Using pip

pip install gitsuggest

Directly from the repository

git clone --recursive https://github.com/csurfer/gitsuggest.git
python gitsuggest/setup.py install

As a command

# For help with usage
gitsuggest --help

# With just username in command to provide password secretly
gitsuggest <username>

# Password can be skipped which means you chose to go the unauthenticated
# way which may raise RateLimitExceeded exception. To skip password enter
# nothing when prompted for password and press enter.

# NOTE: Using it this way generates a static html page with the search
# results. This gets opened it in your default browser.

# To fetch better suggestions at the cost of extra time and calls
gitsuggest <username> --deep_dive

# Without the --deep_dive flag we limit the suggestion to consider only
# the repositories you have starred. With --deep_dive we also consider
# repositories which people you follow have starred.

As a module

from gitsuggest import GitSuggest

# To use with username password combination
gs = GitSuggest(username=<username>, password=<password>)

# To use with access_token
gs = GitSuggest(token=access_token)

# To use without authenticating
gs = GitSuggest(username=<username>)

# To use with deep dive flag
gs = GitSuggest(username=<username>, password=<password>, token=None, deep_dive=True)
gs = GitSuggest(token=access_token, deep_dive=True)
gs = GitSuggest(username=<username>, deep_dive=True)

# To get an iterator over suggested repositories.
gs.get_suggested_repositories()

Bug Reports and Feature Requests

Please use issue tracker for reporting bugs or feature requests.

Development

Pull requests are most welcome.

Buy the developer a cup of coffee!

If you found the utility helpful you can buy me a cup of coffee using