نام (NAME)

gh-search-prs - جستجوی درخواست‌های ادغام (Pull Requests)

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

gh search prs [<query>] [flags]

توضیحات (DESCRIPTION)

جستجوی درخواست‌های ادغام (pull requests) در گیت‌هاب (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⟩

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

گزینه‌ها (OPTIONS)

--app <string>: فیلتر کردن بر اساس سازنده گیت‌هاب اپ (GitHub App)
--archived: فیلتر کردن بر اساس وضعیت بایگانی‌شده بودن مخزن {true|false}
--assignee <string>: فیلتر کردن بر اساس محول‌شده به شخص (assignee)
--author <string>: فیلتر کردن بر اساس نویسنده (از --app برای فیلتر کردن بر اساس یک گیت‌هاب اپ استفاده کنید)
-B, --base <string>: فیلتر کردن بر اساس نام شاخه پایه (base branch)
--checks <string>: فیلتر کردن بر اساس وضعیت بررسی‌ها: {pending|success|failure}
--closed <date>: فیلتر کردن بر اساس تاریخ بسته شدن
--commenter <user>: فیلتر کردن بر اساس نظرات ثبت‌شده توسط کاربر
--comments <number>: فیلتر کردن بر اساس تعداد نظرات
--created <date>: فیلتر کردن بر اساس تاریخ ایجاد
--draft: فیلتر کردن بر اساس وضعیت پیش‌نویس (draft)
-H, --head <string>: فیلتر کردن بر اساس نام شاخه مبدا (head branch)
--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) به کاربر
--merged: فیلتر کردن بر اساس وضعیت ادغام‌شده
--merged-at <date>: فیلتر کردن بر اساس تاریخ ادغام
--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
--review <string>: فیلتر کردن بر اساس وضعیت بازبینی: {none|required|approved|changes_requested}
--review-requested <user>: فیلتر کردن بر اساس کاربر یا تیمی که درخواست بازبینی از آنها شده است
--reviewed-by <user>: فیلتر کردن بر اساس کاربری که بازبینی کرده است
--sort <string> (default "best-match"): مرتب‌سازی نتایج واکشی‌شده: {comments|reactions|reactions-+1|reactions--1|reactions-smile|reactions-thinking_face|reactions-heart|reactions-tada|interactions|created|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, isDraft, isLocked, isPullRequest, labels, number, repository, state, title, updatedAt, url

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

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

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

# جستجوی درخواست‌های ادغام منطبق با مجموعه‌ای از کلیدواژه‌های "fix" و "bug"
$ gh search prs fix bug
# جستجوی درخواست‌های ادغام پیش‌نویس در مخزن cli
$ gh search prs --repo=cli/cli --draft
# جستجوی درخواست‌های ادغام با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
$ gh search prs is:merged author:monalisa
# جستجوی درخواست‌های ادغام باز که درخواست بازبینی از شما دارند
$ gh search prs --review-requested=@me --state=open
# جستجوی درخواست‌های ادغام ادغام‌شده که به خودتان محول شده‌اند
$ gh search prs --assignee=@me --merged
# جستجوی درخواست‌های ادغام با واکنش‌های پرشمار
$ gh search prs --reactions=">100"
# جستجوی درخواست‌های ادغام بدون برچسب "bug"
$ gh search prs -- -label:bug
# جستجوی درخواست‌های ادغام فقط از مخازن بایگانی‌نشده (پیش‌فرض تمام مخازن است)
$ gh search prs --owner github --archived=false

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

gh-search(1)