email.headerregistry.po

# 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:
# Alireza Shabani (Revisto) <theRevisto@gmail.com>, 2025
# Parham Forati, 2025
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026
#
msgid ""
msgstr ""
"Project-Id-Version: Python 3.14\n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2026-09-21 11:59+0000\n"
"PO-Revision-Date: 2026-09-13 16:09+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-fa/fa/)\n"
"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"
"X-Generator: Poedit 3.6\n"

msgid ":mod:`!email.headerregistry`: Custom Header Objects"
msgstr ":mod:`!email.headerregistry`: اشیاء سرآیند سفارشی"

msgid "**Source code:** :source:`Lib/email/headerregistry.py`"
msgstr "**کد منبع:** :source:`Lib/email/headerregistry.py`"

msgid "[1]_"
msgstr "[1]_"

msgid "Headers are represented by customized subclasses of :class:`str`.  The particular class used to represent a given header is determined by the :attr:`~email.policy.EmailPolicy.header_factory` of the :mod:`~email.policy` in effect when the headers are created.  This section documents the particular ``header_factory`` implemented by the email package for handling :RFC:`5322` compliant email messages, which not only provides customized header objects for various header types, but also provides an extension mechanism for applications to add their own custom header types."
msgstr "سرآیندها با زیرکلاس‌های سفارشی از :class:`str` نمایش داده می‌شوند. کلاس خاصی که برای نمایش یک سرآیند مشخص به کار می‌رود، توسط :attr:`~email.policy.EmailPolicy.header_factory` از :mod:`~email.policy` که در زمان ایجاد سرآیندها معتبر است، تعیین می‌شود. این بخش ``header_factory`` خاصی را مستند می‌کند که توسط بسته email برای مدیریت پیام‌های ایمیل منطبق با :RFC:`5322` پیاده‌سازی شده است و نه‌تنها اشیای سرآیند سفارشی برای انواع مختلف سرآیند فراهم می‌کند، بلکه سازوکار توسعه‌ای برای برنامه‌ها فراهم می‌کند تا انواع سرآیند سفارشی خود را اضافه کنند."

msgid "When using any of the policy objects derived from :data:`~email.policy.EmailPolicy`, all headers are produced by :class:`.HeaderRegistry` and have :class:`.BaseHeader` as their last base class.  Each header class has an additional base class that is determined by the type of the header.  For example, many headers have the class :class:`.UnstructuredHeader` as their other base class.  The specialized second class for a header is determined by the name of the header, using a lookup table stored in the :class:`.HeaderRegistry`.  All of this is managed transparently for the typical application program, but interfaces are provided for modifying the default behavior for use by more complex applications."
msgstr "هنگام استفاده از هر یک از اشیاء سیاست مشتق‌شده از :data:`~email.policy.EmailPolicy`، تمام سرآیندها توسط :class:`.HeaderRegistry` تولید می‌شوند و :class:`.BaseHeader` را به‌عنوان آخرین کلاس پایه خود دارند. هر کلاس سرآیند یک کلاس پایه اضافی دارد که بر اساس نوع سرآیند تعیین می‌شود. برای مثال، بسیاری از سرآیندها کلاس :class:`.UnstructuredHeader` را به‌عنوان کلاس پایه دیگر خود دارند. کلاس دوم تخصصی برای یک سرآیند، با استفاده از جدول جستجویی که در :class:`.HeaderRegistry` ذخیره‌شده است، بر اساس نام سرآیند تعیین می‌شود. همه این موارد برای برنامه کاربردی معمول به‌صورت شفاف مدیریت می‌شوند، اما رابط‌هایی برای تغییر رفتار پیش‌فرض جهت استفاده در برنامه‌های پیچیده‌تر فراهم شده‌اند."

msgid "The sections below first document the header base classes and their attributes, followed by the API for modifying the behavior of :class:`.HeaderRegistry`, and finally the support classes used to represent the data parsed from structured headers."
msgstr "بخش‌های زیر ابتدا کلاس‌های پایه‌ی سرآیند و ویژگی‌های آن‌ها را مستند می‌کنند، سپس به API برای تغییر رفتار :class:`.HeaderRegistry` می‌پردازند، و در نهایت کلاس‌های پشتیبانی مورد استفاده برای بازنمایی داده‌های تجزیه‌شده از سرآیند‌های ساختاریافته را پوشش می‌دهند."

msgid "*name* and *value* are passed to ``BaseHeader`` from the :attr:`~email.policy.EmailPolicy.header_factory` call.  The string value of any header object is the *value* fully decoded to a string."
msgstr "*name* و *value* از فراخوانی :attr:`~email.policy.EmailPolicy.header_factory` به ``BaseHeader`` پاس داده می‌شوند. مقدار رشته‌ی هر شیء سرآیند، *value* به‌صورت کامل کدگشایی‌شده به یک رشته است."

