Metadata-Version: 2.1
Name: gitlab-clone
Version: 1.2.0
Summary: Gitlab tool for recursive clone
Home-page: https://github.com/ArseniyAntonov/gitlab-group-clone
Author: Arseniy Antonov
Author-email: arseny.antonov@gmail.com
License: MIT license
Keywords: gitlab,gitlab-api
Classifier: Framework :: Pytest
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
License-File: LICENSE
License-File: AUTHORS.rst

=================
gitlab-clone
=================


Tool for easy cloning whole gitlab structure to your local machine.


* Free software: MIT license



Requirements
------------

* Requests
* Python >= 3.6


Installation
------------

You can install "gitlab-clone" via `pip`_::

    $ pip install gitlab-clone


Usage
-----


>>> gitlab-clone:
  optional arguments:
  -h, --help           show this help message and exit
  --group_id group_id  Id of a group in gitlab
  --branch branch      Branch to clone in all repos [by default master]
  --http               Clone via http instead of ssh
  --gitlab-url gitlab  Gitlab address [by default gitlab.com]
  --token token        Gitlab Token


Example
-------

    $  gitlab-clone --group=123 --token=MySecretToken --gitlab-url=gitlab.organization.com

    For example if you clone this group https://gitlab.com/lmaolmaolmao which id is 6849299

    you will have absolutely the same structure locally:

    .. image:: https://github.com/ArseniyAntonov/gitlab-group-clone/raw/master/img/tree.png

>>> tree
   .
    └── lmaolmaolmao
        └── subgroup1
            └── subgroup2
                └── subgroup3

    If you will use this command again `gitlab-clone` will just pull the updated to the existing repos, and will download new repos from the group.


.. _`pip`: https://pypi.python.org/pypi/pip/


