_SFNValueDefinition
- class ase2sprkkr.result_files.definitions.sfn._SFNValueDefinition(name, type=None, default_value=None, default_value_from_container=None, written_name=None, fixed_value=None, init_by_default=False, result_is_visible=False, info=None, description=None, is_stored=None, is_hidden=False, is_optional=None, is_required=None, is_expert=False, experimental=False, is_repeated=False, repeated_delimiter=None, repeated_count=None, is_always_added=None, name_in_grammar=None, name_format=None, expert=None, write_condition=None, condition=None, warning_condition=None, validators=(), result_class=None, delimiter=None, delimiter_grammar=None, indent=None, value_mapping=None)[source]
An output value without the leading blank used by standard outputs.
Constructor
- Parameters:
is_repeated (bool | str | ase2sprkkr.common.repetition.Repeated)
is_always_added (bool)
validators (Callable[[Any, Any, str], Any] | Iterable[Callable[[Any, Any, str], Any]] | None)
- __init__(name, type=None, default_value=None, default_value_from_container=None, written_name=None, fixed_value=None, init_by_default=False, result_is_visible=False, info=None, description=None, is_stored=None, is_hidden=False, is_optional=None, is_required=None, is_expert=False, experimental=False, is_repeated=False, repeated_delimiter=None, repeated_count=None, is_always_added=None, name_in_grammar=None, name_format=None, expert=None, write_condition=None, condition=None, warning_condition=None, validators=(), result_class=None, delimiter=None, delimiter_grammar=None, indent=None, value_mapping=None)
Definition of a configuration value.
- Parameters:
name (str | Tuple(str)) – Name of the configuration value
type (Optional[GrammarType|mixed]) – Configuration value data type. If it is set to anyting what is not derived from GrammarType, the given value is used as the default value and the data type is derived from it. If it is None, the default value have to be set using
expertparameter.default (mixed) – Default value for the configuration option. Can accept callable (with option instance as an argument) - then the value will be determined at ‘runtime’ (possibly according to the other values of the section)
written_name (str) – Name of the configuration value in the input file
fixed_value (mixed) – If it is given, this option have a fixed_value value (provided by this parameter), that can not be changed by an user. #TODO - currently, callback (as in default_value) is not supported
init_by_default (bool) – If the value is not set, init it by default
result_is_visible (bool) –
If True, the result (see the result property of
Option) assigned to the option is visible if the value is get as its default value - in this mode the result can be used as a kind of default value, specific for given configuration object.If False, the result is visible to the user just using the result property and it should be some transformation of the value of the object (e.g. relative path of the given absolute path, id of assigned object etc.)
is_stored (bool) – If True, the value is readed/writed from the output file. If None, inherit the definition class default (normally True, False for non-stored generated definitions).
is_optional (bool or callable or None) – If True, the value may be omitted from the input. A callable receives the runtime Option and is evaluated after parsing, when the entire configuration is available. During grammar construction callable optionality is treated as optional. None means True if is_required is False (or inferred to be False).
is_required (bool or callable or str) –
Required options must have a value when parsing or saving (however, a required option can still be optional in the grammar if it has a default value). Callable requiredness is also checked while setting, so changing a selector cannot leave its dependent option invalid. If required = None, it is set to True if both the conditions are met:
the value is not expert
the optional is not True and the option has not a default_value
If required is str, it means the same as True, the string will be used as error message.
If it is callable, it is evaluated on demand with the Option as its argument. The runtime section is available as
option._container.is_hidden (bool) – The value is hidden from the user (no container.name access to the value).
experimental (bool) – Mark an experimental value in the metadata and help text.
is_expert (Union[bool,mixed]) – Expert values are somewhat hidden (e.g. listed at end) from the user. Expert values are not exported to the result, if they are set to the default value.
is_repeated (bool | str | ase2sprkkr.common.repetition.Repeated) – Whether the value can apper more than once in the output. The result can be then (dense) array or (sparse) dict, see
ValueDefinition.Repeated.repeated_delimiter (string) – The delimiter used between repeated instances of self, if not repeated_with_name
repeated_count (string or int or callable) – The number of repetitions. If string, the repetition is given from the parsed value at that exact path;
..selects the parent section (for example..NPAN). If callable, the function is called on the values of the local options named by its parameters.repeated_with_name (bool) – If True, the whole value-name pair is repeated
is_always_added (bool)
validators (Callable[[Any, Any, str], Any] | Iterable[Callable[[Any, Any, str], Any]] | None)
- is_always_added
If False, add the value, only if its value is not the default value. Default None means False for expert values, True for the others.
- validators: callable or iterable of callables
Semantic validators receiving the option, its runtime section and validation reason.
- name_in_grammar: bool or None
The value in the conf file is prefixed by <name><name_value_delimiter> If None, the default type value (type.name_in_grammar) is used
- name_format: str or None
The way how the name is written
- expert: Optional[mixed]
If not None, set
is_expertto True,default_valueto the given value andrequiredto False. Note, that alsotypecan be determined from such givendefault_value.- write_condition
If defined, write the value, only if write_condition(the option) is True.
- condition
- If defined, the condition
the condition.parse_condition() is invoked, when given grammar element should be parsed. If it is False, the element is skipped
the condition() is invoked, when the elements of the container is listed to hide the inactive members
- result_class
Redefine the class that holds data for this option/section
- delimiter
If not None, use the specified name_value_delimiter instead of common one
- value_mapping
The set value is transformed by given callback before validation and/or writing
- prefix = ''