smart_message 0.0.13 → 0.0.16

data/examples/memory/06_stdout_publish_only.rb

@@ -0,0 +1,145 @@
+#!/usr/bin/env ruby
+# examples/memory/06_stdout_publish_only.rb
+#
+# STDOUT Transport Example - Publish Only
+#
+# This example demonstrates the STDOUT transport which is designed for
+# publish-only scenarios - great for debugging, logging, or one-way
+# message output without local processing.
+
+require_relative '../../lib/smart_message'
+
+puts "=== SmartMessage Example: STDOUT Transport (Publish Only) ==="
+puts
+
+# Configure SmartMessage for this example
+SmartMessage.configure do |config|
+  config.logger = STDERR  # Use STDERR for framework logs so STDOUT is clean
+  config.log_level = :warn  # Reduce noise
+end
+
+# Define a Log Message for one-way output
+class LogMessage < SmartMessage::Base
+  description "Log entries that are output to STDOUT for external processing"
+
+  property :level,
+    description: "Log level (info, warn, error, debug)"
+  property :component,
+    description: "Component or service generating the log"
+  property :message,
+    description: "Human-readable log message"
+  property :timestamp,
+    default: -> { Time.now.iso8601 },
+    description: "ISO8601 timestamp of when log was generated"
+  property :context,
+    description: "Optional additional context data"
+
+  # Configure to use STDOUT transport (publish-only)
+  config do
+    transport SmartMessage::Transport::StdoutTransport.new
+    from 'log-service'
+  end
+end
+
+# Define a Metrics Message for monitoring systems
+class MetricsMessage < SmartMessage::Base
+  description "System metrics published to STDOUT for monitoring ingestion"
+
+  property :metric_name,
+    description: "Name of the metric (e.g., 'cpu_usage', 'memory_usage')"
+  property :value,
+    description: "Numeric value of the metric"
+  property :unit,
+    description: "Unit of measurement (%, MB, requests/sec, etc.)"
+  property :tags,
+    description: "Hash of tags for metric categorization"
+  property :timestamp,
+    default: -> { Time.now.to_i },
+    description: "Unix timestamp of metric collection"
+
+  config do
+    transport SmartMessage::Transport::StdoutTransport.new(format: :json)  # JSON format for metrics
+    from 'metrics-collector'
+  end
+end
+
+puts "📝 Publishing log messages to STDOUT..."
+puts "=" * 50
+
+# Create and publish various log messages
+log_messages = [
+  {
+    level: "info",
+    component: "user-service",
+    message: "User authentication successful",
+    context: { user_id: 12345, ip_address: "192.168.1.100" }
+  },
+  {
+    level: "warn",
+    component: "payment-service", 
+    message: "Payment processing took longer than expected",
+    context: { order_id: "ORD-001", processing_time_ms: 5500 }
+  },
+  {
+    level: "error",
+    component: "database-service",
+    message: "Connection pool exhausted",
+    context: { pool_size: 20, active_connections: 20, queue_length: 15 }
+  }
+]
+
+log_messages.each do |log_data|
+  message = LogMessage.new(**log_data)
+  message.publish
+  sleep(0.5)  # Small delay for readability
+end
+
+puts "\n📊 Publishing metrics to STDOUT (JSON format)..."
+puts "=" * 50
+
+# Create and publish system metrics
+metrics_data = [
+  {
+    metric_name: "cpu_usage",
+    value: 67.5,
+    unit: "%",
+    tags: { host: "web-01", environment: "production" }
+  },
+  {
+    metric_name: "memory_usage", 
+    value: 2048,
+    unit: "MB",
+    tags: { host: "web-01", environment: "production" }
+  },
+  {
+    metric_name: "requests_per_second",
+    value: 125,
+    unit: "req/sec",
+    tags: { service: "api-gateway", endpoint: "/api/users" }
+  }
+]
+
+metrics_data.each do |metric_data|
+  message = MetricsMessage.new(**metric_data)
+  message.publish
+  sleep(0.3)
+end
+
+puts "\n" + "=" * 50
+puts "🔍 Key Points About STDOUT Transport:"
+puts "  ✓ Publish-only: No message processing"
+puts "  ✓ Perfect for logging and debugging scenarios"
+puts "  ✓ Great for integration with external systems"
+puts "  ✓ Supports both pretty-print and JSON formats"
+puts "  ✓ Clean separation: output to STDOUT, logs to STDERR"
+puts "  ✓ Subscription attempts are ignored with warnings"
+
+puts "\n💡 Usage Ideas:"
+puts "  • Debug message flow: ./my_app | grep 'MessageClass'"
+puts "  • Feed log aggregators: ./my_app | fluentd"
+puts "  • Pipe to analysis tools: ./my_app | jq '.metric_name'"
+puts "  • Integration testing: capture and verify output"
+puts "  • Development monitoring: real-time message visibility"
+
+puts "\n⚠️  Note: If you need local message processing, use MemoryTransport instead!"
+puts "=" * 80

