https://github.com/alanfranz/gh

A thin wrapper to make working with git repos easier for Mercurial users.
https://github.com/alanfranz/gh

Last synced: 6 days ago
JSON representation

A thin wrapper to make working with git repos easier for Mercurial users.

• Host: GitHub
• URL: https://github.com/alanfranz/gh
• Owner: alanfranz
• License: mit
• Created: 2013-04-22T13:55:20.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2013-04-23T14:24:06.000Z (over 11 years ago)
• Last Synced: 2024-04-18T02:12:01.425Z (8 months ago)
• Language: Perl
• Homepage: http://bitbucket.org/sjl/gh/
• Size: 128 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
gh

====

**`gh` is still in its infancy. Don't use it unless you want to contribute.**

Requirements:

* Python 2.6+

* Git (latest version)

`gh` is a thin wrapper around git to provide a Mercurial-like CLI.

    $ cd someprojectthatusesgit

    $ gh log -l10

    ... runs git log -10

    $ gh diff

    ... runs git diff

    $ gh diff --rev abc123

    ... runs git diff abc123

    $ gh diff --change abc123

    ... runs git diff abc123 abc123^

    $ gh branches

    ... runs git branch -a

Why?

----

You use Mercurial.

You want to contribute a patch to a project, but it uses git.

Instead of wasting your time looking up commands in git's excessively verbose

documentation you can use the commands you're familiar with.

Caveats

-------

`gh` assumes basic knowledge about git.  It's meant to save you the pain of

looking up how to do something in git, **not** to save you from learning the

basics of git!

`gh` runs git commands. It does **not** attempt to parse those commands' output

and make it look like output from Mercurial.  It's a tool for humans only.

`gh` is only meant for simple commands -- the ones you'll need 90% of the time.

To do complicated stuff you'll need to learn git's CLI.

Contributing

------------

Fork, send a pull request.

To run the tests you'll need [cram](http://bitheap.org/cram/).