Buf(1) Buf(1)

buf-registry-sdk-info - نمایش اطلاعات کیت توسعه نرم‌افزار (SDK) در رجیستری buf

buf registry sdk info --module= --plugin= [flags]

این دستور بر اساس اطلاعات مشخص‌شده، اطلاعات نگارش را برای یک SDK تولیدشده بازمی‌گرداند. برای تحلیل و استخراج اطلاعات SDK، باید یک ماژول و یک پلاگین مشخص شوند.

مثال‌ها:

برای دریافت اطلاعات SDK مربوط به آخرین کامیت یک ماژول و آخرین نگارش یک پلاگین، تنها کافی است ماژول و پلاگین را مشخص کنید. دستور زیر اطلاعات SDK را برای آخرین کامیت ماژول connectrpc/eliza و آخرین نگارش پلاگین bufbuild/es استخراج می‌کند:

$ buf registry sdk info --module=buf.build/connectrpc/eliza --plugin=buf.build/connectrpc/es
Module
Owner:  connectrpc
Name:   eliza
Commit: <latest commit on default label>
Plugin
Owner:    bufbuild
Name:     es
Version:  <latest version of plugin>
Revision: <latest revision of the plugin version>
Version: <SDK version for the resolved module commit and plugin version>

برای دریافت اطلاعات SDK مربوط به یک کامیت خاص از ماژول و/یا یک نگارش خاص از پلاگین، می‌توانید کامیت را همراه با ماژول و/یا نگارش را همراه با پلاگین مشخص کنید. دستور زیر اطلاعات SDK را برای کامیت مشخص‌شده ماژول connectrpc/eliza و نگارش مشخص‌شده پلاگین bufbuild/es استخراج می‌کند:

$ buf registry sdk info --module=buf.build/connectrpc/eliza:d8fbf2620c604277a0ece1ff3a26f2ff --plugin=buf.build/bufbuild/es:v1.2.1
Module
Owner:  connectrpc
Name:   eliza
Commit: d8fbf2620c604277a0ece1ff3a26f2ff
Plugin
Owner:    bufbuild
Name:     es
Version:  v1.2.1
Revision: 1
Version: 1.2.1-20230727062025-d8fbf2620c60.1

اگر یک نگارش SDK در اختیار دارید و می‌خواهید اطلاعات کامیت ماژول و نگارش پلاگین متناظر با آن SDK را بدانید، می‌توانید ماژول و پلاگین را همراه با رشته نگارش مشخص کنید. دستور زیر اطلاعات SDK را برای نگارش مشخص‌شده SDK از ماژول connectrpc/eliza و پلاگین bufbuild/es استخراج می‌کند.

$ buf registry sdk --module=buf.build/connectrpc/eliza --plugin=buf.build/bufbuild/es --version=1.2.1-20230727062025-d8fbf2620c60.1
Module
Owner:  connectrpc
Name:   eliza
Commit: d8fbf2620c604277a0ece1ff3a26f2ff
Plugin
Owner:    bufbuild
Name:     es
Version:  v1.2.1
Revision: 1
Version: 1.2.1-20230727062025-d8fbf2620c60.1

اطلاعات کامیت ماژول و نگارش پلاگین بر اساس رشته نگارش SDK مشخص‌شده تحلیل و استخراج می‌شوند.

اگر مرجع ماژول و/یا نگارش پلاگین همراه با نگارش SDK مشخص شده باشند، نگارش SDK با مرجع ماژول و/یا نگارش پلاگین مشخص‌شده اعتبارسنجی خواهد شد. در صورت عدم تطابق، این دستور با خطا پایان می‌یابد.

$ buf registry sdk info  \
    --module=buf.build/connectrpc/eliza:8b8b971d6fde4dc8ba5d96f9fda7d53c   \
    --plugin=buf.build/bufbuild/es  \
    --version=1.2.1-20230727062025-d8fbf2620c60.1
Failure: invalid_argument: invalid SDK version v1.2.1-20230727062025-d8fbf2620c60.1 with module short commit d8fbf2620c60 for resolved module reference connectrpc/eliza:8b8b971d6fde4dc8ba5d96f9fda7d53c

در این حالت، نگارش ارائه‌شده SDK به کامیتی متفاوت از کامیت ارائه‌شده برای ماژول منتهی می‌شود.

--format="text" قالب خروجی مورد استفاده. باید یکی از [text,json] باشد

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

--module="" مرجع ماژول برای SDK.

--plugin="" مرجع پلاگین برای SDK.

--version="" نگارش SDK.

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

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

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

buf-registry-sdk(1)

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

2026-07-17 Auto generated by spf13/cobra