Add support for rename_folder Admin API

Author: const-cloudinary

lib/cloudinary/api.rb

@@ -731,6 +731,21 @@ def self.create_folder(folder_name, options={})
     call_api(:post, "folders/#{folder_name}", {}, options)
   end
 
+  # Renames existing asset folder.
+  #
+  # @param [String] from_path The full path of an existing asset folder.
+  # @param [String] to_path   The full path of the new asset folder.
+  # @param [Hash]   options   The optional parameters.
+  #
+  # @return [Cloudinary::Api::Response]
+  #
+  # @raise [Cloudinary::Api::Error]
+  #
+  # @see https://cloudinary.com/documentation/admin_api#rename_folder
+  def self.rename_folder(from_path, to_path, options={})
+    call_api(:put, "folders/#{from_path}", {:to_folder => to_path}, options)
+  end
+
   # Lists upload mappings by folder and its mapped template (URL).
   #
   # @param [Hash] options The optional parameters. See the

spec/api_spec.rb

@@ -741,6 +741,15 @@
       res = @mock_api.create_folder(UNIQUE_TEST_FOLDER)
       expect(res).to have_deep_hash_values_of(expected)
     end
+    it 'should rename folder' do
+      expected = {
+        [:url] => /.*\/folders\/#{UNIQUE_TEST_FOLDER}$/,
+        [:method] => :put,
+        [:payload, :to_folder] => UNIQUE_TEST_FOLDER + "_new",
+      }
+      res = @mock_api.rename_folder(UNIQUE_TEST_FOLDER, UNIQUE_TEST_FOLDER + "_new")
+      expect(res).to have_deep_hash_values_of(expected)
+    end
     it "should support listing folders" do
       res = @mock_api.root_folders
       expect(res).to have_deep_hash_values_of([:url] => /.*\/folders$/, [:method] => :get)