GitGitLab: Gitlab Git Plugin

GitGitLab integrates Gitlab in your git flow.

With GitGitlab, you can create projects, clone them and set them as remote source without leaving the command line.

Installation

.. code::

sudo pip install gitgitlab

Example

.. code::

$ git init
$ git touch 'readme.txt'
$ git add readme.txt
$ git commit -am 'initial commit'
$ git lab create -t my_project            # Creates project my_project and adds it as remote
  Project my_project created on Gitlab
$ git remotes
  gitlab

Command overview

git lab list List your Gitlab projects git lab create Create a project on Gitlab git lab track Set this project as remote for your local repository. git lab open Open a Gitlab project page. If is omitted, uses the project on the 'gitlab' remote of the repository on the current directory. git lab clone Clone a Gitlab project. git lab auth Reset the Gitlab authorization token.

Listing your projects

git lab list lists all the projects that you own and their repository url.

Creating a new project

git lab create <project_name> creates a new private project on Gitlab.

git lab create <project_name> --track creates a new private project and sets it up as remote.

Setting up an existing project to track the local repository

git lab track <project_name> Adds a gitlab project as remote.

Opening the project page

git lab open <project_name> Opens the project page on the default browser.

Cloning a project

git lab clone <project_name> Clones the project.

Obtaining help

git lab help Overview. git lab --help Help for a specific command.

Using it from Python

To use gitgitlab from Python, import gitgitlab.client <http://gitgitlab.readthedocs.org/en/latest/gitgitlab.html#module-gitgitlab.client>_.

Using a custom Gitlab server

By default, gitgitlab uses https://gitlab.com as the Gitlab server url. If you are using your own Gitlab server, you can configure it using git config.

Configure your custom Gitlab server globally:

.. code::

$ git config --global --replace-all gitlab.url <your server url>

Configure your custom Gitlab server only for the current repository:

.. code::

$ git config --replace-all gitlab.url <your server url>

gitgitlab will try to connect to /api/v3

More information

See also the project documentation <http://gitgitlab.readthedocs.org>_.