msgid "This base class defines the following read-only properties:"
msgstr "این کلاس پایه، ویژگی‌های فقط‌خواندنی زیر را تعریف می‌کند:"

msgid "The name of the header (the portion of the field before the ':').  This is exactly the value passed in the :attr:`~email.policy.EmailPolicy.header_factory` call for *name*; that is, case is preserved."
msgstr "نام سرآیند (بخش فیلد پیش از ':'). این دقیقاً همان مقداری است که به‌عنوان *name* در فراخوانی :attr:`~email.policy.EmailPolicy.header_factory` ارسال شده است؛ یعنی بزرگی و کوچکی حروف حفظ می‌شود."

msgid "A tuple of :exc:`~email.errors.HeaderDefect` instances reporting any RFC compliance problems found during parsing.  The email package tries to be complete about detecting compliance issues.  See the :mod:`~email.errors` module for a discussion of the types of defects that may be reported."
msgstr "یک تاپل از نمونه‌های :exc:`~email.errors.HeaderDefect` که هر مشکل انطباق با RFC را که در حین تجزیه یافت می‌شود، گزارش می‌کنند. بسته‌ی email تلاش می‌کند در تشخیص مسائل انطباق کامل باشد. برای بحثی در مورد انواع نقص‌هایی که ممکن است گزارش شوند، ماژول :mod:`~email.errors` را ببینید."

msgid "The maximum number of headers of this type that can have the same ``name``.  A value of ``None`` means unlimited.  The ``BaseHeader`` value for this attribute is ``None``; it is expected that specialized header classes will override this value as needed."
msgstr "حداکثر تعداد سرآیندهای این نوع که می‌توانند ``name`` یکسانی داشته باشند. مقدار ``None`` به معنای نامحدود است. مقدار این ویژگی در ``BaseHeader`` برابر ``None`` است؛ انتظار می‌رود کلاس‌های سرآیند تخصصی این مقدار را در صورت نیاز بازنویسی کنند."

msgid "``BaseHeader`` also provides the following method, which is called by the email library code and should not in general be called by application programs:"
msgstr "``BaseHeader`` همچنین متد زیر را ارائه می‌دهد، که توسط کد کتابخانه ایمیل فراخوانی می‌شود و به‌طور کلی نباید توسط برنامه‌های کاربردی فراخوانی شود:"

msgid "Return a string containing :attr:`~email.policy.Policy.linesep` characters as required to correctly fold the header according to *policy*.  A :attr:`~email.policy.Policy.cte_type` of ``8bit`` will be treated as if it were ``7bit``, since headers may not contain arbitrary binary data.  If :attr:`~email.policy.EmailPolicy.utf8` is ``False``, non-ASCII data will be :rfc:`2047` encoded."
msgstr "رشته‌ای حاوی نویسه‌های :attr:`~email.policy.Policy.linesep` به‌میزان لازم برای تا کردن صحیح سرآیند مطابق *policy* برمی‌گرداند. :attr:`~email.policy.Policy.cte_type` با مقدار ``8bit`` به‌صورت ``7bit`` در نظر گرفته می‌شود، زیرا سرآیندها نمی‌توانند حاوی داده‌های دودویی دلخواه باشند. اگر :attr:`~email.policy.EmailPolicy.utf8` برابر ``False`` باشد، داده‌های غیر ASCII طبق :rfc:`2047` کدگذاری می‌شوند."

msgid "``BaseHeader`` by itself cannot be used to create a header object.  It defines a protocol that each specialized header cooperates with in order to produce the header object.  Specifically, ``BaseHeader`` requires that the specialized class provide a :func:`classmethod` named ``parse``.  This method is called as follows::"
msgstr "``BaseHeader`` به‌تنهایی نمی‌تواند برای ایجاد یک شیء سرآیند به کار رود. این کلاس پروتکلی را تعریف می‌کند که هر سرآیند تخصصی برای ایجاد شیء سرآیند با آن همکاری می‌کند. به‌طور مشخص، ``BaseHeader`` الزام می‌کند که کلاس تخصصی یک :func:`classmethod` به نام ``parse`` فراهم کند. این متد به‌صورت زیر فراخوانی می‌شود::"

msgid "parse(string, kwds)"
msgstr "parse(string, kwds)"

