Changes between Version 71 and Version 72 of DeveloperGuidelines/Py_2_3

Timestamp:

07/09/19 13:06:09 (6 years ago)

Author:

Dominic König

Comment:

--

DeveloperGuidelines/Py_2_3

@@ -285 +285 @@
 a.sort(key=lambda item: s3_str(item))
 }}}
+
+=== XML with XML declaration must be bytes ===
+
+Any XML that contains an XML declaration must be UTF-8 encoded {{{bytes}}}. In Python-2, {{{bytes}}} is synonymous with {{{str}}} - but in Python-3 it is a different data type.
+
+- {{{S3XML.tostring}}} and {{{S3Resource.export_xml}}} will always return {{{bytes}}}
+- if string operations must be performed on such XML, use {{{s3_str}}} to convert it
+
+=== BytesIO ===
+
+Certain libraries expect a file-like object to represent binary data. Whilst in Python-2, this can be handled with {{{StringIO}}}, Python-3 requires to use {{{BytesIO}}} instead.
+
+- {{{zipfile}}} expects and returns {{{bytes}}}