starcli
1.0.0
___ ______ _ ____ ____ _ _
/ * | | / | | / | * | |
| | / | |* / | | | | | |
| | /-- | | | | | | | |
*_./ ._| / ._ |_| _ .|__. |_|_. |_|
Explore proyectos de tendencia en GitHub desde su línea de comando $ _
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.
Cambiar diseños usando --layout {list|table|grid} , o use la opción corta -L
lista
mesa
red
Las tres opciones de diseño admiten enlaces haciendo clic para nombres de repositorio. Si su terminal admite enlaces, puede hacer clic directamente en el nombre y lo llevará al repositorio de GitHub en su navegador.
Por ejemplo, solo desea encontrar reposos de pitón populares: usando --lang o -l :
starcli --lang python
Aquí hay otro ejemplo starcli -l python -L grid , que es Python con diseño de cuadrícula:
Si desea encontrar Repos en su idioma nativo, puede usar --spoken-language o -S :
starcli --spoken-language zh
El comando anterior enumera los reposos escritos en chino.
Una lista completa de códigos de idiomas está disponible aquí
Tenga en cuenta que (como con las opciones --date-range ) como --topics , --pushed , --created no entrará en vigencia porque -d usa un mecanismo de búsqueda diferente para encontrar resultados.
(Recomendado para usarse con --created )
El rango predeterminado es> = 100 estrellas.
Use --stars o -s para especificar lo que desea, por ejemplo, si desea encontrar reposuras que tengan más de 100 estrellas, puede usar:
starcli -s '>100'
Tenga en cuenta que si hace algo como >1000 no muchos repos pueden tener más de 1000 y se crea dentro de alrededor de 200 días (que es el valor predeterminado para --created ), para especificar la fecha de la creación, usar --created , ver más abajo.
Puede ver el número de estrellas que se recibió hoy, esta semana o este mes utilizando la opción --date-range o -d :
starcli -d this-week -L table
Este comando también mostrará el número de estrellas recibidas para cada repositorio esta semana en forma de tabla.
-d utiliza la búsqueda de tendencias de GitHub para repositorios, por lo tanto, opciones --topic , --pushed , --created no tendrá efecto.
--created / -c acepta una fecha en formato ISO8601: aaa yyy-mm-dd
Por ejemplo, para los repos creados el 1 de enero de 2014, use:
starcli --created 2014-01-01
Para buscar reposuras que se crean a partir del 1 de enero de 2014, use:
starcli --created '>=2014-01-01'
Esta opción le permite filtrar por temas. Puede usar --topics o -t para incluir un tema en la búsqueda.
Esta opción se puede usar varias veces.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Use --pushed / -p Cuando desee encontrar reposores populares que se actualicen por última vez en una fecha determinada, digamos 2020-01-01 para el 1 de enero de 2020:
starcli -p 2020-01-01
También puede prefijo el valor con "> = <" como:
starcli -p '>=2020-01-01'
Esto es encontrar reposuras que han empujado por última vez después o el 1 de enero del 1 de 2020.
Lea más sobre la> = <sintaxis en los documentos de GitHub.
Recomendado para ser utilizado con --stars y/o --date-created .
Encontrar proyectos de tendencia por el nombre de usuario de GitHub también es compatible. Use --user o -u para hacerlo.
Simplemente proporcione un nombre de usuario de GitHub válido después de él, como:
starcli -u torvalds
starcli -u gvanrossum
Puede usar --date-range o -d y especificar hoy, esta semana o este mes, de modo que la función de búsqueda de tendencias de GitHub se utilizará para encontrar repos populares y decirle cuántas estrellas se obtienen este día/semana/mes dependiendo de la opción que usó.
starcli -d this-week
Tenga en cuenta que (como --spoken-language ) como --topics , --pushed , --created no entrará en vigencia porque -d usa un mecanismo de búsqueda diferente para encontrar resultados.
¿No te gusta el 7 predeterminado? Puede cambiarlo a otra cosa, usando --limit-results o -r seguido de un entero:
starcli -r 2
Lo anterior solo te dará dos repos. Esto es útil si desea ponerlo en su función .bashrc , .zshrc o fish_greeting .
Simplemente agregue starcli -r 3 -L grid allí, y cada vez que abra su terminal, encontrará 3 repos tendencias impresas perfectamente en un formato de cuadrícula, excelente manera de comenzar su día (un poco como la extensión de la pestaña del hacker).
La salida de resultados se puede mostrar a través de su buscapersonas utilizando el indicador --pager / -p .
Si está utilizando menos, agregue R a su variable LESS de entorno para que los colores y el estilo se puedan mostrar correctamente.
El límite de tarifa puede ser alcanzado si Starcli envía muchas solicitudes repetidas a GitHub dentro de un breve Peroeto de tiempo.
Para evitar esto, proporcione un token de autenticación usando --auth :
starcli --auth 'username:token'
Lea más sobre tokens de autenticación en documentos de Github
Para las pautas de contribución y cómo configurar su entorno de desarrollo, lea CONTRIBUTING.md . MD. Recuerde que todas las contribuciones a este proyecto deberían seguir su código de conducta.
rich (con clic y colorama)requests Gracias a todas estas personas maravillosas (clave 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 |
Este proyecto sigue la especificación de todos los contribuyentes. ¡Contribuciones de cualquier tipo bienvenido!
Este proyecto fue bifurcado de githunt (Python) y su intención inicial era reescribir ese proyecto para usar Rich en lugar de Colorama + Tabule, pero ahora tiene muchas más funciones que antes, gracias a las contribuciones de todos.
