rails_settlement 1.1.0 → 1.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c6cd260f7d833858f657cf7975bc54f27d9b96ac4683ceae6600b0ee404e5799
-  data.tar.gz: 62504498246549f0742944144059d1a9bff5687f6a0f775a4ff80bb1a75c3440
+  metadata.gz: 8a6695df770d40dfaff82ecab8bc78d0c8094be1c1bb5396a3065627394d3b2a
+  data.tar.gz: 816e133bd3c262c8ca33f77b1d2629e11f3980a14a903111b93d22fb1c7d8f66
 SHA512:
-  metadata.gz: 814545781be4df3a5e653ada67eef58ba81264f67bcfc1bab8591c19f4336e3f46051346dab13e9d7e34b6a0d81da75a1441359a67aa66e331193bcd185426f3
-  data.tar.gz: f014d90ed48da27180bf93760dfe0483e300b79974059e3cced620d26932d22195b7661f7b17516b1519ab239e5c0d958cc55755df55ffbfb50fe49e00cd6fcd
+  metadata.gz: 0524dceb140d2e07286d2cac1adfde6d4c24a1b4f10b9103cd0509b0475551e263e14e2deb51c530961f8c5092ff06469723373eb1f391aaaaa862a26bbe311c
+  data.tar.gz: 2ffc3f8ddacc5ce63232670febdb4223f968760ce9da686c20553fd6cfc9b75150b7d2c9cbfffafe2cf865f4745b6a238a61c17ea70343d09085943bbca776a4

data/.rubocop.yml

@@ -10,7 +10,7 @@ Style/StringLiteralsInInterpolation:
   EnforcedStyle: double_quotes
 
 Layout/LineLength:
-  Max: 130
+  Max: 150
 
 Metrics/AbcSize:
   Max: 22

data/README.md

@@ -9,34 +9,44 @@ Add to your Gemfile:
 gem 'rails_settlement'
 ```
 
-## How to User
+## How to Use
 
-Let's suppose you want to fetch a `User` before performing a controller action:
+Suppose you need to fetch a User before executing a controller action:
 
 ```ruby
 class UsersController < ApplicationController
-  set_user only: %i[show] # Internally, it's just a before_action callback, so you can pass options to the callback directly.
-  set_user! only: %i[edit] # Using this method with a bang (!) would trigger an ActiveRecord::RecordNotFound Exception.
+  set_user only: %i[show] # It's essentially a before_action callback, allowing you to pass options directly.
+
+  # Using the bang (!) with this method triggers an ActiveRecord::RecordNotFound Exception.
+  set_user! only: %i[edit]
+
+  # You can also define a scope with the `scope_to` option. It can be either a string/symbol or an Array of string/symbols.
+  # This fetches the user after chaining all the scopes together.
+  # set_user scope_to: :is_active, only: %i[show] #=> User.is_active.find_by
+  # set_user! scope_to: %i[is_active is_admin] #=> User.is_active.is_admin.find_by
 
   def show
-    do_something with: user # You will also have an attribute reader with the same name available if the object is found. If not, it'll default to nil (unless a bang method is used, in which case an error is raised!)
+    do_something with: user # You also have an attribute reader with the same name available if the object is found. If not, it defaults to nil (unless a bang method is used, in which case an error is raised!)
   end
 end
 ```
 
 ```ruby
 class User < ApplicationRecord
-  # This method would be used internally by set_user to fetch correct param (using params_key), and to send a key to #find_by (using model_key)
-  # This can be also overridden on the fly by passing any of these two keys (or both!) in the controller directly
+  scope :is_active, -> { where(is_active: true) }
+
+  # This method is used internally by `set_user` to fetch the correct param (using `params_key`) and to send a key to `find_by` (using `model_key`).
+  # You can override this on the fly by passing any of these two keys (or both!) in the controller directly.
   # Ex: set_user params_key: :user_username, only: %i[index], ...
+  # You can also pass a `scope_to` option in the hash below.
   def self.settable_params
     { params_key: :username, model_key: :username }
   end
 end
 ```
 
-This way you can use any model instead of a `User`. Just follow the naming convention `set_[model_name_in_snake_case]!`.
+This approach allows you to use any model instead of a `User`. Just follow the naming convention set_[model_name_in_snake_case]!.
 
-P.S: This should not work with STI or any Namespaced models. If you have a way to make them work, please raise a pull request!
+Note: This implementation does not support STI or any Namespaced models. If you have a solution to make them work, please submit a pull request!
 
 That's about it!

data/lib/rails_settlement/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsSettlement
-  VERSION = "1.1.0"
+  VERSION = "1.3.0"
 end

data/lib/rails_settlement.rb

@@ -10,19 +10,17 @@ module RailsSettlement
 
   SETTABLE_REGEX = /\Aset_(?<object>[a-z_]+)(?<raisable>!?)\z/.freeze
 
-  class_methods do
+  class_methods do # rubocop:disable Metrics/BlockLength
     def method_missing(method, **options)
-      super unless (match_data = method.to_s.match(SETTABLE_REGEX))
+      super unless (matches = method.to_s.match(SETTABLE_REGEX))
 
-      variable = match_data[:object]
-      raisable = match_data[:raisable].present?
-
-      klass = variable.classify.constantize
-
-      param_options = (klass.try(:settable_params) || {}).merge(options.extract!(:model_key, :params_key))
+      variable, raisable = _handle_match_data(matches)
+      klass = _klass(variable, **options.extract!(:namespace))
+      param_options = _param_options(klass: klass, options: options)
+      scoped_klass = _handle_scopes(klass: klass, scopes: param_options[:scope_to])
 
       before_action(**options) do
-        instance_variable_set("@#{variable}", klass.find_by(param_options[:model_key] => params[param_options[:params_key]]))
+        instance_variable_set("@#{variable}", scoped_klass.find_by(param_options[:model_key] => params[param_options[:params_key]]))
         raise ActiveRecord::RecordNotFound if raisable && instance_variable_get("@#{variable}").nil?
       end
 
@@ -32,6 +30,31 @@ module RailsSettlement
     def respond_to_missing?(method, include_private = false)
       super || method.to_s.match?(SETTABLE_REGEX)
     end
+
+    private
+
+    def _handle_match_data(match_data)
+      [match_data[:object], match_data[:raisable].present?]
+    end
+
+    def _klass(variable, namespace: nil)
+      variable = variable.classify
+      variable = "#{namespace.to_s.classify}::#{variable}" if namespace.present?
+      variable.constantize
+    end
+
+    def _param_options(klass:, options:)
+      (klass.try(:settable_params) || {}).merge(options.extract!(:model_key, :params_key, :scope_to))
+    end
+
+    def _handle_scopes(klass:, scopes:)
+      return klass if scopes.blank?
+
+      scopes = [scopes] unless scopes.is_a?(Array)
+      scopes.each { |scope| klass = klass.public_send(scope) }
+
+      klass
+    end
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rails_settlement
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.3.0
 platform: ruby
 authors:
 - Tejas
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2024-02-10 00:00:00.000000000 Z
+date: 2024-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activerecord