rage_arch 0.2.0 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5977f7f0cda9c29591b5fada240de2a007facc8c3922e8f2a9c6a5ae08ed1f5b
-  data.tar.gz: 05b8e5a3a44cb57099c64b33c9cffba6a0abf80dc6256c41eabe87e86d48378e
+  metadata.gz: 827bf0c1b2891fa1d67035363a4b820a71038e7f9b56b4167a29aa7524fa56dc
+  data.tar.gz: 57e7d566e7b2cbf2ff23e0ee9b1958f7a3e96e9dd9bdf1a2bea22e69c32a5d1c
 SHA512:
-  metadata.gz: 25f7ef50af078a7b61663d26fd8586c5d512709b116ca206266c8d04e1d364c19caf5bf131c0886d0061fc7b1db0e7de3c47f2a827360f2a03b03d911ee5336d
-  data.tar.gz: 06fea4288ebf3eeb5a6e1c3a2baf2895c22514389fbb169a5741474ef500baaaa52b129d0711ee645025fc713a6bd58e2436be05979445c64ec1831206af1437
+  metadata.gz: 95f6572c4ce9124edd8570e31be5ef8a0aaebfd63a3e35ce0c72662910fdfe2daf7141f82d3a5c14f1a7df451340b7b3ac59df0a9805b65e957810359fbdb3a0
+  data.tar.gz: 137357b33fe38902cce2b6de71a3905d22b5b698422eabad04f852fc056ee6da763346dbac1cd842df21677df74677530ad759bd6bc47e9c8b00dbff484d8324

data/README.md

@@ -56,10 +56,10 @@ RageArch.registered?(:order_store)  # => true
 
 **Convention-based auto-registration:** Use cases from `app/use_cases/` and deps from `app/deps/` are auto-registered at boot. The initializer is only needed to override conventions or register external adapters.
 
-**AR model auto-resolution:** If a dep symbol ends in `_store` and no file exists in `app/deps/`, rage_arch looks for an ActiveRecord model automatically:
+**AR model auto-resolution:** If a dep symbol ends in `_store` or `_repo` and no file exists in `app/deps/`, rage_arch looks for an ActiveRecord model automatically:
 
-- `:post_store` resolves to `Post`
-- `:appointment_store` resolves to `Appointment`
+- `:post_store` or `:post_repo` resolves to `Post`
+- `:appointment_store` or `:appointment_repo` resolves to `Appointment`
 
 Explicit `RageArch.register(...)` always takes priority.
 
@@ -288,11 +288,15 @@ end
 | `rails g rage_arch:scaffold Post title:string` | Full CRUD: model, use cases, dep, controller, views, routes |
 | `rails g rage_arch:scaffold Post title:string --api` | Same but API-only (JSON responses) |
 | `rails g rage_arch:scaffold Post title:string --skip-model` | Skip model/migration if it already exists |
+| `rails g rage_arch:resource Post title:string` | Like scaffold but without views (API-style controller) |
+| `rails g rage_arch:controller Pages home about` | Thin controller + use case per action + routes |
 | `rails g rage_arch:use_case CreateOrder` | Generates a base use case file |
 | `rails g rage_arch:use_case orders/create` | Generates a namespaced use case (`Orders::Create`) |
 | `rails g rage_arch:dep post_store` | Generates a dep class by scanning method calls in use cases |
 | `rails g rage_arch:dep_switch post_store` | Lists implementations and switches which one is registered |
 | `rails g rage_arch:dep_switch post_store PostgresPostStore` | Directly activates a specific implementation |
+| `rails g rage_arch:mailer PostMailer post_created` | Rails mailer + dep wrapper (auto-registered) |
+| `rails g rage_arch:job ProcessOrder orders_create` | ActiveJob that runs a use case by symbol |
 
 ---
 
@@ -360,7 +364,7 @@ config.rage_arch.async_subscribers = false
 
 At boot, `RageArch.verify_deps!` runs automatically and raises if it finds wiring problems. It checks:
 
-- Every dep declared with `deps :symbol` is registered in the container (or auto-resolved for `_store` deps)
+- Every dep declared with `deps :symbol` is registered in the container (or auto-resolved for `_store`/`_repo` deps)
 - Every method called on a dep is implemented by the registered object (via static analysis)
 - Every use case declared with `use_cases :symbol` exists in the registry
 - Warns if `use_case_symbol` doesn't match the convention-inferred symbol
