[docs]def first(l):
if l:
return l[0]
[docs]def first_value(d):
if d:
return d[list(d.keys())[0]]
[docs]class Datum(dict):
'''
The Datum class enables functions to be defined on dicts of a certain schema.
It provides two class level variables:
* `defaults`: a dictionary of keys to default values this Datum will have if
none is provided to __init__
* `schema`: a dictionary of keys to constructors which invoke subdata.
Once these are defined, a Datum subclass can be constructed with a dict that provides any
values beyond the defaults, and then all of the defined methods for that Datum subclass
are available to operate on its values. Once the modifications are complete, it can be
rendered back into a dict using the `to_dict()` method.
'''
schema = {}
defaults = {}
def __init__(self, config):
self.update(self.defaults)
self.update(config)
self.__dict__ = self
for schema, realize in self.schema.items():
if schema in self:
value = self[schema]
if isinstance(value, list):
value = [realize(item) for item in value]
elif isinstance(value, dict):
value = {inner: realize(item) for inner, item in value.items()}
else:
value = realize(item)
self[schema] = value
[docs] def to_dict(self):
return self
[docs] def fields(self):
return list(self.defaults.keys())
def __repr__(self):
return str(type(self)) + ': ' + str({
key: value for key, value in self.items()})