# SOME DESCRIPTIVE TITLE.

# Copyright (C) 2001-2025, Python Software Foundation

# This file is distributed under the same license as the Python package.

# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.

#

# Translators:

# Alireza Shabani <theRevisto@gmail.com>, 2025

#

msgid ""

msgstr ""

"Project-Id-Version: Python 3.13\n"

"Report-Msgid-Bugs-To: \n"

"POT-Creation-Date: 2025-02-21 14:16+0000\n"

"PO-Revision-Date: 2021-06-28 01:50+0000\n"

"Last-Translator: Alireza Shabani <theRevisto@gmail.com>, 2025\n"

"Language-Team: Persian (https://app.transifex.com/python-doc/teams/5390/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"

#: ../../tutorial/modules.rst:5

msgid "Modules"

msgstr "ماژول ها"

#: ../../tutorial/modules.rst:7

msgid ""

"If you quit from the Python interpreter and enter it again, the definitions "

"you have made (functions and variables) are lost. Therefore, if you want to "

"write a somewhat longer program, you are better off using a text editor to "

"prepare the input for the interpreter and running it with that file as input"

" instead. This is known as creating a *script*. As your program gets "

"longer, you may want to split it into several files for easier maintenance."

" You may also want to use a handy function that you've written in several "

"programs without copying its definition into each program."

msgstr ""

"اگر از مفسر پایتون خارج شوید و دوباره وارد آن شوید، تعاریفی که انجام داده "

"اید (توابع و متغیرها) از دست می روند. بنابراین، اگر می خواهید یک برنامه "

"نسبتاً طولانی بنویسید، بهتر است از یک ویرایشگر متنی برای تهیه ورودی برای "

"مفسر استفاده کنید و آن را با استفاده از آن فایل به عنوان ورودی اجرا کنید. "

"این به عنوان ایجاد یک *script* شناخته می شود. همان طور که برنامه شما طولانی "

"تر می شود، ممکن است بخواهید آن را به چندین فایل برای نگهداری آسان تر تقسیم "

"کنید. همچنین ممکن است بخواهید از یک تابع کاربردی که در چندین برنامه نوشته "

"اید استفاده کنید بدون اینکه تعریف آن را در هر برنامه کپی کنید."

#: ../../tutorial/modules.rst:16

msgid ""

"To support this, Python has a way to put definitions in a file and use them "

"in a script or in an interactive instance of the interpreter. Such a file is"

" called a *module*; definitions from a module can be *imported* into other "

"modules or into the *main* module (the collection of variables that you have"

" access to in a script executed at the top level and in calculator mode)."

msgstr ""

"برای پشتیبانی از این موضوع، پایتون روشی برای قرار دادن تعاریف در یک فایل و "

"استفاده از آن ها در یک اسکریپت یا در یک نمونه تعاملی از مفسر دارد. چنین "

"فایلی به نام یک *module* شناخته می شود؛ تعاریف از یک ماژول می توانند در سایر"

" ماژول ها یا در ماژول *main* بارگذاری شوند (مجموعه ای از متغیرهایی که در یک "

"اسکریپت که در سطح بالا اجرا می شود و در حالت ماشین حساب به آن ها دسترسی "

"دارید)."

#: ../../tutorial/modules.rst:22

msgid ""

"A module is a file containing Python definitions and statements. The file "

"name is the module name with the suffix :file:`.py` appended. Within a "

"module, the module's name (as a string) is available as the value of the "

"global variable ``__name__``. For instance, use your favorite text editor "

"to create a file called :file:`fibo.py` in the current directory with the "

"following contents::"

msgstr ""

"ماژول یک فایل حاوی تعریف ها و دستورات پایتون است. نام فایل همان نام ماژول با"

" پسوند :file:`.py` اضافه شده در انتهای آن است. درون ماژول، نام ماژول (به "

"صورت رشته) به عنوان مقدار متغیر سراسری ``__name__`` در دسترس است. برای مثال،"

" از ویرایشگر متن دلخواه خود استفاده کنید تا فایلی به نام :file:`fibo.py` در "

"دایرکتوری جاری با محتوای زیر ایجاد کنید::"

#: ../../tutorial/modules.rst:28

msgid ""

"# Fibonacci numbers module\n"

"\n"

"def fib(n): # write Fibonacci series up to n\n"

" a, b = 0, 1\n"

" while a < n:\n"

" print(a, end=' ')\n"

" a, b = b, a+b\n"

" print()\n"

"\n"

"def fib2(n): # return Fibonacci series up to n\n"

" result = []\n"

" a, b = 0, 1\n"

" while a < n:\n"

" result.append(a)\n"

" a, b = b, a+b\n"

" return result"

msgstr ""

"# Fibonacci numbers module\n"

"\n"

"def fib(n): # write Fibonacci series up to n\n"

" a, b = 0, 1\n"

" while a < n:\n"

" print(a, end=' ')\n"

" a, b = b, a+b\n"

" print()\n"

"\n"

"def fib2(n): # return Fibonacci series up to n\n"

" result = []\n"

" a, b = 0, 1\n"

" while a < n:\n"

" result.append(a)\n"

" a, b = b, a+b\n"

" return result"

#: ../../tutorial/modules.rst:45

msgid ""

"Now enter the Python interpreter and import this module with the following "

"command::"

msgstr "حال وارد مفسر پایتون شوید و این ماژول را با فرمان زیر وارد کنید::"

#: ../../tutorial/modules.rst:48

msgid ">>> import fibo"

msgstr ">>> import fibo"

#: ../../tutorial/modules.rst:50

msgid ""

"This does not add the names of the functions defined in ``fibo`` directly "

"to the current :term:`namespace` (see :ref:`tut-scopes` for more details); "

"it only adds the module name ``fibo`` there. Using the module name you can "

"access the functions::"

msgstr ""

"این به طور مستقیم نام توابع تعریف شده در ``fibo`` را به :term:`namespace` "

"فعلی اضافه نمی کند (برای جزئیات بیشتر به :ref:`tut-scopes` مراجعه کنید)؛ فقط"

" نام ماژول ``fibo`` را در آنجا اضافه می کند. با استفاده از نام ماژول می "

