Merge branch 'release/7.1.3'

eventsourcing/__init__.py

@@ -1 +1 @@
-__version__ = '7.1.2'
+__version__ = '7.1.3'

eventsourcing/domain/model/entity.py

@@ -66,7 +66,7 @@ def __create__(cls, originator_id=None, event_class=None, **kwargs):
 
     class Created(Event, Created):
         """
-        Published when an entity is created.
+        Triggered when an entity is created.
         """
 
         def __init__(self, originator_topic, **kwargs):
@@ -101,7 +101,7 @@ def __change_attribute__(self, name, value):
 
     class AttributeChanged(Event, AttributeChanged):
         """
-        Published when a DomainEntity is discarded.
+        Triggered when a named attribute is assigned a new value.
         """
 
         def __mutate__(self, obj):
@@ -117,7 +117,7 @@ def __discard__(self):
 
     class Discarded(Discarded, Event):
         """
-        Published when a DomainEntity is discarded.
+        Triggered when a DomainEntity is discarded.
         """
 
         def __mutate__(self, obj):
@@ -221,6 +221,9 @@ def __mutate__(self, entity_class=None):
             # Call super method.
             return super(EntityWithHashchain.Created, self).__mutate__(entity_class)
 
+    class AttributeChanged(Event, DomainEntity.AttributeChanged):
+        pass
+
     class Discarded(Event, DomainEntity.Discarded):
         def __mutate__(self, obj):
             # Set entity head from event hash.
@@ -310,12 +313,6 @@ class AttributeChanged(Event, DomainEntity.AttributeChanged):
     class Discarded(Event, DomainEntity.Discarded):
         """Published when a VersionedEntity is discarded."""
 
-    # def __change_attribute__(self, name, value):
-    #     if self.__version__:
-    #         super(VersionedEntity, self).__change_attribute__(name, value)
-    #     else:
-    #         setattr(self, name, value)
-
 
 class TimestampedEntity(DomainEntity):
     def __init__(self, __created_on__=None, **kwargs):
@@ -335,7 +332,7 @@ class Event(DomainEntity.Event, EventWithTimestamp):
         """Supertype for events of timestamped entities."""
 
         def __mutate__(self, obj):
-            """Update obj with values from self."""
+            """Updates 'obj' with values from self."""
             obj = super(TimestampedEntity.Event, self).__mutate__(obj)
             if obj is not None:
                 assert isinstance(obj, TimestampedEntity), obj
@@ -358,6 +355,8 @@ class Discarded(Event, DomainEntity.Discarded):
         """Published when a TimestampedEntity is discarded."""
 
 
+# Todo: Move stuff from "test_customise_with_alternative_domain_event_type" in here (to define event classes
+#  and update ___last_event_id__ in mutate method).
 class TimeuuidedEntity(DomainEntity):
     def __init__(self, event_id, **kwargs):
         super(TimeuuidedEntity, self).__init__(**kwargs)