/starred

creating your own Awesome List by GitHub stars!

Primary LanguagePythonMIT LicenseMIT

Starred

Travis CI Status

Install

starred requires Python version 3.x

$ git clone https://github.com/1132719438/starred
$ pip install ./starred
$ starred --username 1132719438 --output README.md

Highlight

  1. Output your starred repositories in table or list

    • Output table(default)
    starred --username <yourname> --output README.md [--type table]
    • Output list
    starred --username <yourname> --output README.md --type list
  2. Nice badges for total number of repositories and generated date

    See Stars

  3. Repositories can be sort by stars, starred date or name

    starred --username <yourname> --output README.md --sort stars/date/name
  4. Automatically create a repository for your stars, and update this repository when your stars changed, old stars will be archived. You can install starred, use scheduled tasks to automatically update your stars repository.

    • Synology NAS: use Task Scheduler to run following script
    LANG=en_US.UTF-8 GITHUB_TOKEN=<yourtoken> starred --username <yourname> --repository <repositoryname>
    • Linux: use crontab to run following script
    export GITHUB_TOKEN=<yourtoken>
    starred --username <yourname> --repository <repositoryname>
    • Windows: use Task Scheduler to run following script (Anaconda3 needed)
    @echo off
    C:\Users\<user>\AppData\Local\Continuum\anaconda3\Scripts\activate.bat C:\Users\<user>\AppData\Local\Continuum\anaconda3 & set GITHUB_TOKEN=<yourtoken> & starred --username <yourname> --repository <repositoryname>

Usage

$ starred --help

Usage: starred [OPTIONS]

  GitHub starred

  creating your own Awesome List used GitHub stars!

  example:     starred --username 1132719438 --output README.md

Options:
  --username TEXT           GitHub username  [required]
  --token TEXT              GitHub token
  --sort [stars|date|name]  sort by language with stars, date or name
  --repository TEXT         repository name
  --message TEXT            commit message
  --output TEXT             output file name with path(print to stdout if not
                            set)
  --http-proxy TEXT         http proxy (i.e. http://127.0.0.1:1080 or
                            socks5://127.0.0.1:1080)
  --https-proxy TEXT        https proxy (same as http proxy if not set)
  --launch                  launch to Github after update repository
  --type [table|list]       output repository information in table or list

Demo

# automatically create the repository
$ export GITHUB_TOKEN=<yourtoken>
$ starred --username <yourname> --repository <repositoryname>

FAQ

  1. Generate new token

    goto Personal access tokens

  2. Why do I need a token?

    • For unauthenticated requests, the rate limit is 60 requests per hour. see Rate Limiting
    • The token must be passed together when you want to automatically create the repository.