msgid "``kwds`` is a dictionary containing one pre-initialized key, ``defects``. ``defects`` is an empty list.  The parse method should append any detected defects to this list.  On return, the ``kwds`` dictionary *must* contain values for at least the keys ``decoded``, ``defects`` and ``parse_tree``. ``decoded`` should be the string value for the header (that is, the header value fully decoded to a string). ``parse_tree`` is set to the parse tree obtained from parsing the header. The parse method should assume that *string* may contain content-transfer-encoded parts, but should correctly handle all valid Unicode characters as well so that it can parse un-encoded header values."
msgstr "``kwds`` یک دیکشنری است که حاوی یک کلید از پیش مقداردهی‌شده، ``defects`` می‌باشد. ``defects`` یک فهرست خالی است. متد parse باید هر عیب شناسایی‌شده را به این فهرست اضافه کند. در بازگشت، دیکشنری ``kwds`` *باید* حاوی مقادیر برای حداقل کلیدهای ``decoded``، ``defects`` و ``parse_tree`` باشد. ``decoded`` باید مقدار رشته برای سرآیند باشد (یعنی مقدار سرآیند به‌صورت کامل کدگشایی‌شده به یک رشته). ``parse_tree`` به درخت تجزیه حاصل از تجزیه سرآیند تنظیم می‌شود. متد parse باید فرض کند که *string* ممکن است حاوی بخش‌های کدگذاری‌شده content-transfer باشد، اما باید نویسه‌های معتبر یونیکد را نیز به‌درستی مدیریت کند تا بتواند مقادیر سرآیند بدون کدگذاری را تجزیه کند."

msgid "``BaseHeader``'s ``__new__`` then creates the header instance, and calls its ``init`` method.  The specialized class only needs to provide an ``init`` method if it wishes to set additional attributes beyond those provided by ``BaseHeader`` itself.  Such an ``init`` method should look like this::"
msgstr "سپس ``__new__``\\ ``BaseHeader`` نمونه‌ی سرآیند را ایجاد می‌کند و متد ``init`` آن را فراخوانی می‌کند. کلاس تخصصی تنها در صورتی لازم است یک متد ``init`` ارائه کند که بخواهد ویژگی‌های اضافی، فراتر از آنچه خود ``BaseHeader`` فراهم می‌کند، تنظیم کند. چنین متد ``init`` باید به این صورت باشد::"

msgid ""
"def init(self, /, *args, **kw):\n"
"    self._myattr = kw.pop('myattr')\n"
"    super().init(*args, **kw)"
msgstr ""
"def init(self, /, *args, **kw):\n"
"    self._myattr = kw.pop('myattr')\n"
"    super().init(*args, **kw)"

msgid "That is, anything extra that the specialized class puts in to the ``kwds`` dictionary should be removed and handled, and the remaining contents of ``kw`` (and ``args``) passed to the ``BaseHeader`` ``init`` method."
msgstr "یعنی هر چیز اضافی که کلاس تخصصی در دیکشنری ``kwds`` قرار می‌دهد باید حذف و مدیریت شود، و محتوای باقی‌مانده‌ی ``kw`` (و ``args``) به متد ``init`` از ``BaseHeader`` ارسال شود."

msgid "An \"unstructured\" header is the default type of header in :rfc:`5322`. Any header that does not have a specified syntax is treated as unstructured.  The classic example of an unstructured header is the :mailheader:`Subject` header."
msgstr "یک سرآیند «بدون ساختار»، نوع پیش‌فرض سرآیند در :rfc:`5322` است. هر سرآیندی که سینتکس مشخصی نداشته باشد، بدون ساختار تلقی می‌شود. یک نمونه کلاسیک از سرآیند بدون ساختار، سرآیند :mailheader:`Subject` است."

msgid "In :rfc:`5322`, an unstructured header is a run of arbitrary text in the ASCII character set.  :rfc:`2047`, however, has an :rfc:`5322` compatible mechanism for encoding non-ASCII text as ASCII characters within a header value.  When a *value* containing encoded words is passed to the constructor, the ``UnstructuredHeader`` parser converts such encoded words into a string, following the :rfc:`2047` rules for unstructured text.  The parser uses heuristics to attempt to decode certain non-compliant encoded words.  Defects are registered in such cases, as well as defects for issues such as invalid characters within the encoded words or the non-encoded text."
msgstr "در :rfc:`5322`، یک سرآیند بدون ساختار، یک دنباله از متن دلخواه در مجموعه نویسه‌های اسکی است. اما :rfc:`2047` یک مکانیزم سازگار با :rfc:`5322` برای کدگذاری متن غیر اسکی به عنوان نویسه‌های اسکی در یک مقدار سرآیند دارد. وقتی یک *value* حاوی واژه‌های کدگذاری‌شده به سازنده پاس داده می‌شود، پارسر ``UnstructuredHeader`` چنین واژه‌های کدگذاری‌شده را به یک رشته تبدیل می‌کند، با دنباله‌ی قوانین :rfc:`2047` برای متن بدون ساختار. پارسر از ابتکارها برای تلاش در کدگشایی واژه‌های کدگذاری‌شده ناسازگار استفاده می‌کند. عیوب در چنین مواردی ثبت می‌شوند، همانند عیوب برای مواردی مانند نویسه‌های نامعتبر در واژه‌های کدگذاری‌شده یا متن بدون کدگذاری."

msgid "This header type provides no additional attributes."
msgstr "این نوع سرآیند، هیچ ویژگی اضافه‌ای ارائه نمی‌دهد."

