bz2.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:
# Rafael Fontenelle <rffontenelle@gmail.com>, 2025
# Revisto <theRevisto@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-16 12:56+0000\n"
"PO-Revision-Date: 2026-09-14 09:05+0330\n"
"Last-Translator: Sepehr Rasouli <sepehrrasouli06@gmail.com>, 2026\n"
"Language-Team: Persian (https://github.com/python/python-docs-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:`!bz2` --- Support for :program:`bzip2` compression"
msgstr ":mod:`!bz2` --- پشتیبانی از فشرده‌سازی :program:`bzip2`"

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

msgid "This module provides a comprehensive interface for compressing and decompressing data using the bzip2 compression algorithm."
msgstr "این ماژول یک رابط جامع برای فشرده‌سازی و واگشایی داده‌ها با استفاده از الگوریتم فشرده‌سازی bzip2 فراهم می‌کند."

msgid "The :mod:`!bz2` module contains:"
msgstr "ماژول :mod:`!bz2` شامل موارد زیر است:"

msgid "The :func:`.open` function and :class:`BZ2File` class for reading and writing compressed files."
msgstr "تابع :func:`.open` و کلاس :class:`BZ2File` برای خواندن و نوشتن پرونده‌های فشرده."

msgid "The :class:`BZ2Compressor` and :class:`BZ2Decompressor` classes for incremental (de)compression."
msgstr "کلاس‌های :class:`BZ2Compressor` و :class:`BZ2Decompressor` برای فشرده‌سازی/واگشایی تدریجی."

msgid "The :func:`compress` and :func:`decompress` functions for one-shot (de)compression."
msgstr "توابع :func:`compress` و :func:`decompress` برای فشرده‌سازی/واگشایی یک‌باره."

msgid "This is an :term:`optional module`. If it is missing from your copy of CPython, look for documentation from your distributor (that is, whoever provided Python to you). If you are the distributor, see :ref:`optional-module-requirements`."
msgstr "این یک :term:`optional module` است. اگر در نسخه CPython شما وجود ندارد، برای مستندات به توزیع‌کننده خود (یعنی هر کسی که پایتون را در اختیار شما قرار داده است) مراجعه کنید. اگر شما توزیع‌کننده هستید، :ref:`optional-module-requirements` را ببینید."

msgid "(De)compression of files"
msgstr "فشرده‌سازی و واگشایی پرونده‌ها"

msgid "Open a bzip2-compressed file in binary or text mode, returning a :term:`file object`."
msgstr "یک پرونده فشرده‌شده با bzip2 را در حالت دودویی یا متنی باز می‌کند و یک :term:`file object` بازمی‌گرداند."

msgid "As with the constructor for :class:`BZ2File`, the *filename* argument can be an actual filename (a :class:`str` or :class:`bytes` object), or an existing file object to read from or write to."
msgstr "مانند سازنده‌ی :class:`BZ2File`، آرگومان *filename* می‌تواند یک نام پرونده واقعی (یک شیء :class:`str` یا :class:`bytes`)، یا یک شیء پرونده موجود برای خواندن از آن یا نوشتن در آن باشد."

msgid "The *mode* argument can be any of ``'r'``, ``'rb'``, ``'w'``, ``'wb'``, ``'x'``, ``'xb'``, ``'a'`` or ``'ab'`` for binary mode, or ``'rt'``, ``'wt'``, ``'xt'``, or ``'at'`` for text mode. The default is ``'rb'``."
msgstr "آرگومان *mode* می‌تواند برای حالت دودویی هر یک از ``'r'``، ``'rb'``، ``'w'``، ``'wb'``، ``'x'``، ``'xb'``، ``'a'`` یا ``'ab'``، یا برای حالت متنی هر یک از ``'rt'``، ``'wt'``، ``'xt'`` یا ``'at'`` باشد. مقدار پیش‌فرض ``'rb'`` است."

msgid "The *compresslevel* argument is an integer from 1 to 9, as for the :class:`BZ2File` constructor."
msgstr "آرگومان *compresslevel* یک عدد صحیح از ۱ تا ۹ است، همان‌طور که برای سازنده‌ی :class:`BZ2File` نیز وجود دارد."

msgid "For binary mode, this function is equivalent to the :class:`BZ2File` constructor: ``BZ2File(filename, mode, compresslevel=compresslevel)``. In this case, the *encoding*, *errors* and *newline* arguments must not be provided."
msgstr "برای حالت دودویی، این تابع معادل سازنده‌ی :class:`BZ2File` است: ``BZ2File(filename, mode, compresslevel=compresslevel)``. در این حالت، نباید آرگومان‌های *encoding*، *errors* و *newline* ارائه شوند."

