hpcflow.app.CommandFilesList

class hpcflow.app.CommandFilesList(_objects)

Bases: CommandFilesList

A list-like container for command files with dot-notation access by label.

Parameters:

_objects (list[FileSpec]) – The files in this list.

Methods

add_object	Add an object to this list.
add_objects	Add multiple objects to the list.
from_json_like	Make an instance of this class from JSON (or YAML) data.
get	Get an object from this list that matches the given criteria.
get_all	Get all objects in this list that match the given criteria.
list_attrs	Get a tuple of the unique access-attribute values of the constituent objects.
to_dict	Serialize this object as a dictionary.
to_json_like	Serialize this object as an object structure that can be trivially converted to JSON.

add_object(obj, index=-1, *, skip_duplicates=False)

Add an object to this list.

Parameters:

• obj (T) –

• index (int) –

• skip_duplicates (bool) –

Return type:

int | None

add_objects(objs, index=-1, *, skip_duplicates=False)

Add multiple objects to the list.

Parameters:

• objs (Iterable[T]) –

• index (int) –

• skip_duplicates (bool) –

Return type:

int

classmethod from_json_like(json_like, shared_data=None, is_hashed=False)

Make an instance of this class from JSON (or YAML) data.

Parameters:

• json_like (str | Mapping[str, JSONed] | Sequence[Mapping[str, JSONed]] | None) – The data to deserialise.

• shared_data (Mapping[str, ObjectList[JSONable]] | None) – Shared context data.

• is_hashed (bool) – If True, accept a dict whose keys are hashes of the dict values.

Return type:

The deserialised object.

get(access_attribute_value=None, **kwargs)

Get an object from this list that matches the given criteria.

Parameters:

access_attribute_value (str | None) –

Return type:

T

get_all(access_attribute_value=None, **kwargs)

Get all objects in this list that match the given criteria.

Parameters:

access_attribute_value (str | None) –

list_attrs()

Get a tuple of the unique access-attribute values of the constituent objects.

Return type:

tuple[str, …]

to_dict()

Serialize this object as a dictionary.

Return type:

dict[str, Any]

to_json_like(dct=None, shared_data=None, exclude=(), path=None)

Serialize this object as an object structure that can be trivially converted to JSON. Note that YAML can also be produced from the result of this method; it just requires a different final serialization step.

Parameters:

• dct (dict[str, JSONable] | None) –

• shared_data (_JSONDeserState) –

• exclude (Container[str | None]) –

• path (list | None) –

Return type:

tuple[JSONDocument, _JSONDeserState]