msgid ":rfc:`5322` specifies a very specific format for dates within email headers. The ``DateHeader`` parser recognizes that date format, as well as recognizing a number of variant forms that are sometimes found \"in the wild\"."
msgstr ":rfc:`5322` قالب بسیار مشخصی را برای تاریخ‌ها در سرآیندهای ایمیل تعیین می‌کند. پارسر ``DateHeader`` آن قالب تاریخ و همچنین تعدادی از صورت‌های متفاوت را که گاهی «در عمل» یافت می‌شوند، تشخیص می‌دهد."

msgid "This header type provides the following additional attributes:"
msgstr "این نوع سرآیند، ویژگی‌های اضافی زیر را فراهم می‌کند:"

msgid "If the header value can be recognized as a valid date of one form or another, this attribute will contain a :class:`~datetime.datetime` instance representing that date.  If the timezone of the input date is specified as ``-0000`` (indicating it is in UTC but contains no information about the source timezone), then :attr:`.datetime` will be a naive :class:`~datetime.datetime`.  If a specific timezone offset is found (including ``+0000``), then :attr:`.datetime` will contain an aware ``datetime`` that uses :class:`datetime.timezone` to record the timezone offset."
msgstr "اگر مقدار سرآیند بتواند به‌عنوان یک تاریخ معتبر در یکی از قالب‌ها تشخیص داده شود، این ویژگی شامل یک نمونه :class:`~datetime.datetime` خواهد بود که نشان‌دهنده آن تاریخ است. اگر منطقه زمانی تاریخ ورودی به‌صورت ``-0000`` مشخص شده باشد (که نشان می‌دهد در UTC است اما حاوی اطلاعاتی درباره منطقه زمانی منبع نیست)، آنگاه :attr:`.datetime` یک :class:`~datetime.datetime` ساده خواهد بود. اگر یک آفست منطقه زمانی مشخص یافت شود (از جمله ``+0000``)، آنگاه :attr:`.datetime` شامل یک ``datetime`` آگاه خواهد بود که از :class:`datetime.timezone` برای ثبت آفست منطقه زمانی استفاده می‌کند."

msgid "The ``decoded`` value of the header is determined by formatting the ``datetime`` according to the :rfc:`5322` rules; that is, it is set to::"
msgstr "مقدار ``decoded`` سرآیند با قالب‌بندی ``datetime`` مطابق قواعد :rfc:`5322` تعیین می‌شود؛ یعنی، به‌صورت زیر تنظیم می‌شود::"

msgid "email.utils.format_datetime(self.datetime)"
msgstr "email.utils.format_datetime(self.datetime)"

msgid "When creating a ``DateHeader``, *value* may be :class:`~datetime.datetime` instance.  This means, for example, that the following code is valid and does what one would expect::"
msgstr "هنگام ایجاد یک ``DateHeader``، *value* می‌تواند نمونه‌ای از :class:`~datetime.datetime` باشد. این بدان معناست که، برای مثال، کد زیر معتبر است و همان کاری را که انتظار می‌رود انجام می‌دهد::"

msgid "msg['Date'] = datetime(2011, 7, 15, 21)"
msgstr "msg['Date'] = datetime(2011, 7, 15, 21)"

msgid "Because this is a naive ``datetime`` it will be interpreted as a UTC timestamp, and the resulting value will have a timezone of ``-0000``.  Much more useful is to use the :func:`~email.utils.localtime` function from the :mod:`~email.utils` module::"
msgstr "از آن‌جا که این یک ``datetime`` ساده (naive) است، به‌عنوان یک مهر زمانی UTC تفسیر می‌شود و مقدار حاصل دارای منطقه زمانی ``-0000`` خواهد بود. بسیار مفیدتر آن است که از تابع :func:`~email.utils.localtime` در ماژول :mod:`~email.utils` استفاده کنید::"

msgid "msg['Date'] = utils.localtime()"
msgstr "msg['Date'] = utils.localtime()"

msgid "This example sets the date header to the current time and date using the current timezone offset."
msgstr "این مثال سرآیند تاریخ را با استفاده از آفست منطقه‌ی زمانی (timezone offset) فعلی، روی زمان و تاریخ فعلی تنظیم می‌کند."

msgid "Address headers are one of the most complex structured header types. The ``AddressHeader`` class provides a generic interface to any address header."
msgstr "سرآیندهای نشانی یکی از پیچیده‌ترین انواع سرآیندهای ساختاریافته هستند. کلاس ``AddressHeader`` یک رابط عام برای هر سرآیند نشانی ارائه می‌دهد."