msgid "For text mode, a :class:`BZ2File` object is created, and wrapped in an :class:`io.TextIOWrapper` instance with the specified encoding, error handling behavior, and line ending(s)."
msgstr "برای حالت متنی، یک شیء :class:`BZ2File` ایجاد می‌شود و در نمونه‌ای از :class:`io.TextIOWrapper` با کدگذاری، رفتار مدیریت خطا و پایان(های) خط مشخص‌شده، دربرگرفته می‌شود."

msgid "The ``'x'`` (exclusive creation) mode was added."
msgstr "حالت ``'x'`` (ایجاد انحصاری) افزوده شد."

msgid "Accepts a :term:`path-like object`."
msgstr "یک :term:`path-like object` را می‌پذیرد."

msgid "Open a bzip2-compressed file in binary mode."
msgstr "باز کردن یک پرونده فشرده‌شده با bzip2 در حالت دودویی."

msgid "If *filename* is a :class:`str` or :class:`bytes` object, open the named file directly. Otherwise, *filename* should be a :term:`file object`, which will be used to read or write the compressed data."
msgstr "اگر *filename* یک شیء :class:`str` یا :class:`bytes` باشد، پرونده نام‌گذاری‌شده مستقیماً باز می‌شود. در غیر این صورت، *filename* باید یک :term:`file object` باشد که برای خواندن یا نوشتن داده‌های فشرده استفاده می‌شود."

msgid "The *mode* argument can be either ``'r'`` for reading (default), ``'w'`` for overwriting, ``'x'`` for exclusive creation, or ``'a'`` for appending. These can equivalently be given as ``'rb'``, ``'wb'``, ``'xb'`` and ``'ab'`` respectively."
msgstr "آرگومان *mode* می‌تواند ``'r'`` برای خواندن (پیش‌فرض)، ``'w'`` برای بازنویسی، ``'x'`` برای ایجاد انحصاری، یا ``'a'`` برای الحاق باشد. این موارد می‌توانند به‌طور معادل به‌ترتیب به‌صورت ``'rb'``، ``'wb'``، ``'xb'`` و ``'ab'`` داده شوند."

msgid "If *filename* is a file object (rather than an actual file name), a mode of ``'w'`` does not truncate the file, and is instead equivalent to ``'a'``."
msgstr "اگر *filename* یک شیء پرونده باشد (نه یک نام پرونده واقعی)، حالت ``'w'`` پرونده را کوتاه نمی‌کند و در عوض معادل ``'a'`` است."

msgid "If *mode* is ``'w'`` or ``'a'``, *compresslevel* can be an integer between ``1`` and ``9`` specifying the level of compression: ``1`` produces the least compression, and ``9`` (default) produces the most compression."
msgstr "اگر *mode* برابر ``'w'`` یا ``'a'`` باشد، *compresslevel* می‌تواند عدد صحیحی بین ``1`` و ``9`` باشد که سطح فشرده‌سازی را مشخص می‌کند: ``1`` کمترین میزان فشرده‌سازی را ایجاد می‌کند و ``9`` (پیش‌فرض) بیشترین میزان فشرده‌سازی را ایجاد می‌کند."

msgid "If *mode* is ``'r'``, the input file may be the concatenation of multiple compressed streams."
msgstr "اگر *mode* برابر ``'r'`` باشد، پرونده ورودی ممکن است حاصل الحاق چند جریان فشرده باشد."

msgid ":class:`BZ2File` provides all of the members specified by the :class:`io.BufferedIOBase`, except for :meth:`~io.BufferedIOBase.detach` and :meth:`~io.IOBase.truncate`. Iteration and the :keyword:`with` statement are supported."
msgstr "کلاس :class:`BZ2File` تمام اعضای مشخص‌شده توسط :class:`io.BufferedIOBase` را فراهم می‌کند، به‌جز :meth:`~io.BufferedIOBase.detach` و :meth:`~io.IOBase.truncate`. پیمایش و دستور :keyword:`with` پشتیبانی می‌شوند."

msgid ":class:`BZ2File` also provides the following methods and attributes:"
msgstr ":class:`BZ2File` همچنین متدها و ویژگی‌های زیر را ارائه می‌دهد:"

msgid "Return buffered data without advancing the file position. At least one byte of data will be returned (unless at EOF). The exact number of bytes returned is unspecified."
msgstr "داده‌های بافرشده را بدون جلو بردن موقعیت پرونده برمی‌گرداند. حداقل یک بایت داده برگردانده خواهد شد (مگر در EOF). تعداد دقیق بایت‌های برگردانده‌شده نامشخص است."

