hal-client 3.1.2 → 3.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: b01e2f92e2ff7241a7b3b9af4e040792ce9254ef
+  data.tar.gz: 70adee990ffa32582f0e40836353746066cf3478
+SHA512:
+  metadata.gz: 2ae965fff453c3252769221d653689da092c984fa2e30c47c1696b09ab9504ea13e8cde54a82d265e601a03248f44fe85b5d12245380a4795eff685bf1aa8cf3
+  data.tar.gz: 1466db8f6c04ed59b314b15c996c6c118646989819a98bdac069d3e15bcf0a037052c1655156b8ce1479b317e052670d9e98bcaca652ab3427a406d1321a7b23

data/README.md

@@ -31,7 +31,7 @@ In the example above `item` is the link rel. The `#related` method extracts embe
     all_the_authors.first.property("name")
     # => "Bob Smith"
 
-#### Request timing
+#### Request evaluation order
 
 If the `author` relationship was a regular link (that is, not embedded) in the above example the HTTP GET to retrieve Bob's representation from the server does not happen until the `#property` method is called. This lazy dereferencing allows for working with efficiently with larger relationship sets.
 
@@ -74,15 +74,6 @@ All `HalClient::Representation`s exposed an `#href` attribute which is its ident
     blog['title'] # => "Some Person's Blog"
     blog['item']  # =>  #<RepresentationSet:...>
 
