role_fu 0.3.3 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4b631da54e6c8f434750a6246d69bb8b7add820b2fc5f4749175572ef1c63154
-  data.tar.gz: 570b07c252c379dad3196093527e3b30c9baba27083bc33ff4f034aa187974d8
+  metadata.gz: 1d30d222a87baa0b3a45fa90fb125d0be1b00c0ed6c61f84f494a55e383f9a15
+  data.tar.gz: a97948df483b99134fd78003033de2dfa0ab623bc4a7ea798263c7547c3ba093
 SHA512:
-  metadata.gz: e8d5e5db755e6e38b447daa753141e01bb67b157292fceb3b363bf489ccba6662c260eabef549e535a182e8add734d683acb0a5ae05979ff2a1343d5907aead0
-  data.tar.gz: 524e26d7e7e308cbcde01bf8e067c01a853a69a4c94a61f22c7ce31500d0eb7ed963094cdcb3cfd26ec6f88d5f9e84a1ea757ba5e706aca6e138c2655abe1b99
+  metadata.gz: d0add7c8ff6d0b02a2eaf3bf74903064a9ad55ea090f67914d0e69baafa4b732425809f210e2ed4627904013b22db2656f019747ed4c079938caab5caee606c2
+  data.tar.gz: b0f085cd793cb87574258b066c6a45b786437525a83d1df1bfb46e8bec4c75508e7620b21d78efd39ced57b744f1eb7f387181fb161d728890778ff27313d339

data/CHANGELOG.md

@@ -1,4 +1,18 @@
-## [Unreleased]
+## [0.4.0] - 2026-02-08
+
+### Added
+
+- **Dynamic Shortcuts**:
+    - Call methods like `user.is_admin?` or `user.is_manager?(org)` directly.
+    - Configurable pattern (`config.dynamic_shortcuts_pattern`), defaults to `is_%{role}?`.
+    - Custom patterns supported (e.g. `in_%{role}_group?`).
+- **Enhanced Resourceable**:
+    - Added `has_many :users, through: :roles` association for direct user access (e.g. `org.users`).
+    - Added `users_grouped_by_role` to get a hash of users per role.
+    - Added `destroy_role(role_name)` for bulk cleanup on a resource.
+    - Added convenience methods/aliases: `users_with_roles`, `applied_roles`.
+- **Generator**:
+    - Updated install template to include new configuration options.
 
 ## [0.3.3] - 2026-02-07
 

data/README.md

@@ -235,8 +235,14 @@ class Organization < ApplicationRecord
 end
 
 org = Organization.first
+org.users                   # All users with ANY role (via has_many :through)
 org.users_with_role(:manager)
-org.available_roles # ["manager", "admin"]
+org.users_with_roles        # All users with ANY role on this org
+org.available_roles         # ["manager", "admin"]
+org.users_grouped_by_role   # { "manager" => [user1], "admin" => [user2] }
+
+# Cleanup
+org.destroy_role(:manager)  # Removes the "manager" role and all its assignments from this org
 
 # Scopes
 Organization.with_role(:manager, user)
@@ -254,9 +260,44 @@ RoleFu.configure do |config|
 
   # Enable Rolify-style permissive checks (Global roles override resource checks)
   config.global_roles_override = true
