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_threadpool_20250818_205044.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:50:44-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 1.828418,
+    "memory_used_mb": 83.328125
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.382325,
+        "publish": 0.170594,
+        "processing": 0.10505
+      },
+      "throughput": {
+        "messages_per_second": 2615.575753612764,
+        "publish_rate": 5861.870874708372
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1000,
+        "completed_task_count": 1000,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 0.59088,
+        "publish": 0.033234,
+        "processing": 0.469295
+      },
+      "throughput": {
+        "messages_per_second": 846.1955050094774,
+        "publish_rate": 15044.833604140338
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1500,
+        "completed_task_count": 1500,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.284559,
+        "publish": 0.050618,
+        "processing": 0.102466
+      },
+      "throughput": {
+        "messages_per_second": 2811.367765560042,
+        "publish_rate": 15804.654470741632
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2300,
+        "completed_task_count": 2300,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.14135,
+        "publish": 0.012542,
+        "processing": 0.101995
+      },
+      "throughput": {
+        "messages_per_second": 1414.9274849663955,
+        "publish_rate": 15946.420028703556
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2500,
+        "completed_task_count": 2500,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.411687,
+        "publish": 0.035677,
+        "processing": 0.287102
+      },
+      "throughput": {
+        "messages_per_second": 1457.417892719469,
+        "publish_rate": 16817.557530061385
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 3100,
+        "completed_task_count": 3100,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_threadpool_20250818_205109.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:51:09-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 1.762657,
+    "memory_used_mb": 73.015625
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.351877,
+        "publish": 0.141333,
+        "processing": 0.105033
+      },
+      "throughput": {
+        "messages_per_second": 2841.9021419416445,
+        "publish_rate": 7075.488385585816
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1000,
+        "completed_task_count": 1000,
+        "queue_length": 0,
+        "length": 816,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 0.570031,
+        "publish": 0.045029,
+        "processing": 0.453406
+      },
+      "throughput": {
+        "messages_per_second": 877.1452780638247,
+        "publish_rate": 11103.955228852517
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1500,
+        "completed_task_count": 1500,
+        "queue_length": 0,
+        "length": 816,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.258034,
+        "publish": 0.055317,
+        "processing": 0.105042
+      },
+      "throughput": {
+        "messages_per_second": 3100.36661835262,
+        "publish_rate": 14462.100258510043
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2300,
+        "completed_task_count": 2300,
+        "queue_length": 0,
+        "length": 816,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.150409,
+        "publish": 0.014546,
+        "processing": 0.105047
+      },
+      "throughput": {
+        "messages_per_second": 1329.7076637701202,
+        "publish_rate": 13749.484394335212
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2500,
+        "completed_task_count": 2500,
+        "queue_length": 0,
+        "length": 816,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.416404,
+        "publish": 0.031952,
+        "processing": 0.286691
+      },
+      "throughput": {
+        "messages_per_second": 1440.908348622972,
+        "publish_rate": 18778.167250876315
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 3100,
+        "completed_task_count": 3100,
+        "queue_length": 0,
+        "length": 816,
+        "running": true
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_threadpool_20250818_205252.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-18T20:52:52-05:00",
+    "implementation": "thread_pool",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processor_count": 12
+  },
+  "overall_stats": {
+    "total_runtime": 1.71345,
+    "memory_used_mb": 67.484375
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.358245,
+        "publish": 0.146183,
+        "processing": 0.105031
+      },
+      "throughput": {
+        "messages_per_second": 2791.385783472205,
+        "publish_rate": 6840.740715404664
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1000,
+        "completed_task_count": 1000,
+        "queue_length": 0,
+        "length": 767,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 0.551001,
+        "publish": 0.037816,
+        "processing": 0.445864
+      },
+      "throughput": {
+        "messages_per_second": 907.439369438531,
+        "publish_rate": 13221.916649037443
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1500,
+        "completed_task_count": 1500,
+        "queue_length": 0,
+        "length": 767,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.254371,
+        "publish": 0.055562,
+        "processing": 0.105019
+      },
+      "throughput": {
+        "messages_per_second": 3145.0125997067275,
+        "publish_rate": 14398.329793743926
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2300,
+        "completed_task_count": 2300,
+        "queue_length": 0,
+        "length": 800,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.136309,
+        "publish": 0.009807,
+        "processing": 0.105042
+      },
+      "throughput": {
+        "messages_per_second": 1467.2545466550264,
+        "publish_rate": 20393.596410727034
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2500,
+        "completed_task_count": 2500,
+        "queue_length": 0,
+        "length": 800,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.396035,
+        "publish": 0.034099,
+        "processing": 0.27945
+      },
+      "throughput": {
+        "messages_per_second": 1515.0176120797403,
+        "publish_rate": 17595.823924455264
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 3100,
+        "completed_task_count": 3100,
+        "queue_length": 0,
+        "length": 800,
+        "running": true
+      }
+    }
+  }
+}

