.\" 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-LOCK" "1" "Aug 05, 2026" "26.2" "pip"
.SH "نام (NAME)"
pip-lock \- قفل‌کردن بسته‌ها و وابستگی‌های آن‌ها در pip
.SH "توضیحات (DESCRIPTION)"
.sp
آزمایشی \- قفل‌کردن بسته‌ها و وابستگی‌های آن‌ها از:
.INDENT 0.0
.IP \(bu 2
PyPI (و سایر نمایه‌ها) با استفاده از مشخص‌کننده‌های نیازمندی.
.IP \(bu 2
نشانی‌های URL پروژه در VCS.
.IP \(bu 2
دایرکتوری‌های محلی پروژه.
.IP \(bu 2
آرشیوهای منبع محلی یا دوردست.
.UNINDENT
.sp
همچنین pip از قفل‌کردن از طریق \(dqفایل‌های نیازمندی‌ها\(dq پشتیبانی می‌کند که روشی آسان را برای تعیین کل یک محیط جهت نصب فراهم می‌سازند.
.sp
تضمین می‌شود که فایل قفلِ تولیدشده فقط برای نسخه جاری python و پلتفرم فعلی معتبر است.

.SH "نحوه استفاده (USAGE)"
.INDENT 0.0
.INDENT 3.5
.sp
.EX
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> ...
.EE
.UNINDENT
.UNINDENT
.SH "گزینه‌ها (OPTIONS)"
.sp
.INDENT 0.0
.TP
.B \-o, \-\-output <path>
نام فایل قفل (پیش‌فرض: pylock.toml). برای stdout از \- استفاده کنید.
.sp
(متغیر محیطی: \fBPIP_OUTPUT\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 \-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 \-\-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 \-e, \-\-editable <path/url>
نصب یک پروژه در حالت قابل ویرایش (مانند \(dqdevelop mode\(dq در setuptools) از مسیر محلی پروژه یا یک URL در VCS.
.sp
(متغیر محیطی: \fBPIP_EDITABLE\fP)
.UNINDENT
.INDENT 0.0
.TP
.B \-\-src <dir>
دایرکتوری برای واکشی پروژه‌های قابل ویرایش به درون آن. مقدار پیش‌فرض در 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 \-\-ignore\-requires\-python
اطلاعات Requires\-Python نادیده گرفته شود.
.sp
(متغیر محیطی: \fBPIP_IGNORE_REQUIRES_PYTHON\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 \-C, \-\-config\-settings <settings>
تنظیمات پیکربندی جهت ارسال به بک‌اند ساخت. تنظیمات به صورت KEY=VALUE هستند. برای ارسال چندین کلید به بک‌اند، چندین بار از گزینه \-\-config\-settings استفاده کنید.
.sp
(متغیر محیطی: \fBPIP_CONFIG_SETTINGS\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 \-\-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)"
توسعه‌دهندگان pip
.\" End of generated man page.