Metadata-Version: 1.0
Name: github-cli
Version: 0.2.9
Summary: A command-line interface to the GitHub Issues API v2.
Home-page: http://packages.python.org/github-cli
Author: Sander Smits
Author-email: jhmsmits@gmail.com
License: BSD
Description: =============================================
        GitHub Issues API v2 - command-line interface
        =============================================
        
        about
        *****
        `github-cli <http://packages.python.org/github-cli/>`_ provides an
        executable called ``ghi``, that can be used to access all of `GitHub
        <http://www.github.com/>`_'s documented `Issues API
        <http://develop.github.com/p/issues.html>`_ (v2) functionality from your
        command-line
        
        github-cli is written in `Python <http://www.python.org/>`_
        
        installation
        ************
        
        *on most UNIX-like systems, you'll probably need to run the following
        `install` commands as root or by using sudo*
        
        **pip**
        
        ::
        
        pip install github-cli
        
        **easy_install**
        
        ::
        
        easy_install github-cli
        
        **from source**
        
        ::
        
        pip install -e git://github.com/jsmits/github-cli.git#egg=github-cli
        
        *or*
        
        ::
        
        git clone git://github.com/jsmits/github-cli.git
        cd github-cli
        python setup.py install
        
        as a result, the ``ghi`` executable will be installed into a system ``bin``
        directory
        
        configuration
        *************
        make sure your GitHub username and API token are added to the global git config::
        
        git config --global github.user <your GitHub username>
        git config --global github.token <your GitHub API token>
        
        you can find the username and API token on your GitHub's account page
        
        usage
        *****
        from within a working directory with a remote that is hosted on
        GitHub (remote named either ``origin`` or ``github`` for git repositories or
        ``default`` or ``github`` for mercurial/`hg-git <http://hg-git.github.com/>`_ repositories), you can do this (note: with
        the -r option, commands can be invoked from anywhere):
        
        ::
        
        (github-cli)[jsmits@imac:~]$ ghi --help
        Usage: ghi command [args] [options]
        
        Examples:
        ghi list [-s open|closed|all]       show open, closed or all issues
        (default: open)
        ghi [-s o|c|a] -v                   same as above, but with issue details
        ghi                                 same as: ghi list
        ghi -v                              same as: ghi list -v
        ghi [-s o|c] -w                     show issues' GitHub page in web browser
        (default: open)
        ghi show <nr>                       show issue <nr>
        ghi show <nr> -v                    same as above, but with comments
        ghi <nr>                            same as: ghi show <nr>
        ghi <nr> -w                         show issue <nr>'s GitHub page in web
        browser
        ghi open (o)                        create a new issue (with $EDITOR)
        ghi close (c) <nr>                  close issue <nr>
        ghi open (o) <nr>                   reopen issue <nr>
        ghi edit (e) <nr>                   edit issue <nr> (with $EDITOR)
        ghi label add (al) <label> <nr>     add <label> to issue <nr>
        ghi label remove (rl) <label> <nr>  remove <label> from issue <nr>
        ghi search (s) <term>               search for <term> (default: open)
        ghi s <term> [-s o|c] -v            same as above, but with details
        ghi s <term> -s closed              only search in closed issues
        ghi comment (m) <nr>                create a comment for issue <nr>
        (with $EDITOR)
        ghi -r <user>/<repo>                specify a repository (can be used for
        all commands)
        ghi -r <repo>                       specify a repository (gets user from
        global git config)
        
        Description: command-line interface to GitHub's Issues API (v2)
        
        Options:
        -h, --help            show this help message and exit
        -v, --verbose         show issue details (only for show, list and search
        commands) [default: False]
        -s STATE, --state=STATE
        specify state (only for list and search (except `all`)
        commands) choices are: open (o), closed (c), all (a)
        [default: open]
        -r REPO, --repo=REPO, --repository=REPO
        specify a repository (format: `user/repo` or just
        `repo` (latter will get the user from the global git
        config))
        -w, --web, --webbrowser
        show issue(s) GitHub page in web browser (only for
        list and show commands) [default: False]
        -V, --version         show program's version number and exit
        
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Unix
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Bug Tracking
