shutil.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
# 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:25+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:`!shutil` --- High-level file operations"
msgstr ":mod:`!shutil` --- عملیات پرونده سطح‌بالا"

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

msgid "The :mod:`!shutil` module offers a number of high-level operations on files and collections of files.  In particular, functions are provided  which support file copying and removal. For operations on individual files, see also the :mod:`os` module."
msgstr "ماژول :mod:`!shutil` تعدادی عملیات سطح بالا روی پرونده‌ها و مجموعه‌هایی از پرونده‌ها ارائه می‌دهد. به‌ویژه، توابعی فراهم شده‌اند که از کپی و حذف پرونده پشتیبانی می‌کنند. برای عملیات روی پرونده‌های منفرد، ماژول :mod:`os` را نیز ببینید."

msgid "Even the higher-level file copying functions (:func:`shutil.copy`, :func:`shutil.copy2`) cannot copy all file metadata."
msgstr "حتی توابع سطح بالاتر کپی پرونده (:func:`shutil.copy`، :func:`shutil.copy2`) نمی‌توانند تمام فراداده‌های پرونده را کپی کنند."

msgid "On POSIX platforms, this means that file owner and group are lost as well as ACLs.  On Mac OS, the resource fork and other metadata are not used. This means that resources will be lost and file type and creator codes will not be correct. On Windows, file owners, ACLs and alternate data streams are not copied."
msgstr "در پلتفرم‌های POSIX، این بدان معناست که مالک و گروه پرونده و همچنین فهرست‌های کنترل دسترسی (ACL) از دست می‌روند. در Mac OS، شاخه‌ی منبع (resource fork) و سایر فراداده‌ها استفاده نمی‌شوند. این بدان معناست که منابع از دست خواهند رفت و کدهای نوع پرونده و ایجادکننده صحیح نخواهند بود. در Windows، مالکان پرونده، فهرست‌های کنترل دسترسی (ACL) و جریان‌های داده جایگزین (alternate data streams) کپی نمی‌شوند."

msgid "Directory and files operations"
msgstr "عملیات پوشه‌ها و پرونده‌ها"

msgid "Copy the contents of the :term:`file-like object <file object>` *fsrc* to the file-like object *fdst*. The integer *length*, if given, is the buffer size. In particular, a negative *length* value means to copy the data without looping over the source data in chunks; by default the data is read in chunks to avoid uncontrolled memory consumption. Note that if the current file position of the *fsrc* object is not 0, only the contents from the current file position to the end of the file will be copied."
msgstr "محتویات :term:`شیء شبه‌پرونده <file object>` *fsrc* را به شیء شبه‌پرونده *fdst* کپی کنید. عدد صحیح *length*، اگر داده شود، اندازه‌ی بافر است. به‌ویژه، مقدار منفی *length* به معنای کپی کردن داده‌ها بدون حلقه‌زدن روی داده‌های منبع به‌صورت تکه‌تکه است؛ به‌طور پیش‌فرض، داده‌ها به‌صورت تکه‌تکه خوانده می‌شوند تا از مصرف حافظه‌ی کنترل‌نشده جلوگیری شود. توجه داشته باشید که اگر موقعیت فعلی پرونده در شیء *fsrc* برابر ۰ نباشد، تنها محتویات از موقعیت فعلی پرونده تا پایان پرونده کپی خواهند شد."

msgid ":func:`copyfileobj` will *not* guarantee that the destination stream has been flushed on completion of the copy. If you want to read from the destination at the completion of the copy operation (for example, reading the contents of a temporary file that has been copied from a HTTP stream), you must ensure that you have called :func:`~io.IOBase.flush` or :func:`~io.IOBase.close` on the file-like object before attempting to read the destination file."
msgstr ":func:`copyfileobj` ضمانت *نمی‌کند* که جریان مقصد در پایان کپی تخلیه شده باشد. اگر می‌خواهید در پایان عملیات کپی از مقصد بخوانید (برای مثال، محتوای یک پرونده موقت را بخوانید که از یک جریان HTTP کپی شده است)، باید اطمینان حاصل کنید که پیش از تلاش برای خواندن پرونده مقصد، :func:`~io.IOBase.flush` یا :func:`~io.IOBase.close` را روی شیء شبه‌پرونده فراخوانی کرده‌اید."

msgid "Copy the contents (no metadata) of the file named *src* to a file named *dst* and return *dst* in the most efficient way possible. *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings."
msgstr "محتوای پرونده‌ای به نام *src* (بدون فراداده) را در پرونده‌ای به نام *dst* کپی می‌کند و *dst* را به کارآمدترین شکل ممکن برمی‌گرداند. *src* و *dst* یا :term:`اشیاء مسیرمانند (path-like objects) <path-like object>` هستند یا نام‌های مسیری که به‌صورت رشته داده شده‌اند."

msgid "*dst* must be the complete target file name; look at :func:`~shutil.copy` for a copy that accepts a target directory path.  If *src* and *dst* specify the same file, :exc:`SameFileError` is raised."
msgstr "*dst* باید نام کامل پرونده مقصد باشد؛ برای کپی‌ای که مسیر پوشه مقصد را می‌پذیرد، به :func:`~shutil.copy` مراجعه کنید. اگر *src* و *dst* یک پرونده را مشخص کنند، :exc:`SameFileError` پرتاب می‌شود."

msgid "The destination location must be writable; otherwise, an :exc:`OSError` exception will be raised. If *dst* already exists, it will be replaced. Special files such as character or block devices and pipes cannot be copied with this function."
msgstr "محل مقصد باید قابل نوشتن باشد؛ در غیر این صورت، استثنای :exc:`OSError` پرتاب خواهد شد. اگر *dst* از قبل وجود داشته باشد، جایگزین خواهد شد. پرونده‌های خاص مانند دستگاه‌های نویسه‌ای یا بلوکی و پایپ‌ها را نمی‌توان با این تابع کپی کرد."

msgid "If *follow_symlinks* is false and *src* is a symbolic link, a new symbolic link will be created instead of copying the file *src* points to."
msgstr "اگر *follow_symlinks* نادرست باشد و *src* یک پیوند نمادین باشد، به‌جای کپی کردن پرونده‌ای که *src* به آن اشاره دارد، یک پیوند نمادین جدید ایجاد خواهد شد."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.copyfile`` with arguments ``src``, ``dst``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.copyfile`` را با آرگومان‌های ``src`` و ``dst`` پرتاب می‌کند."

msgid ":exc:`IOError` used to be raised instead of :exc:`OSError`. Added *follow_symlinks* argument. Now returns *dst*."
msgstr "پیش‌تر :exc:`IOError` به جای :exc:`OSError` پرتاب می‌شد. آرگومان *follow_symlinks* افزوده شد. اکنون *dst* را برمی‌گرداند."

msgid "Raise :exc:`SameFileError` instead of :exc:`Error`.  Since the former is a subclass of the latter, this change is backward compatible."
msgstr ":exc:`SameFileError` به‌جای :exc:`Error` پرتاب می‌شود. از آن‌جا که اولی زیرکلاسی از دومی است، این تغییر سازگار با عقب است."

msgid "Platform-specific fast-copy syscalls may be used internally in order to copy the file more efficiently. See :ref:`shutil-platform-dependent-efficient-copy-operations` section."
msgstr "ممکن است از فراخوانی‌های سیستمی کپی سریع مختص پلتفرم به‌صورت داخلی استفاده شود تا پرونده با کارایی بیشتری کپی شود. بخش :ref:`shutil-platform-dependent-efficient-copy-operations` را ببینید."

msgid "This exception is raised when :func:`copyfile` or :func:`copytree` attempt to copy a named pipe."
msgstr "این استثنا هنگامی پرتاب می‌شود که :func:`copyfile` یا :func:`copytree` برای کپی کردن یک پایپ نام‌دار تلاش کند."

msgid "This exception is raised if source and destination in :func:`copyfile` are the same file."
msgstr "این استثنا زمانی پرتاب می‌شود که مبدأ و مقصد در :func:`copyfile` یک پرونده باشند."

msgid "Copy the permission bits from *src* to *dst*.  The file contents, owner, and group are unaffected.  *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings. If *follow_symlinks* is false, and both *src* and *dst* are symbolic links, :func:`copymode` will attempt to modify the mode of *dst* itself (rather than the file it points to).  This functionality is not available on every platform; please see :func:`copystat` for more information.  If :func:`copymode` cannot modify symbolic links on the local platform, and it is asked to do so, it will do nothing and return."
msgstr "بیت‌های دسترسی را از *src* به *dst* کپی می‌کند. محتوای پرونده، مالک و گروه بدون تغییر باقی می‌مانند. *src* و *dst* :term:`اشیای شبه‌مسیر <path-like object>` یا نام‌های مسیر هستند که به‌صورت رشته داده شده‌اند. اگر *follow_symlinks* نادرست باشد و هر دو *src* و *dst* پیوندهای نمادین باشند، :func:`copymode` تلاش می‌کند حالت خود *dst* را تغییر دهد (نه پرونده‌ای که به آن اشاره می‌کند). این قابلیت در همه سکوها در دسترس نیست؛ لطفاً برای اطلاعات بیشتر :func:`copystat` را ببینید. اگر :func:`copymode` نتواند پیوندهای نمادین را در سکوی محلی تغییر دهد و از آن خواسته شود که این کار را انجام دهد، هیچ کاری انجام نمی‌دهد و بازمی‌گردد."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.copymode`` with arguments ``src``, ``dst``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.copymode`` را با آرگومان‌های ``src`` و ``dst`` پرتاب می‌کند."

msgid "Added *follow_symlinks* argument."
msgstr "آرگومان *follow_symlinks* افزوده شد."

