.nh
.TH "GH-RELEASE-DOWNLOAD" "1" "Sep 2026" "" "GitHub CLI manual"

.SH "نام (NAME)"
gh-release-download \- دانلود فایل‌های یک انتشار

.SH "خلاصه دستور (SYNOPSIS)"
\fBgh release download [<tag>] [flags]\fR

.SH "توضیحات (DESCRIPTION)"
دانلود فایل‌ها و دارایی‌ها (assets) از یک انتشار گیت‌هاب (GitHub release)\&.

.PP
بدون آرگومان صریح نام برچسب (tag name)، فایل‌ها از آخرین انتشار پروژه دانلود می‌شوند\&. در این حالت، مشخص کردن
\fB--pattern\fR
یا
\fB--archive\fR
الزامی است\&.

.SH "گزینه‌ها (OPTIONS)"
.TP
\fB--allow-escape-sequences\fR
اجازه چاپ توالی‌های گریز ترمینال هنگام نوشتن یک فایل در خروجی استاندارد

.TP
\fB-A\fR, \fB--archive\fR \fB<format>\fR
دانلود آرشیو کد منبع در قالب مشخص‌شده (zip یا tar.gz)

.TP
\fB--clobber\fR
رونویسی فایل‌های موجود با نام یکسان

.TP
\fB-D\fR, \fB--dir\fR \fB<directory> (default ".")\fR
دایرکتوری مقصد برای دانلود فایل‌ها

.TP
\fB-O\fR, \fB--output\fR \fB<file>\fR
فایلی برای نوشتن یک دارایی تکی در آن (از "-" برای نوشتن در خروجی استاندارد استفاده کنید)

.TP
\fB-p\fR, \fB--pattern\fR \fB<stringArray>\fR
تنها دانلود فایل‌هایی که با یک الگوی glob مطابقت دارند

.TP
\fB--skip-existing\fR
صرف‌نظر کردن از دانلود در صورت وجود فایل‌هایی با نام مشابه

.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
.TP
\fB-R\fR, \fB--repo\fR \fB<[HOST/]OWNER/REPO>\fR
انتخاب یک مخزن دیگر با استفاده از قالب [HOST/]OWNER/REPO

.SH "کدهای خروج (EXIT CODES)"
0: اجرای موفقیت‌آمیز

.PP
1: خطا

.PP
2: دستور لغو شد

.PP
4: نیاز به احراز هویت است

.PP
نکته: دستورات خاص ممکن است کدهای خروج بیشتری داشته باشند\&. برای اطلاعات بیشتر به راهنمای دستور مراجعه کنید\&.

.SH "مثال (EXAMPLE)"
.EX
# دانلود تمام فایل‌های یک انتشار مشخص
$ gh release download v1.2.3

# دانلود تنها بسته‌های دبیان برای آخرین انتشار
$ gh release download --pattern '*.deb'

# مشخص کردن چندین الگوی فایل
$ gh release download -p '*.deb' -p '*.rpm'

# دانلود آرشیو کد منبع برای یک انتشار
$ gh release download v1.2.3 --archive=zip

.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBgh-release(1)\fR