for testing and deploying your application
for finding and fixing issues
for empowering human code reviews
"""Functions to interact with mapped classes and instances."""
from . import common, exceptions
log = common.logger(__name__)
def new(cls, *args):
"""Create a new mapped object."""
instance = cls(*args)
mapper = _ensure_mapped(instance)
if mapper.exists:
msg = "{!r} already exists".format(mapper.path)
raise exceptions.DuplicateMappingError(msg)
return save(instance)
def find(cls, *args, create=False):
"""Find a matching mapped object or return None."""
return instance
elif create:
else:
return None
def load(cls, **kwargs):
"""Return a list of all matching mapped objects."""
log.debug((cls, kwargs))
raise NotImplementedError
def save(instance):
"""Save a mapped object to file."""
if mapper.deleted:
msg = "{!r} was deleted".format(mapper.path)
raise exceptions.DeletedFileError(msg)
if not mapper.exists:
mapper.create()
mapper.store()
def delete(instance):
"""Delete a mapped object's file."""
mapper.delete()
def _ensure_mapped(obj, *, expected=True):
mapper = common.get_mapper(obj)
if mapper and not expected:
msg = "{!r} is already mapped".format(obj)
raise TypeError(msg)
if not mapper and expected:
msg = "{!r} is not mapped".format(obj)
return mapper
jacebrowning /
yorm