msgid "Copy the permission bits, last access time, last modification time, and flags from *src* to *dst*.  On Linux, :func:`copystat` also copies the \"extended attributes\" where possible.  The file contents, owner, and group are unaffected.  *src* and *dst* are :term:`path-like objects <path-like object>` or path names given as strings."
msgstr "بیت‌های اجازه، زمان آخرین دسترسی، زمان آخرین تغییر و پرچم‌ها را از *src* به *dst* کپی می‌کند. در لینوکس، :func:`copystat` همچنین «ویژگی‌های توسعه‌یافته» را در صورت امکان کپی می‌کند. محتوای پرونده، مالک و گروه بدون تغییر می‌مانند. *src* و *dst* :term:`اشیاء مسیرمانند <path-like object>` یا نام‌های مسیر داده‌شده به‌صورت رشته هستند."

msgid "If *follow_symlinks* is false, and *src* and *dst* both refer to symbolic links, :func:`copystat` will operate on the symbolic links themselves rather than the files the symbolic links refer to—reading the information from the *src* symbolic link, and writing the information to the *dst* symbolic link."
msgstr "اگر *follow_symlinks* نادرست باشد و *src* و *dst* هر دو به پیوندهای نمادین اشاره کنند، :func:`copystat` به‌جای پرونده‌هایی که پیوندهای نمادین به آن‌ها اشاره می‌کنند، روی خود پیوندهای نمادین عمل می‌کند؛ اطلاعات را از پیوند نمادین *src* می‌خواند و اطلاعات را در پیوند نمادین *dst* می‌نویسد."

msgid "Not all platforms provide the ability to examine and modify symbolic links.  Python itself can tell you what functionality is locally available."
msgstr "همه‌ی سکوها امکان بررسی و تغییر پیوندهای نمادین را فراهم نمی‌کنند. خود پایتون می‌تواند به شما بگوید چه قابلیت‌هایی به‌صورت محلی در دسترس است."

msgid "If ``os.chmod in os.supports_follow_symlinks`` is ``True``, :func:`copystat` can modify the permission bits of a symbolic link."
msgstr "اگر ``os.chmod in os.supports_follow_symlinks`` برابر ``True`` باشد، :func:`copystat` می‌تواند بیت‌های دسترسی یک پیوند نمادین را تغییر دهد."

msgid "If ``os.utime in os.supports_follow_symlinks`` is ``True``, :func:`copystat` can modify the last access and modification times of a symbolic link."
msgstr "اگر ``os.utime in os.supports_follow_symlinks`` برابر ``True`` باشد، :func:`copystat` می‌تواند زمان‌های آخرین دسترسی و تغییر یک پیوند نمادین را تغییر دهد."

msgid "If ``os.chflags in os.supports_follow_symlinks`` is ``True``, :func:`copystat` can modify the flags of a symbolic link.  (``os.chflags`` is not available on all platforms.)"
msgstr "اگر ``os.chflags in os.supports_follow_symlinks`` برابر ``True`` باشد، :func:`copystat` می‌تواند پرچم‌های یک پیوند نمادین را تغییر دهد. (``os.chflags`` در همه‌ی سکوها در دسترس نیست.)"

msgid "On platforms where some or all of this functionality is unavailable, when asked to modify a symbolic link, :func:`copystat` will copy everything it can. :func:`copystat` never returns failure."
msgstr "در سکوهایی که برخی یا همه‌ی این قابلیت‌ها در دسترس نیستند، هنگامی که از آن خواسته شود یک پیوند نمادین را تغییر دهد، :func:`copystat` هر آنچه را که بتواند کپی می‌کند. :func:`copystat` هرگز شکست برنمی‌گرداند."

msgid "Please see :data:`os.supports_follow_symlinks` for more information."
msgstr "برای اطلاعات بیشتر، :data:`os.supports_follow_symlinks` را ببینید."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.copystat`` with arguments ``src``, ``dst``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.copystat`` را با آرگومان‌های ``src``، ``dst`` پرتاب می‌کند."

msgid "Added *follow_symlinks* argument and support for Linux extended attributes."
msgstr "آرگومان *follow_symlinks* و پشتیبانی از ویژگی‌های گسترده‌ی لینوکس افزوده شد."

msgid "Copies the file *src* to the file or directory *dst*.  *src* and *dst* should be :term:`path-like objects <path-like object>` or strings.  If *dst* specifies a directory, the file will be copied into *dst* using the base filename from *src*. If *dst* specifies a file that already exists, it will be replaced. Returns the path to the newly created file."
msgstr "پرونده *src* را به پرونده یا پوشه‌ی *dst* کپی می‌کند. *src* و *dst* باید :term:`اشیای مسیرمانند (path-like object) <path-like object>` یا رشته‌ها باشند. اگر *dst* یک پوشه را مشخص کند، پرونده با استفاده از نام پایه‌ی پرونده *src* در *dst* کپی خواهد شد. اگر *dst* پرونده‌ای را مشخص کند که از قبل وجود دارد، آن پرونده جایگزین خواهد شد. مسیر پرونده تازه ایجادشده را برمی‌گرداند."

msgid "If *follow_symlinks* is false, and *src* is a symbolic link, *dst* will be created as a symbolic link.  If *follow_symlinks* is true and *src* is a symbolic link, *dst* will be a copy of the file *src* refers to."
msgstr "اگر *follow_symlinks* نادرست باشد و *src* یک پیوند نمادین باشد، *dst* به‌صورت یک پیوند نمادین ایجاد می‌شود. اگر *follow_symlinks* درست باشد و *src* یک پیوند نمادین باشد، *dst* یک کپی از پرونده‌ای خواهد بود که *src* به آن ارجاع می‌دهد."

msgid ":func:`~shutil.copy` copies the file data and the file's permission mode (see :func:`os.chmod`).  Other metadata, like the file's creation and modification times, is not preserved. To preserve all file metadata from the original, use :func:`~shutil.copy2` instead."
msgstr ":func:`~shutil.copy` داده‌های پرونده و حالت دسترسی پرونده (نگاه کنید به :func:`os.chmod`) را کپی می‌کند. سایر فراداده‌ها، مانند زمان‌های ایجاد و تغییر پرونده، حفظ نمی‌شوند. برای حفظ تمام فراداده‌های پرونده اصلی، به‌جای آن از :func:`~shutil.copy2` استفاده کنید."

msgid "Added *follow_symlinks* argument. Now returns path to the newly created file."
msgstr "آرگومان *follow_symlinks* اضافه شد. اکنون مسیر پرونده تازه ایجادشده را برمی‌گرداند."

msgid "Identical to :func:`~shutil.copy` except that :func:`copy2` also attempts to preserve file metadata."
msgstr "مشابه :func:`~shutil.copy` است، با این تفاوت که :func:`copy2` همچنین تلاش می‌کند فراداده پرونده را حفظ کند."

msgid "When *follow_symlinks* is false, and *src* is a symbolic link, :func:`copy2` attempts to copy all metadata from the *src* symbolic link to the newly created *dst* symbolic link. However, this functionality is not available on all platforms. On platforms where some or all of this functionality is unavailable, :func:`copy2` will preserve all the metadata it can; :func:`copy2` never raises an exception because it cannot preserve file metadata."
msgstr "هنگامی که *follow_symlinks* false باشد و *src* یک پیوند نمادین باشد، :func:`copy2` تلاش می‌کند همه‌ی فراداده‌ها را از پیوند نمادین *src* به پیوند نمادین تازه‌ایجادشده‌ی *dst* کپی کند. با این حال، این قابلیت در همه‌ی سکوها در دسترس نیست. در سکوهایی که بخشی یا همه‌ی این قابلیت در دسترس نیست، :func:`copy2` همه‌ی فراداده‌ای را که بتواند حفظ می‌کند؛ :func:`copy2` هرگز به این دلیل که نمی‌تواند فراداده‌ی پرونده را حفظ کند، استثنایی پرتاب نمی‌کند."

msgid ":func:`copy2` uses :func:`copystat` to copy the file metadata. Please see :func:`copystat` for more information about platform support for modifying symbolic link metadata."
msgstr ":func:`copy2` از :func:`copystat` برای کپی فراداده پرونده استفاده می‌کند. لطفاً برای اطلاعات بیشتر درباره پشتیبانی پلتفرم از تغییر فراداده پیوند نمادین، :func:`copystat` را ببینید."

msgid "Added *follow_symlinks* argument, try to copy extended file system attributes too (currently Linux only). Now returns path to the newly created file."
msgstr "آرگومان *follow_symlinks* افزوده شد، سعی می‌کند ویژگی‌های گسترش‌یافته‌ی سامانه فایل‌بندی را نیز کپی کند (در حال حاضر فقط در لینوکس). اکنون مسیر پرونده تازه‌ایجادشده را برمی‌گرداند."

msgid "This factory function creates a function that can be used as a callable for :func:`copytree`\\'s *ignore* argument, ignoring files and directories that match one of the glob-style *patterns* provided.  See the example below."
msgstr "این تابع کارخانه‌ای، تابعی ایجاد می‌کند که می‌توان از آن به‌عنوان یک شیء فراخوانی‌پذیر برای آرگومان *ignore* تابع :func:`copytree` استفاده کرد؛ این تابع، پرونده‌ها و پوشه‌هایی را که با یکی از الگوهای به‌سبک glob ارائه‌شده در *patterns* مطابقت دارند، نادیده می‌گیرد. مثال زیر را ببینید."

msgid "Recursively copy an entire directory tree rooted at *src* to a directory named *dst* and return the destination directory.  All intermediate directories needed to contain *dst* will also be created by default."
msgstr "به‌صورت بازگشتی کل درخت پوشه‌ای را که ریشه در *src* دارد، به پوشه‌ای به نام *dst* کپی کنید و پوشه مقصد را برگردانید. تمام پوشه‌های میانی لازم برای دربرگرفتن *dst* نیز به‌طور پیش‌فرض ایجاد خواهند شد."

