Integrating git with central services
=====================================

Many central git hosting services, such as GitHub and GitLab, provide an API to
perform actions such as creating repositories and filing pull requests.
git-spindle is a collection of git subcommands to make using these services
easier.

For example, to fork and clone a repository on GitHub, one can now simply use

    git hub clone seveas/whelk

With this git subcommand, you can perform various github actions, such as
creating or forking a repository from the command line.

To install the latest released version:

    pip install git-spindle

If you use windows, you'll want to install git and pip via msys2. Download
msys2 from http://msys2.github.io/ and use pacman to install pip and git:

    pacman -Syu
    pacman -S git
    pacman -S mingw-w64-i686-python2-pip

Usage:

(For detailed information, go to http://seveas.github.com/git-spindle)

  git hub add-account [--host=<host>] <alias>
  git hub add-hook <name> [<setting>...]
  git hub add-public-keys [<key>...]
  git hub add-remote [--ssh|--http|--git] <user>...
  git hub apply-pr <pr-number>
  git hub browse [--parent] [<repo>] [<section>]
  git hub calendar [<user>]
  git hub cat <file>...
  git hub clone [--ssh|--http|--git] [--parent] [git-clone-options] <repo> [<dir>]
  git hub config [--unset] <key> [<value>]
  git hub create [--private] [-d <description>]
  git hub edit-hook <name> [<setting>...]
  git hub fork [--ssh|--http|--git] [<repo>]
  git hub forks [<repo>]
  git hub gist [-d <description>] <file>...
  git hub gists [<user>]
  git hub hooks
  git hub ignore [<language>...]
  git hub issue [<repo>] [--parent] [<issue>...]
  git hub issues [<repo>] [--parent] [<filter>...]
  git hub log [--type=<type>] [<what>]
  git hub ls <dir>...
  git hub mirror [--ssh|--http|--git] [--goblet] [<repo>]
  git hub network [<level>]
  git hub public-keys [<user>]
  git hub pull-request [--issue=<issue>] [<branch1:branch2>]
  git hub remove-hook <name>
  git hub render [--save=<outfile>] <file>
  git hub repos [--no-forks] [<user>]
  git hub say [<msg>]
  git hub set-origin [--ssh|--http|--git]
  git hub setup-goblet
  git hub status
  git hub whoami
  git hub whois <user>...

  git lab add-account [--host=<host>] <alias>
  git lab add-public-keys [<key>...]
  git lab add-remote [--ssh|--http] <user>...
  git lab apply-merge <merge-request-number>
  git lab browse [--parent] [<repo>] [<section>]
  git lab cat <file>...
  git lab clone [--ssh|--http] [--parent] [git-clone-options] <repo> [<dir>]
  git hub config [--unset] <key> [<value>]
  git lab create [--private|--internal] [-d <description>]
  git lab fork [--ssh|--http] [<repo>]
  git lab issue [<repo>] [--parent] [<issue>...]
  git lab issues [<repo>] [--parent] [<filter>...]
  git lab log [<repo>]
  git lab ls <dir>...
  git lab merge-request [<branch1:branch2>]
  git lab mirror [--ssh|--http] [--goblet] [<repo>]
  git lab public-keys [<user>]
  git lab repos [--no-forks]
  git lab set-origin [--ssh|--http]
  git lab whoami
  git lab whois <user>...

  git bb add-account [--host=<host>] <alias>
  git bb add-public-keys [<key>...]
  git bb add-remote [--ssh|--http] <user>...
  git bb apply-pr <pr-number>
  git bb browse [--parent] [<repo>] [<section>]
  git bb cat <file>...
  git bb clone [--ssh|--http] [--parent] [git-clone-options] <repo> [<dir>]
  git hub config [--unset] <key> [<value>]
  git bb create [--private] [-d <description>]
  git bb fork [--ssh|--http] [<repo>]
  git bb forks [<repo>]
  git bb issue [<repo>] [--parent] [<issue>...]
  git bb issues [<repo>] [--parent] [<filter>...]
  git bb ls <dir>...
  git bb mirror [--ssh|--http] [--goblet] [<repo>]
  git bb public-keys [<user>]
  git bb pull-request [<branch1:branch2>]
  git bb repos [--no-forks] [<user>]
  git bb set-origin [--ssh|--http]
  git bb whoami
  git bb whois <user>...

Copyright (C) 2012-2015 Dennis Kaarsemaker <dennis@kaarsemaker.net>

This program is free software: you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation, either version 3 of the License, or (at your option) any later
version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A
PARTICULAR PURPOSE.  See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with
this program.  If not, see <http://www.gnu.org/licenses/>.