minitest-attributes 0.1.0 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b71a344c8363a4b9c1e246d0dd780385dd779ba05438732e5bb882d1a81caf29
-  data.tar.gz: e328c7e05f313934149b2df5e44e63b438aefa5756ca156e762b9f98a637dcbd
+  metadata.gz: 40bffe082643608c76743541a2d5407624899216156781110c8dfcfb768c71e4
+  data.tar.gz: 0b8d08ab75ba4b13c4f9ccefc3801f1b4fd7fbd5556f1d4ff5cd217144eba55d
 SHA512:
-  metadata.gz: 9eaab64b6f06377a1021efd511c94e6a226a42c3bf9ef1d97f216cfc0684d89605e40e696e661acd7dfa50c071ce1ad1bbeaa3a16424e9b4b2bf05ef5d77fbb6
-  data.tar.gz: dc34a8f3d8953b05bfddd57850236eefabdb503bee884978da04c74b9146848064710fb8290f46d4ccf11bd55bcfb95dd08b32aa97576f21feeb9f04f79ddc64
+  metadata.gz: 178862be03081097dce0c56b342e6815b4bb42918aafefe2b3ca407fb16d269aff49b79db0147003a6608149097eb030a693bfb3806cde467726676baa6f286a
+  data.tar.gz: 1f3cecc0b993ba3e8d017935f03165197ab88414bbf82be4c7601f73ede698df8f7e9f69761b6d412de70f82bd58be7542828ea21d0e26f330f598a90689381e

data/CHANGELOG.md

@@ -7,6 +7,14 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.0] - 2026-10-13
+
+### Added
+
+- `assert_hash_attributes(hash, **expected)` assertion, applying the same comparisons to hash values
+  - Keys are looked up as given, then as strings, so symbol keys match parsed JSON
+  - A missing key fails, even when the expected value is `nil`
+
 ## [0.1.0] - 2026-09-24
 
 ### Added

data/README.md

@@ -27,7 +27,7 @@ Then run:
 bundle install
 ```
 
-Requiring the gem mixes `assert_attributes` into `Minitest::Assertions`, so it is available in every `Minitest::Test`, `ActiveSupport::TestCase`, and integration test. Bundler requires it for you in a Rails app; otherwise add `require "minitest/attributes"` to your test helper.
+Requiring the gem mixes `assert_attributes` and `assert_hash_attributes` into `Minitest::Assertions`, so it is available in every `Minitest::Test`, `ActiveSupport::TestCase`, and integration test. Bundler requires it for you in a Rails app; otherwise add `require "minitest/attributes"` to your test helper.
 
 ## Usage
 
@@ -44,6 +44,25 @@ A mismatch fails with a message such as:
 Expected Person#last_name to be "Bubblegum", but was "Abadeer"
 ```
 
+### Hashes
+
+`assert_hash_attributes` makes the same comparisons against the values of a hash. Each key is looked up as given and then as a string, so symbol keys also match parsed JSON:
+
+```ruby
+assert_hash_attributes(
+  JSON.parse(response.body),
+  "@type": "Person",
+  name: "Marceline",
+  nickname: nil
+)
+```
+
+A missing key fails with the hash's keys, even when the expected value is `nil`:
+
+```
+Expected hash to have key :nickname, but its keys were ["@type", "name"]
+```
+
 ## Development
 
 After checking out the repo, run `bin/setup` to install dependencies. Then run `bundle exec rake` to run the tests and RuboCop. You can also run `bin/console` for an interactive prompt.

data/lib/minitest/attributes/version.rb

@@ -2,6 +2,6 @@
 
 module Minitest
   module Attributes
-    VERSION = "0.1.0"
+    VERSION = "0.2.0"
   end
 end

data/lib/minitest/attributes.rb

