SmartMessage Documentation

SmartMessage is a powerful Ruby framework that transforms ordinary messages into intelligent, self-aware entities capable of routing themselves, validating their contents, and executing business logic. By abstracting away the complexities of transport mechanisms (Redis, RabbitMQ, Kafka) and serialization formats (JSON, MessagePack), SmartMessage lets you focus on what matters: your business logic. Think of SmartMessage as ActiveRecord for messaging - just as ActiveRecord frees you from database-specific SQL, SmartMessage liberates your messages from transport-specific implementations. Each message knows how to validate itself, where it came from, where it's going, and what to do when it arrives. With built-in support for filtering, versioning, deduplication, and concurrent processing, SmartMessage provides enterprise-grade messaging capabilities with the simplicity Ruby developers love.

Table of Contents

Getting Started

• Quick Start
• Basic Usage Examples

Core Concepts

• Architecture Overview
• Property System
• Entity Addressing
• Message Filtering
• Message Processing
• Dispatcher & Routing

Transports

• Transport Layer
• Multi-Transport Publishing
• Redis Transport
• Redis Transport Comparison
• Memory Transport

Guides

• Examples & Use Cases
• Architecture Overview
• Transport Configuration

Reference

• Serializers
• Logging System
• Dead Letter Queue
• Message Deduplication
• Proc Handlers

Development

• Troubleshooting
• Ideas & Roadmap

Quick Navigation

• New to SmartMessage? Start with Quick Start
• Need examples? Check out Examples
• Understanding the architecture? Read Architecture Overview
• Having issues? Visit Troubleshooting

Version

This documentation is for SmartMessage v0.0.8.

For older versions, please check the git tags and corresponding documentation.