contentful 1.0.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: fa88c4ac86051cce5074ece0a442eba538b391de
-  data.tar.gz: d3b48ffb2e6415fe4ca1181273ea646c50c66ab6
+  metadata.gz: cf533a202661dbb21a1407db9ce750ce065e4b65
+  data.tar.gz: ab9be792f8c764a9a3d193b2b48a4023e5d67f7a
 SHA512:
-  metadata.gz: ac44810a4f8fa5e725b2953ae54abfb8bb4987d4af1feecfed38631ce4fdade1096f1cfdede0a67fd20fe039e0939243e87ee946568a1cc59cb5107b0c3ac997
-  data.tar.gz: ca723275d5614061688b12d2cf7d1dcc0ca5881b611378f454b70563297c9df5beea6ef6a9a43606eecf80617e12d9042603714125c5a425fed4410f69675e98
+  metadata.gz: 20c2571a350ee58c2b3bb9022067f286b11e853c140d4469ca12b501d0659f1188c9efcf6754d261b334ce387f776b2c8db389261ad909a78fcdcf2eaf8d2c13
+  data.tar.gz: 63b528128d85440107f71f696d0e9278aa94b0e0cae82e6e19a3d007269a04f9468e9ad05e298939df78020c864e263cd0b35c19ca7e68a4228ce09debf86577

data/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## Unreleased
 
+## 1.1.0
+### Added
+* Add support for `select` operator in `#entries` and `#assets` call
+
 ## 1.0.2
 ### Fixed
 * Fix Link resolution for Arrays on localized content

data/README.md

@@ -13,8 +13,6 @@ Add to your Gemfile and bundle:
 gem 'contentful'
 ```
 
-
-
 ## Usage
 
 ```ruby

data/lib/contentful/client.rb

@@ -149,6 +149,7 @@ module Contentful
     #
     # @return [Contentful::Array<Contentful::Entry>]
     def entries(query = {})
+      normalize_select!(query)
       Request.new(self, '/entries', query).get
     end
 
@@ -168,6 +169,7 @@ module Contentful
     #
     # @return [Contentful::Array<Contentful::Asset>]
     def assets(query = {})
+      normalize_select!(query)
       Request.new(self, '/assets', query).get
     end
 
@@ -296,6 +298,18 @@ module Contentful
 
     private
 
+    # 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!(query)
+      return unless query.key?(:select)
+
+      query[:select] = query[:select].split(',').map(&:strip) if query[:select].is_a? String
+      query[:select] = query[:select].reject { |p| p.start_with?('sys.') }
+      query[:select] << 'sys' unless query[:select].include?('sys')
+    end
+
     def normalize_configuration!
       [:space, :access_token, :api_url, :default_locale].each { |s| configuration[s] = configuration[s].to_s }
       configuration[:authentication_mechanism] = configuration[:authentication_mechanism].to_sym

data/lib/contentful/request.rb

@@ -3,7 +3,7 @@ module Contentful
   # with domain specific logic. The client later uses the Request's #url and #query methods
   # to execute the HTTP request.
   class Request
-    attr_reader :client, :type, :query, :id
+    attr_reader :client, :type, :query, :id, :endpoint
 
     def initialize(client, endpoint, query = {}, id = nil)
       @client = client

data/lib/contentful/resource.rb

@@ -142,7 +142,7 @@ module Contentful
     def initialize_fields_for_localized_resource(object)
       @fields = {}
 
-      object['fields'].each do |field_name, nested_child_object|
+      object.fetch('fields', {}).each do |field_name, nested_child_object|
         if Support.localized?(nested_child_object)
           nested_child_object.each do |object_locale, real_child_object|
             @fields[object_locale] ||= {}
@@ -151,8 +151,9 @@ module Contentful
             )
           end
         else
-          @fields[locale] ||= {}
-          @fields[locale].merge! extract_from_object({ field_name => nested_child_object }, :fields)
+          # if sys.locale property not present (due to select operator) use default_locale
+          @fields[locale || default_locale] ||= {}
+          @fields[locale || default_locale].merge! extract_from_object({ field_name => nested_child_object }, :fields)
         end
       end
     end

