smart_message 0.0.8 → 0.0.9

data/lib/smart_message/wrapper.rb.bak

@@ -0,0 +1,132 @@
+# lib/smart_message/wrapper.rb
+# encoding: utf-8
+# frozen_string_literal: true
+
+require 'securerandom'   # STDLIB
+require_relative './header.rb'
+
+module SmartMessage
+  module Wrapper
+    # Every smart message has a common wrapper format that contains
+    # information used to support the dispatching of subscribed
+    # messages upon receipt from a transport as well as the serialized
+    # payload.
+    #
+    # The wrapper consolidates header and payload into a single object
+    # for cleaner method signatures throughout the SmartMessage dataflow.
+    class Base < Hashie::Dash
+      include Hashie::Extensions::IndifferentAccess
+      include Hashie::Extensions::MethodAccess
+      include Hashie::Extensions::DeepMerge
+
+      # Core wrapper properties
+      # Using '_sm_' prefix to avoid collision with user message definitions
+      property :_sm_header,
+        required: true,
+        description: "SmartMessage header containing routing and metadata information"
+      
+      property :_sm_payload,
+        required: true, 
+        description: "Serialized message payload containing the business data"
+
+      # Create wrapper from header and payload
+      def initialize(header: nil, payload: nil, **props, &block)
+        # Handle different initialization patterns
+        if header && payload
+          attributes = {
+            _sm_header: header,
+            _sm_payload: payload
+          }
+        else
+          # Create default header if not provided
+          default_header = SmartMessage::Header.new(
+            uuid:           SecureRandom.uuid,
+            message_class:  'SmartMessage::Wrapper::Base',
+            published_at:   Time.now,
+            publisher_pid:  Process.pid,
+            version:        1
+          )
+          
+          attributes = {
+            _sm_header: default_header,
+            _sm_payload: nil
+          }.merge(props)
+        end
+
+        super(attributes, &block)
+      end
+
+      # Convenience accessors for header and payload
+      def header
+        _sm_header
+      end
+
+      def payload
+        _sm_payload
+      end
+
+      # Check if this is a broadcast message (to field is nil)
+      def broadcast?
+        _sm_header.to.nil?
+      end
+
+      # Check if this is a directed message (to field is present) 
+      def directed?
+        !broadcast?
+      end
+
+      # Get message class from header
+      def message_class
+        _sm_header.message_class
+      end
+
+      # Get sender from header
+      def from
+        _sm_header.from
+      end
+
+      # Get recipient from header
+      def to
+        _sm_header.to
+      end
+
+      # Get reply destination from header
+      def reply_to
+        _sm_header.reply_to
+      end
+
+      # Get message version from header
+      def version
+        _sm_header.version
+      end
+
+      # Get UUID from header
+      def uuid
+        _sm_header.uuid
+      end
+
+      # Convert wrapper to hash for serialization/transport
+      def to_hash
+        {
+          '_sm_header' => _sm_header.to_hash,
+          '_sm_payload' => _sm_payload
+        }
+      end
+
+      alias_method :to_h, :to_hash
+
+      # Outer-level JSON serialization for the wrapper
+      # This is level 2 serialization - always JSON for routing/monitoring
+      def to_json(*args)
+        require 'json'
+        to_hash.to_json(*args)
+      end
+
+      # Split wrapper into header and payload components
+      # Enables destructuring assignment: header, payload = wrapper.split
+      def split
+        [_sm_header, _sm_payload]
+      end
+    end
+  end
+end

data/lib/smart_message.rb

@@ -2,6 +2,8 @@
 # encoding: utf-8
 # frozen_string_literal: true
 
+require 'zeitwerk'
+
 # FIXME: handle this better
 class MilClass  # IMO nil is the same as an empty String
   def to_s
@@ -9,48 +11,92 @@ class MilClass  # IMO nil is the same as an empty String
   end
 end
 
-
 require 'active_support/core_ext/string/inflections'
 require 'date'  # STDLIB
-
-# Production logging should use the logger framework, not debug_me
-
 require 'hashie'         # Your friendly neighborhood hash library.
 
-require_relative './simple_stats'
-
-require_relative './smart_message/version'
-require_relative './smart_message/errors'
-require_relative './smart_message/circuit_breaker'
-require_relative './smart_message/dead_letter_queue'
+# Set up Zeitwerk autoloader
+loader = Zeitwerk::Loader.for_gem
+loader.tag = "smart_message"
+loader.ignore("#{__dir__}/simple_stats.rb")
+loader.setup
 
