ruby_event_store 0.21.0 → 0.22.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: cfb0772fe901e15fc75b778a04a4dd73192b0407
-  data.tar.gz: '07929227f6b1964589cef0962edce96e47cb4198'
+  metadata.gz: 99a317191ac0b7798f70cb2f044b8dd5093e26be
+  data.tar.gz: 2459057d0fe80e5a2c740ec24e27513994807af6
 SHA512:
-  metadata.gz: b7207f55c941d2e1bcd48cf656ef001750c9a17617507f38438e671ab8e2b288a6b045a5aec2731ff7da28462e872e76628094dbe80a6f8696238e67fa35ee72
-  data.tar.gz: ee9af3042920d3a5fb9fe407eb0b0e47a6f46cb0fdf160f1a26f245ee5e057a433b3a1f35eda6afa72c77ef09a7a2423d3e8b7c3b573aeb835c912be2250ce2d
+  metadata.gz: 58a68c35017820ec1375810a16aadf00c744b69a2e61c95523abde8b54637996b5555eff582fd2e5d9fb628623462cb08e43e9168803e873f7c041572d5eb5cf
+  data.tar.gz: 58b2abff609bca93bf3b77f429c7980ddba3a1abdeaa583af33915398152e05faf52738c11a13b7b1edaf8184905c5e464e11d2513c52ee78868ac488b6365dd

data/lib/ruby_event_store/client.rb

@@ -31,6 +31,11 @@ module RubyEventStore
       :ok
     end
 
+    def link_to_stream(event_ids, stream_name:, expected_version: :any)
+      repository.link_to_stream(event_ids, stream_name, expected_version)
+      self
+    end
+
     def delete_stream(stream_name)
       raise IncorrectStreamData if stream_name.nil? || stream_name.empty?
       repository.delete_stream(stream_name)
@@ -119,7 +124,7 @@ module RubyEventStore
         else
           start = start.to_s
           raise InvalidPageStart if start.empty?
-          raise EventNotFound unless repository.has_event?(start)
+          raise EventNotFound.new(start) unless repository.has_event?(start)
         end
         raise InvalidPageSize unless count > 0
         @start = start

data/lib/ruby_event_store/errors.rb

@@ -2,11 +2,19 @@ module RubyEventStore
   WrongExpectedEventVersion  = Class.new(StandardError)
   InvalidExpectedVersion     = Class.new(StandardError)
   IncorrectStreamData        = Class.new(StandardError)
-  EventNotFound              = Class.new(StandardError)
   SubscriberNotExist         = Class.new(StandardError)
   InvalidPageStart           = Class.new(ArgumentError)
   InvalidPageSize            = Class.new(ArgumentError)
   EventDuplicatedInStream    = Class.new(StandardError)
+  NotSupported               = Class.new(StandardError)
+
+  class EventNotFound < StandardError
+    attr_reader :event_id
+    def initialize(event_id)
+      super("Event not found: #{event_id}")
+      @event_id = event_id
+    end
+  end
 
   class InvalidHandler < StandardError
     def initialize(object)

data/lib/ruby_event_store/in_memory_repository.rb

@@ -10,21 +10,12 @@ module RubyEventStore
     end
 
     def append_to_stream(events, stream_name, expected_version)
-      raise InvalidExpectedVersion if !expected_version.equal?(:any) && stream_name.eql?(GLOBAL_STREAM)
-      events = normalize_to_array(events)
-      stream = read_stream_events_forward(stream_name)
-      expected_version = case expected_version
-        when :none
-          -1
-        when :auto, :any
-          stream.size - 1
-        when Integer
-          expected_version
-        else
-          raise InvalidExpectedVersion
-      end
-      append_with_synchronize(events, expected_version, stream, stream_name)
-      self
+      add_to_stream(events, expected_version, stream_name, true)
+    end
+
+    def link_to_stream(event_ids, stream_name, expected_version)
+      events = normalize_to_array(event_ids).map{|eid| read_event(eid) }
+      add_to_stream(events, expected_version, stream_name, nil)
     end
 
     def delete_stream(stream_name)
@@ -66,7 +57,7 @@ module RubyEventStore
     end
 
     def read_event(event_id)
-      all.find { |e| event_id.equal?(e.event_id) } or raise EventNotFound
+      all.find { |e| event_id.eql?(e.event_id) } or raise EventNotFound.new(event_id)
     end
 
     def get_all_streams
@@ -80,7 +71,24 @@ module RubyEventStore
       return *events
     end
 
