contentful-management 2.9.1 → 2.13.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4874bf1c1821fdad9b895fb83cfb53f01dbeb161220c2d5e35f6b266b70a75bc
-  data.tar.gz: 31a641e0b306c5608187591ca2eb7f89024952ece5989243683c2d7ff3effa5a
+  metadata.gz: 4d88eccf48f7dafd7ea1dffa2714427454f90db64d6977f06acf54900e441b39
+  data.tar.gz: 8e27ade92ccc73100cb336012ca1cd50e6fc87ae2b50bddf159344cd33e7e17d
 SHA512:
-  metadata.gz: e8eb04ac563ffc9e81b47dd2078023d27caa879472c96ea02863e2491819b9bcc2f6e73f25d636ebc2957e40863dc76afbd2bdb4b63232b2dbb2c59012670c58
-  data.tar.gz: a2332fbc5da6136910d0f7232cc8a9ca6d545aaec1804cdce12f6c8272f086f6951bf90fd6e668d1b002f55cccac9c02ca29a834b8c34a6d69f122ecaa030d92
+  metadata.gz: 72d956064a708379f60b886a27c9a2565922bcad0521e895989ea9c73e3ec046a19895fe343c9e7d5f7cc1dd4adafabd3c52bdf549cb3cfe1344cda737fbf877
+  data.tar.gz: '093505dbccbab0e54c94c9cdce7ba9df3ebf338bcf7e3f6ac28fe857020357f7bae6d9b0ccc61d4ef9c4da80d9f854738fd9388f0fbbf0f6cfdfb6c8c6e4cba6'

data/CHANGELOG.md

@@ -2,6 +2,46 @@
 
 ## Master
 
