contentful-management 1.5.0 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a5375f7ca984d57cac6d910e9499a7fee451f57f
-  data.tar.gz: 7d847b47c7cb3f9af9dae098f869fb99b4cd04dc
+  metadata.gz: 59a0b72970e30e8e4fa850361c2ed6c52603e6b0
+  data.tar.gz: b1f2d446a426a052a8ca164e1f9ca3a9b15f8212
 SHA512:
-  metadata.gz: 648da2fcb41cb3007f9201e606f460f20b72104b03c6dd57ee5df680d7fca13162b9bfc08018cf4e779d0ff858bc7536d06c8d3a2010239fecab4ff776e93304
-  data.tar.gz: 194e585093ea3025e1b582aa60a96b3d4871afd2030cd9b3cbd5b8b8f29879819d5a7bc56987bfd66adeed95febdd3cb6f188717cb65b920b1b875532f72e53a
+  metadata.gz: d245df3cd7ab483f306fd8fb7823cfbe41bb3b93c4fa1798c8833ac6fcfdbbba4eb62b72c0ef5be78bcc963528ac0983436594c79005309262d83340eca1a199
+  data.tar.gz: 03b149bc58082a045ccda45820f07c590616a50c96ce3af8777ada574f6ab7f453b57f8197b754f687ea60f679f7c162020f5973b064ad783b47fa157ca42a3b

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Master
 
+## 1.6.0
+
+### Added
+* Added support for Snapshot API
+
 ## 1.5.0
 ### Added
 * Added support for Select Operator in Entries and Assets

data/README.md

@@ -661,6 +661,20 @@ pass the ids of the levels below it.
 > Hierarchy is as follows:
 > `No Object -> Space -> ContentType -> EditorInterface`
 
