.nh
.TH "Buf" "1" "2026-07-17" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
buf-push \- ارسال و انتشار به رجیستری شمای Buf


.SH "خلاصه دستور (SYNOPSIS)"
\fBbuf push  [flags]\fP


.SH "توضیحات (DESCRIPTION)"
نخستین آرگومان منبعی است که باید ارسال شود، که باید یکی از قالب‌های [dir,git,protofile,tar,zip] باشد.
در صورتی که هیچ آرگومانی تعیین نشود، مقدار پیش‌فرض "." است.


.SH "گزینه‌ها (OPTIONS)"
\fB--create\fP[=false]
	ایجاد ماژول در صورتی که از قبل وجود نداشته باشد. در صورتی که --create-visibility تنظیم نشده باشد، پیش‌فرض ایجاد یک ماژول خصوصی است.

.PP
\fB--create-default-label\fP=""
	تنظیم برچسب پیش‌فرض ماژول، در صورت ایجاد شدن. اگر تنظیم نشود، ماژول با برچسب پیش‌فرض "main" ایجاد خواهد شد.

.PP
\fB--create-visibility\fP="private"
	تنظیم سطح قابلیت مشاهده (visibility) ماژول در صورت ایجاد شدن. تنها همراه با --create قابل استفاده است. باید یکی از مقادیر [public,private] باشد

.PP
\fB--disable-symlinks\fP[=false]
	عدم دنبال کردن پیوندهای نمادین هنگام خواندن منابع یا پیکربندی از فایل‌سیستم محلی
به‌طور پیش‌فرض، پیوندهای نمادین در این خط فرمان دنبال می‌شوند، اما در Buf Schema Registry هرگز دنبال نخواهند شد

.PP
\fB--error-format\fP="text"
	قالب خطاهای ساخت چاپ‌شده در خروجی خطای استاندارد (stderr). باید یکی از قالب‌های [text,json,msvs,junit,github-actions,gitlab-code-quality] باشد

.PP
\fB--exclude-unnamed\fP[=false]
	ارسال ماژول‌های نام‌گذاری‌شده به BSR. ماژول‌های نام‌گذاری‌شده نباید هیچ وابستگی بدون نامی داشته باشند.

.PP
\fB--git-metadata\fP[=false]
	استفاده از وضعیت سیستم کنترل نسخه گیت برای تنظیم مقادیر فلگ‌ها. اگر این فلگ تنظیم شود، از مقادیر زیر برای فلگ‌های شما استفاده خواهد شد:

.EX
--source-control-url to <git remote URL>/<repository name>/<route>/<checked out commit sha> (e.g. https://github.com/acme/weather/commit/ffac537e6cbbf934b08745a378932722df287a53).
--label for each Git tag and branch pointing to the currently checked out commit. You can set additional labels using --label with this flag.
--create-default-label to the Git default branch (e.g. main) - this is only in effect if --create is also set.
.EE

.PP
نشانی اینترنتی کنترل نسخه (source control URL) و شاخه پیش‌فرض بر اساس ریموت گیت الزامی "origin" است.
این فلگ تنها با نسخه‌های بررسی‌شده (checkouts) مخازن منبع گیت سازگار است.
اگر خودتان فلگ --source-control-url یا --create-default-label را تنظیم کنید، آن مقدار(ها) جایگزین شده و اطلاعات از وضعیت کنترل نسخه گیت استخراج نخواهد شد.

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمایی برای push

.PP
\fB--label\fP=[]
	انتساب برچسب به ماژول‌های ارسال‌شده. می‌تواند چندین بار استفاده شود.

.PP
\fB--source-control-url\fP=""
	نشانی اینترنتی برای مشاهده کد منبع ماژول‌های ارسال‌شده (مانند کامیت مشخص در سیستم کنترل نسخه).


.SH "گزینه‌های موروثی از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--debug\fP[=false]
	فعال‌سازی ثبت وقایع برای اشکال‌زدایی (debug logging)

.PP
\fB--log-format\fP="color"
	قالب گزارش‌گیری [text,color,json]

.PP
\fB--timeout\fP=0s
	مدت زمان تا پایان مهلت زمانی؛ تنظیم روی 0s به معنای عدم وجود محدودیت زمانی است


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


.SH "تاریخچه (HISTORY)"
2026-07-17 تولید خودکار توسط spf13/cobra