rage_arch 0.1.0

data/lib/rage_arch.rb

@@ -0,0 +1,97 @@
+# frozen_string_literal: true
+
+require_relative "rage_arch/version"
+require_relative "rage_arch/result"
+require_relative "rage_arch/container"
+require_relative "rage_arch/dep"
+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"
+
+module RageArch
+  class << self
+    def register(symbol, implementation = nil, &block)
+      Container.register(symbol, implementation, &block)
+    end
+
+    # Registers a dep that uses Active Record for the given model.
+    # Example: Rage.register_ar(:user_store, User)
+    def register_ar(symbol, model_class)
+      register(symbol, Deps::ActiveRecord.for(model_class))
+    end
+
+    def resolve(symbol)
+      Container.resolve(symbol)
+    end
+
+    def registered?(symbol)
+      Container.registered?(symbol)
+    end
+
+    # Verifies that all deps and use_cases declared by registered use cases are
+    # available before the app handles any request. Call after all initializers run
+    # (done automatically by the Railtie unless config.rage.verify_deps = false).
+    #
+    # Raises RuntimeError listing every missing dep/use_case if any are absent.
+    # Returns true when everything is wired correctly.
+    def verify_deps!
+      errors = []
+      scanned_methods = DepScanner.new.scan
+
+      UseCase::Base.registry.each do |uc_symbol, klass|
+        klass.declared_deps.uniq.each do |dep_sym|
+          next if klass.ar_deps.key?(dep_sym) # ar_deps fall back to ActiveRecord, optional
+
+          unless Container.registered?(dep_sym)
+            errors << "  UseCase :#{uc_symbol} (#{klass}) declares dep :#{dep_sym} — not registered in container"
+            next
+          end
+
+          required_methods = scanned_methods[dep_sym]
+          next if required_methods.nil? || required_methods.empty?
+
+          entry = Container.registry[dep_sym]
+          impl =
+            if entry.is_a?(Class)
+              entry
+            elsif entry.is_a?(Proc)
+              nil # skip: calling a Proc may have side effects
+            else
+              entry
+            end
+
+          next if impl.nil?
+
+          impl_name = impl.is_a?(Class) ? impl.name : impl.class.name
+
+          required_methods.each do |method_name|
+            has_method =
+              if impl.is_a?(Class)
+                impl.method_defined?(method_name) || impl.respond_to?(method_name)
+              else
+                impl.respond_to?(method_name)
+              end
+
+            unless has_method
+              errors << "  UseCase :#{uc_symbol} (#{klass}) calls dep :#{dep_sym}##{method_name} — #{impl_name} does not implement ##{method_name}"
+            end
+          end
+        end
+
+        klass.declared_use_cases.uniq.each do |ref_sym|
+          next if UseCase::Base.registry.key?(ref_sym)
+
+          errors << "  UseCase :#{uc_symbol} (#{klass}) declares use_cases :#{ref_sym} — not registered in use case registry"
+        end
+      end
+
+      raise "RageArch boot verification failed:\n#{errors.join("\n")}" if errors.any?
+
+      true
+    end
+  end
+end
+
+require_relative "rage_arch/controller" if defined?(Rails)
+require "rage_arch/railtie" if defined?(Rails)

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification
+name: rage_arch
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Rage Corp
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.2'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Gem to structure Rails apps with use cases, dependencies injectable by
+  symbol, and Result object (success/failure). Includes container, use case base,
+  and rails g rage_arch:use_case generator.
+email:
+- ''
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.md
+- lib/generators/rage_arch/ar_dep_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/scaffold_generator.rb
+- lib/generators/rage_arch/templates/ar_dep.rb.tt
+- lib/generators/rage_arch/templates/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
+- lib/generators/rage_arch/templates/scaffold/create.rb.tt
+- lib/generators/rage_arch/templates/scaffold/destroy.rb.tt
+- lib/generators/rage_arch/templates/scaffold/list.rb.tt
+- lib/generators/rage_arch/templates/scaffold/new.rb.tt
+- lib/generators/rage_arch/templates/scaffold/post_repo.rb.tt
+- lib/generators/rage_arch/templates/scaffold/show.rb.tt
+- lib/generators/rage_arch/templates/scaffold/update.rb.tt
+- lib/generators/rage_arch/templates/use_case.rb.tt
+- lib/generators/rage_arch/use_case_generator.rb
+- lib/rage_arch.rb
+- lib/rage_arch/container.rb
+- lib/rage_arch/controller.rb
+- lib/rage_arch/dep.rb
+- lib/rage_arch/dep_scanner.rb
+- lib/rage_arch/deps/active_record.rb
+- lib/rage_arch/event_publisher.rb
+- lib/rage_arch/fake_event_publisher.rb
+- lib/rage_arch/railtie.rb
+- lib/rage_arch/result.rb
+- lib/rage_arch/rspec_matchers.rb
+- lib/rage_arch/use_case.rb
+- lib/rage_arch/version.rb
+homepage: https://github.com/rage-corp/rage_arch
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rage-corp/rage_arch
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: 'Clean Architecture Light for Rails: use cases, injectable deps, Result.'
+test_files: []