@@ -369,7 +373,7 @@ Example error output:
 
 ```
 RageArch boot verification failed:
-  UseCase :posts_create (Posts::Create) declares dep :post_store — not registered in container and no AR model found
+  UseCase :posts_create (Posts::Create) declares dep :post_store — not registered in container and no AR model found for _store/_repo
   UseCase :posts_create (Posts::Create) calls dep :post_store#save — Posts::PostStore does not implement #save
   UseCase :posts_notify (Posts::Notify) declares use_cases :email_send — not registered in use case registry
 ```
@@ -394,6 +398,7 @@ end
 ## Documentation
 
 - [`doc/GETTING_STARTED.md`](doc/GETTING_STARTED.md) — Getting started guide with common tasks
+- [`doc/TUTORIAL.md`](doc/TUTORIAL.md) — Side-by-side Rails vs Rails+RageArch comparison
 - [`doc/DOCUMENTATION.md`](doc/DOCUMENTATION.md) — Detailed behaviour (use cases, deps, events, config)
 - [`doc/REFERENCE.md`](doc/REFERENCE.md) — Quick-lookup API reference (classes, methods, options)
 

data/lib/generators/rage_arch/controller_generator.rb

@@ -0,0 +1,53 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module RageArch
+  module Generators
+    class ControllerGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      argument :actions, type: :array, default: [], banner: "action action"
+
+      desc "Generate a thin RageArch controller with use cases for each action."
+      def create_controller
+        template "controller/controller.rb.tt", File.join("app/controllers", "#{plural_file_name}_controller.rb")
+      end
+
+      def create_use_cases
+        actions.each do |action|
+          @current_action = action
+          template "controller/action_use_case.rb.tt", File.join("app/use_cases", plural_file_name, "#{action}.rb")
+        end
+      end
+
+      def add_routes
+        return if actions.empty?
+        lines = actions.map { |a| "  get \"#{plural_file_name}/#{a}\", to: \"#{plural_file_name}##{a}\"" }
+        route lines.join("\n")
+      end
+
+      private
+
+      def plural_file_name
+        file_name.pluralize
+      end
+
+      def controller_class_name
+        plural_file_name.camelize
+      end
+
+      def module_name
+        plural_file_name.camelize
+      end
+
+      def current_action
+        @current_action
+      end
+
+      def use_case_symbol(action)
+        "#{plural_file_name}_#{action}"
+      end
+    end
+  end
+end

data/lib/generators/rage_arch/job_generator.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module RageArch
+  module Generators
+    class JobGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      argument :use_case_symbol, type: :string, required: false, default: nil, banner: "use_case_symbol"
+
+      desc "Generate an ActiveJob that runs a RageArch use case by symbol."
+      def create_job
+        template "job/job.rb.tt", File.join("app/jobs", "#{file_name}_job.rb")
+      end
+
+      private
+
+      def job_class_name
+        file_name.camelize
+      end
+
+      def inferred_symbol
+        use_case_symbol || file_name
+      end
+    end
+  end
+end

data/lib/generators/rage_arch/mailer_generator.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+
+module RageArch
+  module Generators
+    class MailerGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      argument :actions, type: :array, default: [], banner: "action action"
+
+      desc "Generate a Rails mailer and a RageArch dep wrapper (auto-registered from app/deps/)."
+      def create_rails_mailer
+        args = [name] + actions
+        invoke "mailer", args
+      end
+
+      def create_dep
+        dep_dir = File.join("app/deps")
+        template "mailer/mailer_dep.rb.tt", File.join(dep_dir, "#{dep_file_name}.rb")
+      end
+
+      private
+
+      def mailer_class_name
+        name.camelize
+      end
+
+      def dep_class_name
+        "#{mailer_class_name}Dep"
+      end
+
+      def dep_file_name
+        "#{file_name}_dep"
+      end
+
+      def dep_symbol
+        file_name.underscore
+      end
+    end
+  end
+end

data/lib/generators/rage_arch/resource_generator.rb