data/lib/contentful/version.rb

@@ -1,5 +1,5 @@
 # Contentful Namespace
 module Contentful
   # Gem Version
-  VERSION = '1.0.2'
+  VERSION = '1.1.0'
 end

data/spec/asset_spec.rb

@@ -67,4 +67,45 @@ describe Contentful::Asset do
     expect(unmarshalled.title).to eq 'Nyan Cat'
     expect(unmarshalled.file).to be_a Contentful::File
   end
+
+  describe 'select operator' do
+    let(:client) { create_client }
+
+    context 'with sys sent' do
+      it 'properly creates an entry' do
+        vcr('asset/select_only_sys') {
+          asset = client.assets(select: ['sys']).first
+          expect(asset.fields).to be_empty
+          expect(asset.sys).not_to be_empty
+        }
+      end
+
+      it 'can contain only one field' do
+        vcr('asset/select_one_field') {
+          asset = client.assets(select: ['sys', 'fields.file']).first
+          expect(asset.fields.keys).to eq([:file])
+        }
+      end
+    end
+
+    context 'without sys sent' do
+      it 'will enforce sys anyway' do
+        vcr('asset/select_no_sys') {
+          asset = client.assets(select: ['fields'], 'sys.id' => 'nyancat').first
+
+          expect(asset.id).to eq 'nyancat'
+          expect(asset.sys).not_to be_empty
+        }
+      end
+
+      it 'works with empty array as well, as sys is enforced' do
+        vcr('asset/select_empty_array') {
+          asset = client.assets(select: [], 'sys.id' => 'nyancat').first
+
+          expect(asset.id).to eq 'nyancat'
+          expect(asset.sys).not_to be_empty
+        }
+      end
+    end
+  end
 end

data/spec/entry_spec.rb

@@ -240,4 +240,60 @@ describe Contentful::Entry do
       end
     end
   end
+
+  describe 'select operator' do
+    let(:client) { create_client }
+
+    context 'with sys sent' do
+      it 'properly creates an entry' do
+        vcr('entry/select_only_sys') {
+          entry = client.entries(select: ['sys'], 'sys.id' => 'nyancat').first
+          expect(entry.fields).to be_empty
+          expect(entry.entry?).to be_truthy
+        }
+      end
+
+      describe 'can contain only one field' do
+        context 'with content_type sent' do
+          it 'will properly create the entry with one field' do
+            vcr('entry/select_one_field_proper') {
+              entry = client.entries(content_type: 'cat', select: ['sys', 'fields.name'], 'sys.id' => 'nyancat').first
+              expect(entry.fields).not_to be_empty
+              expect(entry.entry?).to be_truthy
+              expect(entry.fields[:name]).to eq 'Nyan Cat'
+              expect(entry.fields).to eq({name: 'Nyan Cat'})
+            }
+          end
+        end
+
+        context 'without content_type sent' do
+          it 'will raise an error' do
+            vcr('entry/select_one_field') {
+              expect { client.entries(select: ['sys', 'fields.name'], 'sys.id' => 'nyancat') }.to raise_error Contentful::BadRequest
+            }
+          end
+        end
+      end
+    end
+
+    context 'without sys sent' do
+      it 'will enforce sys anyway' do
+        vcr('entry/select_no_sys') {
+          entry = client.entries(select: ['fields'], 'sys.id' => 'nyancat').first
+
+          expect(entry.id).to eq 'nyancat'
+          expect(entry.sys).not_to be_empty
+        }
+      end
+
+      it 'works with empty array as well, as sys is enforced' do
+        vcr('entry/select_empty_array') {
+          entry = client.entries(select: [], 'sys.id' => 'nyancat').first
+
+          expect(entry.id).to eq 'nyancat'
+          expect(entry.sys).not_to be_empty
+        }
+      end
+    end
+  end
 end

