ruby-service-objects

What problem does it solve?

Creating and maintaining Rails service objects is error-prone without a consistent structure; this guide codifies best practices to ensure predictable APIs, strong tests, and clear documentation.

Core Features & Use Cases

• Enforces the .call pattern and module namespacing to keep services predictable and reusable.
• Requires YARD documentation on public methods and applies the frozen_string_literal pragma for consistency.
• Supports orchestrator delegation, transaction wrapping, and robust error handling across multi-step operations.

Quick Start

Create a new service under app/services with a modular namespace, implement a public .call method, and document the API with YARD.