.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
glab-packages-download \- دانلود یک فایل از رجیستری بسته‌های یک پروژه.


.SH "خلاصه دستور (SYNOPSIS)"
\fBglab packages download --name  --version  --filename  [flags]\fP


.SH "توضیحات (DESCRIPTION)"
دانلود یک فایل بستهٔ عمومی (generic package)، که با نام بسته، نسخه و نام فایل مشخص می‌شود.

.PP
از \fB--path\fR برای انتخاب محل ذخیرهٔ فایل استفاده کنید. اگر یک دایرکتوری را مشخص کند (به یک جداکننده ختم شود یا از قبل وجود داشته باشد)، فایل با نام اصلی خود در آنجا ذخیره می‌شود. در غیر این صورت در همان مسیر دقیق ذخیره شده و به شما امکان تغییر نام فایل را می‌دهد. به‌طور پیش‌فرض، فایل در دایرکتوری جاری با نام اصلی خود ذخیره می‌شود.

.PP
به‌طور پیش‌فرض، فایل دانلودشده در برابر چکسام ذخیره‌شده در رجیستری اعتبارسنجی می‌شود. این امر نیازمند فراخوانی‌های اضافی API برای جستجوی فراداده‌های فایل است. از \fB--no-verify\fR برای صرف‌نظر از اعتبارسنجی استفاده کنید. این کار می‌تواند امکان دانلود فایل‌های خراب یا دستکاری‌شده را فراهم کند؛ با احتیاط استفاده کنید.

.PP
اگر فایل مقصد از قبل وجود داشته باشد، عملیات دانلود ناموفق خواهد بود. برای بازنویسی آن از \fB--force\fR استفاده کنید.

.PP
به‌طور پیش‌فرض، فایل‌ها از پروژهٔ فعلی دانلود می‌شوند. برای هدف قرار دادن پروژه‌ای دیگر از \fB--repo\fR استفاده کنید.


.SH "گزینه‌ها (OPTIONS)"
\fB--filename\fP=""
	نام فایل درون بسته برای دانلود.

.PP
\fB--force\fP[=false]
	بازنویسی فایل مقصد در صورت وجود.

.PP
\fB-n\fP, \fB--name\fP=""
	نام بسته.

.PP
\fB--no-verify\fP[=false]
	عدم اعتبارسنجی چکسام فایل دانلودشده. هشدار: با فعال بودن این گزینه، امکان دانلود فایل‌های خراب یا دستکاری‌شده وجود دارد.

.PP
\fB-p\fP, \fB--path\fP=""
	دایرکتوری برای ذخیره فایل (نام اصلی حفظ می‌شود) یا یک مسیر کامل فایل برای تغییر نام آن. پیش‌فرض، نام اصلی در دایرکتوری جاری است.

.PP
\fB--version\fP=""
	نسخه بسته.


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB-h\fP, \fB--help\fP[=false]
	نمایش راهنما برای این دستور.

.PP
\fB-R\fP, \fB--repo\fP=""
	انتخاب مخزنی دیگر. می‌توانید از OWNER/REPO یا GROUP/NAMESPACE/REPO استفاده کنید. نشانی وب (URL) کامل یا نشانی Git نیز پذیرفته می‌شود.


.SH "مثال (EXAMPLE)"
.EX
# دانلود یک فایل بسته به دایرکتوری جاری
glab packages download --name my-package --version 1.0.0 --filename app.zip

# دانلود درون یک دایرکتوری با حفظ نام اصلی فایل
glab packages download -n my-package --version 1.0.0 --filename app.zip --path ./downloads/

# دانلود در یک مسیر دقیق و تغییر نام فایل
glab packages download -n my-package --version 1.0.0 --filename app.zip --path ./downloads/renamed.zip

# دانلود در یک مسیر مطلق
glab packages download -n my-package --version 1.0.0 --filename app.zip --path /tmp/downloads/app.zip

# دانلود بدون اعتبارسنجی چکسام
glab packages download -n my-package --version 1.0.0 --filename app.zip --no-verify

# بازنویسی یک فایل موجود
glab packages download -n my-package --version 1.0.0 --filename app.zip --force

# استفاده از نام مستعار 'dl' و هدف قرار دادن پروژه‌ای دیگر
glab packages dl -n my-package --version 1.0.0 --filename app.zip -R owner/repo

.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBglab-packages(1)\fP