Buf(1) Buf(1)

buf-dep-graph - چاپ گراف وابستگی‌ها

buf dep graph [flags]

به عنوان مثال، اگر پودمان موجود در شاخه "src/proto" به پودمان "buf.build/foo/bar" از BSR با کامیت "12345" وابسته باشد، و پودمان "buf.build/foo/bar:12345" به پودمان "buf.build/foo/baz" از BSR با کامیت "67890" وابسته باشد، خروجی زیر چاپ خواهد شد:

digraph {

"src/proto" -> "buf.build/foo/bar:12345"
"buf.build/foo/bar:12345" -> "buf.build/foo/baz:67890"

}

خروجی واقعی ممکن است در نسخه‌های مختلف CLI متفاوت باشد و تضمین پایداری ندارد، با این حال خروجی همواره در قالب معتبر DOT خواهد بود. اگر تمایل دارید قالبی پایدار و جایگزین تولید کنیم (مانند پیام Protobuf که به JSON تبدیل شود)، به ما اطلاع دهید!

برای آشنایی بیشتر با Graphviz و زبان DOT به https://graphviz.org مراجعه کنید. نصب graphviz در بسترهای مختلف متفاوت است، اما در macOS با homebrew به آسانی نصب می‌شود:

brew install graphviz

می‌توانید گراف وابستگی را با ابزار dot به سادگی به تصویر بکشید:

buf dep graph | dot -Tpng >| graph.png && open graph.png نخستین آرگومان، منبع یا پودمانی است که قصد چاپ گراف وابستگی آن را دارید، که باید یکی از قالب‌های [dir,git,mod,protofile,tar,zip] باشد. در صورت عدم تعیین آرگومان، مقدار پیش‌فرض "." خواهد بود.

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

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

--format="dot" قالب چاپ گراف. باید یکی از [dot,json] باشد

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

--debug[=false] فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (دیباگ)

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

--timeout=0s مدت‌زمان تا اتمام مهلت (تایم‌اوت)، مقدار صفر به معنای نبود محدودیت زمانی است

buf-dep(1)

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

2026-07-17 Auto generated by spf13/cobra