نام (NAME)

gh-extension-search - جستجو در افزونه‌های گیت‌هاب

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

gh extension search [<query>] [flags]

توضیحات (DESCRIPTION)

جستجوی افزونه‌های gh.

بدون هیچ آرگومانی، این دستور ۳۰ افزونه اولِ قابل نصب را که بر اساس تعداد ستاره‌ها مرتب شده‌اند چاپ می‌کند. با مشخص کردن یک سقف بالاتر با گزینه --limit می‌توان افزونه‌های بیشتری را دریافت کرد.

هنگامی که خروجی به یک ترمینال متصل باشد، این دستور سه ستون چاپ می‌کند. اگر افزونه از قبل به صورت محلی نصب شده باشد، ستون اول دارای علامت ✓ است. ستون دوم نام کامل مخزن افزونه در قالب OWNER/REPO است. ستون سوم توضیحات افزونه است.

هنگامی که خروجی به یک ترمینال متصل نباشد، نویسه ✓ به صورت کلمه "installed" نمایش داده می‌شود، اما در غیر این صورت ترتیب و محتوای ستون‌ها یکسان است.

این دستور رفتاری مشابه gh search repos دارد، اما از توصیف‌کننده‌های جستجوی زیادی پشتیبانی نمی‌کند. برای جستجوی دقیق‌تر افزونه‌ها، از دستور زیر استفاده کنید:

gh search repos --topic "gh-extension"

و در صورت نیاز توصیف‌کننده‌ها را اضافه کنید. برای اطلاعات بیشتر درباره جستجوی مخزن، راهنمای gh help search repos را ببینید.

برای فهرست کردن تنها افزونه‌هایی که از قبل به صورت محلی نصب شده‌اند، دستور زیر را ببینید:

gh ext list

گزینه‌ها (OPTIONS)

-q, --jq <expression>: فیلتر کردن خروجی JSON با استفاده از عبارت jq
--json <fields>: تولید خروجی JSON با فیلدهای مشخص‌شده
--license <strings>: فیلتر کردن بر اساس نوع مجوز
-L, --limit <int> (default 30): حداکثر تعداد افزونه‌ها برای واکشی
--order <string> (default "desc"): ترتیب مخازن بازگردانده‌شده، نادیده گرفته می‌شود مگر اینکه گزینه --sort مشخص شده باشد: {asc|desc}
--owner <strings>: فیلتر کردن بر اساس مالک
--sort <string> (default "best-match"): مرتب‌سازی مخازن دریافت‌شده: {forks|help-wanted-issues|stars|updated}
-t, --template <string>: قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help formatting" مراجعه کنید
-w, --web: باز کردن عبارت جستجو در مرورگر وب

فیلدهای JSON (JSON FIELDS)

createdAt, defaultBranch, description, forksCount, fullName, hasDownloads, hasIssues, hasPages, hasProjects, hasWiki, homepage, id, isArchived, isDisabled, isFork, isPrivate, language, license, name, openIssuesCount, owner, pushedAt, size, stargazersCount, updatedAt, url, visibility, watchersCount

کدهای خروج (EXIT CODES)

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.

مثال‌ها (EXAMPLES)

# فهرست کردن ۳۰ افزونه اول مرتب‌شده بر اساس تعداد ستاره به صورت نزولی
$ gh ext search
# فهرست کردن افزونه‌های بیشتر
$ gh ext search --limit 300
# فهرست کردن افزونه‌های مطابق با عبارت "branch"
$ gh ext search branch
# فهرست کردن افزونه‌های متعلق به سازمان "github"
$ gh ext search --owner github
# فهرست کردن افزونه‌ها با مرتب‌سازی صعودی بر اساس موارد اخیراً به‌روزرسانی‌شده
$ gh ext search --sort updated --order asc
# فهرست کردن افزونه‌ها با فیلتر کردن بر اساس مجوز
$ gh ext search --license MIT
# باز کردن نتایج جستجو در مرورگر وب
$ gh ext search -w

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

gh-extension(1)