Browse trending projects on Github from your command line 💻
Prerequisites
- Requires Python 3.6 or greater
Installation
pip install starcli
Remember to use pip3 instead of pip if you also have Python 2 installed on your system
Usage
Usage: starcli [OPTIONS]
Browse trending repos on GitHub by stars
Options:
-l, --lang TEXT Language filter eg: python
-S, --spoken-language TEXT Spoken Language filter eg: en for English,
zh for Chinese, etc
-c, --created TEXT Specify repo creation date in YYYY-MM-DD,
prefixing with >, <= etc is allowed
-t, --topic TEXT Search by topic, can be specified multiple
times
-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 Amount of stars required, default is
'>=100'. Can use 123, <10, etc.
-r, --limit-results INTEGER Limit the number of results. Default: 7
-o, --order [desc|asc] Order of repos by stars shown, 'desc' or
'asc', default: desc
--long-stats Print the actual stats number (1300 instead
of 1.3k)
-d, --date-range [today|this-week|this-month]
View stars received within time range,
choose from: today, this-week, this-month
-u, --user TEXT Search for trending repositories by username
--debug Turn on debugging mode
--help Show this message and exit.
Layouts
Switch layouts using --layout {list|table|grid}, or use the short option -L
list
table
grid
Filtering by language
For example, you only want to find popular Python repos, you can use --lang or -l:
starcli --lang python
Here, we used starcli -l python -L grid, which is python with grid layout:
Filtering by spoken language
If you wanted to find repos in your native language, you can use --spoken-language or -S:
starcli --spoken-language zh
The above command lists down repos written in Chinese. A full list of language codes is available here
Note that (like --date-range) options like --topics, --pushed, --created won't take effect
because -d uses a different search mechanism to find results.
Specify the number (or range) of stars
(Recommended to be used with --created)
The default range is >=100, you can change that!
Use --stars or -s to specify what you want,
for example, if you want to find repos that has more than 100 stars, you can use:
starcli -s '>100'
Note that if you do something like >1000 not many repos can have
more than 1000 and is created within around 200 days,
to specify date of creation, use --created, see below.
Filter by stars daily, weekly or monthly
Wish to know what's trending this week?!
You can view the number of stars a repo received today, this week or this month by using the --date-range or -d option:
starcli -d this-week -L table
This command will also display the number of stars received for each repo this week in the form of a table.
Specify the date of creation
Want to find newer, older, or just created repos?
Just use --created or -c, and then
provide a date in ISO8601 format: yyyy-mm-dd
For example, for repos created on 1st January 2014, use:
starcli --created 2014-01-01
To search for repos that are created on or after 1st January 2014, use:
starcli --created '>=2014-01-01'
Filtering by topics
This option helps you to filter by topics. You can use --topics or -t to include
a topic in search.
This option can be used multiple times.
starcli -l python -d 2020-07-06 -t deep-learning -t pytorch
Specifying last pushed date
Use this --pushed or -p when you want to find popular repos that are
last updated on a given date, say 2020-01-01 for 1st of Jan
2020:
starcli -p 2020-01-01
You can also prefix the value with ">=<" like:
starcli -p '>=2020-01-01'
This is find repos that have last pushed after or on January the 1st, 2020. Read more about the >=< syntax: GitHub Docs
Searching by user
Recommended to be used with --stars and/or --date-created.
Finding trending projects by GitHub username is supported too. Use --user or -u to do so,
provide a valid GitHub username after that, like:
starcli -u hedythedev
starcli -u gvanrossum
Using date ranges
You can use --date-range or -d and specify today, this-week, or this-month,
so that GitHub Trending search function will be used to find popular repos
and tell you how much stars are gained this day/week/month depending on the
option you used.
starcli -d this-week
Note that (like --spoken-language) options like --topics, --pushed, --created won't take effect
because -d uses a different search mechanism to find results.
Limit the number of results shown
Don't like the default 7? You can change it to something else,
using --limit-results or -r followed by an integer:
starcli -r 2
The above will only give you two repos. This is useful if
you want to put it in your .bashrc, .zshrc, or fish_greeting function.
Just add starcli -r 3 -L grid in there, and every time you open your terminal,
you will find 3 trending repos printed neatly in a grid format, great way to start your
day (bit like the Hacker Tab Extension 😆 ).
Issues, feature request, and feedback
- Issues, bug reports, or feature request: Don't hesitate to open an issue in this repo
- Feedback: any general feedback or questions about using StarCLI you can leave a comment on our Product Hunt page, remember to be nice :)
Development 
For contributing guidelines and how to set up your development environment, please
read CONTRIBUTING.md.
Remember that all contributions to this project should follow its
CODE OF CONDUCT.
Uses
- CommandLine Argument parser: Click
- Colored and table console print:
rich(with click and colorama) - HTTP library to send requests:
requests
Contributors ✨
Thanks goes to all of these wonderful people (emoji key):
Shagilton 💻 |
hexbee 🐛 |
Sam Wellander 💻 |
Shivam Sinha 💻 |
Will McGugan 💻 |
Ashik J M 💻 |
Yu-Lin Chao 💻 |
Saif Kazi 💻 📖 |
arcanearronax ⚠️ 💻 |
jSadoski 📖 |
This project follows the all-contributors specification. Contributions of any kind welcome!
Credits
This project was forked from
githunt (python)
and its initial intention was to rewrite that project to use
Rich instead of colorama + tabulate, but now it has so much more features
than before, thanks everyone!
Liked this project? Don't forget to give it a ⭐
Metadata
Release files for starcli 2.14.2
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| starcli-2.14.2.tar.gz | 15.6 kB | Without provenance | Details for starcli-2.14.2.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| starcli-2.14.2-py3-none-any.whl | Python 3 | none | any | Details for starcli-2.14.2-py3-none-any.whl |
Total release size: 28.8 kB
Release files / starcli-2.14.2.tar.gz
| Download URL | starcli-2.14.2.tar.gz |
|---|---|
| Size | 15.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
06ddb3173c8b723b13f917197f087392a0758561b817c8032bf910ea92153401
|
|
BLAKE2b-256 checksum How to use checksums |
e427ed6fec09a92a3891ac0d9d6b6050005dd10ff54cc0995c027d8d5908de9f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.1 CPython/3.7.8
|
Release files / starcli-2.14.2-py3-none-any.whl
| Download URL | starcli-2.14.2-py3-none-any.whl |
|---|---|
| Size | 13.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c199f559009fd2e9b6a0d2924b2077a2d3028c3c328740dfee0e5d68c7950670
|
|
BLAKE2b-256 checksum How to use checksums |
25b921fd70a4ac73ef4c2d62ac70ce32911aaf7e0366381796e8538829a6e325
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.0 requests-toolbelt/0.9.1 tqdm/4.48.1 CPython/3.7.8
|
Security for starcli 2.14.2
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.