@@ -0,0 +1,110 @@
+# frozen_string_literal: true
+
+require "rails/generators/base"
+require "rails/generators/active_record"
+
+module RageArch
+  module Generators
+    class ResourceGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      argument :attributes, type: :array, default: [], banner: "field:type field:type"
+      class_option :skip_model, type: :boolean, default: false, desc: "Skip model and migration (use when model already exists)"
+
+      desc "Generate a RageArch resource: model, migration, CRUD use cases, dep, API-style controller, and routes (no views)."
+      def create_all
+        create_model_and_migration
+        create_use_cases
+        create_dep
+        create_controller
+        add_route
+      end
+
+      private
+
+      def create_model_and_migration
+        return if options[:skip_model]
+        args = [name] + attributes.map(&:to_s)
+        invoke "active_record:model", args
+      end
+
+      def create_use_cases
+        dir = File.join("app/use_cases", plural_name)
+        empty_directory dir
+        template "scaffold/list.rb.tt",    File.join(dir, "list.rb")
+        template "scaffold/show.rb.tt",    File.join(dir, "show.rb")
+        template "scaffold/new.rb.tt",     File.join(dir, "new.rb")
+        template "scaffold/create.rb.tt",  File.join(dir, "create.rb")
+        template "scaffold/update.rb.tt",  File.join(dir, "update.rb")
+        template "scaffold/destroy.rb.tt", File.join(dir, "destroy.rb")
+      end
+
+      def create_dep
+        dep_dir = File.join("app/deps", plural_name)
+        empty_directory dep_dir
+        template "scaffold/post_repo.rb.tt", File.join(dep_dir, "#{singular_name}_repo.rb")
+      end
+
+      def create_controller
+        template "scaffold/api_controller.rb.tt", File.join("app/controllers", "#{plural_name}_controller.rb")
+      end
+
+      def add_route
+        route "resources :#{plural_name}"
+      end
+
+      def plural_name
+        name.underscore.pluralize
+      end
+
+      def singular_name
+        name.underscore
+      end
+
+      def model_class_name
+        name.camelize
+      end
+
+      def module_name
+        plural_name.camelize
+      end
+
+      def repo_symbol
+        "#{singular_name}_repo"
+      end
+
+      def repo_class_name
+        "#{module_name}::#{singular_name.camelize}Repo"
+      end
+
+      def list_symbol
+        "#{plural_name}_list"
+      end
+
+      def show_symbol
+        "#{plural_name}_show"
+      end
+
+      def create_symbol
+        "#{plural_name}_create"
+      end
+
+      def update_symbol
+        "#{plural_name}_update"
+      end
+
+      def destroy_symbol
+        "#{plural_name}_destroy"
+      end
+
+      def new_symbol
+        "#{plural_name}_new"
+      end
+
+      def attribute_names_for_permit
+        return [] if attributes.blank?
+        attributes.map { |a| a.to_s.split(":").first.to_sym }
+      end
+    end
+  end
+end

data/lib/generators/rage_arch/templates/controller/action_use_case.rb.tt

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module <%= module_name %>
+  class <%= current_action.camelize %> < RageArch::UseCase::Base
+    # deps :example_repo
+
+    def call(params = {})
+      # TODO: implement use case logic
+      success(params)
+    end
+  end
+end

data/lib/generators/rage_arch/templates/controller/controller.rb.tt

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+class <%= controller_class_name %>Controller < ApplicationController
+<%- actions.each do |action| -%>
+  def <%= action %>
+    run :<%= use_case_symbol(action) %>,
+      success: ->(r) { render :<%= action %> },
+      failure: ->(r) { flash_errors(r); redirect_to root_path }
+  end
+
+<%- end -%>
+end

data/lib/generators/rage_arch/templates/job/job.rb.tt

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+class <%= job_class_name %>Job < ApplicationJob
+  queue_as :default
+
+  def perform(**params)
+    result = RageArch::UseCase::Base.build(:<%= inferred_symbol %>).call(params)
+
+    unless result.success?
+      Rails.logger.error "[<%= job_class_name %>Job] Use case :<%= inferred_symbol %> failed: #{result.errors.inspect}"
+    end
+
+    result
+  end
+end

