smart_message 0.0.12 → 0.0.16

data/lib/smart_message/transport/stdout_transport.rb

@@ -2,70 +2,102 @@
 # encoding: utf-8
 # frozen_string_literal: true
 
+require_relative 'file_transport'
+
 module SmartMessage
   module Transport
     # STDOUT transport for testing and development
-    # This transport outputs messages to STDOUT and optionally loops them back
-    class StdoutTransport < Base
-      def default_options
-        {
-          loopback: false,
-          output: $stdout
+    # This is a publish-only transport that outputs messages to STDOUT
+    # Now inherits from FileTransport but maintains specialized formatting
+    class StdoutTransport < FileTransport
+      def initialize(options = {})
+        # Merge STDOUT-specific defaults with FileTransport defaults
+        stdout_options = {
+          file_path: $stdout,
+          file_mode: 'w',
+          file_type: :regular,
+          format: :pretty,  # :pretty or :json
+          enable_subscriptions: false,  # STDOUT is publish-only
+          auto_flush: true
         }
+        super(stdout_options.merge(options))
       end
 
+      # Default to JSON for readability in STDOUT
+      def default_serializer
+        SmartMessage::Serializer::Json.new
+      end
+      
+      # Override configuration to handle STDOUT-specific setup
       def configure
-        @output = @options[:output].is_a?(String) ? File.open(@options[:output], 'w') : @options[:output]
+        # If file_path is a string, delegate to parent FileTransport
+        if @options[:file_path].is_a?(String)
+          super
+        else
+          # Use the IO object directly (like $stdout)
+          @file_handle = @options[:file_path]
+          @write_buffer = []
+          @last_flush = Time.now
+          @file_mutex = Mutex.new
+        end
       end
-
-      # Enable/disable loopback mode
-      def loopback=(enabled)
-        @options[:loopback] = enabled
+      
+      # Override write_to_file to handle STDOUT directly
+      def write_to_file(serialized_message)
+        # If using a string file path, delegate to parent
+        if @options[:file_path].is_a?(String)
+          super
+        else
+          # Use IO object directly
+          content = prepare_file_content(serialized_message)
+          @file_handle.write(content)
+          @file_handle.flush if @options[:auto_flush]
+        end
       end
 
-      def loopback?
-        @options[:loopback]
+      # Override the file content preparation to use custom formatting
+      def prepare_file_content(serialized_message)
+        format_message(@current_message_class, serialized_message)
       end
 
-      # Publish message to STDOUT (single-tier serialization)
-      def do_publish(message_class, serialized_message)
-        logger.debug { "[SmartMessage::StdoutTransport] do_publish called" }
-        logger.debug { "[SmartMessage::StdoutTransport] message_class: #{message_class}" }
-        
-        @output.puts format_message(message_class, serialized_message)
-        @output.flush
-
-        # If loopback is enabled, route the message back through the dispatcher
-        if loopback?
-          logger.debug { "[SmartMessage::StdoutTransport] Loopback enabled, calling receive" }
-          receive(message_class, serialized_message)
-        end
-      rescue => e
-        logger.error { "[SmartMessage] Error in stdout transport do_publish: #{e.class.name} - #{e.message}" }
-        raise
+      # Override subscribe methods to log warnings since this is a publish-only transport
+      def subscribe(message_class, process_method, filter_options = {})
+        logger.warn { "[SmartMessage::StdoutTransport] Subscription attempt ignored - STDOUT transport is publish-only (message_class: #{message_class}, process_method: #{process_method})" }
       end
 
-      def connected?
-        !@output.closed?
+      def unsubscribe(message_class, process_method)
+        logger.warn { "[SmartMessage::StdoutTransport] Unsubscribe attempt ignored - STDOUT transport is publish-only (message_class: #{message_class}, process_method: #{process_method})" }
       end
 
-      def disconnect
-        @output.close if @output.respond_to?(:close) && @output != $stdout && @output != $stderr
+      def unsubscribe!(message_class)
+        logger.warn { "[SmartMessage::StdoutTransport] Unsubscribe all attempt ignored - STDOUT transport is publish-only (message_class: #{message_class})" }
       end
 
       private
 
       def format_message(message_class, serialized_message)
-        <<~MESSAGE
+        if @options[:format] == :json
+          # Output as JSON for machine parsing
+          {
+            transport: 'stdout',
+            message_class: message_class,
+            serialized_message: serialized_message,
+            timestamp: Time.now.iso8601
+          }.to_json + "\n"
+        else
+          # Pretty format for human reading
+          <<~MESSAGE
 
-          ===================================================
-          == SmartMessage Published via STDOUT Transport
-          == Single-Tier Serialization:
-          == Message Class: #{message_class}
-          == Serialized Message: #{serialized_message}
-          ===================================================
+            ===================================================
+            == SmartMessage Published via STDOUT Transport
+            == Message Class: #{message_class}
+            == Serializer: #{@serializer.class.name}
+            == Serialized Message:
+            #{serialized_message}
+            ===================================================
 
-        MESSAGE
+          MESSAGE
+        end
       end
     end
   end

data/lib/smart_message/transport/stdout_transport.rb.backup

@@ -0,0 +1,88 @@
+# lib/smart_message/transport/stdout_transport.rb
+# encoding: utf-8
+# frozen_string_literal: true
+
+module SmartMessage
+  module Transport
+    # STDOUT transport for testing and development
+    # This is a publish-only transport that outputs messages to STDOUT
+    class StdoutTransport < Base
+      def default_options
+        {
+          output: $stdout,
+          format: :pretty  # :pretty or :json
+        }
+      end
+
+      # Default to JSON for readability in STDOUT
+      def default_serializer
+        SmartMessage::Serializer::Json.new
+      end
+
+      def configure
+        @output = @options[:output].is_a?(String) ? File.open(@options[:output], 'w') : @options[:output]
+      end
+
+
+      # Publish message to STDOUT
+      def do_publish(message_class, serialized_message)
+        logger.debug { "[SmartMessage::StdoutTransport] do_publish called" }
+        logger.debug { "[SmartMessage::StdoutTransport] message_class: #{message_class}" }
+        
+        @output.puts format_message(message_class, serialized_message)
+        @output.flush
+      rescue => e
+        logger.error { "[SmartMessage] Error in stdout transport do_publish: #{e.class.name} - #{e.message}" }
+        raise
+      end
+
+      def connected?
+        !@output.closed?
+      end
+
+      def disconnect
+        @output.close if @output.respond_to?(:close) && @output != $stdout && @output != $stderr
+      end
+
+      # Override subscribe methods to log warnings since this is a publish-only transport
+      def subscribe(message_class, process_method, filter_options = {})
+        logger.warn { "[SmartMessage::StdoutTransport] Subscription attempt ignored - STDOUT transport is publish-only (message_class: #{message_class}, process_method: #{process_method})" }
+      end
+
+      def unsubscribe(message_class, process_method)
+        logger.warn { "[SmartMessage::StdoutTransport] Unsubscribe attempt ignored - STDOUT transport is publish-only (message_class: #{message_class}, process_method: #{process_method})" }
+      end
+
+      def unsubscribe!(message_class)
+        logger.warn { "[SmartMessage::StdoutTransport] Unsubscribe all attempt ignored - STDOUT transport is publish-only (message_class: #{message_class})" }
+      end
+
+      private
+
+      def format_message(message_class, serialized_message)
+        if @options[:format] == :json
+          # Output as JSON for machine parsing
+          {
+            transport: 'stdout',
+            message_class: message_class,
+            serialized_message: serialized_message,
+            timestamp: Time.now.iso8601
+          }.to_json
+        else
+          # Pretty format for human reading
+          <<~MESSAGE
+
+            ===================================================
+            == SmartMessage Published via STDOUT Transport
+            == Message Class: #{message_class}
+            == Serializer: #{@serializer.class.name}
+            == Serialized Message:
+            #{serialized_message}
+            ===================================================
+
+          MESSAGE
+        end
+      end
+    end
+  end
+end

data/lib/smart_message/transport.rb

@@ -7,7 +7,6 @@ require_relative 'transport/registry'
 require_relative 'transport/stdout_transport'
 require_relative 'transport/memory_transport'
 require_relative 'transport/redis_transport'
-require_relative 'transport/redis_queue_transport'
 
 module SmartMessage
   module Transport

data/lib/smart_message/version.rb

@@ -3,5 +3,5 @@
 # frozen_string_literal: true
 
 module SmartMessage
-  VERSION = '0.0.12'
+  VERSION = '0.0.16'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: smart_message
 version: !ruby/object:Gem::Version
-  version: 0.0.12
+  version: 0.0.16
 platform: ruby
 authors:
 - Dewayne VanHoozer
@@ -311,9 +311,6 @@ files:
 - docs/development/troubleshooting.md
 - docs/getting-started/examples.md
 - docs/getting-started/quick-start.md
-- docs/guides/redis-queue-getting-started.md
-- docs/guides/redis-queue-patterns.md
-- docs/guides/redis-queue-production.md
 - docs/index.md
 - docs/reference/dead-letter-queue.md
 - docs/reference/logging.md
@@ -322,8 +319,7 @@ files:
 - docs/reference/serializers.md
 - docs/reference/transports.md
 - docs/transports/memory-transport.md
-- docs/transports/redis-enhanced-transport.md
-- docs/transports/redis-queue-transport.md
+- docs/transports/multi-transport.md
 - docs/transports/redis-transport-comparison.md
 - docs/transports/redis-transport.md
 - examples/.gitignore
@@ -360,12 +356,19 @@ files:
 - examples/city_scenario/start_demo.sh
 - examples/city_scenario/stop_demo.sh
 - examples/city_scenario/visitor.rb
+- examples/file/00_run_all_file_demos.rb
+- examples/file/01_basic_file_transport_demo.rb
+- examples/file/02_fifo_transport_demo.rb
+- examples/file/03_file_watching_demo.rb
+- examples/file/04_multi_transport_file_demo.rb
+- examples/file/README.md
+- examples/memory/00_run_all_demos.rb
 - examples/memory/01_message_deduplication_demo.rb
 - examples/memory/02_dead_letter_queue_demo.rb
 - examples/memory/03_point_to_point_orders.rb
 - examples/memory/04_publish_subscribe_events.rb
 - examples/memory/05_many_to_many_chat.rb
-- examples/memory/06_pretty_print_demo.rb
+- examples/memory/06_stdout_publish_only.rb
 - examples/memory/07_proc_handlers_demo.rb
 - examples/memory/08_custom_logger_demo.rb
 - examples/memory/09_error_handling_demo.rb
@@ -375,10 +378,14 @@ files:
 - examples/memory/13_header_block_configuration.rb
 - examples/memory/14_global_configuration_demo.rb
 - examples/memory/15_logger_demo.rb
+- examples/memory/16_pretty_print_demo.rb
 - examples/memory/README.md
+- examples/memory/log/demo_app.log.1
+- examples/memory/log/demo_app.log.2
 - examples/memory/memory_transport_architecture.svg
 - examples/memory/point_to_point_pattern.svg
 - examples/memory/publish_subscribe_pattern.svg
+- examples/multi_transport_example.rb
 - 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
@@ -399,32 +406,9 @@ files:
 - examples/redis/redis_transport_architecture.svg
 - examples/redis/smart_home_iot_dataflow.md
 - examples/redis/smart_home_system_architecture.svg
-- examples/redis_enhanced/README.md
-- examples/redis_enhanced/enhanced_01_basic_patterns.rb
-- examples/redis_enhanced/enhanced_02_fluent_api.rb
-- examples/redis_enhanced/enhanced_03_dual_publishing.rb
-- examples/redis_enhanced/enhanced_04_advanced_routing.rb
-- examples/redis_queue/01_basic_messaging.rb
-- examples/redis_queue/01_comprehensive_examples.rb
-- examples/redis_queue/02_pattern_routing.rb
-- examples/redis_queue/03_fluent_api.rb
-- examples/redis_queue/04_load_balancing.rb
-- examples/redis_queue/05_microservices.rb
-- examples/redis_queue/06_emergency_alerts.rb
-- examples/redis_queue/07_queue_management.rb
-- examples/redis_queue/README.md
-- examples/redis_queue/enhanced_01_basic_patterns.rb
-- examples/redis_queue/enhanced_02_fluent_api.rb
-- examples/redis_queue/enhanced_03_dual_publishing.rb
-- examples/redis_queue/enhanced_04_advanced_routing.rb
-- examples/redis_queue/redis_queue_architecture.svg
-- ideas/README.md
-- ideas/agents.md
-- ideas/database_transport.md
-- ideas/improvement.md
-- ideas/meshage.md
-- ideas/message_discovery.md
-- ideas/message_schema.md
+- examples/utilities/box_it.rb
+- examples/utilities/doing.rb
+- examples/utilities/temp.md
 - lib/simple_stats.rb
 - lib/smart_message.rb
 - lib/smart_message/.idea/.gitignore
@@ -461,17 +445,21 @@ files:
 - lib/smart_message/serializer/json.rb
 - lib/smart_message/subscription.rb
 - lib/smart_message/transport.rb
+- lib/smart_message/transport/async_publish_queue.rb
 - lib/smart_message/transport/base.rb
+- lib/smart_message/transport/fifo_operations.rb
+- lib/smart_message/transport/file_operations.rb
+- lib/smart_message/transport/file_transport.rb
+- lib/smart_message/transport/file_watching.rb
 - lib/smart_message/transport/memory_transport.rb
-- lib/smart_message/transport/redis_enhanced_transport.rb
-- lib/smart_message/transport/redis_queue_transport.rb
+- lib/smart_message/transport/partitioned_files.rb
 - lib/smart_message/transport/redis_transport.rb
 - lib/smart_message/transport/registry.rb
 - lib/smart_message/transport/stdout_transport.rb
+- lib/smart_message/transport/stdout_transport.rb.backup
 - lib/smart_message/utilities.rb
 - lib/smart_message/version.rb
 - lib/smart_message/versioning.rb
-- lib/smart_message/wrapper.rb.bak
 - mkdocs.yml
 - p2p_plan.md
 - p2p_roadmap.md
@@ -499,7 +487,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.7.1
+rubygems_version: 3.7.2
 specification_version: 4
 summary: An abstraction to protect message content from the backend delivery transport.
 test_files: []