action_policy 0.5.6 → 0.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e859b71805cff1035904f6a6b6ec73e19f4722e894f88b9a7834a30569c4f587
-  data.tar.gz: 2df569e93f84268bf3244d1615559716b16081d53df826dfe856cefb7dd0becc
+  metadata.gz: ea35d16fad09b0ec03201b12ff0ff17b8a189fba92c2391ca88d4140e8561570
+  data.tar.gz: 0decb11729d971bcf4fe3ef78b3fe461e42b61e5ed9c0b58fb6d3d9cdd2e8d48
 SHA512:
-  metadata.gz: 6457503550706d1cc63e4e636c675f9d7a0f70184deb0217a8ad79206c897e00317eef14522a72c415b8e292ee0d52a9837c011e2793cec1eee55e8ed792f778
-  data.tar.gz: 148141b42a80097b3b7369118027b77a8cd7a1412cef4b3cd75f5e80415c93cd60f1d1a5d3fd1ee0f30f44886475f59db408deffa3c40d060ff3319fef45c1b9
+  metadata.gz: 10048a5581c03d81ebb582c96bd7a168a800028d2d19783f44ce8837cb2747a1d80249195d0d4df090ebc34002f5ffde90edb5dc34e50765f61ed4c1782ac5ce
+  data.tar.gz: e369370e68ba73cd6645c1b90ea7ede7e4d3b446aa582a77c7a417ccb95065ef06e3461b303317895835004dfbdcf5bacff58664dda7eafe71e09a691cc22c0f

data/CHANGELOG.md

@@ -2,7 +2,25 @@
 
 ## master
 