msgid "A tuple of :class:`.Group` objects encoding the addresses and groups found in the header value.  Addresses that are not part of a group are represented in this list as single-address ``Groups`` whose :attr:`~.Group.display_name` is ``None``."
msgstr "یک تاپل از اشیای :class:`.Group` که نشانی‌ها و گروه‌های یافت‌شده در مقدار سرآیند را کدگذاری می‌کنند. نشانی‌هایی که بخشی از یک گروه نیستند، در این فهرست به‌صورت ``Groups``\\ های تک‌نشانی بازنمایی می‌شوند که :attr:`~.Group.display_name` آن‌ها ``None`` است."

msgid "A tuple of :class:`.Address` objects encoding all of the individual addresses from the header value.  If the header value contains any groups, the individual addresses from the group are included in the list at the point where the group occurs in the value (that is, the list of addresses is \"flattened\" into a one dimensional list)."
msgstr "تاپلی از اشیای :class:`.Address` که همه‌ی نشانی‌های منفردِ موجود در مقدار سرایند را کدگذاری می‌کنند. اگر مقدار سرایند شامل گروهی باشد، نشانی‌های منفردِ آن گروه در نقطه‌ای که گروه در مقدار ظاهر می‌شود، در فهرست گنجانده می‌شوند (یعنی فهرست نشانی‌ها به یک فهرست یک‌بعدی «تخت‌شده» تبدیل می‌شود)."

msgid "The ``decoded`` value of the header will have all encoded words decoded to a string.  :class:`~encodings.idna` encoded domain names are also decoded to a string.  The ``decoded`` value is set by :ref:`joining <meth-str-join>` the :class:`str` value of the elements of the ``groups`` attribute with ``', '``."
msgstr "مقدار ``decoded`` سرآیند تمام واژه‌های کدگذاری‌شده را به یک رشته کدگشایی شده خواهد داشت. نام‌های دامنه کدگذاری‌شده :class:`~encodings.idna` نیز به یک رشته کدگشایی می‌شوند. مقدار ``decoded`` با :ref:`الحاق <meth-str-join>` مقدار :class:`str` المان‌های ویژگی ``groups`` با ``', '`` تنظیم می‌شود."

msgid "A list of :class:`.Address` and :class:`.Group` objects in any combination may be used to set the value of an address header.  ``Group`` objects whose ``display_name`` is ``None`` will be interpreted as single addresses, which allows an address list to be copied with groups intact by using the list obtained from the ``groups`` attribute of the source header."
msgstr "می‌توان از فهرستی از اشیاء :class:`.Address` و :class:`.Group` در هر ترکیبی برای تنظیم مقدار یک سرآیند نشانی استفاده کرد. اشیاء ``Group`` که ``display_name`` آن‌ها ``None`` است، به‌عنوان نشانی‌های منفرد تعبیر می‌شوند؛ این امر امکان می‌دهد یک فهرست نشانی با حفظ گروه‌ها، با استفاده از فهرستی که از ویژگی ``groups`` سرآیند مبدأ به دست می‌آید، کپی شود."

msgid "A subclass of :class:`.AddressHeader` that adds one additional attribute:"
msgstr "زیرکلاسی از :class:`.AddressHeader` که یک ویژگی اضافی می‌افزاید:"

msgid "The single address encoded by the header value.  If the header value actually contains more than one address (which would be a violation of the RFC under the default :mod:`~email.policy`), accessing this attribute will result in a :exc:`ValueError`."
msgstr "تنها نشانی کدگذاری‌شده توسط مقدار سرآیند. اگر مقدار سرآیند در واقع شامل بیش از یک نشانی باشد (که تحت :mod:`~email.policy` پیش‌فرض، نقض RFC خواهد بود)، دسترسی به این ویژگی منجر به :exc:`ValueError` خواهد شد."

msgid "Many of the above classes also have a ``Unique`` variant (for example, ``UniqueUnstructuredHeader``).  The only difference is that in the ``Unique`` variant, :attr:`~.BaseHeader.max_count` is set to 1."
msgstr "بسیاری از کلاس‌های فوق همچنین دارای یک گونه‌ی ``Unique`` هستند (برای مثال، ``UniqueUnstructuredHeader``). تنها تفاوت این است که در گونه‌ی ``Unique``، :attr:`~.BaseHeader.max_count` روی ۱ تنظیم شده است."

msgid "There is really only one valid value for the :mailheader:`MIME-Version` header, and that is ``1.0``.  For future proofing, this header class supports other valid version numbers.  If a version number has a valid value per :rfc:`2045`, then the header object will have non-``None`` values for the following attributes:"
msgstr "در واقع تنها یک مقدار معتبر برای سرآیند :mailheader:`MIME-Version` وجود دارد، و آن ``1.0`` است. برای سازگاری با آینده، این کلاس سرآیند از سایر شماره‌های نسخه معتبر نیز پشتیبانی می‌کند. اگر یک شماره نسخه مقدار معتبری مطابق :rfc:`2045` داشته باشد، شیء سرآیند برای ویژگی‌های زیر مقادیر غیر ``None`` خواهد داشت:"

