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

.SH "نام (NAME)"
buf-convert \- تبدیل پیام میان قالب‌های باینری، JSON یا متن پروتوباف


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


.SH "توضیحات (DESCRIPTION)"
استفاده از یک proto ورودی برای تفسیر یک پیام proto/json و تبدیل آن به قالبی دیگر.

.PP
مثال‌ها:

.EX
$ buf convert <input> --type=<type> --from=<payload> --to=<output>
.EE

.PP
ورودی (<input>) می‌تواند یک فایل .proto محلی، خروجی باینری "buf build"، ماژول BSR یا ماژول محلی buf باشد:

.EX
$ buf convert example.proto --type=Foo.proto --from=payload.json --to=output.binpb
.EE

.PP
هر سه مورد ورودی (<input>)،
.B \-\-from
و
.B \-\-to
گزینه‌های قالب‌بندی را می‌پذیرند:

.EX
$ buf convert example.proto#format=binpb --type=buf.Foo --from=payload#format=json --to=out#format=json
.EE

.PP
هر دو مورد ورودی (<input>) و
.B \-\-from
از تغییر مسیر stdin پشتیبانی می‌کنند:

.EX
$ buf convert <(buf build -o -)#format=binpb --type=foo.Bar --from=<(echo "{\"one\":\"55\"}")#format=json
.EE

.PP
تغییر مسیر از stdin به
.BR \-\-from :

.EX
$ echo "{\"one\":\"55\"}" | buf convert buf.proto --type buf.Foo --from -#format=json
.EE

.PP
تغییر مسیر از stdin به ورودی (<input>):

.EX
$ buf build -o - | buf convert -#format=binpb --type buf.Foo --from=payload.json
.EE

.PP
استفاده از یک ماژول در BSR:

.EX
$ buf convert <buf.build/owner/repository> --type buf.Foo --from=payload.json
.EE


.SH "گزینه‌ها (OPTIONS)"
\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--from\fP="-"
	مکان بار داده (payload) مورد نظر برای تبدیل. قالب‌های پشتیبانی‌شده شامل [binpb,json,txtpb,yaml] هستند

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

.PP
\fB--to\fP="-"
	مکان خروجی عملیات تبدیل. قالب‌های پشتیبانی‌شده شامل [binpb,json,txtpb,yaml] هستند

.PP
\fB--type\fP=""
	نام کامل نوع پیام درون ورودی (مانند acme.weather.v1.Units)

.PP
\fB--validate\fP[=false]
	اعتبارسنجی پیام تعیین‌شده با
.B \-\-from
از طریق اعمال قوانین protovalidate بر روی آن. برای جزئیات بیشتر به
https://github.com/bufbuild/protovalidate
مراجعه کنید


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

.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