2021-01-03 16:33:40 +05:30
|
|
|
import copy
|
2020-09-30 11:23:25 +05:30
|
|
|
from io import StringIO
|
|
|
|
import abc
|
|
|
|
|
2020-10-27 02:08:24 +05:30
|
|
|
import numpy as np
|
2020-09-30 11:23:25 +05:30
|
|
|
import yaml
|
|
|
|
|
2021-03-08 21:07:07 +05:30
|
|
|
from . import Rotation
|
|
|
|
from . import Orientation
|
|
|
|
|
2020-09-30 11:23:25 +05:30
|
|
|
class NiceDumper(yaml.SafeDumper):
|
|
|
|
"""Make YAML readable for humans."""
|
|
|
|
|
|
|
|
def write_line_break(self, data=None):
|
|
|
|
super().write_line_break(data)
|
|
|
|
|
|
|
|
if len(self.indents) == 1:
|
|
|
|
super().write_line_break()
|
|
|
|
|
|
|
|
def increase_indent(self, flow=False, indentless=False):
|
|
|
|
return super().increase_indent(flow, False)
|
|
|
|
|
2020-10-27 02:08:24 +05:30
|
|
|
def represent_data(self, data):
|
2020-10-27 02:13:21 +05:30
|
|
|
"""Cast Config objects and its subclasses to dict."""
|
2021-03-08 21:07:07 +05:30
|
|
|
if isinstance(data, dict) and type(data) != dict:
|
|
|
|
return self.represent_data(dict(data))
|
|
|
|
if isinstance(data, (Rotation, Orientation)):
|
|
|
|
return self.represent_data(data.as_quaternion())
|
|
|
|
else:
|
|
|
|
return super().represent_data(data)
|
2020-10-27 02:08:24 +05:30
|
|
|
|
2020-12-18 19:49:04 +05:30
|
|
|
def ignore_aliases(self, data):
|
|
|
|
"""No references."""
|
|
|
|
return True
|
2020-09-30 11:23:25 +05:30
|
|
|
|
|
|
|
class Config(dict):
|
|
|
|
"""YAML-based configuration."""
|
|
|
|
|
|
|
|
def __repr__(self):
|
|
|
|
"""Show as in file."""
|
|
|
|
output = StringIO()
|
|
|
|
self.save(output)
|
|
|
|
output.seek(0)
|
|
|
|
return ''.join(output.readlines())
|
|
|
|
|
2021-01-03 16:33:40 +05:30
|
|
|
|
|
|
|
def __copy__(self):
|
|
|
|
"""Create deep copy."""
|
|
|
|
return copy.deepcopy(self)
|
|
|
|
|
|
|
|
copy = __copy__
|
|
|
|
|
|
|
|
|
2020-09-30 11:23:25 +05:30
|
|
|
@classmethod
|
|
|
|
def load(cls,fname):
|
2020-09-30 12:19:55 +05:30
|
|
|
"""
|
|
|
|
Load from yaml file.
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
----------
|
|
|
|
fname : file, str, or pathlib.Path
|
|
|
|
Filename or file for writing.
|
|
|
|
|
|
|
|
"""
|
2020-09-30 11:23:25 +05:30
|
|
|
try:
|
|
|
|
fhandle = open(fname)
|
|
|
|
except TypeError:
|
|
|
|
fhandle = fname
|
|
|
|
return cls(yaml.safe_load(fhandle))
|
|
|
|
|
2021-01-03 16:33:40 +05:30
|
|
|
|
2020-09-30 16:02:37 +05:30
|
|
|
def save(self,fname,**kwargs):
|
2020-09-30 11:23:25 +05:30
|
|
|
"""
|
|
|
|
Save to yaml file.
|
|
|
|
|
|
|
|
Parameters
|
|
|
|
----------
|
|
|
|
fname : file, str, or pathlib.Path
|
2020-09-30 12:19:55 +05:30
|
|
|
Filename or file for writing.
|
2020-09-30 16:02:37 +05:30
|
|
|
**kwargs : dict
|
|
|
|
Keyword arguments parsed to yaml.dump.
|
2020-09-30 11:23:25 +05:30
|
|
|
|
|
|
|
"""
|
|
|
|
try:
|
2021-02-10 14:33:35 +05:30
|
|
|
fhandle = open(fname,'w',newline='\n')
|
2020-09-30 11:23:25 +05:30
|
|
|
except TypeError:
|
|
|
|
fhandle = fname
|
2020-09-30 16:02:37 +05:30
|
|
|
|
|
|
|
if 'width' not in kwargs:
|
|
|
|
kwargs['width'] = 256
|
|
|
|
if 'default_flow_style' not in kwargs:
|
|
|
|
kwargs['default_flow_style'] = None
|
2020-10-27 02:13:21 +05:30
|
|
|
if 'sort_keys' not in kwargs:
|
|
|
|
kwargs['sort_keys'] = False
|
2020-10-27 02:08:24 +05:30
|
|
|
|
|
|
|
def array_representer(dumper, data):
|
|
|
|
"""Convert numpy array to list of native types."""
|
|
|
|
return dumper.represent_list([d.item() for d in data])
|
|
|
|
|
|
|
|
NiceDumper.add_representer(np.ndarray, array_representer)
|
|
|
|
|
2020-10-27 11:04:05 +05:30
|
|
|
try:
|
|
|
|
fhandle.write(yaml.dump(self,Dumper=NiceDumper,**kwargs))
|
|
|
|
except TypeError: # compatibility with old pyyaml
|
|
|
|
del kwargs['sort_keys']
|
|
|
|
fhandle.write(yaml.dump(self,Dumper=NiceDumper,**kwargs))
|
2020-09-30 11:23:25 +05:30
|
|
|
|
|
|
|
|
2021-01-03 16:39:21 +05:30
|
|
|
def add(self,d):
|
|
|
|
"""
|
|
|
|
Add dictionary.
|
|
|
|
|
|
|
|
d : dict
|
|
|
|
Dictionary to append.
|
|
|
|
"""
|
|
|
|
duplicate = self.copy()
|
|
|
|
duplicate.update(d)
|
|
|
|
return duplicate
|
|
|
|
|
|
|
|
|
|
|
|
def delete(self,key):
|
|
|
|
"""
|
|
|
|
Delete item.
|
|
|
|
|
2021-01-07 04:33:10 +05:30
|
|
|
key : str or scalar
|
2021-01-03 16:39:21 +05:30
|
|
|
Label of the key to remove.
|
|
|
|
"""
|
|
|
|
duplicate = self.copy()
|
|
|
|
del duplicate[key]
|
|
|
|
return duplicate
|
|
|
|
|
|
|
|
|
2020-09-30 11:23:25 +05:30
|
|
|
@property
|
|
|
|
@abc.abstractmethod
|
|
|
|
def is_complete(self):
|
|
|
|
"""Check for completeness."""
|
|
|
|
pass
|
|
|
|
|
2021-01-03 16:33:40 +05:30
|
|
|
|
2020-09-30 11:23:25 +05:30
|
|
|
@property
|
|
|
|
@abc.abstractmethod
|
|
|
|
def is_valid(self):
|
|
|
|
"""Check for valid file layout."""
|
|
|
|
pass
|