-    def append_with_synchronize(events, expected_version, stream, stream_name)
+    def add_to_stream(events, expected_version, stream_name, include_global)
+      raise InvalidExpectedVersion if !expected_version.equal?(:any) && stream_name.eql?(GLOBAL_STREAM)
+      events = normalize_to_array(events)
+      stream = read_stream_events_forward(stream_name)
+      expected_version = case expected_version
+        when :none
+          -1
+        when :auto, :any
+          stream.size - 1
+        when Integer
+          expected_version
+        else
+         raise InvalidExpectedVersion
+      end
+      append_with_synchronize(events, expected_version, stream, stream_name, include_global)
+    end
+
+    def append_with_synchronize(events, expected_version, stream, stream_name, include_global)
       # expected_version :auto assumes external lock is used
       # which makes reading stream before writing safe.
       #
@@ -90,18 +98,22 @@ module RubyEventStore
       # not for the whole read+write algorithm.
       Thread.pass
       @mutex.synchronize do
-        append(events, expected_version, stream, stream_name)
+        append(events, expected_version, stream, stream_name, include_global)
       end
     end
 
-    def append(events, expected_version, stream, stream_name)
+    def append(events, expected_version, stream, stream_name, include_global)
       raise WrongExpectedEventVersion unless (stream.size - 1).equal?(expected_version)
       events.each do |event|
-        all.push(event)
         raise EventDuplicatedInStream if stream.any?{|ev| ev.event_id.eql?(event.event_id) }
+        if include_global
+          raise EventDuplicatedInStream if all.any?{|ev| ev.event_id.eql?(event.event_id) }
+          all.push(event)
+        end
         stream.push(event)
       end
       streams[stream_name] = stream
+      self
     end
 
     def read_batch(source, start_event_id, count)

data/lib/ruby_event_store/spec/event_repository_lint.rb

@@ -6,25 +6,55 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_all_streams_forward(:head, 1)).to be_empty
   end
 
-  specify 'publish fail if expected version is nil' do
+  specify 'append_to_stream fail if expected version is nil' do
     expect do
       repository.append_to_stream(event = TestDomainEvent.new, 'stream', nil)
     end.to raise_error(RubyEventStore::InvalidExpectedVersion)
   end
 
+  specify 'link_to_stream fail if expected version is nil' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream(event = TestDomainEvent.new, 'stream', :any)
+    expect do
+      repository.link_to_stream(event.event_id, 'stream', nil)
+    end.to raise_error(RubyEventStore::InvalidExpectedVersion)
+  end
+
   specify 'append_to_stream returns self' do
     repository.
       append_to_stream(event = TestDomainEvent.new, 'stream', -1).
       append_to_stream(event = TestDomainEvent.new, 'stream', 0)
   end
 
-  specify 'adds initial event to a new stream' do
+  specify 'link_to_stream returns self' do
+    skip unless test_link_events_to_stream
+    event0 = TestDomainEvent.new
+    event1 = TestDomainEvent.new
+    repository.
+      append_to_stream([event0, event1], 'stream0', -1).
+      link_to_stream(event0.event_id, 'flow', -1).
+      link_to_stream(event1.event_id, 'flow', 0)
+  end
+
+  specify 'adds an initial event to a new stream' do
     repository.append_to_stream(event = TestDomainEvent.new, 'stream', :none)
     expect(repository.read_all_streams_forward(:head, 1).first).to eq(event)
     expect(repository.read_stream_events_forward('stream').first).to eq(event)
     expect(repository.read_stream_events_forward('other_stream')).to be_empty
   end
 
+  specify 'links an initial event to a new stream' do
+    skip unless test_link_events_to_stream
+    repository.
+      append_to_stream(event = TestDomainEvent.new, 'stream', :none).
+      link_to_stream(event.event_id, 'flow', :none)
+
+    expect(repository.read_all_streams_forward(:head, 1).first).to eq(event)
+    expect(repository.read_stream_events_forward('stream').first).to eq(event)
+    expect(repository.read_stream_events_forward('flow')).to eq([event])
+    expect(repository.read_stream_events_forward('other')).to be_empty
+  end
+
   specify 'adds multiple initial events to a new stream' do
     repository.append_to_stream([
       event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -34,6 +64,19 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1])
   end
 
+  specify 'links multiple initial events to a new stream' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :none).link_to_stream([
+      event0.event_id,
+      event1.event_id,
+    ], 'flow', :none)
+    expect(repository.read_all_streams_forward(:head, 2)).to eq([event0, event1])
+    expect(repository.read_stream_events_forward('flow')).to eq([event0, event1])
+  end
+
   specify 'correct expected version on second write' do
     repository.append_to_stream([
       event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -47,6 +90,22 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1, event2, event3])
   end
 