"توانید به توابع دسترسی پیدا کنید::"

#: ../../tutorial/modules.rst:55

msgid ""

">>> fibo.fib(1000)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987\n"

">>> fibo.fib2(100)\n"

"[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]\n"

">>> fibo.__name__\n"

"'fibo'"

msgstr ""

">>> fibo.fib(1000)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377 610 987\n"

">>> fibo.fib2(100)\n"

"[0, 1, 1, 2, 3, 5, 8, 13, 21, 34, 55, 89]\n"

">>> fibo.__name__\n"

"'fibo'"

#: ../../tutorial/modules.rst:62

msgid ""

"If you intend to use a function often you can assign it to a local name::"

msgstr ""

"اگر قصد دارید از یک تابع به طور مکرر استفاده کنید، می توانید آن را به یک نام"

" محلی اختصاص دهید::"

#: ../../tutorial/modules.rst:64

msgid ""

">>> fib = fibo.fib\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> fib = fibo.fib\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

#: ../../tutorial/modules.rst:72

msgid "More on Modules"

msgstr "بیشتر در مورد ماژول ها"

#: ../../tutorial/modules.rst:74

msgid ""

"A module can contain executable statements as well as function definitions. "

"These statements are intended to initialize the module. They are executed "

"only the *first* time the module name is encountered in an import statement."

" [#]_ (They are also run if the file is executed as a script.)"

msgstr ""

"یک ماژول می تواند شامل بیانیه های اجرایی و همچنین تعریف توابع باشد. این "

"بیانیه ها به منظور مقداردهی اولیه ماژول هستند. آن ها تنها در اولین باری که "

"نام ماژول در یک دستور `import` قرار می گیرد، اجرا می شوند. [#]_ (آن ها "

"همچنین اگر فایل به صورت یک اسکریپت اجرا شود, نیز اجرا خواهند شد.)"

#: ../../tutorial/modules.rst:79

msgid ""

"Each module has its own private namespace, which is used as the global "

"namespace by all functions defined in the module. Thus, the author of a "

"module can use global variables in the module without worrying about "

"accidental clashes with a user's global variables. On the other hand, if you"

" know what you are doing you can touch a module's global variables with the "

"same notation used to refer to its functions, ``modname.itemname``."

msgstr ""

"هر ماژول دارای فضای نام خصوصی خود است که به عنوان فضای نام سراسری توسط تمام "

"توابع تعریف شده در ماژول استفاده می شود. بنابراین، نویسنده یک ماژول می تواند"

" از متغیرهای سراسری در ماژول استفاده کند بدون نگرانی از تداخل تصادفی با "

"متغیرهای سراسری کاربر. از سوی دیگر، اگر بدانید که چه کار می کنید، می توانید "

"با استفاده از همان نشانه گذاری که برای اشاره به توابع آن استفاده می شود، به "

"متغیرهای سراسری یک ماژول دسترسی پیدا کنید."

#: ../../tutorial/modules.rst:86

msgid ""

"Modules can import other modules. It is customary but not required to place"

" all :keyword:`import` statements at the beginning of a module (or script, "

"for that matter). The imported module names, if placed at the top level of "

"a module (outside any functions or classes), are added to the module's "

"global namespace."

msgstr ""

"ماژول ها می توانند ماژول های دیگر را وارد کنند. به طور معمول (ولی الزامی "

"نیست), تمام عبارات :keyword:`import` در ابتدای یک ماژول (یا اسکریپت, در این "

"صورت) قرار می گیرند. نام های ماژول وارد شده، در صورتی که در سطح بالای ماژول "

"(خارج از توابع یا کلاس ها) قرار گیرند، به فضای نام عمومی ماژول اضافه می "

"شوند."

#: ../../tutorial/modules.rst:91

msgid ""

"There is a variant of the :keyword:`import` statement that imports names "

"from a module directly into the importing module's namespace. For example::"

msgstr ""

"نوعی از دستور :keyword:`import` وجود دارد که نام ها را مستقیماً از یک ماژول "

"به فضای نام ماژول واردکننده وارد می کند. برای مثال::"

#: ../../tutorial/modules.rst:94

msgid ""

">>> from fibo import fib, fib2\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import fib, fib2\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

#: ../../tutorial/modules.rst:98

msgid ""

"This does not introduce the module name from which the imports are taken in "

"the local namespace (so in the example, ``fibo`` is not defined)."

msgstr ""

"این کار نام ماژولی که واردات از آن انجام شده را به فضای نام محلی معرفی نمی "

"کند (بنابراین در مثال, ``fibo`` تعریف نشده است)."

#: ../../tutorial/modules.rst:101

msgid "There is even a variant to import all names that a module defines::"

msgstr ""

"حتی یک نوع خاص برای وارد کردن تمامی اسامی که یک ماژول تعریف می کند وجود "

"دارد::"

#: ../../tutorial/modules.rst:103

msgid ""

">>> from fibo import *\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import *\n"

">>> fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

#: ../../tutorial/modules.rst:107

msgid ""

"This imports all names except those beginning with an underscore (``_``). In"

" most cases Python programmers do not use this facility since it introduces "

"an unknown set of names into the interpreter, possibly hiding some things "

"you have already defined."

msgstr ""

"این تمام نام ها را به جز آن هایی که با یک آندرلاین (_) شروع می شوند، وارد می"

" کند. در بیشتر موارد، برنامه نویسان پایتون از این قابلیت استفاده نمی کنند "

"زیرا مجموعه ای ناشناخته از نام ها را وارد مفسر می کند که ممکن است باعث پنهان"

" شدن بعضی از چیزهایی شود که شما قبلاً تعریف کرده اید."

#: ../../tutorial/modules.rst:112

msgid ""

"Note that in general the practice of importing ``*`` from a module or "

"package is frowned upon, since it often causes poorly readable code. "

"However, it is okay to use it to save typing in interactive sessions."

msgstr ""

"توجه داشته باشید که به طور کلی، انجام عمل وارد کردن ``*`` از یک ماژول یا "

