pundit-matchers 3.0.1 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: deb38560b2277878e0a13f7f7a6fb510e257c5f84b625a387424e08cb5e8708b
-  data.tar.gz: '084e0cb2b93b0e27f1bb710666b3d9c1aadd9fac71ffef0ca178b025a531cafe'
+  metadata.gz: 379030415885d5cd2557f7540639e6c835f53cfa5a88895fd3e5f7cbbdf1b88f
+  data.tar.gz: 5a5e5f7586d31f4328e3e0b5bf722d3465a681ef77340a90d44b6517f04eb700
 SHA512:
-  metadata.gz: b219dfc3fbc0a1283f0c87627b5615947f97b449ce299d65be5106e0a46b06d9a0ed40f1f86a84830cc567a74d75da9b597136f1c563cebcce3752eb2a581d45
-  data.tar.gz: ce6b7c6a259a6a4e22f673985c3154e334f87acf2f856b9340f97dd62d5d56945cfc16191bfb503bbce24b12c002394e0994554a29376bbe82849a690926fb19
+  metadata.gz: 5c513efb4f063cd3bd15d43c0a68d001bb4ca4ef806861b27cc0de39f7102d6aab8be0ee2b64213b83f8991d38d9e3f62ae6f7b0c03f0ae87f2f1f71fba87b0c
+  data.tar.gz: a32970e872d608219955154cdd43812b36a4d0d37363e09d0e17e341f297c23afb0e947756711b1df3d1c0aad3bcc48a43935663072b87656f196bfdb049afab

data/lib/pundit/matchers/attributes_matcher.rb

@@ -8,6 +8,8 @@ module Pundit
     class AttributesMatcher < BaseMatcher
       # Error message to be raised when no attributes are specified.
       ARGUMENTS_REQUIRED_ERROR = 'At least one attribute must be specified'
+      # Error message to be raised when only one attribute may be specified.
+      ONE_ARGUMENT_REQUIRED_ERROR = 'Only one attribute may be specified'
 
       # Initializes a new instance of the AttributesMatcher class.
       #
@@ -29,6 +31,17 @@ module Pundit
         self
       end
 
+      # Ensures that only one attribute is specified.
+      #
+      # @raise [ArgumentError] If more than one attribute is specified.
+      #
+      # @return [AttributesMatcher] The object itself.
+      def ensure_single_attribute!
+        raise ArgumentError, ONE_ARGUMENT_REQUIRED_ERROR if expected_attributes.size > 1
+
+        self
+      end
+
       private
 
       attr_reader :expected_attributes, :options

data/lib/pundit/matchers.rb

@@ -152,15 +152,32 @@ module Pundit
       ForbidOnlyActionsMatcher.new(*actions)
     end
 
+    # Creates a matcher that tests if the policy permits mass assignment of an attribute.
+    #
+    # @param [String, Symbol, Hash] attribute the attribute to be tested.
+    # @return [PermitAttributesMatcher] the matcher object.
+    def permit_attribute(attribute)
+      PermitAttributesMatcher.new(attribute).ensure_single_attribute!
+    end
+
+    RSpec::Matchers.define_negated_matcher :forbid_attribute, :permit_attribute, &NEGATED_DESCRIPTION
+
     # Creates a matcher that tests if the policy permits mass assignment of a set of attributes.
     #
     # @param [Array<String, Symbol, Hash>] attributes the attributes to be tested.
     # @return [PermitAttributesMatcher] the matcher object.
-    def permit_mass_assignment_of(*attributes)
+    def permit_attributes(*attributes)
       PermitAttributesMatcher.new(*attributes)
     end
 
-    RSpec::Matchers.define_negated_matcher :forbid_mass_assignment_of, :permit_mass_assignment_of, &NEGATED_DESCRIPTION
+    RSpec::Matchers.define_negated_matcher :forbid_attributes, :permit_attributes, &NEGATED_DESCRIPTION
+
+    # @!macro [attach] RSpec::Matchers.alias_matcher
+    #   @!method $1
+    #
+    #   An alias matcher for {$2}.
+    RSpec::Matchers.alias_matcher :permit_mass_assignment_of, :permit_attributes
+    RSpec::Matchers.alias_matcher :forbid_mass_assignment_of, :forbid_attributes
   end
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pundit-matchers
 version: !ruby/object:Gem::Version
-  version: 3.0.1
+  version: 3.1.0
 platform: ruby
 authors:
 - Chris Alley
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-06-16 00:00:00.000000000 Z
+date: 2023-06-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec-core