msgid "Permissions and times of directories are copied with :func:`copystat`, individual files are copied using :func:`~shutil.copy2`."
msgstr "مجوزها و زمان‌های پوشه‌ها با :func:`copystat` کپی می‌شوند، پرونده‌های جداگانه با استفاده از :func:`~shutil.copy2` کپی می‌شوند."

msgid "If *symlinks* is true, symbolic links in the source tree are represented as symbolic links in the new tree and the metadata of the original links will be copied as far as the platform allows; if false or omitted, the contents and metadata of the linked files are copied to the new tree."
msgstr "اگر *symlinks* درست باشد، پیوندهای نمادین در درخت منبع به‌صورت پیوندهای نمادین در درخت جدید نمایش داده می‌شوند و فراداده‌ی پیوندهای اصلی تا جایی که سکو اجازه می‌دهد کپی خواهد شد؛ اگر نادرست باشد یا ذکر نشود، محتوا و فراداده‌ی پرونده‌های پیوندشده به درخت جدید کپی می‌شوند."

msgid "When *symlinks* is false, if the file pointed to by the symlink doesn't exist, an exception will be added in the list of errors raised in an :exc:`Error` exception at the end of the copy process. You can set the optional *ignore_dangling_symlinks* flag to true if you want to silence this exception. Notice that this option has no effect on platforms that don't support :func:`os.symlink`."
msgstr "هنگامی که *symlinks* نادرست باشد، اگر پرونده‌ای که پیوند نمادین به آن اشاره می‌کند وجود نداشته باشد، استثنایی به فهرست خطاهایی که در پایان فرآیند کپی در یک استثنای :exc:`Error` پرتاب می‌شود، افزوده خواهد شد. اگر می‌خواهید این استثنا را نادیده بگیرید، می‌توانید پرچم اختیاری *ignore_dangling_symlinks* را روی درست تنظیم کنید. توجه داشته باشید که این گزینه روی پلتفرم‌هایی که از :func:`os.symlink` پشتیبانی نمی‌کنند، تأثیری ندارد."

msgid "If *ignore* is given, it must be a callable that will receive as its arguments the directory being visited by :func:`copytree`, and a list of its contents, as returned by :func:`os.listdir`.  Since :func:`copytree` is called recursively, the *ignore* callable will be called once for each directory that is copied.  The callable must return a sequence of directory and file names relative to the current directory (i.e. a subset of the items in its second argument); these names will then be ignored in the copy process.  :func:`ignore_patterns` can be used to create such a callable that ignores names based on glob-style patterns."
msgstr "اگر *ignore* داده شود، باید یک شیء فراخوانی‌پذیر باشد که به‌عنوان آرگومان‌های خود، پوشه‌ای را که :func:`copytree` از آن بازدید می‌کند و فهرستی از محتویات آن را، همان‌طور که :func:`os.listdir` برمی‌گرداند، دریافت می‌کند. از آن‌جا که :func:`copytree` به‌صورت بازگشتی فراخوانی می‌شود، شیء فراخوانی‌پذیر *ignore* به‌ازای هر پوشه‌ای که کپی می‌شود، یک بار فراخوانی خواهد شد. این شیء فراخوانی‌پذیر باید دنباله‌ای از نام پوشه‌ها و پرونده‌ها را نسبت به پوشه جاری برگرداند (یعنی زیرمجموعه‌ای از آیتم‌های آرگومان دوم خود)؛ سپس این نام‌ها در فرایند کپی نادیده گرفته خواهند شد. می‌توان از :func:`ignore_patterns` برای ایجاد چنین شیء فراخوانی‌پذیری استفاده کرد که نام‌ها را بر اساس الگوهای به‌سبک glob نادیده می‌گیرد."

msgid "If exception(s) occur, an :exc:`Error` is raised with a list of reasons."
msgstr "اگر استثنا(هایی) رخ دهد، یک :exc:`Error` همراه با فهرستی از دلایل پرتاب می‌شود."

msgid "If *copy_function* is given, it must be a callable that will be used to copy each file. It will be called with the source path and the destination path as arguments. By default, :func:`~shutil.copy2` is used, but any function that supports the same signature (like :func:`~shutil.copy`) can be used."
msgstr "اگر *copy_function* ارائه شود، باید یک شیء فراخوانی‌پذیر باشد که برای کپی کردن هر پرونده از آن استفاده می‌شود. این شیء با مسیر مبدأ و مسیر مقصد به‌عنوان آرگومان‌ها فراخوانی می‌شود. به‌طور پیش‌فرض، :func:`~shutil.copy2` استفاده می‌شود، اما هر تابعی که از همان امضا پشتیبانی کند (مانند :func:`~shutil.copy`) می‌تواند استفاده شود."

msgid "If *dirs_exist_ok* is false (the default) and *dst* already exists, a :exc:`FileExistsError` is raised. If *dirs_exist_ok* is true, the copying operation will continue if it encounters existing directories, and files within the *dst* tree will be overwritten by corresponding files from the *src* tree."
msgstr "اگر *dirs_exist_ok* نادرست (پیش‌فرض) باشد و *dst* از قبل وجود داشته باشد، استثنای :exc:`FileExistsError` پرتاب می‌شود. اگر *dirs_exist_ok* درست باشد، عملیات کپی در صورت مواجهه با پوشه‌های موجود ادامه می‌یابد و پرونده‌های درون درخت *dst* توسط پرونده‌های متناظر از درخت *src* بازنویسی می‌شوند."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.copytree`` with arguments ``src``, ``dst``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.copytree`` را با آرگومان‌های ``src`` و ``dst`` پرتاب می‌کند."

msgid "Added the *copy_function* argument to be able to provide a custom copy function. Added the *ignore_dangling_symlinks* argument to silence dangling symlinks errors when *symlinks* is false."
msgstr "آرگومان *copy_function* افزوده شد تا بتوانید یک تابع کپی سفارشی ارائه دهید. آرگومان *ignore_dangling_symlinks* افزوده شد تا خطاهای پیوندهای نمادین معلق را هنگامی که *symlinks* برابر با false است، ساکت کند."

msgid "Copy metadata when *symlinks* is false. Now returns *dst*."
msgstr "هنگامی که *symlinks* نادرست باشد، فراداده کپی می‌شود. اکنون *dst* را برمی‌گرداند."

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

msgid "Delete an entire directory tree; *path* must point to a directory (but not a symbolic link to a directory).  If *ignore_errors* is true, errors resulting from failed removals will be ignored; if false or omitted, such errors are handled by calling a handler specified by *onexc* or *onerror* or, if both are omitted, exceptions are propagated to the caller."
msgstr "حذف یک درخت پوشه‌ی کامل؛ *path* باید به یک پوشه اشاره کند (اما نه به یک پیوند نمادین به پوشه). اگر *ignore_errors* درست باشد، خطاهای ناشی از حذف‌های ناموفق نادیده گرفته می‌شوند؛ اگر نادرست یا مشخص‌نشده باشد، چنین خطاهایی با فراخوانی هندلری که توسط *onexc* یا *onerror* مشخص‌شده است رسیدگی می‌شوند یا اگر هر دو مشخص‌نشده باشند، استثناها به فراخواننده انتشار می‌یابند."

msgid "This function can support :ref:`paths relative to directory descriptors <dir_fd>`."
msgstr "این تابع می‌تواند از :ref:`مسیرهای نسبی نسبت به توصیف‌گرهای پوشه <dir_fd>` پشتیبانی کند."

msgid "On platforms that support the necessary fd-based functions a symlink attack resistant version of :func:`rmtree` is used by default.  On other platforms, the :func:`rmtree` implementation is susceptible to a symlink attack: given proper timing and circumstances, attackers can manipulate symlinks on the filesystem to delete files they wouldn't be able to access otherwise.  Applications can use the :data:`rmtree.avoids_symlink_attacks` function attribute to determine which case applies."
msgstr "در پلتفرم‌هایی که توابع مبتنی بر fd لازم را پشتیبانی می‌کنند، به‌طور پیش‌فرض از نسخه‌ای از :func:`rmtree` استفاده می‌شود که در برابر حمله‌ی پیوند نمادین مقاوم است. در سایر پلتفرم‌ها، پیاده‌سازی :func:`rmtree` در برابر حمله‌ی پیوند نمادین آسیب‌پذیر است: با زمان‌بندی و شرایط مناسب، مهاجمان می‌توانند پیوندهای نمادین روی سامانه فایل‌بندی را دستکاری کنند تا پرونده‌هایی را حذف کنند که در غیر این صورت قادر به دسترسی به آن‌ها نخواهند بود. برنامه‌ها می‌توانند از ویژگی تابع :data:`rmtree.avoids_symlink_attacks` برای تعیین این‌که کدام حالت صدق می‌کند استفاده کنند."

msgid "If *onexc* is provided, it must be a callable that accepts three parameters: *function*, *path*, and *excinfo*."
msgstr "اگر *onexc* ارائه‌شده باشد، باید یک شیء فراخوانی‌پذیر باشد که سه پارامتر را می‌پذیرد: *function*، *path* و *excinfo*."

msgid "The first parameter, *function*, is the function which raised the exception; it depends on the platform and implementation.  The second parameter, *path*, will be the path name passed to *function*.  The third parameter, *excinfo*, is the exception that was raised. Exceptions raised by *onexc* will not be caught."
msgstr "نخستین پارامتر، *function*، تابعی است که استثنا را پرتاب کرده است؛ این تابع به پلتفرم و پیاده‌سازی بستگی دارد. دومین پارامتر، *path*، نام مسیر داده‌شده به *function* خواهد بود. سومین پارامتر، *excinfo*، استثنایی است که پرتاب شده است. استثناهای پرتاب‌شده از سوی *onexc* گرفته نخواهند شد."

