Buf(1) Buf(1)

buf-build - ساخت و کامپایل فایلهای Protobuf در قالب ایمیج Buf

buf build [flags]

آرگومان اول منبع یا ماژول برای ساخت، یا ایمیج برای تبدیل است که باید یکی از قالب‌های [binpb,dir,git,json,mod,protofile,tar,txtpb,yaml,zip] باشد. در صورت عدم تعیین آرگومان، مقدار پیش‌فرض "." است.

--as-file-descriptor-set[=false] خروجی در قالب یک google.protobuf.FileDescriptorSet به جای یک ایمیج. توجه داشته باشید که ایمیج‌ها از نظر قالب داده‌ای با FileDescriptorSet سازگارند، اما این فلگ متاداده‌های اضافی افزوده شده برای استفاده توسط Buf را حذف می‌کند.

--config="" فایل یا داده‌های buf.yaml مورد استفاده برای پیکربندی

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

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

--exclude-imports[=false] مستثنی کردن واردات (imports).

--exclude-path=[] مستثنی کردن فایل‌ها یا دایرکتوری‌های خاص، مانند "proto/a/a.proto", "proto/a". در صورت تعیین چندباره، اجتماع آن‌ها در نظر گرفته می‌شود

--exclude-source-info[=false] مستثنی کردن اطلاعات منبع (source info)

--exclude-source-retention-options[=false] مستثنی کردن گزینه‌هایی که نگه‌داری آن‌ها در سطح منبع (source retention) است

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

-o, --output="/dev/null" محل خروجی برای ایمیج ساخته‌شده. باید یکی از قالب‌های [binpb,json,txtpb,yaml] باشد

--path=[] محدود کردن به فایل‌ها یا دایرکتوری‌های خاص، مانند "proto/a/a.proto", "proto/a". در صورت تعیین چندباره، اجتماع آن‌ها در نظر گرفته می‌شود

--type=[] انواعی (بسته، پیام، شمارشی/enum، افزونه/extension، سرویس، متد) که باید در این ایمیج گنجانده شوند. در صورت تعیین، ایمیج حاصل تنها شامل توصیف‌گرهایی برای توصیف انواع درخواستی خواهد بود. نام یک نوع ممکن است به ".**" ختم شود تا عنصر نام‌برده و تمام موارد تودرتو در زیر آن (مانند یک بسته و تمام زیربسته‌های آن) را به‌صورت بازگشتی شامل شود

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

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

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

buf(1)

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

2026-07-17 Auto generated by spf13/cobra