contentful-management 3.1.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1537c2cc75f3daacb31c8764f6b7464ed762f662df0437a9a1cb70808f7f5275
-  data.tar.gz: a7613ed0ba9808ecb6636f3bf7ceb20c45ee0c3ef803e7e735f9c9583c18a0b4
+  metadata.gz: 6c115843f4cb0a16069a1a41ada3cc3661f274ab5b2e53a3b51f085f30bd7377
+  data.tar.gz: 2c9c760b683b0f2174b24d1d40473a90dc1d001f6da8fccd32c70e5f511e1633
 SHA512:
-  metadata.gz: 84a0848640c0e345695f76357e1154a83d591aa93698733cc08edd20f719d03121e07dfd08a4b42b274441b992618ddafc9ecab6f19d8ece3a2df6948cffa4d5
-  data.tar.gz: b0f25603b7e59daaf240ffa5770d50fa5b701c47faf8911be5b8a94099428b4eeb94aceed2cce832c071d5116e1cc9f2e027e1a47beab82356a0b6f9b24a2f05
+  metadata.gz: be21b3435d4a8c17661f3db6f31e17a799962ed6cb0acac6edfdeee6f6242283cbd610f0b3af9e6929148b3a0c9fb39a9c3f13fc7f1f6d7d45ee56f138ba8a99
+  data.tar.gz: a8cabfecc97f19740953a33dd92e6d5bc44479f4b393359d614d85c23d7a85f37cba0cc1de80c628a47598006a0154d9ba8c9119d85765e9a32751cefce463c1

data/.circleci/config.yml

@@ -0,0 +1,23 @@
+version: 2.1
+
+jobs:
+  test_and_lint:
+    parameters:
+      ruby-version:
+        type: string
+    docker:
+      - image: cimg/ruby:<< parameters.ruby-version >>
+    steps:
+      - checkout
+      - run: gem install bundler
+      - run: bundle install
+      - run: bundle exec rake rspec_rubocop
+
+workflows:
+  version: 2
+  workflow:
+    jobs:
+      - test_and_lint:
+          matrix:
+            parameters:
+              ruby-version: ["2.6", "2.7", "3.0"]

data/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 ## Master
 
