RubyGems - smart_message - Versions diffs - 0.0.8 → 0.0.10 - Mend

smart_message 0.0.8 → 0.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (87) hide show

checksums.yaml +4 -4
data/.gitignore +1 -0
data/.irbrc +24 -0
data/CHANGELOG.md +119 -0
data/Gemfile.lock +6 -1
data/README.md +389 -17
data/docs/README.md +3 -1
data/docs/addressing.md +119 -13
data/docs/architecture.md +184 -46
data/docs/dead_letter_queue.md +673 -0
data/docs/dispatcher.md +87 -0
data/docs/examples.md +59 -1
data/docs/getting-started.md +8 -1
data/docs/logging.md +382 -326
data/docs/message_deduplication.md +488 -0
data/docs/message_filtering.md +451 -0
data/examples/01_point_to_point_orders.rb +54 -53
data/examples/02_publish_subscribe_events.rb +14 -10
data/examples/03_many_to_many_chat.rb +16 -8
data/examples/04_redis_smart_home_iot.rb +20 -10
data/examples/05_proc_handlers.rb +12 -11
data/examples/06_custom_logger_example.rb +95 -100
data/examples/07_error_handling_scenarios.rb +4 -2
data/examples/08_entity_addressing_basic.rb +18 -6
data/examples/08_entity_addressing_with_filtering.rb +27 -9
data/examples/09_dead_letter_queue_demo.rb +559 -0
data/examples/09_regex_filtering_microservices.rb +407 -0
data/examples/10_header_block_configuration.rb +263 -0
data/examples/10_message_deduplication.rb +209 -0
data/examples/11_global_configuration_example.rb +219 -0
data/examples/README.md +102 -0
data/examples/dead_letters.jsonl +12 -0
data/examples/performance_metrics/benchmark_results_ractor_20250818_205603.json +135 -0
data/examples/performance_metrics/benchmark_results_ractor_20250818_205831.json +135 -0
data/examples/performance_metrics/benchmark_results_test_20250818_204942.json +130 -0
data/examples/performance_metrics/benchmark_results_threadpool_20250818_204942.json +130 -0
data/examples/performance_metrics/benchmark_results_threadpool_20250818_204959.json +130 -0
data/examples/performance_metrics/benchmark_results_threadpool_20250818_205044.json +130 -0
data/examples/performance_metrics/benchmark_results_threadpool_20250818_205109.json +130 -0
data/examples/performance_metrics/benchmark_results_threadpool_20250818_205252.json +130 -0
data/examples/performance_metrics/benchmark_results_unknown_20250819_172852.json +130 -0
data/examples/performance_metrics/compare_benchmarks.rb +519 -0
data/examples/performance_metrics/dead_letters.jsonl +3100 -0
data/examples/performance_metrics/performance_benchmark.rb +344 -0
data/examples/show_logger.rb +367 -0
data/examples/show_me.rb +145 -0
data/examples/temp.txt +94 -0
data/examples/tmux_chat/bot_agent.rb +4 -2
data/examples/tmux_chat/human_agent.rb +4 -2
data/examples/tmux_chat/room_monitor.rb +4 -2
data/examples/tmux_chat/shared_chat_system.rb +6 -3
data/lib/smart_message/addressing.rb +259 -0
data/lib/smart_message/base.rb +123 -599
data/lib/smart_message/circuit_breaker.rb +2 -1
data/lib/smart_message/configuration.rb +199 -0
data/lib/smart_message/ddq/base.rb +71 -0
data/lib/smart_message/ddq/memory.rb +109 -0
data/lib/smart_message/ddq/redis.rb +168 -0
data/lib/smart_message/ddq.rb +31 -0
data/lib/smart_message/dead_letter_queue.rb +27 -10
data/lib/smart_message/deduplication.rb +174 -0
data/lib/smart_message/dispatcher.rb +259 -61
data/lib/smart_message/header.rb +5 -0
data/lib/smart_message/logger/base.rb +21 -1
data/lib/smart_message/logger/default.rb +88 -138
data/lib/smart_message/logger/lumberjack.rb +324 -0
data/lib/smart_message/logger/null.rb +81 -0
data/lib/smart_message/logger.rb +17 -9
data/lib/smart_message/messaging.rb +100 -0
data/lib/smart_message/plugins.rb +132 -0
data/lib/smart_message/serializer/base.rb +25 -8
data/lib/smart_message/serializer/json.rb +5 -4
data/lib/smart_message/subscription.rb +196 -0
data/lib/smart_message/transport/base.rb +72 -41
data/lib/smart_message/transport/memory_transport.rb +7 -5
data/lib/smart_message/transport/redis_transport.rb +15 -45
data/lib/smart_message/transport/stdout_transport.rb +18 -8
data/lib/smart_message/transport.rb +1 -34
data/lib/smart_message/utilities.rb +142 -0
data/lib/smart_message/version.rb +1 -1
data/lib/smart_message/versioning.rb +85 -0
data/lib/smart_message/wrapper.rb.bak +132 -0
data/lib/smart_message.rb +74 -28
data/smart_message.gemspec +3 -0
metadata +83 -3
data/lib/smart_message/serializer.rb +0 -10
data/lib/smart_message/wrapper.rb +0 -43

data/examples/performance_metrics/benchmark_results_ractor_20250818_205603.json ADDED Viewed