msgid "The deprecated *onerror* is similar to *onexc*, except that the third parameter it receives is the tuple returned from :func:`sys.exc_info`."
msgstr "*onerror* منسوخ‌شده مشابه *onexc* است، با این تفاوت که سومین پارامتری که دریافت می‌کند، تاپل برگردانده‌شده از :func:`sys.exc_info` است."

msgid ":ref:`shutil-rmtree-example` for an example of handling the removal of a directory tree that contains read-only files."
msgstr ":ref:`shutil-rmtree-example` برای نمونه‌ای از مدیریت حذف درخت پوشه‌ای که شامل پرونده‌های فقط‌خواندنی است."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.rmtree`` with arguments ``path``, ``dir_fd``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.rmtree`` را با آرگومان‌های ``path`` و ``dir_fd`` پرتاب می‌کند."

msgid "Added a symlink attack resistant version that is used automatically if platform supports fd-based functions."
msgstr "نسخه‌ای مقاوم در برابر حمله‌ی پیوند نمادین افزوده شد که در صورت پشتیبانی سکو از توابع مبتنی بر fd، به‌طور خودکار استفاده می‌شود."

msgid "On Windows, will no longer delete the contents of a directory junction before removing the junction."
msgstr "در ویندوز، دیگر محتویات یک اتصالِ پوشه (directory junction) را پیش از حذف اتصال حذف نخواهد کرد."

msgid "Added the *dir_fd* parameter."
msgstr "پارامتر *dir_fd* اضافه شد."

msgid "Added the *onexc* parameter, deprecated *onerror*."
msgstr "پارامتر *onexc* افزوده شد، *onerror* منسوخ شد."

msgid ":func:`!rmtree` now ignores :exc:`FileNotFoundError` exceptions for all but the top-level path. Exceptions other than :exc:`OSError` and subclasses of :exc:`!OSError` are now always propagated to the caller."
msgstr ":func:`!rmtree` اکنون استثناهای :exc:`FileNotFoundError` را برای همه موارد به‌جز مسیر سطح بالا نادیده می‌گیرد. استثناهایی غیر از :exc:`OSError` و زیرکلاس‌های :exc:`!OSError` اکنون همیشه به فراخواننده منتقل می‌شوند."

msgid "Indicates whether the current platform and implementation provides a symlink attack resistant version of :func:`rmtree`.  Currently this is only true for platforms supporting fd-based directory access functions."
msgstr "نشان می‌دهد که آیا سکو و پیاده‌سازی فعلی، نسخه‌ای مقاوم در برابر حمله‌ی پیوند نمادین از :func:`rmtree` ارائه می‌دهند یا خیر. در حال حاضر، این موضوع فقط برای سکوهای پشتیبانی‌کننده از توابع دسترسی به پوشه مبتنی بر fd صادق است."

msgid "Recursively move a file or directory (*src*) to another location and return the destination."
msgstr "به‌صورت بازگشتی یک پرونده یا پوشه (*src*) را به مکان دیگری منتقل می‌کند و مقصد را برمی‌گرداند."

msgid "If *dst* is an existing directory or a symlink to a directory, then *src* is moved inside that directory. The destination path in that directory must not already exist."
msgstr "اگر *dst* یک پوشه موجود یا پیوند نمادین به یک پوشه باشد، آنگاه *src* به داخل آن پوشه منتقل می‌شود. مسیر مقصد در آن پوشه نباید از قبل وجود داشته باشد."

msgid "If *dst* already exists but is not a directory, it may be overwritten depending on :func:`os.rename` semantics."
msgstr "اگر *dst* از قبل وجود داشته باشد اما پوشه نباشد، ممکن است بسته به رفتار :func:`os.rename` بازنویسی شود."

msgid ":func:`os.rename` is preferably used internally when *src* and the destination are on the same filesystem. In case :func:`os.rename` fails due to :exc:`OSError` (e.g. the user has write permission to the destination file but not to its parent directory), this method falls back to using *copy_function*, in which case *src* is copied to the destination using *copy_function* and then removed."
msgstr ":func:`os.rename` ترجیحاً به‌صورت داخلی زمانی استفاده می‌شود که *src* و مقصد روی سامانه فایل‌بندی یکسانی باشند. در صورتی که :func:`os.rename` به‌دلیل :exc:`OSError` با شکست مواجه شود (مثلاً کاربر اجازه‌ی نوشتن روی پرونده مقصد را دارد اما اجازه‌ی نوشتن در پوشه‌ی والد آن را ندارد)، این متد به استفاده از *copy_function* روی می‌آورد؛ در این حالت *src* با استفاده از *copy_function* به مقصد کپی می‌شود و سپس حذف می‌گردد."

msgid "In case of symlinks, a new symlink pointing to the target of *src* will be created in or as the destination, and *src* will be removed."
msgstr "در مورد پیوندهای نمادین، یک پیوند نمادین جدید که به هدف *src* اشاره می‌کند، در مقصد یا به‌عنوان مقصد ایجاد خواهد شد و *src* حذف خواهد شد."

msgid "If *copy_function* is given, it must be a callable that takes two arguments, *src* and the destination, and will be used to copy *src* to the destination if :func:`os.rename` cannot be used.  If the source is a directory, :func:`copytree` is called, passing it the *copy_function*. The default *copy_function* is :func:`copy2`.  Using :func:`~shutil.copy` as the *copy_function* allows the move to succeed when it is not possible to also copy the metadata, at the expense of not copying any of the metadata."
msgstr "اگر *copy_function* داده شده باشد، باید یک شیء فراخوانی‌پذیر باشد که ۲ آرگومان *src* و مقصد را می‌گیرد و در صورتی که نتوان از :func:`os.rename` استفاده کرد، برای کپی *src* به مقصد از آن استفاده خواهد شد. اگر مبدأ یک پوشه باشد، :func:`copytree` فراخوانی می‌شود و *copy_function* به آن ارسال می‌شود. *copy_function* پیش‌فرض، :func:`copy2` است. استفاده از :func:`~shutil.copy` به‌عنوان *copy_function* اجازه می‌دهد جابه‌جایی در مواردی که کپی فراداده نیز ممکن نیست با موفقیت انجام شود، به بهای آنکه هیچ‌گونه فراداده‌ای کپی نمی‌شود."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.move`` with arguments ``src``, ``dst``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.move`` را با آرگومان‌های ``src`` و ``dst`` پرتاب می‌کند."

msgid "Added explicit symlink handling for foreign filesystems, thus adapting it to the behavior of GNU's :program:`mv`. Now returns *dst*."
msgstr "مدیریت صریح پیوندهای نمادین برای سامانه فایل‌بندی‌های خارجی اضافه شد، بدین ترتیب آن با رفتار :program:`mv` در GNU تطبیق داده شد. اکنون *dst* را برمی‌گرداند."

msgid "Added the *copy_function* keyword argument."
msgstr "آرگومان کلیدواژه‌ای *copy_function* افزوده شد."

msgid "Accepts a :term:`path-like object` for both *src* and *dst*."
msgstr "یک :term:`path-like object` را برای هر دو *src* و *dst* می‌پذیرد."

msgid "Return disk usage statistics about the given path as a :term:`named tuple` with the attributes *total*, *used* and *free*, which are the amount of total, used and free space, in bytes. *path* may be a file or a directory."
msgstr "آمار استفاده از دیسک برای مسیر داده‌شده را به‌صورت یک :term:`named tuple` با ویژگی‌های *total*، *used* و *free* برمی‌گرداند که مقدار فضای کل، استفاده‌شده و آزاد را بر حسب بایت نشان می‌دهند. *path* می‌تواند یک پرونده یا یک پوشه باشد."

msgid "On Unix filesystems, *path* must point to a path within a **mounted** filesystem partition. On those platforms, CPython doesn't attempt to retrieve disk usage information from non-mounted filesystems."
msgstr "در سامانه فایل‌بندی‌های یونیکس، *path* باید به مسیری درون یک افراز از سامانه فایل‌بندی **سوارشده** اشاره کند. در آن سکوها، CPython تلاشی برای دریافت اطلاعات استفاده از دیسک از سامانه فایل‌بندی‌های سوارنشده نمی‌کند."

msgid "On Windows, *path* can now be a file or directory."
msgstr "در ویندوز، *path* اکنون می‌تواند یک پرونده یا پوشه باشد."

msgid "Availability"
msgstr "دسترس‌پذیری"

msgid "Change owner *user* and/or *group* of the given *path*."
msgstr "مالکیت *user* و/یا *group* مسیر داده‌شده *path* را تغییر می‌دهد."

msgid "*user* can be a system user name or a uid; the same applies to *group*. At least one argument is required."
msgstr "*user* می‌تواند نام کاربری سیستم یا uid باشد؛ همین موضوع برای *group* نیز صدق می‌کند. حداقل ۱ آرگومان لازم است."

msgid "See also :func:`os.chown`, the underlying function."
msgstr "همچنین ببینید :func:`os.chown`، تابع زیربنایی."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.chown`` with arguments ``path``, ``user``, ``group``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.chown`` را با آرگومان‌های ``path``، ``user`` و ``group`` پرتاب می‌کند."

msgid "Added *dir_fd* and *follow_symlinks* parameters."
msgstr "پارامترهای *dir_fd* و *follow_symlinks* افزوده شدند."

msgid "Return the path to an executable which would be run if the given *cmd* was called.  If no *cmd* would be called, return ``None``."
msgstr "مسیر یک پرونده اجرایی را برمی‌گرداند که اگر *cmd* داده‌شده فراخوانی شود، اجرا می‌شود. اگر هیچ *cmd* فراخوانی نشود، ``None`` برمی‌گرداند."