msgid "The version number as a string, with any whitespace and/or comments removed."
msgstr "شماره نسخه به‌صورت یک رشته، با حذف هرگونه فضای سفید و/یا کامنت."

msgid "The major version number as an integer"
msgstr "شماره نسخه اصلی به‌صورت عدد صحیح"

msgid "The minor version number as an integer"
msgstr "شماره نسخه فرعی به‌صورت عدد صحیح"

msgid "MIME headers all start with the prefix 'Content-'.  Each specific header has a certain value, described under the class for that header.  Some can also take a list of supplemental parameters, which have a common format. This class serves as a base for all the MIME headers that take parameters."
msgstr "همه سرآیندهای MIME با پیشوند 'Content-' شروع می‌شوند. هر سرآیند خاص، مقدار معینی دارد که در ذیل کلاس مربوط به آن سرآیند توضیح داده شده است. برخی نیز می‌توانند فهرستی از پارامترهای تکمیلی را بپذیرند که قالب مشترکی دارند. این کلاس به‌عنوان پایه‌ای برای همه سرآیندهای MIME که پارامتر می‌پذیرند، عمل می‌کند."

msgid "A dictionary mapping parameter names to parameter values."
msgstr "یک دیکشنری که نام‌های پارامتر را به مقادیر پارامتر نگاشت می‌کند."

msgid "A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:`Content-Type` header."
msgstr "یک کلاس :class:`ParameterizedMIMEHeader` که سرآیند :mailheader:`Content-Type` را مدیریت می‌کند."

msgid "The content type string, in the form ``maintype/subtype``."
msgstr "رشته‌ی نوع محتوا، در قالب ``maintype/subtype``."

msgid "A :class:`ParameterizedMIMEHeader` class that handles the :mailheader:`Content-Disposition` header."
msgstr "یک کلاس :class:`ParameterizedMIMEHeader` که سرآیند :mailheader:`Content-Disposition` را مدیریت می‌کند."

msgid "``inline`` and ``attachment`` are the only valid values in common use."
msgstr "تنها مقادیر معتبرِ رایج، ``inline`` و ``attachment`` هستند."

msgid "Handles the :mailheader:`Content-Transfer-Encoding` header."
msgstr "سرآیند :mailheader:`Content-Transfer-Encoding` را مدیریت می‌کند."

msgid "Valid values are ``7bit``, ``8bit``, ``base64``, and ``quoted-printable``.  See :rfc:`2045` for more information."
msgstr "مقادیر معتبر عبارتند از ``7bit``، ``8bit``، ``base64`` و ``quoted-printable``. برای اطلاعات بیشتر :rfc:`2045` را ببینید."

msgid "This is the factory used by :class:`~email.policy.EmailPolicy` by default. ``HeaderRegistry`` builds the class used to create a header instance dynamically, using *base_class* and a specialized class retrieved from a registry that it holds.  When a given header name does not appear in the registry, the class specified by *default_class* is used as the specialized class.  When *use_default_map* is ``True`` (the default), the standard mapping of header names to classes is copied in to the registry during initialization.  *base_class* is always the last class in the generated class's :class:`~type.__bases__` list."
msgstr "این کارخانه‌ای است که :class:`~email.policy.EmailPolicy` به‌طور پیش‌فرض از آن استفاده می‌کند. ``HeaderRegistry`` با استفاده از *base_class* و یک کلاس تخصصی بازیابی‌شده از رجیستری که در اختیار دارد، به‌صورت پویا کلاسی را می‌سازد که برای ایجاد یک نمونه سرآیند استفاده می‌شود. هنگامی که یک نام سرآیند معین در رجیستری وجود نداشته باشد، کلاس مشخص‌شده توسط *default_class* به‌عنوان کلاس تخصصی استفاده می‌شود. هنگامی که *use_default_map* برابر ``True`` باشد (مقدار پیش‌فرض)، نگاشت استاندارد نام‌های سرآیند به کلاس‌ها در حین مقداردهی اولیه به رجیستری کپی می‌شود. *base_class* همیشه آخرین کلاس در فهرست :class:`~type.__bases__` کلاس ساخته‌شده است."

msgid "The default mappings are:"
msgstr "نگاشت‌های پیش‌فرض عبارتند از:"

msgid "subject"
msgstr "subject"

msgid "UniqueUnstructuredHeader"
msgstr "UniqueUnstructuredHeader"

msgid "date"
msgstr "date"

msgid "UniqueDateHeader"
msgstr "UniqueDateHeader"

msgid "resent-date"
msgstr "resent-date"

msgid "DateHeader"
msgstr "DateHeader"

msgid "orig-date"
msgstr "orig-date"

msgid "sender"
msgstr "sender"

msgid "UniqueSingleAddressHeader"
msgstr "UniqueSingleAddressHeader"

msgid "resent-sender"
msgstr "resent-sender"

msgid "SingleAddressHeader"
msgstr "SingleAddressHeader"

