ruby_event_store 2.17.1 → 2.19.0

data/lib/ruby_event_store/specification.rb

@@ -13,7 +13,7 @@ module RubyEventStore
     end
 
     # Limits the query to certain stream.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param stream_name [String] name of the stream to get events from
     # @return [Specification]
@@ -22,7 +22,7 @@ module RubyEventStore
     end
 
     # Limits the query to events before or after another event.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param start [String] id of event to start reading from.
     # @return [Specification]
@@ -32,7 +32,7 @@ module RubyEventStore
     end
 
     # Limits the query to events before or after another event.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param stop [String] id of event to start reading from.
     # @return [Specification]
@@ -42,7 +42,7 @@ module RubyEventStore
     end
 
     # Limits the query to events that occurred before given time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param time [Time]
     # @return [Specification]
@@ -58,7 +58,7 @@ module RubyEventStore
     end
 
     # Limits the query to events that occurred on or before given time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param time [Time]
     # @return [Specification]
@@ -74,7 +74,7 @@ module RubyEventStore
     end
 
     # Limits the query to events that occurred after given time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param time [Time]
     # @return [Specification]
@@ -90,7 +90,7 @@ module RubyEventStore
     end
 
     # Limits the query to events that occurred on or after given time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param time [Time]
     # @return [Specification]
@@ -106,7 +106,7 @@ module RubyEventStore
     end
 
     # Limits the query to events within given time range.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param time_range [Range]
     # @return [Specification]
@@ -119,7 +119,7 @@ module RubyEventStore
     end
 
     # Sets the order of time sorting using transaction time
-    # {http://railseventstore.org/docs/read/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}
     #
     # @return [Specification]
     def as_at
@@ -127,7 +127,7 @@ module RubyEventStore
     end
 
     # Sets the order of time sorting using validity time
-    # {http://railseventstore.org/docs/read/ Find out more}
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}
     #
     # @return [Specification]
     def as_of
@@ -135,7 +135,7 @@ module RubyEventStore
     end
 
     # Sets the order of reading events to ascending (forward from the start).
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Specification]
     def forward
@@ -143,7 +143,7 @@ module RubyEventStore
     end
 
     # Sets the order of reading events to descending (backward from the start).
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Specification]
     def backward
@@ -151,7 +151,7 @@ module RubyEventStore
     end
 
     # Limits the query to specified number of events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param count [Integer] maximal number of events to retrieve
     # @return [Specification]
@@ -162,7 +162,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point.
     # Yields each batch of records that was retrieved from the store.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @yield [Array<Event>] batch of events
     # @return [Enumerator, nil] Enumerator is returned when block not given
@@ -174,7 +174,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point.
     # Yields events read from the store if block given. Otherwise, returns enumerable collection.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @yield [Event] event
     # @return [Enumerator, nil] Enumerator is returned when block not given
@@ -186,7 +186,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point
     # and maps the result using provided block.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Array] of mapped result
     def map(&block)
@@ -196,7 +196,7 @@ module RubyEventStore
 
     # Reduces the results of the query based on the specification
     # built up to this point result using provided block.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param accumulator starting state for reduce operation
     # @return reduce result as defined by block given
@@ -206,7 +206,7 @@ module RubyEventStore
     end
 
     # Calculates the size of result set based on the specification build up to this point.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Integer] Number of events to read
     def count
@@ -215,7 +215,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point.
     # Returns array of domain events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Array<Event>]
     def to_a
@@ -223,7 +223,7 @@ module RubyEventStore
     end
 
     # Specifies that events should be obtained in batches.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # Looping through a collection of events from the store
     # can be inefficient since it will try to instantiate all
@@ -244,10 +244,18 @@ module RubyEventStore
         end,
       )
     end
-    alias in_batches_of in_batches
+
+    def in_batches_of(batch_size = DEFAULT_BATCH_SIZE)
+      warn <<~EOW
+        RubyEventStore::Specification#in_batches_of is deprecated and will be removed in the next major release.
+
+        Use #in_batches instead.
+      EOW
+      in_batches(batch_size)
+    end
 
     # Specifies that only first event should be read.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Specification]
     def read_first
@@ -255,7 +263,7 @@ module RubyEventStore
     end
 
     # Specifies that only last event should be read.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Specification]
     def read_last
@@ -264,7 +272,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point.
     # Returns the first event in specified collection of events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Event, nil]
     def first
@@ -273,7 +281,7 @@ module RubyEventStore
 
     # Executes the query based on the specification built up to this point.
     # Returns the last event in specified collection of events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Event, nil]
     def last
@@ -281,17 +289,25 @@ module RubyEventStore
     end
 
     # Limits the query to certain event type(s).
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @types [Class, Array(Class)] types of event to look for.
     # @return [Specification]
     def of_type(*types)
       Specification.new(reader, result.dup { |r| r.with_types = types.flatten })
     end
-    alias_method :of_types, :of_type
+
+    def of_types(*types)
+      warn <<~EOW
+        RubyEventStore::Specification#of_types is deprecated and will be removed in the next major release.
+
+        Use #of_type instead.
+      EOW
+      of_type(*types)
+    end
 
     # Limits the query to certain events by given even ids.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @param event_ids [Array(String)] ids of event to look for.
     # @return [Specification]
@@ -302,7 +318,7 @@ module RubyEventStore
     # Reads single event from repository.
     # Returns the event with specified id or nil if event is not found
     # in specified collection of events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Event, nil]
     def event(event_id)
@@ -312,7 +328,7 @@ module RubyEventStore
     # Reads single existing event from repository.
     # Returns the event with specified id or raises [EventNotFound] error if
     # event is not found in specified collection of events.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Event]
     def event!(event_id)
@@ -322,7 +338,7 @@ module RubyEventStore
     # Reads all events of given ids from repository.
     # Yields each event (found by id in specified collection of events)
     # read from the store if block given. Otherwise, returns enumerable collection.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @yield [Event] event
     # @return [Enumerator] Enumerator is returned when block not given

data/lib/ruby_event_store/specification_result.rb

@@ -54,7 +54,7 @@ module RubyEventStore
     end
 
     # Limited results. True if number of read elements are limited
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def limit?
@@ -62,7 +62,7 @@ module RubyEventStore
     end
 
     # Results limit or infinity if limit not defined
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Integer|Infinity]
     def limit
@@ -70,7 +70,7 @@ module RubyEventStore
     end
 
     # Stream definition. Stream to be read or nil
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Stream|nil]
     def stream
@@ -78,7 +78,7 @@ module RubyEventStore
     end
 
     # Starting position. Event id of starting event
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [String]
     def start
@@ -86,7 +86,7 @@ module RubyEventStore
     end
 
     # Stop position. Event id of stopping event
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [String|Symbol]
     def stop
@@ -94,7 +94,7 @@ module RubyEventStore
     end
 
     # Ending time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Time]
     def older_than
@@ -102,7 +102,7 @@ module RubyEventStore
     end
 
     # Ending time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Time]
     def older_than_or_equal
@@ -110,7 +110,7 @@ module RubyEventStore
     end
 
     # Starting time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Time]
     def newer_than
@@ -118,7 +118,7 @@ module RubyEventStore
     end
 
     # Starting time.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Time]
     def newer_than_or_equal
@@ -126,7 +126,7 @@ module RubyEventStore
     end
 
     # Time sorting strategy. Nil when not specified.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Symbol]
     def time_sort_by
@@ -134,7 +134,7 @@ module RubyEventStore
     end
 
     # Read direction. True is reading forward
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def forward?
@@ -142,7 +142,7 @@ module RubyEventStore
     end
 
     # Read direction. True is reading backward
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def backward?
@@ -150,7 +150,7 @@ module RubyEventStore
     end
 
     # Size of batch to read (only for :batch read strategy)
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Integer]
     def batch_size
@@ -158,7 +158,7 @@ module RubyEventStore
     end
 
     # Ids of specified event to be read (if any given)
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Array|nil]
     def with_ids
@@ -166,7 +166,7 @@ module RubyEventStore
     end
 
     # Read by specified ids. True if event ids have been specified.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def with_ids?
@@ -174,7 +174,7 @@ module RubyEventStore
     end
 
     # Event types to be read (if any given)
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Array|nil]
     def with_types
@@ -182,7 +182,7 @@ module RubyEventStore
     end
 
     # Read by specified event types. True if event types have been specified.
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def with_types?
@@ -190,7 +190,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if items will be read in batches
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def batched?
@@ -198,7 +198,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if first item will be read
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def first?
@@ -206,7 +206,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if last item will be read
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def last?
@@ -214,7 +214,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if all items will be read
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def all?
@@ -222,7 +222,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if results will be sorted by timestamp
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def time_sort_by_as_at?
@@ -230,7 +230,7 @@ module RubyEventStore
     end
 
     # Read strategy. True if results will be sorted by valid_at
-    # {http://railseventstore.org/docs/read/ Find out more}.
+    # {https://railseventstore.org/docs/core-concepts/read Find out more}.
     #
     # @return [Boolean]
     def time_sort_by_as_of?

data/lib/ruby_event_store/sync_scheduler.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module RubyEventStore
+  class SyncScheduler
+    DEPRECATION_MESSAGE = <<~EOW
+      DEPRECATION WARNING: Passing a class as a subscriber is deprecated and will be removed in the next major release.
+      Pass an instance or lambda instead, e.g. subscribe(MyHandler.new, to: [MyEvent]).
+    EOW
+
+    def call(subscriber, event, _)
+      if Class === subscriber
+        warn DEPRECATION_MESSAGE
+        subscriber = subscriber.new
+      end
+      subscriber.call(event)
+    end
+
+    def verify(subscriber)
+      if Class === subscriber
+        warn DEPRECATION_MESSAGE
+        begin
+          subscriber.new.respond_to?(:call)
+        rescue ArgumentError
+          false
+        end
+      else
+        subscriber.respond_to?(:call)
+      end
+    end
+  end
+end

data/lib/ruby_event_store/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RubyEventStore
-  VERSION = "2.17.1"
+  VERSION = "2.19.0"
 end

data/lib/ruby_event_store.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require_relative "ruby_event_store/sync_scheduler"
 require_relative "ruby_event_store/dispatcher"
 require_relative "ruby_event_store/subscriptions"
 require_relative "ruby_event_store/broker"
@@ -42,6 +43,7 @@ require_relative "ruby_event_store/serializers/yaml"
 require_relative "ruby_event_store/batch_enumerator"
 require_relative "ruby_event_store/correlated_commands"
 require_relative "ruby_event_store/link_by_metadata"
+require_relative "ruby_event_store/immediate_dispatcher"
 require_relative "ruby_event_store/immediate_async_dispatcher"
 require_relative "ruby_event_store/composed_dispatcher"
 require_relative "ruby_event_store/composed_broker"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ruby_event_store
 version: !ruby/object:Gem::Version
-  version: 2.17.1
+  version: 2.19.0
 platform: ruby
 authors:
 - Arkency
@@ -53,6 +53,7 @@ files:
 - lib/ruby_event_store/event_type_resolver.rb
 - lib/ruby_event_store/expected_version.rb
 - lib/ruby_event_store/immediate_async_dispatcher.rb
+- lib/ruby_event_store/immediate_dispatcher.rb
 - lib/ruby_event_store/in_memory_repository.rb
 - lib/ruby_event_store/instrumented_broker.rb
 - lib/ruby_event_store/instrumented_dispatcher.rb
@@ -96,6 +97,7 @@ files:
 - lib/ruby_event_store/specification_result.rb
 - lib/ruby_event_store/stream.rb
 - lib/ruby_event_store/subscriptions.rb
+- lib/ruby_event_store/sync_scheduler.rb
 - lib/ruby_event_store/transform_keys.rb
 - lib/ruby_event_store/version.rb
 homepage: https://railseventstore.org
@@ -121,7 +123,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.6
 specification_version: 4
 summary: Implementation of an event store in Ruby
 test_files: []