msgid "*mode* is a permission mask passed to :func:`os.access`, by default determining if the file exists and is executable."
msgstr "*mode* یک نقاب مجوز (permission mask) است که به :func:`os.access` ارسال می‌شود و به‌طور پیش‌فرض تعیین می‌کند که آیا پرونده وجود دارد و قابل اجرا است یا خیر."

msgid "*path* is a \"``PATH`` string\" specifying the directories to look in, delimited by :data:`os.pathsep`. When no *path* is specified, the :envvar:`PATH` environment variable is read from :data:`os.environ`, falling back to :data:`os.defpath` if it is not set."
msgstr "*path* یک «رشته ``PATH``» است که پوشه‌هایی را که باید در آن‌ها جستجو شود، مشخص می‌کند و با :data:`os.pathsep` جدا می‌شود. هنگامی که *path* مشخص‌نشده باشد، متغیر محیطی :envvar:`PATH` از :data:`os.environ` خوانده می‌شود و در صورت تنظیم‌نشدن آن، به :data:`os.defpath` بازمی‌گردد."

msgid "If *cmd* contains a directory component, :func:`!which` only checks the specified path directly and does not search the directories listed in *path* or in the system's :envvar:`PATH` environment variable."
msgstr "اگر *cmd* شامل یک جزء پوشه باشد، :func:`!which` فقط مسیر مشخص‌شده را به‌طور مستقیم بررسی می‌کند و پوشه‌های فهرست‌شده در *path* یا در متغیر محیطی :envvar:`PATH` سیستم را جست‌وجو نمی‌کند."

msgid "On Windows, the current directory is prepended to the *path* if *mode* does not include ``os.X_OK``. When the *mode* does include ``os.X_OK``, the Windows API ``NeedCurrentDirectoryForExePathW`` will be consulted to determine if the current directory should be prepended to *path*. To avoid consulting the current working directory for executables: set the environment variable ``NoDefaultCurrentDirectoryInExePath``."
msgstr "در ویندوز، اگر *mode* شامل ``os.X_OK`` نباشد، پوشه فعلی به ابتدای *path* افزوده می‌شود. هنگامی که *mode* شامل ``os.X_OK`` باشد، از API ویندوز ``NeedCurrentDirectoryForExePathW`` برای تعیین اینکه آیا پوشه فعلی باید به ابتدای *path* افزوده شود استفاده می‌شود. برای اجتناب از بررسی پوشه کاری فعلی برای پرونده‌های اجرایی: متغیر محیطی ``NoDefaultCurrentDirectoryInExePath`` را تنظیم کنید."

msgid "Also on Windows, the :envvar:`PATHEXT` environment variable is used to resolve commands that may not already include an extension. For example, if you call ``shutil.which(\"python\")``, :func:`which` will search ``PATHEXT`` to know that it should look for ``python.exe`` within the *path* directories. For example, on Windows::"
msgstr "همچنین در ویندوز، از متغیر محیطی :envvar:`PATHEXT` برای یافتن دستورهایی استفاده می‌شود که ممکن است از قبل شامل پسوند نباشند. برای مثال، اگر ``shutil.which(\"python\")`` را فراخوانی کنید، :func:`which` در ``PATHEXT`` جستجو می‌کند تا بداند که باید به دنبال ``python.exe`` در پوشه‌های *path* بگردد. برای مثال، در ویندوز::"

msgid ""
">>> shutil.which(\"python\")\n"
"'C:\\\\Python33\\\\python.EXE'"
msgstr ""
">>> shutil.which(\"python\")\n"
"'C:\\\\Python33\\\\python.EXE'"

msgid "This is also applied when *cmd* is a path that contains a directory component::"
msgstr "این مورد همچنین زمانی اعمال می‌شود که *cmd* مسیری باشد که شامل یک کامپوننت پوشه باشد::"

msgid ""
">>> shutil.which(\"C:\\\\Python33\\\\python\")\n"
"'C:\\\\Python33\\\\python.EXE'"
msgstr ""
">>> shutil.which(\"C:\\\\Python33\\\\python\")\n"
"'C:\\\\Python33\\\\python.EXE'"

msgid "The :class:`bytes` type is now accepted.  If *cmd* type is :class:`bytes`, the result type is also :class:`bytes`."
msgstr "نوع :class:`bytes` اکنون پذیرفته می‌شود. اگر نوع *cmd* از نوع :class:`bytes` باشد، نوع نتیجه نیز :class:`bytes` خواهد بود."

msgid "On Windows, the current directory is no longer prepended to the search path if *mode* includes ``os.X_OK`` and WinAPI ``NeedCurrentDirectoryForExePathW(cmd)`` is false, else the current directory is prepended even if it is already in the search path; ``PATHEXT`` is used now even when *cmd* includes a directory component or ends with an extension that is in ``PATHEXT``; and filenames that have no extension can now be found."
msgstr "در ویندوز، اگر *mode* شامل ``os.X_OK`` باشد و WinAPI ``NeedCurrentDirectoryForExePathW(cmd)`` نادرست باشد، پوشه جاری دیگر به ابتدای مسیر جستجو افزوده نمی‌شود؛ در غیر این صورت، پوشه جاری حتی اگر از قبل در مسیر جستجو باشد، به ابتدای آن افزوده می‌شود؛ اکنون از ``PATHEXT`` استفاده می‌شود، حتی وقتی *cmd* شامل یک کامپوننت پوشه باشد یا با پسوندی موجود در ``PATHEXT`` تمام شود؛ و اکنون می‌توان نام پرونده‌هایی که پسوند ندارند را پیدا کرد."

msgid "This exception collects exceptions that are raised during a multi-file operation. For :func:`copytree`, the exception argument is a list of 3-tuples (*srcname*, *dstname*, *exception*)."
msgstr "این استثنا، استثناهایی را که در حین یک عملیات چندپرونده‌ای پرتاب می‌شوند، جمع‌آوری می‌کند. برای :func:`copytree`، آرگومان استثنا فهرستی از تاپل‌های ۳-تایی (*srcname*, *dstname*, *exception*) است."

msgid "Platform-dependent efficient copy operations"
msgstr "عملیات کپی کارآمد وابسته به سکو"

msgid "Starting from Python 3.8, all functions involving a file copy (:func:`copyfile`, :func:`~shutil.copy`, :func:`copy2`, :func:`copytree`, and :func:`move`) may use platform-specific \"fast-copy\" syscalls in order to copy the file more efficiently (see :issue:`33671`). \"fast-copy\" means that the copying operation occurs within the kernel, avoiding the use of userspace buffers in Python as in \"``outfd.write(infd.read())``\"."
msgstr "از پایتون 3.8 به بعد، همه‌ی توابع مربوط به کپی پرونده (:func:`copyfile`، :func:`~shutil.copy`، :func:`copy2`، :func:`copytree` و :func:`move`) ممکن است از فراخوانی‌های سیستمی «کپی سریع» (fast-copy) ویژه‌ی سکو استفاده کنند تا پرونده را کارآمدتر کپی کنند (به :issue:`33671` مراجعه کنید). «کپی سریع» به این معنا است که عملیات کپی درون کرنل انجام می‌شود و از استفاده از بافرهای فضای کاربر در پایتون، مانند ``outfd.write(infd.read())``، اجتناب می‌شود."

msgid "On macOS `fcopyfile`_ is used to copy the file content (not metadata)."
msgstr "در macOS، از `fcopyfile`_ برای کپی کردن محتوای پرونده (نه فراداده) استفاده می‌شود."

msgid "On Linux :func:`os.copy_file_range` or :func:`os.sendfile` is used."
msgstr "در لینوکس از :func:`os.copy_file_range` یا :func:`os.sendfile` استفاده می‌شود."

msgid "On Solaris :func:`os.sendfile` is used."
msgstr "در سولاریس، از :func:`os.sendfile` استفاده می‌شود."

msgid "On Windows :func:`shutil.copyfile` uses a bigger default buffer size (1 MiB instead of 64 KiB) and a :func:`memoryview`-based variant of :func:`shutil.copyfileobj` is used."
msgstr "در ویندوز، :func:`shutil.copyfile` از اندازه پیش‌فرض بافر بزرگ‌تری (۱ MiB به جای ۶۴ KiB) استفاده می‌کند و از یک گونه مبتنی بر :func:`memoryview` برای :func:`shutil.copyfileobj` استفاده می‌شود."

msgid "If the fast-copy operation fails and no data was written in the destination file then shutil will silently fall back to less efficient :func:`copyfileobj` function internally."
msgstr "اگر عملیات کپی سریع (fast-copy) ناموفق باشد و هیچ داده‌ای در پرونده مقصد نوشته نشده باشد، shutil به‌صورت داخلی و بی‌صدا به تابع کم‌بازده‌تر :func:`copyfileobj` بازمی‌گردد."

msgid "Solaris now uses :func:`os.sendfile`."
msgstr "Solaris اکنون از :func:`os.sendfile` استفاده می‌کند."

msgid "Copy-on-write or server-side copy may be used internally via :func:`os.copy_file_range` on supported Linux filesystems."
msgstr "ممکن است کپی در زمان نوشتن (Copy-on-write) یا کپی سمت سرور به‌صورت داخلی از طریق :func:`os.copy_file_range` در سامانه فایل‌بندی‌های لینوکسی پشتیبانی‌شده استفاده شود."

msgid "copytree example"
msgstr "مثال copytree"

msgid "An example that uses the :func:`ignore_patterns` helper::"
msgstr "مثالی که از تابع کمکی :func:`ignore_patterns` استفاده می‌کند::"

