attune.Instrument

class attune.Instrument(arrangements: Dict[str, Union[attune._arrangement.Arrangement, dict]], setables: Optional[Dict[str, Optional[Union[attune._setable.Setable, dict]]]] = None, *, name: Optional[str] = None, transition: Optional[Union[attune._transition.Transition, dict]] = None, load: Optional[float] = None)[source]

Bases: object

__init__(arrangements: Dict[str, Union[attune._arrangement.Arrangement, dict]], setables: Optional[Dict[str, Optional[Union[attune._setable.Setable, dict]]]] = None, *, name: Optional[str] = None, transition: Optional[Union[attune._transition.Transition, dict]] = None, load: Optional[float] = None)[source]

Representation of a system of arrangements for an instrument.

Parameters
  • arrangements (Dict[str, Union[Arrangement, dict]) – Dictionary of arrangements in the instrument

  • setables (Dict[str, Optional[Union[Setable, dict]]]) – Settable values in the instrument

  • name (Optional[str]) – The name of the instrument, used to store/retrieve the instrument.

  • transition (Optional[Union[Transition, dict]]) – The operation which creates this instrument. If not given, will be “create”.

  • load (Optional[float]) – POSIX timestamp of the tune when retrieved from the store. Ignore for instruments not retrieved from the store.

property arrangements

The arrangements associated with this instrument.

as_dict()[source]

Dictionary representation for this Instrument.

property load

The POSIX timestamp for when this instrument was created, if it was stored.

property name

The name of the instrument.

This is the key that is used to store/retrieve the instrument.

save(file)[source]

Save the JSON representation into an open file.

property setables

The setables associated with this instrument.

property transition

The transition operation that generated this instrument.