أداة CLI للبحث في GitHub من المحطة.
Stig هي أداة CLI للبحث في GitHub من المحطة. بفضل القدرة على فرز النتائج وتصفيتها، يسهل Stig العثور على ما تبحث عنه. يمكن لـ Stig أيضًا طباعة مستودعات README.md إلى stdout، حتى تتمكن من معرفة المزيد حول المشروع بسرعة.
سيبدو عنصر نتيجة البحث النموذجي كما يلي:
- owner
| - repo
| | - stars
| | | - forks
| | | | - issues
| | | | | - language
| | | | | | - last updated
| | | | | | | - summary
| | | | | | | |
octobanana/stig *12 <3 !4 [C++] 5h
A CLI tool for searching GitHub from the terminal.
سيُظهر المستودع المتشعب الرمز >
، بدلاً من الرمز <
الافتراضي.
يتم تعيين آخر الرموز المحدثة إلى ما يلي:
s : seconds
m : minutes
h : hours
D : days
W : weeks
M : months
Y : years
وفي نهاية النتائج سيظهر ملخص:
- current results
| - total results
| | - current page
| | | - total pages
| | | | - requests remaining
| | | | | - requests limit
| | | | | |
1-5/81 results | 1/17 pages | 9/10 limit
مطلوب محاكي طرفي يدعم رموز الهروب ansi واللون الحقيقي عند تمكين الإخراج الملون. يجب أن تدعم غالبية المحاكيات الطرفية الشائعة كليهما. على الرغم من أن تمكين الإخراج الملون يوفر أفضل تجربة، إلا أنه يمكن ضبطه باستخدام خيار --color
، مع on
أو off
أو auto
كمدخلات، مع كون auto هي القيمة الافتراضية.
افتراضيًا، تسمح واجهة برمجة تطبيقات GitHub بما يصل إلى 10 استعلامات بحث في الدقيقة. لتوسيع الحد إلى 30 استعلام بحث في الدقيقة، يمكنك تمرير رمز GitHub المميز باستخدام خيار --token
.
لمزيد من المعلومات حول إنشاء رمز وصول شخصي جديد، راجع مقالة مساعدة GitHub التالية.
من الممكن استخدام نقطة نهاية API مخصصة للتوافق مع عمليات تثبيت GitHub Enterprise باستخدام خيار --host
. يجب أن يتم تنسيق المضيف كـ، subdomain.domain.tld
. من المتوقع أن يتم تقديم نقطة النهاية عبر HTTPS على المنفذ 443 .
مهم
عند استخدام خيار
--host
، استخدم فقط خيار--token
مع نقطة نهاية API مخصصة موثوقة. إذا تم تمرير مضيف غير صحيح مع رمز مميز، فمن الحكمة إلغاء الرمز المميز على الفور وإنشاء رمز جديد.
# query 'stig' showing '20' results from page '1'
$ stig --query ' stig ' --number 20 --page 1
# query 'stig' with filter 'language:cpp'
$ stig --query ' stig ' --filter ' language:cpp '
# query 'stig' and pipe into less
$ stig --query ' stig ' | less
# query 'all' sorted by 'stars' with filter 'language:js'
$ stig --query ' ' --sort ' stars ' --filter ' language:js '
# query 'http server' with filters 'language:cpp' and 'stars:>10'
$ stig --query ' http server ' --filter ' language:cpp stars:>10 '
# output the README.md for 'octobanana/stig' on default branch
$ stig --readme ' octobanana/stig '
# output the README.md for 'octobanana/stig' on branch 'master'
$ stig --readme ' octobanana/stig/master '
# output the README.md for 'octobanana/stig' on default branch and pipe into less
$ stig --readme ' octobanana/stig ' | less
# output the program help
$ stig --help
# output the program version
$ stig --version
./src/ob/belle.hh
./src/ob/parg.hh
./src/lib/json.hh
سيقوم أمر shell التالي ببناء المشروع في وضع الإصدار:
./build.sh
للإنشاء في وضع التصحيح، قم بتشغيل البرنامج النصي باستخدام علامة --debug
.
سيقوم أمر shell التالي بتثبيت المشروع في وضع الإصدار:
./install.sh
للتثبيت في وضع التصحيح، قم بتشغيل البرنامج النصي باستخدام علامة --debug
.
هذا المشروع مرخص بموجب ترخيص MIT.
حقوق الطبع والنشر (ج) 2018-2019 بريت روبنسون
يُمنح الإذن مجانًا لأي شخص يحصل على نسخة من هذا البرنامج وملفات الوثائق المرتبطة به ("البرنامج")، للتعامل في البرنامج دون قيود، بما في ذلك، على سبيل المثال لا الحصر، حقوق الاستخدام والنسخ والتعديل والدمج. ونشر و/أو توزيع وترخيص من الباطن و/أو بيع نسخ من البرنامج، والسماح للأشخاص الذين تم توفير البرنامج لهم بالقيام بذلك، وفقًا للشروط التالية:
يجب تضمين إشعار حقوق الطبع والنشر أعلاه وإشعار الإذن هذا في جميع النسخ أو الأجزاء الكبيرة من البرنامج.
يتم توفير البرنامج "كما هو"، دون أي ضمان من أي نوع، صريحًا أو ضمنيًا، بما في ذلك، على سبيل المثال لا الحصر، ضمانات القابلية للتسويق والملاءمة لغرض معين وعدم الانتهاك. لا يتحمل المؤلفون أو أصحاب حقوق الطبع والنشر بأي حال من الأحوال المسؤولية عن أي مطالبة أو أضرار أو مسؤولية أخرى، سواء في إجراء العقد أو الضرر أو غير ذلك، الناشئة عن أو خارج أو فيما يتعلق بالبرنامج أو الاستخدام أو المعاملات الأخرى في برمجة.