Adapt configs¶

Introduction¶

If you want to manipulate existing configs without changing them, you can “adapt” them via command line.

User@Host:~$ bake test --adapt abc

bake searches for abc/Adapt.meta within the workspace roots. If found, the configs from the adapt file are parsed:

Adapt {
  ExecutableConfig ... # 0..n
  LibraryConfig ... # 0..n
  CustomConfig ... # 0..n
}

Here is an example to change the DefaultToolchain

Adapt {
  ExecutableConfig test, project: __MAIN__, type: replace {
    DefaultToolchain GCC
  }
}

Effectiveness¶

The adapt configs can be applied to all configs from regular build. This can be controlled by the config names and the project attributes. The example above is adapted only to the config “test” of the main project. __MAIN__ and __ALL__ are keywords. __MAIN__ means the main project or config, __ALL__ means all projects or configs. If you want to apply the changes only to the top level config, write:

ExecutableConfig __MAIN__, project: __MAIN__, ...

If you want to apply the changes to all configs, write:

ExecutableConfig __ALL__, project: __ALL__, ...

It is possible to mix the keywords with reals project or config names.

Occurrences¶

You can specify more configs in one adapt file and you can specify more than one adapt file:

Adapt {
  ExecutableConfig ..., project: ..., type: ... {
    ...
  }
  ExecutableConfig ..., project: ..., type: ... {
    ...
  }
  LibraryConfig ..., project: ..., type: ... {
    ...
  }
  ...
}

User@Host:~$ bake test --adapt abc --adapt xy

They will be applied in the specified order.

Types¶

It is possible to specify the type of adaption:

ExecutableConfig ..., type: replace

The type can be “replace”, “remove” or “extend”.

ExecutableConfig test {
  DefaultToolchain GCC
}

ExecutableConfig __ALL__, project: __ALL__, type: remove {
  DefaultToolchain # remove ok
}

ExecutableConfig __ALL__, project: __ALL__, type: remove {
  DefaultToolchain GCC # remove ok
}

ExecutableConfig __ALL__, project: __ALL__, type: remove {
  DefaultToolchain Diab # remove NOT ok
}

ExecutableConfig __ALL__, project: __ALL__, type: remove {
  DefaultToolchain GCC, eclipseOrder: true # remove NOT ok
}

ExecutableConfig __ALL__, project: __ALL__, type: replace {
  Files "*.cpp"
  DefaultToolchain GCC {
    Linker command: "link.exe"
  }
}