"بسته، مورد انتقاد قرار می گیرد، زیرا معمولاً منجر به کدی می شود که خوانایی "

"ضعیفی دارد. با این حال، استفاده از آن برای کاهش تایپ در جلسات تعاملی اشکالی "

"ندارد."

#: ../../tutorial/modules.rst:116

msgid ""

"If the module name is followed by :keyword:`!as`, then the name following "

":keyword:`!as` is bound directly to the imported module."

msgstr ""

"اگر نام ماژول با :keyword:`!as` دنبال شود، سپس نامی که با :keyword:`!as` "

"دنبال می شود به طور مستقیم به ماژول وارد شده متصل می شود."

#: ../../tutorial/modules.rst:121

msgid ""

">>> import fibo as fib\n"

">>> fib.fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> import fibo as fib\n"

">>> fib.fib(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

#: ../../tutorial/modules.rst:125

msgid ""

"This is effectively importing the module in the same way that ``import "

"fibo`` will do, with the only difference of it being available as ``fib``."

msgstr ""

"این به طور مؤثر ماژول را به همان روشی که ``import fibo`` انجام می دهد، وارد "

"می کند، با تنها تفاوت آن که به عنوان ``fib`` در دسترس است."

#: ../../tutorial/modules.rst:128

msgid ""

"It can also be used when utilising :keyword:`from` with similar effects::"

msgstr ""

"همچنین می تواند هنگام استفاده از :keyword:`from` با تأثیرات مشابه مورد "

"استفاده قرار گیرد::"

#: ../../tutorial/modules.rst:130

msgid ""

">>> from fibo import fib as fibonacci\n"

">>> fibonacci(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

msgstr ""

">>> from fibo import fib as fibonacci\n"

">>> fibonacci(500)\n"

"0 1 1 2 3 5 8 13 21 34 55 89 144 233 377"

#: ../../tutorial/modules.rst:137

msgid ""

"For efficiency reasons, each module is only imported once per interpreter "

"session. Therefore, if you change your modules, you must restart the "

"interpreter -- or, if it's just one module you want to test interactively, "

"use :func:`importlib.reload`, e.g. ``import importlib; "

"importlib.reload(modulename)``."

msgstr ""

"به دلایل کارایی، هر ماژول تنها یک بار در هر جلسه مفسر وارد می شود. بنابراین،"

" اگر ماژول های خود را تغییر دهید، باید مفسر را دوباره راه اندازی کنید -- یا "

"اگر فقط یک ماژول است که می خواهید به صورت تعاملی آزمایش کنید، از "

":func:`importlib.reload` استفاده کنید، مثلاً ``import importlib; "

"importlib.reload(modulename)``."

#: ../../tutorial/modules.rst:147

msgid "Executing modules as scripts"

msgstr "اجرای ماژول ها به صورت اسکریپت"

#: ../../tutorial/modules.rst:149

msgid "When you run a Python module with ::"

msgstr "وقتی یک ماژول پایتون را اجرا می کنید با ::"

#: ../../tutorial/modules.rst:151

msgid "python fibo.py <arguments>"

msgstr "python fibo.py <arguments>"

#: ../../tutorial/modules.rst:153

msgid ""

"the code in the module will be executed, just as if you imported it, but "

"with the ``__name__`` set to ``\"__main__\"``. That means that by adding "

"this code at the end of your module::"

msgstr ""

"کد در ماژول اجرا خواهد شد، همان طور که اگر آن را وارد کرده بودید، اما با "

"تنظیم ``__name__`` به ``\"__main__\"``. این بدان معناست که با افزودن این کد "

"در انتهای ماژول خود::"

#: ../../tutorial/modules.rst:157

msgid ""

"if __name__ == \"__main__\":\n"

" import sys\n"

" fib(int(sys.argv[1]))"

msgstr ""

"if __name__ == \"__main__\":\n"

" import sys\n"

" fib(int(sys.argv[1]))"

#: ../../tutorial/modules.rst:161

msgid ""

"you can make the file usable as a script as well as an importable module, "

"because the code that parses the command line only runs if the module is "

"executed as the \"main\" file:"

msgstr ""

"شما می توانید فایل را به گونه ای ایجاد کنید که هم به عنوان یک اسکریپت قابل "

"استفاده باشد و هم به عنوان یک ماژول واردشدنی، زیرا کدی که دستورات خط فرمان "

"را تحلیل می کند، تنها زمانی اجرا می شود که ماژول به عنوان فایل \"main\" اجرا"

" شود:"

#: ../../tutorial/modules.rst:165

msgid ""

"$ python fibo.py 50\n"

"0 1 1 2 3 5 8 13 21 34"

msgstr ""

"$ python fibo.py 50\n"

"0 1 1 2 3 5 8 13 21 34"

#: ../../tutorial/modules.rst:170

msgid "If the module is imported, the code is not run::"

msgstr "اگر ماژول ایمپورت شده باشد، کد اجرا نمی شود::"

#: ../../tutorial/modules.rst:172

msgid ""

">>> import fibo\n"

">>>"

msgstr ""

">>> import fibo\n"

">>>"

#: ../../tutorial/modules.rst:175

msgid ""

"This is often used either to provide a convenient user interface to a "

"module, or for testing purposes (running the module as a script executes a "

"test suite)."

msgstr ""

"این اغلب برای ارائه یک رابط کاربری راحت به یک ماژول یا برای اهداف آزمایش "

"(اجرای ماژول به عنوان یک اسکریپت یک مجموعه تست را اجرا می کند) استفاده می "

"شود."

#: ../../tutorial/modules.rst:182

msgid "The Module Search Path"

msgstr "مسیر جستجوی ماژول"

#: ../../tutorial/modules.rst:186

msgid ""

"When a module named :mod:`!spam` is imported, the interpreter first searches"

" for a built-in module with that name. These module names are listed in "

":data:`sys.builtin_module_names`. If not found, it then searches for a file "

"named :file:`spam.py` in a list of directories given by the variable "

":data:`sys.path`. :data:`sys.path` is initialized from these locations:"

msgstr ""

"وقتی یک ماژول به نام :mod:`!spam` وارد می شود، مفسر ابتدا به دنبال یک ماژول "

