starcli
1.0.0
___ ______ _ ____ ____ _ _
/ * | | / | | / | * | |
| | / | |* / | | | | | |
| | /-- | | | | | | | |
*_./ ._| / ._ |_| _ .|__. |_|_. |_|
Parcourez les projets de tendance sur github à partir de votre ligne de commande $ _
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.
Disposés de commutation à l'aide --layout {list|table|grid} , ou utilisez la courte option -L
liste
tableau
grille
Les trois options de mise en page prennent en charge les liens clickables pour les noms de référentiel. Si votre terminal prend en charge les liens, vous pouvez cliquer directement sur le nom et il vous emmènera au référentiel GitHub dans votre navigateur.
Par exemple, vous voulez seulement trouver des référentiels Python populaires: en utilisant --lang ou -l :
starcli --lang python
Voici un autre exemple starcli -l python -L grid , qui est Python avec la mise en page de la grille:
Si vous vouliez trouver des références dans votre langue maternelle, vous pouvez utiliser --spoken-language ou -S :
starcli --spoken-language zh
La commande ci-dessus répertorie les reposs écrits en chinois.
Une liste complète des codes linguistiques est disponible ici
Notez que (comme avec les options --date-range ) comme --topics , --pushed , --created ne prendra pas effet car -d utilise un mécanisme de recherche différent pour trouver des résultats.
(Recommandé d'être utilisé avec --created )
La plage par défaut est> = 100 étoiles.
Utilisez --stars ou -s pour spécifier ce que vous voulez, par exemple, si vous souhaitez trouver des références qui ont plus de 100 étoiles, vous pouvez utiliser:
starcli -s '>100'
Notez que si vous faites quelque chose comme >1000 pas beaucoup de dépôts peuvent avoir plus de 1000 et sont créés dans environ 200 jours (ce qui est la valeur par défaut pour --created ), pour spécifier la date de la création, l'utilisation --created , voir ci-dessous.
Vous pouvez voir le nombre d'étoiles qu'un dépôt a reçues aujourd'hui, cette semaine ou ce mois-ci en utilisant l'option --date-range ou -d :
starcli -d this-week -L table
Cette commande affichera également le nombre d'étoiles reçues pour chaque dépôt cette semaine sous la forme d'une table.
-d utilise la recherche de tendances github pour les référentiels, d'où les options --topic , --pushed , --created ne prendra pas effet.
--created / -c accepte une date au format ISO8601: yyyy-mm-dd
Par exemple, pour les reposs créés le 1er janvier 2014, utilisez:
starcli --created 2014-01-01
Pour rechercher des référentiels créés le 1er janvier 2014 ou après ou après : Utiliser:
starcli --created '>=2014-01-01'
Cette option vous permet de filtrer par sujets. Vous pouvez utiliser --topics ou -t pour inclure un sujet dans la recherche.
Cette option peut être utilisée plusieurs fois.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Utiliser --pushed / -p Lorsque vous souhaitez trouver des références populaires qui sont mises à jour pour la dernière fois à une date donnée, disons 2020-01-01 pour le 1er janvier 2020:
starcli -p 2020-01-01
Vous pouvez également préfixer la valeur avec "> = <" comme:
starcli -p '>=2020-01-01'
Ce sont des références qui ont poussé pour la dernière fois après ou le 1er janvier 2020.
En savoir plus sur le> = <syntaxe sur les documents GitHub.
Recommandé d'être utilisé avec --stars et / ou --date-created .
Trouver des projets tendance par le nom d'utilisateur GitHub est également pris en charge. Utilisez --user ou -u pour le faire.
Fournissez simplement un nom d'utilisateur GitHub valide après, comme:
starcli -u torvalds
starcli -u gvanrossum
Vous pouvez utiliser --date-range ou -d et spécifier aujourd'hui, cette semaine ou ce mois, afin que la fonction de recherche de tendance GitHub soit utilisée pour trouver des références populaires et vous dire combien d'étoiles sont gagnées ce jour / semaine / mois en fonction de l'option que vous avez utilisée.
starcli -d this-week
Notez que les options (comme --spoken-language ) comme --topics , --pushed , --created ne prendront pas effet car -d utilise un mécanisme de recherche différent pour trouver des résultats.
Vous n'aimez pas le 7 par défaut? Vous pouvez le changer en quelque chose d'autre, en utilisant --limit-results ou -r suivi d'un entier:
starcli -r 2
Ce qui précède ne vous donnera que deux dépositions. Ceci est utile si vous souhaitez le mettre dans votre fonction .bashrc , .zshrc ou fish_greeting .
Il suffit d'ajouter starcli -r 3 -L grid là-dedans, et chaque fois que vous ouvrez votre terminal, vous trouverez 3 reposs de tendances imprimées soigneusement dans un format de grille, une excellente façon de commencer votre journée (un peu comme l'extension de l'onglet pirate).
La sortie du résultat peut être affichée via votre téléavertisseur OS à l'aide de l'indicateur --pager / -p .
Si vous utilisez moins, ajoutez R à votre variable d'environnement LESS afin que les couleurs et le style puissent être affichés correctement.
La limite de taux peut être touchée si StarCli envoie de nombreuses demandes répétées à GitHub dans un court délai.
Pour éviter cela, fournissez un jeton d'authentification en utilisant --auth :
starcli --auth 'username:token'
En savoir plus sur les jetons d'authentification sur les documents GitHub
Pour contribuer aux directives et comment mettre en place votre environnement de développement, veuillez lire CONTRIBUTING.md . N'oubliez pas que toutes les contributions à ce projet doivent suivre son code de conduite.
rich (avec Click et Colorama)requests Merci à toutes ces personnes merveilleuses (clé 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 |
Ce projet suit les spécifications de tous les contributeurs. Contributions de toute nature bienvenue!
Ce projet a été transporté de githunt (Python) et son intention initiale était de réécrire ce projet à utiliser Rich au lieu de Colorama + Tabule, mais maintenant il a tellement plus de fonctionnalités qu'auparavant, grâce aux contributions de tous?
