Files Config

+++ title = “Config” description = “Configuration” weight = 1 +++

Each file can be configured with different values to influence to behavior of helmize

Each File can have the following properties.

Optional

Type string Default "append" Valid Options append, skip

Define what happens if a file does not match any existing file with it’s identifiers:

• append - Append to file as new entry
• skip - Skip the file

This option is interesting for patches.

Optional

Type float64 Default 0

Limit the amount of matches this file can have. 0 are unlimited matches.

Optional

Type boolean Default true

Define if a file should be rendered. The file will still show up in the summary but no be rendered when templating normally. When files are merged this option is overwritten as well. Eg. when the base file has render set to false and a file merges with it, with renderset to true, the result will be true

Optional

Type boolean Default true

Match this file based on it’s subpath.

---
data:
  game.properties: |
    enemy:
      types:
      - alien
      - monsters
    player:
      maximumLives:5
---
data:
  game.properties: |
    enemy:
      types:
      - imps
      - warriors
    player:
      maximumLives:10

When pattern is active, the file can oly be merged. If there’s no match, the file will be skipped, no matter which configuration is set for property no_match

Optional

Type boolean Default false

The identifiers are used as pattern (regex) to match against other ids.

id:
  - ".*"
cfg:
  subpath: false
  pattern: true
metadata:
  labels:
    shared: "labels"

conditions:
  ...
  - name: "patches"
    allow_root: true

Optional

Type boolean Default false

Forks are new files based on their matches. If a files matches any file’s id it will create a new file. Only one fork can be created, so the first match creates the new file.

[See the example chart]