+
+  # Enable dynamic shortcuts (e.g. user.is_admin?)
+  # Default is nil (disabled). Recommended: "is_%{role}?"
+  config.dynamic_shortcuts_pattern = "is_%{role}?"
 end
 ```
 
+## Dynamic Shortcuts
+
+RoleFu supports dynamic methods for quick role checking if you configure a pattern.
+
+**Configuration:**
+
+```ruby
+# In config/initializers/role_fu.rb
+RoleFu.configure do |config|
+  config.dynamic_shortcuts_pattern = "is_%{role}?"
+end
+```
+
+**Usage:**
+
+```ruby
+user.is_admin?              # Equivalent to user.has_role?(:admin)
+user.is_manager?(org)       # Equivalent to user.has_role?(:manager, org)
+```
+
+**Custom Pattern:**
+
+If you use groups:
+
+```ruby
+config.dynamic_shortcuts_pattern = "in_%{role}_group?"
+
+# Usage:
+user.in_admin_group?        # Equivalent to user.has_role?(:admin)
+```
+
 ## Custom Aliases (e.g. Groups)
 
 If you prefer different terminology (e.g., "Groups" instead of "Roles"), you can alias the methods in your models:

data/gemfiles/rails_7.2.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    role_fu (0.3.3)
+    role_fu (0.4.0)
       activerecord (>= 7.2)
 
 GEM
@@ -104,8 +104,9 @@ GEM
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     json (2.18.1)
@@ -205,7 +206,7 @@ GEM
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.3.1)
-    rdoc (7.1.0)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -345,7 +346,7 @@ CHECKSUMS
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
+  irb (1.17.0) sha256=168c4ddb93d8a361a045c41d92b2952c7a118fa73f23fe14e55609eb7a863aae
   json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lefthook (2.1.0) sha256=a100dc90139806e62b9aa40cf32e9edf34f6cff10c8b55ebd14a1b0add4b86bf
@@ -386,10 +387,10 @@ CHECKSUMS
   railties (7.2.3) sha256=6eb010a6bfe6f223e783f739ddfcbdb5b88b1f3a87f7739f0a0685e466250422
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
-  rdoc (7.1.0) sha256=494899df0706c178596ca6e1d50f1b7eb285a9b2aae715be5abd742734f17363
+  rdoc (7.2.0) sha256=8650f76cd4009c3b54955eb5d7e3a075c60a57276766ebf36f9085e8c9f23192
   regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
   reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  role_fu (0.3.3)
+  role_fu (0.4.0)
   rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
   rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
   rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836

data/gemfiles/rails_8.0.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    role_fu (0.3.3)
+    role_fu (0.4.0)
       activerecord (>= 7.2)
 
 GEM
@@ -101,8 +101,9 @@ GEM
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     json (2.18.1)
@@ -201,7 +202,7 @@ GEM
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.3.1)
-    rdoc (7.1.0)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -341,7 +342,7 @@ CHECKSUMS
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
+  irb (1.17.0) sha256=168c4ddb93d8a361a045c41d92b2952c7a118fa73f23fe14e55609eb7a863aae
   json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lefthook (2.1.0) sha256=a100dc90139806e62b9aa40cf32e9edf34f6cff10c8b55ebd14a1b0add4b86bf
@@ -382,10 +383,10 @@ CHECKSUMS
   railties (8.0.4) sha256=8203d853dcffab4abcdd05c193f101676a92068075464694790f6d8f72d5cb47
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
-  rdoc (7.1.0) sha256=494899df0706c178596ca6e1d50f1b7eb285a9b2aae715be5abd742734f17363
+  rdoc (7.2.0) sha256=8650f76cd4009c3b54955eb5d7e3a075c60a57276766ebf36f9085e8c9f23192
   regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
   reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  role_fu (0.3.3)
+  role_fu (0.4.0)
   rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
   rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
   rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836

data/gemfiles/rails_8.1.gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: ..
   specs:
-    role_fu (0.3.3)
+    role_fu (0.4.0)
       activerecord (>= 7.2)
 
 GEM
@@ -103,8 +103,9 @@ GEM
     i18n (1.14.8)
       concurrent-ruby (~> 1.0)
     io-console (0.8.2)
-    irb (1.16.0)
+    irb (1.17.0)
       pp (>= 0.6.0)
+      prism (>= 1.3.0)
       rdoc (>= 4.0.0)
       reline (>= 0.4.2)
     json (2.18.1)
@@ -203,7 +204,7 @@ GEM
       zeitwerk (~> 2.6)
     rainbow (3.1.1)
     rake (13.3.1)
-    rdoc (7.1.0)
+    rdoc (7.2.0)
       erb
       psych (>= 4.0.0)
       tsort
@@ -343,7 +344,7 @@ CHECKSUMS
   globalid (1.3.0) sha256=05c639ad6eb4594522a0b07983022f04aa7254626ab69445a0e493aa3786ff11
   i18n (1.14.8) sha256=285778639134865c5e0f6269e0b818256017e8cde89993fdfcbfb64d088824a5
   io-console (0.8.2) sha256=d6e3ae7a7cc7574f4b8893b4fca2162e57a825b223a177b7afa236c5ef9814cc
-  irb (1.16.0) sha256=2abe56c9ac947cdcb2f150572904ba798c1e93c890c256f8429981a7675b0806
+  irb (1.17.0) sha256=168c4ddb93d8a361a045c41d92b2952c7a118fa73f23fe14e55609eb7a863aae
   json (2.18.1) sha256=fe112755501b8d0466b5ada6cf50c8c3f41e897fa128ac5d263ec09eedc9f986
   language_server-protocol (3.17.0.5) sha256=fd1e39a51a28bf3eec959379985a72e296e9f9acfce46f6a79d31ca8760803cc
   lefthook (2.1.0) sha256=a100dc90139806e62b9aa40cf32e9edf34f6cff10c8b55ebd14a1b0add4b86bf
@@ -384,10 +385,10 @@ CHECKSUMS
   railties (8.1.2) sha256=1289ece76b4f7668fc46d07e55cc992b5b8751f2ad85548b7da351b8c59f8055
   rainbow (3.1.1) sha256=039491aa3a89f42efa1d6dec2fc4e62ede96eb6acd95e52f1ad581182b79bc6a
   rake (13.3.1) sha256=8c9e89d09f66a26a01264e7e3480ec0607f0c497a861ef16063604b1b08eb19c
-  rdoc (7.1.0) sha256=494899df0706c178596ca6e1d50f1b7eb285a9b2aae715be5abd742734f17363
+  rdoc (7.2.0) sha256=8650f76cd4009c3b54955eb5d7e3a075c60a57276766ebf36f9085e8c9f23192
   regexp_parser (2.11.3) sha256=ca13f381a173b7a93450e53459075c9b76a10433caadcb2f1180f2c741fc55a4
   reline (0.6.3) sha256=1198b04973565b36ec0f11542ab3f5cfeeec34823f4e54cebde90968092b1835
-  role_fu (0.3.3)
+  role_fu (0.4.0)
   rspec (3.13.2) sha256=206284a08ad798e61f86d7ca3e376718d52c0bc944626b2349266f239f820587
   rspec-core (3.13.6) sha256=a8823c6411667b60a8bca135364351dda34cd55e44ff94c4be4633b37d828b2d
   rspec-expectations (3.13.5) sha256=33a4d3a1d95060aea4c94e9f237030a8f9eae5615e9bd85718fe3a09e4b58836

data/lib/generators/role_fu/templates/role_fu.rb

@@ -9,4 +9,11 @@ RoleFu.configure do |config|
 
   # The class name of your RoleAssignment model
   # config.role_assignment_class_name = "RoleAssignment"
+
+  # Enable Rolify-style permissive checks (Global roles override resource checks)
+  # config.global_roles_override = false
+
+  # Enable dynamic shortcuts (e.g. user.is_admin?)
+  # Default is "is_%{role}?". Set to nil to disable.
+  # config.dynamic_shortcuts_pattern = "is_%{role}?"
 end

data/lib/role_fu/configuration.rb

@@ -3,12 +3,25 @@
 module RoleFu
   class Configuration
     attr_accessor :user_class_name, :role_class_name, :role_assignment_class_name, :global_roles_override
+    attr_reader :dynamic_shortcuts_pattern, :dynamic_shortcuts_regex
 
     def initialize
       @user_class_name = "User"
       @role_class_name = "Role"
       @role_assignment_class_name = "RoleAssignment"
       @global_roles_override = false
+      self.dynamic_shortcuts_pattern = "is_%{role}?"
+    end
+
+    def dynamic_shortcuts_pattern=(pattern)
+      @dynamic_shortcuts_pattern = pattern
+      if pattern.nil? || pattern.strip.empty?
+        @dynamic_shortcuts_regex = nil
+      else
+        parts = pattern.split("%{role}", -1)
+        regex_string = "^#{parts.map { |part| Regexp.escape(part) }.join("(?<role>.+)")}$"
+        @dynamic_shortcuts_regex = Regexp.new(regex_string)
+      end
     end
   end
 

data/lib/role_fu/resourceable.rb

@@ -9,6 +9,11 @@ module RoleFu
         as: :resource,
         dependent: :destroy,
         class_name: RoleFu.configuration.role_class_name
+
+      has_many :users,
+        through: :roles,
+        class_name: RoleFu.configuration.user_class_name,
+        source: :users
     end
 
     module ClassMethods
@@ -48,12 +53,15 @@ module RoleFu
         alias_method "users_with_any_#{singular}", :users_with_any_role
         alias_method "users_with_all_#{plural}", :users_with_all_roles
         alias_method "users_with_#{plural}", :users_with_roles
+        alias_method "users_grouped_by_#{singular}", :users_grouped_by_role
         alias_method "available_#{plural}", :available_roles
+        alias_method "applied_#{plural}", :applied_roles
         alias_method "has_#{singular}?", :has_role?
         alias_method "count_users_with_#{singular}", :count_users_with_role
         alias_method "user_has_#{singular}?", :user_has_role?
         alias_method "add_#{singular}_to_user", :add_role_to_user
         alias_method "remove_#{singular}_from_user", :remove_role_from_user
+        alias_method "destroy_#{singular}", :destroy_role
       end
     end
 
@@ -61,6 +69,29 @@ module RoleFu
       roles
     end
 
+    def destroy_role(role_name)
+      roles.where(name: role_name.to_s).destroy_all
+    end
+
+    def users_grouped_by_role
+      RoleFu.role_class.table_name
+
+      # Efficiently load roles and their associated users
+      # 1. Get all roles for this resource
+      # 2. Preload users for these roles
+
+      role_scope = roles.includes(:users)
+
+      results = {}
+      role_scope.each do |role|
+        results[role.name] ||= []
+        results[role.name].concat(role.users)
+      end
+
+      # Deduplicate users if a user has the same role multiple times (unlikely with distinct but safer)
+      results.transform_values(&:uniq)
+    end
+
     def users_with_role(role_name)
       role_table = RoleFu.role_class.table_name
       RoleFu.user_class.joins(:roles)

data/lib/role_fu/roleable.rb

@@ -209,8 +209,27 @@ module RoleFu
       query.distinct
     end
 
+    def method_missing(method_name, *args, &block)
+      if (role_name = parse_dynamic_role_name(method_name))
+        has_role?(role_name, *args)
+      else
+        super
+      end
+    end
+
+    def respond_to_missing?(method_name, include_private = false)
+      parse_dynamic_role_name(method_name) || super
+    end
+
     private
 
+    def parse_dynamic_role_name(method_name)
+      return nil unless (regex = RoleFu.configuration.dynamic_shortcuts_regex)
+
+      match = method_name.to_s.match(regex)
+      match ? match[:role] : nil
+    end
+
     def filter_expired(relation)
       return relation unless RoleFu.role_assignment_class.column_names.include?("expires_at")
 

data/lib/role_fu/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RoleFu
-  VERSION = "0.3.3"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: role_fu
 version: !ruby/object:Gem::Version
-  version: 0.3.3
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexey Poimtsev