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

branches

Get a nice pretty list of available branches.

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)

resync <upstream-branch>

Stashes unstaged changes, Fetches, Auto-Merge/Rebase upstream data from specified upstream branch, Performs smart pull+merge for current branch, Pushes local commits up, and Unstashes changes. Default upstream branch is ‘master’. (alias: rs)

switch <branch>

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

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.

install

Installs legit git aliases.

help

Displays help for legit command. (alias: h)

The Installation

https://img.shields.io/pypi/v/legit.svg

From PyPI with the Python package manager:

pip install legit

Or download a standalone Windows executable from GitHub Releases.

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

To install the git aliases, run the following command:

legit install

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

Uploaded Source

Built Distribution

legit-0.4.1-py2.py3-none-any.whl (13.9 kB view details)

Uploaded Python 2Python 3

File details

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

File metadata

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

File hashes

Hashes for legit-0.4.1.tar.gz
Algorithm Hash digest
SHA256 642377c8a6577841d6218d52ce4f2487ea9e0495397a794ae6073d8695dbf833
MD5 3917e991e72004406bd51ed1881b71d1
BLAKE2b-256 0192d7f9a6ccba82e996eb2cb23f33ebb0adf1ca1692b098f338cc0014f18a3b

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for legit-0.4.1-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 ef2768b7783d16cb7f5b4c1fb4ad8ae8b6fab7674519a98616e7af09e2969135
MD5 a6b5993346f78cb9299e870b5b58372e
BLAKE2b-256 c86105480224a5fe4a4aa6fa6487202bd9fe0aa9afb6d2b4397fd469a8c12895

See more details on using hashes here.

Supported by

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