+  specify 'correct expected version on second link' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :none).append_to_stream([
+      event2 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event3 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'flow', :none).link_to_stream([
+      event0.event_id,
+      event1.event_id,
+    ], 'flow', 1)
+    expect(repository.read_all_streams_forward(:head, 4)).to eq([event0, event1, event2, event3])
+    expect(repository.read_stream_events_forward('flow')).to eq([event2, event3, event0, event1])
+  end
+
   specify 'incorrect expected version on second write' do
     repository.append_to_stream([
       event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -63,6 +122,27 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1])
   end
 
+  specify 'incorrect expected version on second link' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :none)
+    repository.append_to_stream([
+      event2 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event3 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'other', -1)
+    expect do
+      repository.link_to_stream([
+        event2.event_id,
+        event3.event_id,
+      ], 'stream', 0)
+    end.to raise_error(RubyEventStore::WrongExpectedEventVersion)
+
+    expect(repository.read_all_streams_forward(:head, 4)).to eq([event0, event1, event2, event3])
+    expect(repository.read_stream_events_forward('stream')).to eq([event0, event1])
+  end
+
   specify ':none on first and subsequent write' do
     repository.append_to_stream([
       eventA = TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -76,6 +156,22 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([eventA])
   end
 
+  specify ':none on first and subsequent link' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      eventA = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      eventB = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :none)
+
+    repository.link_to_stream([eventA.event_id], 'flow', :none)
+    expect do
+      repository.link_to_stream([eventB.event_id], 'flow', :none)
+    end.to raise_error(RubyEventStore::WrongExpectedEventVersion)
+
+    expect(repository.read_all_streams_forward(:head, 1)).to eq([eventA])
+    expect(repository.read_stream_events_forward('flow')).to eq([eventA])
+  end
+
   specify ':any allows stream with best-effort order and no guarantee' do
     repository.append_to_stream([
       event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -89,6 +185,26 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream').to_set).to eq(Set.new([event0, event1, event2, event3]))
   end
 
+  specify ':any allows linking in stream with best-effort order and no guarantee' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event2 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event3 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :any)
+
+    repository.link_to_stream([
+      event0.event_id, event1.event_id,
+    ], 'flow', :any)
+    repository.link_to_stream([
+      event2.event_id, event3.event_id,
+    ], 'flow', :any)
+
+    expect(repository.read_all_streams_forward(:head, 4).to_set).to eq(Set.new([event0, event1, event2, event3]))
+    expect(repository.read_stream_events_forward('flow').to_set).to eq(Set.new([event0, event1, event2, event3]))
+  end
+
   specify ':auto queries for last position in given stream' do
     skip unless test_expected_version_auto
     repository.append_to_stream([
@@ -106,6 +222,25 @@ RSpec.shared_examples :event_repository do |repository_class|
     ], 'stream', 1)
   end
 
+  specify ':auto queries for last position in given stream when linking' do
+    skip unless test_expected_version_auto
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      eventA = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      eventB = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      eventC = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'another', :auto)
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :auto)
+    repository.link_to_stream([
+      eventA.event_id,
+      eventB.event_id,
+      eventC.event_id,
+    ], 'stream', 1)
+  end
+
   specify ':auto starts from 0' do
     skip unless test_expected_version_auto
     repository.append_to_stream([
@@ -118,6 +253,22 @@ RSpec.shared_examples :event_repository do |repository_class|
     end.to raise_error(RubyEventStore::WrongExpectedEventVersion)
   end
 
+  specify ':auto linking starts from 0' do
+    skip unless test_expected_version_auto
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'whatever', :auto)
+    repository.link_to_stream([
+      event0.event_id,
+    ], 'stream', :auto)
+    expect do
+      repository.append_to_stream([
+        event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      ], 'stream', -1)
+    end.to raise_error(RubyEventStore::WrongExpectedEventVersion)
+  end
+
   specify ':auto queries for last position and follows in incremental way' do
     skip unless test_expected_version_auto
     # It is expected that there is higher level lock
@@ -137,6 +288,28 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1, event2, event3])
   end
 
+  specify ':auto queries for last position and follows in incremental way when linking' do
+    skip unless test_expected_version_auto
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event2 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event3 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :auto)
+    repository.link_to_stream([
+      event0.event_id, event1.event_id,
+    ], 'flow', :auto)
+    repository.link_to_stream([
+      event2.event_id, event3.event_id,
+    ], 'flow', :auto)
+    expect(repository.read_all_streams_forward(:head, 4)).to eq([
+      event0, event1,
+      event2, event3
+    ])
+    expect(repository.read_stream_events_forward('flow')).to eq([event0, event1, event2, event3])
+  end
+
   specify ':auto is compatible with manual expectation' do
     skip unless test_expected_version_auto
     repository.append_to_stream([
@@ -151,6 +324,23 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1, event2, event3])
   end
 