+## 3.4.0
+* Changed CI/CD vendor
+* Added support for Tags API
+
+## 3.3.0
+* Added getter/setter for EditorInterface#sidebar
+
+## 3.2.0
+* Added support for parameters on Users API. [#227](https://github.com/contentful/contentful-management.rb/pull/227)
+
 ## 3.1.0
 ### Added
 * Added read support for Users API.

data/README.md

@@ -1,5 +1,5 @@
 # Contentful::Management
-[![Gem Version](https://badge.fury.io/rb/contentful-management.svg)](http://badge.fury.io/rb/contentful-management) [![Build Status](https://travis-ci.org/contentful/contentful-management.rb.svg)](https://travis-ci.org/contentful/contentful-management.rb)
+[![Gem Version](https://badge.fury.io/rb/contentful-management.svg)](http://badge.fury.io/rb/contentful-management) [![CircleCI](https://circleci.com/gh/contentful/contentful-management.rb/tree/master.svg?style=svg)](https://app.circleci.com/pipelines/github/contentful/contentful-management.rb?branch=master)
 
 Ruby client for the Contentful Content Management API.
 
@@ -640,6 +640,50 @@ Destroying a locale:
 blog_post_locale.destroy
 ```
 
+### Tags
+
+Retrieving all tags from the environment:
+
+```ruby
+tags = environment.tags.all
+```
+
+Retrieving one tag by ID from the environment:
+
+```ruby
+tag = environment.tags.find(tag_id)
+```
+
+Creating a tag:
+
+```ruby
+environment.tags.create(name: 'tag name', id: 'tagID')
+```
+
+Updating a tag:
+
+```ruby
+tag.update(name: 'new name')
+```
+
+Destroying a tag:
+
+```ruby
+tag.destroy
+```
+
+Tagging an entry:
+
+```ruby
+entry.update(_metadata: {"tags": [{ "sys": { "type": "Link", "linkType": "Tag", "id": "fooTag" } }]})
+```
+
+Tagging an asset:
+
+```ruby
+asset.update(_metadata: {"tags": [{ "sys": { "type": "Link", "linkType": "Tag", "id": "fooTag" } }]})
+```
+
 ### Roles
 
 Retrieving all roles from the space:

data/lib/contentful/management/asset.rb

@@ -40,7 +40,7 @@ module Contentful
         fields[:description] = { locale => attributes[:description] } if attributes[:description]
         fields[:file] = { locale => attributes[:file].properties } if attributes[:file]
 
-        { fields: fields }
+        { fields: fields, metadata: attributes[:_metadata] }
       end
 
       # @private
@@ -122,7 +122,7 @@ module Contentful
         self.description = attributes[:description] || description
         self.file = attributes[:file] || file
 
-        { fields: fields_for_query }
+        { fields: fields_for_query, metadata: attributes[:_metadata] }
       end
     end
   end

data/lib/contentful/management/client.rb

@@ -10,6 +10,7 @@ require 'contentful/management/version'
 require 'contentful/management/response'
 require 'contentful/management/resource_builder'
 
+require 'contentful/management/client_tag_methods_factory'
 require 'contentful/management/client_role_methods_factory'
 require 'contentful/management/client_user_methods_factory'
 require 'contentful/management/client_space_methods_factory'
@@ -194,6 +195,15 @@ module Contentful
         ClientAssetMethodsFactory.new(self, space_id, environment_id)
       end
 
+      # Allows manipulation of tags in context of the current client
+      # Allows listing all tags for client, creating new and finding one by ID.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::ClientTagMethodsFactory]
+      def tags(space_id, environment_id)
+        ClientTagMethodsFactory.new(self, space_id, environment_id)
+      end
+
       # Allows manipulation of content types in context of the current client
       # Allows listing all content types for client, creating new and finding one by ID.
       # @see _ README for details.

data/lib/contentful/management/client_tag_methods_factory.rb

@@ -0,0 +1,11 @@
+require_relative 'client_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for Tag API for usage from within Client
+    # @private
+    class ClientTagMethodsFactory
+      include Contentful::Management::ClientAssociationMethodsFactory
+    end
+  end
+end

data/lib/contentful/management/editor_interface.rb

@@ -11,6 +11,7 @@ module Contentful
       include Contentful::Management::Resource::EnvironmentAware
 
       property :controls, :array
+      property :sidebar, :array
 
       # Gets the Default Editor Interface
       #
@@ -39,7 +40,10 @@ module Contentful
 
       # @private
       def self.create_attributes(_client, attributes)
-        { 'controls' => attributes.fetch(:controls) }
+        {
+          'controls' => attributes.fetch(:controls),
+          'sidebar' => attributes.fetch(:sidebar)
+        }
       end
 
       # @private
@@ -54,7 +58,7 @@ module Contentful
       # Updates an Editor Interface
       #
       # @param [Hash] attributes
-      # @option attributes [Array<Hash>] :controls
+      # @option attributes [Array<Hash>] :controls, :sidebar
       #
       # @return [Contentful::Management::EditorInterface]
       def update(attributes)
@@ -66,7 +70,10 @@ module Contentful
             content_type_id: content_type.id,
             editor_id: id
           },
-          { 'controls' => attributes[:controls] || controls },
+          {
+            'controls' => attributes[:controls] || controls,
+            'sidebar' => attributes[:sidebar] || sidebar
+          },
           version: sys[:version]
         )
       end
@@ -86,7 +93,8 @@ module Contentful
 
       def query_attributes(attributes)
         {
-          controls: controls
+          controls: controls,
+          sidebar: sidebar
         }.merge(
           attributes.each_with_object({}) { |(k, v), result| result[k.to_sym] = v }
         )

data/lib/contentful/management/entry.rb

@@ -58,8 +58,7 @@ module Contentful
                             end
 
         client.register_dynamic_entry(content_type.id, DynamicEntry.create(content_type, client))
-
-        { fields: fields_for_create }
+        { fields: fields_for_create, metadata: attributes[:_metadata] }
       end
 
       # @private
@@ -183,7 +182,8 @@ module Contentful
       protected
 
       def query_attributes(attributes)
-        { fields: Contentful::Management::Support.deep_hash_merge(fields_for_query, fields_from_attributes(attributes)) }
+        { metadata: attributes.delete(:_metadata),
+          fields: Contentful::Management::Support.deep_hash_merge(fields_for_query, fields_from_attributes(attributes)) }
       end
 
       private

data/lib/contentful/management/environment.rb

@@ -4,6 +4,7 @@ require_relative 'environment_locale_methods_factory'
 require_relative 'environment_content_type_methods_factory'
 require_relative 'environment_ui_extension_methods_factory'
 require_relative 'environment_editor_interface_methods_factory'
+require_relative 'environment_tag_methods_factory'
 
 module Contentful
   module Management
@@ -121,6 +122,15 @@ module Contentful
         EnvironmentEditorInterfaceMethodsFactory.new(self)
       end
 
+      # Allows manipulation of tags in context of the current environment
+      # Allows listing all tags for the current environment, creating new and finding one by ID.
+      # @see _ README for details.
+      #
+      # @return [Contentful::Management::EnvironmentTagMethodsFactory]
+      def tags
+        EnvironmentTagMethodsFactory.new(self)
+      end
+
       # Gets the environment ID
       def environment_id
         id

data/lib/contentful/management/environment_tag_methods_factory.rb

@@ -0,0 +1,11 @@
+require_relative 'environment_association_methods_factory'
+
+module Contentful
+  module Management
+    # Wrapper for Tag API for usage from within Environment
+    # @private
+    class EnvironmentTagMethodsFactory
+      include Contentful::Management::EnvironmentAssociationMethodsFactory
+    end
+  end
+end

data/lib/contentful/management/organization_user_methods_factory.rb

@@ -14,8 +14,8 @@ module Contentful
         User.find(client, nil, nil, id, @organization_id)
       end
 
-      def all
-        User.all(client, nil, nil, {}, @organization_id)
+      def all(params = {})
+        User.all(client, nil, nil, params, @organization_id)
       end
     end
   end

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

@@ -24,6 +24,7 @@ module Contentful
             @properties = resource.instance_variable_get(:@properties)
             @fields = resource.instance_variable_get(:@fields)
             @sys = resource.instance_variable_get(:@sys).merge(locale: locale)
+            @_metadata = resource.instance_variable_get(:@_metadata)
             self
           end
         end

data/lib/contentful/management/resource_requester.rb

@@ -38,8 +38,8 @@ module Contentful
         object.refresh_data(put(endpoint_options, attributes, headers, object))
       end
 
-      def destroy(endpoint_options = {})
-        delete(endpoint_options)
+      def destroy(endpoint_options = {}, attributes = {}, headers = {})
+        delete(endpoint_options, attributes, headers)
       end
 
       def archive(object, endpoint_options = {}, headers = {})

data/lib/contentful/management/space_user_methods_factory.rb

@@ -15,8 +15,8 @@ module Contentful
         User.find(space.client, space.id, nil, id)
       end
 
-      def all
-        User.all(space.client, space.id)
+      def all(params = {})
+        User.all(space.client, space.id, nil, params, nil)
       end
     end
   end

data/lib/contentful/management/tag.rb

@@ -1,4 +1,5 @@
 require_relative 'resource'
+require_relative 'resource/environment_aware'
 
 module Contentful
   module Management
@@ -6,9 +7,35 @@ module Contentful
     # https://www.contentful.com/developers/docs/references/content-management-api/#/reference/content-tags
     class Tag
       include Contentful::Management::Resource
+      include Contentful::Management::Resource::Refresher
       include Contentful::Management::Resource::SystemProperties
+      include Contentful::Management::Resource::EnvironmentAware
 
       property :name
+
+      # @private
+      def self.create_attributes(_client, attributes)
+        return {} if attributes.nil? || attributes.empty?
+
+        {
+          'name' => attributes.fetch(:name),
+          'sys' => {
+            'visibility' => attributes.fetch(:visibility, 'private'),
+            'id' => attributes.fetch(:id),
+            'type' => 'Tag'
+          }
+        }
+      end
+
+      def destroy
+        ResourceRequester.new(client, self.class).destroy(
+          { space_id: space.id,
+            environment_id: environment_id,
+            resource_id: id },
+          {},
+          version: sys[:version]
+        )
+      end
     end
   end
 end

data/lib/contentful/management/version.rb

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