def test_get_entity_events(self):
repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo=repo)
# Check there are zero stored events in the repo.
entity_events = event_store.get_entity_events(stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(0, len(entity_events))
# Store a domain event.
event1 = Example.Created(entity_id='entity1', a=1, b=2)
event_store.append(event1)
# Check there is one event in the event store.
entity_events = event_store.get_entity_events(stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(1, len(entity_events))
# Store another domain event.
event1 = Example.AttributeChanged(entity_id='entity1', a=1, b=2, entity_version=1)
event_store.append(event1)
# Check there are two events in the event store.
entity_events = event_store.get_entity_events(stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(2, len(entity_events))
# Check there are two events in the event store.
entity_events = event_store.get_entity_events(stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(2, len(entity_events))
def setUp(self):
assert_event_handlers_empty()
# Setup the repo, and a persistence subscriber.
stored_event_repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo=stored_event_repo)
self.repo = CollectionRepo(event_store=event_store)
self.ps = PersistenceSubscriber(event_store=event_store)
def create_event_store(self,
json_encoder_cls=None,
json_decoder_cls=None,
cipher=None,
always_encrypt=False):
transcoder = self.create_transcoder(always_encrypt, cipher,
json_decoder_cls, json_encoder_cls)
return EventStore(
stored_event_repo=self.stored_event_repo,
transcoder=transcoder,
)
def setUp(self):
super(LogTestCase, self).setUp()
# Check we're starting clean, event handler-wise.
assert_event_handlers_empty()
# Setup the persistence subscriber.
self.event_store = EventStore(self.stored_event_repo)
self.persistence_subscriber = PersistenceSubscriber(event_store=self.event_store)
self.log_repo = LogRepo(self.event_store)
def test_get_item(self):
# Setup an event store.
stored_event_repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo=stored_event_repo)
# Put an event in the event store.
entity_id = 'entity1'
event_store.append(Example.Created(entity_id=entity_id, a=1, b=2))
# Setup an example repository.
example_repo = ExampleRepo(event_store=event_store)
# Check the repo has the example.
self.assertIn(entity_id, example_repo)
self.assertNotIn('xxxxxxxx', example_repo)
# Check the entity attributes.
example = example_repo[entity_id]
self.assertEqual(1, example.a)
self.assertEqual(2, example.b)
self.assertEqual(entity_id, example.id)
def test_get_entity_events(self):
repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo=repo)
# Check there are zero stored events in the repo.
entity_events = event_store.get_entity_events(
stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(0, len(entity_events))
# Store a domain event.
event1 = Example.Created(entity_id='entity1', a=1, b=2)
event_store.append(event1)
# Check there is one event in the event store.
entity_events = event_store.get_entity_events(
stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(1, len(entity_events))
# Store another domain event.
event1 = Example.AttributeChanged(entity_id='entity1',
a=1,
b=2,
entity_version=1)
event_store.append(event1)
# Check there are two events in the event store.
entity_events = event_store.get_entity_events(
stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(2, len(entity_events))
# Check there are two events in the event store.
entity_events = event_store.get_entity_events(
stored_entity_id='Example::entity1')
entity_events = list(entity_events)
self.assertEqual(2, len(entity_events))
def test_with_snapshots(self):
# Check the EventPlayer's take_snapshot() method.
stored_event_repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo)
self.ps = PersistenceSubscriber(event_store)
event_player = EventPlayer(
event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate,
snapshot_strategy=EventSourcedSnapshotStrategy(
event_store=event_store))
# Check the method returns None when there are no events.
snapshot = event_player.take_snapshot('wrong')
self.assertIsNone(snapshot)
# Create a new entity.
example = register_new_example(a=123, b=234)
# Take a snapshot with the entity.
snapshot1 = event_player.take_snapshot(example.id)
self.assertIsInstance(snapshot1, Snapshot)
# Take another snapshot with the entity.
snapshot2 = event_player.take_snapshot(example.id)
# - should return the previous snapshot
self.assertIsInstance(snapshot2, Snapshot)
self.assertEqual(snapshot2.at_event_id, snapshot1.at_event_id)
# Generate a domain event.
example.beat_heart()
# Take another snapshot with the entity.
# - should use the previous snapshot and the heartbeat event
snapshot3 = event_player.take_snapshot(example.id)
self.assertNotEqual(snapshot3.at_event_id, snapshot1.at_event_id)
def test_snapshots(self):
stored_event_repo = PythonObjectsStoredEventRepository()
event_store = EventStore(stored_event_repo)
self.ps = PersistenceSubscriber(event_store)
event_player = EventPlayer(event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate)
# Create a new entity.
registered_example = register_new_example(a=123, b=234)
# Take a snapshot.
snapshot = take_snapshot(registered_example, uuid1().hex)
# Replay from this snapshot.
after = snapshot.at_event_id
initial_state = entity_from_snapshot(snapshot)
retrieved_example = event_player.replay_events(
registered_example.id, initial_state=initial_state, after=after)
# Check the attributes are correct.
self.assertEqual(retrieved_example.a, 123)
# Remember the time now.
timecheck1 = uuid1().hex
# Change attribute value.
retrieved_example.a = 999
# Check the initial state doesn't move.
self.assertEqual(initial_state.a, 123)
# Remember the time now.
timecheck2 = uuid1().hex
# Change attribute value.
retrieved_example.a = 9999
# Remember the time now.
timecheck3 = uuid1().hex
# Check the event sourced entities are correct.
assert initial_state.a == 123
retrieved_example = event_player.replay_events(registered_example.id)
self.assertEqual(retrieved_example.a, 9999)
# Take another snapshot.
snapshot2 = take_snapshot(retrieved_example, uuid1().hex)
# Check we can replay from this snapshot.
initial_state2 = entity_from_snapshot(snapshot2)
after2 = snapshot2.domain_event_id
retrieved_example = event_player.replay_events(
registered_example.id, initial_state=initial_state2, after=after2)
# Check the attributes are correct.
self.assertEqual(retrieved_example.a, 9999)
# Check we can get historical state at timecheck1.
retrieved_example = event_player.replay_events(registered_example.id,
until=timecheck1)
self.assertEqual(retrieved_example.a, 123)
# Check we can get historical state at timecheck2.
retrieved_example = event_player.replay_events(registered_example.id,
until=timecheck2)
self.assertEqual(retrieved_example.a, 999)
# Check we can get historical state at timecheck3.
retrieved_example = event_player.replay_events(registered_example.id,
until=timecheck3)
self.assertEqual(retrieved_example.a, 9999)
# Similarly, check we can get historical state using a snapshot
retrieved_example = event_player.replay_events(
registered_example.id,
initial_state=initial_state,
after=after,
until=timecheck2)
self.assertEqual(retrieved_example.a, 999)
def test_get_entity(self):
# Setup an event store, using Python objects.
event_store = EventStore(
stored_event_repo=PythonObjectsStoredEventRepository())
# Store example events.
event1 = Example.Created(entity_id='entity1', a=1, b=2)
event_store.append(event1)
event2 = Example.Created(entity_id='entity2', a=2, b=4)
event_store.append(event2)
event3 = Example.Created(entity_id='entity3', a=3, b=6)
event_store.append(event3)
event4 = Example.Discarded(entity_id='entity3', entity_version=1)
event_store.append(event4)
# Check the event sourced entities are correct.
# - just use a trivial mutate that always instantiates the 'Example'.
event_player = EventPlayer(event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate)
# The the reconstituted entity has correct attribute values.
self.assertEqual('entity1', event_player.replay_events('entity1').id)
self.assertEqual(1, event_player.replay_events('entity1').a)
self.assertEqual(2, event_player.replay_events('entity2').a)
self.assertEqual(None, event_player.replay_events('entity3'))
# Check entity3 raises KeyError.
self.assertEqual(event_player.replay_events('entity3'), None)
# Check it works for "short" entities (should be faster, but the main thing is that it still works).
# - just use a trivial mutate that always instantiates the 'Example'.
event5 = Example.AttributeChanged(entity_id='entity1',
entity_version=1,
name='a',
value=10)
event_store.append(event5)
event_player = EventPlayer(event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate)
self.assertEqual(10, event_player.replay_events('entity1').a)
event_player = EventPlayer(
event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate,
is_short=True,
)
self.assertEqual(10, event_player.replay_events('entity1').a)
def test_get_entity(self):
# Setup an event store, using Python objects.
event_store = EventStore(stored_event_repo=PythonObjectsStoredEventRepository())
# Store example events.
event1 = Example.Created(entity_id='entity1', a=1, b=2)
event_store.append(event1)
event2 = Example.Created(entity_id='entity2', a=2, b=4)
event_store.append(event2)
event3 = Example.Created(entity_id='entity3', a=3, b=6)
event_store.append(event3)
event4 = Example.Discarded(entity_id='entity3', entity_version=1)
event_store.append(event4)
# Check the event sourced entities are correct.
# - just use a trivial mutate that always instantiates the 'Example'.
event_player = EventPlayer(event_store=event_store, id_prefix='Example', mutate_func=Example.mutate)
# The the reconstituted entity has correct attribute values.
self.assertEqual('entity1', event_player.replay_events('entity1').id)
self.assertEqual(1, event_player.replay_events('entity1').a)
self.assertEqual(2, event_player.replay_events('entity2').a)
self.assertEqual(None, event_player.replay_events('entity3'))
# Check entity3 raises KeyError.
self.assertEqual(event_player.replay_events('entity3'), None)
# Check it works for "short" entities (should be faster, but the main thing is that it still works).
# - just use a trivial mutate that always instantiates the 'Example'.
event5 = Example.AttributeChanged(entity_id='entity1', entity_version=1, name='a', value=10)
event_store.append(event5)
event_player = EventPlayer(event_store=event_store, id_prefix='Example', mutate_func=Example.mutate)
self.assertEqual(10, event_player.replay_events('entity1').a)
event_player = EventPlayer(
event_store=event_store,
id_prefix='Example',
mutate_func=Example.mutate,
is_short=True,
)
self.assertEqual(10, event_player.replay_events('entity1').a)
def setUp(self):
# Setup the persistence subscriber.
self.event_store = EventStore(PythonObjectsStoredEventRepository())
self.persistence_subscriber = PersistenceSubscriber(
event_store=self.event_store)