+## 2.13.0
+### Fixed
+* Fixed a possible validation error when submitting a content type. [#218](https://github.com/contentful/contentful-management.rb/pull/218)
+
+### Added
+* Added support for Users API. [#217](https://github.com/contentful/contentful-management.rb/pull/217)
+
+## 2.12.1
+
+### Fixed
+* Fixed an issue where JSON fields with top-level arrays were not properly parsed. [#215](https://github.com/contentful/contentful-management.rb/issues/215)
+
+## 2.12.0
+
+*Note*: Only a minor change because the removed feature was *Alpha*.
+
+### Added
+* Add `OrganizationPeriodicUsage`, `Client#organization_periodic_usages` and `Organization#periodic_usages`.
+* Add `SpacePeriodicUsage`, `Client#space_periodic_usages` and `Organization#space_periodic_usages`.
+
+### Removed
+* Removed now deprecated Alpha Usage APIs, which have been superseeded by the new APIs added.
+
+## 2.11.0
+### Added
+* Added support for Rich Text specific validations. [#200](https://github.com/contentful/contentful-management.rb/pull/200)
+
+### Changed
+* Updated maximum allowed version of the `http` gem. [#205](https://github.com/contentful/contentful-management.rb/issues/205)
+
+## 2.10.0
+### Added
+* Added support for query parameters on the Space endpoints. [#197](https://github.com/contentful/contentful-management.rb/pull/197)
+
+### Fixed
+* Fixed environment aware resources that were not having the `environment_id` properly calculated. [#195](https://github.com/contentful/contentful-management.rb/pull/195)
+
+### Changed
+* Relaxed maximum allowed version of the `json` gem. [#196](https://github.com/contentful/contentful-management.rb/pull/196)
+
 ## 2.9.1
 ### Fixed
 * Default locale is now fetched from the client instead of passed around. [#194](https://github.com/contentful/contentful-management.rb/pull/194)

data/README.md

@@ -827,40 +827,46 @@ Retrieving all organization details:
 organizations = client.organizations.all
 ```
 
-### Usage Periods (ALPHA)
+### Usage
 
 *Note*: This feature is available only to Commited v2 customers.
 
-Retrieving all Usage Periods for an Organizations you belong to:
+#### Organization Periodic Usage
+
+Retrieving all API Usage statistics for an Organization during a given usage period, broken down by organization for all APIs:
 
 ```ruby
-usage_periods = client.usage_periods('organization_id').all
+# Optionally, you can pass the metric, start and end date filters
+usage = client.organization_periodic_usages('organization_id').all
+
+# For example only CDA and CMA metrics from yesterday onwards
+usage = client.organization_periodic_usages('organization_id').all('metric[in]': ['cda', 'cma'], startDate: (Date.today - 1).iso8601)
 ```
 
 Alternatively, if you have an already fetched organization:
 
 ```ruby
-usage_periods = organization.usage_periods().all()
+# Breaking down CMA usage by space, for a given period.
+usage = organization.periodic_usages.all
 ```
 
-### API Usage (ALPHA)
+#### Space Periodic Usage
 
-*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:
+Retrieving all API Usage statistics for an Organization during a given usage period, broken down by space 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')
+# Optionally, you can pass the metric, start and end date filters
+usage = client.space_periodic_usages('organization_id').all
+
+# For example only CDA and CMA metrics from yesterday onwards
+usage = client.space_periodic_usages('organization_id').all('metric[in]': ['cda', 'cma'], startDate: (Date.today - 1).iso8601)
 ```
 
 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')
+usage = organization.space_periodic_usages.all
 ```
 
 ### Users
@@ -871,6 +877,17 @@ Retrieving current user details:
 user = client.users.me
 ```
 
+Retrieving one user by ID from the space:
+
+```ruby
+user = blog_space.users.find(user_id)
+```
+
+Retrieving one user by ID from an organization:
+
+```ruby
+user = organization.users.find('user_id')
+```
 ### UI Extensions
 
 Retrieving all UI extensions from the environment:

data/contentful-management.gemspec

@@ -17,12 +17,12 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
-  spec.add_dependency 'http', '> 1.0', '< 3.0'
+  spec.add_dependency 'http', '> 1.0', '< 5.0'
   spec.add_dependency 'multi_json', '~> 1'
-  spec.add_dependency 'json', '~> 1.8'
+  spec.add_dependency 'json', '>= 1.8', '< 3.0'
 
   spec.add_development_dependency 'bundler'
-  spec.add_development_dependency 'rake', '< 11.0'
+  spec.add_development_dependency 'rake', '>= 12.3.3'
   spec.add_development_dependency 'public_suffix', '< 1.5'
   spec.add_development_dependency 'rspec', '~> 3'
   spec.add_development_dependency 'rspec-its'
@@ -32,7 +32,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'guard-yard'
   spec.add_development_dependency 'rubocop', '~> 0.49.1'
   spec.add_development_dependency 'listen', '~> 3.0'
-  spec.add_development_dependency 'vcr'
-  spec.add_development_dependency 'webmock', '~> 1', '>= 1.17.3'
+  spec.add_development_dependency 'vcr', '~> 4.0'
+  spec.add_development_dependency 'webmock'
+  spec.add_development_dependency 'tins', '~> 1.6.0'
   spec.add_development_dependency 'simplecov'
 end

data/lib/contentful/management/client.rb

@@ -20,9 +20,7 @@ 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'
@@ -31,7 +29,9 @@ require 'contentful/management/client_webhook_health_methods_factory'
 require 'contentful/management/client_preview_api_key_methods_factory'
 require 'contentful/management/client_space_membership_methods_factory'
 require 'contentful/management/client_editor_interface_methods_factory'
+require 'contentful/management/client_space_periodic_usage_methods_factory'
 require 'contentful/management/client_personal_access_tokens_methods_factory'
+require 'contentful/management/client_organization_periodic_usage_methods_factory'
 
 module Contentful
   module Management
@@ -133,22 +133,20 @@ module Contentful
         ClientOrganizationMethodsFactory.new(self)
       end
 
-      # Allows viewing of usage periods in context of the current client
-      # Allows listing all usage periods for client.
+      # Allows listing all usage periods for organization grouped by organization.
       # @see _ README for details.
       #
-      # @return [Contentful::Management::ClientUsagePeriodMethodsFactory]
-      def usage_periods(organization_id)
-        ClientUsagePeriodMethodsFactory.new(self, organization_id)
+      # @return [Contentful::Management::ClientOrganizationPeriodicUsageMethodsFactory]
+      def organization_periodic_usages(organization_id)
+        ClientOrganizationPeriodicUsageMethodsFactory.new(self, organization_id)
       end
 
-      # Allows viewing of api usage in context of the current client
-      # Allows listing all api usage for client.
+      # Allows listing all usage periods for organization grouped by space.
       # @see _ README for details.
       #
-      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
-      def api_usage(organization_id)
-        ClientApiUsageMethodsFactory.new(self, organization_id)
+      # @return [Contentful::Management::ClientSpacePeriodicUsageMethodsFactory]
+      def space_periodic_usages(organization_id)
+        ClientSpacePeriodicUsageMethodsFactory.new(self, organization_id)
       end
 
       # Allows viewing of users in context of the current client

data/lib/contentful/management/{client_usage_period_methods_factory.rb → client_organization_periodic_usage_methods_factory.rb}

@@ -2,9 +2,9 @@ require_relative 'client_association_methods_factory'
 
 module Contentful
   module Management
-    # Wrapper for Usage Period for usage from within Client
+    # Wrapper for Organization Periodic Usages for usage from within Client
     # @private
-    class ClientUsagePeriodMethodsFactory
+    class ClientOrganizationPeriodicUsageMethodsFactory
       include Contentful::Management::ClientAssociationMethodsFactory
 
       def initialize(client, organization_id)
@@ -17,8 +17,7 @@ module Contentful
           {
             organization_id: @organization_id
           },
-          params,
-          'x-contentful-enable-alpha-feature' => 'usage-insights'
+          params
         )
       end
 

data/lib/contentful/management/client_space_methods_factory.rb

@@ -15,8 +15,8 @@ module Contentful
       # Gets a collection of spaces.
       #
       # @return [Contentful::Management::Array<Contentful::Management::Space>]
-      def all
-        @resource_requester.all
+      def all(query = {})
+        @resource_requester.all({}, query)
       end
 
       # Gets a specific space.

data/lib/contentful/management/{client_api_usage_methods_factory.rb → client_space_periodic_usage_methods_factory.rb}

@@ -2,9 +2,9 @@ require_relative 'client_association_methods_factory'
 
 module Contentful
   module Management
-    # Wrapper for API Usage for usage from within Client
+    # Wrapper for Space Periodic Usages for usage from within Client
     # @private
-    class ClientApiUsageMethodsFactory
+    class ClientSpacePeriodicUsageMethodsFactory
       include Contentful::Management::ClientAssociationMethodsFactory
 
       def initialize(client, organization_id)
@@ -12,19 +12,12 @@ module Contentful
         @organization_id = organization_id
       end
 
-      def all(usage_type, usage_period_id, api, params = {})
-        mandatory_params = {
-          'filters[usagePeriod]' => usage_period_id,
-          'filters[metric]' => api
-        }
-
+      def all(params = {})
         @resource_requester.all(
           {
-            usage_type: usage_type,
             organization_id: @organization_id
           },
-          mandatory_params.merge(params),
-          'x-contentful-enable-alpha-feature' => 'usage-insights'
+          params
         )
       end
 

data/lib/contentful/management/entry.rb

@@ -95,18 +95,20 @@ module Contentful
 
       # @private
       def self.parse_objects_array(attributes)
-        attributes.each_with_object([]) do |attr, arr|
-          if attr.is_a? Entry
-            arr << hash_with_link_object('Entry', attr)
-          elsif attr.is_a? Asset
-            arr << hash_with_link_object('Asset', attr)
-          elsif attr.is_a? Hash
-            arr << attr
-          elsif attr.class.ancestors.map(&:to_s).include?('Contentful::Entry')
-            arr << hash_with_link_object('Entry', attr)
-          elsif attr.class.ancestors.map(&:to_s).include?('Contentful::Asset')
-            arr << hash_with_link_object('Asset', attr)
-          end
+        attributes.each_with_object([]) do |attribute, result|
+          result << if attribute.is_a? Entry
+                      hash_with_link_object('Entry', attribute)
+                    elsif attribute.is_a? Asset
+                      hash_with_link_object('Asset', attribute)
+                    elsif attribute.is_a? Hash
+                      attribute
+                    elsif attribute.class.ancestors.map(&:to_s).include?('Contentful::Entry')
+                      hash_with_link_object('Entry', attribute)
+                    elsif attribute.class.ancestors.map(&:to_s).include?('Contentful::Asset')
+                      hash_with_link_object('Asset', attribute)
+                    else
+                      attribute
+                    end
         end
       end
 

data/lib/contentful/management/field.rb

@@ -87,7 +87,9 @@ module Contentful
 
       def validations_to_hash(validations)
         validations.each_with_object([]) do |validation, results|
-          results << validation.properties_to_hash
+          validation_hash = validation.properties_to_hash
+
+          results << validation.properties_to_hash if Field.value_exists?(validation_hash)
         end
       end
     end

data/lib/contentful/management/organization.rb

@@ -1,4 +1,5 @@
 require_relative 'resource'
+require 'contentful/management/organization_user_methods_factory'
 
 module Contentful
   module Management
@@ -16,20 +17,29 @@ module Contentful
         'organizations'
       end
 
-      # Allows listing all usage periods for organization.
+      # Allows listing all usage periods for organization grouped by organization or space.
       # @see _ README for details.
       #
-      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
-      def usage_periods
-        ClientApiUsageMethodsFactory.new(client, id)
+      # @return [Contentful::Management::ClientOrganizationPeriodicUsageMethodsFactory]
+      def periodic_usages
+        ClientOrganizationPeriodicUsageMethodsFactory.new(client, id)
       end
 
-      # Allows listing all api usage for organization.
+      # Allows listing all usage periods for organization grouped by organization or space.
       # @see _ README for details.
       #
-      # @return [Contentful::Management::ClientApiUsageMethodsFactory]
-      def api_usage
-        ClientApiUsageMethodsFactory.new(client, id)
+      # @return [Contentful::Management::ClientSpacePeriodicUsageMethodsFactory]
+      def space_periodic_usages
+        ClientSpacePeriodicUsageMethodsFactory.new(client, id)
+      end
+
+      # Allows viewing of users in context of an organization
+      # Allows listing all users for an organization, and finding one by ID.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::OrganizationUserMethodsFactory]
+      def users
+        OrganizationUserMethodsFactory.new(client, id)
       end
     end
   end

data/lib/contentful/management/{api_usage.rb → organization_periodic_usage.rb}

@@ -2,40 +2,35 @@ 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
+    # Resource class for OrganizationPeriodicUsage.
+    # @see _ https://www.contentful.com/developers/docs/references/content-management-api/#/reference/usage/organization-usage/get-organization-usage/console/curl
+    class OrganizationPeriodicUsage
       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
+      property :metric, :string
+      property :usage, :integer
+      property :usagePerDay, :object
+      property :unitOfMeasure, :string
+      property :dateRange, :object
 
       # @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}"
+        "organizations/#{organization_id}/organization_periodic_usages"
       end
 
-      # Gets all api usage statistics for a given organization and usage type, filtered by usage period and api.
+      # Gets all organization periodic usages for a given organization.
       #
       # @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)
+      # @return [Contentful::Management::Array<Contentful::Management::OrganizationPeriodicUsage>]
+      def self.all(client, organization_id, params = {})
+        ClientOrganizationPeriodicUsageMethodsFactory.new(client, organization_id).all(params)
       end
 
       # Not supported

data/lib/contentful/management/organization_user_methods_factory.rb

@@ -0,0 +1,18 @@
+module Contentful
+  module Management
+    # Wrapper for Users API for usage from within Organization
+    # @private
+    class OrganizationUserMethodsFactory
+      attr_reader :client
+
+      def initialize(client, organization_id)
+        @client = client
+        @organization_id = organization_id
+      end
+
+      def find(id)
+        User.find(client, nil, nil, id, @organization_id)
+      end
+    end
+  end
+end

data/lib/contentful/management/resource.rb

@@ -237,8 +237,9 @@ module Contentful
         # @param [String] resource_id
         #
         # @return [Contentful::Management::Resource]
-        def find(client, space_id, environment_id = nil, resource_id = nil)
-          ResourceRequester.new(client, self).find(space_id: space_id, environment_id: environment_id, resource_id: resource_id)
+        def find(client, space_id, environment_id = nil, resource_id = nil, organization_id = nil)
+          ResourceRequester.new(client, self).find(space_id: space_id, environment_id: environment_id,
+                                                   resource_id: resource_id, organization_id: organization_id)
         end
 
         # Creates a resource.