Skip to main content

Git for Humans.

Project description

Inspired by GitHub for Mac.

The Concept

GitHub for Mac is not just a Git client.

This comment on Hacker News says it best:

They haven’t re-created the git CLI tool in a GUI, they’ve created something different. They’ve created a tool that makes Git more accessible. Little things like auto-stashing when you switch branches will confuse git veterans, but it will make Git much easier to grok for newcomers because of the assumptions it makes about your Git workflow.

Why not bring this innovation back to the command line?

The Interface

switch <branch>

Switches to specified branch. Defaults to current branch. Automatically stashes and unstashes any changes. (alias: sw)

sync [<branch>]

Synchronizes the given branch. Defaults to current branch. Stash, Fetch, Auto-Merge/Rebase, Push, and Unstash. You can only sync published branches. (alias: sy)

publish [<branch>]

Publishes specified branch to the remote. (alias: pub)

unpublish <branch>

Removes specified branch from the remote. (alias: unp)

undo

Un-does the last commit in git history. (alias: un)

branches

Display a list of available branches.

The Installation

https://img.shields.io/pypi/v/legit.svg https://img.shields.io/travis/kennethreitz/legit.svg https://img.shields.io/coveralls/github/kennethreitz/legit.svg

From PyPI with the Python package manager:

pip install legit

Or download a standalone Windows executable from GitHub Releases.

To install the cutting edge version from the git repository:

git clone https://github.com/kennethreitz/legit.git
cd legit
python setup.py install

Note: if you encountered Permission denied, prepend sudo before the pip or python setup.py command.

You’ll then have the wonderful legit command available. Run it within a repository.

To view usage and examples, run legit with no commands or options:

legit

To install the git aliases, run the following command:

legit --install

To uninstall the git aliases, run the following command:

legit --uninstall

Command Options

All legit commands support --verbose and --fake options.

In order to view the git commands invoked by legit, use the --verbose option:

legit sync --verbose

If you want to see the git commands used by legit but don’t want them invoked, use the --fake option:

legit publish --fake

Caveats

  • All remote operations are carried out by the remote identified in $ git config legit.remote remotename

  • If a stash pop merge fails, Legit stops. I’d like to add checking for a failed merge, and undo the command with friendly error reporting.

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

legit-1.0.0.tar.gz (14.9 kB view details)

Uploaded Source

Built Distribution

legit-1.0.0-py2.py3-none-any.whl (15.1 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file legit-1.0.0.tar.gz.

File metadata

  • Download URL: legit-1.0.0.tar.gz
  • Upload date:
  • Size: 14.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for legit-1.0.0.tar.gz
Algorithm Hash digest
SHA256 53a67ad7a7caefab7a6c28a76d7967022e2aee956993b1b074cc4d8c78cc1500
MD5 37958914c1033414353343c06067f9d1
BLAKE2b-256 dcbdc24a5a5d285d2f92ac142cf5974ad5a7d52976c13b150713880e8b01c617

See more details on using hashes here.

Provenance

File details

Details for the file legit-1.0.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for legit-1.0.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4598115f62e15d832bc2becb7d60c7013ab78bd2ec3501e1001ceb9a690434bf
MD5 b11705c8057f819029c313ed298586af
BLAKE2b-256 0d981bdbee0bd748dadf92664af9b6773aa3220ef693efe558d539e7ebb73291

See more details on using hashes here.

Provenance

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