add files

python-3.7.4-docs-html/_sources/library/quopri.rst.txt

@@ -0,0 +1,63 @@
+:mod:`quopri` --- Encode and decode MIME quoted-printable data
+==============================================================
+
+.. module:: quopri
+   :synopsis: Encode and decode files using the MIME quoted-printable encoding.
+
+**Source code:** :source:`Lib/quopri.py`
+
+.. index::
+   pair: quoted-printable; encoding
+   single: MIME; quoted-printable encoding
+
+--------------
+
+This module performs quoted-printable transport encoding and decoding, as
+defined in :rfc:`1521`: "MIME (Multipurpose Internet Mail Extensions) Part One:
+Mechanisms for Specifying and Describing the Format of Internet Message Bodies".
+The quoted-printable encoding is designed for data where there are relatively
+few nonprintable characters; the base64 encoding scheme available via the
+:mod:`base64` module is more compact if there are many such characters, as when
+sending a graphics file.
+
+.. function:: decode(input, output, header=False)
+
+   Decode the contents of the *input* file and write the resulting decoded binary
+   data to the *output* file. *input* and *output* must be :term:`binary file objects
+   <file object>`.  If the optional argument *header* is present and true, underscore
+   will be decoded as space. This is used to decode "Q"-encoded headers as
+   described in :rfc:`1522`: "MIME (Multipurpose Internet Mail Extensions)
+   Part Two: Message Header Extensions for Non-ASCII Text".
+
+
+.. function:: encode(input, output, quotetabs, header=False)
+
+   Encode the contents of the *input* file and write the resulting quoted-printable
+   data to the *output* file. *input* and *output* must be
+   :term:`binary file objects <file object>`. *quotetabs*, a
+   non-optional flag which controls whether to encode embedded spaces
+   and tabs; when true it encodes such embedded whitespace, and when
+   false it leaves them unencoded.
+   Note that spaces and tabs appearing at the end of lines are always encoded,
+   as per :rfc:`1521`.  *header* is a flag which controls if spaces are encoded
+   as underscores as per :rfc:`1522`.
+
+
+.. function:: decodestring(s, header=False)
+
+   Like :func:`decode`, except that it accepts a source :class:`bytes` and
+   returns the corresponding decoded :class:`bytes`.
+
+
+.. function:: encodestring(s, quotetabs=False, header=False)
+
+   Like :func:`encode`, except that it accepts a source :class:`bytes` and
+   returns the corresponding encoded :class:`bytes`. By default, it sends a
+   ``False`` value to *quotetabs* parameter of the :func:`encode` function.
+
+
+
+.. seealso::
+
+   Module :mod:`base64`
+      Encode and decode MIME base64 data