-## 0.5.6 (2021-03-03)
+## 0.6.1 (2022-05-23)
+
+- Fix policy lookup when a namespaced record is passed and the strict mode is used. ([@palkan][])
+- Expose `#authorized_scope` as helper. ([@palkan][])
+- [Fixes [#207](https://github.com/palkan/action_policy/issues/207)] refinement#include deprecation warning on Ruby 3.1
+
+## 0.6.0 (2021-09-02)
+
+- Drop Ruby 2.5 support.
+- [Closes [#186](https://github.com/palkan/action_policy/issues/186)] Add `inline_reasons: true` option to `allowed_to?` to avoid wrapping reasons. ([@palkan][])
+- [Fixes [#173](https://github.com/palkan/action_policy/issues/173)] Explicit context were not merged with implicit one within policy classes. ([@palkan][])
+- Add `strict_namespace:` option to policy_for behaviour ([@kevynlebouille][])
+- Prevent possible side effects in policy lookup ([@tomdalling][])
+
+## 0.5.7 (2021-03-03)
+
+The previous release had incorrect dependencies (due to the missing transpiled files).
+
+## ~~0.5.6 (2021-03-03)~~
 
 - Add `ActionPolicy.enforce_predicate_rules_naming` config to catch rule missing question mark ([@skojin][])
 
@@ -445,3 +463,4 @@ This value is now stored in a cache (if any) instead of just the call result (`t
 [@Be-ngt-oH]: https://github.com/Be-ngt-oH
 [@pirj]: https://github.com/pirj
 [@skojin]: https://github.com/skojin
+[@tomdalling]: https://github.com/tomdalling

data/lib/.rbnext/1995.next/action_policy/utils/pretty_print.rb

@@ -146,8 +146,8 @@ module ActionPolicy
 
       def colorize(val)
         return val unless $stdout.isatty
-        return TRUE if val.eql?(true)
-        return FALSE if val.eql?(false)
+        return TRUE if val.eql?(true) # rubocop:disable Lint/DeprecatedConstants
+        return FALSE if val.eql?(false) # rubocop:disable Lint/DeprecatedConstants
         val
       end
     end

data/lib/.rbnext/2.7/action_policy/behaviours/policy_for.rb

@@ -8,16 +8,18 @@ module ActionPolicy
       using ActionPolicy::Ext::PolicyCacheKey
 
       # Returns policy instance for the record.
-      def policy_for(record:, with: nil, namespace: authorization_namespace, context: authorization_context, allow_nil: false, default: default_authorization_policy_class)
+      def policy_for(record:, with: nil, namespace: authorization_namespace, context: nil, allow_nil: false, default: default_authorization_policy_class, strict_namespace: authorization_strict_namespace)
+        context = context ? authorization_context.merge(context) : authorization_context
+
         policy_class = with || ::ActionPolicy.lookup(
           record,
-          namespace: namespace, context: context, allow_nil: allow_nil, default: default
+          namespace: namespace, context: context, allow_nil: allow_nil, default: default, strict_namespace: strict_namespace
         )
         policy_class&.new(record, **context)
       end
 
       def authorization_context
-        raise NotImplementedError, "Please, define `authorization_context` method!"
+        Kernel.raise NotImplementedError, "Please, define `authorization_context` method!"
       end
 
       def authorization_namespace
@@ -28,6 +30,10 @@ module ActionPolicy
         # override to provide a policy class use when no policy found
       end
 
+      def authorization_strict_namespace
+        # override to provide strict namespace lookup option
+      end
+
       # Override this method to provide implicit authorization target
       # that would be used in case `record` is not specified in
       # `authorize!` and `allowed_to?` call.
@@ -39,7 +45,7 @@ module ActionPolicy
 
       # Return implicit authorization target or raises an exception if it's nil
       def implicit_authorization_target!
-        implicit_authorization_target || raise(
+        implicit_authorization_target || Kernel.raise(
           NotFound,
           [
             self,

data/lib/.rbnext/2.7/action_policy/utils/pretty_print.rb

@@ -146,8 +146,8 @@ module ActionPolicy
 
       def colorize(val)
         return val unless $stdout.isatty
-        return TRUE if val.eql?(true)
-        return FALSE if val.eql?(false)
+        return TRUE if val.eql?(true) # rubocop:disable Lint/DeprecatedConstants
+        return FALSE if val.eql?(false) # rubocop:disable Lint/DeprecatedConstants
         val
       end
     end

data/lib/.rbnext/3.0/action_policy/ext/policy_cache_key.rb

@@ -23,7 +23,7 @@ module ActionPolicy
       end
 
       refine Object do
-        include ObjectExt
+        ::RubyNext::Core.import_methods(ObjectExt, binding)
       end
 
       refine NilClass do

data/lib/.rbnext/3.0/action_policy/policy/aliases.rb

@@ -31,10 +31,18 @@ module ActionPolicy
       def resolve_rule(activity)
         self.class.lookup_alias(activity) ||
           (activity if respond_to?(activity)) ||
+          (check_rule_naming(activity) if ActionPolicy.enforce_predicate_rules_naming) ||
           self.class.lookup_default_rule ||
           super
       end
 
+      private def check_rule_naming(activity)
+        unless activity[-1] == "?"
+          raise NonPredicateRule.new(self, activity)
+        end
+        nil
+      end
+
       module ClassMethods # :nodoc:
         def default_rule(val)
           rules_aliases[DEFAULT] = val

data/lib/.rbnext/3.0/action_policy/policy/core.rb

@@ -23,12 +23,19 @@ module ActionPolicy
     def initialize(policy, rule)
       @policy = policy.class
       @rule = rule
-      @message =
-        "Couldn't find rule '#{@rule}' for #{@policy}" \
+      @message = "Couldn't find rule '#{@rule}' for #{@policy}" \
         "#{suggest(@rule, @policy.instance_methods - Object.instance_methods)}"
     end
   end
 
+  class NonPredicateRule < UnknownRule
+    def initialize(policy, rule)
+      @policy = policy.class
+      @rule = rule
+      @message = "The rule '#{@rule}' of '#{@policy}' must ends with ? (question mark)\nDid you mean? #{@rule}?"
+    end
+  end
+
   module Policy
     # Core policy API
     module Core
@@ -79,7 +86,7 @@ module ActionPolicy
         @result = self.class.result_class.new(self.class, rule)
 
         catch :policy_fulfilled do
-          result.load __apply__(rule)
+          result.load __apply__(resolve_rule(rule))
         end
 
         result.value
@@ -126,13 +133,13 @@ module ActionPolicy
       end
 
       # An alias for readability purposes
-      def check?(*args) ;  allowed_to?(*args); end
+      def check?(*args, **hargs) ;  allowed_to?(*args, **hargs); end
 
       # Returns a rule name (policy method name) for activity.
       #
       # By default, rule name is equal to activity name.
       #
-      # Raises ActionPolicy::UknownRule when rule is not found in policy.
+      # Raises ActionPolicy::UnknownRule when rule is not found in policy.
       def resolve_rule(activity)
         raise UnknownRule.new(self, activity) unless
           respond_to?(activity)

data/lib/.rbnext/3.0/action_policy/policy/reasons.rb

@@ -31,6 +31,20 @@ module ActionPolicy
 
       def present?() ;  !empty?; end
 
+      def merge(other)
+        other.reasons.each do |policy_class, rules|
+          reasons[policy_class] ||= []
+
+          rules.each do |rule|
+            if rule.is_a?(::Hash)
+              add_detailed_reason(reasons[policy_class], rule)
+            else
+              add_non_detailed_reason(reasons[policy_class], rule)
+            end
+          end
+        end
+      end
+
       private
 
       def add_non_detailed_reason(store, rule)
@@ -182,7 +196,7 @@ module ActionPolicy
         result.details ||= {}
       end
 
-      def allowed_to?(rule, record = :__undef__, **options)
+      def allowed_to?(rule, record = :__undef__, inline_reasons: false, **options)
         res =
           if (record == :__undef__ || record == self.record) && options.empty?
             rule = resolve_rule(rule)
@@ -196,7 +210,9 @@ module ActionPolicy
             policy.result
           end
 
-        result&.reasons&.add(policy, rule, res.details) if res.fail?
+        if res.fail? && result&.reasons
+          inline_reasons ? result.reasons.merge(res.reasons) : result.reasons.add(policy, rule, res.details)
+        end
 
         res.clear_details
 

data/lib/.rbnext/3.0/action_policy/rspec/be_an_alias_of.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "action_policy/testing"
+
+module ActionPolicy
+  module RSpec
+    # Policy rule alias matcher `be_an_alias_of`.
+    #
+    # Verifies that for given policy a policy rule has an alias.
+    #
+    # Example:
+    #
+    #   # in policy specs
+    #   subject(:policy) { described_class.new(record, user: user) }
+    #
+    #   let(:user) { build_stubbed(:user) }
+    #   let(:record) { build_stubbed(:post) }
+    #
+    #   describe "#show?" do
+    #     it "is an alias of :index? policy rule" do
+    #       expect(:show?).to be_an_alias_of(policy, :index?)
+    #     end
+    #   end
+    #
+    #   # negated version
+    #   describe "#show?" do
+    #     it "is not an alias of :index? policy rule" do
+    #       expect(:show?).to_not be_an_alias_of(policy, :index?)
+    #     end
+    #   end
+    #
+    class BeAnAliasOf < ::RSpec::Matchers::BuiltIn::BaseMatcher
+      attr_reader :policy, :rule, :actual
+
+      def initialize(policy, rule)
+        @policy = policy
+        @rule = rule
+      end
+
+      def match(_expected, actual)
+        policy.resolve_rule(actual) == rule
+      end
+
+      def does_not_match?(actual)
+        @actual = actual
+        policy.resolve_rule(actual) != rule
+      end
+
+      def supports_block_expectations?() ;  false; end
+
+      def failure_message
+        "expected #{policy}##{actual} " \
+        "to be an alias of #{policy}##{rule}"
+      end
+
+      def failure_message_when_negated
+        "expected #{policy}##{actual} " \
+        "to not be an alias of #{policy}##{rule}"
+      end
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include(Module.new do
+    def be_an_alias_of(policy, rule)
+      ActionPolicy::RSpec::BeAnAliasOf.new(policy, rule)
+    end
+  end)
+end

data/lib/.rbnext/3.0/action_policy/utils/pretty_print.rb

@@ -146,8 +146,8 @@ module ActionPolicy
 
       def colorize(val)
         return val unless $stdout.isatty
-        return TRUE if val.eql?(true)
-        return FALSE if val.eql?(false)
+        return TRUE if val.eql?(true) # rubocop:disable Lint/DeprecatedConstants
+        return FALSE if val.eql?(false) # rubocop:disable Lint/DeprecatedConstants
         val
       end
     end

data/lib/.rbnext/{1995.next → 3.1}/action_policy/behaviours/policy_for.rb

@@ -8,16 +8,18 @@ module ActionPolicy
       using ActionPolicy::Ext::PolicyCacheKey
 
       # Returns policy instance for the record.
-      def policy_for(record:, with: nil, namespace: authorization_namespace, context: authorization_context, allow_nil: false, default: default_authorization_policy_class)
+      def policy_for(record:, with: nil, namespace: authorization_namespace, context: nil, allow_nil: false, default: default_authorization_policy_class, strict_namespace: authorization_strict_namespace)
+        context = context ? authorization_context.merge(context) : authorization_context
+
         policy_class = with || ::ActionPolicy.lookup(
           record,
-          namespace: namespace, context: context, allow_nil: allow_nil, default: default
+          namespace: namespace, context: context, allow_nil: allow_nil, default: default, strict_namespace: strict_namespace
         )
         policy_class&.new(record, **context)
       end
 
       def authorization_context
-        raise NotImplementedError, "Please, define `authorization_context` method!"
+        Kernel.raise NotImplementedError, "Please, define `authorization_context` method!"
       end
 
       def authorization_namespace
@@ -28,6 +30,10 @@ module ActionPolicy
         # override to provide a policy class use when no policy found
       end
 
+      def authorization_strict_namespace
+        # override to provide strict namespace lookup option
+      end
+
       # Override this method to provide implicit authorization target
       # that would be used in case `record` is not specified in
       # `authorize!` and `allowed_to?` call.
@@ -39,7 +45,7 @@ module ActionPolicy
 
       # Return implicit authorization target or raises an exception if it's nil
       def implicit_authorization_target!
-        implicit_authorization_target || raise(
+        implicit_authorization_target || Kernel.raise(
           NotFound,
           [
             self,

data/lib/.rbnext/3.1/action_policy/ext/module_namespace.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module ActionPolicy
+  module Ext
+    # Add Module#namespace method
+    module ModuleNamespace # :nodoc: all
+      unless "".respond_to?(:safe_constantize)
+        require "action_policy/ext/string_constantize"
+        using ActionPolicy::Ext::StringConstantize
+      end
+
+      module Ext
+        def namespace
+          return unless name&.match?(/[^^]::/)
+
+          name.sub(/::[^:]+$/, "").safe_constantize
+        end
+      end
+
+      # See https://github.com/jruby/jruby/issues/5220
+      ::Module.include(Ext) if RUBY_PLATFORM.match?(/java/i)
+
+      refine Module do
+        if RUBY_VERSION <= "2.7.0"
+          include Ext
+        else
+          ::RubyNext::Core.import_methods(Ext, binding)
+        end
+      end
+    end
+  end
+end

data/lib/.rbnext/3.1/action_policy/ext/policy_cache_key.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module ActionPolicy
+  module Ext
+    # Adds #_policy_cache_key method to Object,
+    # which just call #policy_cache_key or #cache_key
+    # or #object_id (if `use_object_id` parameter is set to true).
+    #
+    # For other core classes returns string representation.
+    #
+    # Raises ArgumentError otherwise.
+    module PolicyCacheKey # :nodoc: all
+      module ObjectExt
+        def _policy_cache_key(use_object_id: false)
+          return policy_cache_key if respond_to?(:policy_cache_key)
+          return cache_key_with_version if respond_to?(:cache_key_with_version)
+          return cache_key if respond_to?(:cache_key)
+
+          return object_id.to_s if use_object_id == true
+
+          raise ArgumentError, "object is not cacheable"
+        end
+      end
+
+      refine Object do
+        ::RubyNext::Core.import_methods(ObjectExt, binding)
+      end
+
+      refine NilClass do
+        def _policy_cache_key(*) = ""
+      end
+
+      refine TrueClass do
+        def _policy_cache_key(*) = "t"
+      end
+
+      refine FalseClass do
+        def _policy_cache_key(*) = "f"
+      end
+
+      refine String do
+        def _policy_cache_key(*) = self
+      end
+
+      refine Symbol do
+        def _policy_cache_key(*) = to_s
+      end
+
+      if RUBY_PLATFORM.match?(/java/i)
+        refine Integer do
+          def _policy_cache_key(*) = to_s
+        end
+
+        refine Float do
+          def _policy_cache_key(*) = to_s
+        end
+      else
+        refine Numeric do
+          def _policy_cache_key(*) = to_s
+        end
+      end
+
+      refine Time do
+        def _policy_cache_key(*) = to_s
+      end
+
+      refine Module do
+        def _policy_cache_key(*) = name
+      end
+    end
+  end
+end

data/lib/action_policy/behaviour.rb

@@ -74,10 +74,8 @@ module ActionPolicy
     end
 
     def lookup_authorization_policy(record, **options) # :nodoc:
-      record = implicit_authorization_target! if record == :__undef__
-      raise ArgumentError, "Record must be specified" if record.nil?
-
-      options[:context] && (options[:context] = authorization_context.merge(options[:context]))
+      record = implicit_authorization_target! if :__undef__ == record # rubocop:disable Style/YodaCondition See https://github.com/palkan/action_policy/pull/180
+      Kernel.raise ArgumentError, "Record must be specified" if record.nil?
 
       policy_for(record: record, **options)
     end

data/lib/action_policy/behaviours/policy_for.rb

@@ -8,16 +8,18 @@ module ActionPolicy
       using ActionPolicy::Ext::PolicyCacheKey
 
       # Returns policy instance for the record.
-      def policy_for(record:, with: nil, namespace: authorization_namespace, context: authorization_context, allow_nil: false, default: default_authorization_policy_class)
+      def policy_for(record:, with: nil, namespace: authorization_namespace, context: nil, allow_nil: false, default: default_authorization_policy_class, strict_namespace: authorization_strict_namespace)
+        context = context ? authorization_context.merge(context) : authorization_context
+
         policy_class = with || ::ActionPolicy.lookup(
           record,
-          namespace:, context:, allow_nil:, default:
+          namespace:, context:, allow_nil:, default:, strict_namespace:
         )
         policy_class&.new(record, **context)
       end
 
       def authorization_context
-        raise NotImplementedError, "Please, define `authorization_context` method!"
+        Kernel.raise NotImplementedError, "Please, define `authorization_context` method!"
       end
 
       def authorization_namespace
@@ -28,6 +30,10 @@ module ActionPolicy
         # override to provide a policy class use when no policy found
       end
 
+      def authorization_strict_namespace
+        # override to provide strict namespace lookup option
+      end
+
       # Override this method to provide implicit authorization target
       # that would be used in case `record` is not specified in
       # `authorize!` and `allowed_to?` call.
@@ -39,7 +45,7 @@ module ActionPolicy
 
       # Return implicit authorization target or raises an exception if it's nil
       def implicit_authorization_target!
-        implicit_authorization_target || raise(
+        implicit_authorization_target || Kernel.raise(
           NotFound,
           [
             self,

data/lib/action_policy/ext/module_namespace.rb

@@ -21,7 +21,11 @@ module ActionPolicy
       ::Module.include(Ext) if RUBY_PLATFORM.match?(/java/i)
 
       refine Module do
-        include Ext
+        if RUBY_VERSION <= "2.7.0"
+          include Ext
+        else
+          import_methods Ext
+        end
       end
     end
   end

data/lib/action_policy/ext/policy_cache_key.rb

@@ -23,7 +23,7 @@ module ActionPolicy
       end
 
       refine Object do
-        include ObjectExt
+        import_methods ObjectExt
       end
 
       refine NilClass do

data/lib/action_policy/lookup_chain.rb

@@ -67,12 +67,20 @@ module ActionPolicy
       def lookup_within_namespace(policy_name, namespace, strict: false)
         NamespaceCache.fetch(namespace&.name || "Kernel", policy_name, strict: strict) do
           mod = namespace
+          policy_class = nil
+
           loop do
-            policy = [mod&.name, policy_name].compact.join("::").safe_constantize
-            break policy if policy || mod.nil? || strict
+            policy_class = [mod&.name, policy_name].compact.join("::").safe_constantize
+            break policy_class if policy_class || mod.nil?
 
             mod = mod.namespace
           end
+
+          next policy_class if !strict || namespace.nil? || policy_class.nil?
+
+          # If we're in the strict mode and the namespace boundary is provided,
+          # we must check that the found policy satisfies it
+          policy_class if policy_class.name.start_with?("#{namespace.name}::")
         end
       end
 

data/lib/action_policy/policy/authorization.rb

@@ -66,7 +66,7 @@ module ActionPolicy
           allow_nil ||= optional
 
           ids.each do |id|
-            authorization_targets[id] = {allow_nil, optional}
+            authorization_targets[id] = {allow_nil:, optional:}
           end
 
           attr_reader(*ids)

data/lib/action_policy/policy/core.rb

@@ -86,7 +86,7 @@ module ActionPolicy
         @result = self.class.result_class.new(self.class, rule)
 
         catch :policy_fulfilled do
-          result.load __apply__(rule)
+          result.load __apply__(resolve_rule(rule))
         end
 
         result.value
@@ -133,13 +133,13 @@ module ActionPolicy
       end
 
       # An alias for readability purposes
-      def check?(*args) = allowed_to?(*args)
+      def check?(*args, **hargs) = allowed_to?(*args, **hargs)
 
       # Returns a rule name (policy method name) for activity.
       #
       # By default, rule name is equal to activity name.
       #
-      # Raises ActionPolicy::UknownRule when rule is not found in policy.
+      # Raises ActionPolicy::UnknownRule when rule is not found in policy.
       def resolve_rule(activity)
         raise UnknownRule.new(self, activity) unless
           respond_to?(activity)

data/lib/action_policy/policy/reasons.rb

@@ -31,6 +31,20 @@ module ActionPolicy
 
       def present?() = !empty?
 
+      def merge(other)
+        other.reasons.each do |policy_class, rules|
+          reasons[policy_class] ||= []
+
+          rules.each do |rule|
+            if rule.is_a?(::Hash)
+              add_detailed_reason(reasons[policy_class], rule)
+            else
+              add_non_detailed_reason(reasons[policy_class], rule)
+            end
+          end
+        end
+      end
+
       private
 
       def add_non_detailed_reason(store, rule)
@@ -182,7 +196,7 @@ module ActionPolicy
         result.details ||= {}
       end
 
-      def allowed_to?(rule, record = :__undef__, **options)
+      def allowed_to?(rule, record = :__undef__, inline_reasons: false, **options)
         res =
           if (record == :__undef__ || record == self.record) && options.empty?
             rule = resolve_rule(rule)
@@ -196,7 +210,9 @@ module ActionPolicy
             policy.result
           end
 
-        result&.reasons&.add(policy, rule, res.details) if res.fail?
+        if res.fail? && result&.reasons
+          inline_reasons ? result.reasons.merge(res.reasons) : result.reasons.add(policy, rule, res.details)
+        end
 
         res.clear_details
 

data/lib/action_policy/rails/controller.rb

@@ -23,7 +23,10 @@ module ActionPolicy
     include ActionPolicy::Behaviours::Namespaced
 
     included do
-      helper_method :allowed_to? if respond_to?(:helper_method)
+      if respond_to?(:helper_method)
+        helper_method :allowed_to?
+        helper_method :authorized_scope
+      end
 
       attr_writer :authorize_count
       attr_reader :verify_authorized_skipped
@@ -57,7 +60,7 @@ module ActionPolicy
     end
 
     def verify_authorized
-      raise UnauthorizedAction.new(controller_path, action_name) if
+      Kernel.raise UnauthorizedAction.new(controller_path, action_name) if
         authorize_count.zero? && !verify_authorized_skipped
     end
 

data/lib/action_policy/rspec/be_an_alias_of.rb

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+require "action_policy/testing"
+
+module ActionPolicy
+  module RSpec
+    # Policy rule alias matcher `be_an_alias_of`.
+    #
+    # Verifies that for given policy a policy rule has an alias.
+    #
+    # Example:
+    #
+    #   # in policy specs
+    #   subject(:policy) { described_class.new(record, user: user) }
+    #
+    #   let(:user) { build_stubbed(:user) }
+    #   let(:record) { build_stubbed(:post) }
+    #
+    #   describe "#show?" do
+    #     it "is an alias of :index? policy rule" do
+    #       expect(:show?).to be_an_alias_of(policy, :index?)
+    #     end
+    #   end
+    #
+    #   # negated version
+    #   describe "#show?" do
+    #     it "is not an alias of :index? policy rule" do
+    #       expect(:show?).to_not be_an_alias_of(policy, :index?)
+    #     end
+    #   end
+    #
+    class BeAnAliasOf < ::RSpec::Matchers::BuiltIn::BaseMatcher
+      attr_reader :policy, :rule, :actual
+
+      def initialize(policy, rule)
+        @policy = policy
+        @rule = rule
+      end
+
+      def match(_expected, actual)
+        policy.resolve_rule(actual) == rule
+      end
+
+      def does_not_match?(actual)
+        @actual = actual
+        policy.resolve_rule(actual) != rule
+      end
+
+      def supports_block_expectations?() = false
+
+      def failure_message
+        "expected #{policy}##{actual} " \
+        "to be an alias of #{policy}##{rule}"
+      end
+
+      def failure_message_when_negated
+        "expected #{policy}##{actual} " \
+        "to not be an alias of #{policy}##{rule}"
+      end
+    end
+  end
+end
+
+RSpec.configure do |config|
+  config.include(Module.new do
+    def be_an_alias_of(policy, rule)
+      ActionPolicy::RSpec::BeAnAliasOf.new(policy, rule)
+    end
+  end)
+end

data/lib/action_policy/rspec.rb

@@ -1,4 +1,5 @@
 # frozen_string_literal: true
 
+require "action_policy/rspec/be_an_alias_of"
 require "action_policy/rspec/be_authorized_to"
 require "action_policy/rspec/have_authorized_scope"

data/lib/action_policy/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module ActionPolicy
-  VERSION = "0.5.6"
+  VERSION = "0.6.1"
 end

metadata

@@ -1,29 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: action_policy
 version: !ruby/object:Gem::Version
-  version: 0.5.6
+  version: 0.6.1
 platform: ruby
 authors:
 - Vladimir Dementyev
-autorequire: 
+autorequire:
 bindir: bin
 cert_chain: []
-date: 2021-03-03 00:00:00.000000000 Z
+date: 2022-05-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: ruby-next
+  name: ruby-next-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.11.0
+        version: 0.14.0
 - !ruby/object:Gem::Dependency
   name: ammeter
   requirement: !ruby/object:Gem::Requirement
@@ -133,9 +133,6 @@ files:
 - LICENSE.txt
 - README.md
 - config/rubocop-rspec.yml
-- lib/.rbnext/1995.next/action_policy/behaviours/policy_for.rb
-- lib/.rbnext/1995.next/action_policy/behaviours/scoping.rb
-- lib/.rbnext/1995.next/action_policy/policy/authorization.rb
 - lib/.rbnext/1995.next/action_policy/utils/pretty_print.rb
 - lib/.rbnext/2.7/action_policy/behaviours/policy_for.rb
 - lib/.rbnext/2.7/action_policy/i18n.rb
@@ -153,10 +150,16 @@ files:
 - lib/.rbnext/3.0/action_policy/policy/execution_result.rb
 - lib/.rbnext/3.0/action_policy/policy/pre_check.rb
 - lib/.rbnext/3.0/action_policy/policy/reasons.rb
+- lib/.rbnext/3.0/action_policy/rspec/be_an_alias_of.rb
 - lib/.rbnext/3.0/action_policy/rspec/be_authorized_to.rb
 - lib/.rbnext/3.0/action_policy/rspec/have_authorized_scope.rb
 - lib/.rbnext/3.0/action_policy/utils/pretty_print.rb
 - lib/.rbnext/3.0/action_policy/utils/suggest_message.rb
+- lib/.rbnext/3.1/action_policy/behaviours/policy_for.rb
+- lib/.rbnext/3.1/action_policy/behaviours/scoping.rb
+- lib/.rbnext/3.1/action_policy/ext/module_namespace.rb
+- lib/.rbnext/3.1/action_policy/ext/policy_cache_key.rb
+- lib/.rbnext/3.1/action_policy/policy/authorization.rb
 - lib/action_policy.rb
 - lib/action_policy/authorizer.rb
 - lib/action_policy/base.rb
@@ -194,6 +197,7 @@ files:
 - lib/action_policy/rails/scope_matchers/active_record.rb
 - lib/action_policy/railtie.rb
 - lib/action_policy/rspec.rb
+- lib/action_policy/rspec/be_an_alias_of.rb
 - lib/action_policy/rspec/be_authorized_to.rb
 - lib/action_policy/rspec/dsl.rb
 - lib/action_policy/rspec/have_authorized_scope.rb
@@ -222,7 +226,7 @@ metadata:
   documentation_uri: https://actionpolicy.evilmartians.io/
   homepage_uri: https://actionpolicy.evilmartians.io/
   source_code_uri: http://github.com/palkan/action_policy
-post_install_message: 
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -230,15 +234,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.5.0
+      version: 2.6.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
-signing_key: 
+rubygems_version: 3.3.7
+signing_key:
 specification_version: 4
 summary: Authorization framework for Ruby/Rails application
 test_files: []