msgid ""
"from shutil import copytree, ignore_patterns\n"
"\n"
"copytree(source, destination, ignore=ignore_patterns('*.pyc', 'tmp*'))"
msgstr ""
"from shutil import copytree, ignore_patterns\n"
"\n"
"copytree(source, destination, ignore=ignore_patterns('*.pyc', 'tmp*'))"

msgid "This will copy everything except ``.pyc`` files and files or directories whose name starts with ``tmp``."
msgstr "این کار همه‌چیز را به جز پرونده‌های ``.pyc`` و پرونده‌ها یا پوشه‌هایی که نام آن‌ها با ``tmp`` شروع می‌شود، کپی می‌کند."

msgid "Another example that uses the *ignore* argument to add a logging call::"
msgstr "مثالی دیگر که از آرگومان *ignore* برای افزودن یک فراخوانی گزارش استفاده می‌کند::"

msgid ""
"from shutil import copytree\n"
"import logging\n"
"\n"
"def _logpath(path, names):\n"
"    logging.info('Working in %s', path)\n"
"    return []   # nothing will be ignored\n"
"\n"
"copytree(source, destination, ignore=_logpath)"
msgstr ""
"from shutil import copytree\n"
"import logging\n"
"\n"
"def _logpath(path, names):\n"
"    logging.info('Working in %s', path)\n"
"    return []   # nothing will be ignored\n"
"\n"
"copytree(source, destination, ignore=_logpath)"

msgid "rmtree example"
msgstr "مثال rmtree"

msgid "This example shows how to remove a directory tree on Windows where some of the files have their read-only bit set. It uses the onexc callback to clear the readonly bit and reattempt the remove. Any subsequent failure will propagate. ::"
msgstr "این مثال نشان می‌دهد که چگونه می‌توان یک درخت پوشه را در ویندوز حذف کرد، در حالتی که بیت فقط‌خواندنی برخی از پرونده‌ها تنظیم شده است. این مثال از کال‌بک onexc برای پاک کردن بیت فقط‌خواندنی و تلاش دوباره برای حذف استفاده می‌کند. هر شکست بعدی منتشر خواهد شد. ::"

msgid ""
"import os, stat\n"
"import shutil\n"
"\n"
"def remove_readonly(func, path, _):\n"
"    \"Clear the readonly bit and reattempt the removal\"\n"
"    os.chmod(path, stat.S_IWRITE)\n"
"    func(path)\n"
"\n"
"shutil.rmtree(directory, onexc=remove_readonly)"
msgstr ""
"import os, stat\n"
"import shutil\n"
"\n"
"def remove_readonly(func, path, _):\n"
"    \"Clear the readonly bit and reattempt the removal\"\n"
"    os.chmod(path, stat.S_IWRITE)\n"
"    func(path)\n"
"\n"
"shutil.rmtree(directory, onexc=remove_readonly)"

msgid "Archiving operations"
msgstr "عملیات بایگانی"

msgid "Added support for the *xztar* format."
msgstr "پشتیبانی از قالب *xztar* اضافه شد."

msgid "High-level utilities to create and read compressed and archived files are also provided.  They rely on the :mod:`zipfile` and :mod:`tarfile` modules."
msgstr "ابزارهای سطح بالا برای ایجاد و خواندن پرونده‌های فشرده و بایگانی‌شده نیز ارائه شده‌اند. این ابزارها به ماژول‌های :mod:`zipfile` و :mod:`tarfile` متکی هستند."

msgid "Create an archive file (such as zip or tar) and return its name."
msgstr "یک پرونده آرشیو (مانند zip یا tar) ایجاد می‌کند و نام آن را برمی‌گرداند."

msgid "*base_name* is the name of the file to create, including the path, minus any format-specific extension."
msgstr "*base_name* نام پرونده‌ای است که ایجاد می‌شود، شامل مسیر، بدون هیچ پسوند مخصوص قالب."

msgid "*format* is the archive format: one of \"zip\" (if the :mod:`zlib` module is available), \"tar\", \"gztar\" (if the :mod:`zlib` module is available), \"bztar\" (if the :mod:`bz2` module is available), \"xztar\" (if the :mod:`lzma` module is available), or \"zstdtar\" (if the :mod:`compression.zstd` module is available)."
msgstr "*format* قالب بایگانی است: یکی از \"zip\" (اگر ماژول :mod:`zlib` در دسترس باشد)، \"tar\"، \"gztar\" (اگر ماژول :mod:`zlib` در دسترس باشد)، \"bztar\" (اگر ماژول :mod:`bz2` در دسترس باشد)، \"xztar\" (اگر ماژول :mod:`lzma` در دسترس باشد)، یا \"zstdtar\" (اگر ماژول :mod:`compression.zstd` در دسترس باشد)."

msgid "*root_dir* is a directory that will be the root directory of the archive, all paths in the archive will be relative to it; for example, we typically chdir into *root_dir* before creating the archive."
msgstr "*root_dir* پوشه‌ای است که پوشه‌ی ریشه‌ی بایگانی خواهد بود؛ همه‌ی مسیرهای داخل بایگانی نسبت به آن نسبی خواهند بود؛ برای مثال، معمولاً پیش از ایجاد بایگانی، با chdir وارد *root_dir* می‌شویم."

msgid "*base_dir* is the directory where we start archiving from; i.e. *base_dir* will be the common prefix of all files and directories in the archive.  *base_dir* must be given relative to *root_dir*.  See :ref:`shutil-archiving-example-with-basedir` for how to use *base_dir* and *root_dir* together."
msgstr "*base_dir* پوشه‌ای است که بایگانی را از آن آغاز می‌کنیم؛ یعنی *base_dir* پیشوند مشترک همه‌ی پرونده‌ها و پوشه‌های درون بایگانی خواهد بود. *base_dir* باید نسبت به *root_dir* داده شود. برای چگونگی استفاده از *base_dir* و *root_dir* با یکدیگر، به :ref:`shutil-archiving-example-with-basedir` مراجعه کنید."

msgid "*root_dir* and *base_dir* both default to the current directory."
msgstr "*root_dir* و *base_dir* هر دو به‌طور پیش‌فرض برابر با پوشه جاری هستند."

msgid "If *dry_run* is true, no archive is created, but the operations that would be executed are logged to *logger*."
msgstr "اگر *dry_run* درست باشد، هیچ بایگانی‌ای ایجاد نمی‌شود، اما عملیاتی که اجرا می‌شدند، در *logger* ثبت می‌شوند."

msgid "*owner* and *group* are used when creating a tar archive. By default, uses the current owner and group."
msgstr "*owner* و *group* هنگام ایجاد یک آرشیو tar استفاده می‌شوند. به‌طور پیش‌فرض، از مالک و گروه فعلی استفاده می‌شود."

msgid "*logger* must be an object compatible with :pep:`282`, usually an instance of :class:`logging.Logger`."
msgstr "*logger* باید یک شیء سازگار با :pep:`282` باشد، معمولاً یک نمونه از :class:`logging.Logger`."

msgid "The *verbose* argument is unused and deprecated."
msgstr "آرگومان *verbose* استفاده نمی‌شود و منسوخ است."

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.make_archive`` with arguments ``base_name``, ``format``, ``root_dir``, ``base_dir``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.make_archive`` را با آرگومان‌های ``base_name``، ``format``، ``root_dir``، ``base_dir`` پرتاب می‌کند."

msgid "This function is not thread-safe when custom archivers registered with :func:`register_archive_format` do not support the *root_dir* argument.  In this case it temporarily changes the current working directory of the process to *root_dir* to perform archiving."
msgstr "این تابع زمانی که بایگانی‌کننده‌های سفارشی ثبت‌شده با :func:`register_archive_format` از آرگومان *root_dir* پشتیبانی نمی‌کنند، ایمنی نخی ندارد. در این حالت، پوشه کاری فعلی فرایند را به‌طور موقت به *root_dir* تغییر می‌دهد تا بایگانی انجام شود."

msgid "The modern pax (POSIX.1-2001) format is now used instead of the legacy GNU format for archives created with ``format=\"tar\"``."
msgstr "قالب مدرن pax (POSIX.1-2001) اکنون به‌جای قالب قدیمی GNU برای بایگانی‌های ایجادشده با ``format=\"tar\"`` استفاده می‌شود."

msgid "This function is now made thread-safe during creation of standard ``.zip`` and tar archives."
msgstr "این تابع اکنون هنگام ایجاد بایگانی‌های استاندارد ``.zip`` و tar، ایمن از نظر نخی (thread-safe) شده است."

msgid "Return a list of supported formats for archiving. Each element of the returned sequence is a tuple ``(name, description)``."
msgstr "فهرستی از قالب‌های پشتیبانی‌شده برای بایگانی برمی‌گرداند. هر عنصر از دنباله‌ی برگردانده‌شده یک تاپل ``(name, description)`` است."

msgid "By default :mod:`!shutil` provides these formats:"
msgstr "به‌طور پیش‌فرض :mod:`!shutil` این قالب‌ها را فراهم می‌کند:"

msgid "*zip*: ZIP file (if the :mod:`zlib` module is available)."
msgstr "*zip*: پرونده ZIP (اگر ماژول :mod:`zlib` در دسترس باشد)."

msgid "*tar*: Uncompressed tar file. Uses POSIX.1-2001 pax format for new archives."
msgstr "*tar*: پرونده tar فشرده‌نشده. برای بایگانی‌های جدید از قالب POSIX.1-2001 pax استفاده می‌کند."

msgid "*gztar*: gzip'ed tar-file (if the :mod:`zlib` module is available)."
msgstr "*gztar*: پرونده tar فشرده‌شده با gzip (اگر ماژول :mod:`zlib` در دسترس باشد)."

msgid "*bztar*: bzip2'ed tar-file (if the :mod:`bz2` module is available)."
msgstr "*bztar*: پرونده tar فشرده‌شده با bzip2 (اگر ماژول :mod:`bz2` در دسترس باشد)."

