Metadata-Version: 2.1
Name: gitlab-backup
Version: 0.4.0
Summary: backup a gitlab user or organization
Home-page: http://github.com/josegonzalez/python-gitlab-backup
Author: Jose Diaz-Gonzalez
Author-email: gitlab-backup@josediazgonzalez.com
License: MIT
Classifier: Development Status :: 5 - Production/Stable
Classifier: Topic :: System :: Archiving :: Backup
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Requires-Dist: python-gitlab

=============
gitlab-backup
=============

|PyPI| |Python Versions|

backup a gitlab user or organization

Requirements
============

- GIT 1.9+

Installation
============

Using PIP via PyPI::

    pip install gitlab-backup

Using PIP via Github::

    pip install git+https://github.com/josegonzalez/python-gitlab-backup.git#egg=gitlab-backup

Usage
=====

CLI Usage is as follows::

    usage: gitlab-backup [-h] [--host HOST] [--username USERNAME]
                         [--password PASSWORD] [--oath-token OATH_TOKEN]
                         [--private-token PRIVATE_TOKEN] [--clone-bare]
                         [--clone-lfs] [--disable-ssl-verification]
                         [--namespace NAMESPACE]
                         [--output-directory OUTPUT_DIRECTORY] [--prefer-ssh]
                         [--skip-existing]
                         [--private_key]

    Backup a gitlab account

    optional arguments:
      -h, --help            show this help message and exit
      --host HOST           gitlab host
      --username USERNAME   username for basic auth
      --password PASSWORD   password for basic auth. If a username is given but
                            not a password, the password will be prompted for.
      --oath-token OATH_TOKEN
                            oath token, or path to token (file://...)
      --private-token PRIVATE_TOKEN
                            private token, or path to token (file://...)
      --clone-bare          clone bare repositories
      --clone-lfs           clone LFS repositories (requires Git LFS to be
                            installed, https://git-lfs.github.com)
      --disable-ssl-verification
                            disable ssl verification
      --namespace NAMESPACE
                            specify a gitlab namespace to backup
      --output-directory OUTPUT_DIRECTORY
                            directory at which to backup the repositories
      --prefer-ssh          Clone repositories using SSH instead of HTTPS
      --skip-existing       skip project if a backup directory exists
      --with-membership     Backup projects provided user or key is member of
      --private_key         To specify a private key


.. |PyPI| image:: https://img.shields.io/pypi/v/gitlab-backup.svg
   :target: https://pypi.python.org/pypi/gitlab-backup/
.. |Python Versions| image:: https://img.shields.io/pypi/pyversions/gitlab-backup.svg
   :target: https://github.com/albertyw/gitlab-backup