"داخلی با آن نام می گردد. نام های این ماژول ها در "

":data:`sys.builtin_module_names` فهرست شده اند. اگر یافت نشود، سپس به دنبال "

"فایلی با نام :file:`spam.py` در لیستی از دایرکتوری ها که توسط متغیر "

":data:`sys.path` ارائه شده است، می گردد. :data:`sys.path` از این مکان ها "

"مقداردهی اولیه می شود:"

#: ../../tutorial/modules.rst:192

msgid ""

"The directory containing the input script (or the current directory when no "

"file is specified)."

msgstr ""

"دایرکتوری که شامل اسکریپت ورودی است (یا دایرکتوری فعلی هنگامی که هیچ فایلی "

"مشخص نشده است)."

#: ../../tutorial/modules.rst:194

msgid ""

":envvar:`PYTHONPATH` (a list of directory names, with the same syntax as the"

" shell variable :envvar:`PATH`)."

msgstr ""

":envvar:`PYTHONPATH` (یک لیست از نام دایرکتوری ها, با همان نحوه نگارش متغیر "

"شِل :envvar:`PATH`)."

#: ../../tutorial/modules.rst:196

msgid ""

"The installation-dependent default (by convention including a ``site-"

"packages`` directory, handled by the :mod:`site` module)."

msgstr ""

"پیش فرض وابسته به نصب (به طور مرسوم شامل یک دایرکتوری ``site-packages`` که "

"توسط ماژول :mod:`site` مدیریت می شود)."

#: ../../tutorial/modules.rst:199

msgid "More details are at :ref:`sys-path-init`."

msgstr "جزئیات بیشتر در :ref:`sys-path-init` قرار دارد."

#: ../../tutorial/modules.rst:202

msgid ""

"On file systems which support symlinks, the directory containing the input "

"script is calculated after the symlink is followed. In other words the "

"directory containing the symlink is **not** added to the module search path."

msgstr ""

"در سیستم فایل هایی که از سیملینک ها پشتیبانی می کنند، دایرکتوری حاوی اسکریپت"

" ورودی پس از دنبال کردن سیملینک محاسبه می شود. به عبارت دیگر، دایرکتوری حاوی"

" سیملینک به مسیر جستجوی ماژول اضافه می شود."

#: ../../tutorial/modules.rst:206

msgid ""

"After initialization, Python programs can modify :data:`sys.path`. The "

"directory containing the script being run is placed at the beginning of the "

"search path, ahead of the standard library path. This means that scripts in "

"that directory will be loaded instead of modules of the same name in the "

"library directory. This is an error unless the replacement is intended. See"

" section :ref:`tut-standardmodules` for more information."

msgstr ""

"پس از مقداردهی اولیه، برنامه های پایتون می توانند :data:`sys.path` را تغییر "

"دهند. دایرکتوری حاوی اسکریپتی که اجرا می شود، در ابتدای مسیر جستجو قرار می "

"گیرد، پیش از مسیر کتابخانه استاندارد. این بدین معناست که اسکریپت های موجود "

"در آن دایرکتوری به جای ماژول های هم نام در دایرکتوری کتابخانه بارگذاری می "

"شوند. این یک خطا است مگر اینکه جایگزینی مورد نظر باشد. برای اطلاعات بیشتر به"

" بخش :ref:`tut-standardmodules` مراجعه کنید."

#: ../../tutorial/modules.rst:219

msgid "\"Compiled\" Python files"

msgstr "فایل های پایتون \"کامپایل شده\""

#: ../../tutorial/modules.rst:221

msgid ""

"To speed up loading modules, Python caches the compiled version of each "

"module in the ``__pycache__`` directory under the name "

":file:`module.{version}.pyc`, where the version encodes the format of the "

"compiled file; it generally contains the Python version number. For "

"example, in CPython release 3.3 the compiled version of spam.py would be "

"cached as ``__pycache__/spam.cpython-33.pyc``. This naming convention "

"allows compiled modules from different releases and different versions of "

"Python to coexist."

msgstr ""

"برای سرعت بخشیدن به بارگذاری ماژول ها، پایتون نسخه کامپایل شده هر ماژول را "

"در دایرکتوری ``__pycache__``، با نام :file:`module.{version}.pyc` ذخیره می "

"کند که نسخه آن فرمت فایل کامپایل شده را رمزگذاری می کند؛ به طور کلی شامل "

"شماره نسخه پایتون است. به عنوان مثال، در نسخه 3.3 CPython، نسخه کامپایل شده "

"spam.py به صورت ``__pycache__/spam.cpython-33.pyc`` ذخیره می شود. این "

"نامگذاری به ماژول های کامپایل شده از نسخه ها و شماره های مختلف پایتون اجازه "

"می دهد که در کنار هم وجود داشته باشند."

#: ../../tutorial/modules.rst:229

msgid ""

"Python checks the modification date of the source against the compiled "

"version to see if it's out of date and needs to be recompiled. This is a "

"completely automatic process. Also, the compiled modules are platform-"

"independent, so the same library can be shared among systems with different "

"architectures."

msgstr ""

"پایتون تاریخ تغییر منبع را در مقابل نسخه کامپایل شده بررسی می کند تا ببیند "

"آیا قدیمی است و نیاز به بازکامپایل شدن دارد یا خیر. این یک فرآیند کاملاً "

"خودکار است. همچنین، ماژول های کامپایل شده مستقل از پلتفرم هستند، بنابراین "

"همان کتابخانه می تواند بین سیستم هایی با معماری های متفاوت به اشتراک گذاشته "

"شود."

#: ../../tutorial/modules.rst:234

msgid ""

"Python does not check the cache in two circumstances. First, it always "

"recompiles and does not store the result for the module that's loaded "

"directly from the command line. Second, it does not check the cache if "

"there is no source module. To support a non-source (compiled only) "

"distribution, the compiled module must be in the source directory, and there"

" must not be a source module."

msgstr ""

"پایتون در دو حالت حافظه پنهان را بررسی نمی کند. اول، همیشه دوباره کامپایل "

