Metadata-Version: 2.4
Name: python3-gitlab-client
Version: 0.9.4
Summary: The python meat of Clazzes.org's gitlabclient.
Author: Christoph Lechleitner
Author-email: christoph.lechleitner@iteg.at
License: Apache 2.0
Keywords: clazzes.org,gitlabclient
Classifier: Intended Audience :: Developers
Classifier: Topic :: Utilities
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3 :: Only
License-File: LICENSE
Requires-Dist: clazzes-tools
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# Gitlab-Client

The gitlab-client shall include python3-based tools facilitating the Gitlab API to perform analytic tasks, checkout whole groups of projects, and the like.

# Installation & Configuration

## Installation for Debian-based systems:

~~~
test -f /etc/apt/trusted.gpg.d/pba-archiver.clazzes.org.gpg || \
  sudo wget -O /etc/apt/trusted.gpg.d/pba-archiver.clazzes.org.gpg \
               https://deb.clazzes.org/gpg/pba-archiver.clazzes.org.gpg

test -f /etc/apt/sources.list.d/any-pytools-1.list || \
  sudo wget -O /etc/apt/sources.list.d/any-pytools-1.list \
               https://deb.clazzes.org/any/sources.list.d/any/any-pytools-1.list

sudo apt-get update
sudo apt-get install -y gitlab-client python3-gitlab-client
~~~

## Configuration

For configuration see /etc/gitlab-client/gitlab-client.cnf.template

For minimal initial configuration you will want to 
copy `/etc/gitlab-client/gitlab-client.cnf.template` 
to `~/.gitlab-client/gitlab-client.cnf` and edit it.


# Tools provided by gitlab-client

All tools /usr/bin/glc-* describe themselfes and their options when called with --help

## glc-ping

Checks if the Gitlab v4 APIs of one or all configured instances are reachable.

## glc-projects-list [projectFilter]

Lists all projects matching an eventually specified filter.

## glc-projects-clone [projectFilter]

Clones all projects matching the filter in the current directory
after checking back with a list of projects that would be clone.