msgid "While calling :meth:`peek` does not change the file position of the :class:`BZ2File`, it may change the position of the underlying file object (e.g. if the :class:`BZ2File` was constructed by passing a file object for *filename*)."
msgstr "اگرچه فراخوانی :meth:`peek` موقعیت فایلِ :class:`BZ2File` را تغییر نمی‌دهد، اما ممکن است موقعیت شیء پرونده زیربنایی را تغییر دهد (برای مثال، اگر :class:`BZ2File` با ارسال یک شیء پرونده برای *filename* ساخته شده باشد)."

msgid "Return the file descriptor for the underlying file."
msgstr "توصیف‌گر پرونده مربوط به پرونده زیربنایی را برمی‌گرداند."

msgid "Return whether the file was opened for reading."
msgstr "برمی‌گرداند که آیا پرونده برای خواندن باز شده است."

msgid "Return whether the file supports seeking."
msgstr "برمی‌گرداند که آیا پرونده از مکان‌یابی (seeking) پشتیبانی می‌کند."

msgid "Return whether the file was opened for writing."
msgstr "برمی‌گرداند که آیا پرونده برای نوشتن باز شده است یا خیر."

msgid "Read up to *size* uncompressed bytes, while trying to avoid making multiple reads from the underlying stream. Reads up to a buffer's worth of data if size is negative."
msgstr "تا *size* بایت فشرده‌نشده را می‌خواند، در حالی که تلاش می‌کند از انجام چندین عملیات خواندن از جریان زیرین اجتناب کند. اگر size منفی باشد، تا اندازه‌ی یک بافر داده می‌خواند."

msgid "Returns ``b''`` if the file is at EOF."
msgstr "اگر پرونده در EOF باشد، ``b''`` را برمی‌گرداند."

msgid "Read bytes into *b*."
msgstr "بایت‌ها را در *b* بخوانید."

msgid "Returns the number of bytes read (0 for EOF)."
msgstr "تعداد بایت‌های خوانده‌شده را برمی‌گرداند (۰ برای EOF)."

msgid "``'rb'`` for reading and ``'wb'`` for writing."
msgstr "``'rb'`` برای خواندن و ``'wb'`` برای نوشتن."

msgid "The bzip2 file name.  Equivalent to the :attr:`~io.FileIO.name` attribute of the underlying :term:`file object`."
msgstr "نام پرونده bzip2. معادل ویژگی :attr:`~io.FileIO.name` در :term:`file object` زیربنایی است."

msgid "Support for the :keyword:`with` statement was added."
msgstr "پشتیبانی از دستور :keyword:`with` افزوده شد."

msgid "Support was added for *filename* being a :term:`file object` instead of an actual filename."
msgstr "پشتیبانی برای اینکه *filename* به‌جای یک نام پرونده واقعی، یک :term:`file object` باشد، اضافه شد."

msgid "The ``'a'`` (append) mode was added, along with support for reading multi-stream files."
msgstr "حالت ``'a'`` (الحاق) افزوده شد، به همراه پشتیبانی از خواندن پرونده‌های چندجریانی (multi-stream)."

msgid "The :meth:`~io.BufferedIOBase.read` method now accepts an argument of ``None``."
msgstr "متد :meth:`~io.BufferedIOBase.read` اکنون آرگومانی با مقدار ``None`` را می‌پذیرد."

msgid "The *buffering* parameter has been removed. It was ignored and deprecated since Python 3.0. Pass an open file object to control how the file is opened."
msgstr "پارامتر *buffering* حذف شده است. این پارامتر از Python 3.0 نادیده گرفته می‌شد و منسوخ بود. برای کنترل چگونگی باز شدن پرونده، یک شیء پرونده باز را پاس دهید."

msgid "The *compresslevel* parameter became keyword-only."
msgstr "پارامتر *compresslevel* فقط کلیدواژه‌ای شد."

msgid "This class is thread unsafe in the face of multiple simultaneous readers or writers, just like its equivalent classes in :mod:`gzip` and :mod:`lzma` have always been."
msgstr "این کلاس در مواجهه با چندین خواننده یا نویسنده همزمان، از نظر نخی ایمن نیست، همان‌طور که کلاس‌های معادل آن در :mod:`gzip` و :mod:`lzma` همیشه بوده‌اند."

msgid "Incremental (de)compression"
msgstr "فشرده‌سازی و واگشایی تدریجی"

