azeroth 2.0.0 → 2.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65ba326980d7b37bb878cf1f230dea518561a68fdc337e53b9ca6391766957f3
-  data.tar.gz: 6f39fcee3056ad4eccbc72d1fc268460144bf3ec442cc4292f31a3bbf98f77b4
+  metadata.gz: bffbd5680be44e59335195e606064c1c4861c30eebdf5a94063b97b6831b564d
+  data.tar.gz: 112ffcf30bfcd30f58ff24c8bd8b28a29d82e3708335f462192b3d8b1bc20854
 SHA512:
-  metadata.gz: 10907b167920b813c0de6aa9a77dad7366cf8a16179a4179c6343ab4544d9b86560ed812a2d897aaf702d4d556b3d77d45de2a03b00a47e34368488230ef2cf7
-  data.tar.gz: 805c0ea2d52a06e1c2472ba390d973fcf0b06e3ae16fcf03cde5cae97a70b0b25072aff1f7295a42cbcfd4c228a62e32481e126bbc9191394f2031d1df5b7482
+  metadata.gz: 44dacff749a10df31d63b6a51f2f9769030ff3b9addceb537839db3c98dac51885cbcea229992ebcb68e024dd1012ebe9a3d94f158ba587e562802e26c98a570
+  data.tar.gz: ae2263e16bc69ed18bf8690c4e938b4622dab9e645d20458cee4d6afb2529531726c54e582249d265d79fc551d51af096e9b08b41fb304d3578227c66eba4492

data/.gitignore