msgid "to"
msgstr "to"

msgid "UniqueAddressHeader"
msgstr "UniqueAddressHeader"

msgid "resent-to"
msgstr "resent-to"

msgid "AddressHeader"
msgstr "AddressHeader"

msgid "cc"
msgstr "cc"

msgid "resent-cc"
msgstr "resent-cc"

msgid "bcc"
msgstr "bcc"

msgid "resent-bcc"
msgstr "resent-bcc"

msgid "from"
msgstr "from"

msgid "resent-from"
msgstr "resent-from"

msgid "reply-to"
msgstr "reply-to"

msgid "mime-version"
msgstr "mime-version"

msgid "MIMEVersionHeader"
msgstr "MIMEVersionHeader"

msgid "content-type"
msgstr "content-type"

msgid "ContentTypeHeader"
msgstr "ContentTypeHeader"

msgid "content-disposition"
msgstr "content-disposition"

msgid "ContentDispositionHeader"
msgstr "ContentDispositionHeader"

msgid "content-transfer-encoding"
msgstr "content-transfer-encoding"

msgid "ContentTransferEncodingHeader"
msgstr "ContentTransferEncodingHeader"

msgid "message-id"
msgstr "message-id"

msgid "MessageIDHeader"
msgstr "MessageIDHeader"

msgid "``HeaderRegistry`` has the following methods:"
msgstr "``HeaderRegistry`` متدهای زیر را دارد:"

msgid "*name* is the name of the header to be mapped.  It will be converted to lower case in the registry.  *cls* is the specialized class to be used, along with *base_class*, to create the class used to instantiate headers that match *name*."
msgstr "*name* نام سرآیندی است که باید نگاشت شود. این نام در رجیستری به حروف کوچک تبدیل می‌شود. *cls* کلاس تخصصی است که به همراه *base_class*، برای ایجاد کلاسی به کار می‌رود که سرآیندهای منطبق با *name* را نمونه‌سازی می‌کند."

msgid "Construct and return a class to handle creating a *name* header."
msgstr "یک کلاس را برای مدیریت ایجاد سرآیند *name* بسازید و برگردانید."

msgid "Retrieves the specialized header associated with *name* from the registry (using *default_class* if *name* does not appear in the registry) and composes it with *base_class* to produce a class, calls the constructed class's constructor, passing it the same argument list, and finally returns the class instance created thereby."
msgstr "سرآیند اختصاصی مرتبط با *name* را از رجیستری بازیابی می‌کند (اگر *name* در رجیستری وجود نداشته باشد، از *default_class* استفاده می‌شود) و آن را با *base_class* ترکیب می‌کند تا کلاسی تولید شود، سازنده‌ی کلاس ساخته‌شده را با همان فهرست آرگومان‌ها فراخوانی می‌کند و در نهایت نمونه‌ی کلاس ایجادشده از این طریق را برمی‌گرداند."

msgid "The following classes are the classes used to represent data parsed from structured headers and can, in general, be used by an application program to construct structured values to assign to specific headers."
msgstr "کلاس‌های زیر کلاس‌هایی هستند که برای نمایش داده‌های تجزیه‌شده از سرآیندهای ساخت‌یافته استفاده می‌شوند و به‌طور کلی یک برنامه کاربردی می‌تواند از آن‌ها برای ساخت مقادیر ساخت‌یافته جهت انتساب به سرآیندهای مشخص استفاده کند."

msgid "The class used to represent an email address.  The general form of an address is::"
msgstr "کلاسی که برای نمایش یک نشانی ایمیل استفاده می‌شود. شکل کلی یک نشانی به این صورت است::"

msgid "[display_name] <username@domain>"
msgstr "[display_name] <username@domain>"

msgid "or::"
msgstr "یا::"

msgid "username@domain"
msgstr "username@domain"

msgid "where each part must conform to specific syntax rules spelled out in :rfc:`5322`."
msgstr "که هر بخش باید با قواعد سینتکسی خاصی که در :rfc:`5322` تشریح شده است مطابقت داشته باشد."

msgid "As a convenience *addr_spec* can be specified instead of *username* and *domain*, in which case *username* and *domain* will be parsed from the *addr_spec*.  An *addr_spec* must be a properly RFC quoted string; if it is not ``Address`` will raise an error.  Unicode characters are allowed and will be property encoded when serialized.  However, per the RFCs, Unicode is *not* allowed in the username portion of the address."
msgstr "به عنوان یک راحتی، *addr_spec* می‌تواند به جای *username* و *domain* مشخص شود، در این صورت *username* و *domain* از *addr_spec* تجزیه خواهند شد. یک *addr_spec* باید یک رشته نقل‌قول‌شده RFC مناسب باشد؛ اگر نباشد ``Address`` خطا خواهد داد. نویسه‌های یونیکد مجاز هستند و هنگام سریال‌سازی به‌صورت مناسب کدگذاری می‌شوند. با این حال، طبق RFCها، یونیکد در بخش نام‌کاربری آدرس *مجاز نیست*."

