Starred

Install

$ pip install starred
$ starred --username maguowei --token=xxxxxxxx --sort > README.md

Usage

$ starred --help

Usage: starred [OPTIONS]

  GitHub starred

  creating your own Awesome List by GitHub stars!

  example:     starred --username maguowei --token=xxxxxxxx --sort > README.md

Options:
  --username TEXT        GitHub username  [required]
  --token TEXT           GitHub token  [required]
  --sort                 sort by category[language/topic] name alphabetically
                         [default: False]

  --topic                category by topic, default is category by language
                         [default: False]

  --topic_limit INTEGER  topic stargazer_count gt number, set bigger to reduce
                         topics number  [default: 500]

  --repository TEXT      repository name  [default: ]
  --filename TEXT        file name  [default: README.md]
  --message TEXT         commit message  [default: update stars]
  --private              include private repos  [default: False]
  --version              Show the version and exit.
  --help                 Show this message and exit.

Demo

# automatically create the repository
$ export GITHUB_TOKEN=yourtoken
$ starred --username yourname --repository awesome-stars --sort

maguowei/awesome-stars
update awesome-stars every day by GitHub Action the example with GitHub Action

Who uses starred?

by search: https://github.com/search?p=1&q=%22Generated+by+starred%22&type=Code
by topics:
- https://github.com/topics/starred
- https://github.com/topics/awesome-stars

Use awesome-stars as template

The simple way to create an awesome-stars repository is to use maguowei/awesome-stars as template. It will auto update your awesome-stars repository every day by GitHub Action.

Click Create a new repository from awesome-stars

use-awesome-stars-as-template

Setting the permissions of the GITHUB_TOKEN for your repository

set permissions to Read and write permissions and click Save button

workflow-permissions

Run the workflow first time

click Run workflow button

run-workflow

Customize the workflow schedule

.github/workflows/schedules.yml#L5

schedule

FAQ

Generate new token

link: Github Personal access tokens

Install the master branch version

$ poetry build 
$ pip install dist/starred-${x.x.x}.tar.gz

Dev & Run
```
poetry run starred --help
```

Metadata

Release files for starred 4.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for starred 4.3.0
File	Size	Uploaded
starred-4.3.0.tar.gz	6.2 kB	Jan 14, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for starred 4.3.0
File	Interpreter	ABI	Platform	Reset
starred-4.3.0-py3-none-any.whl 8.1 kB Jan 14, 2023	Python 3	none	any	Details

Total release size: 14.3 kB

Release files / starred-4.3.0.tar.gz

Download URL	starred-4.3.0.tar.gz
Size	6.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`ffda9ffcd6abe91c0a0607e9d91d19728914306078897c5dcedcca258ed0a7bf`
BLAKE2b-256 checksum How to use checksums	`7f81ff57599c09e10539ae0ae8f274803b6303f750f792e107240272797d6417`
Upload date	Jan 14, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.3.2 CPython/3.11.1 Linux/5.15.0-1030-azure`

Release files / starred-4.3.0-py3-none-any.whl

Download URL	starred-4.3.0-py3-none-any.whl
Size	8.1 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f50f2f07db97b8f9d52ed899ae304fbe57828dde6c66a78eeebfbae6289af050`
BLAKE2b-256 checksum How to use checksums	`66e0ac8181af2f28e92cfa2d8a340190a2dcc2b89083c581328db41a48e65e2a`
Upload date	Jan 14, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`poetry/1.3.2 CPython/3.11.1 Linux/5.15.0-1030-azure`