clpo13 / starstruck

Get a user's GitHub repos ordered by number of stars

starstruck

Gets a list of a user's GitHub repositories ordered by how many stars the repo has using the GitHub GraphQL API v4.

Prerequisites

Requires Python 3.6+. Installing with Poetry is optional but highly recommended.

If you don't want to mess around with that, you can install the dependency Requests directly with pip or your package manager (e.g. apt on Debian or Ubuntu):

pip3 install --user requests       # user-only
py -3 -m pip install requests      # Windows
sudo apt install python3-requests  # system-wide

Running

First, set an environment variable containing a GitHub personal access token with at least the public_repo scope (full repo access will also show stars for private repositories you have access to):

export GH_TOKEN=a1b2c3  # bash, ksh, zsh
set -x GH_TOKEN a1b2c3  # fish
setenv GH_TOKEN a1b2c3  # csh, tcsh

On Windows:

$Env:GH_TOKEN = "a1b2c3"  # PowerShell
set GH_TOKEN=a1b2c3       # cmd.exe

Then, create the virtualenv, install dependencies, and run the script:

poetry install
poetry run starstruck clpo13

You can also open a shell in the virtualenv with poetry shell. If you're not using Poetry, or if you're in the virtualenv shell, simply run the script directly:

./starstruck.py clpo13        # Linux/BSD/macOS
py -3 .\starstruck.py clpo13  # Windows

The script will print the names and number of stargazers of up to twenty repositories belonging to the specified user, with the most-starred repo first.

License

Copyright (c) 2019 Cody Logan. Released under the MIT License.