+  specify ':auto is compatible with manual expectation when linking' do
+    skip unless test_expected_version_auto
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :auto)
+    repository.link_to_stream([
+      event0.event_id,
+    ], 'flow', :auto)
+    repository.link_to_stream([
+      event1.event_id,
+    ], 'flow', 0)
+    expect(repository.read_all_streams_forward(:head, 4)).to eq([event0, event1,])
+    expect(repository.read_stream_events_forward('flow')).to eq([event0, event1,])
+  end
+
   specify 'manual is compatible with auto expectation' do
     skip unless test_expected_version_auto
     repository.append_to_stream([
@@ -165,6 +355,23 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_stream_events_forward('stream')).to eq([event0, event1, event2, event3])
   end
 
+  specify 'manual is compatible with auto expectation when linking' do
+    skip unless test_expected_version_auto
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+      event0 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+      event1 = TestDomainEvent.new(event_id: SecureRandom.uuid),
+    ], 'stream', :auto)
+    repository.link_to_stream([
+      event0.event_id,
+    ], 'flow', :none)
+    repository.link_to_stream([
+      event1.event_id,
+    ], 'flow', :auto)
+    expect(repository.read_all_streams_forward(:head, 4)).to eq([event0, event1])
+    expect(repository.read_stream_events_forward('flow')).to eq([event0, event1])
+  end
+
   specify 'unlimited concurrency for :any - everything should succeed' do
     skip unless test_race_conditions_any
     verify_conncurency_assumptions
@@ -204,6 +411,53 @@ RSpec.shared_examples :event_repository do |repository_class|
     end
   end
 
+  specify 'unlimited concurrency for :any - everything should succeed when linking' do
+    skip unless test_race_conditions_any
+    skip unless test_link_events_to_stream
+    verify_conncurency_assumptions
+    begin
+      concurrency_level = 4
+
+      fail_occurred = false
+      wait_for_it  = true
+
+      concurrency_level.times.map do |i|
+        100.times do |j|
+          eid = "0000000#{i}-#{sprintf("%04d", j)}-0000-0000-000000000000"
+          repository.append_to_stream([
+            TestDomainEvent.new(event_id: eid),
+          ], 'stream', :any)
+        end
+      end
+
+      threads = concurrency_level.times.map do |i|
+        Thread.new do
+          true while wait_for_it
+          begin
+            100.times do |j|
+              eid = "0000000#{i}-#{sprintf("%04d", j)}-0000-0000-000000000000"
+              repository.link_to_stream(eid, 'flow', :any)
+            end
+          rescue RubyEventStore::WrongExpectedEventVersion
+            fail_occurred = true
+          end
+        end
+      end
+      wait_for_it = false
+      threads.each(&:join)
+      expect(fail_occurred).to eq(false)
+      expect(repository.read_stream_events_forward('flow').size).to eq(400)
+      events_in_stream = repository.read_stream_events_forward('flow')
+      expect(events_in_stream.size).to eq(400)
+      events0 = events_in_stream.select do |ev|
+        ev.event_id.start_with?("0-")
+      end
+      expect(events0).to eq(events0.sort_by{|ev| ev.event_id })
+    ensure
+      cleanup_concurrency_test
+    end
+  end
+
   specify 'limited concurrency for :auto - some operations will fail without outside lock, stream is ordered' do
     skip unless test_expected_version_auto
     skip unless test_race_conditions_auto
@@ -246,6 +500,57 @@ RSpec.shared_examples :event_repository do |repository_class|
     end
   end
 
