.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "PIP-DOWNLOAD" "1" "Aug 05, 2026" "26.2" "pip"
.SH "نام (NAME)"
pip-download \- بارگیری بسته‌ها
.SH "توضیحات (DESCRIPTION)"
.sp
بارگیری بسته‌ها از:
.INDENT 0.0
.IP \(bu 2
مخزن PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی.
.IP \(bu 2
نشانی‌های اینترنتی پروژه‌های VCS.
.IP \(bu 2
دایرکتوری‌های محلی پروژه.
.IP \(bu 2
آرشیوهای منبع محلی یا دوردست.
.UNINDENT
.sp
همچنین pip از بارگیری با استفاده از \(dqفایل‌های نیازمندی‌ها\(dq پشتیبانی می‌کند، که روشی آسان برای تعیین کل یک محیط جهت بارگیری فراهم می‌آورند.

.SH "نحوه استفاده (USAGE)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
python \-m pip download [options] <requirement specifier> [package\-index\-options] ...
python \-m pip download [options] \-r <requirements file> [package\-index\-options] ...
python \-m pip download [options] <vcs project url> ...
python \-m pip download [options] <local project path> ...
python \-m pip download [options] <archive url/path> ...
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
.INDENT 0.0
.TP
.B \-c, \-\-constraint <file>
محدود کردن نسخه‌ها با استفاده از فایل محدودیت‌های داده‌شده. از این گزینه می‌توان چندین بار استفاده کرد.
.sp
(متغیر محیطی: \fBPIP_CONSTRAINT\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-build\-constraint <file>
محدود کردن وابستگی‌های ساخت با استفاده از فایل محدودیت‌های داده‌شده. از این گزینه می‌توان چندین بار استفاده کرد.
.sp
(متغیر محیطی: \fBPIP_BUILD_CONSTRAINT\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-r, \-\-requirement <file>
نصب از فایل نیازمندی‌های داده‌شده. این فایل یا URL می‌تواند در قالب requirements.txt مربوط به pip یا در قالب pylock.toml باشد. پشتیبانی از pylock.toml آزمایشی است. از این گزینه می‌توان چندین بار استفاده کرد.
.sp
(متغیر محیطی: \fBPIP_REQUIREMENT\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-requirements\-from\-script <file>
نصب وابستگی‌های فایل اسکریپت داده‌شده، طبق آنچه توسط متاداده‌های درون‌خطی PEP 723 تعریف شده است.
.sp
(متغیر محیطی: \fBPIP_REQUIREMENTS_FROM_SCRIPT\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-deps
عدم نصب وابستگی‌های بسته.
.sp
(متغیر محیطی: \fBPIP_NO_DEPS\fP, \fBPIP_NO_DEPENDENCIES\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-only\-deps
فقط وابستگی‌های نیازمندی‌های ارائه‌شده در نظر گرفته شوند، نه خود نیازمندی‌ها. نمی‌توان آن را در ترکیب با \-\-no\-deps، \-\-group، \-\-requirement، یا \-\-requirements\-from\-script استفاده کرد. هیچ‌یک از نیازمندی‌های ارائه‌شده توسط کاربر پردازش نخواهند شد، حتی اگر آن‌ها وابستگی‌های سایر نیازمندی‌های ارائه‌شده توسط کاربر باشند.
.sp
(متغیر محیطی: \fBPIP_ONLY_DEPS\fP, \fBPIP_ONLY_DEPENDENCIES\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-src <dir>
دایرکتوری مقصد برای دریافت (checkout) پروژه‌های قابل ویرایش. مقدار پیش‌فرض در virtualenv برابر با \(dq<venv path>/src\(dq است. مقدار پیش‌فرض برای نصب‌های سراسری برابر با \(dq<current dir>/src\(dq است.
.sp
(متغیر محیطی: \fBPIP_SRC\fP, \fBPIP_SOURCE\fP, \fBPIP_SOURCE_DIR\fP, \fBPIP_SOURCE_DIRECTORY\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-require\-hashes
الزام به وجود هش برای بررسی هر نیازمندی در برابر آن، جهت نصب‌های تکرارپذیر. این گزینه زمانی که هر بسته‌ای در یک فایل نیازمندی‌ها دارای گزینه \-\-hash باشد، به صورت ضمنی اعمال می‌شود.
.sp
(متغیر محیطی: \fBPIP_REQUIRE_HASHES\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-require\-hashes
هنگام مواجهه با نیازمندی دارای هش، گزینه \-\-require\-hashes به صورت خودکار فعال نشود.
.sp
(متغیر محیطی: \fBPIP_NO_REQUIRE_HASHES\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-progress\-bar <progress_bar>
مشخص کردن اینکه آیا نوار پیشرفت باید استفاده شود یا خیر. در حالت \(aqauto\(aq، گزینه \-\-quiet تمام نوارهای پیشرفت را پنهان می‌کند. [auto, on, off, raw] (پیش‌فرض: auto)
.sp
(متغیر محیطی: \fBPIP_PROGRESS_BAR\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-build\-isolation
غیرفعال‌سازی ایزوله‌سازی هنگام ساخت یک توزیع منبع مدرن. در صورت استفاده از این گزینه، وابستگی‌های ساخت مشخص‌شده توسط PEP 518 باید از قبل نصب شده باشند.
.sp
(متغیر محیطی: \fBPIP_NO_BUILD_ISOLATION\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-check\-build\-dependencies
بررسی وابستگی‌های ساخت.
.sp
(متغیر محیطی: \fBPIP_CHECK_BUILD_DEPENDENCIES\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-ignore\-requires\-python
نادیده گرفتن اطلاعات Requires\-Python.
.sp
(متغیر محیطی: \fBPIP_IGNORE_REQUIRES_PYTHON\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-d, \-\-dest <dir>
بارگیری بسته‌ها درون <dir>.
.sp
(متغیر محیطی: \fBPIP_DEST\fP, \fBPIP_DESTINATION_DIR\fP, \fBPIP_DESTINATION_DIRECTORY\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-platform <platform>
فقط از بسته‌های wheel سازگار با <platform> استفاده شود. مقدار پیش‌فرض، پلتفرم سیستم در حال اجرا است. از این گزینه چندین بار برای مشخص کردن چندین پلتفرم پشتیبانی‌شده توسط مفسر مقصد استفاده کنید.
.sp
(متغیر محیطی: \fBPIP_PLATFORM\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-python\-version <python_version>
نسخه مفسر پایتون برای بررسی سازگاری wheel و \(dqRequires\-Python\(dq.
پیش‌فرض، نسخه‌ای است که از مفسر در حال اجرا به دست می‌آید. نسخه را می‌توان با حداکثر سه عدد صحیح جداشده با نقطه مشخص کرد (مانند \(dq3\(dq برای 3.0.0، \(dq3.7\(dq برای 3.7.0، یا \(dq3.7.3\(dq). همچنین می‌توان نسخه اصلی\-فرعی را به صورت یک رشته بدون نقطه مشخص کرد (مانند \(dq37\(dq برای 3.7.0).
.sp
(متغیر محیطی: \fBPIP_PYTHON_VERSION\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-implementation <implementation>
فقط از بسته‌های wheel سازگار با پیاده‌سازی پایتون <implementation> استفاده شود، مانند \(aqpp\(aq، \(aqjy\(aq، \(aqcp\(aq یا \(aqip\(aq. اگر مشخص نشود، پیاده‌سازی مفسر فعلی استفاده خواهد شد. از \(aqpy\(aq برای اجبار به استفاده از بسته‌های wheel مستقل از پیاده‌سازی استفاده کنید.
.sp
(متغیر محیطی: \fBPIP_IMPLEMENTATION\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-abi <abi>
فقط از بسته‌های wheel سازگار با ABI پایتون <abi> استفاده شود، مانند \(aqpypy_41\(aq. اگر مشخص نشود، برچسب ABI مفسر فعلی استفاده می‌شود. از این گزینه چندین بار برای مشخص کردن چندین ABI پشتیبانی‌شده توسط مفسر مقصد استفاده کنید. معمولاً هنگام استفاده از این گزینه نیاز به تعیین \-\-implementation، \-\-platform، و \-\-python\-version خواهید داشت.
.sp
(متغیر محیطی: \fBPIP_ABI\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-group <[path:]group>
نصب یک گروه وابستگی (dependency-group) نام‌گذاری‌شده از یک فایل \(dqpyproject.toml\(dq. در صورت ارائه مسیر، نام فایل باید \(dqpyproject.toml\(dq باشد. حالت پیش‌فرض، استفاده از \(dqpyproject.toml\(dq در دایرکتوری فعلی است.
.sp
(متغیر محیطی: \fBPIP_GROUP\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-no\-clean
عدم پاک‌سازی دایرکتوری‌های ساخت.
.sp
(متغیر محیطی: \fBPIP_NO_CLEAN\fP)
.UNINDENT

.SH "نویسندگان (AUTHORS)"
توسعه‌دهندگان pip
.SH "کپی‌رایت و تکثیر (COPYRIGHT)"
The pip developers
.\" End of generated man page.