Name

The name attribute of the manifest front matter should succinctly describe the purpose of the manifest. It should be specified as the first attribute of the manifest thus:

{
  "name": "example"
  # ... remainder of manifest goes here
}

The reason it is defined in the manifest specification is to provide the user with feedback at the start end of the manifest application or removal process as to what manifest was applied. This is because manifest application can be a long running procedure and may be left for a while to complete.

Ideally, if you maintain multiple configuration manifests this should be unique, although the tool does not enforce this.

GeneSystem will not proceed with a manifest that does not have the name specified.

Access to manifest name in command variables

You can access the manifest name from a command variable like this:

{
  "name": "manifest",
  "version": "0.0.1",
  "metadata": {
    "gene_system": {
      "version": "0.4.0"
    }
  },
  "steps": [
    {
      "name": "print manifest name",
      "exe": {
        "install": {
          "cmd": [
            "echo \"{{manifest.name}}\""
          ]
        },
      },
      "tags": "example step"
    }
  ]
}