oat 0.4.5 → 0.4.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b99c27fce884d038d2dcb994993171a221fe9207
-  data.tar.gz: 6c1d130acce638a3387a99f029925e38a5483c51
+  metadata.gz: a56613cc3b7d20d015369d97b0690153f7dcadf9
+  data.tar.gz: 2f786daef5e0b151100f7da50facb9654b31110d
 SHA512:
-  metadata.gz: b1f2ee9f1645746fda92ebe645083071c0cb2867766fa35ff8cc2b63a14aa297975035e02dbdf6bd5dfd2707d6acd4c15a2ab9b187cc23ea5f1ba30a48fcea81
-  data.tar.gz: cba99539507beaaa10e87339ccdf2b1dcd3ce13431b0651e1ff18ac2b13f788a8a812b09921efa7f01b478d3beff91e53c75ce170539550b396e04ad4ae9e38f
+  metadata.gz: fcedb948f276b849b4252a3955e8deac185062d5130154f188a252bb653a390cbd37b9a19fe11609b7eaa6fb4ef6f1e09dd7a9d37bc71870bdc90a519be69ed6
+  data.tar.gz: 70e5907449c358f1ebaa2b386b886abc37623b46200c785fc32202997d16bac2201a3323ebec0c9bdeb99ca20670c916448fe3c41c68fcc976737f0983782c16

data/.travis.yml

@@ -6,7 +6,6 @@ rvm:
   - 1.9.2
   - 1.8.7
   - jruby-1.7.11
-  - rbx-2.2.9
 
 gemfile:
   - gemfiles/Gemfile.as-3.0.x

data/CHANGELOG.md