"کرده و نتیجه را برای ماژولی که به طور مستقیم از خط فرمان بارگذاری می شود، "

"ذخیره نمی کند. دوم، اگر ماژول منبعی وجود نداشته باشد، حافظه پنهان را بررسی "

"نمی کند. برای پشتیبانی از توزیع بدون منبع (فقط کامپایل شده), ماژول کامپایل "

"شده باید در دایرکتوری منبع باشد و نباید ماژول منبعی وجود داشته باشد."

#: ../../tutorial/modules.rst:241

msgid "Some tips for experts:"

msgstr "نکاتی برای متخصصان:"

#: ../../tutorial/modules.rst:243

msgid ""

"You can use the :option:`-O` or :option:`-OO` switches on the Python command"

" to reduce the size of a compiled module. The ``-O`` switch removes assert "

"statements, the ``-OO`` switch removes both assert statements and __doc__ "

"strings. Since some programs may rely on having these available, you should"

" only use this option if you know what you're doing. \"Optimized\" modules "

"have an ``opt-`` tag and are usually smaller. Future releases may change "

"the effects of optimization."

msgstr ""

"شما می توانید از سوئیچ های :option:`-O` یا :option:`-OO` در دستور Python "

"استفاده کنید تا حجم یک ماژول کامپایل شده را کاهش دهید. سوئیچ ``-O`` عبارات "

"assert را حذف می کند، سوئیچ ``-OO`` هم عبارات assert و هم رشته های __doc__ "

"را حذف می کند. از آنجایی که برخی برنامه ها ممکن است بر دسترسی به این ها تکیه"

" داشته باشند، باید تنها در صورتی که دقیقاً می دانید چه کاری انجام می دهید از"

" این گزینه استفاده کنید. ماژول های \"بهینه سازی شده\" دارای یک برچسب "

"``opt-`` هستند و معمولاً حجم کمتری دارند. نسخه های آینده ممکن است اثرات "

"بهینه سازی را تغییر دهند."

#: ../../tutorial/modules.rst:251

msgid ""

"A program doesn't run any faster when it is read from a ``.pyc`` file than "

"when it is read from a ``.py`` file; the only thing that's faster about "

"``.pyc`` files is the speed with which they are loaded."

msgstr ""

"اجرای یک برنامه زمانی که از فایل ``.pyc`` خوانده می شود، سریع تر از زمانی که"

" از فایل ``.py`` خوانده می شود نیست؛ تنها نکته ای که در مورد فایل های "

"``.pyc`` سریع تر است، سرعت بارگذاری آنهاست."

#: ../../tutorial/modules.rst:255

msgid ""

"The module :mod:`compileall` can create .pyc files for all modules in a "

"directory."

msgstr ""

"ماژول :mod:`compileall` می تواند فایل های .pyc را برای همه ماژول ها در یک "

"دایرکتوری ایجاد کند."

#: ../../tutorial/modules.rst:258

msgid ""

"There is more detail on this process, including a flow chart of the "

"decisions, in :pep:`3147`."

msgstr ""

"جزئیات بیشتری در مورد این فرآیند، از جمله یک نمودار جریان از تصمیمات، در "

":pep:`3147` وجود دارد."

#: ../../tutorial/modules.rst:265

msgid "Standard Modules"

msgstr "ماژول های استاندارد"

#: ../../tutorial/modules.rst:269

msgid ""

"Python comes with a library of standard modules, described in a separate "

"document, the Python Library Reference (\"Library Reference\" hereafter). "

"Some modules are built into the interpreter; these provide access to "

"operations that are not part of the core of the language but are "

"nevertheless built in, either for efficiency or to provide access to "

"operating system primitives such as system calls. The set of such modules "

"is a configuration option which also depends on the underlying platform. "

"For example, the :mod:`winreg` module is only provided on Windows systems. "

"One particular module deserves some attention: :mod:`sys`, which is built "

"into every Python interpreter. The variables ``sys.ps1`` and ``sys.ps2`` "

"define the strings used as primary and secondary prompts::"

msgstr ""

"پایتون با یک کتابخانه از ماژول های استاندارد ارائه می شود که در یک سند "

"جداگانه به نام مرجع کتابخانه پایتون (\"مرجع کتابخانه\" از این پس) توصیف شده "

"است. برخی از ماژول ها در مفسر ساخته شده اند؛ این ماژول ها امکان دسترسی به "

"عملیاتی را فراهم می کنند که بخشی از هسته زبان نیستند، اما به هر حال به دلایل"

" کارایی یا جهت دسترسی به ابزارهای اولیه سیستم عامل مانند فراخوانی های سیستمی"

" ساخته شده اند. مجموعه این ماژول ها یک گزینه پیکربندی است که همچنین به پلت "

"فرم زیربنایی بستگی دارد. برای مثال، ماژول :mod:`winreg` تنها در سیستم های "

"ویندوز ارائه می شود. یک ماژول خاص نیاز به توجه دارد: :mod:`sys`، که در هر "

"مفسر پایتون ساخته شده است. متغیرهای ``sys.ps1`` و ``sys.ps2`` رشته هایی که "

"به عنوان پرامپت اولیه و ثانویه مورد استفاده قرار می گیرند را تعریف می کنند::"

#: ../../tutorial/modules.rst:281

msgid ""

">>> import sys\n"

">>> sys.ps1\n"

"'>>> '\n"

">>> sys.ps2\n"

"'... '\n"

">>> sys.ps1 = 'C> '\n"

"C> print('Yuck!')\n"

"Yuck!\n"

"C>"

msgstr ""

">>> import sys\n"

">>> sys.ps1\n"

"'>>> '\n"

">>> sys.ps2\n"

"'... '\n"

">>> sys.ps1 = 'C> '\n"

"C> print('Yuck!')\n"

"Yuck!\n"

"C>"

#: ../../tutorial/modules.rst:292

msgid ""

"These two variables are only defined if the interpreter is in interactive "

"mode."

msgstr "این دو متغیر تنها زمانی تعریف می شوند که مفسر در حالت تعاملی باشد."

#: ../../tutorial/modules.rst:294

msgid ""

"The variable ``sys.path`` is a list of strings that determines the "