msgid "*xztar*: xz'ed tar-file (if the :mod:`lzma` module is available)."
msgstr "*xztar*: پرونده tar فشرده‌شده با xz (اگر ماژول :mod:`lzma` در دسترس باشد)."

msgid "*zstdtar*: Zstandard compressed tar-file (if the :mod:`compression.zstd` module is available)."
msgstr "*zstdtar*: پرونده tar فشرده‌شده با Zstandard (اگر ماژول :mod:`compression.zstd` در دسترس باشد)."

msgid "You can register new formats or provide your own archiver for any existing formats, by using :func:`register_archive_format`."
msgstr "با استفاده از :func:`register_archive_format` می‌توانید قالب‌های جدید را ثبت کنید یا بایگانی‌کننده (archiver) خودتان را برای هر یک از قالب‌های موجود ارائه دهید."

msgid "Register an archiver for the format *name*."
msgstr "یک بایگانی‌کننده برای قالب *name* ثبت کنید."

msgid "*function* is the callable that will be used to create archives. The callable will receive the *base_name* of the file to create, followed by the *base_dir* (which defaults to :data:`os.curdir`) to start archiving from. Further arguments are passed as keyword arguments: *owner*, *group*, *dry_run* and *logger* (as passed in :func:`make_archive`)."
msgstr "*function* یک شیء فراخوانی‌پذیر است که برای ایجاد بایگانی‌ها استفاده خواهد شد. این شیء فراخوانی‌پذیر، *base_name* پرونده‌ای که ایجاد می‌شود و سپس *base_dir* را (که پیش‌فرض آن :data:`os.curdir` است) دریافت می‌کند تا بایگانی از آن آغاز شود. آرگومان‌های بیشتر به‌صورت آرگومان‌های کلیدواژه‌ای ارسال می‌شوند: *owner*، *group*، *dry_run* و *logger* (همان‌طور که در :func:`make_archive` ارسال می‌شوند)."

msgid "If *function* has the custom attribute ``function.supports_root_dir`` set to ``True``, the *root_dir* argument is passed as a keyword argument. Otherwise the current working directory of the process is temporarily changed to *root_dir* before calling *function*. In this case :func:`make_archive` is not thread-safe."
msgstr "اگر ویژگی سفارشی ``function.supports_root_dir`` برای *function* روی ``True`` تنظیم شده باشد، آرگومان *root_dir* به‌عنوان یک آرگومان کلیدواژه‌ای ارسال می‌شود. در غیر این صورت، پوشه کاری جاری فرایند پیش از فراخوانی *function* به‌طور موقت به *root_dir* تغییر می‌یابد. در این حالت :func:`make_archive` نخ‌ایمن نیست."

msgid "If given, *extra_args* is a sequence of ``(name, value)`` pairs that will be used as extra keywords arguments when the archiver callable is used."
msgstr "در صورت ارائه، *extra_args* دنباله‌ای از جفت‌های ``(name, value)`` است که هنگام استفاده از شیء فراخوانی‌پذیر آرشیوکننده، به‌عنوان آرگومان‌های کلیدواژه‌ای اضافی استفاده می‌شوند."

msgid "*description* is used by :func:`get_archive_formats` which returns the list of archivers.  Defaults to an empty string."
msgstr "*description* توسط :func:`get_archive_formats` استفاده می‌شود، که فهرست بایگانی‌کننده‌ها را برمی‌گرداند. مقدار پیش‌فرض آن یک رشته خالی است."

msgid "Added support for functions supporting the *root_dir* argument."
msgstr "پشتیبانی از توابعی که از آرگومان *root_dir* پشتیبانی می‌کنند، افزوده شد."

msgid "Remove the archive format *name* from the list of supported formats."
msgstr "قالب بایگانی *name* را از فهرست قالب‌های پشتیبانی‌شده حذف می‌کند."

msgid "Unpack an archive. *filename* is the full path of the archive."
msgstr "یک بایگانی را واگشایی کنید. *filename* مسیر کامل بایگانی است."

msgid "*extract_dir* is the name of the target directory where the archive is unpacked. If not provided, the current working directory is used."
msgstr "*extract_dir* نام پوشه هدفی است که آرشیو در آن واگشایی می‌شود. اگر ارائه نشود، از پوشه کاری جاری استفاده می‌شود."

msgid "*format* is the archive format: one of \"zip\", \"tar\", \"gztar\", \"bztar\", \"xztar\", or \"zstdtar\".  Or any other format registered with :func:`register_unpack_format`.  If not provided, :func:`unpack_archive` will use the archive file name extension and see if an unpacker was registered for that extension.  In case none is found, a :exc:`ValueError` is raised."
msgstr "*format* قالب بایگانی است: یکی از \"zip\"، \"tar\"، \"gztar\"، \"bztar\"، \"xztar\" یا \"zstdtar\". یا هر قالب دیگری که با :func:`register_unpack_format` ثبت‌شده باشد. اگر ارائه نشود، :func:`unpack_archive` از پسوند نام پرونده بایگانی استفاده می‌کند و بررسی می‌کند که آیا واگشاینده‌ای برای آن پسوند ثبت‌شده است یا خیر. در صورتی که هیچ موردی یافت نشود، یک :exc:`ValueError` پرتاب می‌شود."

msgid "The keyword-only *filter* argument is passed to the underlying unpacking function. For zip files, *filter* is not accepted. For tar files, it is recommended to use ``'data'`` (default since Python 3.14), unless using features specific to tar and UNIX-like filesystems. (See :ref:`tarfile-extraction-filter` for details.)"
msgstr "آرگومان *filter* که فقط کلیدواژه‌ای است، به تابع واگشایی زیربنایی ارسال می‌شود. برای پرونده‌های zip، *filter* پذیرفته نمی‌شود. برای پرونده‌های tar، توصیه می‌شود از ``'data'`` استفاده کنید (از Python 3.14 پیش‌فرض است)، مگر اینکه از ویژگی‌های خاص tar و سامانه فایل‌بندی‌های شبهUNIX استفاده کنید. (برای جزئیات، :ref:`tarfile-extraction-filter` را ببینید.)"

msgid "Raises an :ref:`auditing event <auditing>` ``shutil.unpack_archive`` with arguments ``filename``, ``extract_dir``, ``format``."
msgstr "یک :ref:`رویداد حسابرسی <auditing>` ``shutil.unpack_archive`` را با آرگومان‌های ``filename``، ``extract_dir`` و ``format`` پرتاب می‌کند."

msgid "Never extract archives from untrusted sources without prior inspection. It is possible that files are created outside of the path specified in the *extract_dir* argument, for example, members that have absolute filenames or filenames with \"..\" components."
msgstr "هرگز بایگانی‌ها را از منابع غیرقابل‌اعتماد بدون بررسی پیشین استخراج نکنید. ممکن است پرونده‌ها خارج از مسیر مشخص‌شده در آرگومان *extract_dir* ایجاد شوند، برای مثال اعضایی که نام‌پرونده‌های مطلق یا نام‌پرونده‌هایی دارای اجزای \"..\" دارند."

msgid "Since Python 3.14, the defaults for both built-in formats (zip and tar files) will prevent the most dangerous of such security issues, but will not prevent *all* unintended behavior. Read the :ref:`tarfile-further-verification` section for tar-specific details."
msgstr "از پایتون 3.14، پیش‌فرض‌های هر دو قالب توکار (پرونده‌های zip و tar) از خطرناک‌ترینِ این مشکلات امنیتی جلوگیری خواهند کرد، اما از *تمام* رفتارهای ناخواسته جلوگیری نخواهند کرد. برای جزئیات مختص tar، بخش :ref:`tarfile-further-verification` را مطالعه کنید."

msgid "Accepts a :term:`path-like object` for *filename* and *extract_dir*."
msgstr "یک :term:`path-like object` را برای *filename* و *extract_dir* می‌پذیرد."

msgid "Added the *filter* argument."
msgstr "آرگومان *filter* اضافه شد."

msgid "Registers an unpack format. *name* is the name of the format and *extensions* is a list of extensions corresponding to the format, like ``.zip`` for Zip files."
msgstr "یک قالب واگشایی را ثبت می‌کند. *name* نام قالب است و *extensions* فهرستی از پسوندهای متناظر با قالب است، مانند ``.zip`` برای پرونده‌های Zip."

msgid "*function* is the callable that will be used to unpack archives. The callable will receive:"
msgstr "*function* فراخوانی‌پذیری است که برای واگشایی آرشیوها استفاده خواهد شد. این فراخوانی‌پذیر دریافت خواهد کرد:"

msgid "the path of the archive, as a positional argument;"
msgstr "مسیر بایگانی، به‌عنوان یک آرگومان جایگاهی؛"

msgid "the directory the archive must be extracted to, as a positional argument;"
msgstr "پوشه‌ای که بایگانی باید در آن استخراج شود، به‌عنوان یک آرگومان جایگاهی؛"

msgid "possibly a *filter* keyword argument, if it was given to :func:`unpack_archive`;"
msgstr "احتمالاً یک آرگومان کلیدواژه‌ای *filter*، اگر به :func:`unpack_archive` داده شده باشد؛"

msgid "additional keyword arguments, specified by *extra_args* as a sequence of ``(name, value)`` tuples."
msgstr "آرگومان‌های کلیدواژه‌ای اضافی، که توسط *extra_args* به‌صورت دنباله‌ای از تاپل‌های ``(name, value)`` مشخص‌شده‌اند."

msgid "*description* can be provided to describe the format, and will be returned by the :func:`get_unpack_formats` function."
msgstr "می‌توان *description* را برای توصیف قالب ارائه کرد، و توسط تابع :func:`get_unpack_formats` بازگردانده می‌شود."