msgid "Create a new compressor object. This object may be used to compress data incrementally. For one-shot compression, use the :func:`compress` function instead."
msgstr "یک شیء فشرده‌ساز جدید ایجاد کنید. این شیء می‌تواند برای فشرده‌سازی تدریجی داده‌ها استفاده شود. برای فشرده‌سازی یکجا، به‌جای آن از تابع :func:`compress` استفاده کنید."

msgid "*compresslevel*, if given, must be an integer between ``1`` and ``9``. The default is ``9``."
msgstr "*compresslevel*، در صورت داده شدن، باید یک عدد صحیح بین ``1`` و ``9`` باشد. مقدار پیش‌فرض ``9`` است."

msgid "Provide data to the compressor object. Returns a chunk of compressed data if possible, or an empty byte string otherwise."
msgstr "داده را به شیء فشرده‌ساز ارائه دهید. در صورت امکان تکه‌ای از داده فشرده برمی‌گرداند، در غیر این صورت یک رشته بایتی خالی برمی‌گرداند."

msgid "When you have finished providing data to the compressor, call the :meth:`flush` method to finish the compression process."
msgstr "هنگامی که ارائه داده به فشرده‌ساز را به پایان رساندید، متد :meth:`flush` را فراخوانی کنید تا فرآیند فشرده‌سازی به پایان برسد."

msgid "Finish the compression process. Returns the compressed data left in internal buffers."
msgstr "فرایند فشرده‌سازی را به پایان می‌رساند. داده‌های فشرده‌ی باقی‌مانده در بافرهای داخلی را برمی‌گرداند."

msgid "The compressor object may not be used after this method has been called."
msgstr "پس از فراخوانی این متد، نمی‌توان از شیء فشرده‌ساز استفاده کرد."

msgid "Create a new decompressor object. This object may be used to decompress data incrementally. For one-shot compression, use the :func:`decompress` function instead."
msgstr "یک شیء واگشا (decompressor) جدید ایجاد کنید. این شیء می‌تواند برای واگشایی داده‌ها به‌صورت تدریجی استفاده شود. برای فشرده‌سازی یک‌باره، به‌جای آن از تابع :func:`decompress` استفاده کنید."

msgid "This class does not transparently handle inputs containing multiple compressed streams, unlike :func:`decompress` and :class:`BZ2File`. If you need to decompress a multi-stream input with :class:`BZ2Decompressor`, you must use a new decompressor for each stream."
msgstr "این کلاس، برخلاف :func:`decompress` و :class:`BZ2File`، ورودی‌های حاوی چندین جریان فشرده را به‌صورت شفاف مدیریت نمی‌کند. اگر نیاز دارید یک ورودی حاوی چند جریان را با :class:`BZ2Decompressor` واگشایی کنید، باید برای هر جریان از یک واگشای جدید استفاده کنید."

msgid "Decompress *data* (a :term:`bytes-like object`), returning uncompressed data as bytes. Some of *data* may be buffered internally, for use in later calls to :meth:`decompress`. The returned data should be concatenated with the output of any previous calls to :meth:`decompress`."
msgstr "*data* (یک :term:`bytes-like object`) را واگشایی می‌کند و داده‌ی فشرده‌نشده را به‌صورت بایت برمی‌گرداند. ممکن است بخشی از *data* در بافر داخلی نگه‌داری شود، تا در فراخوانی‌های بعدی :meth:`decompress` استفاده شود. داده‌ی برگردانده‌شده باید با خروجی هر فراخوانی قبلی :meth:`decompress` الحاق شود."

msgid "If *max_length* is nonnegative, returns at most *max_length* bytes of decompressed data. If this limit is reached and further output can be produced, the :attr:`~.needs_input` attribute will be set to ``False``. In this case, the next call to :meth:`~.decompress` may provide *data* as ``b''`` to obtain more of the output."
msgstr "اگر *max_length* منفی نباشد، حداکثر *max_length* بایت از داده‌ی خارج‌شده از حالت فشرده را برمی‌گرداند. اگر به این حد برسد و امکان تولید خروجی بیشتری وجود داشته باشد، ویژگی :attr:`~.needs_input` روی ``False`` تنظیم می‌شود. در این حالت، می‌توانید در فراخوانی بعدی :meth:`~.decompress` برای دریافت خروجی بیشتر، *data* را به‌صورت ``b''`` ارائه دهید."

