Development environment

This section describes some tips on how to configure your development environment so you can use the MACH composer to the fullest.

Installing the CLI

The MACH composer is a Python project. In order to make this work on your local machine, make sure you have Python 3.8 installed on your system.

You can install MACH directly from the Python package index.

Using pipx

We recommend using pipx as an installer.
This will make sure the MACH composer gets installed in it's own sandboxed virtual environment and lets you run mach from your command line.

$ pipx install mach-composer

Using the JSON schema for IntelliSense autocompletion

On Visual Studio Code

Register the MACH schema per project by adding a .vscode/settings.json with the following configuration:

{
  "yaml.schemas": {
    "https://raw.githubusercontent.com/labd/mach-composer/master/schema.json": "*.yml"
  }
}