smart_message 0.0.13 → 0.0.17

data/examples/memory/06_stdout_publish_only.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+# examples/memory/06_stdout_publish_only.rb
+#
+# STDOUT Transport Example - Publish Only
+#
+# This example demonstrates the STDOUT transport with different formats
+# using a single message class that can be configured with different
+# transport instances.
+
+require_relative '../../lib/smart_message'
+
+puts "=== SmartMessage Example: STDOUT Transport Format Demonstrations ==="
+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 simple message class for format demonstration
+class DemoMessage < SmartMessage::Base
+  description "Simple demonstration message for format testing"
+
+  property :first_name,
+    description: "Person's first name"
+  property :last_name,
+    description: "Person's last name"
+
+  # Default config - will be overridden with transport instance replacement
+  config do
+    transport SmartMessage::Transport::StdoutTransport.new
+    from 'demo-service'
+  end
+end
+
+puts "🎨 Example 1: Pretty Format (:pretty) - 1 message"
+puts "=" * 60
+
+# Create a simple message for pretty formatting
+message_data = {
+  first_name: "Alice",
+  last_name: "Johnson"
+}
+
+# Replace the message's transport with :pretty format
+message = DemoMessage.new(**message_data)
+message.transport SmartMessage::Transport::StdoutTransport.new(format: :pretty)
+message.publish
+
+puts
+puts
+puts "📋 Example 2: JSONL Format (:jsonl) - 2 messages"
+puts "=" * 60
+
+# Create two simple messages for JSONL format
+jsonl_messages = [
+  {
+    first_name: "Bob",
+    last_name: "Smith"
+  },
+  {
+    first_name: "Carol",
+    last_name: "Williams"
+  }
+]
+
+# Replace transport with :jsonl format and publish both messages
+jsonl_messages.each do |msg_data|
+  message = DemoMessage.new(**msg_data)
+  message.transport SmartMessage::Transport::StdoutTransport.new(format: :jsonl)
+  message.publish
+end
+
+puts
+puts
+puts "📊 Example 3: JSON Format (:json) - 3 messages"
+puts "=" * 60
+
+# Create three simple messages for JSON format
+json_messages = [
+  {
+    first_name: "David",
+    last_name: "Brown"
+  },
+  {
+    first_name: "Emma",
+    last_name: "Davis"
+  },
+  {
+    first_name: "Frank",
+    last_name: "Miller"
+  }
+]
+
+# Replace transport with :json format and publish all three messages
+json_messages.each do |msg_data|
+  message = DemoMessage.new(**msg_data)
+  message.transport SmartMessage::Transport::StdoutTransport.new(format: :json)
+  message.publish
+end
+
+puts
+puts
+puts "\n🔍 Format Comparison Summary:"
+puts "  🎨 :pretty - Beautiful, colorized output using amazing_print"
+puts "  📋 :jsonl  - JSON Lines format, one message per line (default)"
+puts "  📊 :json   - Compact JSON format without newlines"
+puts
+puts "💡 Usage Ideas:"
+puts "  • Debug message flow: ./my_app | grep 'first_name'"
+puts "  • Feed log aggregators: ./my_app | fluentd"
+puts "  • Pipe to analysis tools: ./my_app | jq '.last_name'"
+puts "  • Integration testing: capture and verify output"
+puts "  • Development monitoring: real-time message visibility"
+puts
+puts "⚠️  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)"