gitconductor 0.6.0

Manage nested GitLab repositories seamlessly(ish)

gitconductor

gitconductor is a command-line tool and Python library for managing git operations over nested GitLab groups using the official GitLab Python API. It traverses group and subgroup hierarchies, runs recursive git commands, and can work with Python packages inside a cloned hierarchy.

Full documentation: gitconductor.readthedocs.io.

Features

• Recursive group traversal across nested GitLab groups
• Git operations across many projects, such as clone, branch, checkout, add, commit, status, and push
• Hierarchy and access visualisation with Rich tables and trees
• Python package helpers for requirements, installation, and wheel building
• CLI and Python API entry points

Installation

pip install gitconductor

Configuration

Gitconductor needs a GitLab Personal Access Token. The quickest setup is:

export GITCONDUCTOR_GITLAB_API_KEY=<my-private-key>

For self-hosted GitLab, set the GitLab URL too:

export GITCONDUCTOR_GITLAB_URL=https://gitlab.example.com

Gitconductor can also store settings in a TOML file. By default, this is:

~/.config/gitconductor/gitconductor.toml

The location can be changed via GITCONDUCTOR_CONFIG or the top-level --cfg CLI option.

Quick Start

gitconductor clone my-group
cd my-group
gitconductor status
gitconductor viz tree

Run commands from a subgroup or project directory to narrow the recursive scope.

Documentation

See the full documentation for:

• Configuration
• Git CLI commands
• Visualisation
• Python package commands
• Python API

Development & Contributing

Contributions are welcome. See CONTRIBUTING.md.

License

MIT License. See LICENCE.md.