data/spec/fixtures/vcr_cassettes/asset/select_empty_array.yml

@@ -0,0 +1,104 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/assets?select=sys&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - '"87f134c2b4adb7ec01f63ac1d3b15dd8"'
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - d64c3a9dd291011cd26ee2f99f2aa0d9
+      Content-Length:
+      - '487'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:52:07 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8126-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222727.316651,VS0,VE51
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "total": 1,
+          "skip": 0,
+          "limit": 100,
+          "items": [
+            {
+              "sys": {
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "cfexampleapi"
+                  }
+                },
+                "id": "nyancat",
+                "type": "Asset",
+                "createdAt": "2013-09-02T14:56:34.240Z",
+                "updatedAt": "2013-09-02T14:56:34.240Z",
+                "revision": 1,
+                "locale": "en-US"
+              }
+            }
+          ]
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:52:06 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/asset/select_no_sys.yml

@@ -0,0 +1,119 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/assets?select=fields,sys&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - '"0cab5fc96bce67132a639cad150f071d"'
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - f55b5b2f93cef644633d281119afb30a
+      Content-Length:
+      - '952'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:52:06 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8123-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222726.601311,VS0,VE32
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "total": 1,
+          "skip": 0,
+          "limit": 100,
+          "items": [
+            {
+              "fields": {
+                "title": "Nyan Cat",
+                "file": {
+                  "url": "//images.contentful.com/cfexampleapi/4gp6taAwW4CmSgumq2ekUm/9da0cd1936871b8d72343e895a00d611/Nyan_cat_250px_frame.png",
+                  "details": {
+                    "size": 12273,
+                    "image": {
+                      "width": 250,
+                      "height": 250
+                    }
+                  },
+                  "fileName": "Nyan_cat_250px_frame.png",
+                  "contentType": "image/png"
+                }
+              },
+              "sys": {
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "cfexampleapi"
+                  }
+                },
+                "id": "nyancat",
+                "type": "Asset",
+                "createdAt": "2013-09-02T14:56:34.240Z",
+                "updatedAt": "2013-09-02T14:56:34.240Z",
+                "revision": 1,
+                "locale": "en-US"
+              }
+            }
+          ]
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:52:05 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/asset/select_one_field.yml

@@ -0,0 +1,97 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/assets?select=sys,fields.file
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - W/"085ac6af79cdb4d429d04216f7bb5006"
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - d1b7413944dbed021a0834096ac1969e
+      Content-Length:
+      - '778'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Wed, 12 Oct 2016 01:06:40 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-gru7126-GRU
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476234399.815111,VS0,VE352
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        H4sIAAAAAAAAA+WWW2+bMBSA3/srKp4X8A2DeYv6UFVbu1UkatdpqhxsiBMg
+        LMCarOp/nyGhITRbuqyTqjVPHNvn7i/H90fHx0a+zA3v+F5/aqFYZlJLRn8+
+        50tDrz28q84Us4LHep3UUj5VmRZALcQqUYWWIFjJqpBJZfBLbXBlVh8LlYzF
+        xlHtLFRx5aw5U6+V88qPYVkq4ZHMzWCWFjItwjLWn4kVhHLBkyyWPFMWXIBF
+        dl2SzD/1ycdy6i+vTofvrSCACLOAYtcmyJUhoiGBLoAM2Bi50LXELJLmJIuM
+        KoHmZwhZcBVvh1iHlKsfVZg2Qozgtoreq6Ps5FAr3SlRjCstd1WXjSO9OZYq
+        GldFI9gGrRh0uVtSXfrH8KpiXfCk7s7uBNalGqxbWIdmTTIZVX1c/Rrzj6a3
+        ul+dMfKMB92MnpyqTzZ35YNKp1ul1HuxXmsC8WuL3cKJKpF2OzdRtsvQKoKh
+        ap3dXW/Z31ziPJdFeyOYS15I0a9KbyAAcQ/CHqADwDxiexCYAICbtkKZia4C
+        6kF3ALGHHA8Sk0FnS2Euv6tczVLtgG4yNuJZwOu7bsi0N/SbVFftWKf4T1HB
+        5zef0snN4Cyf9s/OpmU5y0/y3MIu4sQVIUfBCNKAOFx/OSh0RgiPQsCsMc+y
+        ZcCLuwN4YQyzbtf34YKcDmFtWjBzDoDlNym8EWKaChzICGA9gAaQeDb1MDER
+        3b7yTxlZK2iioIeIiSn8FSPoNTFCoowWvH93RU4SPyqTb0hOh4nFBAeBgAxT
+        14EjVzgIEyxdZnMABIXQuljy9FYzcotskC1uw7n+lzaz9A/HC0RP7v7+6aI9
+        bhPWxkVvHoDL87LZSU6V8381alLdWd3YF+KG7JstXdA6Cq3ZAl8VN+O4kJf9
+        a99VPvh8cj6kl+dXkaUni3ARhYSEABIINEAkCEI7cBkUSAhrwqcHcIIAcTuX
+        fj8n68dp8wyqny+PjzBI4QGc7I7+bXBR5f5CUNBnQmF7CHmYmYTSvx8mut1f
+        jx6OfgL41JO2/wwAAA==
+    http_version: 
+  recorded_at: Wed, 12 Oct 2016 01:06:40 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/asset/select_only_sys.yml

