role_fu 0.3.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b2b6f0598619d72c54eff632b24395808c2e830c1742ae072e5c977ae183f31e
-  data.tar.gz: 90b6b655d0858fe2876a530055bc5a4bb27e6f0552b1ad2a4dba4fbc8fedb0e7
+  metadata.gz: 1d30d222a87baa0b3a45fa90fb125d0be1b00c0ed6c61f84f494a55e383f9a15
+  data.tar.gz: a97948df483b99134fd78003033de2dfa0ab623bc4a7ea798263c7547c3ba093
 SHA512:
-  metadata.gz: 46c110643a2838ce274b0041f27c2c47b37a279265e96114f2e4cacd1f7c0964e143575ed171fc4d416c998718392dcd103c0d97d0003330506f240c826fb019
-  data.tar.gz: cae97d08a68d4db3700c3801d464ea4369029239eeb3181461043c367cba0f967275a38a80309503a6a994095432530a3204dd257acfa1fff48c6947fd768831
+  metadata.gz: d0add7c8ff6d0b02a2eaf3bf74903064a9ad55ea090f67914d0e69baafa4b732425809f210e2ed4627904013b22db2656f019747ed4c079938caab5caee606c2
+  data.tar.gz: b0f085cd793cb87574258b066c6a45b786437525a83d1df1bfb46e8bec4c75508e7620b21d78efd39ced57b744f1eb7f387181fb161d728890778ff27313d339

data/CHANGELOG.md

@@ -1,4 +1,24 @@
-## [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
+
+### Fixed
+
+- **UUID Support**: Generators now automatically detect and use UUIDs for primary and foreign keys if enabled in the application or model configuration.
 
 ## [0.3.1] - 2026-02-06
 

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.1)
+    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.1)
+  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.1)
+    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.1)
+  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.1)
+    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.1)
+  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/abilities_generator.rb

@@ -22,7 +22,7 @@ module RoleFu
       end
 
       def create_abilities_migration
-        migration_template "abilities_migration.rb.erb", "db/migrate/role_fu_create_permissions.rb", migration_version: migration_version
+        migration_template "abilities_migration.rb.erb", "db/migrate/role_fu_create_permissions.rb"
       end
 
       def inject_into_role_model
@@ -56,6 +56,19 @@ module RoleFu
       def migration_version
         "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]" if Rails::VERSION::MAJOR >= 5
       end
+
+      def uuid_enabled?
+        options[:primary_key_type] == "uuid" ||
+          Rails.configuration.generators.options.dig(:active_record, :primary_key_type) == :uuid ||
+          role_has_uuid_pk?
+      end
+
+      def role_has_uuid_pk?
+        role_cname = RoleFu.configuration.role_class_name
+        klass = role_cname.safe_constantize
+        return false unless klass&.table_exists?
+        klass.columns_hash[klass.primary_key]&.type == :uuid
+      end
     end
   end
 end

data/lib/generators/role_fu/audit_generator.rb

@@ -18,7 +18,7 @@ module RoleFu
       desc "" # Empty desc to avoid duplication at the bottom
 
       def create_audit_migration
-        migration_template "audit_migration.rb.erb", "db/migrate/role_fu_create_audits.rb", migration_version: migration_version
+        migration_template "audit_migration.rb.erb", "db/migrate/role_fu_create_audits.rb"
       end
 
       def create_model
@@ -30,6 +30,19 @@ module RoleFu
       def migration_version
         "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]" if Rails::VERSION::MAJOR >= 5
       end
+
+      def uuid_enabled?
+        options[:primary_key_type] == "uuid" ||
+          Rails.configuration.generators.options.dig(:active_record, :primary_key_type) == :uuid ||
+          user_has_uuid_pk?
+      end
+
+      def user_has_uuid_pk?
+        user_cname = RoleFu.configuration.user_class_name || "User"
+        klass = user_cname.safe_constantize
+        return false unless klass&.table_exists?
+        klass.columns_hash[klass.primary_key]&.type == :uuid
+      end
     end
   end
 end