msgid "If all of the input data was decompressed and returned (either because this was less than *max_length* bytes, or because *max_length* was negative), the :attr:`~.needs_input` attribute will be set to ``True``."
msgstr "اگر تمام داده‌های ورودی واگشایی شده و بازگردانده شده باشند (چه به این دلیل که داده‌ها کمتر از *max_length* بایت بودند و چه به این دلیل که *max_length* منفی بود)، ویژگی :attr:`~.needs_input` روی ``True`` تنظیم خواهد شد."

msgid "Attempting to decompress data after the end of stream is reached raises an :exc:`EOFError`.  Any data found after the end of the stream is ignored and saved in the :attr:`~.unused_data` attribute."
msgstr "تلاش برای واگشایی داده‌ها پس از رسیدن به پایان جریان، باعث پرتاب یک :exc:`EOFError` می‌شود. هر داده‌ای که پس از پایان جریان یافت شود، نادیده گرفته می‌شود و در ویژگی :attr:`~.unused_data` ذخیره می‌شود."

msgid "Added the *max_length* parameter."
msgstr "پارامتر *max_length* افزوده شد."

msgid "``True`` if the end-of-stream marker has been reached."
msgstr "اگر به نشانگر پایان جریان رسیده باشد، ``True`` است."

msgid "Data found after the end of the compressed stream."
msgstr "داده‌ای پس از پایان جریان فشرده یافت شد."

msgid "If this attribute is accessed before the end of the stream has been reached, its value will be ``b''``."
msgstr "اگر پیش از رسیدن به پایان جریان به این ویژگی دسترسی پیدا کنید، مقدار آن ``b''`` خواهد بود."

msgid "``False`` if the :meth:`.decompress` method can provide more decompressed data before requiring new uncompressed input."
msgstr "``False`` اگر متد :meth:`.decompress` بتواند پیش از نیاز به ورودی فشرده‌نشده‌ی جدید، داده‌ی واگشایی‌شده‌ی بیشتری فراهم کند."

msgid "One-shot (de)compression"
msgstr "فشرده‌سازی/واگشایی یک‌باره"

msgid "Compress *data*, a :term:`bytes-like object <bytes-like object>`."
msgstr "فشرده‌سازی *data*، یک :term:`شیء شبه‌بایت <bytes-like object>`."

msgid "For incremental compression, use a :class:`BZ2Compressor` instead."
msgstr "برای فشرده‌سازی افزایشی، در عوض از :class:`BZ2Compressor` استفاده کنید."

msgid "Decompress *data*, a :term:`bytes-like object <bytes-like object>`."
msgstr "واگشایی *data*، یک :term:`شیء شبه‌بایت (bytes-like object) <bytes-like object>`."

msgid "If *data* is the concatenation of multiple compressed streams, decompress all of the streams."
msgstr "اگر *data* حاصل الحاق چندین جریان فشرده باشد، تمام جریان‌ها را از حالت فشرده خارج می‌کند."

msgid "For incremental decompression, use a :class:`BZ2Decompressor` instead."
msgstr "برای واگشایی افزایشی، به‌جای آن از :class:`BZ2Decompressor` استفاده کنید."

msgid "Support for multi-stream inputs was added."
msgstr "پشتیبانی از ورودی‌های چندجریانی (multi-stream) اضافه شد."

msgid "Examples of usage"
msgstr "نمونه‌های استفاده"

msgid "Below are some examples of typical usage of the :mod:`!bz2` module."
msgstr "در زیر چند نمونه از کاربرد معمول ماژول :mod:`!bz2` آمده است."

msgid "Using :func:`compress` and :func:`decompress` to demonstrate round-trip compression:"
msgstr "استفاده از :func:`compress` و :func:`decompress` برای نمایش فشرده‌سازی رفت‌وبرگشتی:"

msgid "Using :class:`BZ2Compressor` for incremental compression:"
msgstr "استفاده از :class:`BZ2Compressor` برای فشرده‌سازی تدریجی:"

msgid "The example above uses a very \"nonrandom\" stream of data (a stream of ``b\"z\"`` chunks).  Random data tends to compress poorly, while ordered, repetitive data usually yields a high compression ratio."
msgstr "مثال بالا از یک جریان داده بسیار «غیرتصادفی» استفاده می‌کند (جریانی از تکه‌های ``b\"z\"``). داده‌های تصادفی معمولاً به‌خوبی فشرده نمی‌شوند، در حالی که داده‌های منظم و تکراری معمولاً نسبت فشرده‌سازی بالایی دارند."

msgid "Writing and reading a bzip2-compressed file in binary mode:"
msgstr "نوشتن و خواندن یک پرونده فشرده‌شده با bzip2 در حالت دودویی:"