Find good first issues right from your CLI!
Project description
Good First Issues
Find good first issues right from your CLI!
Install Good First Issues
Requires Python 3.6.1 or higher.
pip3 install good-first-issues
The CLI uses the alias gfi
to run commands.
Contents
Create GitHub Personal Access Token:
The CLI requires GitHub Personal Access Token to make requests to the GitHub API.
You don't have to select any scopes, add a Note for your token and select Generate token.
Provide token to CLI:
gfi config
Token is stored locally on /home/<username>/.gfi/good-first-issues
file.
Usage
GitHub provides API using both REST and GraphQL, each with 5000 requests per hour with the Personal Access Token.
You can switch between these APIs but using the GraphQL option is faster and efficient!
There are two ways you can get good first issues:
- query all the repos in a user or an organization profile.
- query a particular repo in a user or an organization profile.
GraphQL
To use the GraphQL option use the gfi gql
command.
Query all the repos in a user or an organization profile.
# Query all repos in an organization
gfi gql "rust-lang"
# Query all repos in a user profile
gfi gql "sindresorhus" --user
Query a particular repo in a user or an organization profile.
# Query a single repo in an organization
gfi gql "rust-lang" --repo "rust"
# Query a single repo in a user profile
# No --user flag needed.
gfi gql "sindresorhus" --repo "awesome"
Changing output limits
The output is limited to display 10 issues by default. Use --limit
flag to set the number of issues for output or --all
for no limits.
# Limit the issues to 20
gfi gql "rust-lang" --limit 20
# View all issues found.
gfi gql "rust-lang" --all
Viewing issues on browser
It's hard to navigate through all the issues when you have the --all
flag enabled, you can view the issues on your browser with ease using the --web
flag.
gfi gql "rust-lang" --all --web
REST API
To use the GraphQL option use the gfi get
command.
Query all the repos in a user or an organization profile.
# Query all repos in an organization
gfi get "rust-lang"
# Query all repos in a user profile
gfi get "sindresorhus"
Changing output limits
The output is limited to display 10 issues by default. Use --limit
flag to set the number of issues for output or --all
for no limits.
# Limit the issues to 20
gfi get "rust-lang" --limit 20
# View all issues found.
gfi get "rust-lang" --all
Viewing issues on browser
It's hard to navigate through all the issues when you have the --all
flag enabled, you can view the issues on your browser with ease using the --web
flag.
gfi gql "rust-lang" --all --web
Contributing
For guidance on setting up a development environment and how to make a contribution to Flask, see the contributing guidelines.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for good_first_issues-1.2.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2eb6c7b06c7459a3efad267e691c9a3738f36d2109ea02b244934e8902f1d05f |
|
MD5 | c9843cfb019ea6f1eedce3be2902eb58 |
|
BLAKE2b-256 | 8f9914cb5d81d30c61696ecd0db9fde944dfb872d5ad8a60ccd164a4513f8647 |