msgid "The display name portion of the address, if any, with all quoting removed.  If the address does not have a display name, this attribute will be an empty string."
msgstr "بخش نام نمایشی نشانی، در صورت وجود، با حذف تمام علامت‌های نقل‌قول. اگر نشانی نام نمایشی نداشته باشد، این ویژگی یک رشته خالی خواهد بود."

msgid "The ``username`` portion of the address, with all quoting removed."
msgstr "بخش ``username`` از نشانی، با حذف تمام علامت‌های نقل‌قول."

msgid "The ``domain`` portion of the address."
msgstr "بخش ``domain`` از نشانی."

msgid "The ``username@domain`` portion of the address, correctly quoted for use as a bare address (the second form shown above).  This attribute is not mutable."
msgstr "بخش ``username@domain`` از نشانی، که به‌درستی در علامت نقل‌قول قرار گرفته است تا به‌عنوان یک نشانی ساده (دومین شکل نشان‌داده‌شده در بالا) استفاده شود. این ویژگی تغییرپذیر نیست."

msgid "The ``str`` value of the object is the address quoted according to :rfc:`5322` rules, but with no Content Transfer Encoding of any non-ASCII characters."
msgstr "مقدار ``str`` شیء، نشانی نقل‌قول‌شده مطابق قواعد :rfc:`5322` است، اما بدون کدگذاری انتقال محتوا (Content Transfer Encoding) برای هیچ‌یک از نویسه‌های غیر ASCII."

msgid "To support SMTP (:rfc:`5321`), ``Address`` handles one special case: if ``username`` and ``domain`` are both the empty string (or ``None``), then the string value of the ``Address`` is ``<>``."
msgstr "برای پشتیبانی از SMTP (:rfc:`5321`)، ``Address`` یک حالت خاص را مدیریت می‌کند: اگر ``username`` و ``domain`` هر دو رشته خالی (یا ``None``) باشند، مقدار رشته‌ای ``Address`` برابر ``<>`` است."

msgid "The class used to represent an address group.  The general form of an address group is::"
msgstr "کلاسی که برای بازنمایی یک گروه نشانی استفاده می‌شود. شکل کلی یک گروه نشانی به این صورت است::"

msgid "display_name: [address-list];"
msgstr "display_name: [address-list];"

msgid "As a convenience for processing lists of addresses that consist of a mixture of groups and single addresses, a ``Group`` may also be used to represent single addresses that are not part of a group by setting *display_name* to ``None`` and providing a list of the single address as *addresses*."
msgstr "برای سهولت در پردازش فهرست‌هایی از نشانی‌ها که شامل ترکیبی از گروه‌ها و نشانی‌های تکی هستند، می‌توان از ``Group`` همچنین برای نمایش نشانی‌های تکی که بخشی از یک گروه نیستند استفاده کرد؛ برای این کار *display_name* را روی ``None`` تنظیم کنید و فهرستی از نشانی تکی را به‌عنوان *addresses* ارائه دهید."

msgid "The ``display_name`` of the group.  If it is ``None`` and there is exactly one ``Address`` in ``addresses``, then the ``Group`` represents a single address that is not in a group."
msgstr "``display_name`` گروه. اگر این مقدار ``None`` باشد و دقیقاً یک ``Address`` در ``addresses`` وجود داشته باشد، آنگاه ``Group`` نشان‌دهنده‌ی یک نشانی واحد است که در گروهی نیست."

msgid "A possibly empty tuple of :class:`.Address` objects representing the addresses in the group."
msgstr "یک تاپل احتمالاً خالی از اشیای :class:`.Address` که نشان‌دهنده‌ی نشانی‌های درون گروه هستند."

msgid "The ``str`` value of a ``Group`` is formatted according to :rfc:`5322`, but with no Content Transfer Encoding of any non-ASCII characters.  If ``display_name`` is none and there is a single ``Address`` in the ``addresses`` list, the ``str`` value will be the same as the ``str`` of that single ``Address``."
msgstr "مقدار ``str`` یک ``Group`` مطابق :rfc:`5322` قالب‌بندی می‌شود، اما بدون اعمال کدگذاری انتقال محتوا (Content Transfer Encoding) بر هیچ‌یک از نویسه‌های غیر ASCII. اگر ``display_name`` وجود نداشته باشد و تنها یک ``Address`` در فهرست ``addresses`` وجود داشته باشد، مقدار ``str`` برابر با ``str`` همان ``Address`` تنها خواهد بود."

msgid "Footnotes"
msgstr "پانویس‌ها"

msgid "Originally added in 3.3 as a :term:`provisional module <provisional package>`"
msgstr "در ابتدا در 3.3 به‌عنوان یک :term:`ماژول موقتی <provisional package>` افزوده شد"