-require_relative './smart_message/dispatcher.rb'
-require_relative './smart_message/transport.rb'
-require_relative './smart_message/base.rb'
+# Load simple_stats manually since it's not following the naming convention
+require_relative './simple_stats'
 
 # SmartMessage abstracts messages from the backend transport process
 module SmartMessage
-  # The super class of all smart messages
-  # class Base < Dash from the Hashie gem plus mixins
-  # end
-
-  # encapsulates the message transport plugin
-  # module Transport is defined in transport.rb
-
-  # encapsulates the message code/decode serializer
+  class << self
+    # Global configuration for SmartMessage
+    # 
+    # Usage:
+    #   SmartMessage.configure do |config|
+    #     config.logger = MyApp::Logger.new
+    #     config.transport = MyApp::Transport.new
+    #     config.serializer = MyApp::Serializer.new
+    #   end
+    def configure
+      yield(configuration)
+    end
+    
+    # Get the global configuration instance
+    def configuration
+      @configuration ||= Configuration.new
+    end
+    
+    # Reset global configuration to defaults
+    def reset_configuration!
+      @configuration = Configuration.new
+    end
+  end
+  # Module definitions for Zeitwerk to populate
   module Serializer
-    # the super class of the message serializer
-    class Base
+    class << self
+      def default
+        # Check global configuration first, then fall back to framework default
+        SmartMessage.configuration.default_serializer
+      end
     end
   end
 
-  # encapsulates the message logging capability
   module Logger
-    # the super class of the message logger
-    class Base
+    class << self
+      def default
+        # Check global configuration first, then fall back to framework default
+        SmartMessage.configuration.default_logger
+      end
+    end
+  end
+  
+  module Transport
+    class << self
+      def default
+        # Check global configuration first, then fall back to framework default
+        SmartMessage.configuration.default_transport
+      end
+      
+      def registry
+        @registry ||= Registry.new
+      end
+
+      def register(name, transport_class)
+        registry.register(name, transport_class)
+      end
+
+      def get(name)
+        registry.get(name)
+      end
+
+      def create(name, **options)
+        transport_class = get(name)
+        transport_class&.new(**options)
+      end
+
+      def available
+        registry.list
+      end
     end
   end
 end # module SmartMessage
 
-require_relative './smart_message/serializer'
-require_relative './smart_message/logger'
+# Don't eager load initially - let Zeitwerk handle lazy loading

data/smart_message.gemspec

@@ -41,6 +41,9 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'concurrent-ruby'
   spec.add_dependency 'redis'
   spec.add_dependency 'breaker_machines'
+  spec.add_dependency 'zeitwerk'
+  spec.add_dependency 'lumberjack'
+  spec.add_dependency 'colorize'
 
   spec.add_development_dependency 'bundler'
   spec.add_development_dependency 'rake'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_message
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -79,6 +79,48 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: zeitwerk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: lumberjack
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
@@ -203,6 +245,7 @@ extra_rdoc_files: []
 files:
 - ".envrc"
 - ".gitignore"
+- ".irbrc"
 - ".travis.yml"
 - CHANGELOG.md
 - COMMITS.md
@@ -215,11 +258,13 @@ files:
 - docs/README.md
 - docs/addressing.md
 - docs/architecture.md
+- docs/dead_letter_queue.md
 - docs/dispatcher.md
 - docs/examples.md
 - docs/getting-started.md
 - docs/ideas_to_think_about.md
 - docs/logging.md
+- docs/message_filtering.md
 - docs/message_processing.md
 - docs/proc_handlers_summary.md
 - docs/properties.md
@@ -236,8 +281,28 @@ files:
 - examples/07_error_handling_scenarios.rb
 - examples/08_entity_addressing_basic.rb
 - examples/08_entity_addressing_with_filtering.rb
+- examples/09_dead_letter_queue_demo.rb
+- examples/09_regex_filtering_microservices.rb
+- examples/10_header_block_configuration.rb
+- examples/11_global_configuration_example.rb
 - examples/README.md