@@ -0,0 +1,88 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/assets?select=sys
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - W/"ab5a0e424e4930d0e5a81480700cc930"
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - 79b396f10bc2940719a0951035039f8f
+      Content-Length:
+      - '380'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:52:05 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8138-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222725.125826,VS0,VE30
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        H4sIAAAAAAAAA+VUPU/DMBDd+yuqzCSyHdcl3jp1AIkhqUAgBis1wiRNrdhF
+        jar+d2ynaZ0gVBAsqDf5Xe775W43Go8D1aiAjnfmaYBuJDcomNU1awKj219Z
+        G73WrDR67JAqhDQAOFCKldAGQdBiofnKBnxyAduwgywuk5Ist6k6i1bp1WIV
+        TtnVdCuqIrA5T2KyV0V2qDl1EQcGYmnbyV/4lq1kyZkUtqtO9se367OVoPWB
+        W7CVDxss03mK7zZF2tzPFzde/NOwlOLa/5DXnGm+nNm5BAjAOIQwBCQDCcUT
+        CkEEAHj0HTZyOXRAIbzOYEzRlEIcJXDac6j5u1BiXZkExKu8XOesdATyKlyk
+        Xattm4cW/zElr0zKJme9WR//2PMkgCQEKIOYTgiNcYRIf6afSTg4GMogRTiK
+        CfyKBHQ5JFQNq/6OA3xuEYakDRy8RYCXw8EbK/xL95NLNJwn+SYBE4oQjZMI
+        E/L7JTC39nm0H30AkgXzyoAGAAA=
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:52:04 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/entry/select_empty_array.yml

@@ -0,0 +1,111 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/entries?select=sys&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - '"df5a0bca323bd8fb0e370f41cf07a148"'
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - f8fa255397530ecd6c842426aeeea221
+      Content-Length:
+      - '645'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:48:00 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '114'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8120-JFK
+      X-Cache:
+      - HIT
+      X-Cache-Hits:
+      - '1'
+      X-Timer:
+      - S1476222480.429217,VS0,VE0
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "total": 1,
+          "skip": 0,
+          "limit": 100,
+          "items": [
+            {
+              "sys": {
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "cfexampleapi"
+                  }
+                },
+                "id": "nyancat",
+                "type": "Entry",
+                "createdAt": "2013-06-27T22:46:19.513Z",
+                "updatedAt": "2013-09-04T09:19:39.027Z",
+                "revision": 5,
+                "contentType": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "ContentType",
+                    "id": "cat"
+                  }
+                },
+                "locale": "en-US"
+              }
+            }
+          ]
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:47:59 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/entry/select_no_sys.yml

