contentful-management 3.3.0 → 3.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: df8e043eb2757aa5fc7ac3a679a7f7ac945869b350920f660586079e954fb540
-  data.tar.gz: 8e58ce2d681d748c68987a7db23d7bbe846feea6c9b93f35be369a84e9b84bb4
+  metadata.gz: 6c115843f4cb0a16069a1a41ada3cc3661f274ab5b2e53a3b51f085f30bd7377
+  data.tar.gz: 2c9c760b683b0f2174b24d1d40473a90dc1d001f6da8fccd32c70e5f511e1633
 SHA512:
-  metadata.gz: c19c035a3ab9a8dbb85c2e8679c15bfa83b7499c4e83927996536f595847d1201c636561d63a300bf2d8edbee507e57b020a56ac0b512ee290af121fecfe9107
-  data.tar.gz: 91ed42d0f1356e1d0bc7076566587b6a54870472c16391272fb8b0cec7b834539b19682f3e42a3c232667fe97506cbbd8d0f9e25f29ab7368774d470b3afa5e0
+  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,10 @@
 
 ## Master
 
+## 3.4.0
+* Changed CI/CD vendor
+* Added support for Tags API
+
 ## 3.3.0
 * Added getter/setter for EditorInterface#sidebar
 

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/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/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/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.3.0'.freeze
+    VERSION = '3.4.0'.freeze
   end
 end