"interpreter's search path for modules. It is initialized to a default path "

"taken from the environment variable :envvar:`PYTHONPATH`, or from a built-in"

" default if :envvar:`PYTHONPATH` is not set. You can modify it using "

"standard list operations::"

msgstr ""

"متغیر ``sys.path`` یک لیستی از رشته ها است که مسیر جستجوی مفسر برای ماژول ها"

" را تعیین می کند. این متغیر به یک مسیر پیش فرض که از متغیر محیطی "

":envvar:`PYTHONPATH` گرفته شده است، یا اگر :envvar:`PYTHONPATH` تنظیم نشده "

"باشد، از یک مقدار پیش فرض داخلی، مقداردهی اولیه می شود. شما می توانید با "

"استفاده از عملیات استاندارد لیست آن را تغییر دهید::"

#: ../../tutorial/modules.rst:300

msgid ""

">>> import sys\n"

">>> sys.path.append('/ufs/guido/lib/python')"

msgstr ""

">>> import sys\n"

">>> sys.path.append('/ufs/guido/lib/python')"

#: ../../tutorial/modules.rst:307

msgid "The :func:`dir` Function"

msgstr "تابع :func:`dir`"

#: ../../tutorial/modules.rst:309

msgid ""

"The built-in function :func:`dir` is used to find out which names a module "

"defines. It returns a sorted list of strings::"

msgstr ""

"تابع داخلی :func:`dir` برای پیدا کردن نام هایی که یک ماژول تعریف می کند "

"استفاده می شود. این تابع یک لیست مرتب شده از رشته ها را برمی گرداند::"

#: ../../tutorial/modules.rst:312

msgid ""

">>> import fibo, sys\n"

">>> dir(fibo)\n"

"['__name__', 'fib', 'fib2']\n"

">>> dir(sys)\n"

"['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',\n"

" '__interactivehook__', '__loader__', '__name__', '__package__', '__spec__',\n"

" '__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',\n"

" '_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',\n"

" '_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',\n"

" 'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',\n"

" 'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',\n"

" 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',\n"

" 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',\n"

" 'float_repr_style', 'get_asyncgen_hooks', 'get_coroutine_origin_tracking_depth',\n"

" 'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',\n"

" 'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',\n"

" 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',\n"

" 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',\n"

" 'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',\n"

" 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',\n"

" 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', 'pycache_prefix',\n"

" 'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', 'setdlopenflags',\n"

" 'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', 'stderr',\n"

" 'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', 'version_info',\n"

" 'warnoptions']"

msgstr ""

">>> import fibo, sys\n"

">>> dir(fibo)\n"

"['__name__', 'fib', 'fib2']\n"

">>> dir(sys)\n"

"['__breakpointhook__', '__displayhook__', '__doc__', '__excepthook__',\n"

" '__interactivehook__', '__loader__', '__name__', '__package__', '__spec__',\n"

" '__stderr__', '__stdin__', '__stdout__', '__unraisablehook__',\n"

" '_clear_type_cache', '_current_frames', '_debugmallocstats', '_framework',\n"

" '_getframe', '_git', '_home', '_xoptions', 'abiflags', 'addaudithook',\n"

" 'api_version', 'argv', 'audit', 'base_exec_prefix', 'base_prefix',\n"

" 'breakpointhook', 'builtin_module_names', 'byteorder', 'call_tracing',\n"

" 'callstats', 'copyright', 'displayhook', 'dont_write_bytecode', 'exc_info',\n"

" 'excepthook', 'exec_prefix', 'executable', 'exit', 'flags', 'float_info',\n"

" 'float_repr_style', 'get_asyncgen_hooks', 'get_coroutine_origin_tracking_depth',\n"

" 'getallocatedblocks', 'getdefaultencoding', 'getdlopenflags',\n"

" 'getfilesystemencodeerrors', 'getfilesystemencoding', 'getprofile',\n"

" 'getrecursionlimit', 'getrefcount', 'getsizeof', 'getswitchinterval',\n"

" 'gettrace', 'hash_info', 'hexversion', 'implementation', 'int_info',\n"

" 'intern', 'is_finalizing', 'last_traceback', 'last_type', 'last_value',\n"

" 'maxsize', 'maxunicode', 'meta_path', 'modules', 'path', 'path_hooks',\n"

" 'path_importer_cache', 'platform', 'prefix', 'ps1', 'ps2', 'pycache_prefix',\n"

" 'set_asyncgen_hooks', 'set_coroutine_origin_tracking_depth', 'setdlopenflags',\n"

" 'setprofile', 'setrecursionlimit', 'setswitchinterval', 'settrace', 'stderr',\n"

" 'stdin', 'stdout', 'thread_info', 'unraisablehook', 'version', 'version_info',\n"

" 'warnoptions']"

#: ../../tutorial/modules.rst:338

msgid ""

"Without arguments, :func:`dir` lists the names you have defined currently::"

msgstr ""

"بدون آرگومان، :func:`dir` نام هایی را که در حال حاضر تعریف کرده اید لیست می "

"کند::"

#: ../../tutorial/modules.rst:340

msgid ""

">>> a = [1, 2, 3, 4, 5]\n"

">>> import fibo\n"

">>> fib = fibo.fib\n"

">>> dir()\n"

"['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']"

msgstr ""

">>> a = [1, 2, 3, 4, 5]\n"

">>> import fibo\n"

">>> fib = fibo.fib\n"

">>> dir()\n"

"['__builtins__', '__name__', 'a', 'fib', 'fibo', 'sys']"

#: ../../tutorial/modules.rst:346

msgid ""

"Note that it lists all types of names: variables, modules, functions, etc."

msgstr ""

"توجه داشته باشید که شامل همه انواع نام ها می شود: متغیرها، ماژول ها، توابع، "

"و غیره."

#: ../../tutorial/modules.rst:350

msgid ""

":func:`dir` does not list the names of built-in functions and variables. If"

" you want a list of those, they are defined in the standard module "

":mod:`builtins`::"

msgstr ""

":func:`dir` نام توابع و متغیرهای داخلی را فهرست نمی کند. اگر به دنبال فهرستی"

