Skip to main content

A component manager based where your components live in Git.

Project description

Gitvier is a CLI “component management” tool for when you’ve got a container repository and then that repository relies on a bunch of components to operate, which you’re then actively working on those components. As such, it aims to allow the user to try and manage these components, allowing for installing, updating, etc. as well as running commands over some/all components. However, it differs from something like GitMan in that it will not explicitly revert dependencies to specified revisions unless explicitly forced as most likely if you install a component on “master” and the component is currently on branch “develop”, if you run “gitvier update”, you don’t expect that component to be put back onto master, but rather that maybe just do a git pull on this component (and all others). I primarily built this to support the usecase of Submitty and for my research projects.

This borrows concepts heavily from GitMan which is a great dependency manager with Git, but less useful as a “component manager” (hence the existance of this tool).


  • Python 3.5+
  • Git



From Pip:

pip3 install gitvier

From Source:

git clone
python3 install


$ gitvier --help
usage: gitvier [-h] [-V] <command> ...

A component manager based where your components live in Git.

positional arguments:
    init         Initialize a new gitvier directory

optional arguments:
  -h, --help     show this help message and exit
  -V, --version  show program's version number and exit

Gitvier Config File

Gitvier operates over a .gitvier.yml config file which contains the various components of our system. At the root level you can specify a location (defaults to current directory if omitted) where all components would live and components which is a list of components which contain the following elements:

name: <component_name/subfolder where component will be installed to>
repo: <git_url>
rev: <branch or tag or commit hash or branch/tag@timestamp>
commands: <list of bash commands to run after install/update> (optional)

An example of a .gitvier.yml file (taken from Submitty):

location: .
- name: RainbowGrades
  rev: master
- name: grading
  rev: master

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

gitvier-0.1.1.tar.gz (6.4 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page