starcli
1.0.0
___ ______ _ ____ ____ _ _
/ * | | / | | / | * | |
| | / | |* / | | | | | |
| | /-- | | | | | | | |
*_./ ._| / ._ |_| _ .|__. |_|_. |_|
Procure projetos de tendência no github da sua linha 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.
Alterne os layouts usando --layout {list|table|grid} ou use a opção curta -L
lista
mesa
grade
Todas as três opções de layout suportam links clicáveis para nomes do repositório. Se o seu terminal suportar links, você poderá clicar diretamente no nome e ele o levará ao repositório do GitHub no seu navegador.
Por exemplo, você deseja encontrar apenas repositões populares de Python: usando --lang ou -l :
starcli --lang python
Aqui está outro exemplo de starcli -l python -L grid , que é Python com layout da grade:
Se você quiser encontrar repositórios em seu idioma nativo, pode usar --spoken-language ou -S :
starcli --spoken-language zh
O comando acima lista os repositórios escritos em chinês.
Uma lista completa de códigos de linguagem está disponível aqui
Observe que (como com --date-range ) As opções como --topics , --pushed , --created não terão efeito porque -d usa um mecanismo de pesquisa diferente para encontrar resultados.
(Recomendado para ser usado com --created )
O intervalo padrão é> = 100 estrelas.
Use --stars ou -s para especificar o que você deseja, por exemplo, se você deseja encontrar repositórios com mais de 100 estrelas, você pode usar:
starcli -s '>100'
Observe que, se você fizer algo como >1000 muitos repositórios não podem ter mais de 1000 e for criado em cerca de 200 dias (que é o padrão para --created ), para especificar a data da criação, use --created , veja abaixo.
Você pode ver o número de estrelas que um repo recebeu hoje, esta semana ou este mês usando a opção --date-range ou -d :
starcli -d this-week -L table
Este comando também exibirá o número de estrelas recebidas para cada repo esta semana na forma de uma tabela.
-d usa a pesquisa de tendências do GitHub por repositórios, portanto, opções --topic , --pushed , --created não terão efeito.
--created / -c Aceita uma data no formato ISO8601: AAAYYY-MM-DD
Por exemplo, para repositórios criados em 1º de janeiro de 2014, use:
starcli --created 2014-01-01
Para procurar repositórios criados em ou após 1º de janeiro de 2014, use:
starcli --created '>=2014-01-01'
Esta opção permite filtrar por tópicos. Você pode usar --topics ou -t para incluir um tópico na pesquisa.
Esta opção pode ser usada várias vezes.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Use --pushed / -p quando você deseja encontrar repositórios populares que sejam atualizados pela última vez em uma determinada data, digamos 2020-01-01 para 1º de janeiro de 2020:
starcli -p 2020-01-01
Você também pode prefixar o valor com "> = <" como:
starcli -p '>=2020-01-01'
Estes são os repositórios do Find que pressionaram pela última vez após ou em 1º de janeiro de 2020.
Leia mais sobre o> = <sintaxe nos documentos do GitHub.
Recomendado para ser usado com --stars e/ou --date-created .
Encontrar projetos de tendências pelo nome de usuário do github também é suportado. Use --user ou -u para fazê -lo.
Basta fornecer um nome de usuário do github válido depois dele, como:
starcli -u torvalds
starcli -u gvanrossum
Você pode usar --date-range ou -d e especificar hoje, nesta semana ou neste mês, para que a função de pesquisa de tendências do GitHub seja usada para encontrar repositórios populares e dizer quantos estrelas são obtidas neste dia/semana/mês, dependendo da opção que você usou.
starcli -d this-week
Observe que as opções (como --spoken-language ) como --topics , --pushed , --created não terão efeito porque -d usa um mecanismo de pesquisa diferente para encontrar resultados.
Não gosta do padrão 7? Você pode alterá -lo para outra coisa, usando --limit-results ou -r seguido por um número inteiro:
starcli -r 2
O exposto acima só lhe dará dois repositórios. Isso é útil se você deseja colocá -lo na função .bashrc , .zshrc ou fish_greeting .
Basta adicionar starcli -r 3 -L grid lá e, toda vez que você abrir seu terminal, você encontrará 3 repositórios de tendência impressos em um formato de grade, ótima maneira de começar o seu dia (um pouco como a extensão da guia Hacker).
A saída de resultado pode ser exibida através do seu Pager usando o sinalizador --pager / -p .
Se você estiver usando menos, adicione R à sua variável de ambiente LESS para que as cores e o estilo possam ser exibidos corretamente.
O limite de taxa pode ser atingido se o Starcli enviar muitas solicitações repetidas ao GitHub dentro de um curto perod do tempo.
Para evitar isso, forneça um token de autenticação usando --auth :
starcli --auth 'username:token'
Leia mais sobre tokens de autenticação nos documentos do Github
Para diretrizes contribuintes e como configurar seu ambiente de desenvolvimento, leia CONTRIBUTING.md . Lembre -se de que todas as contribuições para este projeto devem seguir seu código de conduta.
rich (com clique e colorama)requests Obrigado a todas essas pessoas maravilhosas (key emoji):
Shagilton | Hexbee ? | Sam Wellander | Shivam Sinha | Will McGugan | Ashik JM | Yu-lin chao |
Saif Kazi | Arcanoarronax | Jsadoski | Odmishien (Tetsuya Mishima) | Neel Shah | 0xflotus | Akash Dhanwani |
Ed Davis | Jeff Chiang | Dmitry Kankalovich |
Este projeto segue a especificação de todos os contribuintes. Contribuições de qualquer tipo de boas -vindas!
Este projeto foi bifurcado por githunt (Python) e sua intenção inicial era reescrever esse projeto para usar rico em vez de colorama + tabulou, mas agora tem muito mais recursos do que antes, graças às contribuições de todos?
