gcop 1.2.0

gcop is your git AI copilot.

Gcop is your git AI copilot. You can use any large language model to help automate the generation of commit messages.

Features

• Generate commit messages by large language models.
• Easily config your language model.
• Powerful and simple alias commands to use.

TECH

• Promptulate: Large language model automation and Autonomous Language Agents development framework
• P3G: Python Packages Project Generator
• Gamma: Generate gcop Banner here
• gpt-4o: Generate project code

Video Demo

Quick Start

• Install gcop

pip install gcop

• If you are first time to use gcop, you need to run the gcop init command to initialize the configuration. This command will alias gcop command on your git.

gcop init

Basic Usage

Run the git ghelp command to get help information and show all gcop commands.

gcop is your local git command copilot
Version: 1.0.0
GitHub: https://github.com/Undertone0809/gcop


Usage: git [OPTIONS] COMMAND

Commands:
  git undo       Undo the last commit but keep the file changes
  git pf         Push the changes to the remote repository with force
  git ghelp      Add command into git config
  git gconfig    Open the config file in the default editor
  git gcommit    Generate a git commit message based on the staged changes and commit the changes
  git c          The same as `git gcommit` command

Config your language model

Before you generate a commit message, you need to config your language model. You can use any large language model to generate commit messages. The following example shows how to config the language model.

git gconfig

Then gcop will generate a config.yaml, then gcop will open the config.yaml file in the default editor, and you can config your language model. See how to config your model here:

config.yaml store path:

• Windows: %USERPROFILE%\.gcop\config.yaml
• Linux: ~/.gcop/config.yaml
• MacOS: ~/.gcop/config.yaml

Generate commit message

The following example show how to use gcop to generate a commit message.

git add .
git gcommit

Video Demo

This video shows how to use gcop to generate a commit message.

All commands

git gcommit / git c

Generate a git commit message based on the staged changes and commit the changes.

> git c # You can also use `git gcommit` command
? Select a commit message to commit (Use arrow keys)
 » docs: Add 'All commands' section to README.md
   feat: Add 'git gcommit' and 'git gconfig' commands to README.md
   feat: Add 'git config --global alias.pf' command in __main__.py
   retry

git gconfig

Open the config file in the default editor.

git undo

Undo the last commit.

git pf

Push force to the current branch, equivalent to git push --force.

Development setup

Conda package manager is recommended. Create a conda environment.

conda create -n gcop python==3.10

Activate conda environment and install poetry

conda activate gcop
pip install poetry

Then you can run the client using the following command:

gcop --help

or with Poetry:

poetry run gcop --help

Makefile usage

Makefile contains a lot of functions for faster development.

Install all dependencies and pre-commit hooks

Install requirements:

make install

Pre-commit hooks coulb be installed after git init via

make pre-commit-install

Codestyle and type checks

Automatic formatting uses ruff.

make polish-codestyle

# or use synonym
make formatting

Codestyle checks only, without rewriting files:

make check-codestyle

Note: check-codestyle uses ruff and darglint library

Code security

If this command is not selected during installation, it cannnot be used.

make check-safety

This command launches Poetry integrity checks as well as identifies security issues with Safety and Bandit.

make check-safety

Tests with coverage badges

Run pytest

make test

All linters

Of course there is a command to run all linters in one:

make lint

the same as:

make check-codestyle && make test && make check-safety

Docker

make docker-build

which is equivalent to:

make docker-build VERSION=latest

Remove docker image with

make docker-remove

More information about docker.

Cleanup

Delete pycache files

make pycache-remove

Remove package build

make build-remove

Delete .DS_STORE files

make dsstore-remove

Remove .mypycache

make mypycache-remove

Or to remove all above run:

make cleanup

🛡 License

This project is licensed under the terms of the MIT license. See LICENSE for more details.

Contact

For more information, please contact: [e-mail]

See anything changelog, describe the telegram channel

Credits

This project was generated with P3G