[Docutils-checkins] SF.net SVN: docutils:[9339] trunk/docutils

[<mi...@us...>]

Revision: 9339
          http://sourceforge.net/p/docutils/code/9339
Author:   milde
Date:     2023-04-08 21:08:59 +0000 (Sat, 08 Apr 2023)
Log Message:
-----------
Revert introduction of `core.publish_bytes()` and `io.BytesOutput`.

Modified Paths:
--------------
    trunk/docutils/HISTORY.txt
    trunk/docutils/docutils/core.py
    trunk/docutils/docutils/io.py
    trunk/docutils/test/test_writers/test_docutils_xml.py
    trunk/docutils/test/test_writers/test_html4css1_misc.py
    trunk/docutils/test/test_writers/test_html5_polyglot_misc.py
    trunk/docutils/test/test_writers/test_odt.py

Modified: trunk/docutils/HISTORY.txt
===================================================================
--- trunk/docutils/HISTORY.txt	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/HISTORY.txt	2023-04-08 21:08:59 UTC (rev 9339)
@@ -23,8 +23,6 @@
 
 * docutils/core.py
 
-  - Added new `publish_bytes()` function to explicitly return
-    output as binary data in a `bytes` object.
   - New argument "auto_encode" for `publish_string()` and
     `publish_programmatically()`.
   - New functions `rst2…()` for use as "console_scripts" `entry point`_.

Modified: trunk/docutils/docutils/core.py
===================================================================
--- trunk/docutils/docutils/core.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/docutils/core.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -474,43 +474,6 @@
     return output
 
 
-def publish_bytes(source, source_path=None, destination_path=None,
-                  reader=None, reader_name='standalone',
-                  parser=None, parser_name='restructuredtext',
-                  writer=None, writer_name='pseudoxml',
-                  settings=None, settings_spec=None,
-                  settings_overrides=None, config_section=None,
-                  enable_exit_status=False):
-    """
-    Set up & run a `Publisher` for programmatic use with string I/O.  Return
-    the encoded bytes.
-
-    Be sure to set the 'output_encoding' setting to the desired encoding.::
-
-        publish_bytes(..., settings_overrides={'output_encoding': 'latin1'})
-
-    Similarly for bytes input (`source`)::
-
-        publish_bytes(..., settings_overrides={'input_encoding': 'latin1'})
-
-    Parameters: see `publish_programmatically()`.
-
-    Provisional.
-    """
-    output, publisher = publish_programmatically(
-        source_class=io.StringInput, source=source, source_path=source_path,
-        destination_class=io.BytesOutput,
-        destination=None, destination_path=destination_path,
-        reader=reader, reader_name=reader_name,
-        parser=parser, parser_name=parser_name,
-        writer=writer, writer_name=writer_name,
-        settings=settings, settings_spec=settings_spec,
-        settings_overrides=settings_overrides,
-        config_section=config_section,
-        enable_exit_status=enable_exit_status)
-    return output
-
-
 def publish_parts(source, source_path=None, source_class=io.StringInput,
                   destination_path=None,
                   reader=None, reader_name='standalone',

Modified: trunk/docutils/docutils/io.py
===================================================================
--- trunk/docutils/docutils/io.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/docutils/io.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -629,26 +629,6 @@
     mode = 'wb'
 
 
-class BytesOutput(Output):
-
-    """
-    Direct binary output.
-    Provisional.
-    """
-
-    default_destination_path = '<bytes>'
-
-    def write(self, data):
-        """Encode `data`, store it in `self.destination`, and return it."""
-        self.destination = self.encode(data)
-        return self.destination
-
-    def encode(self, data):
-        if isinstance(data, bytes):
-            return data
-        return str(data).encode(self.encoding, self.error_handler)
-
-
 class StringInput(Input):
     """Input from a `str` or `bytes` instance."""
 

Modified: trunk/docutils/test/test_writers/test_docutils_xml.py
===================================================================
--- trunk/docutils/test/test_writers/test_docutils_xml.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/test/test_writers/test_docutils_xml.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -121,7 +121,7 @@
 
 
 def publish_xml(settings, source):
-    return docutils.core.publish_bytes(source=source.encode('utf-8'),
+    return docutils.core.publish_string(source=source.encode('utf-8'),
                                        reader_name='standalone',
                                        writer_name='docutils_xml',
                                        settings_overrides=settings)

Modified: trunk/docutils/test/test_writers/test_html4css1_misc.py
===================================================================
--- trunk/docutils/test/test_writers/test_html4css1_misc.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/test/test_writers/test_html4css1_misc.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -33,7 +33,7 @@
             'stylesheet': '',
             '_disable_config': True,
             }
-        result = core.publish_bytes(
+        result = core.publish_string(
             'EUR = \u20ac', writer_name='html4css1',
             settings_overrides=settings_overrides)
         # Encoding a euro sign with latin1 doesn't work, so the

Modified: trunk/docutils/test/test_writers/test_html5_polyglot_misc.py
===================================================================
--- trunk/docutils/test/test_writers/test_html5_polyglot_misc.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/test/test_writers/test_html5_polyglot_misc.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -39,7 +39,7 @@
             'output_encoding': 'latin1',
             'stylesheet': '',
             '_disable_config': True}
-        result = core.publish_bytes(
+        result = core.publish_string(
             'EUR = \u20ac', writer_name='html5_polyglot',
             settings_overrides=settings_overrides)
         # Encoding a euro sign with latin1 doesn't work, so the

Modified: trunk/docutils/test/test_writers/test_odt.py
===================================================================
--- trunk/docutils/test/test_writers/test_odt.py	2023-04-08 21:08:47 UTC (rev 9338)
+++ trunk/docutils/test/test_writers/test_odt.py	2023-04-08 21:08:59 UTC (rev 9339)
@@ -73,7 +73,7 @@
             settings_overrides['_disable_config'] = True
             settings_overrides['language_code'] = 'en-US'
 
-        result = docutils.core.publish_bytes(
+        result = docutils.core.publish_string(
             source=input,
             reader_name='standalone',
             writer_name='odf_odt',

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.