contentful-management 2.5.0 → 2.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 683b48fdab7cafe30ccbc6ba4359db731ce08a97f59b83cae82397a3982f03bf
-  data.tar.gz: bf94afa87c07baa3daca8e6b70dad36000fadffcd41334e625ddadfe4f25197f
+  metadata.gz: 3cfd74c3a04e3793e905a34376d42fb480b87db5c90e54d139139f4487502dd3
+  data.tar.gz: 59e6df1fcb94c5f2d0bc5332ed47432c28fd0430df70a2a72b0bb14f484a20c2
 SHA512:
-  metadata.gz: bbebbb891e59e74e85919ea4e8e992ace7c467b652a098d8668cf5b587744789ac8fc4de1dff1026a1a010ad0d85aa33c99bfbfb01fd0a437e2c8e287841fb56
-  data.tar.gz: 6e0af2ee33543eab79af415edaa8939a6ab747d858d8717d16a621aaf45a898e50dca21cb0fdf2282c2b691b599d3935a4d87f2781c5c57da85baaed05157025
+  metadata.gz: ef4905fce5b2beedf604320370e9f90bdc1f784e8cf02f36bd831a11e73db29d55a9f67865481da39c38974bfa43f828266b7f031bfcde4da7cb9ff957aa59ec
+  data.tar.gz: bfb19ea973172df0fd8578eb780efd94a3ac931526b9e0646c9d9cac03e4bbeea0ad5a7faa5d5bc2154c8fc77b4cce85cdbc15bfce01b9a7dfabdc7a9b52f69e

data/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Master
 
+## 2.6.0
+### Added
+* Added Usage Periods API.
+* Added API Usages API.
+
 ## 2.5.0
 
 As `RichText` moves from `alpha` to `beta`, we're treating this as a feature release.

data/README.md

@@ -8,6 +8,7 @@ Ruby client for the Contentful Content Management API.
 ## Setup
 
 Add this line to your application's Gemfile:
+
 ```ruby
 gem 'contentful-management'
 ```
@@ -15,7 +16,7 @@ gem 'contentful-management'
 ## Usage
 
 ### Examples
