Repository navigation
Expand file tree
/
Copy pathvenv.po
More file actions
273 lines (230 loc) · 19.4 KB
/
Copy pathvenv.po
File metadata and controls
273 lines (230 loc) · 19.4 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
# 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:
# Danial Behzadi <dani.behzi@ubuntu.com>, 2025
# 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-08-26 03:59+0000\n"
"PO-Revision-Date: 2026-08-25 20:56+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 "Virtual Environments and Packages"
msgstr "محیط‌های مجازی و بسته‌ها"
msgid "Introduction"
msgstr "مقدمه"
msgid "Python applications will often use packages and modules that don't come as part of the standard library. Applications will sometimes need a specific version of a library, because the application may require that a particular bug has been fixed or the application may be written using an obsolete version of the library's interface."
msgstr "برنامه‌های پایتون معمولاً از بسته‌ها و ماژول‌هایی استفاده می‌کنند که بخشی از کتابخانه‌ی استاندارد نیستند. همچنین، گاهی یک برنامه به نسخه‌ی مشخصی از یک کتابخانه نیاز دارد؛ زیرا ممکن است به رفع یک باگ خاص وابسته باشد یا با استفاده از نسخه‌ی قدیمی‌تری از رابط آن کتابخانه نوشته شده باشد."
msgid "This means it may not be possible for one Python installation to meet the requirements of every application. If application A needs version 1.0 of a particular module but application B needs version 2.0, then the requirements are in conflict and installing either version 1.0 or 2.0 will leave one application unable to run."
msgstr "این موضوع باعث می‌شود که یک نصب واحد از پایتون نتواند نیازهای همه‌ی برنامه‌ها را برآورده کند. برای مثال، اگر برنامه‌ی A به نسخه‌ی 1.0 یک ماژول نیاز داشته باشد، اما برنامه‌ی B به نسخه‌ی 2.0 همان ماژول وابسته باشد، این نیازها با یکدیگر در تعارض خواهند بود و نصب هر یک از نسخه‌های 1.0 یا 2.0 باعث می‌شود یکی از برنامه‌ها دیگر قابل اجرا نباشد."
msgid "The solution for this problem is to create a :term:`virtual environment`, a self-contained directory tree that contains a Python installation for a particular version of Python, plus a number of additional packages."
msgstr "راه‌حل این مشکل، ایجاد یک :term:`محیط مجازی <virtual environment>` است؛ یک ساختار پوشه مستقل که شامل یک نصب از پایتون برای نسخه‌ای مشخص از پایتون، به‌همراه تعدادی بسته‌ی اضافی است."
msgid "Different applications can then use different virtual environments. To resolve the earlier example of conflicting requirements, application A can have its own virtual environment with version 1.0 installed while application B has another virtual environment with version 2.0. If application B requires a library be upgraded to version 3.0, this will not affect application A's environment."
msgstr "به این ترتیب، هر برنامه می‌تواند از محیط مجازی مخصوص به خود استفاده کند. برای حل مثال قبلی، برنامه‌ی A می‌تواند محیط مجازی خود را با نسخه‌ی 1.0 آن ماژول داشته باشد، در حالی که برنامه‌ی B از محیط مجزایی با نسخه‌ی 2.0 استفاده کند. اگر بعدها برنامه‌ی B به ارتقای آن کتابخانه به نسخه‌ی 3.0 نیاز داشته باشد، این تغییر هیچ تأثیری بر محیط برنامه‌ی A نخواهد داشت."
msgid "Creating Virtual Environments"
msgstr "ایجاد محیط‌های مجازی"
msgid "The module used to create and manage virtual environments is called :mod:`venv`. :mod:`venv` will install the Python version from which the command was run (as reported by the :option:`--version` option). For instance, executing the command with ``python3.12`` will install version 3.12."
msgstr "ماژولی که برای ایجاد و مدیریت محیط‌های مجازی استفاده می‌شود، :mod:`venv` نام دارد. ماژول :mod:`venv` همان نسخه‌ای از پایتون را نصب می‌کند که دستور با آن اجرا شده است (همان‌طور که با گزینه‌ی :option:`--version` گزارش می‌شود). برای مثال، اگر دستور را با ``python3.12`` اجرا کنید، نسخه‌ی 3.12 نصب خواهد شد."
msgid "To create a virtual environment, decide upon a directory where you want to place it, and run the :mod:`venv` module as a script with the directory path::"
msgstr "برای ایجاد یک محیط مجازی، ابتدا پوشه موردنظر خود را انتخاب کنید و سپس ماژول :mod:`venv` را به‌صورت یک اسکریپت همراه با مسیر آن پوشه اجرا کنید::"
msgid "python -m venv tutorial-env"
msgstr "python -m venv tutorial-env"
msgid "This will create the ``tutorial-env`` directory if it doesn't exist, and also create directories inside it containing a copy of the Python interpreter and various supporting files."
msgstr "اگر پوشه ``tutorial-env`` وجود نداشته باشد، این دستور آن را ایجاد می‌کند و همچنین درون آن پوشه‌هایی شامل یک نسخه از مفسر پایتون و پرونده‌های پشتیبان موردنیاز را می‌سازد."
msgid "A common directory location for a virtual environment is ``.venv``. This name keeps the directory typically hidden in your shell and thus out of the way while giving it a name that explains why the directory exists. It also prevents clashing with ``.env`` environment variable definition files that some tooling supports."
msgstr "یکی از محل‌های رایج برای ایجاد محیط مجازی، پوشه ``.venv`` است. این نام معمولاً باعث می‌شود پوشه در پوسته مخفی بماند و در عین حال به‌خوبی نشان دهد که دلیل وجود آن چیست. همچنین از تداخل با پرونده‌های تعریف متغیرهای محیطی ``.env`` که برخی ابزارها از آن‌ها پشتیبانی می‌کنند، جلوگیری می‌کند."
msgid "Once you've created a virtual environment, you may activate it."
msgstr "پس از ایجاد محیط مجازی، می‌توانید آن را فعال کنید."
msgid "On Windows, run::"
msgstr "در ویندوز، دستور زیر را اجرا کنید::"
msgid "tutorial-env\\Scripts\\activate"
msgstr "tutorial-env\\Scripts\\activate"
msgid "On Unix or MacOS, run::"
msgstr "در یونیکس یا macOS، دستور زیر را اجرا کنید::"
msgid "source tutorial-env/bin/activate"
msgstr "source tutorial-env/bin/activate"
msgid "(This script is written for the bash shell. If you use the :program:`csh` or :program:`fish` shells, there are alternate ``activate.csh`` and ``activate.fish`` scripts you should use instead.)"
msgstr "(این اسکریپت برای پوسته bash نوشته شده است. اگر از پوسته‌های :program:`csh` یا :program:`fish` استفاده می‌کنید، باید به‌ترتیب از اسکریپت‌های ``activate.csh`` یا ``activate.fish`` استفاده کنید.)"
msgid "Activating the virtual environment will change your shell's prompt to show what virtual environment you're using, and modify the environment so that running ``python`` will get you that particular version and installation of Python. For example:"
msgstr "با فعال کردن محیط مجازی، اعلان پوسته تغییر می‌کند تا نشان دهد از کدام محیط مجازی استفاده می‌کنید. همچنین محیط به‌گونه‌ای تنظیم می‌شود که با اجرای دستور ``python``، همان نسخه و نصب پایتون مربوط به آن محیط مجازی اجرا شود. برای مثال:"
msgid ""
"$ source ~/envs/tutorial-env/bin/activate\n"
"(tutorial-env) $ python\n"
"Python 3.5.1 (default, May 6 2016, 10:59:36)\n"
" ...\n"
">>> import sys\n"
">>> sys.path\n"
"['', '/usr/local/lib/python35.zip', ...,\n"
"'~/envs/tutorial-env/lib/python3.5/site-packages']\n"
">>>"
msgstr ""
"$ source ~/envs/tutorial-env/bin/activate\n"
"(tutorial-env) $ python\n"
"Python 3.5.1 (default, May 6 2016, 10:59:36)\n"
" ...\n"
">>> import sys\n"
">>> sys.path\n"
"['', '/usr/local/lib/python35.zip', ...,\n"
"'~/envs/tutorial-env/lib/python3.5/site-packages']\n"
">>>"
msgid "Note that the activated virtual environment does not alter the ``PYTHONPATH`` variable in any way. This may lead to unexpected results if the path includes references to code which is incompatible with the Python version the virtual environment is using. The best practice is to ``unset PYTHONPATH`` in bash or the equivalent for the shell you are using."
msgstr "توجه داشته باشید که محیط مجازی فعال‌شده، متغیر ``PYTHONPATH`` را به هیچ‌وجه تغییر نمی‌دهد. اگر این مسیر شامل ارجاع‌هایی به کدی باشد که با نسخه پایتونی که محیط مجازی استفاده می‌کند سازگار نیست، ممکن است به نتایج غیرمنتظره‌ای منجر شود. بهترین روش این است که در bash یا معادل آن در پوسته‌ای که استفاده می‌کنید، این متغیر را با دستور ``unset PYTHONPATH`` حذف کنید."
msgid "To deactivate a virtual environment, type::"
msgstr "برای غیرفعال کردن محیط مجازی، دستور زیر را وارد کنید::"
msgid "deactivate"
msgstr "deactivate"
msgid "into the terminal."
msgstr "در پایانه."
msgid "Managing Packages with pip"
msgstr "مدیریت بسته‌ها با pip"
msgid "You can install, upgrade, and remove packages using a program called :program:`pip`. By default ``pip`` will install packages from the `Python Package Index <https://pypi.org>`_. You can browse the Python Package Index by going to it in your web browser."
msgstr "می‌توانید با استفاده از برنامه‌ای به نام :program:`pip` بسته‌ها را نصب، به‌روزرسانی و حذف کنید. به‌طور پیش‌فرض، ``pip`` بسته‌ها را از `Python Package Index <https://pypi.org>`_ نصب می‌کند. همچنین می‌توانید با مراجعه به این وب‌سایت در مرورگر خود، بسته‌های موجود در Python Package Index را مرور کنید."
msgid "``pip`` has a number of subcommands: \"install\", \"uninstall\", \"freeze\", etc. (Consult the :ref:`installing-index` guide for complete documentation for ``pip``.)"
msgstr "``pip`` دارای چندین زیرفرمان مانند «install»، «uninstall»، «freeze» و موارد دیگر است. (برای مشاهده‌ی مستندات کامل ``pip`` به راهنمای :ref:`installing-index` مراجعه کنید.)"
msgid "You can install the latest version of a package by specifying a package's name:"
msgstr "می‌توانید با مشخص کردن نام یک بسته، آخرین نسخه‌ی آن را نصب کنید:"
msgid ""
"(tutorial-env) $ python -m pip install novas\n"
"Collecting novas\n"
" Downloading novas-3.1.1.3.tar.gz (136kB)\n"
"Installing collected packages: novas\n"
" Running setup.py install for novas\n"
"Successfully installed novas-3.1.1.3"
msgstr ""
"(tutorial-env) $ python -m pip install novas\n"
"Collecting novas\n"
" Downloading novas-3.1.1.3.tar.gz (136kB)\n"
"Installing collected packages: novas\n"
" Running setup.py install for novas\n"
"Successfully installed novas-3.1.1.3"
msgid "You can also install a specific version of a package by giving the package name followed by ``==`` and the version number:"
msgstr "همچنین می‌توانید با نوشتن نام بسته، سپس ``==`` و شماره‌ی نسخه، نسخه‌ی مشخصی از آن را نصب کنید:"
msgid ""
"(tutorial-env) $ python -m pip install requests==2.6.0\n"
"Collecting requests==2.6.0\n"
" Using cached requests-2.6.0-py2.py3-none-any.whl\n"
"Installing collected packages: requests\n"
"Successfully installed requests-2.6.0"
msgstr ""
"(tutorial-env) $ python -m pip install requests==2.6.0\n"
"Collecting requests==2.6.0\n"
" Using cached requests-2.6.0-py2.py3-none-any.whl\n"
"Installing collected packages: requests\n"
"Successfully installed requests-2.6.0"
msgid "If you re-run this command, ``pip`` will notice that the requested version is already installed and do nothing. You can supply a different version number to get that version, or you can run ``python -m pip install --upgrade`` to upgrade the package to the latest version:"
msgstr "اگر این دستور را دوباره اجرا کنید، ``pip`` تشخیص می‌دهد که نسخه‌ی درخواستی از قبل نصب شده است و هیچ کاری انجام نمی‌دهد. می‌توانید شماره‌ی نسخه‌ی دیگری را مشخص کنید تا همان نسخه نصب شود، یا با اجرای ``python -m pip install --upgrade`` بسته را به آخرین نسخه ارتقا دهید:"
msgid ""
"(tutorial-env) $ python -m pip install --upgrade requests\n"
"Collecting requests\n"
"Installing collected packages: requests\n"
" Found existing installation: requests 2.6.0\n"
" Uninstalling requests-2.6.0:\n"
" Successfully uninstalled requests-2.6.0\n"
"Successfully installed requests-2.7.0"
msgstr ""
"(tutorial-env) $ python -m pip install --upgrade requests\n"
"Collecting requests\n"
"Installing collected packages: requests\n"
" Found existing installation: requests 2.6.0\n"
" Uninstalling requests-2.6.0:\n"
" Successfully uninstalled requests-2.6.0\n"
"Successfully installed requests-2.7.0"
msgid "``python -m pip uninstall`` followed by one or more package names will remove the packages from the virtual environment."
msgstr "دستور ``python -m pip uninstall`` که پس از آن یک یا چند نام بسته آورده می‌شود، آن بسته‌ها را از محیط مجازی حذف می‌کند."
msgid "``python -m pip show`` will display information about a particular package:"
msgstr "دستور ``python -m pip show`` اطلاعات مربوط به یک بسته‌ی مشخص را نمایش می‌دهد:"
msgid ""
"(tutorial-env) $ python -m pip show requests\n"
"---\n"
"Metadata-Version: 2.0\n"
"Name: requests\n"
"Version: 2.7.0\n"
"Summary: Python HTTP for Humans.\n"
"Home-page: http://python-requests.org\n"
"Author: Kenneth Reitz\n"
"Author-email: me@kennethreitz.com\n"
"License: Apache 2.0\n"
"Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages\n"
"Requires:"
msgstr ""
"(tutorial-env) $ python -m pip show requests\n"
"---\n"
"Metadata-Version: 2.0\n"
"Name: requests\n"
"Version: 2.7.0\n"
"Summary: Python HTTP for Humans.\n"
"Home-page: http://python-requests.org\n"
"Author: Kenneth Reitz\n"
"Author-email: me@kennethreitz.com\n"
"License: Apache 2.0\n"
"Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages\n"
"Requires:"
msgid "``python -m pip list`` will display all of the packages installed in the virtual environment:"
msgstr "دستور ``python -m pip list`` فهرست تمام بسته‌های نصب‌شده در محیط مجازی را نمایش می‌دهد:"
msgid ""
"(tutorial-env) $ python -m pip list\n"
"novas (3.1.1.3)\n"
"numpy (1.9.2)\n"
"pip (7.0.3)\n"
"requests (2.7.0)\n"
"setuptools (16.0)"
msgstr ""
"(tutorial-env) $ python -m pip list\n"
"novas (3.1.1.3)\n"
"numpy (1.9.2)\n"
"pip (7.0.3)\n"
"requests (2.7.0)\n"
"setuptools (16.0)"
msgid "``python -m pip freeze`` will produce a similar list of the installed packages, but the output uses the format that ``python -m pip install`` expects. A common convention is to put this list in a ``requirements.txt`` file:"
msgstr "دستور ``python -m pip freeze`` نیز فهرستی مشابه از بسته‌های نصب‌شده تولید می‌کند، اما خروجی آن در قالبی است که دستور ``python -m pip install`` انتظار دارد. معمولاً این فهرست را در پرونده‌ای با نام ``requirements.txt`` ذخیره می‌کنند:"
msgid ""
"(tutorial-env) $ python -m pip freeze > requirements.txt\n"
"(tutorial-env) $ cat requirements.txt\n"
"novas==3.1.1.3\n"
"numpy==1.9.2\n"
"requests==2.7.0"
msgstr ""
"(tutorial-env) $ python -m pip freeze > requirements.txt\n"
"(tutorial-env) $ cat requirements.txt\n"
"novas==3.1.1.3\n"
"numpy==1.9.2\n"
"requests==2.7.0"
msgid "The ``requirements.txt`` can then be committed to version control and shipped as part of an application. Users can then install all the necessary packages with ``install -r``:"
msgstr "سپس می‌توان پرونده ``requirements.txt`` را در سامانه‌ی کنترل نسخه ثبت (commit) کرد و همراه با برنامه منتشر نمود. در این صورت، کاربران می‌توانند با استفاده از ``install -r`` تمام بسته‌های موردنیاز را نصب کنند:"
msgid ""
"(tutorial-env) $ python -m pip install -r requirements.txt\n"
"Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))\n"
" ...\n"
"Collecting numpy==1.9.2 (from -r requirements.txt (line 2))\n"
" ...\n"
"Collecting requests==2.7.0 (from -r requirements.txt (line 3))\n"
" ...\n"
"Installing collected packages: novas, numpy, requests\n"
" Running setup.py install for novas\n"
"Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0"
msgstr ""
"(tutorial-env) $ python -m pip install -r requirements.txt\n"
"Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))\n"
" ...\n"
"Collecting numpy==1.9.2 (from -r requirements.txt (line 2))\n"
" ...\n"
"Collecting requests==2.7.0 (from -r requirements.txt (line 3))\n"
" ...\n"
"Installing collected packages: novas, numpy, requests\n"
" Running setup.py install for novas\n"
"Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0"
msgid "``pip`` has many more options. Consult the :ref:`installing-index` guide for complete documentation for ``pip``. When you've written a package and want to make it available on the Python Package Index, consult the `Python packaging user guide`_."
msgstr "``pip`` گزینه‌های بسیار بیشتری نیز دارد. برای مطالعه‌ی مستندات کامل ``pip``، به راهنمای :ref:`installing-index` مراجعه کنید. همچنین، اگر بسته‌ای نوشته‌اید و می‌خواهید آن را در Python Package Index منتشر کنید، به `Python packaging user guide`_ مراجعه کنید."