@@ -12,3 +12,5 @@ spec/dummy/log/*
 spec/dummy/tmp/*
 spec/dummy/db/*.sqlite3
 spec/dummy/db/*.sqlite3-journal
+spec/dummy/db/*.sqlite3-shm
+spec/dummy/db/*.sqlite3-wal

data/.rubocop.yml

@@ -13,7 +13,7 @@ Metrics/BlockLength:
     - 'azeroth.gemspec'
 
 RSpec/NestedGroups:
-  Max: 4
+  Max: 5
 
 RSpec/AlignLeftLetBrace:
   Enabled: true

data/README.md

@@ -11,7 +11,7 @@ Azeroth
 
 Yard Documentation
 -------------------
-[https://www.rubydoc.info/gems/azeroth/2.0.0](https://www.rubydoc.info/gems/azeroth/2.0.0)
+[https://www.rubydoc.info/gems/azeroth/2.1.1](https://www.rubydoc.info/gems/azeroth/2.1.1)
 
 Azeroth has been designed making the coding of controllers easier
 as routes in controllers are usually copy, paste and replace of same
@@ -25,9 +25,9 @@ does not perform database operations
 Future versions will enable `html` rendering to also perform
 database operations.
 
-Current Release: [2.0.0](https://github.com/darthjee/azeroth/tree/2.0.0)
+Current Release: [2.1.1](https://github.com/darthjee/azeroth/tree/2.1.1)
 
-[Next release](https://github.com/darthjee/azeroth/compare/2.0.0...master)
+[Next release](https://github.com/darthjee/azeroth/compare/2.1.1...master)
 
 Installation
 ---------------
@@ -54,10 +54,14 @@ Usage
 ## Azeroth::Resourceable
 
 [Resourceable](https://www.rubydoc.info/gems/azeroth/Azeroth/Resourceable)
-module adds class method [resource_for](https://www.rubydoc.info/gems/azeroth/Azeroth/Resourceable/ClassMethods#resource_for-instance_method)
+module adds class methods
+[resource_for](https://www.rubydoc.info/gems/azeroth/Azeroth/Resourceable/ClassMethods#resource_for-instance_method)
 which adds a resource and action methods for `create`, `show`, `index`,
 `update`, `delete`, `edit`
+and
+[model_for](https://www.rubydoc.info/gems/azeroth/Azeroth/Resourceable/ClassMethods#model_for-instance_method)
 
+### #resource_for
 It accepts options
 - only: List of actions to be built
 - except: List of actions to not to be built
@@ -68,6 +72,8 @@ It accepts options
 - update_with: Method/Block to be ran when updating the reource on update
 - paginated: Flag when pagination should be applied
 - per_page: Number of items returned when pagination is active
+- id_key: key used to find a model. id by default
+- param_key: parameter key used to find the model
 
 ```ruby
   # publishers_controller.rb
@@ -165,6 +171,11 @@ It accepts options
   # }
 ```
 
+### #model_for
+It accepts options
+- id_key: key used to find a model. id by default
+- param_key: parameter key used to find the model
+
 ## Azeroth::Decorator
 
 [Decorators](https://www.rubydoc.info/gems/azeroth/Azeroth/Decorator) are

data/lib/azeroth/controller_interface.rb

@@ -75,8 +75,6 @@ module Azeroth
     #
     # @param method_name [Symbol] name of the method
     #   called
-    # @param args [Array<Object>] arguments of the
-    #   method called
     #
     # @return [Object]
     def method_missing(method_name, *)

data/lib/azeroth/decorator.rb

@@ -94,8 +94,6 @@ module Azeroth
     # When object is an iterator, decoration is applied to each
     # and an array is returned
     #
-    # @param args [Hash] options (to be implemented)
-    #
     # @return [Hash]
     def as_json(*)
       return nil if object.nil?
@@ -146,8 +144,6 @@ module Azeroth
     #
     # @param method_name [Symbol] name of the method
     #   called
-    # @param args [Array<Object>] arguments of the
-    #   method called
     #
     # @return [Object]
     def method_missing(method_name, *)

data/lib/azeroth/options.rb

@@ -17,6 +17,8 @@ module Azeroth
     DEFAULT_OPTIONS = {
       only: %i[create destroy edit index new show update],
       except: [],
+      id_key: :id,
+      param_key: :id,
       decorator: true,
       before_save: nil,
       after_save: nil,
@@ -65,6 +67,20 @@ module Azeroth
     #
     # @return [Array<String,Symbol>]
 
+    # @method id_key
+    # @api private
+    #
+    # key used to find a model. id by default
+    #
+    # @return [Symbol]
+
+    # @method param_key
+    # @api private
+    #
+    # parameter key used to find the model
+    #
+    # @return [Symbol]
+
     # @method decorator
     # @api private
     #

data/lib/azeroth/params_builder.rb

@@ -6,14 +6,15 @@ module Azeroth
   #
   # Class responsible for adding params handling methods to a controller
   class ParamsBuilder < Sinclair::Model
-    # @!method initialize(model:, builder:)
+    # @!method initialize(model:, builder:, options:)
     #   @api private
     #
     #   @param model [Model] Resource interface
     #   @param builder [Sinclair] Methods builder
+    #   @param options [Azeroth::Options] options
     #
     #   @return [ParamsBuilder]
-    initialize_with(:model, :builder, writter: false)
+    initialize_with(:model, :builder, :options, writter: false)
 
     # Append the params methods to be built
     #
@@ -22,7 +23,8 @@ module Azeroth
       method_name = name
       allowed_attributes = permitted_attributes.map(&:to_sym)
 
-      add_method("#{name}_id") { params.require(:id) }
+      param_key = options.param_key
+      add_method("#{name}_id") { params.require(param_key) }
       add_method("#{name}_params") do
         params.require(method_name)
               .permit(*allowed_attributes)
@@ -47,6 +49,14 @@ module Azeroth
     #
     # @return [Sinclair]
 
+    # @method options
+    # @api private
+    # @private
+    #
+    # Methods builder
+    #
+    # @return [Azeroth::Options]
+
     delegate :add_method, to: :builder
     # @method add_method
     # @api private

data/lib/azeroth/resource_builder.rb

@@ -10,14 +10,15 @@ module Azeroth
   # entries of a resource, and one for fetching an specific
   # entry
   class ResourceBuilder < Sinclair::Model
-    # @!method initialize(model:, builder:)
+    # @!method initialize(model:, builder:, options:)
     #   @api private
     #
     #   @param model [Model] Resource model interface
     #   @param builder [Sinclair] method builder
+    #   @param options [Azeroth::Options] options
     #
     #   @return [ResourceBuilder]
-    initialize_with(:model, :builder, writter: false)
+    initialize_with(:model, :builder, :options, writter: false)
 
     # Append methods to be built to the builder
     #
@@ -27,7 +28,10 @@ module Azeroth
     # @return [Array<Sinclair::MethodDefinition>]
     def append
       add_method(plural, "@#{plural} ||= #{model.klass}.all")
-      add_method(name, "@#{name} ||= #{plural}.find(#{name}_id)")
+      add_method(
+        name,
+        "@#{name} ||= #{plural}.find_by!(#{id_key}: #{name}_id)"
+      )
     end
 
     # @method model
@@ -70,5 +74,13 @@ module Azeroth
     # Return the pluralized version of resource name
     #
     # @return [String]
+
+    delegate :id_key, to: :options
+    # @method plural
+    # @api private
+    #
+    # key used to find a model. id by default
+    #
+    # @return [Symbol]
   end
 end

data/lib/azeroth/resourceable/class_methods.rb

@@ -7,7 +7,7 @@ module Azeroth
     #
     # Class methods added by {Resourceable}
     module ClassMethods
-      # Adds resource methods for resource
+      # Adds resource and routes methods for resource
       #
       # @param (see Resourceable.resource_for)
       # @option (see Resourceable.resource_for)
@@ -16,7 +16,20 @@ module Azeroth
       # @see (see Resourceable.resource_for)
       # @example (see Resourceable.resource_for)
       def resource_for(name, **options)
-        Builder.new(
+        EndpointsBuilder.new(
+          self, name, Azeroth::Options.new(options)
+        ).build
+      end
+
+      # Adds resource methods for resource
+      #
+      # @param (see Resourceable.model_for)
+      # @return (see Resourceable.model_for)
+      #
+      # @see (see Resourceable.model_for)
+      # @example (see Resourceable.model_for)
+      def model_for(name, **options)
+        ResourcesBuilder.new(
           self, name, Azeroth::Options.new(options)
         ).build
       end

data/lib/azeroth/resourceable/endpoints_builder.rb

@@ -0,0 +1,104 @@
+# frozen_string_literal: true
+
+require 'sinclair'
+
+module Azeroth
+  module Resourceable
+    # @api private
+    # Builder responsible to add all methods to the controller
+    #
+    # Builder uses other builders to put together it's methods
+    #
+    # @see ResourceBuilder
+    # @see ResourceRouteBuilder
+    # @see RoutesBuilder
+    class EndpointsBuilder
+      # @param klass [ActionController::Base] Controller to
+      #   to be changed
+      # @param model_name [Symbol,String]
+      # @param options [Options]
+      def initialize(klass, model_name, options)
+        @klass = klass
+        @options = options
+        @model = Azeroth::Model.new(model_name, options)
+
+        add_routes
+        ResourcesBuilder.new(klass, model_name, options).build
+      end
+
+      private
+
+      attr_reader :klass, :model, :options
+
+      # @method klass
+      # @api private
+      # @private
+      #
+      # Controller to changed
+      #
+      # @return [ActionController::Base]
+
+      # @method model
+      # @api private
+      # @private
+      #
+      # Model interface to resource model
+      #
+      # @return [Model]
+
+      # @method options
+      # @api private
+      # @private
+      #
+      # Options
+      #
+      # @return [Options]
+
+      delegate :build, :add_method, to: :builder
+      # @method build
+      # @api private
+      # @private
+      #
+      # build all the methods
+      #
+      # @return [Array<Sinclair::MethodDefinition>]
+
+      # @method add_method
+      # @api private
+      #
+      # Add method to be built
+      #
+      # @return [Array<Sinclair::MethodDefinition>]
+
+      delegate :name, to: :model
+      # @method name
+      # @api private
+      # @private
+      #
+      # Resource name
+      #
+      # @return [Symbol,String]
+
+      # @api private
+      # @private
+      #
+      # Returns a method builder
+      #
+      # @return [Sinclair]
+      #
+      # @see https://www.rubydoc.info/gems/sinclair Sinclair
+      def builder
+        @builder ||= Sinclair.new(klass)
+      end
+
+      # Add metohods for each route
+      #
+      # @return [Array<Sinclair::MethodDefinition>]
+      def add_routes
+        RoutesBuilder.new(
+          model: model, builder: builder, options: options
+        ).append
+      end
+    end
+  end
+end

data/lib/azeroth/resourceable/{builder.rb → resources_builder.rb}

@@ -5,14 +5,12 @@ require 'sinclair'
 module Azeroth
   module Resourceable
     # @api private
-    # Builder responsible to add all methods to the controller
+    # Builder responsible to add resource / model methods to the controller
     #
-    # Builder uses other builders to put together it's methods
+    # Builder uses {ResourceBuilder} to put together it's methods
     #
     # @see ResourceBuilder
-    # @see ResourceRouteBuilder
-    # @see RoutesBuilder
-    class Builder
+    class ResourcesBuilder
       # @param klass [ActionController::Base] Controller to
       #   to be changed
       # @param model_name [Symbol,String]
@@ -24,7 +22,6 @@ module Azeroth
 
         add_params
         add_resource
-        add_routes
         add_helpers
       end
 
@@ -98,7 +95,7 @@ module Azeroth
       # @return [Array<Sinclair::MethodDefinition>]
       def add_params
         ParamsBuilder.new(
-          model: model, builder: builder
+          model: model, builder: builder, options: options
         ).append
       end
 
@@ -106,16 +103,7 @@ module Azeroth
       #
       # @return [Array<Sinclair::MethodDefinition>]
       def add_resource
-        ResourceBuilder.new(model: model, builder: builder).append
-      end
-
-      # Add metohods for each route
-      #
-      # @return [Array<Sinclair::MethodDefinition>]
-      def add_routes
-        RoutesBuilder.new(
-          model: model, builder: builder, options: options
-        ).append
+        ResourceBuilder.new(model: model, builder: builder, options: options).append
       end
 
       # Add helpers to render objects on template

data/lib/azeroth/resourceable.rb

@@ -16,13 +16,16 @@ module Azeroth
       rescue_from ActiveRecord::RecordNotFound, with: :not_found
     end
 
-    autoload :Builder, 'azeroth/resourceable/builder'
-    autoload :ClassMethods, 'azeroth/resourceable/class_methods'
+    autoload :ClassMethods,     'azeroth/resourceable/class_methods'
+    autoload :EndpointsBuilder, 'azeroth/resourceable/endpoints_builder'
+    autoload :ResourcesBuilder, 'azeroth/resourceable/resources_builder'
 
     class << self
       # @method self.resource_for(name, **options)
       # @api public
       #
+      # Adds resource and routes methods for resource
+      #
       # @param name [String, Symbol] Name of the resource
       # @param options [Hash] resource building options
       # @option options only [Array<Symbol,String>,Symbol,String] List of
@@ -45,6 +48,8 @@ module Azeroth
       #   endpoint should be paginated
       # @option options per_page [Integer] number of entries returned per
       #   page on index
+      # @option options id_key [Symbol] key used to find a model. id by default
+      # @option options param_key [Symbol] parameter key used to find the model
       #
       # @return [Array<MethodDefinition>] list of methods created
       #
@@ -209,6 +214,16 @@ module Azeroth
       #     'per_page' => 20,
       #     'page' => 2
       #   }
+
+      # @method self.model_for(name, **options)
+      # @api public
+      #
+      # Adds resource and routes methods for resource
+      #
+      # @param name [String, Symbol] Name of the resource
+      # @param options [Hash] resource building options
+      # @option options id_key [Symbol] key used to find a model. id by default
+      # @option options param_key [Symbol] parameter key used to find the model
     end
 
     private

data/lib/azeroth/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Azeroth
-  VERSION = '2.0.0'
+  VERSION = '2.1.1'
 end

data/spec/lib/azeroth/params_builder_spec.rb

@@ -4,55 +4,71 @@ require 'spec_helper'
 
 describe Azeroth::ParamsBuilder do
   subject(:params_builder) do
-    described_class.new(model: model, builder: builder)
+    described_class.new(model: model, builder: builder, options: options)
   end
 
-  let(:model)   { Azeroth::Model.new(:document, options) }
-  let(:options) { Azeroth::Options.new }
-  let(:builder) { Sinclair.new(klass) }
-  let(:klass)   { Class.new(ParamsBuilderController) }
+  let(:model)        { Azeroth::Model.new(:document, options) }
+  let(:options)      { Azeroth::Options.new(options_hash) }
+  let(:options_hash) { {} }
+  let(:builder)      { Sinclair.new(klass) }
+  let(:klass)        { Class.new(ParamsBuilderController) }
+  let(:controller)   { klass.new(id, attributes) }
+  let(:attributes)   { document.attributes }
+  let(:document)     { create(:document) }
+  let(:id)           { Random.rand(10..100) }
 
   before do
     params_builder.append
   end
 
   describe '#append' do
-    it 'adds id method' do
-      expect { builder.build }
-        .to add_method(:document_id).to(klass)
-    end
-
-    it 'adds params method' do
-      expect { builder.build }
-        .to add_method(:document_params).to(klass)
-    end
+    context 'when no options are given' do
+      it 'adds id method' do
+        expect { builder.build }
+          .to add_method(:document_id).to(klass)
+      end
 
-    describe 'after the build' do
-      let(:controller) { klass.new(id, attributes) }
-      let(:document)   { create(:document) }
-      let(:attributes) { document.attributes }
-      let(:id)         { Random.rand(10..100) }
-      let(:expected_attributes) do
-        {
-          'name' => document.name,
-          'reference' => document.reference
-        }
+      it 'adds params method' do
+        expect { builder.build }
+          .to add_method(:document_params).to(klass)
       end
 
-      before { builder.build }
+      describe 'after the build' do
+        let(:expected_attributes) do
+          {
+            'name' => document.name,
+            'reference' => document.reference
+          }
+        end
+
+        before { builder.build }
 
-      context 'when requesting id' do
-        it 'returns id from request path' do
-          expect(controller.document_id).to eq(id)
+        context 'when requesting id' do
+          it 'returns id from request path' do
+            expect(controller.document_id).to eq(id)
+          end
         end
-      end
 
-      context 'when requesting params' do
-        it 'returns payload' do
-          expect(controller.document_params.to_h)
-            .to eq(expected_attributes)
+        context 'when requesting params' do
+          it 'returns payload' do
+            expect(controller.document_params.to_h)
+              .to eq(expected_attributes)
+          end
         end
       end
     end
   end
+
+  context 'when no options are given' do
+    let(:options_hash) { { param_key: :document_id } }
+    let(:controller)   { klass.new(id, attributes, param_id: :document_id) }
+
+    before { builder.build }
+
+    context 'when requesting id' do
+      it 'returns id from request path' do
+        expect(controller.document_id).to eq(id)
+      end
+    end
+  end
 end

data/spec/lib/azeroth/resource_builder_spec.rb

@@ -4,13 +4,14 @@ require 'spec_helper'
 
 describe Azeroth::ResourceBuilder do
   subject(:resource_builder) do
-    described_class.new(model: model, builder: builder)
+    described_class.new(model: model, builder: builder, options: options)
   end
 
-  let(:model)   { Azeroth::Model.new(:document, options) }
-  let(:options) { Azeroth::Options.new }
-  let(:builder) { Sinclair.new(klass) }
-  let(:klass)   { Class.new(ResourceBuilderController) }
+  let(:model)        { Azeroth::Model.new(:document, options) }
+  let(:options)      { Azeroth::Options.new(options_hash) }
+  let(:options_hash) { {} }
+  let(:builder)      { Sinclair.new(klass) }
+  let(:klass)        { Class.new(ResourceBuilderController) }
 
   before do
     resource_builder.append
@@ -18,21 +19,44 @@ describe Azeroth::ResourceBuilder do
   end
 
   describe '#append' do
-    it 'adds the listing method' do
-      expect { builder.build }
-        .to change { klass.new.respond_to?(:documents) }
-        .to(true)
-    end
+    context 'when no option is given' do
+      it 'adds the listing method' do
+        expect { builder.build }
+          .to change { klass.new.respond_to?(:documents) }
+          .to(true)
+      end
+
+      it 'adds the fetching method' do
+        expect { builder.build }
+          .to change { klass.new.respond_to?(:document) }
+          .to(true)
+      end
+
+      describe 'after the build' do
+        let(:controller) { klass.new(document_id: document.id) }
+        let(:document)   { create(:document) }
+
+        before { builder.build }
 
-    it 'adds the fetching method' do
-      expect { builder.build }
-        .to change { klass.new.respond_to?(:document) }
-        .to(true)
+        context 'when requesting the list of documents' do
+          it 'returns the list of documents' do
+            expect(controller.documents).to eq(Document.all)
+          end
+        end
+
+        context 'when requesting one document' do
+          it 'returns the requested document' do
+            expect(controller.document).to eq(document)
+          end
+        end
+      end
     end
 
-    describe 'after the build' do
-      let(:controller) { klass.new(document_id: document.id) }
-      let(:document)   { create(:document) }
+    context 'when id_key option is given' do
+      let(:options_hash) { { id_key: :reference } }
+
+      let(:controller) { klass.new(document_id: document.reference) }
+      let(:document)   { create(:document, reference: SecureRandom.hex(20)) }
 
       before { builder.build }
 

data/spec/lib/azeroth/resourceable/endpoints_builder_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Azeroth::Resourceable::EndpointsBuilder do
+  subject(:builder) { described_class.new(klass, :document, options) }
+
+  let(:options)      { Azeroth::Options.new(options_hash) }
+  let(:options_hash) { {} }
+
+  let(:klass) do
+    Class.new(Controller) do
+    end
+  end
+
+  describe '#build' do
+    let(:available_routes) { %i[index show new destroy create update] }
+    let(:expected_params_methods)   { %i[document_id document_params] }
+    let(:expected_routes_methods)   { available_routes }
+    let(:expected_resource_methods) { %i[document documents] }
+
+    context 'when no option is given' do
+      it 'adds params methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & expected_params_methods).sort }
+          .from([]).to(expected_params_methods.sort)
+      end
+
+      it 'adds routes methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
+      end
+
+      it 'adds resource methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & expected_resource_methods).sort }
+          .from([]).to(expected_resource_methods.sort)
+      end
+    end
+
+    context 'when only option is given for a route' do
+      let(:options_hash) { { only: route } }
+      let(:route)                   { available_routes.sample }
+      let(:expected_routes_methods) { [route] }
+
+      it 'adds routes methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
+      end
+    end
+
+    context 'when only option as array is given for a route' do
+      let(:options_hash) { { only: routes } }
+      let(:routes)                  { [available_routes.sample, available_routes.sample].uniq }
+      let(:expected_routes_methods) { routes }
+
+      it 'adds routes methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
+      end
+    end
+
+    context 'when except option is given for a route' do
+      let(:options_hash) { { except: route } }
+      let(:route)                   { available_routes.sample }
+      let(:expected_routes_methods) { available_routes - [route] }
+
+      it 'adds routes methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
+      end
+    end
+
+    context 'when except option as array is given for a route' do
+      let(:options_hash) { { except: routes } }
+      let(:routes)                  { [available_routes.sample, available_routes.sample].uniq }
+      let(:expected_routes_methods) { available_routes - routes }
+
+      it 'adds routes methods' do
+        expect { builder.build }
+          .to change { (klass.instance_methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
+      end
+    end
+  end
+end

data/spec/lib/azeroth/resourceable/resources_builder_spec.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe Azeroth::Resourceable::ResourcesBuilder do
+  subject(:builder) { described_class.new(klass, :document, options) }
+
+  let(:options)      { Azeroth::Options.new(options_hash) }
+  let(:options_hash) { {} }
+
+  let(:klass) do
+    Class.new(Controller) do
+    end
+  end
+
+  describe '#build' do
+    let(:expected_resource_methods) { %i[document documents] }
+    let(:expected_params_methods)   { %i[document_id document_params] }
+
+    it 'adds params methods' do
+      expect { builder.build }
+        .to change { (klass.instance_methods & expected_params_methods).sort }
+        .from([]).to(expected_params_methods.sort)
+    end
+
+    it 'adds resource methods' do
+      expect { builder.build }
+        .to change { (klass.instance_methods & expected_resource_methods).sort }
+        .from([]).to(expected_resource_methods.sort)
+    end
+  end
+end

data/spec/lib/azeroth/resourceable_spec.rb

@@ -10,54 +10,41 @@ describe Azeroth::Resourceable do
   end
 
   describe '.resource_for' do
-    let(:params)     { { id: model.id, format: :json } }
-    let(:model_name) { :document }
-    let(:model)      { create(model_name) }
-    let(:controller) { controller_class.new(params) }
-    let(:decorator)  { Document::Decorator }
+    let(:available_routes) { %i[index show new destroy create update] }
+    let(:params)           { { id: model.id, format: :json } }
+    let(:model_name)       { :document }
+    let(:model)            { create(model_name) }
+    let(:controller)       { controller_class.new(params) }
+    let(:decorator)        { Document::Decorator }
 
     context 'when no special option is given' do
-      %i[index show new edit update destroy].each do |method_name|
-        it do
-          expect { controller_class.resource_for(model_name) }
-            .to add_method(method_name).to(controller_class)
-        end
+      it 'add routes methods' do
+        expect { controller_class.resource_for(model_name) }
+          .to change { (controller.methods & available_routes).sort }
+          .from([]).to(available_routes.sort)
       end
     end
 
     context 'when passing the only option' do
-      let(:options) { { only: %i[index show] } }
-
-      %i[index show].each do |method_name|
-        it do
-          expect { controller_class.resource_for(model_name, **options) }
-            .to add_method(method_name).to(controller_class)
-        end
-      end
+      let(:options) { { only: expected_routes_methods } }
+      let(:expected_routes_methods) { %i[index show] }
 
-      %i[new edit update destroy].each do |method_name|
-        it do
-          expect { controller_class.resource_for(model_name, **options) }
-            .not_to add_method(method_name).to(controller_class)
-        end
+      it 'add routes methods' do
+        expect { controller_class.resource_for(model_name, **options) }
+          .to change { (controller.methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
       end
     end
 
     context 'when passing the except option' do
-      let(:options) { { except: %i[index show] } }
-
-      %i[index show].each do |method_name|
-        it do
-          expect { controller_class.resource_for(model_name, **options) }
-            .not_to add_method(method_name).to(controller_class)
-        end
-      end
-
-      %i[new edit update destroy].each do |method_name|
-        it do
-          expect { controller_class.resource_for(model_name, **options) }
-            .to add_method(method_name).to(controller_class)
-        end
+      let(:options) { { except: skipped_routes } }
+      let(:skipped_routes)          { %i[index show] }
+      let(:expected_routes_methods) { available_routes - skipped_routes }
+
+      it 'add routes methods' do
+        expect { controller_class.resource_for(model_name, **options) }
+          .to change { (controller.methods & available_routes).sort }
+          .from([]).to(expected_routes_methods.sort)
       end
     end
 
@@ -105,4 +92,17 @@ describe Azeroth::Resourceable do
       end
     end
   end
+
+  describe '.model_for' do
+    let(:model_name) { :document }
+    let(:model)                     { create(model_name) }
+    let(:controller)                { controller_class.new({}) }
+    let(:expected_resource_methods) { %i[document documents] }
+
+    it 'adds resource methods' do
+      expect { controller_class.model_for(model_name) }
+        .to change { (controller.methods & expected_resource_methods).sort }
+        .from([]).to(expected_resource_methods.sort)
+    end
+  end
 end

data/spec/support/app/controllers/params_builder_controller.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 class ParamsBuilderController
-  def initialize(id, attributes)
+  def initialize(id, attributes, param_id: :id)
     @params = ActionController::Parameters.new(
-      id: id,
+      param_id => id,
       document: attributes
     )
   end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: azeroth
 version: !ruby/object:Gem::Version
-  version: 2.0.0
+  version: 2.1.1
 platform: ruby
 authors:
 - Darthjee
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-05-09 00:00:00.000000000 Z
+date: 2025-05-16 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -115,8 +115,9 @@ files:
 - lib/azeroth/request_handler/update.rb
 - lib/azeroth/resource_builder.rb
 - lib/azeroth/resourceable.rb
-- lib/azeroth/resourceable/builder.rb
 - lib/azeroth/resourceable/class_methods.rb
+- lib/azeroth/resourceable/endpoints_builder.rb
+- lib/azeroth/resourceable/resources_builder.rb
 - lib/azeroth/routes_builder.rb
 - lib/azeroth/version.rb
 - spec/controllers/documents_controller_spec.rb
@@ -253,7 +254,8 @@ files:
 - spec/lib/azeroth/request_handler/update_spec.rb
 - spec/lib/azeroth/request_handler_spec.rb
 - spec/lib/azeroth/resource_builder_spec.rb
-- spec/lib/azeroth/resourceable/builder_spec.rb
+- spec/lib/azeroth/resourceable/endpoints_builder_spec.rb
+- spec/lib/azeroth/resourceable/resources_builder_spec.rb
 - spec/lib/azeroth/resourceable_spec.rb
 - spec/lib/azeroth/routes_builder_spec.rb
 - spec/spec_helper.rb

data/spec/lib/azeroth/resourceable/builder_spec.rb

@@ -1,19 +0,0 @@
-# frozen_string_literal: true
-
-require 'spec_helper'
-
-describe Azeroth::Resourceable::Builder do
-  subject { described_class.new(klass, :document, options) }
-
-  let(:options)      { Azeroth::Options.new(options_hash) }
-  let(:options_hash) { {} }
-
-  let(:klass) do
-    Class.new(Controller) do
-    end
-  end
-
-  describe '#build' do
-    it 'adds spec'
-  end
-end