+### Snapshots
+
+Retrieving all Snapshot for a given Entry:
+
+```ruby
+snapshots = entry.snapshots.all
+```
+
+Retrieving a Snapshot for a given Entry:
+
+```ruby
+snapshot = entry.snapshots.find('some_snapshot_id')
+```
+
 ### Pagination
 
 ```ruby

data/lib/contentful/management/client.rb

@@ -14,6 +14,7 @@ require 'contentful/management/client_locale_methods_factory'
 require 'contentful/management/client_role_methods_factory'
 require 'contentful/management/client_editor_interface_methods_factory'
 require 'contentful/management/client_webhook_methods_factory'
+require 'contentful/management/client_snapshot_methods_factory'
 
 require_relative 'request'
 require 'http'
@@ -155,6 +156,15 @@ module Contentful
         ClientWebhookMethodsFactory.new(self)
       end
 
+      # Allows manipulation of snapshots in context of the current client
+      # Allows listing all webhooks for client, creating new and finding one by id.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientSnapshotMethodsFactory]
+      def snapshots
+        ClientSnapshotMethodsFactory.new(self)
+      end
+
       # @private
       def setup_logger
         @logger = configuration[:logger]

data/lib/contentful/management/client_association_all_published_method_factory.rb

@@ -7,7 +7,7 @@ module Contentful
       #
       # @param [String] space_id
       # @param [Hash] params
-      # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+      # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
       # @deprecated This call will be soon removed from the API except for Content Types
       #
       # @return [Contentful::Management::Array<Contentful::Management::Resource>]

data/lib/contentful/management/client_association_methods_factory.rb

@@ -16,7 +16,7 @@ module Contentful
       #
       # @param [String] space_id
       # @param [Hash] params
-      # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+      # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
       #
       # @return [Contentful::Management::Array<Contentful::Management::Resource>]
       def all(space_id, params = {})

data/lib/contentful/management/client_editor_interface_methods_factory.rb

@@ -17,8 +17,7 @@ module Contentful
       #
       # @param [String] space_id
       # @param [String] content_type_id
-      # @param [Hash] params
-      # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+      # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
       #
       # @return [Contentful::Management::EditorInterface]
       def default(space_id, content_type_id)

data/lib/contentful/management/client_snapshot_methods_factory.rb

@@ -0,0 +1,34 @@
+require_relative 'client_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for Webhook API for usage from within Client
+    # @private
+    class ClientSnapshotMethodsFactory
+      include Contentful::Management::ClientAssociationMethodsFactory
+
+      def create(*)
+        fail 'Not supported'
+      end
+
+      def all(space_id, entry_id, _params = {})
+        @resource_requester.find(
+          space_id: space_id,
+          entry_id: entry_id
+        )
+      end
+
+      def find(space_id, entry_id, snapshot_id)
+        @resource_requester.find(
+          space_id: space_id,
+          entry_id: entry_id,
+          snapshot_id: snapshot_id
+        )
+      end
+
+      def new(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/content_type_entry_methods_factory.rb

@@ -15,7 +15,7 @@ module Contentful
       # Gets all entries for a specific ContentType
       #
       # @param [Hash] params
-      # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+      # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
       # @option params [String] 'sys.id'
       # @option params [String] :limit
       # @option params [String] :skip

data/lib/contentful/management/editor_interface.rb

@@ -12,10 +12,9 @@ module Contentful
 
       # Gets the Default Editor Interface
       #
+      # @param [Contentful::Management::Client] client
       # @param [String] space_id
       # @param [String] content_type_id
-      # @param [Hash] params
-      # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
       #
       # @return [Contentful::Management::EditorInterface]
       def self.default(client, space_id, content_type_id)

data/lib/contentful/management/entry.rb

@@ -1,6 +1,7 @@
 require_relative 'resource'
 require_relative 'resource_requester'
 require_relative 'client_entry_methods_factory'
+require_relative 'entry_snapshot_methods_factory'
 require_relative 'resource/entry_fields'
 require_relative 'resource/fields'
 require_relative 'resource/field_aware'
@@ -139,6 +140,15 @@ module Contentful
         end
       end
 
+      # Allows manipulation of snapshots in context of the current entry
+      # Allows listing all snapshots belonging to this entry and finding one by id.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::EntrySnapshotMethodsFactory]
+      def snapshots
+        EntrySnapshotMethodsFactory.new(self)
+      end
+
       protected
 
       def query_attributes(attributes)
@@ -188,7 +198,13 @@ module Contentful
       end
 
       def fetch_content_type
-        @content_type ||= ::Contentful::Management::ContentType.find(client, space.id, sys[:contentType].id)
+        content_type_id = if sys[:contentType].is_a?(::Contentful::Management::Resource)
+                            sys[:contentType].id
+                          else
+                            sys[:contentType]['sys']['id']
+                          end
+        space_id = space.is_a?(::Contentful::Management::Resource) ? space.id : space['sys']['id']
+        @content_type ||= ::Contentful::Management::ContentType.find(client, space_id, content_type_id)
       end
 
       def self.hash_with_link_object(type, attribute)

data/lib/contentful/management/entry_association_methods_factory.rb

@@ -0,0 +1,30 @@
+require_relative 'resource_requester'
+
+module Contentful
+  module Management
+    # Wrapper for Entry Association Methods
+    # @private
+    module EntryAssociationMethodsFactory
+      attr_reader :entry
+
+      def initialize(entry)
+        @entry = entry
+      end
+
+      def all(_params = {})
+        associated_class.all(entry.client, entry.sys[:space].id, entry.id)
+      end
+
+      def find(id)
+        associated_class.find(entry.client, entry.sys[:space].id, entry.id, id)
+      end
+
+      def associated_class
+        class_name = /\A(.+)Entry(.+)MethodsFactory\z/.match(self.class.name).captures.join
+        class_name.split('::').reduce(Object) do |mod, actual_class_name|
+          mod.const_get(actual_class_name)
+        end
+      end
+    end
+  end
+end

data/lib/contentful/management/entry_snapshot_methods_factory.rb

@@ -0,0 +1,23 @@
+require_relative 'entry_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for Snapshot API for usage from within Space
+    # @private
+    class EntrySnapshotMethodsFactory
+      include Contentful::Management::EntryAssociationMethodsFactory
+
+      def new
+        fail 'Not supported'
+      end
+
+      def create(*)
+        fail 'Not supported'
+      end
+
+      def update(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/resource.rb

@@ -172,7 +172,7 @@ module Contentful
         # @param [Contentful::Management::Client] client
         # @param [String] space_id
         # @param [Hash] parameters Search Options
-        # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+        # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
         #
         # @return [Contentful::Management::Array<Contentful::Management::Resource>]
         def all(client, space_id, parameters = {})

data/lib/contentful/management/resource/all_published.rb

@@ -8,7 +8,7 @@ module Contentful
         # @param [Contentful::Management::Client] client
         # @param [String] space_id
         # @param [Hash] parameters
-        # @see _ For complete option list: http://docs.contentfulcda.apiary.io/#reference/search-parameters
+        # @see _ For complete option list: https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/search-parameters
         # @option parameters [String] 'sys.id' Entry ID
         # @option parameters [String] :content_type
         # @option parameters [Integer] :limit

data/lib/contentful/management/resource_builder.rb

@@ -12,6 +12,7 @@ require_relative 'api_key'
 require_relative 'locale'
 require_relative 'role'
 require_relative 'editor_interface'
+require_relative 'snapshot'
 
 module Contentful
   module Management
@@ -31,7 +32,8 @@ module Contentful
         'ApiKey' => Contentful::Management::ApiKey,
         'Locale' => Contentful::Management::Locale,
         'Role' => Contentful::Management::Role,
-        'EditorInterface' => Contentful::Management::EditorInterface
+        'EditorInterface' => Contentful::Management::EditorInterface,
+        'Snapshot' => Contentful::Management::Snapshot
       }
       # Default Entry Mapping
       # @see _ README for more information on Entry Mapping

data/lib/contentful/management/snapshot.rb

@@ -0,0 +1,77 @@
+require_relative 'resource'
+require_relative 'client_snapshot_methods_factory'
+
+module Contentful
+  module Management
+    # Resource class for Snapshot.
+    # @see _ https://www.contentful.com/developers/docs/references/content-management-api/#/reference/snapshots
+    class Snapshot
+      include Contentful::Management::Resource
+      include Contentful::Management::Resource::SystemProperties
+      include Contentful::Management::Resource::Refresher
+
+      property :snapshot, DynamicEntry
+
+      # Gets all Snapshots for an Entry
+      #
+      # @param [Contentful::Management::Client] client
+      # @param [String] space_id
+      # @param [String] entry_id
+      #
+      # @return [Contentful::Management::Array<Contentful::Management::Snapshot>]
+      def self.all(client, space_id, entry_id)
+        ClientSnapshotMethodsFactory.new(client).all(space_id, entry_id)
+      end
+
+      # Gets a Snapshot by ID
+      #
+      # @param [Contentful::Management::Client] client
+      # @param [String] space_id
+      # @param [String] entry_id
+      # @param [String] snapshot_id
+      #
+      # @return [Contentful::Management::Snapshot]
+      def self.find(client, space_id, entry_id, snapshot_id)
+        ClientSnapshotMethodsFactory.new(client).find(space_id, entry_id, snapshot_id)
+      end
+
+      # Creates a Snapshot
+      #
+      # Not Supported
+      def self.create(*)
+        fail 'Not supported'
+      end
+
+      # @private
+      def self.endpoint
+        'snapshots'
+      end
+
+      # @private
+      def self.build_endpoint(endpoint_options)
+        space_id = endpoint_options.fetch(:space_id)
+        entry_id = endpoint_options.fetch(:entry_id)
+        snapshot_id = endpoint_options.fetch(:snapshot_id, nil)
+
+        endpoint = "/#{space_id}/entries/#{entry_id}/snapshots"
+        endpoint = "#{endpoint}/#{snapshot_id}" unless snapshot_id.nil?
+
+        endpoint
+      end
+
+      # Deletes a Snapshot
+      #
+      # Not Supported
+      def destroy
+        fail 'Not supported'
+      end
+
+      # Updates a Snapshot
+      #
+      # Not Supported
+      def update(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/support.rb

@@ -18,6 +18,10 @@ module Contentful
           end
         end
 
+        # If the query contains the :select operator, we enforce :sys properties.
+        # The SDK requires sys.type to function properly, but as other of our SDKs
+        # require more parts of the :sys properties, we decided that every SDK should
+        # include the complete :sys block to provide consistency accross our SDKs.
         def normalize_select!(parameters)
           return parameters unless parameters.key?(:select)
 

data/lib/contentful/management/version.rb

@@ -3,6 +3,6 @@ module Contentful
   # Management Namespace
   module Management
     # Gem Version
-    VERSION = '1.5.0'
+    VERSION = '1.6.0'
   end
 end

data/spec/fixtures/vcr_cassettes/snapshot/all.yml

@@ -0,0 +1,175 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/entries/5gQdVmPHKwIk2MumquYwOu/snapshots
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulManagementGem/1.5.0
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Wed, 15 Mar 2017 13:00:48 GMT
+      Etag:
+      - '"ee206ff530734e5e435ba4e4a6f65138"'
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35989'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - fdd656a48caca3b9ebdb56278bbd97e9
+      Content-Length:
+      - '2230'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_455_673446=LdblBCssCV4lrtEEe3xQBv86yVgAAAAA/6vCZQKOGiM1pnwP0ueCPg==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=XchXGox3MHWSirWi6lKYhQAAAAD11IdruXmlA9lecyNqikh/; path=/; Domain=.contentful.com
+      - visid_incap_673446=nUCpGmO8SuqSEyl+gmJhG/86yVgAAAAAQUIPAAAAAABZ7NG5ziIBQ9ssmjhdUq1L;
+        expires=Thu, 15 Mar 2018 11:35:42 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 5-81023772-81023789 NNNN CT(80 84 0) RT(1489582840232 76) q(0 0 1 -1) r(72
+        72) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "items": [
+            {
+              "sys": {
+                "type": "Snapshot",
+                "snapshotType": "publish",
+                "id": "6DglRQMMHWUnzi2F3RjFFo",
+                "createdAt": "2017-03-10T15:58:05.435Z",
+                "createdBy": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "User",
+                    "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                  }
+                },
+                "updatedAt": "2017-03-10T15:58:05.435Z",
+                "updatedBy": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "User",
+                    "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                  }
+                },
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "facgnwwgj5fe"
+                  }
+                }
+              },
+              "snapshot": {
+                "fields": {
+                  "name": {
+                    "en-US": "something else"
+                  }
+                },
+                "sys": {
+                  "id": "5gQdVmPHKwIk2MumquYwOu",
+                  "type": "Entry",
+                  "createdAt": "2017-03-02T18:47:44.195Z",
+                  "createdBy": {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "User",
+                      "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                    }
+                  },
+                  "space": {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "Space",
+                      "id": "facgnwwgj5fe"
+                    }
+                  },
+                  "contentType": {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "ContentType",
+                      "id": "test"
+                    }
+                  },
+                  "version": 3,
+                  "updatedAt": "2017-03-10T15:58:05.418Z",
+                  "updatedBy": {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "User",
+                      "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                    }
+                  },
+                  "firstPublishedAt": "2017-03-10T15:58:05.418Z",
+                  "publishedCounter": 1,
+                  "publishedAt": "2017-03-10T15:58:05.418Z",
+                  "publishedBy": {
+                    "sys": {
+                      "type": "Link",
+                      "linkType": "User",
+                      "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                    }
+                  },
+                  "publishedVersion": 2
+                }
+              }
+            }
+          ],
+          "skip": 0,
+          "limit": 100
+        }
+    http_version: 
+  recorded_at: Wed, 15 Mar 2017 13:00:48 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/snapshot/find.yml

@@ -0,0 +1,166 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/entries/5gQdVmPHKwIk2MumquYwOu/snapshots/6DglRQMMHWUnzi2F3RjFFo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulManagementGem/1.5.0
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Wed, 15 Mar 2017 13:00:40 GMT
+      Etag:
+      - '"e7cb4a6a14f463d523a7917c8f8c0798"'
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35990'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - 22d901abad32cb929af5ff811fa7c576
+      Content-Length:
+      - '1812'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_455_673446=GeSLeHIwgDkBptEEe3xQBvg6yVgAAAAA066E7B87Jk5uc41TYOkiVA==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=Z+7JIgkUJjjGDvGK6lKYhQAAAABvPw9JF3ZUHlxEUbV7CrLL; path=/; Domain=.contentful.com
+      - visid_incap_673446=piS6dEBqQB6IarxgWlDmRPg6yVgAAAAAQUIPAAAAAABgkxLUNytbyjh0ZKnBdnlf;
+        expires=Thu, 15 Mar 2018 11:35:42 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 7-48171554-48171566 NNNN CT(76 76 0) RT(1489582836194 75) q(0 0 2 -1) r(38
+        38) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Snapshot",
+            "snapshotType": "publish",
+            "id": "6DglRQMMHWUnzi2F3RjFFo",
+            "createdAt": "2017-03-10T15:58:05.435Z",
+            "createdBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "updatedAt": "2017-03-10T15:58:05.435Z",
+            "updatedBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "space": {
+              "sys": {
+                "type": "Link",
+                "linkType": "Space",
+                "id": "facgnwwgj5fe"
+              }
+            }
+          },
+          "snapshot": {
+            "fields": {
+              "name": {
+                "en-US": "something else"
+              }
+            },
+            "sys": {
+              "id": "5gQdVmPHKwIk2MumquYwOu",
+              "type": "Entry",
+              "createdAt": "2017-03-02T18:47:44.195Z",
+              "createdBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "space": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "Space",
+                  "id": "facgnwwgj5fe"
+                }
+              },
+              "contentType": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "ContentType",
+                  "id": "test"
+                }
+              },
+              "version": 3,
+              "updatedAt": "2017-03-10T15:58:05.418Z",
+              "updatedBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "firstPublishedAt": "2017-03-10T15:58:05.418Z",
+              "publishedCounter": 1,
+              "publishedAt": "2017-03-10T15:58:05.418Z",
+              "publishedBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "publishedVersion": 2
+            }
+          }
+        }
+    http_version: 
+  recorded_at: Wed, 15 Mar 2017 13:00:40 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/snapshot/find_not_found.yml

@@ -0,0 +1,92 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/entries/5gQdVmPHKwIk2MumquYwOu/snapshots/not_exist
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulManagementGem/1.5.0
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+  response:
+    status:
+      code: 404
+      message: Not Found
+    headers:
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Wed, 15 Mar 2017 13:01:18 GMT
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35988'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - afd5d6e7bc6aaf08d085fc4c23aaf744
+      Content-Length:
+      - '256'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_455_673446=OJ4+BSi+WGBf09EEe3xQBh47yVgAAAAAX+bqWYlGC4oiKmWzaDxmLQ==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=wwHdJpMe1xiJzwoq6lKYhQAAAADZTOr3iSzc+jzOAjfUX2eF; path=/; Domain=.contentful.com
+      - visid_incap_673446=+KmqM5KzTLSG+5bIDro0aB47yVgAAAAAQUIPAAAAAAAeOn0F7mP/l5RRcC7XvjIt;
+        expires=Thu, 15 Mar 2018 11:35:42 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 4-66000696-66000702 NNNN CT(97 97 0) RT(1489582877658 78) q(0 0 2 -1) r(5
+        5) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Error",
+            "id": "NotFound"
+          },
+          "message": "The resource could not be found.",
+          "details": {
+            "space": "facgnwwgj5fe",
+            "id": "not_exist",
+            "type": "Snapshot"
+          },
+          "requestId": "afd5d6e7bc6aaf08d085fc4c23aaf744"
+        }
+    http_version: 
+  recorded_at: Wed, 15 Mar 2017 13:01:18 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/snapshot/properties.yml

@@ -0,0 +1,301 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/entries/5gQdVmPHKwIk2MumquYwOu/snapshots/6DglRQMMHWUnzi2F3RjFFo
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulManagementGem/1.5.0
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Wed, 15 Mar 2017 14:15:11 GMT
+      Etag:
+      - '"e7cb4a6a14f463d523a7917c8f8c0798"'
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35997'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '9'
+      X-Contentful-Request-Id:
+      - c6415481467edf1db09a8f6af9992f0b
+      Content-Length:
+      - '1812'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_455_673446=QOp8Fya4sETH+udOfXxQBm5MyVgAAAAA02XoDJZSZGFtrd9dnzAraQ==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=VjGyGI/Z/j6QKUO36lKYhQAAAAAL9l+bL1QH0yHsyL13x65q; path=/; Domain=.contentful.com
+      - visid_incap_673446=Gkaf4qLtR+WiJtmNC+2rDG5MyVgAAAAAQUIPAAAAAADB5VOrUuXXOfF40O0pU58Z;
+        expires=Thu, 15 Mar 2018 13:30:20 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 6-189905-189906 NNNN CT(75 77 0) RT(1489587310149 82) q(0 0 1 -1) r(3 3) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Snapshot",
+            "snapshotType": "publish",
+            "id": "6DglRQMMHWUnzi2F3RjFFo",
+            "createdAt": "2017-03-10T15:58:05.435Z",
+            "createdBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "updatedAt": "2017-03-10T15:58:05.435Z",
+            "updatedBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "space": {
+              "sys": {
+                "type": "Link",
+                "linkType": "Space",
+                "id": "facgnwwgj5fe"
+              }
+            }
+          },
+          "snapshot": {
+            "fields": {
+              "name": {
+                "en-US": "something else"
+              }
+            },
+            "sys": {
+              "id": "5gQdVmPHKwIk2MumquYwOu",
+              "type": "Entry",
+              "createdAt": "2017-03-02T18:47:44.195Z",
+              "createdBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "space": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "Space",
+                  "id": "facgnwwgj5fe"
+                }
+              },
+              "contentType": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "ContentType",
+                  "id": "test"
+                }
+              },
+              "version": 3,
+              "updatedAt": "2017-03-10T15:58:05.418Z",
+              "updatedBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "firstPublishedAt": "2017-03-10T15:58:05.418Z",
+              "publishedCounter": 1,
+              "publishedAt": "2017-03-10T15:58:05.418Z",
+              "publishedBy": {
+                "sys": {
+                  "type": "Link",
+                  "linkType": "User",
+                  "id": "4SejVrWT96dvL9IV4Nb7sQ"
+                }
+              },
+              "publishedVersion": 2
+            }
+          }
+        }
+    http_version: 
+  recorded_at: Wed, 15 Mar 2017 14:15:11 GMT
+- request:
+    method: get
+    uri: https://api.contentful.com/spaces/facgnwwgj5fe/content_types/test
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulManagementGem/1.5.0
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Content-Length:
+      - '0'
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Access-Control-Allow-Headers:
+      - Accept,Accept-Language,Authorization,Cache-Control,Content-Length,Content-Range,Content-Type,DNT,Destination,Expires,If-Match,If-Modified-Since,If-None-Match,Keep-Alive,Last-Modified,Origin,Pragma,Range,User-Agent,X-Http-Method-Override,X-Mx-ReqToken,X-Requested-With,X-Contentful-Version,X-Contentful-Content-Type,X-Contentful-Organization,X-Contentful-Skip-Transformation,X-Contentful-User-Agent
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cf-Space-Id:
+      - facgnwwgj5fe
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Date:
+      - Wed, 15 Mar 2017 14:15:15 GMT
+      Etag:
+      - '"c34724c7958eb31fe3ea50969e50f751"'
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Ratelimit-Hour-Limit:
+      - '36000'
+      X-Contentful-Ratelimit-Hour-Remaining:
+      - '35996'
+      X-Contentful-Ratelimit-Reset:
+      - '0'
+      X-Contentful-Ratelimit-Second-Limit:
+      - '10'
+      X-Contentful-Ratelimit-Second-Remaining:
+      - '8'
+      X-Contentful-Request-Id:
+      - b1328a38a8618fede4530cded1786e7c
+      Content-Length:
+      - '1159'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_455_673446=2d9VUTNqqQRs/+dOfXxQBnJMyVgAAAAAh4zCgN3NwnL2cQ8hI+ciLA==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=ZOdzI6lDwmdaxLEl6lKYhQAAAACxCUtusdaevIGW6gJC4DV/; path=/; Domain=.contentful.com
+      - visid_incap_673446=S0SEOYVESMa+CnIHxIO47nJMyVgAAAAAQUIPAAAAAADNV4SQJLTvAQEr6bu7XQSV;
+        expires=Thu, 15 Mar 2018 13:30:10 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 4-368281-368307 NNNN CT(78 77 0) RT(1489587310676 76) q(0 0 2 -1) r(39 39)
+        U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "name": "Test",
+          "fields": [
+            {
+              "name": "name",
+              "id": "name",
+              "type": "Symbol",
+              "localized": false,
+              "required": false,
+              "disabled": false,
+              "omitted": false,
+              "validations": []
+            }
+          ],
+          "displayField": "name",
+          "description": "",
+          "sys": {
+            "id": "test",
+            "type": "ContentType",
+            "createdAt": "2017-03-02T18:32:49.570Z",
+            "createdBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "space": {
+              "sys": {
+                "type": "Link",
+                "linkType": "Space",
+                "id": "facgnwwgj5fe"
+              }
+            },
+            "firstPublishedAt": "2017-03-02T18:32:50.559Z",
+            "publishedCounter": 1,
+            "publishedAt": "2017-03-02T18:32:50.559Z",
+            "publishedBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            },
+            "publishedVersion": 1,
+            "version": 2,
+            "updatedAt": "2017-03-02T18:32:50.586Z",
+            "updatedBy": {
+              "sys": {
+                "type": "Link",
+                "linkType": "User",
+                "id": "4SejVrWT96dvL9IV4Nb7sQ"
+              }
+            }
+          }
+        }
+    http_version: 
+  recorded_at: Wed, 15 Mar 2017 14:15:15 GMT
+recorded_with: VCR 3.0.3

data/spec/lib/contentful/management/snapshot_spec.rb

@@ -0,0 +1,87 @@
+require 'spec_helper'
+require 'contentful/management/space'
+require 'contentful/management/client'
+
+module Contentful
+  module Management
+    describe Snapshot do
+      let(:token) { '<ACCESS_TOKEN>' }
+      let(:space_id) { 'facgnwwgj5fe' }
+      let(:entry_id) { '5gQdVmPHKwIk2MumquYwOu' }
+      let(:snapshot_id) { '6DglRQMMHWUnzi2F3RjFFo' }
+      let!(:client) { Client.new(token) }
+
+      subject { client.snapshots }
+
+      describe '.all' do
+        it 'class method also works' do
+          vcr('snapshot/all') { expect(Contentful::Management::Snapshot.all(client, space_id, entry_id)).to be_kind_of Contentful::Management::Array }
+        end
+        it 'returns a Contentful::Array' do
+          vcr('snapshot/all') { expect(subject.all(space_id, entry_id)).to be_kind_of Contentful::Management::Array }
+        end
+        it 'builds a Contentful::Management::Snapshot object' do
+          vcr('snapshot/all') { expect(subject.all(space_id, entry_id).first).to be_kind_of Contentful::Management::Snapshot }
+        end
+      end
+
+      describe '.find' do
+        it 'class method also works' do
+          vcr('snapshot/find') { expect(Contentful::Management::Snapshot.find(client, space_id, entry_id, snapshot_id)).to be_kind_of Contentful::Management::Snapshot }
+        end
+        it 'returns a Contentful::Management::Snapshot' do
+          vcr('snapshot/find') { expect(subject.find(space_id, entry_id, snapshot_id)).to be_kind_of Contentful::Management::Snapshot }
+        end
+        it 'returns snapshot for a given key' do
+          vcr('snapshot/find') do
+            snapshot = subject.find(space_id, entry_id, snapshot_id)
+            expect(snapshot.id).to eql snapshot_id
+          end
+        end
+        it 'returns an error when snapshot does not exist' do
+          vcr('snapshot/find_not_found') do
+            result = subject.find(space_id, entry_id, 'not_exist')
+            expect(result).to be_kind_of Contentful::Management::NotFound
+          end
+        end
+      end
+
+      describe '.create' do
+        it 'is not supported' do
+          expect { subject.create }.to raise_error 'Not supported'
+        end
+      end
+
+      describe '#update' do
+        it 'is not supported' do
+          vcr('snapshot/find') do
+            snapshot = subject.find(space_id, entry_id, snapshot_id)
+
+            expect { snapshot.update }.to raise_error 'Not supported'
+          end
+        end
+      end
+
+      describe '#destroy' do
+        it 'is not supported' do
+          vcr('snapshot/find') do
+            snapshot = subject.find(space_id, entry_id, snapshot_id)
+
+            expect { snapshot.destroy }.to raise_error 'Not supported'
+          end
+        end
+      end
+
+      describe 'properties' do
+        it '.snapshot' do
+          vcr('snapshot/properties') do
+            snapshot = subject.find(space_id, entry_id, snapshot_id)
+
+            expect(snapshot.snapshot).to be_a Contentful::Management::Entry
+            expect(snapshot.snapshot.name['en-US']).to eq 'something else'
+          end
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contentful-management
 version: !ruby/object:Gem::Version
-  version: 1.5.0
+  version: 1.6.0
 platform: ruby
 authors:
 - Piotr Protas
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-12-19 00:00:00.000000000 Z
+date: 2017-04-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -243,6 +243,7 @@ files:
 - lib/contentful/management/client_entry_methods_factory.rb
 - lib/contentful/management/client_locale_methods_factory.rb
 - lib/contentful/management/client_role_methods_factory.rb
+- lib/contentful/management/client_snapshot_methods_factory.rb
 - lib/contentful/management/client_space_methods_factory.rb
 - lib/contentful/management/client_webhook_methods_factory.rb
 - lib/contentful/management/content_type.rb
@@ -251,6 +252,8 @@ files:
 - lib/contentful/management/dynamic_entry.rb
 - lib/contentful/management/editor_interface.rb
 - lib/contentful/management/entry.rb
+- lib/contentful/management/entry_association_methods_factory.rb
+- lib/contentful/management/entry_snapshot_methods_factory.rb
 - lib/contentful/management/error.rb
 - lib/contentful/management/field.rb
 - lib/contentful/management/file.rb
@@ -274,6 +277,7 @@ files:
 - lib/contentful/management/resource_requester.rb
 - lib/contentful/management/response.rb
 - lib/contentful/management/role.rb
+- lib/contentful/management/snapshot.rb
 - lib/contentful/management/space.rb
 - lib/contentful/management/space_api_key_methods_factory.rb
 - lib/contentful/management/space_asset_methods_factory.rb
@@ -493,6 +497,10 @@ files:
 - spec/fixtures/vcr_cassettes/roles/find.yml
 - spec/fixtures/vcr_cassettes/roles/find_for_space_not_found.yml
 - spec/fixtures/vcr_cassettes/roles/update.yml
+- spec/fixtures/vcr_cassettes/snapshot/all.yml
+- spec/fixtures/vcr_cassettes/snapshot/find.yml
+- spec/fixtures/vcr_cassettes/snapshot/find_not_found.yml
+- spec/fixtures/vcr_cassettes/snapshot/properties.yml
 - spec/fixtures/vcr_cassettes/space/all.yml
 - spec/fixtures/vcr_cassettes/space/api_key/all.yml
 - spec/fixtures/vcr_cassettes/space/api_key/create.yml
@@ -556,6 +564,7 @@ files:
 - spec/lib/contentful/management/entry_spec.rb
 - spec/lib/contentful/management/locale_spec.rb
 - spec/lib/contentful/management/role_spec.rb
+- spec/lib/contentful/management/snapshot_spec.rb
 - spec/lib/contentful/management/space_spec.rb
 - spec/lib/contentful/management/webhook_spec.rb
 - spec/spec_helper.rb
@@ -789,6 +798,10 @@ test_files:
 - spec/fixtures/vcr_cassettes/roles/find.yml
 - spec/fixtures/vcr_cassettes/roles/find_for_space_not_found.yml
 - spec/fixtures/vcr_cassettes/roles/update.yml
+- spec/fixtures/vcr_cassettes/snapshot/all.yml
+- spec/fixtures/vcr_cassettes/snapshot/find.yml
+- spec/fixtures/vcr_cassettes/snapshot/find_not_found.yml
+- spec/fixtures/vcr_cassettes/snapshot/properties.yml
 - spec/fixtures/vcr_cassettes/space/all.yml
 - spec/fixtures/vcr_cassettes/space/api_key/all.yml
 - spec/fixtures/vcr_cassettes/space/api_key/create.yml
@@ -852,6 +865,7 @@ test_files:
 - spec/lib/contentful/management/entry_spec.rb
 - spec/lib/contentful/management/locale_spec.rb
 - spec/lib/contentful/management/role_spec.rb
+- spec/lib/contentful/management/snapshot_spec.rb
 - spec/lib/contentful/management/space_spec.rb
 - spec/lib/contentful/management/webhook_spec.rb
 - spec/spec_helper.rb