jsonapi-rspec 0.0.4 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b47e58f3f6448c75638d51bf9b1e71158cf0ba27e9ad2ef3de757eefef637cff
-  data.tar.gz: cb6760bd5fbcfd5302f8b53cca011588fedbc591674859a08c4272b820297ba4
+  metadata.gz: 404100d143c51997a54c90beae1d40c2f30c38c62d83358c3b52147ca2528a9f
+  data.tar.gz: 8c2abd999070e75c839193c513e7c443b65c36c7d31b2e9bd8c27a193a8aa0e1
 SHA512:
-  metadata.gz: bd3a469d0c1bdb3655f8d53b35a1dd4e65cb90d26ce7bd5dc8c3d9d8b391e352fa405fe76f9b49dc0943d263c6823abc6fa70904c3b7f4a420dc6ad53d62ea26
-  data.tar.gz: 8f2965c6f53ad2c2e92de9c550390eb964b07f3dfad58e3ded6e0527da5f61eb8aab126eeb758d34a53df36cf3e773a8b76ec40301c8022906950a2707bccfac
+  metadata.gz: 2f69b0906838b7409d56adee6012bf83583b6f271394e8e3a4a4a171821df9b865551e58fea814f799afdf27084a01ca7d4be409a20610c528fc748dd61134b9
+  data.tar.gz: 3a9c8bc87b5e83db4279bd7b286892a3b4869dd3fbe6bf44b47dd172a25fb2349cdad018b7d6d54e3d4119e9121e2601910bb34d91552c795927ac137eaa86fe

data/README.md