+- examples/dead_letters.jsonl
+- examples/performance_metrics/benchmark_results_ractor_20250818_205603.json
+- examples/performance_metrics/benchmark_results_ractor_20250818_205831.json
+- examples/performance_metrics/benchmark_results_test_20250818_204942.json
+- examples/performance_metrics/benchmark_results_threadpool_20250818_204942.json
+- examples/performance_metrics/benchmark_results_threadpool_20250818_204959.json
+- examples/performance_metrics/benchmark_results_threadpool_20250818_205044.json
+- examples/performance_metrics/benchmark_results_threadpool_20250818_205109.json
+- examples/performance_metrics/benchmark_results_threadpool_20250818_205252.json
+- examples/performance_metrics/benchmark_results_unknown_20250819_172852.json
+- examples/performance_metrics/compare_benchmarks.rb
+- examples/performance_metrics/dead_letters.jsonl
+- examples/performance_metrics/performance_benchmark.rb
+- examples/show_logger.rb
+- examples/show_me.rb
 - examples/smart_home_iot_dataflow.md
+- examples/temp.txt
 - examples/tmux_chat/README.md
 - examples/tmux_chat/bot_agent.rb
 - examples/tmux_chat/human_agent.rb
@@ -247,8 +312,10 @@ files:
 - examples/tmux_chat/stop_chat_demo.sh
 - lib/simple_stats.rb
 - lib/smart_message.rb
+- lib/smart_message/addressing.rb
 - lib/smart_message/base.rb
 - lib/smart_message/circuit_breaker.rb
+- lib/smart_message/configuration.rb
 - lib/smart_message/dead_letter_queue.rb
 - lib/smart_message/dispatcher.rb
 - lib/smart_message/dispatcher/.keep
@@ -257,19 +324,25 @@ files:
 - lib/smart_message/logger.rb
 - lib/smart_message/logger/base.rb
 - lib/smart_message/logger/default.rb
+- lib/smart_message/logger/lumberjack.rb
+- lib/smart_message/logger/null.rb
+- lib/smart_message/messaging.rb
+- lib/smart_message/plugins.rb
 - lib/smart_message/property_descriptions.rb
 - lib/smart_message/property_validations.rb
-- lib/smart_message/serializer.rb
 - lib/smart_message/serializer/base.rb
 - lib/smart_message/serializer/json.rb
+- lib/smart_message/subscription.rb
 - lib/smart_message/transport.rb
 - lib/smart_message/transport/base.rb
 - lib/smart_message/transport/memory_transport.rb
 - lib/smart_message/transport/redis_transport.rb
 - lib/smart_message/transport/registry.rb
 - lib/smart_message/transport/stdout_transport.rb
+- lib/smart_message/utilities.rb
 - lib/smart_message/version.rb
-- lib/smart_message/wrapper.rb
+- lib/smart_message/versioning.rb
+- lib/smart_message/wrapper.rb.bak
 - smart_message.gemspec
 homepage: https://github.com/MadBomber/smart_message
 licenses: []

data/lib/smart_message/serializer.rb

@@ -1,10 +0,0 @@
-# lib/smart_message/serializer.rb
-# encoding: utf-8
-# frozen_string_literal: true
-
-require_relative 'serializer/base'
-require_relative 'serializer/json'
-
-module SmartMessage::Serializer
-  # Serializer module for message encoding/decoding
-end # module SmartMessage::Serializer

data/lib/smart_message/wrapper.rb

@@ -1,43 +0,0 @@
-# lib/smart_message/wrapper.rb
-# encoding: utf-8
-# frozen_string_literal: true
-
-# TODO: consider having a serializer plugin for the wrapper that is
-#       different than that used for the payload.
-
-require_relative './header.rb'
-
-module SmartMessage
-  module Wrapper
-    # Every smart message has a common wrapper format that contains
-    # information used to support the dispatching of subscribed
-    # messages upon receipt from a transport as well as the serialized
-    # payload.
-    class Base < Hashie::Dash
-      include Hashie::Extensions::IndifferentAccess
-      include Hashie::Extensions::MergeInitializer
-      include Hashie::Extensions::MethodAccess
-
-      # Common attributes of the smart message standard header
-      # Using '_sm_' as a prefix to avoid potential collision with
-      # a user's message definition.
-      property :_sm_header
-      property :_sm_payload
-
-      def initialize(**props, &block)
-        attributes = {
-          _sm_header: SmartMessage::Header.new(
-            uuid:           SecureRandom.uuid,
-            message_class:  self.class.to_s,
-            published_at:   2,
-            publisher_pid:  3
-          )
-        }.merge(props)
-
-        super(attributes, &block)
-      end
-
-
-    end
-  end
-end