نام (NAME)

buf-export - برون‌بری پرونده‌های proto از یک مکان به مکان دیگر

خلاصه دستور (SYNOPSIS)

buf export [flags]

توضیحات (DESCRIPTION)

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

مثال‌ها:

برون‌بری پرونده‌های proto در یک منبع به یک شاخه خروجی:

$ buf export <source> --output=<output-dir>

برون‌بری شاخه جاری به یک شاخه محلی دیگر:

$ buf export . --output=<output-dir>

برون‌بری جدیدترین ماژول دوردست به یک شاخه محلی:

$ buf export <buf.build/owner/repository> --output=<output-dir>

برون‌بری نسخه مشخصی از یک ماژول دوردست به یک شاخه محلی:

$ buf export <buf.build/owner/repository:ref> --output=<output-dir>

برون‌بری یک مخزن گیت به یک شاخه محلی:

$ buf export https://github.com/owner/repository.git --output=<output-dir>

گزینه‌ها (OPTIONS)

--all[=false] در صورت تنظیم، پرونده‌های مستندات و پروانه (license) موجود برای ورودی برون‌بری‌شده نیز گنجانده می‌شوند. اگر ورودی بیش از یک ماژول داشته باشد، نام ماژول به عنوان پسوند به نام پرونده‌های مستندات و پروانه اضافه می‌شود.

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

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

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

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

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

-o, --output="" شاخه خروجی برای پرونده‌های برون‌بری‌شده

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

گزینه‌های به ارث رسیده از دستورات والد (OPTIONS INHERITED FROM PARENT COMMANDS)

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

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

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

همچنین ببینید (SEE ALSO)

buf(1)

تاریخچه (HISTORY)

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