Stroma

A foundation for building modular, extensible DSLs in Ruby.

Building modular DSLs shouldn't require reinventing the wheel. Stroma provides a structured approach for library authors to compose DSL modules with:

• 🔌 Module Registration - Register DSL modules at boot time, compose them into a unified interface
• 🧱 Structured Composition - Include all registered modules automatically via single DSL entry point
• 🏛️ Inheritance Safe - Per-class state isolation with automatic deep copying
• 🪝 Extension Hooks - Optional before/after hooks for user customization
• ⚙️ Extension Settings - Three-level hierarchical storage for extension configuration
• 🔒 Thread Safe - Immutable registry after finalization, safe concurrent reads

Stroma is a foundation for library authors building DSL-driven frameworks (service objects, form objects, decorators, etc.).

Core lifecycle:

1. Register - Define DSL modules at boot time via Stroma::Registry
2. Compose - Classes include Stroma::DSL to gain all registered modules automatically
3. Extend (optional) - Users can add cross-cutting logic via before/after hooks

gem "stroma"

module MyLib
  module DSL
    # Register DSL modules at load time
    Stroma::Registry.register(:inputs, MyLib::Inputs::DSL)
    Stroma::Registry.register(:actions, MyLib::Actions::DSL)
    Stroma::Registry.finalize!

    def self.included(base)
      base.include(Stroma::DSL)
    end
  end
end

module MyLib
  class Base
    include MyLib::DSL
  end
end

class UserService < MyLib::Base
  input :email, type: String

  make :create_user

  private

  def create_user
    # implementation
  end
end

We welcome contributions! Check out our Contributing Guide to get started.

Ways to contribute:

• 🐛 Report bugs and issues
• 💡 Suggest new features
• 📝 Improve documentation
• 🧪 Add test cases
• 🔧 Submit pull requests

Special thanks to all our contributors!

Stroma is available as open source under the terms of the MIT License.