@@ -14,52 +14,81 @@ module Minitest
   # compared within +TIME_DELTA+ seconds, and an actual value that responds to
   # +to_plain_text+ (such as an Action Text rich text) is compared as plain
   # text. Everything else falls through to +assert_equal+.
+  #
+  # +assert_hash_attributes+ applies the same comparisons to the values of a
+  # hash.
   module Attributes
     TIME_DELTA = 1
 
     def assert_attributes(record, **expected_attributes)
       expected_attributes.each do |attribute, expected_value|
-        assert_attribute(record, attribute, expected_value)
+        assert_value(
+          "#{record.class.name}##{attribute}",
+          expected_value,
+          record.public_send(attribute)
+        )
+      end
+    end
+
+    # Like +assert_attributes+, but reads each key from a hash. A key is looked
+    # up as given, then as a string, so symbol keys also match the string keys
+    # of parsed JSON:
+    #
+    #   assert_hash_attributes(JSON.parse(body), "@type": "Person", age: 12)
+    #
+    # A missing key fails, even when the expected value is +nil+.
+    def assert_hash_attributes(hash, **expected_attributes)
+      expected_attributes.each do |key, expected_value|
+        assert_hash_attribute(hash, key, expected_value)
       end
     end
 
     private
 
-    def assert_attribute(record, attribute, expected_value)
-      actual_value = record.public_send(attribute)
+    def assert_hash_attribute(hash, key, expected_value)
+      found_key = [key, key.to_s].find { |candidate| hash.key?(candidate) }
+      assert(
+        found_key,
+        "Expected hash to have key #{key.inspect}, " \
+        "but its keys were #{hash.keys.inspect}"
+      )
+
+      assert_value(
+        "hash[#{found_key.inspect}]", expected_value, hash[found_key]
+      )
+    end
 
+    def assert_value(label, expected_value, actual_value)
       if expected_value.nil?
         assert_nil(
           actual_value,
-          attribute_message(record, attribute, expected_value, actual_value)
+          value_message(label, expected_value, actual_value)
         )
       elsif expected_value.is_a?(Time)
         assert_in_delta(
           expected_value.to_f,
           actual_value.to_f,
           TIME_DELTA,
-          attribute_message(record, attribute, expected_value, actual_value)
+          value_message(label, expected_value, actual_value)
         )
       elsif actual_value.respond_to?(:to_plain_text)
         plain_actual_value = actual_value.to_plain_text
         assert_equal(
           expected_value,
           plain_actual_value,
-          attribute_message(
-            record, attribute, expected_value, plain_actual_value
-          )
+          value_message(label, expected_value, plain_actual_value)
         )
       else
         assert_equal(
           expected_value,
           actual_value,
-          attribute_message(record, attribute, expected_value, actual_value)
+          value_message(label, expected_value, actual_value)
         )
       end
     end
 
-    def attribute_message(record, attribute, expected_value, actual_value)
-      "Expected #{record.class.name}##{attribute} to be " \
+    def value_message(label, expected_value, actual_value)
+      "Expected #{label} to be " \
         "#{expected_value.inspect}, but was #{actual_value.inspect}"
     end
   end

data/sig/minitest/attributes.rbs

@@ -4,10 +4,12 @@ module Minitest
     TIME_DELTA: Integer
 
     def assert_attributes: (untyped record, **untyped expected_attributes) -> void
+    def assert_hash_attributes: (Hash[untyped, untyped] hash, **untyped expected_attributes) -> void
 
     private
 
-    def assert_attribute: (untyped record, Symbol attribute, untyped expected_value) -> void
-    def attribute_message: (untyped record, Symbol attribute, untyped expected_value, untyped actual_value) -> String
+    def assert_hash_attribute: (Hash[untyped, untyped] hash, Symbol key, untyped expected_value) -> void
+    def assert_value: (String label, untyped expected_value, untyped actual_value) -> void
+    def value_message: (String label, untyped expected_value, untyped actual_value) -> String
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: minitest-attributes
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Abdullah Hashim