active_cqrs 0.1.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c2e4253bd612863165532f83c066668977d3f6caa0c078dacb47bc5376ac29ae
+  data.tar.gz: ad25655a55d929a16d6a043a62d19150434edbf2dba06b6907cc941d2cfc764f
+SHA512:
+  metadata.gz: 9ed47015cb1271d144e4a0c2ddfbea7eef8c28da0b1809750bb56fe495fd11189092cf9db28ef01d9e72a01ea0fed31d3cedfd75c8bd200a1e9c598cdb835128
+  data.tar.gz: 560a0487bc47c17c97632982f1b187e5864c96134331e8e67f6a36438ab2c0917446d3a8b07f221cfbfff985cdcc63818d7e552ad603c623e2f9db1b744bd90e

data/lib/active_cqrs/auto_registrar.rb

@@ -0,0 +1,54 @@
+require "active_cqrs/logger"
+
+module ActiveCqrs
+  class AutoRegistrar
+    def initialize(command_bus:, query_bus:, root: Rails.root)
+      @command_bus = command_bus
+      @query_bus = query_bus
+      @root = root
+    end
+
+    def call
+      load_handlers
+      register_handlers
+    end
+
+    private
+
+    def load_handlers
+      command_files = Dir[@root.join("app/handlers/commands/**/*.rb")]
+      query_files   = Dir[@root.join("app/handlers/queries/**/*.rb")]
+
+      (command_files + query_files).each do |file|
+        require_dependency file
+        Logger.log "Loaded handler file: #{file.gsub(@root.to_s + "/", "")}"
+      end
+    end
+
+    def register_handlers
+      ObjectSpace.each_object(Class).select { |klass| klass.name&.end_with?("Handler") }.each do |handler_class|
+        next unless handler_class.name
+
+        base_name = handler_class.name.sub(/Handler$/, "")
+        command_class = safe_constantize("#{base_name}Command")
+        query_class   = safe_constantize("#{base_name}Query")
+
+        if command_class
+          @command_bus.registry.register(command_class, handler_class.new)
+          Logger.log "Registered #{handler_class} for #{command_class}"
+        elsif query_class
+          @query_bus.registry.register(query_class, handler_class.new)
+          Logger.log "Registered #{handler_class} for #{query_class}"
+        else
+          Logger.log "Skipped #{handler_class} — no matching Command or Query class found"
+        end
+      end
+    end
+
+    def safe_constantize(name)
+      Object.const_get(name)
+    rescue NameError
+      nil
+    end
+  end
+end

data/lib/active_cqrs/command.rb

@@ -0,0 +1,3 @@
+module ActiveCqrs
+  class Command; end
+end

data/lib/active_cqrs/command_bus.rb

@@ -0,0 +1,14 @@
+module ActiveCqrs
+  class CommandBus
+    attr_reader :registry
+
+    def initialize(registry = HandlerRegistry.new)
+      @registry = registry
+    end
+
+    def call(command)
+      handler = @registry.resolve(command.class)
+      handler.call(command)
+    end
+  end
+end

data/lib/active_cqrs/handler_registry.rb

@@ -0,0 +1,15 @@
+module ActiveCqrs
+  class HandlerRegistry
+    def initialize
+      @handlers = {}
+    end
+
+    def register(klass, handler)
+      @handlers[klass] = handler
+    end
+
+    def resolve(klass)
+      @handlers[klass] || raise("No handler registered for #{klass}")
+    end
+  end
+end

data/lib/active_cqrs/logger.rb

@@ -0,0 +1,21 @@
+require "logger"
+
+module ActiveCqrs
+  module Logger
+    class << self
+      attr_accessor :enabled
+
+      def log(message)
+        return unless enabled
+
+        if defined?(Rails)
+          ::Rails.logger.info("[CQRS] #{message}")
+        else
+          puts "[CQRS] #{message}"
+        end
+      end
+    end
+
+    self.enabled = true
+  end
+end

data/lib/active_cqrs/query.rb

@@ -0,0 +1,3 @@
+module ActiveCqrs
+  class Query; end
+end

data/lib/active_cqrs/query_bus.rb

@@ -0,0 +1,14 @@
+module ActiveCqrs
+  class QueryBus
+    attr_reader :registry
+
+    def initialize(registry = HandlerRegistry.new)
+      @registry = registry
+    end
+
+    def call(query)
+      handler = @registry.resolve(query.class)
+      handler.call(query)
+    end
+  end
+end

