Buf(1) Buf(1)

buf-source-edit-deprecate - منسوخ کردن انواع Protobuf

buf source edit deprecate [flags]

منسوخ کردن انواع Protobuf با افزودن گزینه 'deprecated = true'.

گزینه --prefix الزامی است و پیشوند نام کاملاً مشخص (fully-qualified name) انواعی که باید منسوخ شوند را مشخص می‌کند. تمام انواعی که نام کامل آن‌ها با این پیشوند آغاز می‌شود، گزینه 'deprecated = true' را دریافت خواهند کرد. برای فیلدها و مقادیر enum، تنها تطابق‌های دقیق منسوخ می‌شوند.

اگر هیچ نوعی با پیشوندهای مشخص‌شده مطابقت نداشته باشد، خطا برمی‌گرداند. اگر انواع منطبق قبلاً منسوخ شده باشند، هیچ تغییری اعمال نمی‌شود و دستور با موفقیت پایان می‌یابد.

به طور پیش‌فرض، منبع همان شاخه جاری است و پرونده‌ها در جای خود قالب‌بندی و بازنویسی می‌شوند.

مثال‌ها:

منسوخ کردن تمام انواع زیر یک پیشوند بسته:

$ buf source edit deprecate --prefix foo.bar

منسوخ کردن یک پیام خاص و تمام انواع تو در توی آن:

$ buf source edit deprecate --prefix foo.bar.MyMessage

منسوخ کردن یک فیلد خاص:

$ buf source edit deprecate --prefix foo.bar.MyMessage.my_field

می‌توان چندین پرچم --prefix مشخص کرد:

$ buf source edit deprecate --prefix foo.bar --prefix baz.qux

نمایش تفاوت تغییرات (diff) به جای بازنویسی پرونده‌ها:

$ buf source edit deprecate --prefix foo.bar -d

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

-d, --diff[=false] نمایش تفاوت‌ها به جای بازنویسی پرونده‌ها

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

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

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

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

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

--prefix=[] الزامی. پیشوند نام کامل انواعی که باید منسوخ شوند. می‌تواند چندین بار تعیین شود.

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

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

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

buf-source-edit(1)

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

2026-07-17 Auto generated by spf13/cobra