نام (NAME)

gh-search-commits - جستجوی کامیت‌ها

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

gh search commits [<query>] [flags]

توضیحات (DESCRIPTION)

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

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

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

⟨https://docs.github.com/search-github/searching-on-github/searching-commits⟩

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

گزینه‌ها (OPTIONS)

--author <string>: فیلتر کردن بر اساس نویسنده
--author-date <date>: فیلتر کردن بر اساس تاریخ نگارش
--author-email <string>: فیلتر کردن بر اساس ایمیل نویسنده
--author-name <string>: فیلتر کردن بر اساس نام نویسنده
--committer <string>: فیلتر کردن بر اساس ثبت‌کننده کامیت (committer)
--committer-date <date>: فیلتر کردن بر اساس تاریخ ثبت کامیت
--committer-email <string>: فیلتر کردن بر اساس ایمیل ثبت‌کننده کامیت
--committer-name <string>: فیلتر کردن بر اساس نام ثبت‌کننده کامیت
--hash <string>: فیلتر کردن بر اساس هش کامیت
-q, --jq <expression>: فیلتر کردن خروجی JSON با استفاده از عبارت jq
--json <fields>: تولید خروجی JSON با فیلدهای مشخص‌شده
-L, --limit <int> (default 30): حداکثر تعداد کامیت‌ها برای واکشی
--merge: فیلتر کردن بر اساس کامیت‌های ادغام (merge)
--order <string> (default "desc"): ترتیب کامیت‌های برگشتی، نادیده گرفته می‌شود مگر اینکه فلگ '--sort' مشخص شده باشد: {asc|desc}
--owner <strings>: فیلتر کردن بر اساس مالک مخزن
--parent <string>: فیلتر کردن بر اساس هش والد (parent)
-R, --repo <OWNER/REPO>: فیلتر کردن بر اساس مخزن، در قالب OWNER/REPO
--sort <string> (default "best-match"): مرتب‌سازی کامیت‌های واکشی‌شده: {author-date|committer-date}
-t, --template <string>: قالب‌بندی خروجی JSON با استفاده از الگوی Go؛ به "gh help formatting" مراجعه کنید
--tree <string>: فیلتر کردن بر اساس هش درخت (tree)
--visibility <strings>: فیلتر کردن بر اساس سطح دسترسی مخزن: {public|private|internal}
-w, --web: باز کردن عبارت جستجو در مرورگر وب

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

author, commit, committer, id, parents, repository, sha, url

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

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

1: خطا

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

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

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

مثال‌ها (EXAMPLES)

# جستجوی کامیت‌های منطبق با مجموعه‌ای از کلیدواژه‌های "readme" و "typo"
$ gh search commits readme typo
# جستجوی کامیت‌های منطبق با عبارت "bug fix"
$ gh search commits "bug fix"
# جستجوی کامیت‌ها با استفاده از توصیف‌کننده‌های جستجوی خام به عنوان آرگومان‌های جداگانه
$ gh search commits fix author:monalisa merge:false
# جستجوی کامیت‌های ثبت‌شده توسط کاربر "monalisa"
$ gh search commits --committer=monalisa
# جستجوی کامیت‌های نگارش‌شده توسط کاربران با نام "Jane Doe"
$ gh search commits --author-name="Jane Doe"
# جستجوی کامیت‌های منطبق با هش "8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3"
$ gh search commits --hash=8dd03144ffdc6c0d486d6b705f9c7fba871ee7c3
# جستجوی کامیت‌های نگارش‌شده پیش از ۱ فوریه ۲۰۲۲
$ gh search commits --author-date="<2022-02-01"

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

gh-search(1)