-Some examples can be found in the ```examples/``` directory or you take a look at this [extended example script](https://github.com/contentful/cma_import_script).
+Some examples can be found in the `examples/` directory or you take a look at this [extended example script](https://github.com/contentful/cma_import_script).
 
 ### Client
 
@@ -597,12 +598,24 @@ Creating a locale:
 environment.locales.create(name: 'German', code: 'de-DE')
 ```
 
+Creating a locale with fallback:
+
+```ruby
+environment.locales.create(name: 'German', code: 'de-DE', fallback_code: 'en-US')
+```
+
 Updating a locale:
 
 ```ruby
 blog_post_locale.update(name: 'German', code: 'de-DE')
 ```
 
+Updating a locale with fallback:
+
+```ruby
+blog_post_locale.update(name: 'German', code: 'de-DE', fallback_code: 'en-US')
+```
+
 Destroying a locale:
 
 ```ruby
@@ -796,6 +809,42 @@ Retrieving all organization details:
 organizations = client.organizations.all
 ```
 
+### Usage Periods (ALPHA)
+
+*Note*: This feature is available only to Commited v2 customers.
+
+Retrieving all Usage Periods for an Organizations you belong to:
+
+```ruby
+usage_periods = client.usage_periods('organization_id').all
+```
+
+Alternatively, if you have an already fetched organization:
+
+```ruby
+usage_periods = organization.usage_periods().all()
+```
+
+### API Usage (ALPHA)
+
+*Note*: This feature is available only to Commited v2 customers.
+
+Retrieving all API Usage statistics for an Organizations during a given usage period, broken down by organization for all APIs:
+
+```ruby
+# Valid usage types are by 'organization' and by 'space'.
+# Usage period IDs are numerical and can be fetched from the Usage Periods API.
+# Valid API breakdowns are: 'cda', 'cpa', 'cma' or 'all_apis'.
+usage = client.api_usage('organization_id').all('organization', usage_period_id, 'all_apis')
+```
+
+Alternatively, if you have an already fetched organization:
+
+```ruby
+# Breaking down CMA usage by space, for a given period.
+usage = organization.api_usage().all('space', usage_period_id, 'cma')
+```
+
 ### Users
 
 Retrieving current user details:

data/lib/contentful/management/api_usage.rb

@@ -0,0 +1,67 @@
+require_relative 'resource'
+
+module Contentful
+  module Management
+    # Resource class for ApiUsage.
+    # @see _ https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-usages
+    class ApiUsage
+      include Contentful::Management::Resource
+      include Contentful::Management::Resource::Refresher
+      include Contentful::Management::Resource::SystemProperties
+
+      property :unitOfMeasure
+      property :interval
+      property :usage
+      property :startDate, :date
+      property :endDate, :date
+
+      # @private
+      def self.build_endpoint(endpoint_options)
+        organization_id = endpoint_options[:organization_id]
+        usage_type = endpoint_options[:usage_type]
+
+        "organizations/#{organization_id}/usages/#{usage_type}"
+      end
+
+      # Gets all api usage statistics for a given organization and usage type, filtered by usage period and api.
+      #
+      # @param [Contentful::Management::Client] client
+      # @param [String] organization_id
+      # @param [String] usage_type
+      # @param [Integer] usage_period_id
+      # @param [String] api
+      # @param [Hash] params
+      #
+      # @return [Contentful::Management::Array<Contentful::Management::ApiUsage>]
+      # rubocop:disable Metrics/ParameterLists
+      def self.all(client, organization_id, usage_type, usage_period_id, api, params = {})
+        ClientApiUsageMethodsFactory.new(client, organization_id).all(usage_type, usage_period_id, api, params)
+      end
+
+      # Not supported
+      def self.find(*)
+        fail 'Not supported'
+      end
+
+      # @private
+      def self.endpoint
+        'usages'
+      end
+
+      # Not supported
+      def self.create(*)
+        fail 'Not supported'
+      end
+
+      # Not supported
+      def destroy
+        fail 'Not supported'
+      end
+
+      # Not supported
+      def update(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/client.rb

@@ -20,7 +20,9 @@ require 'contentful/management/client_upload_methods_factory'
 require 'contentful/management/client_api_key_methods_factory'
 require 'contentful/management/client_webhook_methods_factory'
 require 'contentful/management/client_snapshot_methods_factory'
+require 'contentful/management/client_api_usage_methods_factory'
 require 'contentful/management/client_environment_methods_factory'
+require 'contentful/management/client_usage_period_methods_factory'
 require 'contentful/management/client_organization_methods_factory'
 require 'contentful/management/client_content_type_methods_factory'
 require 'contentful/management/client_ui_extension_methods_factory'
@@ -131,6 +133,24 @@ module Contentful
         ClientOrganizationMethodsFactory.new(self)
       end
 
+      # Allows viewing of usage periods in context of the current client
+      # Allows listing all usage periods for client.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientUsagePeriodMethodsFactory]
+      def usage_periods(organization_id)
+        ClientUsagePeriodMethodsFactory.new(self, organization_id)
+      end
+
+      # Allows viewing of api usage in context of the current client
+      # Allows listing all api usage for client.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
+      def api_usage(organization_id)
+        ClientApiUsageMethodsFactory.new(self, organization_id)
+      end
+
       # Allows viewing of users in context of the current client
       # Allows listing all users for client.
       # @see _ README for details.

data/lib/contentful/management/client_api_usage_methods_factory.rb

@@ -0,0 +1,44 @@
+require_relative 'client_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for API Usage for usage from within Client
+    # @private
+    class ClientApiUsageMethodsFactory
+      include Contentful::Management::ClientAssociationMethodsFactory
+
+      def initialize(client, organization_id)
+        super(client)
+        @organization_id = organization_id
+      end
+
+      def all(usage_type, usage_period_id, api, params = {})
+        mandatory_params = {
+          'filters[usagePeriod]' => usage_period_id,
+          'filters[metric]' => api
+        }
+
+        @resource_requester.all(
+          {
+            usage_type: usage_type,
+            organization_id: @organization_id
+          },
+          mandatory_params.merge(params),
+          'x-contentful-enable-alpha-feature' => 'usage-insights'
+        )
+      end
+
+      def new(*)
+        fail 'Not supported'
+      end
+
+      def find(*)
+        fail 'Not supported'
+      end
+
+      def create(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/client_usage_period_methods_factory.rb

@@ -0,0 +1,38 @@
+require_relative 'client_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for Usage Period for usage from within Client
+    # @private
+    class ClientUsagePeriodMethodsFactory
+      include Contentful::Management::ClientAssociationMethodsFactory
+
+      def initialize(client, organization_id)
+        super(client)
+        @organization_id = organization_id
+      end
+
+      def all(params = {})
+        @resource_requester.all(
+          {
+            organization_id: @organization_id
+          },
+          params,
+          'x-contentful-enable-alpha-feature' => 'usage-insights'
+        )
+      end
+
+      def new(*)
+        fail 'Not supported'
+      end
+
+      def find(*)
+        fail 'Not supported'
+      end
+
+      def create(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/organization.rb

@@ -15,6 +15,22 @@ module Contentful
       def self.build_endpoint(_endpoint_options)
         'organizations'
       end
+
+      # Allows listing all usage periods for organization.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
+      def usage_periods
+        ClientApiUsageMethodsFactory.new(client, id)
+      end
+
+      # Allows listing all api usage for organization.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
+      def api_usage
+        ClientApiUsageMethodsFactory.new(client, id)
+      end
     end
   end
 end

data/lib/contentful/management/resource_builder.rb

@@ -12,7 +12,9 @@ require_relative 'webhook'
 require_relative 'api_key'
 require_relative 'resource'
 require_relative 'snapshot'
+require_relative 'api_usage'
 require_relative 'environment'
+require_relative 'usage_period'
 require_relative 'organization'
 require_relative 'content_type'
 require_relative 'webhook_call'
@@ -35,6 +37,8 @@ module Contentful
         'Space' => Contentful::Management::Space,
         'SpaceMembership' => Contentful::Management::SpaceMembership,
         'Organization' => Contentful::Management::Organization,
+        'ApiUsage' => Contentful::Management::ApiUsage,
+        'UsagePeriod' => Contentful::Management::UsagePeriod,
         'User' => Contentful::Management::User,
         'Environment' => Contentful::Management::Environment,
         'ContentType' => Contentful::Management::ContentType,

data/lib/contentful/management/resource_requester.rb

@@ -10,9 +10,9 @@ module Contentful
         @resource_class = resource_class
       end
 
-      def all(endpoint_options = {}, query = {})
+      def all(endpoint_options = {}, query = {}, headers = {})
         query = resource_class.pre_process_params(query)
-        get(endpoint_options, query)
+        get(endpoint_options, query, headers)
       end
 
       def find(endpoint_options = {})
@@ -60,11 +60,13 @@ module Contentful
         false
       end
 
-      def get(endpoint_options = {}, query = {})
+      def get(endpoint_options = {}, query = {}, headers = {})
         request = Request.new(
           client,
           resource_class.build_endpoint(endpoint_options),
-          query
+          query,
+          nil,
+          headers
         )
         ResourceBuilder.new(request.get, client).run
       end

data/lib/contentful/management/usage_period.rb

@@ -0,0 +1,59 @@
+require_relative 'resource'
+
+module Contentful
+  module Management
+    # Resource class for UsagePeriod.
+    # @see _ https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-usages
+    class UsagePeriod
+      include Contentful::Management::Resource
+      include Contentful::Management::Resource::Refresher
+      include Contentful::Management::Resource::SystemProperties
+
+      property :startDate, :date
+      property :endDate, :date
+
+      # @private
+      def self.build_endpoint(endpoint_options)
+        organization_id = endpoint_options[:organization_id]
+
+        "organizations/#{organization_id}/usage_periods"
+      end
+
+      # Gets all usage periods for a given organization.
+      #
+      # @param [Contentful::Management::Client] client
+      # @param [String] organization_id
+      # @param [Hash] params
+      #
+      # @return [Contentful::Management::Array<Contentful::Management::UsagePeriod>]
+      def self.all(client, organization_id, params = {})
+        ClientUsagePeriodMethodsFactory.new(client, organization_id).all(params)
+      end
+
+      # Not supported
+      def self.find(*)
+        fail 'Not supported'
+      end
+
+      # @private
+      def self.endpoint
+        'usages'
+      end
+
+      # Not supported
+      def self.create(*)
+        fail 'Not supported'
+      end
+
+      # Not supported
+      def destroy
+        fail 'Not supported'
+      end
+
+      # Not supported
+      def update(*)
+        fail 'Not supported'
+      end
+    end
+  end
+end

data/lib/contentful/management/version.rb

@@ -3,6 +3,6 @@ module Contentful
   # Management Namespace
   module Management
     # Gem Version
-    VERSION = '2.5.0'.freeze
+    VERSION = '2.6.0'.freeze
   end
 end

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

@@ -0,0 +1,155 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/organizations/org_id/usages/organization?filters%5Bmetric%5D=cda&filters%5BusagePeriod%5D=1
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/2.5.0; platform ruby/2.4.1; os macOS/16;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      X-Contentful-Enable-Alpha-Feature:
+      - usage-insights
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/2.2.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      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,X-Contentful-Enable-Alpha-Feature
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Contentful-Api:
+      - cma
+      Date:
+      - Sat, 10 Nov 2018 10:47:53 GMT
+      Etag:
+      - W/"efdf341b30e8c442ecb1bfe1b7f21817"
+      Referrer-Policy:
+      - strict-origin-when-cross-origin
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Request-Id:
+      - 26c4437bd5b8c12ee6b71ad955dd7339
+      X-Download-Options:
+      - noopen
+      X-Frame-Options:
+      - ALLOWALL
+      X-Permitted-Cross-Domain-Policies:
+      - none
+      X-Xss-Protection:
+      - 1; mode=block
+      Content-Length:
+      - '959'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_728_673446=17XUL5vN1wivb82OzmAaCli35lsAAAAAbBLg2M0OjfGoassR05osmA==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=r1SmH3jioiwG5xWr6lKYhQAAAAB3pI+2F+Uz7kJVuxNgDetk; path=/; Domain=.contentful.com
+      - visid_incap_673446=BbPQYzUTTGyyIO44A0XYili35lsAAAAAQUIPAAAAAABSSTQWr6HEWN7pTaZKxfmU;
+        expires=Sat, 09 Nov 2019 14:12:09 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 3-12615349-12615354 NNNN CT(0 0 0) RT(1541846872399 65) q(0 0 0 -1) r(1 1)
+        U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |+
+        {
+          "total":1,
+          "limit":25,
+          "skip":0,
+          "sys":{
+            "type":"Array"
+          },
+          "items":[
+            {
+              "unitOfMeasure":"apiRequests",
+              "interval":"daily",
+              "usage":[
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                9423,
+                49300,
+                12546,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0,
+                0
+              ],
+              "sys":{
+                "type":"ApiUsage",
+                "id":"1_org_id",
+                "organization":{
+                  "sys":{
+                    "type":"Link",
+                    "linkType":"Organization",
+                    "id":"org_id"
+                  }
+                },
+                "usagePeriod":{
+                  "sys":{
+                    "type":"Link",
+                    "linkType":"UsagePeriod",
+                    "id":"1"
+                  }
+                }
+              }
+            }
+          ]
+        }
+
+    http_version: 
+  recorded_at: Sat, 10 Nov 2018 10:47:53 GMT
+recorded_with: VCR 4.0.0

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

@@ -0,0 +1,114 @@
+---
+http_interactions:
+- request:
+    method: get
+    uri: https://api.contentful.com/organizations/org_id/usage_periods
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      X-Contentful-User-Agent:
+      - sdk contentful-management.rb/2.5.0; platform ruby/2.4.1; os macOS/16;
+      Authorization:
+      - Bearer <ACCESS_TOKEN>
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      X-Contentful-Enable-Alpha-Feature:
+      - usage-insights
+      Connection:
+      - close
+      Host:
+      - api.contentful.com
+      User-Agent:
+      - http.rb/2.2.2
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Accept-Ranges:
+      - bytes
+      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,X-Contentful-Enable-Alpha-Feature
+      Access-Control-Allow-Methods:
+      - DELETE,GET,HEAD,POST,PUT,OPTIONS
+      Access-Control-Allow-Origin:
+      - "*"
+      Access-Control-Expose-Headers:
+      - Etag
+      Access-Control-Max-Age:
+      - '1728000'
+      Cache-Control:
+      - max-age=0
+      Content-Type:
+      - application/vnd.contentful.management.v1+json
+      Contentful-Api:
+      - cma
+      Date:
+      - Sat, 10 Nov 2018 10:59:12 GMT
+      Etag:
+      - W/"0e32a37f3690af7bd68571521823b4c3"
+      Referrer-Policy:
+      - strict-origin-when-cross-origin
+      Server:
+      - Contentful
+      Strict-Transport-Security:
+      - max-age=15768000
+      X-Content-Type-Options:
+      - nosniff
+      X-Contentful-Request-Id:
+      - 9e2af1c902719cf6251824eb8bad9a5b
+      X-Download-Options:
+      - noopen
+      X-Frame-Options:
+      - ALLOWALL
+      X-Permitted-Cross-Domain-Policies:
+      - none
+      X-Xss-Protection:
+      - 1; mode=block
+      Content-Length:
+      - '347'
+      Connection:
+      - Close
+      Set-Cookie:
+      - incap_ses_728_673446=emwoQG4P7gsAZ9COzmAaCv+55lsAAAAA12p7HXlIfXdD2z8IqJzDPw==;
+        path=/; Domain=.contentful.com
+      - nlbi_673446=JuK/CqPU8mAD0NE+6lKYhQAAAAAeh+9STttZdZDE0eCH49c3; path=/; Domain=.contentful.com
+      - visid_incap_673446=3rYhv3e6Tf2l54SFmGsgOP+55lsAAAAAQUIPAAAAAAA6Tug0qWXjQ5TjaPxx4YJR;
+        expires=Sat, 09 Nov 2019 14:12:09 GMT; path=/; Domain=.contentful.com
+      X-Iinfo:
+      - 6-10352937-10352945 NNNN CT(90 182 0) RT(1541847550884 85) q(0 0 3 -1) r(5
+        5) U5
+      X-Cdn:
+      - Incapsula
+    body:
+      encoding: ASCII-8BIT
+      string: |+
+        {
+          "total":2,
+          "sys":{
+            "type":"Array"
+          },
+          "items":[
+            {
+              "startDate":"2018-11-01",
+              "endDate":null,
+              "sys":{
+                "type":"UsagePeriod",
+                "id":"2"
+              }
+            },
+            {
+              "startDate":"2018-10-01",
+              "endDate":"2018-10-31",
+              "sys":{
+                "type":"UsagePeriod",
+                "id":"1"
+              }
+            }
+          ]
+        }
+
+    http_version: 
+  recorded_at: Sat, 10 Nov 2018 10:59:12 GMT
+recorded_with: VCR 4.0.0

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

@@ -0,0 +1,28 @@
+require 'spec_helper'
+require 'contentful/management/space'
+require 'contentful/management/client'
+
+module Contentful
+  module Management
+    describe ApiKey do
+      let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
+      let(:organization_id) { 'org_id' }
+
+      let!(:client) { Client.new(token ) }
+
+      subject { client.api_usage(organization_id) }
+
+      describe '.all' do
+        it 'class method also works' do
+          vcr('api_usage/all') { expect(Contentful::Management::ApiUsage.all(client, organization_id, 'organization', 1, 'cda')).to be_kind_of Contentful::Management::Array }
+        end
+        it 'returns a Contentful::Array' do
+          vcr('api_usage/all') { expect(subject.all('organization', 1, 'cda')).to be_kind_of Contentful::Management::Array }
+        end
+        it 'builds a Contentful::Management::ApiUsage object' do
+          vcr('api_usage/all') { expect(subject.all('organization', 1, 'cda').first).to be_kind_of Contentful::Management::ApiUsage }
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,27 @@
+require 'spec_helper'
+require 'contentful/management/client'
+
+module Contentful
+  module Management
+    describe ApiKey do
+      let(:token) { ENV.fetch('CF_TEST_CMA_TOKEN', '<ACCESS_TOKEN>') }
+      let(:organization_id) { 'org_id' }
+
+      let!(:client) { Client.new(token ) }
+
+      subject { client.usage_periods(organization_id) }
+
+      describe '.all' do
+        it 'class method also works' do
+          vcr('usage_period/all') { expect(Contentful::Management::UsagePeriod.all(client, organization_id)).to be_kind_of Contentful::Management::Array }
+        end
+        it 'returns a Contentful::Array' do
+          vcr('usage_period/all') { expect(subject.all).to be_kind_of Contentful::Management::Array }
+        end
+        it 'builds a Contentful::Management::UsagePeriod object' do
+          vcr('usage_period/all') { expect(subject.all.first).to be_kind_of Contentful::Management::UsagePeriod }
+        end
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: contentful-management
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.6.0
 platform: ruby
 authors:
 - Piotr Protas
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-10-15 00:00:00.000000000 Z
+date: 2018-11-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: http
@@ -293,10 +293,12 @@ files:
 - examples/create_space.rb
 - lib/contentful/management.rb
 - lib/contentful/management/api_key.rb
+- lib/contentful/management/api_usage.rb
 - lib/contentful/management/array.rb
 - lib/contentful/management/asset.rb
 - lib/contentful/management/client.rb
 - lib/contentful/management/client_api_key_methods_factory.rb
+- lib/contentful/management/client_api_usage_methods_factory.rb
 - lib/contentful/management/client_asset_methods_factory.rb
 - lib/contentful/management/client_association_all_published_method_factory.rb
 - lib/contentful/management/client_association_methods_factory.rb
@@ -314,6 +316,7 @@ files:
 - lib/contentful/management/client_space_methods_factory.rb
 - lib/contentful/management/client_ui_extension_methods_factory.rb
 - lib/contentful/management/client_upload_methods_factory.rb
+- lib/contentful/management/client_usage_period_methods_factory.rb
 - lib/contentful/management/client_user_methods_factory.rb
 - lib/contentful/management/client_webhook_call_methods_factory.rb
 - lib/contentful/management/client_webhook_health_methods_factory.rb
@@ -374,6 +377,7 @@ files:
 - lib/contentful/management/support.rb
 - lib/contentful/management/ui_extension.rb
 - lib/contentful/management/upload.rb
+- lib/contentful/management/usage_period.rb
 - lib/contentful/management/user.rb
 - lib/contentful/management/validation.rb
 - lib/contentful/management/version.rb
@@ -414,6 +418,7 @@ files:
 - spec/fixtures/vcr_cassettes/api_key/find.yml
 - spec/fixtures/vcr_cassettes/api_key/find_for_space_not_found.yml
 - spec/fixtures/vcr_cassettes/api_key/preview.yml
+- spec/fixtures/vcr_cassettes/api_usage/all.yml
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/asset/143_assets_next_page.yml
 - spec/fixtures/vcr_cassettes/asset/all.yml
@@ -703,6 +708,7 @@ files:
 - spec/fixtures/vcr_cassettes/upload/destroy.yml
 - spec/fixtures/vcr_cassettes/upload/find.yml
 - spec/fixtures/vcr_cassettes/upload/find_not_found.yml
+- spec/fixtures/vcr_cassettes/usage_period/all.yml
 - spec/fixtures/vcr_cassettes/user/find.yml
 - spec/fixtures/vcr_cassettes/webhook/all.yml
 - spec/fixtures/vcr_cassettes/webhook/create.yml
@@ -720,6 +726,7 @@ files:
 - spec/fixtures/vcr_cassettes/webhook_call/find_not_found.yml
 - spec/fixtures/vcr_cassettes/webhook_health/find.yml
 - spec/lib/contentful/management/api_key_spec.rb
+- spec/lib/contentful/management/api_usage_spec.rb
 - spec/lib/contentful/management/array_spec.rb
 - spec/lib/contentful/management/asset_spec.rb
 - spec/lib/contentful/management/client_spec.rb
@@ -737,6 +744,7 @@ files:
 - spec/lib/contentful/management/space_spec.rb
 - spec/lib/contentful/management/ui_extension_spec.rb
 - spec/lib/contentful/management/upload_spec.rb
+- spec/lib/contentful/management/usage_period_spec.rb
 - spec/lib/contentful/management/user_spec.rb
 - spec/lib/contentful/management/webhook_calls_spec.rb
 - spec/lib/contentful/management/webhook_health_spec.rb
@@ -801,6 +809,7 @@ test_files:
 - spec/fixtures/vcr_cassettes/api_key/find.yml
 - spec/fixtures/vcr_cassettes/api_key/find_for_space_not_found.yml
 - spec/fixtures/vcr_cassettes/api_key/preview.yml
+- spec/fixtures/vcr_cassettes/api_usage/all.yml
 - spec/fixtures/vcr_cassettes/array_page_1.yml
 - spec/fixtures/vcr_cassettes/asset/143_assets_next_page.yml
 - spec/fixtures/vcr_cassettes/asset/all.yml
@@ -1090,6 +1099,7 @@ test_files:
 - spec/fixtures/vcr_cassettes/upload/destroy.yml
 - spec/fixtures/vcr_cassettes/upload/find.yml
 - spec/fixtures/vcr_cassettes/upload/find_not_found.yml
+- spec/fixtures/vcr_cassettes/usage_period/all.yml
 - spec/fixtures/vcr_cassettes/user/find.yml
 - spec/fixtures/vcr_cassettes/webhook/all.yml
 - spec/fixtures/vcr_cassettes/webhook/create.yml
@@ -1107,6 +1117,7 @@ test_files:
 - spec/fixtures/vcr_cassettes/webhook_call/find_not_found.yml
 - spec/fixtures/vcr_cassettes/webhook_health/find.yml
 - spec/lib/contentful/management/api_key_spec.rb
+- spec/lib/contentful/management/api_usage_spec.rb
 - spec/lib/contentful/management/array_spec.rb
 - spec/lib/contentful/management/asset_spec.rb
 - spec/lib/contentful/management/client_spec.rb
@@ -1124,6 +1135,7 @@ test_files:
 - spec/lib/contentful/management/space_spec.rb
 - spec/lib/contentful/management/ui_extension_spec.rb
 - spec/lib/contentful/management/upload_spec.rb
+- spec/lib/contentful/management/usage_period_spec.rb
 - spec/lib/contentful/management/user_spec.rb
 - spec/lib/contentful/management/webhook_calls_spec.rb
 - spec/lib/contentful/management/webhook_health_spec.rb