data/examples/performance_metrics/benchmark_results_unknown_20250819_172852.json ADDED Viewed

@@ -0,0 +1,130 @@
+{
+  "benchmark_info": {
+    "timestamp": "2025-08-19T17:28:52-05:00",
+    "subject": "unknown",
+    "ruby_version": "3.4.5",
+    "platform": "arm64-darwin24",
+    "processors": 12
+  },
+  "overall_stats": {
+    "total_runtime": 2.160022,
+    "memory_used_mb": 86.9375
+  },
+  "scenario_results": {
+    "cpu_light": {
+      "name": "CPU Light",
+      "messages_generated": 1000,
+      "messages_published": 1000,
+      "messages_processed": 1000,
+      "errors": 0,
+      "times": {
+        "total": 0.635312,
+        "publish": 0.406514,
+        "processing": 0.105049
+      },
+      "throughput": {
+        "messages_per_second": 1574.0297680509734,
+        "publish_rate": 2459.939879069356
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1000,
+        "completed_task_count": 1000,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "cpu_heavy": {
+      "name": "CPU Heavy",
+      "messages_generated": 500,
+      "messages_published": 500,
+      "messages_processed": 500,
+      "errors": 0,
+      "times": {
+        "total": 0.322838,
+        "publish": 0.150142,
+        "processing": 0.105063
+      },
+      "throughput": {
+        "messages_per_second": 1548.7643957650587,
+        "publish_rate": 3330.180762211773
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 1500,
+        "completed_task_count": 1500,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "io_light": {
+      "name": "I/O Light",
+      "messages_generated": 800,
+      "messages_published": 800,
+      "messages_processed": 800,
+      "errors": 0,
+      "times": {
+        "total": 0.50592,
+        "publish": 0.296219,
+        "processing": 0.10506
+      },
+      "throughput": {
+        "messages_per_second": 1581.2776723592663,
+        "publish_rate": 2700.7045462985157
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2300,
+        "completed_task_count": 2300,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "io_heavy": {
+      "name": "I/O Heavy",
+      "messages_generated": 200,
+      "messages_published": 200,
+      "messages_processed": 200,
+      "errors": 0,
+      "times": {
+        "total": 0.204666,
+        "publish": 0.070861,
+        "processing": 0.105044
+      },
+      "throughput": {
+        "messages_per_second": 977.2018801364175,
+        "publish_rate": 2822.427004981584
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 2500,
+        "completed_task_count": 2500,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    },
+    "mixed": {
+      "name": "Mixed Load",
+      "messages_generated": 600,
+      "messages_published": 600,
+      "messages_processed": 600,
+      "errors": 0,
+      "times": {
+        "total": 0.47226,
+        "publish": 0.263228,
+        "processing": 0.105055
+      },
+      "throughput": {
+        "messages_per_second": 1270.4865963664083,
+        "publish_rate": 2279.3927697661343
+      },
+      "dispatcher_stats": {
+        "scheduled_task_count": 3100,
+        "completed_task_count": 3100,
+        "queue_length": 0,
+        "length": 1000,
+        "running": true
+      }
+    }
+  }
+}