| PIP-LOCK(1) | pip | PIP-LOCK(1) |
نام (NAME)
pip-lock - قفل‌کردن بسته‌ها و وابستگی‌های آن‌ها در pip
توضیحات (DESCRIPTION)
آزمایشی - قفل‌کردن بسته‌ها و وابستگی‌های آن‌ها از:
- PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی.
- نشانی‌های URL پروژه در VCS.
- دایرکتوری‌های محلی پروژه.
- آرشیوهای منبع محلی یا دوردست.
همچنین pip از قفل‌کردن از طریق "فایل‌های نیازمندی‌ها" پشتیبانی می‌کند که روشی آسان را برای تعیین کل یک محیط جهت نصب فراهم می‌سازند.
تضمین می‌شود که فایل قفلِ تولیدشده فقط برای نسخه جاری python و پلتفرم فعلی معتبر است.
نحوه استفاده (USAGE)
python -m pip lock [options] [-e] <local project path> ... python -m pip lock [options] <requirement specifier> [package-index-options] ... python -m pip lock [options] -r <requirements file> [package-index-options] ... python -m pip lock [options] <archive url/path> ...
گزینه‌ها (OPTIONS)
- -o, --output <path>
- نام فایل
قفل
(پیش‌فرض: pylock.toml).
برای stdout از -
استفاده
کنید.
(متغیر محیطی: PIP_OUTPUT)
- -r, --requirement <file>
- نصب از روی
فایل
نیازمندی‌های
داده‌شده.
این فایل یا
URL می‌تواند
در قالب requirements.txt
مربوط به pip
یا در قالب
pylock.toml باشد.
پشتیبانی
از pylock.toml
آزمایشی
است. این
گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_REQUIREMENT)
- --requirements-from-script <file>
- نصب
وابستگی‌های
فایل
اسکریپت
داده‌شده،
طبق
متادیتای
درون‌برنامه‌ای
تعریف‌شده
در PEP 723.
(متغیر محیطی: PIP_REQUIREMENTS_FROM_SCRIPT)
- -c, --constraint <file>
- محدود کردن
نسخه‌ها با
استفاده از
فایل
محدودیت‌های
داده‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_CONSTRAINT)
- --build-constraint <file>
- محدود کردن
وابستگی‌های
ساخت با
استفاده از
فایل
محدودیت‌های
داده‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_BUILD_CONSTRAINT)
- --no-deps
- وابستگی‌های
بسته نصب
نشوند.
(متغیر محیطی: PIP_NO_DEPS, PIP_NO_DEPENDENCIES)
- --only-deps
- فقط
وابستگی‌های
نیازمندی‌های
ارائه‌شده
در نظر
گرفته
شوند، نه
خود
نیازمندی‌ها.
این گزینه
در ترکیب با
--no-deps، --group، --requirement یا
--requirements-from-script قابل
استفاده
نیست.
هیچ‌یک از
نیازمندی‌های
ارائه‌شده
توسط کاربر
پردازش
نخواهند
شد، حتی اگر
آن‌ها
وابستگیِ
سایر
نیازمندی‌های
ارائه‌شده
توسط کاربر
باشند.
(متغیر محیطی: PIP_ONLY_DEPS, PIP_ONLY_DEPENDENCIES)
- -e, --editable <path/url>
- نصب یک
پروژه در
حالت قابل
ویرایش
(مانند "develop mode"
در setuptools) از
مسیر محلی
پروژه یا یک
URL در VCS.
(متغیر محیطی: PIP_EDITABLE)
- --src <dir>
- دایرکتوری
برای واکشی
پروژه‌های
قابل
ویرایش به
درون آن.
مقدار
پیش‌فرض در
virtualenv برابر با
"<venv path>/src" است.
مقدار
پیش‌فرض
برای
نصب‌های
سراسری "<current
dir>/src" است.
(متغیر محیطی: PIP_SRC, PIP_SOURCE, PIP_SOURCE_DIR, PIP_SOURCE_DIRECTORY)
- --ignore-requires-python
- اطلاعات Requires-Python
نادیده
گرفته شود.
(متغیر محیطی: PIP_IGNORE_REQUIRES_PYTHON)
- --no-build-isolation
- غیرفعال‌سازی
ایزوله‌سازی
هنگام ساخت
یک توزیع
سورس‌کد
مدرن. در
صورت
استفاده از
این گزینه،
وابستگی‌های
ساخت
مشخص‌شده
توسط PEP 518 باید
از پیش نصب
شده باشند.
(متغیر محیطی: PIP_NO_BUILD_ISOLATION)
- --check-build-dependencies
- بررسی
وابستگی‌های
ساخت.
(متغیر محیطی: PIP_CHECK_BUILD_DEPENDENCIES)
- -C, --config-settings <settings>
- تنظیمات
پیکربندی
جهت ارسال
به بک‌اند
ساخت.
تنظیمات به
صورت KEY=VALUE
هستند. برای
ارسال
چندین کلید
به بک‌اند،
چندین بار
از گزینه
--config-settings استفاده
کنید.
(متغیر محیطی: PIP_CONFIG_SETTINGS)
- --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)
- --group <[path:]group>
- نصب یک گروه
وابستگی
(dependency-group)
نام‌گذاری‌شده
از یک فایل
"pyproject.toml". اگر
مسیری مشخص
شده باشد،
نام فایل
حتماً باید
"pyproject.toml" باشد.
حالت
پیش‌فرض
استفاده از
"pyproject.toml" در
دایرکتوری
جاری است.
(متغیر محیطی: PIP_GROUP)
- --no-clean
- دایرکتوری‌های
ساخت
پاک‌سازی
نشوند.
(متغیر محیطی: PIP_NO_CLEAN)
نویسندگان (AUTHORS)
توسعه‌دهندگان pip
کپی‌رایت و تکثیر (COPYRIGHT)
توسعه‌دهندگان pip
| August 5, 2026 | 26.2 |