" از آن ها هستید، آن ها در ماژول استاندارد :mod:`builtins` تعریف شده اند::"

#: ../../tutorial/modules.rst:354

msgid ""

">>> import builtins\n"

">>> dir(builtins)\n"

"['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',\n"

" 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',\n"

" 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',\n"

" 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',\n"

" 'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',\n"

" 'FileExistsError', 'FileNotFoundError', 'FloatingPointError',\n"

" 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',\n"

" 'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',\n"

" 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',\n"

" 'MemoryError', 'NameError', 'None', 'NotADirectoryError', 'NotImplemented',\n"

" 'NotImplementedError', 'OSError', 'OverflowError',\n"

" 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',\n"

" 'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',\n"

" 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',\n"

" 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',\n"

" 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',\n"

" 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',\n"

" 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',\n"

" '__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',\n"

" 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',\n"

" 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',\n"

" 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',\n"

" 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',\n"

" 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',\n"

" 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',\n"

" 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',\n"

" 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',\n"

" 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',\n"

" 'zip']"

msgstr ""

">>> import builtins\n"

">>> dir(builtins)\n"

"['ArithmeticError', 'AssertionError', 'AttributeError', 'BaseException',\n"

" 'BlockingIOError', 'BrokenPipeError', 'BufferError', 'BytesWarning',\n"

" 'ChildProcessError', 'ConnectionAbortedError', 'ConnectionError',\n"

" 'ConnectionRefusedError', 'ConnectionResetError', 'DeprecationWarning',\n"

" 'EOFError', 'Ellipsis', 'EnvironmentError', 'Exception', 'False',\n"

" 'FileExistsError', 'FileNotFoundError', 'FloatingPointError',\n"

" 'FutureWarning', 'GeneratorExit', 'IOError', 'ImportError',\n"

" 'ImportWarning', 'IndentationError', 'IndexError', 'InterruptedError',\n"

" 'IsADirectoryError', 'KeyError', 'KeyboardInterrupt', 'LookupError',\n"

" 'MemoryError', 'NameError', 'None', 'NotADirectoryError', 'NotImplemented',\n"

" 'NotImplementedError', 'OSError', 'OverflowError',\n"

" 'PendingDeprecationWarning', 'PermissionError', 'ProcessLookupError',\n"

" 'ReferenceError', 'ResourceWarning', 'RuntimeError', 'RuntimeWarning',\n"

" 'StopIteration', 'SyntaxError', 'SyntaxWarning', 'SystemError',\n"

" 'SystemExit', 'TabError', 'TimeoutError', 'True', 'TypeError',\n"

" 'UnboundLocalError', 'UnicodeDecodeError', 'UnicodeEncodeError',\n"

" 'UnicodeError', 'UnicodeTranslateError', 'UnicodeWarning', 'UserWarning',\n"

" 'ValueError', 'Warning', 'ZeroDivisionError', '_', '__build_class__',\n"

" '__debug__', '__doc__', '__import__', '__name__', '__package__', 'abs',\n"

" 'all', 'any', 'ascii', 'bin', 'bool', 'bytearray', 'bytes', 'callable',\n"

" 'chr', 'classmethod', 'compile', 'complex', 'copyright', 'credits',\n"

" 'delattr', 'dict', 'dir', 'divmod', 'enumerate', 'eval', 'exec', 'exit',\n"

" 'filter', 'float', 'format', 'frozenset', 'getattr', 'globals', 'hasattr',\n"

" 'hash', 'help', 'hex', 'id', 'input', 'int', 'isinstance', 'issubclass',\n"

" 'iter', 'len', 'license', 'list', 'locals', 'map', 'max', 'memoryview',\n"

" 'min', 'next', 'object', 'oct', 'open', 'ord', 'pow', 'print', 'property',\n"

" 'quit', 'range', 'repr', 'reversed', 'round', 'set', 'setattr', 'slice',\n"

" 'sorted', 'staticmethod', 'str', 'sum', 'super', 'tuple', 'type', 'vars',\n"

" 'zip']"

#: ../../tutorial/modules.rst:389

msgid "Packages"

msgstr "بسته ها"

#: ../../tutorial/modules.rst:391

msgid ""

"Packages are a way of structuring Python's module namespace by using "

"\"dotted module names\". For example, the module name :mod:`!A.B` "

"designates a submodule named ``B`` in a package named ``A``. Just like the "

"use of modules saves the authors of different modules from having to worry "

"about each other's global variable names, the use of dotted module names "

"saves the authors of multi-module packages like NumPy or Pillow from having "

"to worry about each other's module names."

msgstr ""

"پکیج ها روشی برای ساختاربندی فضای نام ماژول های پایتون با استفاده از \"نام "

"های ماژول نقطه گذاری شده\" هستند. به عنوان مثال، نام ماژول :mod:`!A.B` یک "

"زیرماژول به نام ``B`` را در یک پکیج به نام ``A`` تعیین می کند. درست مانند "

"استفاده از ماژول ها که نویسندگان ماژول های مختلف را از نگرانی درباره نام های"

" متغیر جهانی یکدیگر بی نیاز می کند، استفاده از نام های ماژول نقطه گذاری شده "

"نویسندگان پکیج های چند ماژولی مثل NumPy یا Pillow را از نگرانی درباره نام "

"های ماژول یکدیگر بی نیاز می کند."

#: ../../tutorial/modules.rst:399

msgid ""

"Suppose you want to design a collection of modules (a \"package\") for the "

"uniform handling of sound files and sound data. There are many different "

"sound file formats (usually recognized by their extension, for example: "

":file:`.wav`, :file:`.aiff`, :file:`.au`), so you may need to create and "

"maintain a growing collection of modules for the conversion between the "

"various file formats. There are also many different operations you might "

"want to perform on sound data (such as mixing, adding echo, applying an "

"equalizer function, creating an artificial stereo effect), so in addition "

"you will be writing a never-ending stream of modules to perform these "

"operations. Here's a possible structure for your package (expressed in "

"terms of a hierarchical filesystem):"

msgstr ""

"فرض کنید می خواهید مجموعه ای از ماژول ها (یک \"پکیج\") برای مدیریت یکپارچه "

