نام (NAME)

buf-convert - تبدیل پیام میان قالب‌های باینری، JSON یا متن پروتوباف

خلاصه دستور (SYNOPSIS)

buf convert [flags]

توضیحات (DESCRIPTION)

استفاده از یک proto ورودی برای تفسیر یک پیام proto/json و تبدیل آن به قالبی دیگر.

مثال‌ها:

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

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

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

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

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

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

$ buf convert <(buf build -o -)#format=binpb --type=foo.Bar --from=<(echo "{

تغییر مسیر از stdin به --from:

$ echo "{

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

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

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

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

گزینه‌ها (OPTIONS)

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

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

--from="-" مکان بار داده (payload) مورد نظر برای تبدیل. قالب‌های پشتیبانی‌شده شامل [binpb,json,txtpb,yaml] هستند

-h, --help[=false] راهنمایی برای convert

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

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

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

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

--debug[=false] فعال کردن گزارش‌گیری اشکال‌زدایی (debug)

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

--timeout=0s مدت زمان تا پایان مهلت زمانی؛ تنظیم روی 0s یعنی بدون محدودیت زمانی

همچنین ببینید (SEE ALSO)

buf(1)

تاریخچه (HISTORY)

2026-07-17 تولید خودکار توسط spf13/cobra