| PIP-DOWNLOAD(1) | pip | PIP-DOWNLOAD(1) |
نام (NAME)
pip-download - بارگیری بسته‌ها
توضیحات (DESCRIPTION)
بارگیری بسته‌ها از:
- مخزن PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی.
- نشانی‌های اینترنتی پروژه‌های VCS.
- دایرکتوری‌های محلی پروژه.
- آرشیوهای منبع محلی یا دوردست.
همچنین pip از بارگیری با استفاده از "فایل‌های نیازمندی‌ها" پشتیبانی می‌کند، که روشی آسان برای تعیین کل یک محیط جهت بارگیری فراهم می‌آورند.
نحوه استفاده (USAGE)
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> ...
گزینه‌ها (OPTIONS)
- -c, --constraint <file>
- محدود کردن
نسخه‌ها با
استفاده از
فایل
محدودیت‌های
داده‌شده.
از این
گزینه
می‌توان
چندین بار
استفاده
کرد.
(متغیر محیطی: PIP_CONSTRAINT)
- --build-constraint <file>
- محدود کردن
وابستگی‌های
ساخت با
استفاده از
فایل
محدودیت‌های
داده‌شده.
از این
گزینه
می‌توان
چندین بار
استفاده
کرد.
(متغیر محیطی: PIP_BUILD_CONSTRAINT)
- -r, --requirement <file>
- نصب از فایل
نیازمندی‌های
داده‌شده.
این فایل یا
URL می‌تواند
در قالب requirements.txt
مربوط به pip
یا در قالب
pylock.toml باشد.
پشتیبانی
از pylock.toml
آزمایشی
است. از این
گزینه
می‌توان
چندین بار
استفاده
کرد.
(متغیر محیطی: PIP_REQUIREMENT)
- --requirements-from-script <file>
- نصب
وابستگی‌های
فایل
اسکریپت
داده‌شده،
طبق آنچه
توسط
متاداده‌های
درون‌خطی PEP 723
تعریف شده
است.
(متغیر محیطی: PIP_REQUIREMENTS_FROM_SCRIPT)
- --no-deps
- عدم نصب
وابستگی‌های
بسته.
(متغیر محیطی: PIP_NO_DEPS, PIP_NO_DEPENDENCIES)
- --only-deps
- فقط
وابستگی‌های
نیازمندی‌های
ارائه‌شده
در نظر
گرفته
شوند، نه
خود
نیازمندی‌ها.
نمی‌توان
آن را در
ترکیب با
--no-deps، --group، --requirement، یا
--requirements-from-script
استفاده
کرد. هیچ‌یک
از
نیازمندی‌های
ارائه‌شده
توسط کاربر
پردازش
نخواهند
شد، حتی اگر
آن‌ها
وابستگی‌های
سایر
نیازمندی‌های
ارائه‌شده
توسط کاربر
باشند.
(متغیر محیطی: PIP_ONLY_DEPS, PIP_ONLY_DEPENDENCIES)
- --src <dir>
- دایرکتوری
مقصد برای
دریافت (checkout)
پروژه‌های
قابل
ویرایش.
مقدار
پیش‌فرض در
virtualenv برابر با
"<venv path>/src" است.
مقدار
پیش‌فرض
برای
نصب‌های
سراسری
برابر با
"<current dir>/src" است.
(متغیر محیطی: PIP_SRC, PIP_SOURCE, PIP_SOURCE_DIR, PIP_SOURCE_DIRECTORY)
- --require-hashes
- الزام به
وجود هش
برای بررسی
هر
نیازمندی
در برابر
آن، جهت
نصب‌های
تکرارپذیر.
این گزینه
زمانی که هر
بسته‌ای در
یک فایل
نیازمندی‌ها
دارای
گزینه --hash
باشد، به
صورت ضمنی
اعمال
می‌شود.
(متغیر محیطی: PIP_REQUIRE_HASHES)
- --no-require-hashes
- هنگام
مواجهه با
نیازمندی
دارای هش،
گزینه --require-hashes به
صورت
خودکار
فعال نشود.
(متغیر محیطی: PIP_NO_REQUIRE_HASHES)
- --progress-bar <progress_bar>
- مشخص کردن
اینکه آیا
نوار
پیشرفت
باید
استفاده
شود یا خیر.
در حالت 'auto'،
گزینه --quiet
تمام
نوارهای
پیشرفت را
پنهان
می‌کند. [auto, on, off, raw]
(پیش‌فرض: auto)
(متغیر محیطی: PIP_PROGRESS_BAR)
- --no-build-isolation
- غیرفعال‌سازی
ایزوله‌سازی
هنگام ساخت
یک توزیع
منبع مدرن.
در صورت
استفاده از
این گزینه،
وابستگی‌های
ساخت
مشخص‌شده
توسط PEP 518 باید
از قبل نصب
شده باشند.
(متغیر محیطی: PIP_NO_BUILD_ISOLATION)
- --check-build-dependencies
- بررسی
وابستگی‌های
ساخت.
(متغیر محیطی: PIP_CHECK_BUILD_DEPENDENCIES)
- --ignore-requires-python
- نادیده
گرفتن
اطلاعات Requires-Python.
(متغیر محیطی: PIP_IGNORE_REQUIRES_PYTHON)
- -d, --dest <dir>
- بارگیری
بسته‌ها
درون <dir>.
(متغیر محیطی: PIP_DEST, PIP_DESTINATION_DIR, PIP_DESTINATION_DIRECTORY)
- --platform <platform>
- فقط از
بسته‌های wheel
سازگار با
<platform> استفاده
شود. مقدار
پیش‌فرض،
پلتفرم
سیستم در
حال اجرا
است. از این
گزینه
چندین بار
برای مشخص
کردن چندین
پلتفرم
پشتیبانی‌شده
توسط مفسر
مقصد
استفاده
کنید.
(متغیر محیطی: PIP_PLATFORM)
- --python-version <python_version>
- نسخه مفسر
پایتون
برای بررسی
سازگاری wheel و
"Requires-Python".
پیش‌فرض،
نسخه‌ای
است که از
مفسر در حال
اجرا به دست
می‌آید.
نسخه را
می‌توان با
حداکثر سه
عدد صحیح
جداشده با
نقطه مشخص
کرد (مانند
"3" برای 3.0.0،
"3.7" برای 3.7.0،
یا "3.7.3").
همچنین
می‌توان
نسخه
اصلی-فرعی
را به صورت
یک رشته
بدون نقطه
مشخص کرد
(مانند "37"
برای 3.7.0).
(متغیر محیطی: PIP_PYTHON_VERSION)
- --implementation <implementation>
- فقط از
بسته‌های wheel
سازگار با
پیاده‌سازی
پایتون <implementation>
استفاده
شود، مانند
'pp'، 'jy'، 'cp' یا 'ip'.
اگر مشخص
نشود،
پیاده‌سازی
مفسر فعلی
استفاده
خواهد شد.
از 'py' برای
اجبار به
استفاده از
بسته‌های wheel
مستقل از
پیاده‌سازی
استفاده
کنید.
(متغیر محیطی: PIP_IMPLEMENTATION)
- --abi <abi>
- فقط از
بسته‌های wheel
سازگار با ABI
پایتون <abi>
استفاده
شود، مانند
'pypy_41'. اگر مشخص
نشود،
برچسب ABI
مفسر فعلی
استفاده
می‌شود. از
این گزینه
چندین بار
برای مشخص
کردن چندین
ABI
پشتیبانی‌شده
توسط مفسر
مقصد
استفاده
کنید.
معمولاً
هنگام
استفاده از
این گزینه
نیاز به
تعیین --implementation،
--platform، و --python-version
خواهید
داشت.
(متغیر محیطی: PIP_ABI)
- --group <[path:]group>
- نصب یک گروه
وابستگی
(dependency-group)
نام‌گذاری‌شده
از یک فایل
"pyproject.toml". در
صورت ارائه
مسیر، نام
فایل باید
"pyproject.toml" باشد.
حالت
پیش‌فرض،
استفاده از
"pyproject.toml" در
دایرکتوری
فعلی است.
(متغیر محیطی: PIP_GROUP)
- --no-clean
- عدم
پاک‌سازی
دایرکتوری‌های
ساخت.
(متغیر محیطی: PIP_NO_CLEAN)
نویسندگان (AUTHORS)
توسعه‌دهندگان pip
کپی‌رایت و تکثیر (COPYRIGHT)
The pip developers
| August 5, 2026 | 26.2 |