as2fm.scxml_converter.scxml_entries.ascxml_configuration.AscxmlConfiguration

class as2fm.scxml_converter.scxml_entries.ascxml_configuration.AscxmlConfiguration

Bases: ScxmlBase

Base class for a generic configuration entry in ASCXML.

Inheriting classes will contain values coming from external configuration. At compile time, the get_configured_value method can be used to get the actual config. value. Examples of configuration entries are getters of BT ports values, ROS 2 Parameters and so on.

__init__()

Methods

`__init__`()
`as_plain_scxml`(struct_declarations, ...)	Convert the object to its plain SCXML version.
`as_xml`()	Convert the object to an XML element.
`check_validity`()	Check if the object is valid.
`from_xml_tree`(xml_tree, custom_data_types, ...)	External interface to create a ScxmlBase object from an XML tree.
`from_xml_tree_impl`(xml_tree, custom_data_types)	Child-specific implementation to create a ScxmlBase object from an XML tree.
`get_config_request_response_events`()	A method returning the events to request and receive the non-constant config values.
`get_configured_value`()	Retrieve the previously configured value.
`get_custom_data_types`()	Get the container with custom data types.
`get_tag_name`()	Get the tag name of the XML element.
`get_xml_origin`()	Get the xml_element this object was made from.
`is_constant_value`()
`is_plain_scxml`([verbose])	Check if the object is compatible with the plain SCXML standard.
`set_custom_data_types`(custom_data_types)	Save container with custom data types.
`set_xml_origin`(xml_origin)	Set the xml_element this object was made from.
`update_configured_value`(ascxml_declarations)	Configure the entry value using the existing AscxmlDeclarations

abstract as_plain_scxml(struct_declarations, ascxml_declarations, **kwargs) → List[ScxmlBase]

Convert the object to its plain SCXML version.

Parameters:

struct_declarations – List of custom structures defined in the model
ascxml_declarations – Additional declarations, like ROS or BT specific ones
kwargs – Additional framework specific entries, e.g. the BT plugin ID.

abstract as_xml(): Convert the object to an XML element.

abstract check_validity() → bool: Check if the object is valid.

classmethod from_xml_tree(xml_tree: _Element, custom_data_types: Dict[str, StructDefinition], **kwargs) → Self: External interface to create a ScxmlBase object from an XML tree.

abstract classmethod from_xml_tree_impl(xml_tree: _Element, custom_data_types: Dict[str, StructDefinition]) → Self: Child-specific implementation to create a ScxmlBase object from an XML tree.

abstract get_config_request_response_events() → Tuple[str, str] | None

A method returning the events to request and receive the non-constant config values.

Returns:: None if the value is constant, a tuple with the request-receive events otherwise.

get_configured_value() → str: Retrieve the previously configured value.

get_custom_data_types() → Dict[str, StructDefinition]: Get the container with custom data types.

abstract classmethod get_tag_name() → str: Get the tag name of the XML element.

get_xml_origin() → _Element | None: Get the xml_element this object was made from.

abstract is_plain_scxml(verbose: bool = False) → bool: Check if the object is compatible with the plain SCXML standard.

set_custom_data_types(custom_data_types: Dict[str, StructDefinition]): Save container with custom data types.

set_xml_origin(xml_origin: _Element): Set the xml_element this object was made from.

abstract update_configured_value(ascxml_declarations: List[AscxmlDeclaration]): Configure the entry value using the existing AscxmlDeclarations