starcli
1.0.0
___ ______ _ ____ ____ _ _
/ * | | / | | / | * | |
| | / | |* / | | | | | |
| | /-- | | | | | | | |
*_./ ._| / ._ |_| _ .|__. |_|_. |_|
Просмотрите трендовые проекты на GitHub из вашей командной строки $ _
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.
Переключатели с использованием --layout {list|table|grid} , или используйте короткую опцию -L
список
стол
сетка
Все три параметра макета поддерживают кликабельные ссылки для имен репозитория. Если ваш терминал поддерживает ссылки, вы можете напрямую нажать на имя, и он перенесет вас в репозиторий GitHub в вашем браузере.
Например, вы хотите только найти популярные репозитовы Python: использование --lang или -l :
starcli --lang python
Вот еще один пример starcli -l python -L grid , которая представляет собой Python с макетом сетки:
Если вы хотите найти репо на своем родном языке, вы можете использовать --spoken-language или -S :
starcli --spoken-language zh
Приведенная выше команда перечисляет репо, написанные на китайском языке.
Полный список языковых кодов доступен здесь
Обратите внимание, что (как и в случае с --date-range ), таких как --topics , --pushed , --created не вступит в силу, потому что -d использует другой механизм поиска, чтобы найти результаты.
(Рекомендуется использовать с --created )
Диапазон по умолчанию составляет> = 100 звезд.
Используйте --stars или -s , чтобы указать, что вы хотите, например, если вы хотите найти репо, в которых более 100 звезд вы можете использовать:
starcli -s '>100'
Обратите внимание, что если вы делаете что -то вроде >1000 не так много репо, может иметь более 1000 и создается в течение примерно 200 дней (что является дефолтом для --created ), чтобы указать дату создания, использование --created , см. Ниже.
Вы можете просмотреть количество звезд, полученных сегодня, на этой неделе или в этом месяце, используя вариант --date-range или -d :
starcli -d this-week -L table
Эта команда также отобразит количество звезд, полученных для каждого репо на этой неделе в виде таблицы.
-d использует поиск в тренде Github для репозиториев, следовательно, варианты --topic , --pushed , --created не вступит в силу.
--created / -c принимает дату в ISO8601 Формат: yyyy-mm-dd
Например, для репо, созданных 1 января 2014 года, используйте:
starcli --created 2014-01-01
Для поиска репо, которые создаются 1 января 2014 года или после этого , используйте:
starcli --created '>=2014-01-01'
Эта опция позволяет вам фильтровать по темам. Вы можете использовать --topics или -t , чтобы включить тему в поиск.
Эта опция можно использовать несколько раз.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Используйте --pushed / -p , когда вы хотите найти популярные репо, которые в последний раз обновляются в данную дату, скажем, 2020-01-01 за 1 января 2020 года:
starcli -p 2020-01-01
Вы также можете префикс значения с "> = <" like:
starcli -p '>=2020-01-01'
Это нахождение репо, которые в последний раз продвигались после или 1 января, 2020 года.
Узнайте больше о> = <синтаксис на GitHub Docs.
Рекомендуется использовать с --stars и/или --date-created .
Поиск трендовых проектов Github также поддерживается. Используйте --user или -u для этого.
Просто предоставьте действительное имя пользователя GitHub после этого, например:
starcli -u torvalds
starcli -u gvanrossum
Вы можете использовать --date-range или -d и указать сегодня, в неделю или этот месяц, чтобы функция поиска в тренде GitHub будет использоваться для поиска популярных репо и сообщить вам, сколько звезд получено в этот день/неделю/месяц в зависимости от варианта, который вы использовали.
starcli -d this-week
Обратите внимание, что (например, --spoken-language ), такие как --topics , --pushed , --created не вступит в силу, потому что -d использует другой механизм поиска, чтобы найти результаты.
Не нравится дефолт 7? Вы можете изменить его на что -то другое, используя --limit-results или -r , а затем целое число:
starcli -r 2
Вышеуказанное даст вам только два репо. Это полезно, если вы хотите поместить его в свою функцию .bashrc , .zshrc или fish_greeting .
Просто добавьте там starcli -r 3 -L grid , и каждый раз, когда вы откроете свой терминал, вы найдете 3 репо, аккуратно напечатанные в формате сетки, отличный способ начать свой день (немного похоже на расширение вкладки Hacker).
Выход результата может отображаться через пейджер вашей ОС с помощью флага --pager / -p .
Если вы используете меньше, добавьте R в вашу LESS переменную среды, чтобы можно было правильно отображаться цвета и стиль.
Предел ставки может быть достигнут, если StarCli отправит много повторяющихся запросов на GitHub в течение короткого периода времени.
Чтобы избежать этого, предоставьте токен аутентификации, используя --auth :
starcli --auth 'username:token'
Узнайте больше о токенах аутентификации на документах GitHub
Для внесения руководящих принципов и того, как настроить вашу среду разработки, пожалуйста, прочитайте CONTRIBUTING.md . Помните, что все вклады в этот проект должны следовать его кодексу поведения.
rich (с щелчком и колорамой)requests Спасибо всем этим замечательным людям (ключ смайликов):
Шагилтон | шестнадцатеричный ? | Сэм Велландер | Шивам Синха | Уилл МакГуган | Ashik JM | Ю-Лин Хао |
Саиф Кази | ArcAnearronax | Jsadoski | Odmishien (Tetsuya mishima) | Нил Шах | 0xflotus | Акаш Дханвани |
Эд Дэвис | Джефф Чиан | Дмитрий Канкалович |
Этот проект следует за спецификацией всех контролей. Взносы любого вида приветствуются!
Этот проект был разветвлен от githunt (Python), и его первоначальное намерение состояло в том, чтобы переписать этот проект, чтобы использовать Rich, а не Colorama + Tabulate, но теперь у него гораздо больше функций, чем раньше, благодаря вкладам каждого?
