Extensions > API reference > config

config

This is a top-level module for creating configuration transitions and build setting descriptors which describe what kind of build setting (if any) a rule is.

ex: the following rule is marked as a build setting by setting the build_setting parameter of the rule() function. Specifically it is a build setting of type int and is a flag which means this build setting is callable on the command line.

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

bool

BuildSetting config.bool(flag=False)

A bool-typed build setting

Parameters

Parameter Description
flag ; default = False
Whether or not this build setting is callable on the command line.

int

BuildSetting config.int(flag=False)

An integer-typed build setting

Parameters

Parameter Description
flag ; default = False
Whether or not this build setting is callable on the command line.

string

BuildSetting config.string(flag=False)

A string-typed build setting

Parameters

Parameter Description
flag ; default = False
Whether or not this build setting is callable on the command line.

string_list

BuildSetting config.string_list(flag=False)

A string list-typed build setting

Parameters

Parameter Description
flag ; default = False
Whether or not this build setting is callable on the command line.