@@ -0,0 +1,102 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/entries?select=fields,sys&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Encoding:
+      - gzip
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - W/"3c46068783b671b134692b4f78a7fa2f"
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - b324e9d019b4904cdb24b892102dad8d
+      Content-Length:
+      - '1022'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:44:39 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8139-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222279.159150,VS0,VE143
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        H4sIAAAAAAAAA+VX227bOBB9z1cEeu1a4kX3NyPYxQboFgvERYEURUBLtM1Y
+        klWJbuoW+feS1I2UZTdNvU8rGLYoc4YzZ85c9P3q+tqqD7UVX38Xt2LBDyUV
+        K2teVeRgiWfPf8g9fMdJJp5Dtaq3rBQLoBYZyxmXf4FmzTjNpcKPSmGjVmxb
+        MZqlw0HqsILk6rB3B1Jc3xBuSYXNJdRu6aCmfVgRVix3T7W2UamuN9LU5vqk
+        KUl22a6SJ7SC+gFLWvO/KkaLtPe+PUUHpLenA+YtK7bG8QqCYrtogfuz4NVh
+        vIHJM6wNKctDItzsbRXw9vcK6NaCJav4JhUBEFIIQDgDrvgsEIoBEJ836ttE
+        64tCC2IcaHpYTtYS4S4KUr0R7192b17XVI+T0ti4V4gonvauda738sgMqy5J
+        cllj75TGAQ/N2GRFv5K8zCgp2c/jYTqoAdyxYhx1K6ko4TSdy8yQIcQz4M9Q
+        IEPo+jGMbA/iez2C+zIdC0Qy5iASu2Mc2QAFhkBFv7Ca7QpxgGdQvuC04C0d
+        Lxf4m92gdxrRlxA72yUkUzlPi9n7uw75Jgvkt8peixVJtk8Vo9u61ADcVZWh
+        rkzyeZJKkzsVI86k9ii5pwjV8/8UpfQkb+tpn3ajwqAD25s15pY48Dy7ELBh
+        AHWyCJFjfomyAsMF9GIvjAGyAQxHIhrDQsOyROOCWVwuAfJppg1Qm1w7h/AJ
+        xhmBmGpO4qyuPf0t6/aoPyliHHcoGZsNpd+W+2pNK72waG1Jbuoa01q2WQPc
+        k33pEtgec+l8AT+HrNmkAJ5BMEPhAuETTUpB1rYpw+OpLnUJZ6d6VU+hqWY8
+        8nZozV3zUr9tJK1G/f+yJB0jO1WSRP9CC+jGnh9j10a+0b9EII5LEmhEvBjC
+        GLk29sdVTCtJyODQb6Q5Z7xpSSfyfMXU33orlcZXch62HEext7bbmrjaZ+I2
+        d/Rm4OB/7v8tHu8Xt/V2fnu73e939U1dOzhExA3TFUHJEvqJGxBxF6BVsER4
+        uQKR03H0yX4s1+M5JqWcsMycqJu+YtXsm7TYiyIcmb1a0n9iJmzlnljKN0IQ
+        BXgsJgQ3lK03cp7BUdCnRiM5TLFyrU2yqrpIAN+1o/5Zl8y+0ljqPJZ0fWJC
+        G8+UQ4iOpktZTybmy0uUmf9oKOjG6cmZ4FUJ6IKfzgRtAvY5eySiJaB6F+wu
+        6xIJOPEe2NLn9/LPXZc+J/OnD+5Nfrfe558R3b7PnSglIElhhP0wgMswDRB2
+        MQ0jjwCQ+hA60p4H8UrzgDxQfn1YVYLEdlm8IhUhmsipF6Wip96qzWtIRWHY
+        q1Pxpd5NZqVEQTtZe401e6VYPV89X/0A9oLYTmkQAAA=
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:44:38 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/entry/select_one_field.yml

