2014-03-10 21:36:47 +00:00
|
|
|
from __future__ import absolute_import
|
|
|
|
|
2014-09-16 21:54:17 +00:00
|
|
|
|
2014-01-31 03:45:39 +00:00
|
|
|
class StateObject(object):
|
2014-01-31 00:06:35 +00:00
|
|
|
"""
|
2014-09-16 23:35:14 +00:00
|
|
|
An object with serializable state.
|
2014-01-31 00:06:35 +00:00
|
|
|
|
2014-09-16 23:35:14 +00:00
|
|
|
State attributes can either be serializable types(str, tuple, bool, ...)
|
|
|
|
or StateObject instances themselves.
|
2014-01-31 00:06:35 +00:00
|
|
|
"""
|
2014-09-16 23:35:14 +00:00
|
|
|
# An attribute-name -> class-or-type dict containing all attributes that
|
|
|
|
# should be serialized. If the attribute is a class, it must be a subclass
|
|
|
|
# of StateObject.
|
|
|
|
_stateobject_attributes = None
|
2014-01-31 00:06:35 +00:00
|
|
|
|
|
|
|
def _get_state_attr(self, attr, cls):
|
|
|
|
val = getattr(self, attr)
|
2014-09-16 23:35:14 +00:00
|
|
|
if hasattr(val, "get_state"):
|
|
|
|
return val.get_state()
|
2014-01-31 00:06:35 +00:00
|
|
|
else:
|
|
|
|
return val
|
|
|
|
|
2014-09-16 23:35:14 +00:00
|
|
|
def from_state(self):
|
|
|
|
raise NotImplementedError
|
2014-01-31 00:06:35 +00:00
|
|
|
|
2014-09-16 23:35:14 +00:00
|
|
|
def get_state(self):
|
|
|
|
state = {}
|
|
|
|
for attr, cls in self._stateobject_attributes.iteritems():
|
|
|
|
state[attr] = self._get_state_attr(attr, cls)
|
|
|
|
return state
|
2014-09-16 21:54:17 +00:00
|
|
|
|
2014-09-16 23:35:14 +00:00
|
|
|
def load_state(self, state):
|
|
|
|
for attr, cls in self._stateobject_attributes.iteritems():
|
|
|
|
if state.get(attr, None) is None:
|
|
|
|
setattr(self, attr, None)
|
|
|
|
else:
|
|
|
|
curr = getattr(self, attr)
|
|
|
|
if hasattr(curr, "load_state"):
|
|
|
|
curr.load_state(state[attr])
|
|
|
|
elif hasattr(cls, "from_state"):
|
|
|
|
setattr(self, attr, cls.from_state(state[attr]))
|
|
|
|
else:
|
|
|
|
setattr(self, attr, cls(state[attr]))
|