launch.substitutions.python_expression module

Module for the PythonExpression substitution.

class launch.substitutions.python_expression.PythonExpression

Bases: Substitution

Substitution that can access contextual local variables.

The expression may contain Substitutions, but must return something that can be converted to a string with str(). It also may contain math symbols and functions.

__init__(expression: str | Path | Substitution | Iterable[str | Path | Substitution], python_modules: str | Path | Substitution | Iterable[str | Path | Substitution] = ['math']) → None

Create a PythonExpression substitution.

describe() → str

Return a description of this substitution as a string.

property expression: List[Substitution]

Getter for expression.

classmethod parse(data: Sequence[str | Path | Substitution | Iterable[str | Path | Substitution]])

Parse PythonExpression substitution.

perform(context: LaunchContext) → str

Perform the substitution by evaluating the expression.

property python_modules: List[Substitution]

Getter for python modules.