{"id":37085651,"url":"https://github.com/ddkasa/gh-random-star","last_synced_at":"2026-01-14T10:32:15.740Z","repository":{"id":220019046,"uuid":"750544962","full_name":"ddkasa/gh-random-star","owner":"ddkasa","description":"Simple CLI tool to fetch random starred repositories from a users GitHub profile.","archived":false,"fork":false,"pushed_at":"2025-06-16T07:41:39.000Z","size":220,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-19T01:17:43.870Z","etag":null,"topics":["cli","github","random"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/github-random-star/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ddkasa.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-30T20:56:20.000Z","updated_at":"2025-06-16T07:41:38.000Z","dependencies_parsed_at":"2024-06-19T19:44:33.428Z","dependency_job_id":"2a33ad40-537c-456d-b890-bb3e862481fe","html_url":"https://github.com/ddkasa/gh-random-star","commit_stats":null,"previous_names":["ddkasa/github-random-star"],"tags_count":12,"template":false,"template_full_name":null,"purl":"pkg:github/ddkasa/gh-random-star","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddkasa%2Fgh-random-star","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddkasa%2Fgh-random-star/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddkasa%2Fgh-random-star/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddkasa%2Fgh-random-star/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ddkasa","download_url":"https://codeload.github.com/ddkasa/gh-random-star/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ddkasa%2Fgh-random-star/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28417453,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-14T10:25:19.714Z","status":"ssl_error","status_checked_at":"2026-01-14T10:22:49.371Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","github","random"],"created_at":"2026-01-14T10:32:15.095Z","updated_at":"2026-01-14T10:32:15.725Z","avatar_url":"https://github.com/ddkasa.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ⭐️ GitHub Random Star ⭐️\n\n\u003ca href=\"https://pypi.org/project/github-random-star\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/github_random_star?style=for-the-badge\u0026logo=pypi\" /\u003e\u003c/a\u003e\n\u003ca href=\"https://pypi.org/project/github-random-star\"\u003e\u003cimg alt=\"PyPI - Python Version\" src=\"https://img.shields.io/pypi/pyversions/github-random-star?style=for-the-badge\"\u003e\u003c/a\u003e\n\u003ca href=\"https://github.com/ddkasa/gh-random-star/actions/workflows/pypi-publish.yml\"\u003e\u003cimg src=\"https://img.shields.io/github/actions/workflow/status/ddkasa/github-random-star/pypi-publish.yml?style=for-the-badge\"/\u003e\u003c/a\u003e\n\u003ca href=\"https://pypistats.org/packages/github-random-star\"\u003e\u003cimg src=\"https://img.shields.io/pypi/dm/github-random-star?style=for-the-badge\" /\u003e\u003c/a\u003e\n\n![](docs/example_image.png?raw=true)\n\n\u003e If you have starred way too many GitHub repositories and need a way of keeping track of them. This simple CLI tool throws you quasi random starred repos at you to look at and explore.\n\n\u003e If you are struggling with selection paralysis; it also allows for selecting random repositories from a GitHub user.\n\n## Installation\n\n#### Install with [Pipx](https://github.com/pypa/pipx) or Pip.\n\n```\npipx install github-random-star\n```\n\n#### Install with [GitHub CLI](https://github.com/cli/cli).\n\n```\ngh extension install ddkasa/gh-random-star\n```\n\n## Usage\n\n- Setup GitHub API token as the `GITHUB_TOKEN` environment variable. _If this is not setup it will use the public access point with lower rates._\n\n### PyPi\n\n- Run the script through `gh-star \u003ccommand\u003e \u003caccount\u003e \u003cflags\u003e`.\n- Run `gh-star help star` to get help.\n\n### GitHub CLI\n\n- Run the script through `gh random-star \u003ccommand\u003e \u003caccount\u003e \u003cflags\u003e`.\n- Run `gh random-star help star` to get help.\n\n### Commands\n\n1. `star` Randomly select from all starred items of a GH user.\n2. `repo` Randomly select from a GH users repositories.\n\n### Arguments\n\n- `\u003caccount\u003e` Username of the GitHub account to retrieve the starred items from. **Required**\n\n### Flags\n\n- `-t, --total` Total amount of random items you want to pick from. Defaults to 3.\n- `-r, --refresh` Whether to fetch new cached data or not. Will re fetch all starred items instead of using cache.\n- `--max-history` The amount of historic choices to cache. Defaults to 100. Set to **-1** to keep history unlimited. `GH_STAR_MAX_HISTORY` environment variable can be used to override this value.\n- `-i, --ignore` If to use a list of repositories to ignore. Defaults to true.\n- `--max_results` The amount of starred items to retrieve from GitHub. Defaults to all.\n\n### Examples\n\n##### PyPI\n\n- `gh-star star ddkasa`\n- `gh-star repo ddkasa`\n- `gh-star star ddkasa -t 5`\n- `gh-star star ddkasa -r -t 5`\n\n##### GitHub CLI\n\n- `gh random-star star ddkasa`\n- `gh random-star repo ddkasa`\n\n## Contributing\n\nDevelopment is run through [Poetry](https://github.com/python-poetry/poetry).\n\n### Basic Setup\n\n1. `git clone https://github.com/ddkasa/github-random-star`\n2. `cd github-random-star`\n3. `poetry shell`\n4. `poetry install`\n5. `poetry run gh-star`\n\n- Lint with `ruff check toggl_api`\n- Check typing with `mypy toggl_api`\n\n### Testing\n\n- Use `pytest` for all tests\n- Use `pytest -m unit` for unit tests\n- Use `pytest -m integration` for integration tests\n- Test all supported python versions through `tox`\n\n## License\n\nMIT. Look at the [LICENSE](LICENSE.md) for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddkasa%2Fgh-random-star","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fddkasa%2Fgh-random-star","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fddkasa%2Fgh-random-star/lists"}