Skip to main content

A tool to simplfy git operations

Project description

logo

GitEase

Version Python License Downloads Documentation Status

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

$ 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 

# 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


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.7.tar.gz (188.5 kB view details)

Uploaded Source

Built Distribution

gitease-0.0.7-py3-none-any.whl (9.6 kB view details)

Uploaded Python 3

File details

Details for the file gitease-0.0.7.tar.gz.

File metadata

  • Download URL: gitease-0.0.7.tar.gz
  • Upload date:
  • Size: 188.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.17

File hashes

Hashes for gitease-0.0.7.tar.gz
Algorithm Hash digest
SHA256 c33a27663aa6d19a3a8a204c17b0d71fe8bb6e2f51d9da878a19d1665e0fb1a2
MD5 c866fb428130708edf184077b945853c
BLAKE2b-256 674194bc9a3060a3750a03f0c4a6a08e652fabbeb62606b32d8f4b2f9fe0155d

See more details on using hashes here.

File details

Details for the file gitease-0.0.7-py3-none-any.whl.

File metadata

  • Download URL: gitease-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 9.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.8.17

File hashes

Hashes for gitease-0.0.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1a21b775444c29184cf4e6777fe462fb3a10ef325fee9bc6a6a143540f4135ab
MD5 3a82c839ce80f17acb04d9fb0c992d68
BLAKE2b-256 086cfbec55e4dcacd69624ee33f56f32b00f8a627bf736c894b02292825b655d

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page