@@ -0,0 +1,76 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/entries?select=sys,fields.name&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.contentful.com
+  response:
+    status:
+      code: 400
+      message: Bad Request
+    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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Server:
+      - Contentful
+      X-Contentful-Request-Id:
+      - 9c4cc23976ca91562c72e53c04fe70c3
+      Content-Length:
+      - '354'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:48:16 GMT
+      Via:
+      - 1.1 varnish
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8122-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222496.116198,VS0,VE31
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Error",
+            "id": "BadRequest"
+          },
+          "message": "A Content Type ID is required. When querying for Entries and involving fields you need to limit your query to a specific Content Type. Please send a Content Type ID (not the name) as the URI query parameter \"content_type\"",
+          "requestId": "9c4cc23976ca91562c72e53c04fe70c3"
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:48:15 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/entry/select_one_field_proper.yml

@@ -0,0 +1,114 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/entries?content_type=cat&select=sys,fields.name&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - '"5bceeb558eb6136686e5aae912e25903"'
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - 309c7fd04e9f5a7a4518df8412b92c62
+      Content-Length:
+      - '699'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:48:15 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '0'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8140-JFK
+      X-Cache:
+      - MISS
+      X-Cache-Hits:
+      - '0'
+      X-Timer:
+      - S1476222495.442871,VS0,VE44
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "total": 1,
+          "skip": 0,
+          "limit": 100,
+          "items": [
+            {
+              "fields": {
+                "name": "Nyan Cat"
+              },
+              "sys": {
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "cfexampleapi"
+                  }
+                },
+                "id": "nyancat",
+                "type": "Entry",
+                "createdAt": "2013-06-27T22:46:19.513Z",
+                "updatedAt": "2013-09-04T09:19:39.027Z",
+                "revision": 5,
+                "contentType": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "ContentType",
+                    "id": "cat"
+                  }
+                },
+                "locale": "en-US"
+              }
+            }
+          ]
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:48:14 GMT
+recorded_with: VCR 3.0.3

data/spec/fixtures/vcr_cassettes/entry/select_only_sys.yml

@@ -0,0 +1,111 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://cdn.contentful.com/spaces/cfexampleapi/entries?select=sys&sys.id=nyancat
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - RubyContentfulGem/1.0.2
+      Authorization:
+      - Bearer b4c0n73n7fu1
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Accept-Encoding:
+      - gzip
+      Connection:
+      - close
+      Host:
+      - cdn.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:
+      - GET,HEAD,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '86400'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.delivery.v1+json
+      Etag:
+      - '"df5a0bca323bd8fb0e370f41cf07a148"'
+      Server:
+      - Contentful
+      X-Content-Type-Options:
+      - nosniff
+      - nosniff
+      X-Contentful-Request-Id:
+      - f8fa255397530ecd6c842426aeeea221
+      Content-Length:
+      - '645'
+      Accept-Ranges:
+      - bytes
+      Date:
+      - Tue, 11 Oct 2016 21:47:59 GMT
+      Via:
+      - 1.1 varnish
+      Age:
+      - '113'
+      Connection:
+      - close
+      X-Served-By:
+      - cache-jfk8121-JFK
+      X-Cache:
+      - HIT
+      X-Cache-Hits:
+      - '1'
+      X-Timer:
+      - S1476222479.776857,VS0,VE0
+      Vary:
+      - Accept-Encoding
+    body:
+      encoding: ASCII-8BIT
+      string: |
+        {
+          "sys": {
+            "type": "Array"
+          },
+          "total": 1,
+          "skip": 0,
+          "limit": 100,
+          "items": [
+            {
+              "sys": {
+                "space": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "Space",
+                    "id": "cfexampleapi"
+                  }
+                },
+                "id": "nyancat",
+                "type": "Entry",
+                "createdAt": "2013-06-27T22:46:19.513Z",
+                "updatedAt": "2013-09-04T09:19:39.027Z",
+                "revision": 5,
+                "contentType": {
+                  "sys": {
+                    "type": "Link",
+                    "linkType": "ContentType",
+                    "id": "cat"
+                  }
+                },
+                "locale": "en-US"
+              }
+            }
+          ]
+        }
+    http_version: 
+  recorded_at: Tue, 11 Oct 2016 21:47:59 GMT
+recorded_with: VCR 3.0.3

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contentful
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Contentful GmbH (Jan Lelis)
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-05 00:00:00.000000000 Z
+date: 2016-10-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -278,6 +278,7 @@ files:
 - doc/Contentful/Resource/CustomResource.html
 - doc/Contentful/Resource/Fields.html
 - doc/Contentful/Resource/Fields/ClassMethods.html
