I define the specifications of an individual, including but not limited to parameter ranges.

A single attribute value is defined with the construct name = value or name value.

A dict of values is defined with just the dict name on a line by itself followed by a line of hyphens, e.g., -----. Then, after the hyphens, one or more key value lines. (Zero lines should make an empty dict, but is not supported.) Then another line of hyphens.

But dicts can be stacked! If a key has two parts separated by a colon, the first part is an entry in the top-level dict that is actually another dict, and the second part is an entry in that dict. For example,:

   params
   -------------------------------------------
   351:Rg        990
   351:ttrig     2E-4
   351:Vbatt     62.7
   361:Rg        82000
   361:ttrig     2E-4
   361:Vbatt     63.343
   371:ttrig     2E-3
   371:Vbatt     63.42
   -------------------------------------------

There are three sub-dicts inside params, accessible with the keys 351, 361, and 371.

Method	dict_start	Called by `SpecsLoader.read` when the first hyphens-line of a pair is encountered.
Method	dict_add	Adds the supplied value as an entry (or sub-entry) of a started dict with at least one key, more if it is a sub-entry.
Method	dict_done	Called by `SpecsLoader.read` when the second and last hyphens-line of a pair is encountered.
Method	add	Sets my attribute name to value.
Method	get	With a single argument, returns the value of the name attribute. With multiple arguments, returns the named entry of the named entry ... of the named dict.

def dict_start(self, name):

Called by SpecsLoader.read when the first hyphens-line of a pair is encountered.

def dict_add(self, value, *keys):

Adds the supplied value as an entry (or sub-entry) of a started dict with at least one key, more if it is a sub-entry.

def dict_done(self):

Called by SpecsLoader.read when the second and last hyphens-line of a pair is encountered.

def add(self, name, value):

Sets my attribute name to value.

def get(self, *names, **kw):

With a single argument, returns the value of the name attribute. With multiple arguments, returns the named entry of the named entry ... of the named dict.

Supply the the dict (and possibly sub-dict) name(s) in top-first order.

Returns an empty dict if the attribute or entry doesn't exist.

API Documentation for ade, generated by pydoctor at 2022-11-17 13:13:22.

ade.specs.Specs(object) class documentation

`ade.specs.Specs(object)` class documentation