-### POST requests
-
-HalClient supports POST requests to remote resources via it's `#post` method.
-
-    blog.post(new_article_as_hal_json_str)
-    #=> #<Representation: http://blog.me>
-
-The argument to post may be `String` or any object that responds to `#to_hal`. Additional options may be passed to change the content type of the post, etc.
-
 ### Paged collections
 
 HalClient provides a high level abstraction for paged collections encoded using [standard `item`, `next` and `prev` link relations](http://tools.ietf.org/html/rfc6573).
@@ -94,6 +85,51 @@ HalClient provides a high level abstraction for paged collections encoded using
 
 If the collection is paged this will navigate to the next page after yielding all the items on the current page. `HalClient::Collection` is `Enumerable` so all your favorite collection methods are available.
 
+### PUT/POST/PATCH requests
+
+HalClient supports PUT/POST/PATCH requests to remote resources via it's `#put`, `#post` and `#patch` methods, respectively.
+
+    blog.put(update_article_as_hal_json_str)
+    #=> #<Representation: http://blog.me>
+
+    blog.post(new_article_as_hal_json_str)
+    #=> #<Representation: http://blog.me>
+
+    blog.patch(diffs_of_article_as_hal_json_str)
+    #=> #<Representation: http://blog.me>
+
+The first argument to `#put`, `#post` and `#patch` may be a `String` or any object that responds to `#to_hal`. Additional options may be passed to change the content type of the post, etc.
+
+### PUT requests
+
+HalClient supports PUT requests to remote resources via it's `#put` method.
+
+    blog.put(new_article_as_hal_json_str)
+    #=> #<Representation: http://blog.me>
+
+The argument to post may be `String` or any object that responds to `#to_hal`. Additional options may be passed to change the content type of the post, etc.
+
+### Editing representation
+
+HalClient supports editing of representations. This is useful when
+creating resources from a template or updating resources. For example,
+consider a resource whose "author" relationship we want to update to
+point the author's new profile page.
+
+
+```ruby
+doc = HalClient.get("http://example.com/somedoc")
+improved_doc =
+  HalClient::RepresentationEditor.new(doc)                              # create an editor
+    .reject_related("author") { |it| it.property("name") == "John Doe"} # unlink Johe Doe's old page
+    .add_link("author", "http://example.com/john-doe")                  # add link to his new page
+
+doc.put(improved_doc)                                                   # save changes to server
+
+```
+
+This removes "John Plagerist" from the documents list of authors and then performs an HTTP PUT request with the updated document.
+
 ### Custom media types
 
 If the API uses one or more a custom mime types we can specify that they be included in the `Accept` header field of each request.

data/lib/hal_client/representation.rb

@@ -38,6 +38,22 @@ class HalClient
       @hal_client.post(href, data, options)
     end
 
+    # Puts a `Representation` or `String` to this resource.
+    #
+    # data - a `String` or an object that responds to `#to_hal`
+    # options - set of options to pass to `HalClient#put`
+    def put(data, options={})
+      @hal_client.put(href, data, options)
+    end
+
+    # Patchs a `Representation` or `String` to this resource.
+    #
+    # data - a `String` or an object that responds to `#to_hal`
+    # options - set of options to pass to `HalClient#patch`
+    def patch(data, options={})
+      @hal_client.patch(href, data, options)
+    end
+
     # Returns true if this representation contains the specified
     # property.
     #
@@ -191,12 +207,9 @@ class HalClient
     def to_json
       raw.to_json
     end
+    alias_method :to_hal, :to_json
 
-    protected
-    attr_reader :hal_client
-
-    MISSING = Object.new
-
+    # Internal: Returns parsed json document
     def raw
       if @raw.nil? && @href
         (fail "unable to make requests due to missing hal client") unless hal_client
@@ -206,6 +219,15 @@ class HalClient
       @raw
     end
 
+    # Internal: Returns the HalClient used to retrieve this
+    # representation
+    attr_reader :hal_client
+
+    protected
+
+    MISSING = Object.new
+
+
     def links
       @links ||= LinksSection.new raw.fetch("_links"){{}}
     end

data/lib/hal_client/representation_editor.rb

@@ -0,0 +1,138 @@
+require 'hal_client'
+require 'forwardable'
+
+class HalClient
+
+  # Provides ability to edit a representation. Editing a
+  # representation is useful in writable APIs as a way to update
+  # resources.
+  #
+  # This class will not actually modify the underlying representation
+  # in any way.
+  #
+  # Example:
+  #
+  # ```ruby
+  #   altered_doc = HalClient::RepresentationEditor.new(some_doc)
+  #     .reject_relate("author") { |it| it["name"]  = "John Plagiarist" }
+  # ```
+  class RepresentationEditor
+    extend Forwardable
+
+    # Initialize a new representation editor.
+    #
+    # a_representation - The representation from which you want to
+    #   start. This object will *not* be modified!
+    # raw - Not for public use! Used internally for handling multi-
+    #   staged changes.
+    def initialize(a_representation, raw = a_representation.raw)
+      @orig_repr = a_representation
+      @raw = raw
+    end
+
+    # Returns the raw json representation of this representation
+    def to_json
+      raw.to_json
+    end
+    alias_method :to_hal, :to_json
+
+    # Returns a RepresentationEditor for a representation like the
+    # current one but without the specified links and/or embeddeds.
+    #
+    # rel - The relationship type to remove or filter
+    # blk - When given only linked and embedded resource for whom
+    #   the block returns true will be rejected.
+    #
+    # Yields Representation of the target for each link/embedded.
+    def reject_related(rel, &blk)
+      reject_links(rel, &blk).reject_embedded(rel, &blk)
+    end
+
+    # Returns a RepresentationEditor for a representation like the
+    # current one but without the specified links.
+    #
+    # rel - The relationship type to remove or filter
+    # blk - When given only links to resources for whom
+    #   the block returns true will be rejected.
+    #
+    # Yields Representation of the target for each link.
+    def reject_links(rel, &blk)
+      reject_from_section("_links",
+                          rel,
+                          ->(l) {Representation.new(href: l["href"],
+                                                    hal_client: hal_client)},
+                          blk)
+    end
+
+    # Returns a RepresentationEditor for a representation like the
+    # current one but without the specified embedded resources.
+    #
+    # rel - The relationship type to remove or filter
+    # blk - When given only embedded resources for whom
+    #   the block returns true will be rejected.
+    #
+    # Yields Representation of the target for each embedded.
+    def reject_embedded(rel, &blk)
+      reject_from_section("_embedded",
+                          rel,
+                          ->(e) {Representation.new(parsed_json: e,
+                                                    hal_client: hal_client)},
+                          blk)
+    end
+
+    # Returns a RepresentationEditor exactly like this one except that
+    # is has an additional link to the specified target with the
+    # specified rel.
+    #
+    # rel - The type of relationship this link represents
+    # target - URL of the target of the link
+    # opts
+    #   :templated - is this link templated? Default: false
+    def add_link(rel, target, opts={})
+      templated = opts.fetch(:templated, false)
+      
+      link_obj = { "href" => target.to_s }
+      link_obj = link_obj.merge("templated" => true) if templated
+
+      with_new_link = Array(raw.fetch("_links", {}).fetch(rel, [])) + [link_obj]
+      updated_links_section =  raw.fetch("_links", {}).merge(rel => with_new_link)
+
+      self.class.new(orig_repr, raw.merge("_links" => updated_links_section))
+    end
+
+    protected
+
+    attr_reader :orig_repr, :raw
+
+    def Array(thing)
+      if Hash === thing
+        [thing]
+      else
+        Kernel.Array(thing)
+      end
+    end
+
+    def hal_client
+      orig_repr.hal_client
+    end
+
+    def reject_from_section(name, rel, coercion, filter=nil)
+      return self unless raw.fetch(name, {}).has_key?(rel)
+
+      filtered_rel = if filter
+        [raw[name].fetch(rel,[])].flatten
+          .reject{|it| filter.call(coercion.call(it)) }
+      else
+        []
+      end
+
+      new_sec = if filtered_rel.empty?
+                  raw[name].reject{|k,_| rel == k}
+                else
+                  raw[name].merge(rel => filtered_rel )
+                end
+
+      self.class.new(orig_repr, raw.merge(name => new_sec))
+    end
+  end
+end

data/lib/hal_client/representation_set.rb

@@ -49,6 +49,28 @@ class HalClient
       first.post(data, options)
     end
 
+    # Put a `Representation` or `String` to the resource.
+    #
+    # NOTE: This only works for a single representation.
+    #
+    # data - a `String` or an object that responds to `#to_hal`
+    # options - set of options to pass to `HalClient#put`
+    def put(data, options={})
+      raise NotImplementedError, "We only puts to singular resources." if count > 1
+      first.put(data, options)
+    end
+
+    # Patch a `Representation` or `String` to the resource.
+    #
+    # NOTE: This only works for a single representation.
+    #
+    # data - a `String` or an object that responds to `#to_hal`
+    # options - set of options to pass to `HalClient#patch`
+    def patch(data, options={})
+      raise NotImplementedError, "We only patchs to singular resources." if count > 1
+      first.patch(data, options)
+    end
+
     protected
 
     attr_reader :reprs

data/lib/hal_client/version.rb

@@ -1,3 +1,3 @@
 class HalClient
-  VERSION = "3.1.2"
+  VERSION = "3.2.0"
 end

data/lib/hal_client.rb

@@ -15,6 +15,8 @@ class HalClient
   autoload :HttpClientError, 'hal_client/errors'
   autoload :HttpServerError, 'hal_client/errors'
 
+  autoload :RepresentationEditor, 'hal_client/representation_editor'
+
   # Initializes a new client instance
   #
   # options - hash of configuration options
@@ -79,6 +81,36 @@ class HalClient
     interpret_response client_for_post(override_headers: headers).post(url, body: req_body)
   end
 
+  # Put a `Representation` or `String` to the resource identified at `url`.
+  #
+  # url - The URL of the resource of interest.
+  # data - a `String` or an object that responds to `#to_hal`
+  # headers - custom header fields to use for this request
+  def put(url, data, headers={})
+    req_body = if data.respond_to? :to_hal
+                 data.to_hal
+               else
+                 data
+               end
+
+    interpret_response client_for_post(override_headers: headers).put(url, body: req_body)
+  end
+
+  # Patch a `Representation` or `String` to the resource identified at `url`.
+  #
+  # url - The URL of the resource of interest.
+  # data - a `String` or an object that responds to `#to_hal`
+  # headers - custom header fields to use for this request
+  def patch(url, data, headers={})
+    req_body = if data.respond_to? :to_hal
+                 data.to_hal
+               else
+                 data
+               end
+
+    interpret_response client_for_post(override_headers: headers).patch(url, body: req_body)
+  end
+
   protected
 
   attr_reader :headers

data/spec/hal_client/representation_editor_spec.rb

@@ -0,0 +1,163 @@
+require_relative "../spec_helper"
+require "hal_client/representation_editor"
+
+RSpec.describe HalClient::RepresentationEditor do
+  describe "creation" do
+    it "take a representation" do
+      expect(described_class.new(a_repr)).to be_kind_of described_class
+    end
+  end
+
+  subject { described_class.new(a_repr) }
+
+  specify { expect(subject.to_hal).to be_equivalent_json_to raw_hal }
+  specify { expect(subject.to_json).to be_equivalent_json_to raw_hal }
+
+  describe "#reject_links" do
+    specify { expect(subject.reject_links("up")).not_to have_link "up" }
+
+    it "removes links matching block but not others" do
+      altered = subject.reject_links("up") {|repr| %r|/c1$| === repr.href }
+
+      expect(altered).not_to have_link "up", with_href("http://example.com/c1")
+      expect(altered).to     have_link "up", with_href("http://example.com/c2")
+    end
+
+    specify { expect(subject.reject_links("absent-rel")).to be_equivalent_json_to raw_hal }
+    specify { expect(subject.reject_links("about") {|repr| %r|/another$| === repr.href })
+              .not_to have_link "about" }
+  end
+
+  describe "#reject_embedded" do
+    specify { expect(subject.reject_embedded("replies"))
+              .not_to have_embedded "replies" }
+    specify { expect(subject.reject_embedded("absent-rel"))
+              .to be_equivalent_json_to raw_hal }
+
+    it "removes links matching block but not others" do
+      altered = subject.reject_embedded("replies") {|repr|  "+1" == repr.property("value") }
+
+      expect(altered).not_to have_embedded "replies", hash_including("value" => "+1")
+      expect(altered).to     have_embedded "replies", hash_including("value" => "-1")
+    end
+  end
+
+  describe "#reject_related" do
+    it "rejects from links section" do
+      altered = subject.reject_related("up")
+
+      expect(altered).not_to have_link("up")
+      expect(altered).not_to have_embedded("up")
+    end
+
+    it "rejects from links section matching block" do
+      altered = subject.reject_related("up") { |it| %r|/c1$| === it.href }
+
+      expect(altered).not_to have_link "up", with_href("http://example.com/c1")
+      expect(altered).to     have_link "up", with_href("http://example.com/c2")
+      expect(altered).not_to have_embedded("up")
+    end
+
+
+    it "rejects from embedded section" do
+      altered = subject.reject_related("replies")
+
+      expect(altered).not_to have_link("replies")
+      expect(altered).not_to have_embedded("replies")
+    end
+
+    it "rejects from embedded section matching block" do
+      altered = subject.reject_related("replies") {|it| it["value"] == "+1" }
+
+      expect(altered).not_to have_link("replies", hash_including("value" => "+1"))
+      expect(altered).not_to have_embedded("replies", hash_including("value" => "+1"))
+
+      expect(altered).to have_link("replies", hash_including("value" => "-1"))
+                          .or(have_embedded("replies", hash_including("value" => "-1")))
+
+    end
+
+    specify { expect(subject.reject_related("absent-rel"))
+              .to be_equivalent_json_to raw_hal }
+
+  end
+
+  describe "#add_link" do
+    it "adds brand new link rel" do
+      expect(subject.add_link("related", "http://example.com/third"))
+        .to have_link("related", with_href("http://example.com/third")
+                                 .and(not_templated))
+    end
+
+    it "adds without replacing existing links" do
+      expect(subject.add_link("about", "http://example.com/third"))
+        .to have_link("about", with_href("http://example.com/third"))
+             .and have_link("about", with_href("http://example.com/another"))
+    end
+
+    it "adds templated links" do
+      expect(subject.add_link("related", "http://example.com/third{?wat}", templated: true))
+        .to have_link "related", with_href("http://example.com/third{?wat}")
+                                 .and(be_templated)
+    end
+  end
+
+  # Background
+
+  let(:a_repr) { HalClient::Representation
+                 .new(parsed_json: MultiJson.load(raw_hal)) }
+
+  let(:raw_hal) { <<-HAL }
+    { "_links": {
+        "self"  : { "href": "http://example.com/a_repr" }
+        ,"up"   : [{ "href": "http://example.com/c1" },
+                  { "href": "http://example.com/c2" }]
+        ,"about": { "href": "http://example.com/another" }
+      }
+      ,"_embedded": {
+        "replies": [
+          { "value": "+1" }
+          ,{"value": "-1" }
+        ]
+       }
+    }
+  HAL
+
+  ANYTHING = ->(_) { true }
+
+  matcher :be_templated do
+    match do |actual|
+      true == actual["templated"]
+    end
+  end
+
+  matcher :not_templated do
+    match do |actual|
+      true != actual["templated"]
+    end
+  end
+
+  matcher :with_href do |expected_url|
+    match do |actual|
+      expected_url === actual["href"]
+    end
+  end
+
+  matcher :have_link do |expected_rel, expected_target=ANYTHING|
+    match do |actual_json|
+      parsed = MultiJson.load(actual_json.to_hal)
+
+      [parsed["_links"].fetch(expected_rel, [])].flatten
+        .any?{|l| expected_target === l }
+    end
+  end
+
+  matcher :have_embedded do |expected_rel, expected_target=ANYTHING|
+    match do |actual_json|
+      parsed = MultiJson.load(actual_json.to_hal)
+
+      [parsed["_embedded"].fetch(expected_rel, [])].flatten
+        .any?{|e| expected_target === e }
+    end
+  end
+end

data/spec/hal_client/representation_set_spec.rb

@@ -81,6 +81,42 @@ describe HalClient::RepresentationSet do
     end
   end
 
+  describe "#put" do
+    context "with a single representation" do
+      subject(:repr_single_set) { described_class.new([foo_repr]) }
+      let!(:put_request) { stub_request(:put, "example.com/foo") }
+
+      before(:each) do
+        repr_single_set.put("abc")
+      end
+
+      it "makes an HTTP PUT with the data within the representation" do
+        expect(
+          put_request.
+          with(:body => "abc", :headers => {'Content-Type' => 'application/hal+json'})
+          ).to have_been_made
+      end
+    end
+  end
+
+  describe "#patch" do
+    context "with a single representation" do
+      subject(:repr_single_set) { described_class.new([foo_repr]) }
+      let!(:patch_request) { stub_request(:patch, "example.com/foo") }
+
+      before(:each) do
+        repr_single_set.patch("abc")
+      end
+
+      it "makes an HTTP PATCH with the data within the representation" do
+        expect(
+          patch_request.
+          with(:body => "abc", :headers => {'Content-Type' => 'application/hal+json'})
+          ).to have_been_made
+      end
+    end
+  end
+
   let(:a_client) { HalClient.new }
 
   let(:foo_repr) { HalClient::Representation.new hal_client: a_client, parsed_json: MultiJson.load(foo_hal)}

data/spec/hal_client/representation_spec.rb

@@ -25,11 +25,11 @@ HAL
 
   describe "#post" do
     let!(:post_request) {
-      stub_request(:post, "example.com/bar")
+      stub_request(:post, repr.href)
     }
 
     before(:each) do
-      repr.related("link1").post("abc")
+      repr.post("abc")
     end
 
     specify("makes request") {
@@ -39,6 +39,38 @@ HAL
     }
   end
 
+  describe "#put" do
+    let!(:put_request) {
+      stub_request(:put, repr.href)
+    }
+
+    before(:each) do
+      repr.put("abc")
+    end
+
+    specify("makes request") {
+      expect(put_request.with(:body => "abc",
+                              :headers => {'Content-Type' => 'application/hal+json'}))
+        .to have_been_made
+    }
+  end
+
+  describe "#patch" do
+    let!(:patch_request) {
+      stub_request(:patch, repr.href)
+    }
+
+    before(:each) do
+      repr.patch("abc")
+    end
+
+    specify("makes request") {
+      expect(patch_request.with(:body => "abc",
+                                :headers => {'Content-Type' => 'application/hal+json'}))
+        .to have_been_made
+    }
+  end
+
   describe "#to_s" do
     subject(:return_val) { repr.to_s }
 
@@ -173,6 +205,10 @@ HAL
   specify { expect(subject.has_related? "no-such-link-or-embed").to be false }
   specify { expect(subject.related? "no-such-link-or-embed").to be false }
 
+  specify { expect(subject.to_json).to be_equivalent_json_to raw_repr }
+  specify { expect(subject.to_hal).to be_equivalent_json_to raw_repr }
+
+
   context "curie links" do
     let(:raw_repr) { <<-HAL }
 { "_links": {
@@ -270,6 +306,7 @@ HAL
       "Expected representation of <#{url}> but found only #{repr_set.map(&:href)}"
     }
   end
+
 end
 
 describe HalClient::Representation, "w/o hal_client" do
@@ -294,4 +331,6 @@ describe HalClient::Representation, "w/o hal_client" do
   }
 }
   HAL
