tcb 0.5.0

data/lib/tcb/subscriber_invocation_failed.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module TCB
+  class SubscriberInvocationFailed < Data.define(
+    :original_event,
+    :subscriber_type,
+    :subscriber_class,
+    :subscriber_location,
+    :subscriber_source,
+    :error_class,
+    :error_message,
+    :error_backtrace,
+    :occurred_at
+  )
+    def self.build(handler:, original_event:, error:)
+      metadata = SubscriberMetadataExtractor.new(handler).extract
+
+      new(
+        original_event: original_event,
+        subscriber_type: metadata.subscriber_type,
+        subscriber_class: metadata.subscriber_class,
+        subscriber_location: metadata.subscriber_location,
+        subscriber_source: metadata.subscriber_source,
+        error_class: error.class.name,
+        error_message: error.message,
+        error_backtrace: error.backtrace,
+        occurred_at: Time.now
+      )
+    end
+  end
+end

data/lib/tcb/subscriber_metadata_extractor.rb

@@ -0,0 +1,66 @@
+# frozen_string_literal: true
+
+module TCB
+  class SubscriberMetadataExtractor
+    SubscriberMetadata = Data.define(
+      :subscriber_type,
+      :subscriber_class,
+      :subscriber_location,
+      :subscriber_source
+    )
+
+    def initialize(handler)
+      @handler = handler
+    end
+
+    def extract
+      if @handler.is_a?(Proc)
+        extract_proc_metadata
+      else
+        extract_class_metadata
+      end
+    end
+
+    private
+
+    def extract_proc_metadata
+      file, line = @handler.source_location
+      location = file ? "#{file}:#{line}" : nil
+
+      SubscriberMetadata.new(
+        subscriber_type: :block,
+        subscriber_class: "Proc",
+        subscriber_location: location,
+        subscriber_source: extract_source(@handler)
+      )
+    end
+
+    def extract_class_metadata
+      file, line = @handler.class.source_location
+      location = file ? "#{file}:#{line}" : nil
+
+      SubscriberMetadata.new(
+        subscriber_type: :class,
+        subscriber_class: @handler.class.name,
+        subscriber_location: location,
+        subscriber_source: extract_method_source(@handler, :call)
+      )
+    end
+
+    def extract_source(proc_or_method)
+      return nil unless defined?(MethodSource) # TODO/TBD: We'd need to extract the source of the block
+
+      proc_or_method.source
+    rescue MethodSource::SourceNotFoundError, LoadError
+      nil
+    end
+
+    def extract_method_source(handler_instance, method_name)
+      return nil unless defined?(MethodSource)
+
+      handler_instance.method(method_name).source
+    rescue MethodSource::SourceNotFoundError, LoadError, NameError
+      nil
+    end
+  end
+end

data/lib/tcb/test_helpers/shared.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module TCB
+  module TestHelpers
+    module Shared
+      def poll_until(within: 1.0, interval: 0.001, &block)
+        deadline = Time.now + within
+        loop do
+          return true if block.call
+          return false if Time.now >= deadline
+          sleep interval
+        end
+      end
+
+      def with_subscriptions(*event_classes)
+        captured = Hash.new { |h, k| h[k] = [] }
+        subscriptions = event_classes.map do |event_class|
+          TCB.config.event_bus.subscribe(event_class) do |event|
+            captured[event_class] << event
+          end
+        end
+        yield captured
+      ensure
+        subscriptions.each { |sub| TCB.config.event_bus.unsubscribe(sub) }
+      end
+    end
+  end
+end
+

data/lib/tcb/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module TCB
+  VERSION = "0.5.0"
+end

data/lib/tcb.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require_relative "tcb/minitest_helpers"
+require_relative "tcb/domain_context"
+require_relative "tcb/event_query"
+require_relative "tcb/event_store/active_record"
+require_relative "tcb/event_store/event_stream_envelope"
+require_relative "tcb/event_store/in_memory"
+require_relative "tcb/stream_id"
+require_relative "tcb/handles_events"
+require_relative "tcb/handles_commands"
+require_relative "tcb/records_events"
+require_relative "tcb/record"
+require_relative "tcb/configuration"
+require_relative "tcb/publish"
+require_relative "tcb/command_bus"
+require_relative "tcb/subscriber_metadata_extractor"
+require_relative "tcb/subscriber_invocation_failed"
+require_relative "tcb/event_bus_shutdown"
+require_relative "tcb/domain"
+require_relative "tcb/event_bus"
+require_relative "tcb/version"
+
+module TCB
+  Envelope = EventStore::EventStreamEnvelope
+
+  def self.record(events_from: [], events: [], within: nil, &block)
+    Record.call(
+      events_from: events_from,
+      events: events,
+      within: within,
+      store: config.event_store,
+      registrations: config.persist_registrations,
+      &block
+    )
+  end
+
+  def self.read(domain_module)
+    EventQuery.new(
+      store: config.event_store,
+      context: DomainContext.from_module(domain_module).to_s
+    )
+  end
+
+  def self.configure(&block)
+    @configure_block = block
+    yield config
+    config.permitted_serialization_classes
+    config.freeze
+  end
+
+  def self.reset!
+    @config.event_bus.force_shutdown
+    @config = nil
+    configure(&@configure_block) if @configure_block
+  end
+end

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: tcb
+version: !ruby/object:Gem::Version
+  version: 0.5.0
+platform: ruby
+authors:
+- Ljubomir Marković
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.9'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest-reporters
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.7.1
+- !ruby/object:Gem::Dependency
+  name: debug
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 1.9.2
+- !ruby/object:Gem::Dependency
+  name: method_source
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+description: TCB gives Rails applications a clean domain language for DDD. Thread-safe
+  event bus, command routing, aggregate pattern, and opt-in event persistence.
+email:
+- ljubomir@tcb.si
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- lib/generators/tcb/domain/domain_generator.rb
+- lib/generators/tcb/domain/templates/command_handler.rb.tt
+- lib/generators/tcb/domain/templates/domain_module.rb.tt
+- lib/generators/tcb/event_store/event_store_generator.rb
+- lib/generators/tcb/event_store/templates/command_handler.rb.tt
+- lib/generators/tcb/event_store/templates/domain_module.rb.tt
+- lib/generators/tcb/event_store/templates/migration.rb.tt
+- lib/generators/tcb/install/install_generator.rb
+- lib/generators/tcb/install/templates/tcb.rb.tt
+- lib/generators/tcb/shared/command_argument.rb
+- lib/tcb.rb
+- lib/tcb/command_bus.rb
+- lib/tcb/configuration.rb
+- lib/tcb/domain.rb
+- lib/tcb/domain_context.rb
+- lib/tcb/event_bus.rb
+- lib/tcb/event_bus/running_strategy.rb
+- lib/tcb/event_bus/shutdown_strategy.rb
+- lib/tcb/event_bus/subscriber_registry.rb
+- lib/tcb/event_bus/termination_signal_handler.rb
+- lib/tcb/event_bus_shutdown.rb
+- lib/tcb/event_query.rb
+- lib/tcb/event_store/active_record.rb
+- lib/tcb/event_store/event_stream_envelope.rb
+- lib/tcb/event_store/in_memory.rb
+- lib/tcb/handles_commands.rb
+- lib/tcb/handles_events.rb
+- lib/tcb/minitest_helpers.rb
+- lib/tcb/publish.rb
+- lib/tcb/record.rb
+- lib/tcb/records_events.rb
+- lib/tcb/rspec_helpers.rb
+- lib/tcb/stream_id.rb
+- lib/tcb/subscriber_invocation_failed.rb
+- lib/tcb/subscriber_metadata_extractor.rb
+- lib/tcb/test_helpers/shared.rb
+- lib/tcb/version.rb
+homepage: https://github.com/tcb-si/tcb
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/tcb-si/tcb
+  changelog_uri: https://github.com/tcb-si/tcb/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Lightweight DDD runtime for Rails — events, commands, and aggregates
+test_files: []