data/examples/memory/07_proc_handlers_demo.rb

@@ -28,12 +28,12 @@ class NotificationMessage < SmartMessage::Base
     description: "ISO8601 timestamp when notification was created"
 
   config do
-    transport SmartMessage::Transport::StdoutTransport.new(loopback: true)
+    transport SmartMessage::Transport::MemoryTransport.new
   end
 
   # Default handler
-  def self.process(wrapper)
-    message_header, message_payload = wrapper.split
+  def process(message)
+    message_header, message_payload = message
     data = JSON.parse(message_payload)
     icon = case data['type']
            when 'info' then 'ℹ️'
@@ -56,8 +56,8 @@ puts
 
 # 2. Block handler
 puts "2️⃣ Block handler subscription:"
-block_id = NotificationMessage.subscribe do |wrapper|
-  data = JSON.parse(wrapper._sm_payload)
+block_id = NotificationMessage.subscribe do |message|
+  data = message
   if data['type'] == 'error'
     puts "🔥 [BLOCK] Critical error logged: #{data['title']}"
     # Could send to error tracking service here
@@ -68,9 +68,9 @@ puts
 
 # 3. Proc handler
 puts "3️⃣ Proc handler subscription:"
-audit_logger = proc do |wrapper|
-  data = JSON.parse(wrapper._sm_payload)
-  timestamp = wrapper._sm_header.published_at.strftime('%Y-%m-%d %H:%M:%S')
+audit_logger = proc do |message|
+  data = message
+  timestamp = message._sm_header.published_at.strftime('%Y-%m-%d %H:%M:%S')
   puts "📝 [AUDIT] #{timestamp} - User #{data['user_id']}: #{data['type'].upcase}"
 end
 
@@ -80,8 +80,8 @@ puts
 
 # 4. Lambda handler
 puts "4️⃣ Lambda handler subscription:"
-warning_filter = lambda do |wrapper|
-  data = JSON.parse(wrapper._sm_payload)
+warning_filter = lambda do |message|
+  data = message
   if data['type'] == 'warning'
     puts "⚡ [LAMBDA] Warning for user #{data['user_id']}: #{data['message']}"
   end
@@ -94,8 +94,8 @@ puts
 # 5. Method handler (traditional, but shown for comparison)
 puts "5️⃣ Method handler subscription:"
 class NotificationService
-  def self.handle_notifications(wrapper)
-    data = JSON.parse(wrapper._sm_payload)
+  def handle_notifications(message)
+    data = message
     puts "🏢 [SERVICE] Processing #{data['type']} notification for user #{data['user_id']}"
   end
 end
@@ -174,7 +174,7 @@ puts "=" * 60
 
 puts "\nThis example demonstrated:"
 puts "• ✅ Default self.process method (traditional)"
-puts "• ✅ Block handlers with subscribe { |wrapper| ... } (NEW!)"
+puts "• ✅ Block handlers with subscribe { |message| ... } (NEW!)"
 puts "• ✅ Proc handlers with subscribe(proc { ... }) (NEW!)"
 puts "• ✅ Lambda handlers with subscribe(lambda { ... }) (NEW!)"
 puts "• ✅ Method handlers with subscribe('Class.method') (traditional)"