"فایل های صوتی و داده های صوتی طراحی کنید. انواع مختلفی از فرمت های فایل صوتی"

" وجود دارد (که معمولاً با پسوندشان شناخته می شوند, برای مثال: :file:`.wav`, "

":file:`.aiff`, :file:`.au`), بنابراین ممکن است نیاز داشته باشید مجموعه ای رو"

" به رشد از ماژول ها برای تبدیل بین فرمت های مختلف فایل ها ایجاد و نگهداری "

"کنید. همچنین عملیات متنوعی وجود دارد که ممکن است بخواهید بر روی داده های "

"صوتی انجام دهید (مانند میکس, افزوده های اکو, اعمال یک تابع اکولایزر, ایجاد "

"یک افکت استریو مصنوعی), بنابراین علاوه بر این، شما در حال نوشتن جریان پایان "

"ناپذیری از ماژول ها برای انجام این عملیات خواهید بود. اینجا ساختاری ممکن "

"برای پکیج شما آورده شده است (که بر اساس یک سیستم فایل سلسله مراتبی بیان شده "

"است):"

#: ../../tutorial/modules.rst:410

msgid ""

"sound/ Top-level package\n"

" __init__.py Initialize the sound package\n"

" formats/ Subpackage for file format conversions\n"

" __init__.py\n"

" wavread.py\n"

" wavwrite.py\n"

" aiffread.py\n"

" aiffwrite.py\n"

" auread.py\n"

" auwrite.py\n"

" ...\n"

" effects/ Subpackage for sound effects\n"

" __init__.py\n"

" echo.py\n"

" surround.py\n"

" reverse.py\n"

" ...\n"

" filters/ Subpackage for filters\n"

" __init__.py\n"

" equalizer.py\n"

" vocoder.py\n"

" karaoke.py\n"

" ..."

msgstr ""

"sound/ بسته سطح بالا\n"

" __init__.py مقداردهی اولیه بسته sound\n"

" formats/ زیر بسته برای تبدیل فرمت فایل ها\n"

" __init__.py\n"

" wavread.py\n"

" wavwrite.py\n"

" aiffread.py\n"

" aiffwrite.py\n"

" auread.py\n"

" auwrite.py\n"

" ...\n"

" effects/ زیر بسته برای افکت های صوتی\n"

" __init__.py\n"

" echo.py\n"

" surround.py\n"

" reverse.py\n"

" ...\n"

" filters/ زیر بسته برای فیلترها\n"

" __init__.py\n"

" equalizer.py\n"

" vocoder.py\n"

" karaoke.py\n"

" ..."

#: ../../tutorial/modules.rst:436

msgid ""

"When importing the package, Python searches through the directories on "

"``sys.path`` looking for the package subdirectory."

msgstr ""

"زمانی که بسته وارد می شود، پایتون در دایرکتوری های موجود در ``sys.path`` "

"جستجو می کند تا زیردایرکتوری بسته را پیدا کند."

#: ../../tutorial/modules.rst:439

msgid ""

"The :file:`__init__.py` files are required to make Python treat directories "

"containing the file as packages (unless using a :term:`namespace package`, a"

" relatively advanced feature). This prevents directories with a common name,"

" such as ``string``, from unintentionally hiding valid modules that occur "

"later on the module search path. In the simplest case, :file:`__init__.py` "

"can just be an empty file, but it can also execute initialization code for "

"the package or set the ``__all__`` variable, described later."

msgstr ""

"پرونده های :file:`__init__.py` برای این لازم است که پایتون دایرکتوری هایی که"

" این فایل را دارند به عنوان بسته شناخته کند (مگر آنکه از یک :term:`namespace"

" package` استفاده شود, که ویژگی نسبتاً پیشرفته ای است). این کار از مخفی شدن "

"ناخواستهٔ ماژول های معتبر توسط دایرکتوری های دارای نام های رایج، مانند "

"``string``، در مسیر جستجوی ماژول جلوگیری می کند. در ساده ترین حالت، "

":file:`__init__.py` می تواند فقط یک فایل خالی باشد، اما همچنین می تواند کد "

"اولیه سازی برای بسته را اجرا کرده یا متغیر ``__all__`` را که بعداً توضیح "

"داده خواهد شد ست کند."

#: ../../tutorial/modules.rst:447

msgid ""

"Users of the package can import individual modules from the package, for "

"example::"

msgstr ""

"کاربران بسته می توانند به صورت جداگانه ماژول های مختلف را از بسته وارد کنند،"

" به عنوان مثال::"

#: ../../tutorial/modules.rst:450

msgid "import sound.effects.echo"

msgstr "import sound.effects.echo"

#: ../../tutorial/modules.rst:452

msgid ""

"This loads the submodule :mod:`!sound.effects.echo`. It must be referenced "

"with its full name. ::"

msgstr ""

"این زیرماژول :mod:`!sound.effects.echo` را بارگذاری می کند. باید با نام کامل"

" به آن ارجاع داده شود. ::"

#: ../../tutorial/modules.rst:455

msgid "sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)"

msgstr "sound.effects.echo.echofilter(input, output, delay=0.7, atten=4)"

#: ../../tutorial/modules.rst:457

msgid "An alternative way of importing the submodule is::"

msgstr "راه دیگری برای وارد کردن زیرماژول وجود دارد::"

#: ../../tutorial/modules.rst:459

msgid "from sound.effects import echo"

msgstr "from sound.effects import echo"

#: ../../tutorial/modules.rst:461

msgid ""

"This also loads the submodule :mod:`!echo`, and makes it available without "

"its package prefix, so it can be used as follows::"

msgstr ""

"این همچنین زیر ماژول :mod:`!echo` را بارگذاری می کند و بدون پیشوند بسته، آن "

"را در دسترس قرار می دهد، بنابراین می توان به صورت زیر از آن استفاده کرد::"

#: ../../tutorial/modules.rst:464

msgid "echo.echofilter(input, output, delay=0.7, atten=4)"

msgstr "echo.echofilter(input, output, delay=0.7, atten=4)"

#: ../../tutorial/modules.rst:466