6.1.2.6. Command

Use arbitrary custom command for analysis compilation

This rule calls a command shell with the given commands for build and clean actions.

Use this rule to call your build system with appropriate parameters to generate the desired IR file (most likely /Project/ir).

Options

The following places define options that affect this rule: BuildSystemIntegration, Project-GlobalOptions

abort_on_error

abort_on_error : bool = True

If set to true and the build step returns a non-zero exit-code, the build is aborted. Otherwise a non-zero exit-code is logged but the build continues.

 

build_command

build_command : str | None = None

Command to execute during the build step. This is run as a shell command and has to comply to the quoting rules used for the default shell.

 

capture_output

capture_output : bool = False

Sets whether the shell output of the step should be captured. Note that only the output of the build step will be captured and not the output of possible clean steps.

The output will be parsed according to the format configured with the options output_format, stdout_format, stderr_format.

 

clean_command

clean_command : str | None = None

Command to execute during the clean step. This is run as a shell command and has to comply to the quoting rules used for the default shell.

 

cwd

cwd : bauhaus.analysis.config.ProjectRelativePath | None = None

Directory for execution for the command. Defaults to /Project/directory if left unspecified.

 

environment

environment : dict[str, str] = {}

Environment for extending the call of the command. These entries are added to the environment and existing ones will be overwritten.

 

output_format

output_format : list[str] = ['generic']

Name of the format(s) describing the output pattern to capture from stdout/stderr.

The format names available here correspond to the provider options in /Analysis/AnalysisControl/ExternalAnalysisFormats.

This option only has an effect if capture_output is true.

 

stderr_format

stderr_format : list[str] = []

Name of the format(s) describing the output pattern to capture from stderr. This takes precedence over output_format if set.

The format names available here correspond to the provider options in /Analysis/AnalysisControl/ExternalAnalysisFormats.

This option only has an effect if capture_output is true.

 

stdout_format

stdout_format : list[str] = []

Name of the format(s) describing the output pattern to capture from stdout. This takes precedence over output_format if set.

The format names available here correspond to the provider options in /Analysis/AnalysisControl/ExternalAnalysisFormats.

This option only has an effect if capture_output is true.