All-in-one CLI to commit your work to Github [Presentation, Design]
pip install g3
You can, optionally, create the alias g=g3
so that you execute simply g commit
and g pr
.
g3 configure
You will be asked to enter:
- your Github token
- your open-ai key
- the openai model you want to use
- the temperature which will be used to generate the commit messages and PR descriptions
- the openai api version
- the tone which will be used in the commit messages and PR descriptions
- the commit message max characters
- the PR description max words
g3 commit
- --tone: The tone to use
- --jira: The jira ticket(s) to reference
- --include: A phrase you want to include
- --edit: The hash of the commit you want to rephrase
g3 pr
- --tone: The tone to use
- --jira: The jira ticket(s) to reference
- --include: A phrase you want to include
- --edit: The number of the PR you want to rephrase
The project requires Python 3.11
and Poetry for dependency management.
Optionally configure poetry to create the virtual environment within the project as follows:
poetry config virtualenvs.in-project true
Now install the project, along with its development dependencies, in a local virtual environment as follows:
poetry install
You may enable the virtual environment, so that you run modules without the poetry run
prefix, as follows:
source `poetry env info -p`/bin/activate
or simply as follows:
poetry shell
You are expected to enable pre-commit hooks so that you get your code auto-sanitized before being committed.
- mypy: Static type checker of variables and functions based on PEP 484
- isort: Optimizes imports
- black: Opinionated code formatter based on PEP 8
- flake8: Improves code style and quality based on PEP 8
Install pre-commit before starting to contribute to the project as follows:
pre-commit install