msgid "Unregister an unpack format. *name* is the name of the format."
msgstr "ثبت یک قالب واگشایی را لغو می‌کند. *name* نام قالب است."

msgid "Return a list of all registered formats for unpacking. Each element of the returned sequence is a tuple ``(name, extensions, description)``."
msgstr "فهرستی از تمام قالب‌های ثبت‌شده برای واگشایی را برمی‌گرداند. هر عنصر از دنباله‌ی برگردانده‌شده یک تاپل ``(name, extensions, description)`` است."

msgid "*zip*: ZIP file (unpacking compressed files works only if the corresponding module is available)."
msgstr "*zip*: پرونده ZIP (واگشایی پرونده‌های فشرده فقط زمانی کار می‌کند که ماژول مربوطه در دسترس باشد)."

msgid "*tar*: uncompressed tar file."
msgstr "*tar*: پرونده tar فشرده‌نشده."

msgid "You can register new formats or provide your own unpacker for any existing formats, by using :func:`register_unpack_format`."
msgstr "با استفاده از :func:`register_unpack_format`، می‌توانید قالب‌های جدید را ثبت کنید یا واگشای (unpacker) خودتان را برای هر قالب موجود فراهم کنید."

msgid "Archiving example"
msgstr "مثال بایگانی"

msgid "In this example, we create a gzip'ed tar-file archive containing all files found in the :file:`.ssh` directory of the user::"
msgstr "در این مثال، یک بایگانی tar فشرده‌شده با gzip ایجاد می‌کنیم که شامل همه‌ی پرونده‌های موجود در پوشه‌ی :file:`.ssh` کاربر است::"

msgid ""
">>> from shutil import make_archive\n"
">>> import os\n"
">>> archive_name = os.path.expanduser(os.path.join('~', 'myarchive'))\n"
">>> root_dir = os.path.expanduser(os.path.join('~', '.ssh'))\n"
">>> make_archive(archive_name, 'gztar', root_dir)\n"
"'/Users/tarek/myarchive.tar.gz'"
msgstr ""
">>> from shutil import make_archive\n"
">>> import os\n"
">>> archive_name = os.path.expanduser(os.path.join('~', 'myarchive'))\n"
">>> root_dir = os.path.expanduser(os.path.join('~', '.ssh'))\n"
">>> make_archive(archive_name, 'gztar', root_dir)\n"
"'/Users/tarek/myarchive.tar.gz'"

msgid "The resulting archive contains:"
msgstr "بایگانی حاصل شامل:"

msgid ""
"$ tar -tzvf /Users/tarek/myarchive.tar.gz\n"
"drwx------ tarek/staff       0 2010-02-01 16:23:40 ./\n"
"-rw-r--r-- tarek/staff     609 2008-06-09 13:26:54 ./authorized_keys\n"
"-rwxr-xr-x tarek/staff      65 2008-06-09 13:26:54 ./config\n"
"-rwx------ tarek/staff     668 2008-06-09 13:26:54 ./id_dsa\n"
"-rwxr-xr-x tarek/staff     609 2008-06-09 13:26:54 ./id_dsa.pub\n"
"-rw------- tarek/staff    1675 2008-06-09 13:26:54 ./id_rsa\n"
"-rw-r--r-- tarek/staff     397 2008-06-09 13:26:54 ./id_rsa.pub\n"
"-rw-r--r-- tarek/staff   37192 2010-02-06 18:23:10 ./known_hosts"
msgstr ""
"$ tar -tzvf /Users/tarek/myarchive.tar.gz\n"
"drwx------ tarek/staff       0 2010-02-01 16:23:40 ./\n"
"-rw-r--r-- tarek/staff     609 2008-06-09 13:26:54 ./authorized_keys\n"
"-rwxr-xr-x tarek/staff      65 2008-06-09 13:26:54 ./config\n"
"-rwx------ tarek/staff     668 2008-06-09 13:26:54 ./id_dsa\n"
"-rwxr-xr-x tarek/staff     609 2008-06-09 13:26:54 ./id_dsa.pub\n"
"-rw------- tarek/staff    1675 2008-06-09 13:26:54 ./id_rsa\n"
"-rw-r--r-- tarek/staff     397 2008-06-09 13:26:54 ./id_rsa.pub\n"
"-rw-r--r-- tarek/staff   37192 2010-02-06 18:23:10 ./known_hosts"

msgid "Archiving example with *base_dir*"
msgstr "مثال بایگانی با *base_dir*"

msgid "In this example, similar to the `one above <shutil-archiving-example_>`_, we show how to use :func:`make_archive`, but this time with the usage of *base_dir*.  We now have the following directory structure:"
msgstr "در این مثال، مشابه `مثال بالا <shutil-archiving-example_>`_، نحوه استفاده از :func:`make_archive` را نشان می‌دهیم، اما این بار با استفاده از *base_dir*. اکنون ساختار پوشه زیر را داریم:"

msgid ""
"$ tree tmp\n"
"tmp\n"
"└── root\n"
"    └── structure\n"
"        ├── content\n"
"            └── please_add.txt\n"
"        └── do_not_add.txt"
msgstr ""
"$ tree tmp\n"
"tmp\n"
"└── root\n"
"    └── structure\n"
"        ├── content\n"
"            └── please_add.txt\n"
"        └── do_not_add.txt"

msgid "In the final archive, :file:`please_add.txt` should be included, but :file:`do_not_add.txt` should not.  Therefore we use the following::"
msgstr "در بایگانی نهایی، :file:`please_add.txt` باید گنجانده شود، اما :file:`do_not_add.txt` نباید گنجانده شود. بنابراین از دستور زیر استفاده می‌کنیم::"

msgid ""
">>> from shutil import make_archive\n"
">>> import os\n"
">>> archive_name = os.path.expanduser(os.path.join('~', 'myarchive'))\n"
">>> make_archive(\n"
"...     archive_name,\n"
"...     'tar',\n"
"...     root_dir='tmp/root',\n"
"...     base_dir='structure/content',\n"
"... )\n"
"'/Users/tarek/myarchive.tar'"
msgstr ""
">>> from shutil import make_archive\n"
">>> import os\n"
">>> archive_name = os.path.expanduser(os.path.join('~', 'myarchive'))\n"
">>> make_archive(\n"
"...     archive_name,\n"
"...     'tar',\n"
"...     root_dir='tmp/root',\n"
"...     base_dir='structure/content',\n"
"... )\n"
"'/Users/tarek/myarchive.tar'"

msgid "Listing the files in the resulting archive gives us:"
msgstr "فهرست پرونده‌های موجود در آرشیو حاصل به این صورت است:"

msgid ""
"$ python -m tarfile -l /Users/tarek/myarchive.tar\n"
"structure/content/\n"
"structure/content/please_add.txt"
msgstr ""
"$ python -m tarfile -l /Users/tarek/myarchive.tar\n"
"structure/content/\n"
"structure/content/please_add.txt"

msgid "Querying the size of the output terminal"
msgstr "پرس‌وجوی اندازه‌ی پایانه‌ی خروجی"

msgid "Get the size of the terminal window."
msgstr "اندازه‌ی پنجره‌ی پایانه را بگیرید."

msgid "For each of the two dimensions, the environment variable, ``COLUMNS`` and ``LINES`` respectively, is checked. If the variable is defined and the value is a positive integer, it is used."
msgstr "برای هر یک از دو بُعد، متغیر محیطی مربوطه، به‌ترتیب ``COLUMNS`` و ``LINES``، بررسی می‌شود. اگر متغیر تعریف شده باشد و مقدار آن یک عدد صحیح مثبت باشد، از آن استفاده می‌شود."

msgid "When ``COLUMNS`` or ``LINES`` is not defined, which is the common case, the terminal connected to :data:`sys.__stdout__` is queried by invoking :func:`os.get_terminal_size`."
msgstr "هنگامی که ``COLUMNS`` یا ``LINES`` تعریف نشده باشد، که حالت رایج است، از پایانه‌ی متصل به :data:`sys.__stdout__` با فراخوانی :func:`os.get_terminal_size` پرس‌وجو می‌شود."

msgid "If the terminal size cannot be successfully queried, either because the system doesn't support querying, or because we are not connected to a terminal, the value given in ``fallback`` parameter is used. ``fallback`` defaults to ``(80, 24)`` which is the default size used by many terminal emulators."
msgstr "اگر نتوان اندازه پایانه را با موفقیت پرس‌وجو کرد، چه به این دلیل که سیستم از پرس‌وجو پشتیبانی نمی‌کند و چه به این دلیل که به یک پایانه متصل نباشیم، از مقدار داده‌شده به پارامتر ``fallback`` استفاده می‌شود. مقدار پیش‌فرض ``fallback`` برابر ``(80, 24)`` است که اندازه پیش‌فرض مورد استفاده بسیاری از شبیه‌سازهای پایانه است."

msgid "The value returned is a named tuple of type :class:`os.terminal_size`."
msgstr "مقدار بازگشتی یک چندگانه‌ی نام‌دار (named tuple) از نوع :class:`os.terminal_size` است."

msgid "See also: The Single UNIX Specification, Version 2, `Other Environment Variables`_."
msgstr "همچنین ببینید: The Single UNIX Specification, Version 2، `Other Environment Variables`_."

msgid "The ``fallback`` values are also used if :func:`os.get_terminal_size` returns zeroes."
msgstr "در صورتی که :func:`os.get_terminal_size` صفرها را برگرداند، از مقدارهای ``fallback`` نیز استفاده می‌شود."

msgid "file"
msgstr "پرونده"

msgid "copying"
msgstr "کپی"

msgid "copying files"
msgstr "کپی پرونده‌ها"

msgid "directory"
msgstr "پوشه"

msgid "deleting"
msgstr "حذف"