@@ -2,11 +2,6 @@
 
 RSpec matchers for [JSON API](http://jsonapi.org).
 
-## Resources
-
-* Chat: [gitter](http://gitter.im/jsonapi-rb)
-* Twitter: [@jsonapirb](http://twitter.com/jsonapirb)
-
 ## Installation
 
 Add the following to your application's Gemfile:
@@ -25,8 +20,10 @@ Add to your `spec/spec_helpers.rb`:
 require 'jsonapi/rspec'
 
 RSpec.configure do |config|
-  # ...
   config.include JSONAPI::RSpec
+
+  # Support for documents with mixed string/symbol keys. Disabled by default.
+  config.jsonapi_indifferent_hash = true
 end
 ```
 
@@ -40,14 +37,42 @@ Available matchers:
 * `expect(document['data']).to have_jsonapi_attributes(:name, :email, :country).exactly`
 * `expect(document['data']).to have_attribute(:name).with_value('Lucas')`
 * `expect(document['data']).to have_relationships(:posts, :comments)`
+* `expect(document['data']).to have_relationships(:posts, :comments, :likes).exactly`
 * `expect(document['data']).to have_relationship(:posts).with_data([{ 'id' => '1', 'type' => 'posts' }])`
 * `expect(document['data']['relationships']['posts']).to have_links(:self, :related)`
 * `expect(document['data']).to have_link(:self).with_value('http://api.example.com/users/12')`
 * `expect(document).to have_meta`
 * `expect(document).to have_meta('foo' => 'bar')`
+* `expect(document).to have_meta('foo' => 'bar', 'fum' => 'baz').exactly`
 * `expect(document).to have_jsonapi_object`
 * `expect(document).to have_jsonapi_object('version' => '1.0')`
 
+### On matcher arguments...
+
+**Note**: JSON:API spec requires JSON documents, thus attribute, relationship
+and link matcher arguments will always be converted into strings for
+consistency!!!
+
+Basically, the tests bellow are absolutely equal:
+
+```ruby
+expect(document['data']).to have_id(12)
+expect(document['data']).to have_id('12')
+
+expect(document['data']).to have_type(:users)
+expect(document['data']).to have_type('users')
+
+expect(document['data']).to have_jsonapi_attributes(:name, :email)
+expect(document['data']).to have_jsonapi_attributes('name', 'email')
+```
+
+The JSON:API spec also requires the `id` and `type` to be strings, so any other
+argument passed will also be converted into a string.
+
+If the document you are trying to test has mixed string/symbol keys, just
+configure matchers to be indifferent in that regard, using the
+`jsonapi_indifferent_hash = true` configuration option.
+
 ## Advanced examples
 
 Checking for an included resource:

data/lib/jsonapi/rspec.rb

@@ -1,4 +1,6 @@
+require 'json'
 require 'rspec/matchers'
+require 'rspec/core'
 require 'jsonapi/rspec/id'
 require 'jsonapi/rspec/type'
 require 'jsonapi/rspec/attributes'
@@ -7,6 +9,10 @@ require 'jsonapi/rspec/links'
 require 'jsonapi/rspec/meta'
 require 'jsonapi/rspec/jsonapi_object'
 
+RSpec.configure do |c|
+  c.add_setting :jsonapi_indifferent_hash, default: false
+end
+
 module JSONAPI
   module RSpec
     include Id
@@ -16,5 +22,15 @@ module JSONAPI
     include Links
     include Meta
     include JsonapiObject
+
+    def self.as_indifferent_hash(doc)
+      return doc unless ::RSpec.configuration.jsonapi_indifferent_hash
+
+      if doc.respond_to?(:with_indifferent_access)
+        return doc.with_indifferent_access
+      end
+
+      JSON.parse(JSON.generate(doc))
+    end
   end
 end

data/lib/jsonapi/rspec/attributes.rb

@@ -1,20 +1,49 @@
 module JSONAPI
   module RSpec
     module Attributes
-      ::RSpec::Matchers.define :have_attribute do |attr|
-        match do |actual|
-          (actual['attributes'] || {}).key?(attr.to_s) &&
-            (!@val_set || actual['attributes'][attr.to_s] == @val)
+      ::RSpec::Matchers.define :have_attribute do |attr_name|
+        match do |doc|
+          doc = JSONAPI::RSpec.as_indifferent_hash(doc)
+          attributes_node = doc['attributes']
+
+          return false unless attributes_node
+
+          @existing_attributes = attributes_node.keys
+          @has_attribute = attributes_node.key?(attr_name.to_s)
+          @actual = attributes_node[attr_name.to_s]
+
+          return @actual == @expected if @has_attribute && @should_match_value
+
+          @has_attribute
         end
 
-        chain :with_value do |val|
-          @val_set = true
-          @val = val
+        chain :with_value do |expected_value|
+          @should_match_value = true
+          @expected = expected_value
         end
+
+        description do
+          result = "have attribute #{attr_name.inspect}"
+          result << " with value #{@expected.inspect}" if @should_match_value
+          result
+        end
+
+        failure_message do |_doc|
+          if @actual
+            "expected `#{attr_name}` attribute " \
+              "to have value `#{@expected}` but was `#{@actual}`"
+          else
+            "expected attributes to include `#{attr_name}`. " \
+              "Actual attributes were #{@existing_attributes}"
+          end
+        end
+
+        diffable
       end
 
       ::RSpec::Matchers.define :have_jsonapi_attributes do |*attrs|
         match do |actual|
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
           return false unless actual.key?('attributes')
 
           counted = (attrs.size == actual['attributes'].size) if @exactly

data/lib/jsonapi/rspec/id.rb

@@ -2,7 +2,9 @@ module JSONAPI
   module RSpec
     module Id
       ::RSpec::Matchers.define :have_id do |expected|
-        match { |actual| actual['id'] == expected }
+        match do |actual|
+          JSONAPI::RSpec.as_indifferent_hash(actual)['id'] == expected
+        end
       end
     end
   end

data/lib/jsonapi/rspec/jsonapi_object.rb

@@ -3,8 +3,10 @@ module JSONAPI
     module JsonapiObject
       ::RSpec::Matchers.define :have_jsonapi_object do |val|
         match do |actual|
-          actual.key?('jsonapi') &&
-            (!val || actual['jsonapi'] == val)
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
+          val = JSONAPI::RSpec.as_indifferent_hash(val)
+
+          actual.key?('jsonapi') && (!val || actual['jsonapi'] == val)
         end
       end
     end

data/lib/jsonapi/rspec/links.rb

@@ -3,6 +3,7 @@ module JSONAPI
     module Links
       ::RSpec::Matchers.define :have_link do |link|
         match do |actual|
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
           actual.key?('links') && actual['links'].key?(link.to_s) &&
             (!@val_set || actual['links'][link.to_s] == @val)
         end
@@ -15,6 +16,7 @@ module JSONAPI
 
       ::RSpec::Matchers.define :have_links do |*links|
         match do |actual|
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
           return false unless actual.key?('links')
 
           links.all? { |link| actual['links'].key?(link.to_s) }

data/lib/jsonapi/rspec/meta.rb

@@ -3,8 +3,18 @@ module JSONAPI
     module Meta
       ::RSpec::Matchers.define :have_meta do |val|
         match do |actual|
-          actual.key?('meta') &&
-            (!val || actual['meta'] == val)
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
+          return false unless actual.key?('meta')
+          return true unless val
+
+          val = JSONAPI::RSpec.as_indifferent_hash(val)
+          return false unless val <= actual['meta']
+
+          !@exactly || (@exactly && val.size == actual['meta'].size)
+        end
+
+        chain :exactly do
+          @exactly = true
         end
       end
     end

data/lib/jsonapi/rspec/relationships.rb

@@ -3,6 +3,7 @@ module JSONAPI
     module Relationships
       ::RSpec::Matchers.define :have_relationship do |rel|
         match do |actual|
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
           return false unless (actual['relationships'] || {}).key?(rel.to_s)
 
           !@data_set || actual['relationships'][rel.to_s]['data'] == @data_val
@@ -10,7 +11,7 @@ module JSONAPI
 
         chain :with_data do |val|
           @data_set = true
-          @data_val = val
+          @data_val = JSONAPI::RSpec.as_indifferent_hash(val)
         end
 
         failure_message do |actual|
@@ -25,9 +26,17 @@ module JSONAPI
 
       ::RSpec::Matchers.define :have_relationships do |*rels|
         match do |actual|
+          actual = JSONAPI::RSpec.as_indifferent_hash(actual)
           return false unless actual.key?('relationships')
 
-          rels.all? { |rel| actual['relationships'].key?(rel) }
+          counted = (rels.size == actual['relationships'].keys.size) if @exactly
+
+          rels.map(&:to_s).all? { |rel| actual['relationships'].key?(rel) } \
+            && (counted == @exactly)
+        end
+
+        chain :exactly do
+          @exactly = true
         end
       end
     end

data/lib/jsonapi/rspec/type.rb

@@ -2,7 +2,9 @@ module JSONAPI
   module RSpec
     module Type
       ::RSpec::Matchers.define :have_type do |expected|
-        match { |actual| actual['type'] == expected }
+        match do |actual|
+          JSONAPI::RSpec.as_indifferent_hash(actual)['type'] == expected.to_s
+        end
       end
     end
   end

metadata

@@ -1,15 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: jsonapi-rspec
 version: !ruby/object:Gem::Version
-  version: 0.0.4
+  version: 0.0.9
 platform: ruby
 authors:
 - Lucas Hosseini
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-03-26 00:00:00.000000000 Z
+date: 2020-08-07 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: rspec-core
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec-expectations
   requirement: !ruby/object:Gem::Requirement
@@ -115,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.1
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: RSpec matchers for JSON API.