data/lib/active_cqrs/railtie.rb

@@ -0,0 +1,9 @@
+require "rails/railtie"
+
+module ActiveCQRS
+  class Railtie < Rails::Railtie
+    initializer "active_cqrs.configure" do |app|
+      # Optionally inject configuration or generators
+    end
+  end
+end

data/lib/active_cqrs/version.rb

@@ -0,0 +1,3 @@
+module ActiveCqrs
+  VERSION = "0.1.1"
+end

data/lib/active_cqrs.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "active_cqrs/version"
+require "active_cqrs/command"
+require "active_cqrs/query"
+require "active_cqrs/command_bus"
+require "active_cqrs/query_bus"
+require "active_cqrs/handler_registry"
+require "active_cqrs/logger"
+require "active_cqrs/auto_registrar"
+require "active_cqrs/railtie" if defined?(Rails)
+require_relative "active_cqrs/version"
+
+module ActiveCqrs
+  class Error < StandardError; end
+  # Your code goes here...
+end

data/lib/generators/cqrs/command/command_generator.rb

@@ -0,0 +1,18 @@
+require "rails/generators"
+
+module Cqrs
+  module Generators
+    class CommandGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+      desc "Generates a command and corresponding handler"
+
+      def create_command_file
+        template "command.rb.tt", File.join("app/commands", class_path, "#{file_name}_command.rb")
+      end
+
+      def create_handler_file
+        template "command_handler.rb.tt", File.join("app/handlers/commands", class_path, "#{file_name}_handler.rb")
+      end
+    end
+  end
+end

data/lib/generators/cqrs/install/install_generator.rb

@@ -0,0 +1,14 @@
+require "rails/generators"
+
+module Cqrs
+  module Generators
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc "Creates a CQRS initializer"
+
+      def copy_initializer
+        template "initializer.rb", "config/initializers/cqrs.rb"
+      end
+    end
+  end
+end

data/lib/generators/cqrs/install/templates/initializer.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "active_cqrs"
+
+Rails.application.config.to_prepare do
+  CQRS_COMMAND_BUS = ActiveCqrs::CommandBus.new
+  CQRS_QUERY_BUS   = ActiveCqrs::QueryBus.new
+
+  ActiveCqrs::Logger.enabled = Rails.env.development?
+
+  ActiveCqrs::AutoRegistrar.new(
+    command_bus: CQRS_COMMAND_BUS,
+    query_bus:   CQRS_QUERY_BUS
+  ).call
+end

data/lib/generators/cqrs/query/query_generator.rb

@@ -0,0 +1,18 @@
+require "rails/generators"
+
+module Cqrs
+  module Generators
+    class QueryGenerator < Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+      desc "Generates a query and corresponding handler"
+
+      def create_query_file
+        template "query.rb.tt", File.join("app/queries", class_path, "#{file_name}_query.rb")
+      end
+
+      def create_handler_file
+        template "query_handler.rb.tt", File.join("app/handlers/queries", class_path, "#{file_name}_handler.rb")
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification
+name: active_cqrs
+version: !ruby/object:Gem::Version
+  version: 0.1.1
+platform: ruby
+authors:
+- kiebor81
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2025-07-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '6.0'
+description: active_cqrs is a lightweight Ruby gem that introduces CQRS into Rails
+  applications
+email: 
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/active_cqrs.rb
+- lib/active_cqrs/auto_registrar.rb
+- lib/active_cqrs/command.rb
+- lib/active_cqrs/command_bus.rb
+- lib/active_cqrs/handler_registry.rb
+- lib/active_cqrs/logger.rb
+- lib/active_cqrs/query.rb
+- lib/active_cqrs/query_bus.rb
+- lib/active_cqrs/railtie.rb
+- lib/active_cqrs/version.rb
+- lib/generators/cqrs/command/command_generator.rb
+- lib/generators/cqrs/install/install_generator.rb
+- lib/generators/cqrs/install/templates/initializer.rb
+- lib/generators/cqrs/query/query_generator.rb
+homepage: https://github.com/kiebor81/active_cqrs
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.17
+signing_key: 
+specification_version: 4
+summary: CQRS interface for Rails using ActiveRecord
+test_files: []