.nh
.TH "Buf" "1" "2026-07-17" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
buf-dep-graph \- چاپ گراف وابستگی‌ها


.SH "خلاصه دستور (SYNOPSIS)"
\fBbuf dep graph  [flags]\fP


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

.PP
digraph {

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

.PP
}

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

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

.PP
brew install graphviz

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

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


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

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

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

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنمای graph


.SH "گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)"
\fB--debug\fP[=false]
	فعال‌سازی ثبت گزارش‌های اشکال‌زدایی (دیباگ)

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

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


.SH "همچنین ببینید (SEE ALSO)"
\fBbuf-dep(1)\fP


.SH "تاریخچه (HISTORY)"
2026-07-17 تولید خودکار توسط spf13/cobra