Buf(1) Buf(1)

buf-breaking - بررسی تغییرات مخرب (Breaking Changes) در فایل‌های پروتوباف با buf

buf breaking --against [flags]

این دستور اطمینان حاصل می‌کند که مکان ورودی در مقایسه با مکان مبنا هیچ تغییر مخربی (breaking changes) ندارد.

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

--against="" الزامی است، مگر اینکه --against-registry تنظیم شده باشد. سورس، ماژول یا ایمیجی که باید در برابر آن مقایسه انجام شود. باید یکی از قالب‌های [binpb,dir,git,json,mod,protofile,tar,txtpb,yaml,zip] باشد

--against-config="" فایل یا داده‌های buf.yaml که برای پیکربندی سورس، ماژول یا ایمیج مورد مقایسه استفاده می‌شود

--against-registry[=false] اجرای بررسی تغییرات مخرب در برابر آخرین کامیت در شاخه پیش‌فرض رجیستری. تمام ماژول‌های موجود در ورودی باید یک نام پیکربندی‌شده داشته باشند، در غیر این صورت این عملیات ناموفق خواهد بود. اگر یک ماژول ریموت با نام پیکربندی‌شده یافت نشود، عملیات ناموفق خواهد بود. این گزینه نمی‌تواند همراه با --against تنظیم شود.

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

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

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

--exclude-imports[=false] مستثنی کردن موارد import از تشخیص تغییرات مخرب.

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

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

--limit-to-input-files[=false] اجرای بررسی تغییرات مخرب فقط در برابر فایل‌های موجود در ورودی هنگامی که تنظیم شود، ورودی مبنای مقایسه تنها شامل فایل‌های موجود در ورودی خواهد بود اولویت بالاتری نسبت به --path دارد

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

--debug[=false] فعال‌سازی ثبت وقایع خطایابی

--log-format="color" قالب ثبت وقایع [text,color,json]

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

buf(1)

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

2026-07-17 Auto generated by spf13/cobra