data/lib/generators/rage_arch/templates/mailer/mailer_dep.rb.tt

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+# Dep for :<%= dep_symbol %>. Wraps <%= mailer_class_name %>.
+# Auto-registered by convention from app/deps/
+class <%= dep_class_name %>
+<%- actions.each do |action| -%>
+  def <%= action %>(*args)
+    <%= mailer_class_name %>.<%=action %>(*args).deliver_later
+  end
+
+<%- end -%>
+<%- if actions.empty? -%>
+  # def send_email(*args)
+  #   <%= mailer_class_name %>.send_email(*args).deliver_later
+  # end
+<%- end -%>
+end

data/lib/rage_arch/{auto_registrar.rb → auto_registry.rb}

@@ -5,7 +5,7 @@ module RageArch
   # Use cases: subclasses of RageArch::UseCase::Base → registered by inferred symbol.
   # Deps: classes under app/deps/ → registered by inferred symbol.
   # AR auto-resolution: deps ending in _store with no file in app/deps/ → resolves AR model.
-  class AutoRegistrar
+  class AutoRegistry
     class << self
       def run
         register_use_cases
@@ -23,7 +23,7 @@ module RageArch
 
         # Ensure all subclasses have their symbol inferred and registered
         RageArch::UseCase::Base.descendants.each do |klass|
-          next if klass.name.nil? # anonymous classes
+          next if safe_class_name(klass).nil?
           klass.use_case_symbol # triggers inference + registration if not already set
         end
       end
@@ -38,34 +38,57 @@ module RageArch
           require file
         end
 
-        # Register any class defined under app/deps/ that isn't already registered
+        # Register any class defined under app/deps/ that isn't already registered.
+        # Some gems (e.g. Faker) redefine .name with required keyword args,
+        # so we use safe_class_name to avoid ArgumentError on iteration.
         ObjectSpace.each_object(Class).select do |klass|
-          next unless klass.name
-          next if klass.name.start_with?("RageArch::")
+          klass_name = safe_class_name(klass)
+          next unless klass_name
+          next if klass_name.start_with?("RageArch::")
 
           # Check if this class was loaded from app/deps/
           source_file = begin
-            Object.const_source_location(klass.name)&.first
-          rescue
+            Object.const_source_location(klass_name)&.first
+          rescue StandardError
             nil
           end
           next unless source_file && source_file.start_with?(deps_dir.to_s)
 
-          sym = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(klass.name)).to_sym
+          sym = ActiveSupport::Inflector.underscore(ActiveSupport::Inflector.demodulize(klass_name)).to_sym
           unless Container.registered?(sym)
-            Container.register(sym, klass.new)
+            begin
+              Container.register(sym, klass.new)
+            rescue LoadError, StandardError
+              # Skip deps that fail to instantiate (e.g. missing gem dependencies).
+            end
           end
         end
       end
 
+      # Safely retrieve a class name. Some gems (e.g. Faker::Travel::Airport)
+      # redefine .name with required keyword arguments, which raises ArgumentError
+      # when called without them. Returns nil if the name cannot be retrieved.
+      def safe_class_name(klass)
+        klass.name
+      rescue ArgumentError, NoMethodError
+        nil
+      end
+
       def resolve_store_deps
-        # For each use case, check declared deps ending in _store
+        # For each use case, check declared deps ending in _store or _repo
         RageArch::UseCase::Base.registry.each_value do |klass|
           klass.declared_deps.each do |dep_sym|
             next if Container.registered?(dep_sym)
-            next unless dep_sym.to_s.end_with?("_store")
 
