{"id":27835,"library":"ghtopdep","title":"ghtopdep","description":"A CLI tool to list and sort GitHub dependent repositories and packages by star count, helping to identify the most popular dependents of a given repository or package. Version 0.4.3, last release in 2023, stable with low maintenance.","status":"maintenance","version":"0.4.3","language":"python","source_language":"en","source_url":"https://github.com/github-tooling/ghtopdep","tags":["cli","github","dependents","stars","top-dep"],"install":[{"cmd":"pip install ghtopdep","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"The package is a CLI tool, import only if using programmatically; direct 'import ghtopdep' may work but the entry point is the CLI.","wrong":"import ghtopdep","symbol":"ghtopdep","correct":"from ghtopdep import ghtopdep"}],"quickstart":{"code":"from ghtopdep import ghtopdep\nghtopdep.main(['--repo', 'tensorflow/tensorflow', '--limit', '5'])","lang":"python","description":"Get the top 5 most-starred dependents of tensorflow/tensorflow (as a Python function call)."},"warnings":[{"fix":"Add '--type repo' to limit to GitHub repositories.","message":"The output includes both repositories and packages (PyPI, npm) by default, which may mix GitHub repos with package registries. Use '--type repo' or '--type package' to filter.","severity":"gotcha","affected_versions":">=0.1.0"},{"fix":"Use the command-line tool: 'ghtopdep --repo tensorflow/tensorflow'","message":"The library previously had a different CLI entry point (ghtopdep as a module) but now recommends using the 'ghtopdep' command directly in terminal. Calling as a Python function is not officially documented.","severity":"deprecated","affected_versions":">=0.4.0"},{"fix":"Export GITHUB_TOKEN or GA_TOKEN environment variable with a GitHub personal access token before running.","message":"GitHub API rate limits can cause failures for large queries. The tool does not have built-in authentication token support; you must set GH_TOKEN environment variable manually.","severity":"gotcha","affected_versions":">=0.1.0"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Use: from ghtopdep import ghtopdep","cause":"Trying to import the function incorrectly; the correct import is 'from ghtopdep import ghtopdep'.","error":"ImportError: cannot import name 'ghtopdep' from 'ghtopdep'"},{"fix":"Use correct format: 'owner/repo' (e.g., 'tensorflow/tensorflow')","cause":"The repository format must be 'owner/repo' or full URL.","error":"Error: Invalid value for '--repo': 'invalid/repo'"},{"fix":"Set GITHUB_TOKEN environment variable with a personal access token to increase rate limit.","cause":"Hit GitHub API rate limit without authentication.","error":"rate limit exceeded (403)"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}