نام (NAME)

gh-search-issues - جستجوی مسائل (Issues)

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

gh search issues [<query>] [flags]

توضیحات (DESCRIPTION)

جستجوی مسائل (issues) در گیت‌هاب (GitHub).

این دستور از ساخت پرس‌وجو با استفاده از نحو جستجوی گیت‌هاب، استفاده از فلگ‌های پارامتر و توصیف‌کننده (qualifier)، یا ترکیبی از این دو پشتیبانی می‌کند.

نحو جستجوی گیت‌هاب در نشانی زیر مستند شده است:

⟨https://docs.github.com/search-github/searching-on-github/searching-issues-and-pull-requests⟩

روی میزبان‌های گیت‌هاب پشتیبانی‌شده، نحو جستجوی پیشرفته مسائل می‌تواند در پرس‌وجوی --search به کار رود. برای اطلاعات بیشتر در مورد جستجوی پیشرفته مسائل، ببینید:

⟨https://docs.github.com/en/issues/tracking-your-work-with-issues/using-issues/filtering-and-searching-issues-and-pull-requests#building-advanced-filters-for-issues⟩

از --search-type برای انتخاب رتبه‌بندی معنایی (semantic) یا ترکیبی (کلیدواژه + معنایی) به جای جستجوی پیش‌فرض لغوی (lexical) استفاده کنید. جستجوی معنایی و ترکیبی به مسائل محدود هستند، بر اساس میزان ارتباط رتبه‌بندی می‌شوند (بنابراین --sort و --order قابل استفاده نیستند)، یک صفحه تکی از نتایج برمی‌گردانند، و روی GitHub Enterprise Server در دسترس نیستند.

برای اطلاعات بیشتر در مورد مدیریت پرس‌وجوهای جستجو حاوی خط پیوند، دستور gh search --help را اجرا کنید.

گزینه‌ها (OPTIONS)

--app <string>: فیلتر کردن بر اساس سازنده گیت‌هاب اپ (GitHub App)
--archived: فیلتر کردن بر اساس وضعیت بایگانی‌شده بودن مخزن {true|false}
--assignee <string>: فیلتر کردن بر اساس محول‌شده به شخص (assignee)
--author <string>: فیلتر کردن بر اساس نویسنده (از --app برای فیلتر کردن بر اساس یک گیت‌هاب اپ استفاده کنید)
--closed <date>: فیلتر کردن بر اساس تاریخ بسته شدن
--commenter <user>: فیلتر کردن بر اساس نظرات ثبت‌شده توسط کاربر
--comments <number>: فیلتر کردن بر اساس تعداد نظرات
--created <date>: فیلتر کردن بر اساس تاریخ ایجاد
--include-prs: شامل کردن درخواست‌های ادغام (Pull Requests) در نتایج
--interactions <number>: فیلتر کردن بر اساس تعداد واکنش‌ها و نظرات
--involves <user>: فیلتر کردن بر اساس مشارکت کاربر
-q, --jq <expression>: فیلتر کردن خروجی JSON با استفاده از عبارت jq
--json <fields>: تولید خروجی JSON با فیلدهای مشخص‌شده
--label <strings>: فیلتر کردن بر اساس برچسب
--language <string>: فیلتر کردن بر اساس زبان برنامه‌نویسی
-L, --limit <int> (default 30): حداکثر تعداد نتایج برای واکشی
--locked: فیلتر کردن بر اساس وضعیت قفل بودن گفتگو
--match <strings>: محدود کردن جستجو به فیلد خاصی از مسئله: {title|body|comments}
--mentions <user>: فیلتر کردن بر اساس اشاره‌ها (mentions) به کاربر
--milestone <title>: فیلتر کردن بر اساس عنوان مایلستون (milestone)
--no-assignee: فیلتر کردن بر اساس نداشتن محول‌شونده (assignee)
--no-label: فیلتر کردن بر اساس نداشتن برچسب
--no-milestone: فیلتر کردن بر اساس نداشتن مایلستون
--no-project: فیلتر کردن بر اساس نداشتن پروژه
--order <string> (default "desc"): ترتیب نتایج برگشتی، نادیده گرفته می‌شود مگر اینکه فلگ '--sort' مشخص شده باشد: {asc|desc}
--owner <strings>: فیلتر کردن بر اساس مالک مخزن
--project <owner/number>: فیلتر کردن بر اساس مالک/شماره برد پروژه
--reactions <number>: فیلتر کردن بر اساس تعداد واکنش‌ها
-R, --repo <OWNER/REPO>: فیلتر کردن بر اساس مخزن، در قالب OWNER/REPO
--search-type <string> (default "lexical"): نوع جستجوی مسئله برای اجرا: {lexical|semantic|hybrid}
--sort <string> (default "best-match"): مرتب‌سازی نتایج واکشی‌شده: {comments|created|interactions|reactions|reactions-+1|reactions--1|reactions-heart|reactions-smile|reactions-tada|reactions-thinking_face|updated}
--state <string>: فیلتر کردن بر اساس وضعیت: {open|closed}
--team-mentions <string>: فیلتر کردن بر اساس اشاره‌ها به تیم
-t, --template <string>: قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help formatting" مراجعه کنید
--updated <date>: فیلتر کردن بر اساس تاریخ آخرین به‌روزرسانی
--visibility <strings>: فیلتر کردن بر اساس سطح دسترسی مخزن: {public|private|internal}
-w, --web: باز کردن عبارت جستجو در مرورگر وب

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

assignees, author, authorAssociation, body, closedAt, commentsCount, createdAt, id, isLocked, isPullRequest, labels, number, repository, state, title, updatedAt, url

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

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

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

# جستجوی مسائل منطبق با مجموعه‌ای از کلیدواژه‌های "readme" و "typo"
$ gh search issues readme typo
# جستجوی مسائل منطبق با عبارت "broken feature"
$ gh search issues "broken feature"
# جستجوی مسائل با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
$ gh search issues label:bug author:monalisa state:open
# جستجوی مسائل و درخواست‌های ادغام در سازمان cli
$ gh search issues --include-prs --owner=cli
# جستجوی مسائل باز محول‌شده به خودتان
$ gh search issues --assignee=@me --state=open
# جستجوی مسائل با نظرات پرشمار
$ gh search issues --comments=">100"
# جستجوی مسائل بدون برچسب "bug"
$ gh search issues -- -label:bug
# جستجوی مسائل فقط از مخازن بایگانی‌نشده (پیش‌فرض تمام مخازن است)
$ gh search issues --owner github --archived=false
# جستجوی مسائل با استفاده از رتبه‌بندی معنایی (زبان طبیعی)
$ gh search issues "feature broken on web" --search-type semantic
# جستجوی مسائل با استفاده از رتبه‌بندی ترکیبی (کلیدواژه + معنایی)
$ gh search issues "feature broken" --search-type hybrid

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

gh-search(1)