for testing and deploying your application
for finding and fixing issues
for empowering human code reviews
"""Converter classes."""
from abc import ABCMeta, abstractclassmethod, abstractmethod
from .. import common
from . import Mappable
log = common.logger(__name__)
class Converter(metaclass=ABCMeta):
"""Base class for attribute converters."""
@abstractclassmethod
def create_default(cls):
"""Create a default value for an attribute."""
raise NotImplementedError(common.OVERRIDE_MESSAGE)
def to_value(cls, data):
"""Convert loaded data to an attribute's value."""
def to_data(cls, value):
"""Convert an attribute to data optimized for dumping."""
class Container(Mappable, Converter, metaclass=ABCMeta):
"""Base class for mutable attribute converters."""
@classmethod
return cls.__new__(cls)
value = cls.create_default()
value.update_value(data, auto_attr=True)
return value
@abstractmethod
def update_value(self, data, *, auto_attr): # pragma: no cover (abstract method)
"""Update the attribute's value from loaded data."""
def format_data(self):
"""Format the attribute to data optimized for dumping."""
return self.to_data(self)
jacebrowning /
yorm
