Metadata-Version: 1.1
Name: legit
Version: 0.2.0
Summary: Git for Humans.
Home-page: https://github.com/kennethreitz/legit
Author: Kenneth Reitz
Author-email: me@kennethreitz.com
License: BSD
Description: .. -*-restructuredtext-*-
        
        Legit: Git for Humans
        =====================
        
        Inspired by GitHub for Mac.
        
        
        The Concept
        -----------
        
        `GitHub for Mac <http://mac.github.com>`_ is not just a Git client.
        
        This `comment <https://news.ycombinator.com/item?id=2684483>`_ 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>]``
            Syncronizes the given branch. Defaults to current branch.
            Stash, Fetch, Auto-Merge/Rebase, Push, and Unstash.
            You can only sync published branches.
        
        ``switch <branch>``
            Switches to specified branch.
            Defaults to current branch.
            Automatically stashes and unstashes any changes.
        
        ``sprout [<branch>] <new-branch>``
            Creates a new branch off of the specified branch.
            Swiches to it immediately.
        
        ``harvest [<branch>] <into-branch>``
            Auto-Merge/Rebase of specified branch changes into the second branch.
        
        ``graft <branch> <into-branch>``
            Auto-Merge/Rebase of specified branch into the second branch.
            Immediately removes specified branch. You can only graft unpublished branches.
        
        ``publish <branch>``
            Publishes specified branch to the remote.
        
        ``unpublish <branch>``
            Removes specified branch from the remote.
        
        ``install``
            Installs legit git aliases.
        
        
        The Installation
        ----------------
        
        .. image:: https://img.shields.io/pypi/v/nine.svg
            :target: https://pypi.python.org/pypi/legit/
        
        From `PyPI <https://pypi.python.org/pypi/legit/>`_ with the Python package manager::
        
            pip install legit
        
        Or to install the cutting edge version::
        
            pip install git+https://github.com/kennethreitz/legit.git@develop
        
        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.
        
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