+
+
 end

data/spec/spec_helper.rb

@@ -4,3 +4,9 @@ require 'rspec'
 require 'webmock/rspec'
 require 'multi_json'
 require 'rspec/collection_matchers'
+
+require 'support/custom_matchers'
+
+RSpec.configure do |config|
+  config.include CustomMatchers
+end

data/spec/support/custom_matchers.rb

@@ -0,0 +1,19 @@
+module CustomMatchers
+  extend RSpec::Matchers::DSL
+
+  matcher :be_equivalent_json_to do |expected_json|
+    match do |actual_json|
+      MultiJson.load(json(expected_json)) == MultiJson.load(json(actual_json))
+    end
+
+    protected
+
+    def json(jsonish)
+      if String === jsonish
+        jsonish
+      else
+        jsonish.to_json
+      end
+    end
+  end
+end

metadata

@@ -1,148 +1,131 @@
 --- !ruby/object:Gem::Specification
 name: hal-client
 version: !ruby/object:Gem::Version
-  version: 3.1.2
-  prerelease: 
+  version: 3.2.0
 platform: ruby
 authors:
 - Peter Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-19 00:00:00.000000000 Z
+date: 2014-11-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.1
 - !ruby/object:Gem::Dependency
   name: addressable
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.3'
 - !ruby/object:Gem::Dependency
   name: multi_json
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.9'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.5'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '10.1'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.0.0.beta
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 3.0.0.beta
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.17'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.17.4
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.17'
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 1.17.4
 - !ruby/object:Gem::Dependency
   name: rspec-collection_matchers
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 description: An easy to use interface for REST APIs that use HAL.
@@ -152,8 +135,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .travis.yml
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -166,51 +149,50 @@ files:
 - lib/hal_client/errors.rb
 - lib/hal_client/links_section.rb
 - lib/hal_client/representation.rb
+- lib/hal_client/representation_editor.rb
 - lib/hal_client/representation_set.rb
 - lib/hal_client/version.rb
 - spec/hal_client/collection_spec.rb
 - spec/hal_client/curie_resolver_spec.rb
 - spec/hal_client/links_section_spec.rb
+- spec/hal_client/representation_editor_spec.rb
 - spec/hal_client/representation_set_spec.rb
 - spec/hal_client/representation_spec.rb
 - spec/hal_client_spec.rb
 - spec/spec_helper.rb
+- spec/support/custom_matchers.rb
 homepage: https://github.com/pezra/hal-client
 licenses:
 - MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 916239915633512664
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: 916239915633512664
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.2.2
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Use HAL APIs easily
 test_files:
 - spec/hal_client/collection_spec.rb
 - spec/hal_client/curie_resolver_spec.rb
 - spec/hal_client/links_section_spec.rb
+- spec/hal_client/representation_editor_spec.rb
 - spec/hal_client/representation_set_spec.rb
 - spec/hal_client/representation_spec.rb
 - spec/hal_client_spec.rb
 - spec/spec_helper.rb
+- spec/support/custom_matchers.rb
+has_rdoc: