Gameta

Gameta is a powerful CLI tool that helps you to manage meta-repositories or metarepos. It allows you to create links to related repositories, make changes and sync them, and provides functionality to customise and apply other CLI commands to these repositories.

What is Gameta?

Gameta is a play on the word gamete (reproductive cells), and similar to how gametes form the building blocks for life, gameta helps to manage the many repositories that form the building blocks for more complex software.

System Requirements

Gameta requires Python 3.6+, it is designed to be multi-platform but currently is only tested in Linux environments.

Installation

Gameta can be easily installed and updated via pip:

$ pip install gameta  # install
$ pip install -U gameta  # update

Getting Started

Getting started is really easy.

gameta init
gameta init -g  # To initialise directory as a Git repo 

Gameta will extract git information and create the .meta file which stores all your project configurations.

{
  "projects": {
    "gameta": {
      "path": ".",
      "tags": ["metarepo"],
      "url": "https://github.com:genius-systems/gameta.git"
    }
  }
}

Note

If your project has not been initialised with Git, you can specify the --git or -g flag to perform a git init, but you will have to update the repository URL manually later on.

If your repository contains a .meta file generated by Gameta, simply run the following command to sync all linked repositories locally:

gameta sync

Adding a Repository

Run the following command to add a new repository.

gameta repo add -n GitPython -u https://github.com/gitpython-developers/GitPython.git -p GitPython

Note

The path variable is the relative path within the metarepo itself

You should see another entry under the projects object within the .meta file

{
  "projects": {
    "gameta": {
      "path": ".",
      "tags": ["metarepo"],
      "url": "git@github.com:genius-systems/gameta.git"
    },
    "GitPython": {
      "path": "GitPython",
      "tags": ["a", "b", "c"],
      "url": "https://github.com/gitpython-developers/GitPython.git"
    }
  }
}

You should also see the repository cloned to the relative path specified

Applying commands

Gameta provides a powerful toolkit to manage your set of repositories.

gameta apply -c "git fetch --all --tags --prune" -c "git merge"

The command above applies the following to all repositories:

1. Fetches all git updates, tags and prunes redundant git artifacts
2. Merges changes on the default branch

There's alot more that you can do with commands, see the Applying Commands page for more information

Best practices

Learn how to leverage on Gameta's capabilities in the Best Practices page

Documentation

Documentation can be found at Gameta Docs