-            model_name = dep_sym.to_s.sub(/_store\z/, "").camelize
+            dep_str = dep_sym.to_s
+            suffix = if dep_str.end_with?("_store")
+              "_store"
+            elsif dep_str.end_with?("_repo")
+              "_repo"
+            end
+            next unless suffix
+
+            model_name = dep_str.sub(/#{suffix}\z/, "").camelize
             model_class = begin
               model_name.constantize
             rescue NameError

data/lib/rage_arch/patches/middleware_stack.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+# Ruby 4.0+ freezes array literals by default. ActionPack's MiddlewareStack#build
+# calls `middlewares.freeze` which permanently freezes the internal array,
+# preventing later initializers (e.g. Propshaft) from inserting middleware.
+#
+# This patch makes `build` freeze a dup instead of the original array.
+if RUBY_VERSION >= '4.0'
+  require 'action_dispatch/middleware/stack'
+
+  ActionDispatch::MiddlewareStack.prepend(Module.new do
+    def build(app = nil, &block)
+      duped = middlewares.dup
+      duped.freeze.reverse.inject(app || block) do |a, e|
+        e.build(a)
+      end
+    end
+  end)
+end

data/lib/rage_arch/railtie.rb

@@ -2,6 +2,7 @@
 
 require "rage_arch"
 require_relative "controller"
+require_relative "patches/middleware_stack"
 
 module RageArch
   class Railtie < ::Rails::Railtie
@@ -21,7 +22,7 @@ module RageArch
       end
 
       # Auto-register use cases and deps by convention.
-      RageArch::AutoRegistrar.run
+      RageArch::AutoRegistry.run
     end
   end
 end

data/lib/rage_arch/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RageArch
-  VERSION = "0.2.0"
+  VERSION = "0.2.2"
 end

data/lib/rage_arch.rb

@@ -8,7 +8,7 @@ require_relative "rage_arch/event_publisher"
 require_relative "rage_arch/use_case"
 require_relative "rage_arch/deps/active_record"
 require_relative "rage_arch/dep_scanner"
-require_relative "rage_arch/auto_registrar"
+require_relative "rage_arch/auto_registry"
 
 module RageArch
   class << self
@@ -68,7 +68,7 @@ module RageArch
         klass.declared_deps.uniq.each do |dep_sym|
           unless Container.registered?(dep_sym)
             # 6b. AR model not found for _store dep
-            if dep_sym.to_s.end_with?("_store")
+            if dep_sym.to_s.end_with?("_store") || dep_sym.to_s.end_with?("_repo")
               errors << "  UseCase :#{uc_symbol} (#{klass}) declares dep :#{dep_sym} — not registered in container and no AR model found"
             else
               errors << "  UseCase :#{uc_symbol} (#{klass}) declares dep :#{dep_sym} — not registered in container"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rage_arch
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.2
 platform: ruby
 authors:
 - Rage Corp
@@ -77,11 +77,19 @@ extra_rdoc_files: []
 files:
 - LICENSE
 - README.md
+- lib/generators/rage_arch/controller_generator.rb
 - lib/generators/rage_arch/dep_generator.rb
 - lib/generators/rage_arch/dep_switch_generator.rb
 - lib/generators/rage_arch/install_generator.rb
+- lib/generators/rage_arch/job_generator.rb
+- lib/generators/rage_arch/mailer_generator.rb
+- lib/generators/rage_arch/resource_generator.rb
 - lib/generators/rage_arch/scaffold_generator.rb
+- lib/generators/rage_arch/templates/controller/action_use_case.rb.tt
+- lib/generators/rage_arch/templates/controller/controller.rb.tt
 - lib/generators/rage_arch/templates/dep.rb.tt
+- lib/generators/rage_arch/templates/job/job.rb.tt
+- lib/generators/rage_arch/templates/mailer/mailer_dep.rb.tt
 - lib/generators/rage_arch/templates/rage_arch.rb.tt
 - lib/generators/rage_arch/templates/scaffold/api_controller.rb.tt
 - lib/generators/rage_arch/templates/scaffold/controller.rb.tt
@@ -95,7 +103,7 @@ files:
 - lib/generators/rage_arch/templates/use_case.rb.tt
 - lib/generators/rage_arch/use_case_generator.rb
 - lib/rage_arch.rb
-- lib/rage_arch/auto_registrar.rb
+- lib/rage_arch/auto_registry.rb
 - lib/rage_arch/container.rb
 - lib/rage_arch/controller.rb
 - lib/rage_arch/dep.rb
@@ -103,6 +111,7 @@ files:
 - lib/rage_arch/deps/active_record.rb
 - lib/rage_arch/event_publisher.rb
 - lib/rage_arch/fake_event_publisher.rb
+- lib/rage_arch/patches/middleware_stack.rb
 - lib/rage_arch/railtie.rb
 - lib/rage_arch/result.rb
 - lib/rage_arch/rspec_helpers.rb