@@ -0,0 +1,135 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:56:03-05:00",
+    "implementation": "ractor",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 4.173938,
+    "memory_used_mb": 21.046875
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.360609,
+        "publish": 0.139781,
+        "processing": 0.103401
+      },
+      "throughput": {
+        "messages_per_second": 2773.0866395458793,
+        "publish_rate": 7154.048118127643
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 1000,
+        "scheduled_task_count": 1000,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 1.701841,
+        "publish": 0.487508,
+        "processing": 1.1547
+      },
+      "throughput": {
+        "messages_per_second": 293.7994795048421,
+        "publish_rate": 1025.624194885007
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 1500,
+        "scheduled_task_count": 1500,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.880671,
+        "publish": 0.068458,
+        "processing": 0.724868
+      },
+      "throughput": {
+        "messages_per_second": 908.3982554211505,
+        "publish_rate": 11685.997253790645
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 2300,
+        "scheduled_task_count": 2300,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.249395,
+        "publish": 0.015782,
+        "processing": 0.205659
+      },
+      "throughput": {
+        "messages_per_second": 801.9406964854949,
+        "publish_rate": 12672.665061462425
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 2500,
+        "scheduled_task_count": 2500,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.969969,
+        "publish": 0.145701,
+        "processing": 0.747523
+      },
+      "throughput": {
+        "messages_per_second": 618.5764699696589,
+        "publish_rate": 4118.022525583215
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 3100,
+        "scheduled_task_count": 3100,
+        "running": true,
+        "implementation": "ractor"
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_ractor_20250818_205831.json ADDED Viewed

@@ -0,0 +1,135 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:58:31-05:00",
+    "implementation": "ractor",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 4.174644,
+    "memory_used_mb": 23.53125
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.353973,
+        "publish": 0.135409,
+        "processing": 0.106285
+      },
+      "throughput": {
+        "messages_per_second": 2825.0742288253628,
+        "publish_rate": 7385.033491126882
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 1000,
+        "scheduled_task_count": 1000,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 1.76826,
+        "publish": 0.427835,
+        "processing": 1.265818
+      },
+      "throughput": {
+        "messages_per_second": 282.76384694558493,
+        "publish_rate": 1168.6748395993782
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 1500,
+        "scheduled_task_count": 1500,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.893786,
+        "publish": 0.065332,
+        "processing": 0.731431
+      },
+      "throughput": {
+        "messages_per_second": 895.068841982309,
+        "publish_rate": 12245.14786016041
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 2300,
+        "scheduled_task_count": 2300,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.274932,
+        "publish": 0.017833,
+        "processing": 0.210557
+      },
+      "throughput": {
+        "messages_per_second": 727.4526064626889,
+        "publish_rate": 11215.162900241125
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 2500,
+        "scheduled_task_count": 2500,
+        "running": true,
+        "implementation": "ractor"
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.870865,
+        "publish": 0.145127,
+        "processing": 0.625774
+      },
+      "throughput": {
+        "messages_per_second": 688.9701618505738,
+        "publish_rate": 4134.309949216893
+      },
+      "dispatcher_stats": {
+        "pool_size": null,
+        "queue_length": 0,
+        "completed_task_count": 3100,
+        "scheduled_task_count": 3100,
+        "running": true,
+        "implementation": "ractor"
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_test_20250818_204942.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:49:42-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 0.320226,
+    "memory_used_mb": 13.234375
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 1000,
+      "times": {
+        "total": 0.104235,
+        "publish": 0.00063,
+        "processing": 8.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 500,
+      "times": {
+        "total": 0.049786,
+        "publish": 0.000265,
+        "processing": 4.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 800,
+      "times": {
+        "total": 0.074226,
+        "publish": 0.000436,
+        "processing": 2.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 200,
+      "times": {
+        "total": 0.017842,
+        "publish": 0.00011,
+        "processing": 2.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 600,
+      "times": {
+        "total": 0.064902,
+        "publish": 0.000362,
+        "processing": 1.0e-05
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_threadpool_20250818_204942.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:49:42-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 0.320226,
+    "memory_used_mb": 13.234375
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 1000,
+      "times": {
+        "total": 0.104235,
+        "publish": 0.00063,
+        "processing": 8.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 500,
+      "times": {
+        "total": 0.049786,
+        "publish": 0.000265,
+        "processing": 4.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 800,
+      "times": {
+        "total": 0.074226,
+        "publish": 0.000436,
+        "processing": 2.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 200,
+      "times": {
+        "total": 0.017842,
+        "publish": 0.00011,
+        "processing": 2.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 600,
+      "times": {
+        "total": 0.064902,
+        "publish": 0.000362,
+        "processing": 1.0e-05
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_threadpool_20250818_204959.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:49:59-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 0.443399,
+    "memory_used_mb": 18.765625
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 1000,
+      "times": {
+        "total": 0.14078,
+        "publish": 0.03588,
+        "processing": 6.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 500,
+      "times": {
+        "total": 0.070466,
+        "publish": 0.016272,
+        "processing": 5.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 800,
+      "times": {
+        "total": 0.107196,
+        "publish": 0.026111,
+        "processing": 8.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 200,
+      "times": {
+        "total": 0.02724,
+        "publish": 0.006383,
+        "processing": 4.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 0,
+      "messages_processed": 0,
+      "errors": 600,
+      "times": {
+        "total": 0.0889,
+        "publish": 0.018691,
+        "processing": 6.0e-06
+      },
+      "throughput": {
+        "messages_per_second": 0.0,
+        "publish_rate": 0.0
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 0,
+        "completed_task_count": 0,
+        "queue_length": 0,
+        "length": 0,
+        "running": true
+      }
+    }
+  }
+}