data/lib/generators/role_fu/role_fu_generator.rb

@@ -33,7 +33,7 @@ module RoleFu
       end
 
       def copy_role_fu_migration
-        migration_template "migration.rb.erb", "db/migrate/role_fu_create_#{table_name}.rb", migration_version: migration_version
+        migration_template "migration.rb.erb", "db/migrate/role_fu_create_#{table_name}.rb"
       end
 
       def inject_role_fu_into_user_model
@@ -52,6 +52,18 @@ module RoleFu
       def migration_version
         "[#{Rails::VERSION::MAJOR}.#{Rails::VERSION::MINOR}]" if Rails::VERSION::MAJOR >= 5
       end
+
+      def uuid_enabled?
+        options[:primary_key_type] == "uuid" ||
+          Rails.configuration.generators.options.dig(:active_record, :primary_key_type) == :uuid ||
+          user_has_uuid_pk?
+      end
+
+      def user_has_uuid_pk?
+        klass = user_cname.safe_constantize
+        return false unless klass&.table_exists?
+        klass.columns_hash[klass.primary_key]&.type == :uuid
+      end
     end
   end
 end

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

@@ -2,8 +2,8 @@
 
 class RoleFuCreatePermissions < ActiveRecord::Migration<%= migration_version %>
   def change
-    create_table :permissions do |t|
-      t.references :role, null: false, index: true
+    create_table :permissions<%= ", id: :uuid" if uuid_enabled? %> do |t|
+      t.references :role, null: false, index: true<%= ", type: :uuid" if uuid_enabled? %>
       t.string :action, null: false
       t.jsonb :conditions, default: {}
 

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

@@ -2,10 +2,10 @@
 
 class RoleFuCreateAudits < ActiveRecord::Migration<%= migration_version %>
   def change
-    create_table :role_assignment_audits do |t|
-      t.references :user, index: true
-      t.references :role, index: true
-      t.references :role_assignment, index: true
+    create_table :role_assignment_audits<%= ", id: :uuid" if uuid_enabled? %> do |t|
+      t.references :user, index: true<%= ", type: :uuid" if uuid_enabled? %>
+      t.references :role, index: true<%= ", type: :uuid" if uuid_enabled? %>
+      t.references :role_assignment, index: true<%= ", type: :uuid" if uuid_enabled? %>
       t.string :operation, null: false # INSERT, UPDATE, DELETE
       t.string :whodunnit
       t.jsonb :meta_snapshot

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

@@ -2,16 +2,16 @@
 
 class RoleFuCreate<%= table_name.camelize %> < ActiveRecord::Migration<%= migration_version %>
   def change
-    create_table :<%= table_name %> do |t|
+    create_table :<%= table_name %><%= ", id: :uuid" if uuid_enabled? %> do |t|
       t.string :name
-      t.references :resource, polymorphic: true, index: true
+      t.references :resource, polymorphic: true, index: true<%= ", type: :uuid" if uuid_enabled? %>
 
       t.timestamps
     end
 
-    create_table :<%= table_name.singularize %>_assignments do |t|
-      t.references :<%= user_cname.underscore %>, index: true
-      t.references :<%= table_name.singularize %>, index: true
+    create_table :<%= table_name.singularize %>_assignments<%= ", id: :uuid" if uuid_enabled? %> do |t|
+      t.references :<%= user_cname.underscore %>, index: true<%= ", type: :uuid" if uuid_enabled? %>
+      t.references :<%= table_name.singularize %>, index: true<%= ", type: :uuid" if uuid_enabled? %>
       t.datetime :expires_at, index: true
       t.jsonb :meta, default: {}
 

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.1"
+  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.1
+  version: 0.4.0
 platform: ruby
 authors:
 - Alexey Poimtsev