+- doc/Contentful/Resource/LocalizedFields.html
 - doc/Contentful/Resource/SystemProperties.html
 - doc/Contentful/Resource/SystemProperties/ClassMethods.html
 - doc/Contentful/ResourceBuilder.html
@@ -370,6 +371,10 @@ files:
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/array_page_2.yml
 - spec/fixtures/vcr_cassettes/asset.yml
+- spec/fixtures/vcr_cassettes/asset/select_empty_array.yml
+- spec/fixtures/vcr_cassettes/asset/select_no_sys.yml
+- spec/fixtures/vcr_cassettes/asset/select_one_field.yml
+- spec/fixtures/vcr_cassettes/asset/select_only_sys.yml
 - spec/fixtures/vcr_cassettes/bad_request.yml
 - spec/fixtures/vcr_cassettes/content_type.yml
 - spec/fixtures/vcr_cassettes/entries.yml
@@ -379,6 +384,11 @@ files:
 - spec/fixtures/vcr_cassettes/entry/json_objects_client.yml
 - spec/fixtures/vcr_cassettes/entry/marshall.yml
 - spec/fixtures/vcr_cassettes/entry/raw.yml
+- spec/fixtures/vcr_cassettes/entry/select_empty_array.yml
+- spec/fixtures/vcr_cassettes/entry/select_no_sys.yml
+- spec/fixtures/vcr_cassettes/entry/select_one_field.yml
+- spec/fixtures/vcr_cassettes/entry/select_one_field_proper.yml
+- spec/fixtures/vcr_cassettes/entry/select_only_sys.yml
 - spec/fixtures/vcr_cassettes/entry_cache.yml
 - spec/fixtures/vcr_cassettes/entry_locales.yml
 - spec/fixtures/vcr_cassettes/field.yml
@@ -468,6 +478,10 @@ test_files:
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/array_page_2.yml
 - spec/fixtures/vcr_cassettes/asset.yml
+- spec/fixtures/vcr_cassettes/asset/select_empty_array.yml
+- spec/fixtures/vcr_cassettes/asset/select_no_sys.yml
+- spec/fixtures/vcr_cassettes/asset/select_one_field.yml
+- spec/fixtures/vcr_cassettes/asset/select_only_sys.yml
 - spec/fixtures/vcr_cassettes/bad_request.yml
 - spec/fixtures/vcr_cassettes/content_type.yml
 - spec/fixtures/vcr_cassettes/entries.yml
@@ -477,6 +491,11 @@ test_files:
 - spec/fixtures/vcr_cassettes/entry/json_objects_client.yml
 - spec/fixtures/vcr_cassettes/entry/marshall.yml
 - spec/fixtures/vcr_cassettes/entry/raw.yml
+- spec/fixtures/vcr_cassettes/entry/select_empty_array.yml
+- spec/fixtures/vcr_cassettes/entry/select_no_sys.yml
+- spec/fixtures/vcr_cassettes/entry/select_one_field.yml
+- spec/fixtures/vcr_cassettes/entry/select_one_field_proper.yml
+- spec/fixtures/vcr_cassettes/entry/select_only_sys.yml
 - spec/fixtures/vcr_cassettes/entry_cache.yml
 - spec/fixtures/vcr_cassettes/entry_locales.yml
 - spec/fixtures/vcr_cassettes/field.yml