+  specify 'limited concurrency for :auto - some operations will fail without outside lock, stream is ordered' do
+    skip unless test_expected_version_auto
+    skip unless test_race_conditions_auto
+    skip unless test_link_events_to_stream
+
+    verify_conncurency_assumptions
+    begin
+      concurrency_level = 4
+
+      concurrency_level.times.map do |i|
+        100.times do |j|
+          eid = "0000000#{i}-#{sprintf("%04d", j)}-0000-0000-000000000000"
+          repository.append_to_stream([
+            TestDomainEvent.new(event_id: eid),
+          ], 'whatever', :any)
+        end
+      end
+
+      fail_occurred = 0
+      wait_for_it  = true
+
+      threads = concurrency_level.times.map do |i|
+        Thread.new do
+          true while wait_for_it
+          100.times do |j|
+            begin
+              eid = "0000000#{i}-#{sprintf("%04d", j)}-0000-0000-000000000000"
+              repository.link_to_stream(eid, 'stream', :auto)
+              sleep(rand(concurrency_level) / 1000.0)
+            rescue RubyEventStore::WrongExpectedEventVersion
+              fail_occurred +=1
+            end
+          end
+        end
+      end
+      wait_for_it = false
+      threads.each(&:join)
+      expect(fail_occurred).to be > 0
+      events_in_stream = repository.read_stream_events_forward('stream')
+      expect(events_in_stream.size).to be < 400
+      expect(events_in_stream.size).to be >= 100
+      events0 = events_in_stream.select do |ev|
+        ev.event_id.start_with?("0-")
+      end
+      expect(events0).to eq(events0.sort_by{|ev| ev.event_id })
+      additional_limited_concurrency_for_auto_check
+    ensure
+      cleanup_concurrency_test
+    end
+  end
+
   it 'appended event is stored in given stream' do
     expected_event = TestDomainEvent.new(data: {})
     repository.append_to_stream(expected_event, 'stream', :any)
@@ -268,6 +573,21 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(retrieved_event.metadata[:request_id]).to eq(3)
   end
 
+  it 'data and metadata attributes are retrieved when linking' do
+    skip unless test_link_events_to_stream
+    event = TestDomainEvent.new(
+      data: { order_id: 3 },
+      metadata: { request_id: 4 }
+    )
+    repository.
+      append_to_stream(event, 'stream', :any).
+      link_to_stream(event.event_id, 'flow', :any)
+    retrieved_event = repository.read_stream_events_forward('flow').first
+    expect(retrieved_event.metadata[:request_id]).to eq(4)
+    expect(retrieved_event.data[:order_id]).to eq(3)
+    expect(event).to eq(retrieved_event)
+  end
+
   it 'does not have deleted streams' do
     repository.append_to_stream(e1 = TestDomainEvent.new, 'stream', -1)
     repository.append_to_stream(e2 = TestDomainEvent.new, 'other_stream', -1)
@@ -278,6 +598,17 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_all_streams_forward(:head, 10)).to eq([e1,e2])
   end
 
+  it 'does not have deleted streams with linked events' do
+    skip unless test_link_events_to_stream
+    repository.
+      append_to_stream(e1 = TestDomainEvent.new, 'stream', -1).
+      link_to_stream(e1.event_id, 'flow', -1)
+
+    repository.delete_stream('flow')
+    expect(repository.read_stream_events_forward('flow')).to be_empty
+    expect(repository.read_all_streams_forward(:head, 10)).to eq([e1])
+  end
+
   it 'has or has not domain event' do
     just_an_id = 'd5c134c2-db65-4e87-b6ea-d196f8f1a292'
     repository.append_to_stream(TestDomainEvent.new(event_id: just_an_id), 'stream', -1)
@@ -285,6 +616,10 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.has_event?(just_an_id)).to be_truthy
     expect(repository.has_event?(just_an_id.clone)).to be_truthy
     expect(repository.has_event?('any other id')).to be_falsey
+
+    repository.delete_stream('stream')
+    expect(repository.has_event?(just_an_id)).to be_truthy
+    expect(repository.has_event?(just_an_id.clone)).to be_truthy
   end
 
   it 'knows last event in stream' do
@@ -295,6 +630,18 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.last_stream_event('other_stream')).to be_nil
   end
 
+  it 'knows last event in stream when linked' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+        e0 = TestDomainEvent.new(event_id: '00000000-0000-0000-0000-000000000001'),
+        e1 = TestDomainEvent.new(event_id: '00000000-0000-0000-0000-000000000002'),
+      ],
+      'stream',
+      -1
+    ).link_to_stream([e1.event_id, e0.event_id], 'flow', -1)
+    expect(repository.last_stream_event('flow')).to eq(e0)
+  end
+
   it 'reads batch of events from stream forward & backward' do
     event_ids = ["96c920b1-cdd0-40f4-907c-861b9fff7d02", "56404f79-0ba0-4aa0-8524-dc3436368ca0", "6a54dd21-f9d8-4857-a195-f5588d9e406c", "0e50a9cd-f981-4e39-93d5-697fc7285b98", "d85589bc-b993-41d4-812f-fc631d9185d5", "96bdacda-77dd-4d7d-973d-cbdaa5842855", "94688199-e6b7-4180-bf8e-825b6808e6cc", "68fab040-741e-4bc2-9cca-5b8855b0ca19", "ab60114c-011d-4d58-ab31-7ba65d99975e", "868cac42-3d19-4b39-84e8-cd32d65c2445"]
     events = event_ids.map{|id| TestDomainEvent.new(event_id: id) }
@@ -315,20 +662,62 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_events_backward('stream', events[4].event_id, 100)).to eq(events.first(4).reverse)
   end
 
+  it 'reads batch of linked events from stream forward & backward' do
+    skip unless test_link_events_to_stream
+    event_ids = ["96c920b1-cdd0-40f4-907c-861b9fff7d02", "56404f79-0ba0-4aa0-8524-dc3436368ca0", "6a54dd21-f9d8-4857-a195-f5588d9e406c", "0e50a9cd-f981-4e39-93d5-697fc7285b98", "d85589bc-b993-41d4-812f-fc631d9185d5", "96bdacda-77dd-4d7d-973d-cbdaa5842855", "94688199-e6b7-4180-bf8e-825b6808e6cc", "68fab040-741e-4bc2-9cca-5b8855b0ca19", "ab60114c-011d-4d58-ab31-7ba65d99975e", "868cac42-3d19-4b39-84e8-cd32d65c2445"]
+    events = event_ids.map{|id| TestDomainEvent.new(event_id: id) }
+    repository.append_to_stream(TestDomainEvent.new, 'other_stream', -1)
+    events.each.with_index do |event, index|
+      repository.
+        append_to_stream(event, 'stream', index - 1).
+        link_to_stream(event.event_id, 'flow', index - 1)
+    end
+    repository.append_to_stream(TestDomainEvent.new, 'other_stream', 0)
+
+    expect(repository.read_events_forward('flow', :head, 3)).to eq(events.first(3))
+    expect(repository.read_events_forward('flow', :head, 100)).to eq(events)
+    expect(repository.read_events_forward('flow', events[4].event_id, 4)).to eq(events[5..8])
+    expect(repository.read_events_forward('flow', events[4].event_id, 100)).to eq(events[5..9])
+
+    expect(repository.read_events_backward('flow', :head, 3)).to eq(events.last(3).reverse)
+    expect(repository.read_events_backward('flow', :head, 100)).to eq(events.reverse)
+    expect(repository.read_events_backward('flow', events[4].event_id, 4)).to eq(events.first(4).reverse)
+    expect(repository.read_events_backward('flow', events[4].event_id, 100)).to eq(events.first(4).reverse)
+  end
 
   it 'reads all stream events forward & backward' do
     s1 = 'stream'
     s2 = 'other_stream'
-    repository.append_to_stream(a = TestDomainEvent.new(event_id: '7010d298-ab69-4bb1-9251-f3466b5d1282'), s1, -1)
-    repository.append_to_stream(b = TestDomainEvent.new(event_id: '34f88aca-aaba-4ca0-9256-8017b47528c5'), s2, -1)
-    repository.append_to_stream(c = TestDomainEvent.new(event_id: '8e61c864-ceae-4684-8726-97c34eb8fc4f'), s1, 0)
-    repository.append_to_stream(d = TestDomainEvent.new(event_id: '30963ed9-6349-450b-ac9b-8ea50115b3bd'), s2, 0)
-    repository.append_to_stream(e = TestDomainEvent.new(event_id: '5bdc58b7-e8a7-4621-afd6-ccb828d72457'), s2, 1)
+    repository.
+      append_to_stream(a = TestDomainEvent.new(event_id: '7010d298-ab69-4bb1-9251-f3466b5d1282'), s1, -1).
+      append_to_stream(b = TestDomainEvent.new(event_id: '34f88aca-aaba-4ca0-9256-8017b47528c5'), s2, -1).
+      append_to_stream(c = TestDomainEvent.new(event_id: '8e61c864-ceae-4684-8726-97c34eb8fc4f'), s1, 0).
+      append_to_stream(d = TestDomainEvent.new(event_id: '30963ed9-6349-450b-ac9b-8ea50115b3bd'), s2, 0).
+      append_to_stream(e = TestDomainEvent.new(event_id: '5bdc58b7-e8a7-4621-afd6-ccb828d72457'), s2, 1)
 
     expect(repository.read_stream_events_forward(s1)).to eq [a,c]
     expect(repository.read_stream_events_backward(s1)).to eq [c,a]
   end
 
+  it 'reads all stream linked events forward & backward' do
+    skip unless test_link_events_to_stream
+    s1, fs1, fs2 = 'stream', 'flow', 'other_flow'
+    repository.
+      append_to_stream(a = TestDomainEvent.new(event_id: '7010d298-ab69-4bb1-9251-f3466b5d1282'), s1, -1).
+      append_to_stream(b = TestDomainEvent.new(event_id: '34f88aca-aaba-4ca0-9256-8017b47528c5'), s1, 0).
+      append_to_stream(c = TestDomainEvent.new(event_id: '8e61c864-ceae-4684-8726-97c34eb8fc4f'), s1, 1).
+      append_to_stream(d = TestDomainEvent.new(event_id: '30963ed9-6349-450b-ac9b-8ea50115b3bd'), s1, 2).
+      append_to_stream(e = TestDomainEvent.new(event_id: '5bdc58b7-e8a7-4621-afd6-ccb828d72457'), s1, 3).
+      link_to_stream('7010d298-ab69-4bb1-9251-f3466b5d1282', fs1, -1).
+      link_to_stream('34f88aca-aaba-4ca0-9256-8017b47528c5', fs2, -1).
+      link_to_stream('8e61c864-ceae-4684-8726-97c34eb8fc4f', fs1, 0).
+      link_to_stream('30963ed9-6349-450b-ac9b-8ea50115b3bd', fs2, 0).
+      link_to_stream('5bdc58b7-e8a7-4621-afd6-ccb828d72457', fs2, 1)
+
+    expect(repository.read_stream_events_forward(fs1)).to eq [a,c]
+    expect(repository.read_stream_events_backward(fs1)).to eq [c,a]
+  end
+
   it 'reads batch of events from all streams forward & backward' do
     event_ids = ["96c920b1-cdd0-40f4-907c-861b9fff7d02", "56404f79-0ba0-4aa0-8524-dc3436368ca0", "6a54dd21-f9d8-4857-a195-f5588d9e406c", "0e50a9cd-f981-4e39-93d5-697fc7285b98", "d85589bc-b993-41d4-812f-fc631d9185d5", "96bdacda-77dd-4d7d-973d-cbdaa5842855", "94688199-e6b7-4180-bf8e-825b6808e6cc", "68fab040-741e-4bc2-9cca-5b8855b0ca19", "ab60114c-011d-4d58-ab31-7ba65d99975e", "868cac42-3d19-4b39-84e8-cd32d65c2445"]
     events = event_ids.map{|id| TestDomainEvent.new(event_id: id) }
@@ -347,6 +736,27 @@ RSpec.shared_examples :event_repository do |repository_class|
     expect(repository.read_all_streams_backward(events[4].event_id, 100)).to eq(events.first(4).reverse)
   end
 
+  it 'linked events do not affect reading from all streams - no duplicates' do
+    skip unless test_link_events_to_stream
+    event_ids = ["96c920b1-cdd0-40f4-907c-861b9fff7d02", "56404f79-0ba0-4aa0-8524-dc3436368ca0", "6a54dd21-f9d8-4857-a195-f5588d9e406c", "0e50a9cd-f981-4e39-93d5-697fc7285b98", "d85589bc-b993-41d4-812f-fc631d9185d5", "96bdacda-77dd-4d7d-973d-cbdaa5842855", "94688199-e6b7-4180-bf8e-825b6808e6cc", "68fab040-741e-4bc2-9cca-5b8855b0ca19", "ab60114c-011d-4d58-ab31-7ba65d99975e", "868cac42-3d19-4b39-84e8-cd32d65c2445"]
+    events = event_ids.map{|id| TestDomainEvent.new(event_id: id) }
+    events.each do |ev|
+      repository.
+        append_to_stream(ev, SecureRandom.uuid, -1).
+        link_to_stream(ev.event_id, SecureRandom.uuid, -1)
+    end
+
+    expect(repository.read_all_streams_forward(:head, 3)).to eq(events.first(3))
+    expect(repository.read_all_streams_forward(:head, 100)).to eq(events)
+    expect(repository.read_all_streams_forward(events[4].event_id, 4)).to eq(events[5..8])
+    expect(repository.read_all_streams_forward(events[4].event_id, 100)).to eq(events[5..9])
+
+    expect(repository.read_all_streams_backward(:head, 3)).to eq(events.last(3).reverse)
+    expect(repository.read_all_streams_backward(:head, 100)).to eq(events.reverse)
+    expect(repository.read_all_streams_backward(events[4].event_id, 4)).to eq(events.first(4).reverse)
+    expect(repository.read_all_streams_backward(events[4].event_id, 100)).to eq(events.first(4).reverse)
+  end
+
   it 'reads events different uuid object but same content' do
     event_ids = [
       "96c920b1-cdd0-40f4-907c-861b9fff7d02",
@@ -378,6 +788,33 @@ RSpec.shared_examples :event_repository do |repository_class|
     end.to raise_error(RubyEventStore::EventDuplicatedInStream)
   end
 
+  it 'does not allow same event twice' do
+    repository.append_to_stream(
+      TestDomainEvent.new(event_id: "a1b49edb-7636-416f-874a-88f94b859bef"),
+      'stream',
+      -1
+    )
+    expect do
+      repository.append_to_stream(
+        TestDomainEvent.new(event_id: "a1b49edb-7636-416f-874a-88f94b859bef"),
+        'another',
+        -1
+      )
+    end.to raise_error(RubyEventStore::EventDuplicatedInStream)
+  end
+
+  it 'does not allow linking same event twice in a stream' do
+    skip unless test_link_events_to_stream
+    repository.append_to_stream([
+        TestDomainEvent.new(event_id: "a1b49edb-7636-416f-874a-88f94b859bef"),
+      ], 'stream',
+      -1
+    ).link_to_stream("a1b49edb-7636-416f-874a-88f94b859bef", 'flow', -1)
+    expect do
+      repository.link_to_stream("a1b49edb-7636-416f-874a-88f94b859bef", 'flow', 0)
+    end.to raise_error(RubyEventStore::EventDuplicatedInStream)
+  end
+
   it 'allows appending to GLOBAL_STREAM explicitly' do
     event = TestDomainEvent.new(event_id: "df8b2ba3-4e2c-4888-8d14-4364855fa80e")
     repository.append_to_stream(event, "all", :any)
@@ -418,6 +855,20 @@ RSpec.shared_examples :event_repository do |repository_class|
     end
   end
 
+  specify "only :none, :any, :auto and Integer allowed as expected_version when linking" do
+    skip unless test_link_events_to_stream
+    [Object.new, SecureRandom.uuid, :foo].each do |invalid_expected_version|
+      repository.append_to_stream(
+        TestDomainEvent.new(event_id: evid = SecureRandom.uuid),
+        SecureRandom.uuid,
+        -1
+      )
+      expect {
+        repository.link_to_stream(evid, SecureRandom.uuid, invalid_expected_version)
+      }.to raise_error(RubyEventStore::InvalidExpectedVersion)
+    end
+  end
+
   specify "events not persisted if append failed" do
     repository.append_to_stream([
       TestDomainEvent.new(event_id: SecureRandom.uuid),
@@ -444,14 +895,33 @@ RSpec.shared_examples :event_repository do |repository_class|
   end
 
   specify 'reading particular event' do
-    test_event = TestDomainEvent.new
-    repository.append_to_stream(TestDomainEvent.new, "test", -1)
-    repository.append_to_stream(test_event, "test", 0)
+    test_event = TestDomainEvent.new(event_id: "941cd8f5-b3f9-47af-b4e4-07f8cea37467")
+    repository.
+      append_to_stream(TestDomainEvent.new, "test", -1).
+      append_to_stream(test_event, "test", 0)
 
-    expect(repository.read_event(test_event.event_id)).to eq(test_event)
+    expect(repository.read_event("941cd8f5-b3f9-47af-b4e4-07f8cea37467")).to eq(test_event)
   end
 
   specify 'reading non-existent event' do
-    expect{repository.read_event('72922e65-1b32-4e97-8023-03ae81dd3a27')}.to raise_error(RubyEventStore::EventNotFound)
+    expect do
+      repository.read_event('72922e65-1b32-4e97-8023-03ae81dd3a27')
+    end.to raise_error do |err|
+      expect(err).to be_a(RubyEventStore::EventNotFound)
+      expect(err.event_id).to eq('72922e65-1b32-4e97-8023-03ae81dd3a27')
+      expect(err.message).to eq('Event not found: 72922e65-1b32-4e97-8023-03ae81dd3a27')
+    end
+  end
+
+  specify 'linking non-existent event' do
+    skip unless test_link_events_to_stream
+    expect do
+      repository.link_to_stream('72922e65-1b32-4e97-8023-03ae81dd3a27', "flow", -1)
+    end.to raise_error do |err|
+      expect(err).to be_a(RubyEventStore::EventNotFound)
+      expect(err.event_id).to eq('72922e65-1b32-4e97-8023-03ae81dd3a27')
+      expect(err.message).to eq('Event not found: 72922e65-1b32-4e97-8023-03ae81dd3a27')
+    end
   end
+
 end

data/lib/ruby_event_store/version.rb

@@ -1,3 +1,3 @@
 module RubyEventStore
-  VERSION = "0.21.0"
+  VERSION = "0.22.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ruby_event_store
 version: !ruby/object:Gem::Version
-  version: 0.21.0
+  version: 0.22.0
 platform: ruby
 authors:
 - Arkency
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2017-12-22 00:00:00.000000000 Z
+date: 2018-01-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -129,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.11
+rubygems_version: 2.6.13
 signing_key: 
 specification_version: 4
 summary: Event Store in Ruby