| PIP-WHEEL(1) | pip | PIP-WHEEL(1) |
نام (NAME)
pip-wheel - ساخت بسته‌های ویل (Wheel) برای پیش‌نیازها و وابستگی‌ها
توضیحات (DESCRIPTION)
ساخت آرشیوهای ویل (Wheel) برای پیش‌نیازها و وابستگی‌های شما.
ویل (Wheel) یک قالب بستهٔ ساخته‌شده (built-package) است و این مزیت را دارد که نرم‌افزار شما در هر بار نصب مجدداً کامپایل نشود. برای جزئیات بیشتر، مستندات ویل را ببینید: https://wheel.readthedocs.io/en/latest
دستور 'pip wheel' از رابط سیستم ساخت همان‌طور که در این‌جا شرح داده شده است استفاده می‌کند: https://pip.pypa.io/en/stable/reference/build-system
نحوه استفاده (USAGE)
python -m pip wheel [options] <requirement specifier> ... python -m pip wheel [options] -r <requirements file> ... python -m pip wheel [options] [-e] <vcs project url> ... python -m pip wheel [options] [-e] <local project path> ... python -m pip wheel [options] <archive url/path> ...
گزینه‌ها (OPTIONS)
- -w, --wheel-dir <dir>
- ساخت
بسته‌های
ویل درون
<dir>؛ مقدار
پیش‌فرض،
دایرکتوری
کاری جاری
است.
(متغیر محیطی: PIP_WHEEL_DIR)
- --no-build-isolation
- غیرفعال
کردن
جداسازی
هنگام ساخت
توزیع مبدأ
مدرن. در
صورت
استفاده از
این گزینه،
وابستگی‌های
ساختی که
توسط PEP 518 مشخص
شده‌اند
باید از قبل
نصب شده
باشند.
(متغیر محیطی: PIP_NO_BUILD_ISOLATION)
- --check-build-dependencies
- بررسی
وابستگی‌های
ساخت.
(متغیر محیطی: PIP_CHECK_BUILD_DEPENDENCIES)
- -c, --constraint <file>
- محدود کردن
نسخه‌ها با
استفاده از
فایل
قیدهای
مشخص‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_CONSTRAINT)
- --build-constraint <file>
- محدود کردن
وابستگی‌های
ساخت با
استفاده از
فایل
قیدهای
مشخص‌شده.
این گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_BUILD_CONSTRAINT)
- -e, --editable <path/url>
- نصب یک
پروژه در
حالت قابل
ویرایش
(مانند
"حالت
توسعه" یا develop
mode در setuptools) از یک
مسیر محلی
پروژه یا یک
نشانی
اینترنتی VCS.
(متغیر محیطی: PIP_EDITABLE)
- -r, --requirement <file>
- نصب از فایل
نیازمندی‌های
مشخص‌شده.
فایل یا
نشانی
اینترنتی
می‌تواند
در قالب requirements.txt
مربوط به pip
یا در قالب
pylock.toml باشد.
پشتیبانی
از pylock.toml
آزمایشی
است. این
گزینه
می‌تواند
چندین بار
استفاده
شود.
(متغیر محیطی: PIP_REQUIREMENT)
- --requirements-from-script <file>
- نصب
وابستگی‌های
فایل
اسکریپت
مشخص‌شده
همان‌طور
که توسط
متادیتای
درون‌خطی PEP 723
تعریف شده
است.
(متغیر محیطی: PIP_REQUIREMENTS_FROM_SCRIPT)
- --src <dir>
- دایرکتوری
برای
دریافت (check out)
پروژه‌های
قابل
ویرایش
درون آن.
مقدار
پیش‌فرض در
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-deps
- وابستگی‌های
بسته نصب
نشوند.
(متغیر محیطی: PIP_NO_DEPS, PIP_NO_DEPENDENCIES)
- --only-deps
- فقط
وابستگی‌های
پیش‌نیازهای
ارائه‌شده
در نظر
گرفته
شوند، نه
خود
پیش‌نیازها.
نمی‌توان
همراه با
گزینه‌های
--no-deps، --group، --requirement یا
--requirements-from-script
استفاده
شود. هیچ
پیش‌نیاز
ارائه‌شده
توسط کاربر
پردازش
نخواهد شد،
حتی اگر
وابستگی
پیش‌نیازهای
دیگر
ارائه‌شده
توسط کاربر
باشند.
(متغیر محیطی: PIP_ONLY_DEPS, PIP_ONLY_DEPENDENCIES)
- --progress-bar <progress_bar>
- مشخص کردن
این‌که آیا
نوار
پیشرفت
استفاده
شود یا خیر.
در حالت 'auto'،
گزینهٔ --quiet
تمام
نوارهای
پیشرفت را
پنهان
می‌کند.
گزینه‌ها: [auto,
on, off, raw] (پیش‌فرض:
auto).
(متغیر محیطی: PIP_PROGRESS_BAR)
- --no-verify
- معتبر بودن
بستهٔ ویل
ساخته‌شده
اعتبارسنجی
نشود.
(متغیر محیطی: PIP_NO_VERIFY)
- -C, --config-settings <settings>
- تنظیمات
پیکربندی
که باید به
بک‌اند
ساخت (build backend)
ارسال شوند.
تنظیمات به
صورت KEY=VALUE
هستند. برای
ارسال
چندین کلید
به بک‌اند،
چندین بار
از گزینهٔ
--config-settings استفاده
کنید.
(متغیر محیطی: PIP_CONFIG_SETTINGS)
- --require-hashes
- الزام وجود
هش برای
بررسی هر
پیش‌نیاز،
به منظور
نصب‌های
تکرارپذیر.
این گزینه
زمانی که هر
بسته‌ای در
فایل
پیش‌نیازها
گزینهٔ --hash
داشته
باشد، به
طور ضمنی
فعال
می‌شود.
(متغیر محیطی: PIP_REQUIRE_HASHES)
- --no-require-hashes
- هنگام
مواجهه با
پیش‌نیازی
دارای هش،
گزینهٔ --require-hashes
به صورت
خودکار
فعال نشود.
(متغیر محیطی: PIP_NO_REQUIRE_HASHES)
- --group <[path:]group>
- نصب یک گروه
وابستگی
مشخص از
فایل "pyproject.toml".
در صورت
ارائهٔ
مسیر، نام
فایل باید
"pyproject.toml" باشد.
حالت
پیش‌فرض
استفاده از
"pyproject.toml" در
دایرکتوری
جاری است.
(متغیر محیطی: PIP_GROUP)
- --no-clean
- دایرکتوری‌های
ساخت
پاک‌سازی
نشوند.
(متغیر محیطی: PIP_NO_CLEAN)
نویسنده (AUTHOR)
توسعه‌دهندگان pip
حق نشر (COPYRIGHT)
توسعه‌دهندگان pip
| August 5, 2026 | 26.2 |