starcli
1.0.0
___ ______ _ ____ ____ _ _
/ * | | / | | / | * | |
| | / | |* / | | | | | |
| | /-- | | | | | | | |
*_./ ._| / ._ |_| _ .|__. |_|_. |_|
Jelajahi proyek tren di github dari baris perintah Anda $ _
pip3 install starcli Usage: starcli [OPTIONS]
Search and query GitHub repositories
Options:
-l, --lang TEXT Language filter eg: python. (can be used
multiple times)
-S, --spoken-language TEXT Spoken Language filter eg: en for English,
zh for Chinese
-c, --created TEXT Specify repo creation date in YYYY-MM-DD,
use >date, <=date etc to be more specific.
-t, --topic TEXT Date of last push in YYYY-MM-DD (>, <, >=,
<= specifiers supported)
-p, --pushed TEXT Specify date of last push in YYYY-MM-DD, >=<
allowed
-L, --layout [list|table|grid] The output format (list, table, or grid),
default is list
-s, --stars TEXT Number of stars, default is '>=100'. eg:
'>0', '123', '<50000
-n, --num-results INTEGER The number of items in the results. Default:
7
-o, --order [desc|asc] Order of repos by stars, 'desc' or 'asc',
default: desc
--long-stats Print the actual stats number (1300 instead
of 1.3k)
-d, --date-range [day|week|month]
View stars received within time, choose
from: day, week, month. Uses GitHub trending
for fetching results, hence some other
filter options may not work.
-u, --user TEXT Filter for trending repositories by username
--auth TEXT Optionally use GitHub personal access token
in the format 'username:password'.
-P, --pager Use $PAGER to page output. (put -r in $LESS
to enable ANSI styles)
--debug Turn on debugging mode
--help Show this message and exit.
Sakelar tata letak menggunakan --layout {list|table|grid} , atau gunakan opsi pendek -L
daftar
meja
kisi
Ketiga opsi tata letak mendukung tautan yang dapat diklik untuk nama repositori. Jika terminal Anda mendukung tautan, Anda dapat langsung mengklik nama dan itu akan membawa Anda ke repositori GitHub di browser Anda.
Misalnya, Anda hanya ingin menemukan repo python populer: menggunakan --lang atau -l :
starcli --lang python
Inilah contoh lain starcli -l python -L grid , yaitu ular python dengan tata letak grid:
Jika Anda ingin menemukan repo dalam bahasa ibu Anda, Anda dapat menggunakan --spoken-language atau -S :
starcli --spoken-language zh
Perintah di atas mencantumkan repo yang ditulis dalam bahasa Cina.
Daftar lengkap kode bahasa tersedia di sini
Perhatikan bahwa (seperti --date-range ) opsi seperti --topics , --pushed , --created tidak akan berlaku karena -d menggunakan mekanisme pencarian yang berbeda untuk menemukan hasil.
(Disarankan untuk digunakan dengan --created )
Kisaran default adalah> = 100 bintang.
Gunakan --stars atau -s untuk menentukan apa yang Anda inginkan, misalnya, jika Anda ingin menemukan repo yang memiliki lebih dari 100 bintang, Anda dapat menggunakan:
starcli -s '>100'
Perhatikan bahwa jika Anda melakukan sesuatu seperti >1000 tidak banyak repo yang dapat memiliki lebih dari 1000 dan dibuat dalam waktu sekitar 200 hari (yang merupakan default untuk --created ), untuk menentukan tanggal pembuatan, menggunakan --created , lihat di bawah.
Anda dapat melihat jumlah bintang yang diterima repo hari ini, minggu ini atau bulan ini dengan menggunakan opsi --date-range atau -d :
starcli -d this-week -L table
Perintah ini juga akan menampilkan jumlah bintang yang diterima untuk setiap repo minggu ini dalam bentuk tabel.
-d Menggunakan pencarian tren github untuk repositori, karenanya opsi --topic , --pushed , --created tidak akan berlaku.
--created / -c menerima tanggal dalam format ISO8601: yyyy-mm-dd
Misalnya, untuk repo yang dibuat pada 1 Januari 2014, gunakan:
starcli --created 2014-01-01
Untuk mencari repo yang dibuat pada atau setelah 1 Januari 2014, gunakan:
starcli --created '>=2014-01-01'
Opsi ini memungkinkan Anda memfilter berdasarkan topik. Anda dapat menggunakan --topics atau -t untuk memasukkan topik dalam pencarian.
Opsi ini dapat digunakan beberapa kali.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Gunakan --pushed / -p Saat Anda ingin menemukan repo populer yang terakhir diperbarui pada tanggal tertentu, katakanlah 2020-01-01 untuk 1 Januari 2020:
starcli -p 2020-01-01
Anda juga dapat mengawali nilai dengan "> = <" seperti:
starcli -p '>=2020-01-01'
Ini menemukan repo yang terakhir didorong setelah atau pada tanggal 1 Januari 2020.
Baca lebih lanjut tentang> = <sintaks pada dokumen GitHub.
Direkomendasikan untuk digunakan dengan --stars dan/atau --date-created .
Menemukan proyek tren dengan nama pengguna GitHub juga didukung. Gunakan --user atau -u untuk melakukannya.
Cukup berikan nama pengguna GitHub yang valid setelah itu, seperti:
starcli -u torvalds
starcli -u gvanrossum
Anda dapat menggunakannya --date-range atau -d dan menentukan hari ini, minggu ini, atau bulan ini, sehingga fungsi pencarian tren GitHub akan digunakan untuk menemukan repo populer dan memberi tahu Anda berapa banyak bintang yang diperoleh hari/minggu/bulan ini tergantung pada opsi yang Anda gunakan.
starcli -d this-week
Perhatikan bahwa opsi (seperti --spoken-language ) seperti --topics , --pushed , --created tidak akan berlaku karena -d menggunakan mekanisme pencarian yang berbeda untuk menemukan hasil.
Tidak suka default 7? Anda dapat mengubahnya menjadi sesuatu yang lain, menggunakan --limit-results atau -r diikuti oleh bilangan bulat:
starcli -r 2
Di atas hanya akan memberi Anda dua repo. Ini berguna jika Anda ingin memasukkannya ke fungsi .bashrc , .zshrc , atau fish_greeting Anda.
Cukup tambahkan starcli -r 3 -L grid di sana, dan setiap kali Anda membuka terminal Anda, Anda akan menemukan 3 repo tren yang dicetak dengan rapi dalam format kisi, cara yang bagus untuk memulai hari Anda (sedikit seperti ekstensi tab hacker).
Output hasil dapat ditampilkan melalui pager OS Anda menggunakan flag --pager / -p .
Jika Anda menggunakan lebih sedikit, tambahkan R ke variabel lingkungan LESS sehingga warna dan gaya dapat ditampilkan dengan benar.
Batas tarif dapat dipukul jika Starcli mengirimkan banyak permintaan berulang ke GitHub dalam waktu singkat.
Untuk menghindari hal ini, berikan token otentikasi menggunakan --auth :
starcli --auth 'username:token'
Baca lebih lanjut tentang token otentikasi di dokumen gitub
Untuk Pedoman yang Berkontribusi dan Cara Menyiapkan Lingkungan Pengembangan Anda, Baca CONTRIBUTING.md . Ingatlah bahwa semua kontribusi untuk proyek ini harus mengikuti kode perilaku.
rich (dengan klik dan colorama)requests Terima kasih kepada semua orang yang luar biasa ini (Kunci Emoji):
Shagilton | hexbee ? | Sam Wellander | Shivam Sinha | Will McGugan | Ashik JM | Yu-Lin Chao |
Saif Kazi | Arcanearronax | jsadoski | Odmishien (Tetsuya Mishima) | Neel Shah | 0xflotus | Akash Dhanwani |
Ed Davis | Jeff Chiang | Dmitry Kankalovich |
Proyek ini mengikuti spesifikasi semua-kontributor. Kontribusi apa pun yang baik!
Proyek ini bercabang dari githunt (Python) dan niat awalnya adalah untuk menulis ulang proyek itu untuk menggunakan Rich alih -alih Colorama + Tabulate, tetapi sekarang memiliki fitur yang jauh lebih banyak daripada sebelumnya, berkat kontribusi semua orang?
