python-docs-fa/library/base64.po at update-CI · python/python-docs-fa

512 lines (434 loc) · 16.4 KB
# SOME DESCRIPTIVE TITLE.
# Copyright (C) 2001 Python Software Foundation
# This file is distributed under the same license as the Python package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
# Translators:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-07-25 12:59+0330\n"
"PO-Revision-Date: 2021-06-28 00:55+0000\n"
"Last-Translator: Rafael Fontenelle <rffontenelle@gmail.com>, 2025\n"
"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/"
"Language: fa\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"
"Plural-Forms: nplurals=2; plural=(n > 1);\n"
#: ../../library/base64.rst:2
msgid ":mod:`!base64` --- Base16, Base32, Base64, Base85 Data Encodings"
#: ../../library/base64.rst:8
msgid "**Source code:** :source:`Lib/base64.py`"
#: ../../library/base64.rst:16
"This module provides functions for encoding binary data to printable ASCII "
"characters and decoding such encodings back to binary data. This includes "
"the :ref:`encodings specified in <base64-rfc-4648>` :rfc:`4648` (Base64, "
"Base32 and Base16), the :ref:`Base85 encoding <base64-base-85>` specified in "
"`PDF 2.0 <https://pdfa.org/resource/iso-32000-2/>`_, and non-standard "
"variants of Base85 used elsewhere."
#: ../../library/base64.rst:24
"There are two interfaces provided by this module.  The modern interface "
"supports encoding :term:`bytes-like objects <bytes-like object>` to "
"ASCII :class:`bytes`, and decoding :term:`bytes-like objects <bytes-like "
"object>` or strings containing ASCII to :class:`bytes`.  Both base-64 "
"alphabets defined in :rfc:`4648` (normal, and URL- and filesystem-safe) are "
"supported."
#: ../../library/base64.rst:30
"The :ref:`legacy interface <base64-legacy>` does not support decoding from "
"strings, but it does provide functions for encoding and decoding to and "
"from :term:`file objects <file object>`.  It only supports the Base64 "
"standard alphabet, and it adds newlines every 76 characters as "
"per :rfc:`2045`.  Note that if you are looking for :rfc:`2045` support you "
"probably want to be looking at the :mod:`email` package instead."
#: ../../library/base64.rst:38
"ASCII-only Unicode strings are now accepted by the decoding functions of the "
"modern interface."
#: ../../library/base64.rst:42
"Any :term:`bytes-like objects <bytes-like object>` are now accepted by all "
"encoding and decoding functions in this module.  Ascii85/Base85 support "
#: ../../library/base64.rst:50
msgid "RFC 4648 Encodings"
#: ../../library/base64.rst:52
"The :rfc:`4648` encodings are suitable for encoding binary data so that it "
"can be safely sent by email, used as parts of URLs, or included as part of "
"an HTTP POST request."
#: ../../library/base64.rst:58
"Encode the :term:`bytes-like object` *s* using Base64 and return the "
"encoded :class:`bytes`."
#: ../../library/base64.rst:61
"Optional *altchars* must be a :term:`bytes-like object` of length 2 which "
"specifies an alternative alphabet for the ``+`` and ``/`` characters. This "
"allows an application to e.g. generate URL or filesystem safe Base64 "
"strings.  The default is ``None``, for which the standard Base64 alphabet is "
#: ../../library/base64.rst:66
"May assert or raise a :exc:`ValueError` if the length of *altchars* is not "
"2.  Raises a :exc:`TypeError` if *altchars* is not a :term:`bytes-like "
#: ../../library/base64.rst:72
"Decode the Base64 encoded :term:`bytes-like object` or ASCII string *s* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:75
"Optional *altchars* must be a :term:`bytes-like object` or ASCII string of "
"length 2 which specifies the alternative alphabet used instead of the ``+`` "
"and ``/`` characters."
#: ../../library/base64.rst:79
"A :exc:`binascii.Error` exception is raised if *s* is incorrectly padded."
#: ../../library/base64.rst:82
"If *validate* is ``False`` (the default), characters that are neither in the "
"normal base-64 alphabet nor the alternative alphabet are discarded prior to "
"the padding check.  If *validate* is ``True``, these non-alphabet characters "
"in the input result in a :exc:`binascii.Error`."
#: ../../library/base64.rst:88
"For more information about the strict base64 check, "
"see :func:`binascii.a2b_base64`"
#: ../../library/base64.rst:90
"May assert or raise a :exc:`ValueError` if the length of *altchars* is not 2."
#: ../../library/base64.rst:94
"Encode :term:`bytes-like object` *s* using the standard Base64 alphabet and "
"return the encoded :class:`bytes`."
#: ../../library/base64.rst:100
"Decode :term:`bytes-like object` or ASCII string *s* using the standard "
"Base64 alphabet and return the decoded :class:`bytes`."
#: ../../library/base64.rst:106
"Encode :term:`bytes-like object` *s* using the URL- and filesystem-safe "
"alphabet, which substitutes ``-`` instead of ``+`` and ``_`` instead of ``/"
"`` in the standard Base64 alphabet, and return the encoded :class:`bytes`.  "
"The result can still contain ``=``."
#: ../../library/base64.rst:115
"Decode :term:`bytes-like object` or ASCII string *s* using the URL- and "
"filesystem-safe alphabet, which substitutes ``-`` instead of ``+`` and ``_`` "
"instead of ``/`` in the standard Base64 alphabet, and return the "
"decoded :class:`bytes`."
#: ../../library/base64.rst:124
"Encode the :term:`bytes-like object` *s* using Base32 and return the "
"encoded :class:`bytes`."
#: ../../library/base64.rst:130
"Decode the Base32 encoded :term:`bytes-like object` or ASCII string *s* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:133 ../../library/base64.rst:181
"Optional *casefold* is a flag specifying whether a lowercase alphabet is "
"acceptable as input.  For security purposes, the default is ``False``."
#: ../../library/base64.rst:137
":rfc:`4648` allows for optional mapping of the digit 0 (zero) to the letter "
"O (oh), and for optional mapping of the digit 1 (one) to either the letter I "
"(eye) or letter L (el).  The optional argument *map01* when not ``None``, "
"specifies which letter the digit 1 should be mapped to (when *map01* is not "
"``None``, the digit 0 is always mapped to the letter O).  For security "
"purposes the default is ``None``, so that 0 and 1 are not allowed in the "
#: ../../library/base64.rst:144 ../../library/base64.rst:185
"A :exc:`binascii.Error` is raised if *s* is incorrectly padded or if there "
"are non-alphabet characters present in the input."
#: ../../library/base64.rst:151
"Similar to :func:`b32encode` but uses the Extended Hex Alphabet, as defined "
"in :rfc:`4648`."
#: ../../library/base64.rst:159
"Similar to :func:`b32decode` but uses the Extended Hex Alphabet, as defined "
"in :rfc:`4648`."
#: ../../library/base64.rst:162
"This version does not allow the digit 0 (zero) to the letter O (oh) and "
"digit 1 (one) to either the letter I (eye) or letter L (el) mappings, all "
"these characters are included in the Extended Hex Alphabet and are not "
"interchangeable."
#: ../../library/base64.rst:172
"Encode the :term:`bytes-like object` *s* using Base16 and return the "
"encoded :class:`bytes`."
#: ../../library/base64.rst:178
"Decode the Base16 encoded :term:`bytes-like object` or ASCII string *s* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:192
msgid "Base85 Encodings"
#: ../../library/base64.rst:194
"Base85 encoding is a family of algorithms which represent four bytes using "
"five ASCII characters.  Originally implemented in the Unix ``btoa(1)`` "
"utility, a version of it was later adopted by Adobe in the PostScript "
"language and is standardized in PDF 2.0 (ISO 32000-2). This version, in both "
"its ``btoa`` and PDF variants, is implemented by :func:`a85encode`."
#: ../../library/base64.rst:201
"A separate version, using a different output character set, was defined as "
"an April Fool's joke in :rfc:`1924` but is now used by Git and other "
"software.  This version is implemented by :func:`b85encode`."
#: ../../library/base64.rst:205
"Finally, a third version, using yet another output character set designed "
"for safe inclusion in programming language strings, is defined by ZeroMQ and "
"implemented here by :func:`z85encode`."
#: ../../library/base64.rst:209
"The functions present in this module differ in how they handle the following:"
#: ../../library/base64.rst:211
msgid "Whether to include and expect enclosing ``<~`` and ``~>`` markers."
#: ../../library/base64.rst:212
msgid "Whether to fold the input into multiple lines."
#: ../../library/base64.rst:213
msgid "The set of ASCII characters used for encoding."
#: ../../library/base64.rst:214
msgid "Compact encodings of sequences of spaces and null bytes."
#: ../../library/base64.rst:215
msgid "The encoding of zero-padding bytes applied to the input."
#: ../../library/base64.rst:217
"Refer to the documentation of the individual functions for more information."
#: ../../library/base64.rst:221
"Encode the :term:`bytes-like object` *b* using Ascii85 and return the "
"encoded :class:`bytes`."
#: ../../library/base64.rst:224
"*foldspaces* is an optional flag that uses the special short sequence 'y' "
"instead of 4 consecutive spaces (ASCII 0x20) as supported by 'btoa'. This "
"feature is not supported by the standard encoding used in PDF."
#: ../../library/base64.rst:228
"*wrapcol* controls whether the output should have newline (``b'\\n'``) "
"characters added to it. If this is non-zero, each output line will be at "
"most this many characters long, excluding the trailing newline."
#: ../../library/base64.rst:232
"*pad* controls whether zero-padding applied to the end of the input is fully "
"retained in the output encoding, as done by ``btoa``, producing an exact "
"multiple of 5 bytes of output. This is not part of the standard encoding "
"used in PDF, as it does not preserve the length of the data."
#: ../../library/base64.rst:238
"*adobe* controls whether the encoded byte sequence is framed with ``<~`` and "
"``~>``, as in a PostScript base-85 string literal.  Note that while "
"ASCII85Decode streams in PDF documents *must* be terminated with ``~>``, "
"they *must not* use a leading ``<~``."
#: ../../library/base64.rst:248
"Decode the Ascii85 encoded :term:`bytes-like object` or ASCII string *b* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:251
"*foldspaces* is a flag that specifies whether the 'y' short sequence should "
"be accepted as shorthand for 4 consecutive spaces (ASCII 0x20). This feature "
"is not supported by the standard Ascii85 encoding used in PDF and PostScript."
#: ../../library/base64.rst:256
"*adobe* controls whether the ``<~`` and ``~>`` markers are present. While "
"the leading ``<~`` is not required, the input must end with ``~>``, or "
"a :exc:`ValueError` is raised."
#: ../../library/base64.rst:260
"*ignorechars* should be a byte string containing characters to ignore from "
"the input. This should only contain whitespace characters, and by default "
"contains all whitespace characters in ASCII."
#: ../../library/base64.rst:269
"Encode the :term:`bytes-like object` *b* using base85 (as used in e.g. git-"
"style binary diffs) and return the encoded :class:`bytes`."
#: ../../library/base64.rst:272
"The input is padded with ``b'\\0'`` so its length is a multiple of 4 bytes "
"before encoding.  If *pad* is true, all the resulting characters are "
"retained in the output, which will always be a multiple of 5 bytes, and thus "
"the length of the data may not be preserved on decoding."
#: ../../library/base64.rst:283
"Decode the base85-encoded :term:`bytes-like object` or ASCII string *b* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:291
"Encode the :term:`bytes-like object` *s* using Z85 (as used in ZeroMQ) and "
"return the encoded :class:`bytes`."
#: ../../library/base64.rst:294
"The `ZeroMQ specification <https://rfc.zeromq.org/spec/32/>`_ requires the "
"length of Z85-encoded data to be a multiple of 5 bytes. To produce compliant "
"data frames, you must pad the input data to this function to a multiple of 4 "
#: ../../library/base64.rst:304
"Decode the Z85-encoded :term:`bytes-like object` or ASCII string *s* and "
"return the decoded :class:`bytes`."
#: ../../library/base64.rst:313
msgid "Legacy Interface"
#: ../../library/base64.rst:317
"Decode the contents of the binary *input* file and write the resulting "
"binary data to the *output* file. *input* and *output* must be :term:`file "
"objects <file object>`. *input* will be read until ``input.readline()`` "
"returns an empty bytes object."
#: ../../library/base64.rst:325
"Decode the :term:`bytes-like object` *s*, which must contain one or more "
"lines of base64 encoded data, and return the decoded :class:`bytes`."
#: ../../library/base64.rst:333
"Encode the contents of the binary *input* file and write the resulting "
"base64 encoded data to the *output* file. *input* and *output* must "
"be :term:`file objects <file object>`. *input* will be read until "
"``input.read()`` returns an empty bytes object. :func:`encode` inserts a "
"newline character (``b'\\n'``) after every 76 bytes of the output, as well "
"as ensuring that the output always ends with a newline, as per :rfc:`2045` "
#: ../../library/base64.rst:343
"Encode the :term:`bytes-like object` *s*, which can contain arbitrary binary "
"data, and return :class:`bytes` containing the base64-encoded data, with "
"newlines (``b'\\n'``) inserted after every 76 bytes of output, and ensuring "
"that there is a trailing newline, as per :rfc:`2045` (MIME)."
#: ../../library/base64.rst:351
msgid "An example usage of the module:"
#: ../../library/base64.rst:364
msgid "Security Considerations"
#: ../../library/base64.rst:366
"A new security considerations section was added to :rfc:`4648` (section 12); "
"it's recommended to review the security section for any code deployed to "
"production."
#: ../../library/base64.rst:371
msgid "Module :mod:`binascii`"
#: ../../library/base64.rst:372
"Support module containing ASCII-to-binary and binary-to-ASCII conversions."
#: ../../library/base64.rst:374
":rfc:`1521` - MIME (Multipurpose Internet Mail Extensions) Part One: "
"Mechanisms for Specifying and Describing the Format of Internet Message "
#: ../../library/base64.rst:375
"Section 5.2, \"Base64 Content-Transfer-Encoding,\" provides the definition "
"of the base64 encoding."
#: ../../library/base64.rst:378
"`ISO 32000-2 Portable document format - Part 2: PDF 2.0 <https://pdfa.org/"
"resource/iso-32000-2/>`_"
#: ../../library/base64.rst:379
"Section 7.4.3, \"ASCII85Decode Filter,\" provides the definition of the "
"Ascii85 encoding used in PDF and PostScript, including the output character "
"set and the details of data length preservation using zero-padding and "
"partial output groups."
#: ../../library/base64.rst:384
msgid "`ZeroMQ RFC 32/Z85 <https://rfc.zeromq.org/spec/32/>`_"
#: ../../library/base64.rst:385
"The \"Formal Specification\" section provides the character set used in Z85."
#: ../../library/base64.rst:10
msgid "base64"
#: ../../library/base64.rst:10
msgid "encoding"
#: ../../library/base64.rst:10
msgid "MIME"
#: ../../library/base64.rst:10
msgid "base64 encoding"
Navigation Menu

Uh oh!

Uh oh!

FilesExpand file tree

base64.po

Latest commit

History

base64.po

File metadata and controls