@@ -0,0 +1,121 @@
+# Changelog
+
+## [v0.4.5](https://github.com/ismasan/oat/tree/v0.4.5)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.4.4...v0.4.5)
+#### 09/07/14
+- *Merged pull-request:* Fix serializer ampersand warning [\#43](https://github.com/ismasan/oat/pull/43) ([iainbeeston](https://github.com/iainbeeston))
+
+- *Merged pull-request:* Update build matrix [\#42](https://github.com/ismasan/oat/pull/42) ([iainbeeston](https://github.com/iainbeeston))
+
+- *Merged pull-request:* Update to rspec3 [\#41](https://github.com/ismasan/oat/pull/41) ([iainbeeston](https://github.com/iainbeeston))
+
+- *Closed issue:* Thread Safety [\#39](https://github.com/ismasan/oat/issues/39)
+
+## [v0.4.4](https://github.com/ismasan/oat/tree/v0.4.4)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.4.3...v0.4.4)
+#### 26/05/14
+- *Merged pull-request:* Add title addribute to siren action's fields [\#38](https://github.com/ismasan/oat/pull/38) ([erezesk](https://github.com/erezesk))
+
+- *Closed issue:* Top level json api meta [\#28](https://github.com/ismasan/oat/issues/28)
+
+## [v0.4.3](https://github.com/ismasan/oat/tree/v0.4.3)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.4.2...v0.4.3)
+#### 01/05/14
+- *Merged pull-request:* json-api: Don't add templated links to the resource [\#37](https://github.com/ismasan/oat/pull/37) ([kjg](https://github.com/kjg))
+
+## [v0.4.2](https://github.com/ismasan/oat/tree/v0.4.2)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.4.1...v0.4.2)
+#### 29/04/14
+- *Merged pull-request:* Add type attribute for siren actions [\#36](https://github.com/ismasan/oat/pull/36) ([erezesk](https://github.com/erezesk))
+
+- *Closed issue:* Errors management [\#35](https://github.com/ismasan/oat/issues/35)
+
+## [v0.4.1](https://github.com/ismasan/oat/tree/v0.4.1)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.4.0...v0.4.1)
+#### 25/04/14
+- *Merged pull-request:* Add meta property [\#32](https://github.com/ismasan/oat/pull/32) ([ahx](https://github.com/ahx))
+
+## [v0.4.0](https://github.com/ismasan/oat/tree/v0.4.0)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.3.0...v0.4.0)
+#### 07/04/14
+- *Merged pull-request:* Don't block NoMethodErrors from raising [\#31](https://github.com/ismasan/oat/pull/31) ([shekibobo](https://github.com/shekibobo))
+
+- *Closed issue:* Does this support any type of caching? [\#30](https://github.com/ismasan/oat/issues/30)
+
+## [v0.3.0](https://github.com/ismasan/oat/tree/v0.3.0)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.2.5...v0.3.0)
+#### 25/03/14
+- *Merged pull-request:* Don't allow rake 10.2 on ruby 1.8.7 [\#29](https://github.com/ismasan/oat/pull/29) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Json api link templates [\#27](https://github.com/ismasan/oat/pull/27) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Json api attribute links [\#26](https://github.com/ismasan/oat/pull/26) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Serializer from block or class update [\#16](https://github.com/ismasan/oat/pull/16) ([kjg](https://github.com/kjg))
+
+- *Closed issue:* How to serialize many records? [\#24](https://github.com/ismasan/oat/issues/24)
+
+## [v0.2.5](https://github.com/ismasan/oat/tree/v0.2.5)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.2.4...v0.2.5)
+#### 20/03/14
+- *Merged pull-request:* Json api nil entities [\#25](https://github.com/ismasan/oat/pull/25) ([kjg](https://github.com/kjg))
+
+## [v0.2.4](https://github.com/ismasan/oat/tree/v0.2.4)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.2.3...v0.2.4)
+#### 24/02/14
+- *Merged pull-request:* Allow for serializing json api resource collections into root key [\#23](https://github.com/ismasan/oat/pull/23) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Json api subent top linked [\#22](https://github.com/ismasan/oat/pull/22) ([kjg](https://github.com/kjg))
+
+## [v0.2.3](https://github.com/ismasan/oat/tree/v0.2.3)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.2.2...v0.2.3)
+#### 17/02/14
+- *Merged pull-request:* Json api sub behaviour [\#20](https://github.com/ismasan/oat/pull/20) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Add version badge to README [\#18](https://github.com/ismasan/oat/pull/18) ([shekibobo](https://github.com/shekibobo))
+
+## [v0.2.2](https://github.com/ismasan/oat/tree/v0.2.2)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.1.2...v0.2.2)
+#### 17/02/14
+- *Merged pull-request:* Test more combinations in travis [\#17](https://github.com/ismasan/oat/pull/17) ([kjg](https://github.com/kjg))
+
+- *Merged pull-request:* Make specs more accurate and using updated syntax [\#15](https://github.com/ismasan/oat/pull/15) ([shekibobo](https://github.com/shekibobo))
+
+- *Merged pull-request:* Better Context [\#14](https://github.com/ismasan/oat/pull/14) ([shekibobo](https://github.com/shekibobo))
+
+- *Merged pull-request:* Less active support [\#11](https://github.com/ismasan/oat/pull/11) ([kjg](https://github.com/kjg))
+
+- *Closed issue:* Remove activesupport dependency [\#10](https://github.com/ismasan/oat/issues/10)
+
+## [v0.1.2](https://github.com/ismasan/oat/tree/v0.1.2)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.1.1...v0.1.2)
+#### 13/02/14
+- *Merged pull-request:* Support ruby 1.8.7 [\#12](https://github.com/ismasan/oat/pull/12) ([kjg](https://github.com/kjg))
+
+- *Closed issue:* Serializing collections [\#9](https://github.com/ismasan/oat/issues/9)
+
+## [v0.1.1](https://github.com/ismasan/oat/tree/v0.1.1)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.1.0...v0.1.1)
+#### 26/01/14
+- *Merged pull-request:* Don't add invalid link relations to HAL output [\#8](https://github.com/ismasan/oat/pull/8) ([shekibobo](https://github.com/shekibobo))
+
+## [v0.1.0](https://github.com/ismasan/oat/tree/v0.1.0)
+[Full Changelog](https://github.com/ismasan/oat/compare/v0.0.1...v0.1.0)
+#### 14/01/14
+- *Merged pull-request:* Add Serializer#map\_properties to DRY property definitions [\#6](https://github.com/ismasan/oat/pull/6) ([shekibobo](https://github.com/shekibobo))
+
+- *Merged pull-request:* Add action support for Siren. [\#4](https://github.com/ismasan/oat/pull/4) ([SebastianEdwards](https://github.com/SebastianEdwards))
+
+- *Merged pull-request:* Don't try to serialize nil with an entity serializer [\#3](https://github.com/ismasan/oat/pull/3) ([shekibobo](https://github.com/shekibobo))
+
+- *Merged pull-request:* Fix a small typo in the README [\#2](https://github.com/ismasan/oat/pull/2) ([stevenharman](https://github.com/stevenharman))
+
+- *Closed issue:* DRY property declaration [\#5](https://github.com/ismasan/oat/issues/5)
+
+## [v0.0.1](https://github.com/ismasan/oat/tree/v0.0.1)
+#### 18/11/13
+- *Merged pull-request:* Fix a few spelling and grammar errors [\#1](https://github.com/ismasan/oat/pull/1) ([leemachin](https://github.com/leemachin))
+
+
+
+\* *This changelog was generated by [github_changelog_generator](https://github.com/skywinder/Github-Changelog-Generator)*

data/README.md

@@ -162,7 +162,7 @@ adapter Oat::Adapters::Siren
 ```
 At the moment Oat ships with adapters for [HAL](http://stateless.co/hal_specification.html), [Siren](https://github.com/kevinswiber/siren) and [JsonAPI](http://jsonapi.org/), but it's easy to write your own.
 
-Note: Oat adapters are not *required* by default. Your code should explicitely require the ones it needs:
+Note: Oat adapters are not *required* by default. Your code should explicitly require the ones it needs:
 
 ```ruby
 # HAL
@@ -183,7 +183,7 @@ ProductSerializer.new(product, nil, Oat::Adapters::HAL)
 
 That means that your app could switch adapters on run time depending, for example, on the request's `Accept` header or anything you need.
 
-Note: a different library could be written to make adapter-switching auto-magical for different frameworks, for example using [Responders](http://api.rubyonrails.org/classes/ActionController/Responder.html) in Rails.
+Note: a different library could be written to make adapter-switching auto-magical for different frameworks, for example using [Responders](http://api.rubyonrails.org/classes/ActionController/Responder.html) in Rails. Also see [Rails Integration](#rails-integration).
 
 ## Nested serializers
 
@@ -198,8 +198,10 @@ class AccountSerializer < Oat::Serializer
     property :status, item.status
     # user entities
     entities :users, item.users do |user, user_serializer|
-      user_serializer.name user.name
-      user_serializer.email user.email
+      user_serializer.properties do |props|
+        props.name user.name
+        props.email user.email
+      end
     end
   end
 end
@@ -277,6 +279,12 @@ The way sub-entities are rendered in the final payload is up to the adapter. In
 }
 ```
 
+## Nested serializers when using the `JsonAPI` adapter
+
+Collections are easy to express in HAL and Siren because they're no different from any other "entity". JsonAPI, however, doesn't work that way. In JsonAPI there's a distinction between "side-loaded" entities and the collection that is the subject of the resource. For this reason a `collection` method was added to the Oat DSL specifically for use with the `JsonAPI` adapter.
+
+In the `HAL` and `Siren` adapters, `collection` is aliased to `entities`, but in the `JsonAPI` adapter, it sets the resource's main collection array as per the spec. `entities` keep the current behaviour of side-loading entities in the resource.
+
 ## Subclassing
 
 Serializers can be subclassed, for example if you want all your serializers to share the same adapter or add shared helper methods.
@@ -577,6 +585,68 @@ The result for the SocialHalAdapter is:
 
 You can take a look at [the built-in Hypermedia adapters](https://github.com/ismasan/oat/tree/master/lib/oat/adapters) for guidance.
 
+## Rails Integration
+The Rails responder functionality works out of the box with Oat when the
+requests specify JSON as their response format via a header
+`Accept: application/json` or query parameter `format=json`.
+
+However, if you want to also support the mime type of your Hypermedia
+format of choice, it will require a little bit of code.
+
+The example below uses Siren, but the same pattern can be used for HAL and
+JsonAPI.
+
+Register the Siren mime-type and a responder:
+
+```ruby
+# config/initializers/oat.rb
+Mime::Type.register 'application/vnd.siren+json', :siren
+
+ActionController::Renderers.add :siren do |resource, options|
+  self.content_type ||= Mime[:siren]
+  resource.to_siren
+end
+```
+
+In your controller, add `:siren` to the `respond_to`:
+
+```ruby
+class UsersController < ApplicationController
+  respond_to :siren, :json
+
+  def show
+    user = User.find(params[:id])
+    respond_with UserSerializer.new(user)
+  end
+end
+```
+
+Finally, add a `to_siren` method to your serializer:
+
+```ruby
+class UserSerializer < Oat::Serializer
+  adapter Oat::Adapters::Siren
+
+  schema do
+    property :name, item.name
+    property :email, item.name
+  end
+
+  def to_siren
+    to_json
+  end
+end
+```
+
+Now http requests that specify the Siren mime type will work as
+expected.
+
+**NOTE**
+The key thing that makes this all hang together is that the
+object passed to `respond_with` implements a `to_FORMAT` method, where
+`FORMAT` is the symbol used to register the mime type and responder
+(`:siren`).  Without it, Rails will not invoke your responder block.
+
 ## Installation
 
 Add this line to your application's Gemfile:

data/lib/oat/adapters/hal.rb

@@ -3,7 +3,11 @@ module Oat
   module Adapters
     class HAL < Oat::Adapter
       def link(rel, opts = {})
-        data[:_links][rel] = opts if opts[:href]
+        if opts.is_a?(Array)
+          data[:_links][rel] = opts.select { |link_obj| link_obj.include?(:href) }
+        else
+          data[:_links][rel] = opts if opts[:href]
+        end
       end
 
       def properties(&block)
@@ -16,19 +20,30 @@ module Oat
 
       alias_method :meta, :property
 
+      def rel(rels)
+        # no-op to maintain interface compatibility with the Siren adapter
+      end
+
       def entity(name, obj, serializer_class = nil, context_options = {}, &block)
         entity_serializer = serializer_from_block_or_class(obj, serializer_class, context_options, &block)
-        data[:_embedded][name] = entity_serializer ? entity_serializer.to_hash : nil
+        data[:_embedded][entity_name(name)] = entity_serializer ? entity_serializer.to_hash : nil
       end
 
       def entities(name, collection, serializer_class = nil, context_options = {}, &block)
-        data[:_embedded][name] = collection.map do |obj|
+        data[:_embedded][entity_name(name)] = collection.map do |obj|
           entity_serializer = serializer_from_block_or_class(obj, serializer_class, context_options, &block)
           entity_serializer ? entity_serializer.to_hash : nil
         end
       end
       alias_method :collection, :entities
 
+      def entity_name(name)
+        # entity name may be an array, but HAL only uses the first
+        name.respond_to?(:first) ? name.first : name
+      end
+
+      private :entity_name
+
     end
   end
 end

data/lib/oat/adapters/json_api.rb

@@ -19,6 +19,10 @@ module Oat
         @meta = {}
       end
 
+      def rel(rels)
+        # no-op to maintain interface compatibility with the Siren adapter
+      end
+
       def type(*types)
         @root_name = types.first.to_s.pluralize.to_sym
       end
@@ -69,15 +73,21 @@ module Oat
         ent = serializer_from_block_or_class(obj, serializer_class, context_options, &block)
         if ent
           ent_hash = ent.to_hash
-          entity_hash[name.to_s.pluralize.to_sym] ||= []
-          data[:links][name] = ent_hash[:id]
-          entity_hash[name.to_s.pluralize.to_sym] << ent_hash
+          _name = entity_name(name)
+          link_name = _name.to_s.pluralize.to_sym
+          data[:links][_name] = ent_hash[:id]
+
+          entity_hash[link_name] ||= []
+          unless entity_hash[link_name].include? ent_hash
+            entity_hash[link_name] << ent_hash
+          end
         end
       end
 
       def entities(name, collection, serializer_class = nil, context_options = {}, &block)
         return if collection.nil? || collection.empty?
-        link_name = name.to_s.pluralize.to_sym
+        _name = entity_name(name)
+        link_name = _name.to_s.pluralize.to_sym
         data[:links][link_name] = []
 
         collection.each do |obj|
@@ -86,11 +96,20 @@ module Oat
           if ent
             ent_hash = ent.to_hash
             data[:links][link_name] << ent_hash[:id]
-            entity_hash[link_name] << ent_hash
+            unless entity_hash[link_name].include? ent_hash
+              entity_hash[link_name] << ent_hash
+            end
           end
         end
       end
 
+      def entity_name(name)
+        # entity name may be an array, but JSON API only uses the first
+        name.respond_to?(:first) ? name.first : name
+      end
+
+      private :entity_name
+
       def collection(name, collection, serializer_class = nil, context_options = {}, &block)
         @treat_as_resource_collection = true
         data[:resource_collection] = [] unless data[:resource_collection].is_a?(Array)

data/lib/oat/adapters/siren.rb

@@ -10,6 +10,13 @@ module Oat
         data[:actions] = []
       end
 
+      # Sub-Entities have a required rel attribute
+      # https://github.com/kevinswiber/siren#rel
+      def rel(rels)
+        # rel must be an array.
+        data[:rel] = Array(rels)
+      end
+
       def type(*types)
         data[:class] = types
       end
@@ -30,7 +37,15 @@ module Oat
 
       def entity(name, obj, serializer_class = nil, context_options = {}, &block)
         ent = serializer_from_block_or_class(obj, serializer_class, context_options, &block)
-        data[:entities] << ent.to_hash if ent
+        if ent
+          # use the name as the sub-entities rel to the parent resource.
+          ent.rel(name)
+          ent_hash = ent.to_hash
+
+          unless data[:entities].include? ent_hash
+            data[:entities] << ent_hash
+          end
+        end
       end
 
       def entities(name, collection, serializer_class = nil, context_options = {}, &block)

data/lib/oat/version.rb

@@ -1,3 +1,3 @@
 module Oat
-  VERSION = "0.4.5"
+  VERSION = "0.4.6"
 end

data/spec/adapters/hal_spec.rb

@@ -81,5 +81,23 @@ describe Oat::Adapters::HAL do
         )
       end
     end
+
+    let(:array_of_linked_objects_serializer) {
+      array_of_linked_objects_serializer_class.new(friendly_user, nil, Oat::Adapters::HAL)
+    }
+    let(:linked_objects_hash) { array_of_linked_objects_serializer.to_hash }
+
+    context 'with an array of linked objects' do
+      it 'produces a HAL-compliant hash' do
+        expect(linked_objects_hash.fetch(:_links).fetch(:related).size).to be 3
+        expect(linked_objects_hash.fetch(:_links)).to include(
+          :related => [
+            {:type=>"friend", :href=>"http://foo.bar.com/1"},
+            {:type=>"friend", :href=>"http://foo.bar.com/2"},
+            {:type=>"friend", :href=>"http://foo.bar.com/3"}
+          ]
+        )
+      end
+    end
   end
 end

data/spec/adapters/json_api_spec.rb

@@ -84,7 +84,10 @@ describe Oat::Adapters::JsonAPI do
 
       context 'using #entity' do
         subject(:linked_managers){ hash.fetch(:linked).fetch(:managers) }
-        its(:size) { should eq(1) }
+
+        it "does not duplicate an entity that is associated with 2 objects" do
+          expect(linked_managers.size).to eq(1)
+        end
 
         it "contains the correct properties and links" do
           expect(linked_managers.first).to include(
@@ -313,7 +316,10 @@ describe Oat::Adapters::JsonAPI do
 
         context 'sub entity' do
           subject(:linked_managers){ collection_hash.fetch(:linked).fetch(:managers) }
-          its(:size) { should eq(1) }
+
+          it "does not duplicate an entity that is associated with multiple objects" do
+            expect(linked_managers.size).to eq(1)
+          end
 
           it "contains the correct properties and links" do
             expect(linked_managers.first).to include(

data/spec/adapters/siren_spec.rb

@@ -45,6 +45,10 @@ describe Oat::Adapters::Siren do
         :href => "http://foo.bar.com/#{friend.id}"
       )
 
+      # sub-entity rel is an array, so it may have multiple values
+      expect(embedded_friends.first.fetch(:rel)).to include(:friends)
+      expect(embedded_friends.first.fetch(:rel)).to include('http://example.org/rels/person')
+
       embedded_managers = hash.fetch(:entities).select{ |o| o[:class].include? "manager" }
       expect(embedded_managers.size).to be 1
       expect(embedded_managers.first.fetch(:properties)).to include(
@@ -56,6 +60,7 @@ describe Oat::Adapters::Siren do
         :rel => [:self],
         :href => "http://foo.bar.com/#{manager.id}"
       )
+      expect(embedded_managers.first.fetch(:rel)).to include(:manager)
 
       # action close_account
       actions = hash.fetch(:actions)

data/spec/fixtures.rb

@@ -3,8 +3,9 @@ module Fixtures
   def self.included(base)
     base.let(:user_class) { Struct.new(:name, :age, :id, :friends, :manager) }
     base.let(:friend) { user_class.new('Joe', 33, 2, []) }
-    base.let(:manager) { user_class.new('Jane', 29, 3, []) }
+    base.let(:manager) { user_class.new('Jane', 29, 3, [friend]) }
     base.let(:user) { user_class.new('Ismael', 35, 1, [friend], manager) }
+    base.let(:friendly_user) { user_class.new('Jeff', 33, 1, [friend, manager, user]) }
     base.let(:serializer_class) do
       Class.new(Oat::Serializer) do
         klass = self
@@ -23,7 +24,7 @@ module Fixtures
             attrs.message_from_above context[:message]
           end
 
-          entities :friends, item.friends, klass, :message => "Merged into parent's context"
+          entities [:friends, 'http://example.org/rels/person'], item.friends, klass, :message => "Merged into parent's context"
 
           entity :manager, item.manager do |manager, s|
             s.type 'manager'
@@ -33,6 +34,8 @@ module Fixtures
               attrs.name manager.name
               attrs.age manager.age
             end
+
+            entities [:friends, 'http://example.org/rels/person'], item.friends, klass, :message => "Merged into parent's context"
           end
 
           if adapter.respond_to?(:action)
@@ -50,6 +53,24 @@ module Fixtures
           end
         end
 
+        def url_for(id)
+          "http://foo.bar.com/#{id}"
+        end
+      end
+    end
+    base.let(:array_of_linked_objects_serializer_class) do
+      Class.new(Oat::Serializer) do
+        schema do
+          type 'user'
+
+          link :self, :href => url_for(item.id)
+          link :related, item.friends.map { |friend|
+            {:type => 'friend', :href => url_for(friend.id)}
+          }.sort_by { |link_obj|
+            link_obj[:href]
+          }
+        end
+
         def url_for(id)
           "http://foo.bar.com/#{id}"
         end

metadata

@@ -1,83 +1,83 @@
 --- !ruby/object:Gem::Specification
 name: oat
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.4.6
 platform: ruby
 authors:
 - Ismael Celis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-09 00:00:00.000000000 Z
+date: 2015-02-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
   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: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rspec-its
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: Oat helps you separate your API schema definitions from the underlying
@@ -89,9 +89,10 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
-- .travis.yml
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE
 - LICENSE.txt
@@ -130,17 +131,17 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.3
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Adapters-based serializers with Hypermedia support