A tool to simplfy git operations
Project description
GitEase
A tool to simplify git usage with sprinkles of AI magic.
Humans think in simpler terms than git operates in. This tool aims to bridge that gap by providing a simpler language to do common git tasks. Plus an LLM can write your commit messages for you.
You can load recent information with gs load
, save current changes with gs save
and share them with gs share
.
Behind the scenes it's exactly what you would expect from git, but with a simpler interface.
Install
- Get an openai api key
$ export OPENAI_API_KEY=...
$ pip install gitease
- If OPENAI_API_KEY is not set, you will be prompted to enter a commit message manually.
Usage
Within a repo, run:
$ ge --help
Commands:
--help: Show this message and exit.
save <message>: Add and commit files to git. Massage is generated if not provided
share <message>: Share to remote - Add, commit and push changes to git. Massage is generated if not provided
load : Pull recent updates from git
message: Generate commit message from diff using AI.
undo: Undo last git action - only works using AI
Examples
$ ge save
> Entering new StuffDocumentsChain chain...
> Entering new LLMChain chain...
Prompt after formatting:
Write a concise summary of the following:
...
> Finished chain.
Your commit message is:
docs: Update documentation, configuration, and index files
This commit updates the documentation, configuration, and index files for the project, including Makefile,
conf.py, and index.rst. These changes provide information about the project, its features, and quickstart
instructions. Additionally, it updates the version of gitease from 0.0.5 to 0.0.6.
To confirm, press Enter.
Otherwise, write your own message:
Press CTRL+C to cancel
Response:
# Add and Commit all python files in src with the message "feat: Add new script"
ge save -a 'src/*.py' -m 'feat: Add new script'
# Add multiple files
ge save -a README.md -a gitease/cli.py
# Add and commits everything without prompting for validation
ge save -y
# Add the README.md file and commit with a generated message
ge share -a README.md -y
# Add and commit README.md file with "upload readme" message and merges to main
ge share -a README.md -m "upload readme" --merge=main
# Pull recent changes from git
ge load
$ ge undo
Welcome to GitEase
Last git action is: Update README and CLI files
A revert command is: git reset HEAD@{0}
Shell I run the command for you? [y/n]:
Running: git reset HEAD@{0}
Unstaged changes after reset:
M README.md
M gitease/cli.py
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
gitease-0.0.9.tar.gz
(9.1 kB
view details)
Built Distribution
File details
Details for the file gitease-0.0.9.tar.gz
.
File metadata
- Download URL: gitease-0.0.9.tar.gz
- Upload date:
- Size: 9.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.1 CPython/3.11.4 Darwin/22.4.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 605c57939db1ce2d1f1c0a649f2dfb4c4a57d4dcde19ffac2e6e4c7ec97cc4b5 |
|
MD5 | 7a5bab87efa2e0542b869b8922b7636b |
|
BLAKE2b-256 | 41316d81d00b02735ba9cb8b622c2a24ea5a13a6cd09645600a0d43e24e65d0b |
File details
Details for the file gitease-0.0.9-py3-none-any.whl
.
File metadata
- Download URL: gitease-0.0.9-py3-none-any.whl
- Upload date:
- Size: 9.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: poetry/1.5.1 CPython/3.11.4 Darwin/22.4.0
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4a13d2f988ddecbd11d191f690b2411095b3086774f20f1187c378f07c8e430 |
|
MD5 | 380c6f06b7ca1a994384e5b1f8424b00 |
|
BLAKE2b-256 | e3a82222b520778983b2d4263182f31514fb9eb2279c692148162e2af38d877e |