Add support for reorder_metadata_fields Admin API

Author: epasos573

cloudinary/api.py

@@ -657,3 +657,17 @@ def reorder_metadata_field_datasource(field_external_id, order_by, direction=Non
     uri = [field_external_id, 'datasource', 'order']
     params = {'order_by': order_by, 'direction': direction}
     return call_metadata_api('post', uri, params, **options)
+
+
+def reorder_metadata_fields(order_by, direction=None, **options):
+    """Reorders metadata fields.
+
+    :param order_by: Criteria for the order (one of the fields 'label', 'external_id', 'created_at').
+    :param direction: Optional (gets either asc or desc).
+    :param options: Additional options.
+
+    :rtype: Response
+    """
+    uri = ['reorder']
+    params = {'order_by': order_by, 'direction': direction}
+    return call_metadata_api('put', uri, params, **options)

test/test_metadata.py

@@ -11,7 +11,7 @@
 from cloudinary import api
 from cloudinary.exceptions import BadRequest, NotFound
 from test.helper_test import (
-    UNIQUE_TEST_ID, get_uri, get_params, get_method, api_response_mock, ignore_exception
+    UNIQUE_TEST_ID, get_uri, get_params, get_method, api_response_mock, ignore_exception, get_json_body
 )
 
 MOCK_RESPONSE = api_response_mock()
@@ -486,6 +486,45 @@ def test_order_by_desc_in_a_metadata_field_data_source(self):
 
         self.assertEqual(result['values'][0]['value'], DATASOURCE_MULTIPLE[-1]['value'])
 
+    @patch("urllib3.request.RequestMethods.request")
+    @unittest.skipUnless(cloudinary.config().api_secret, "requires api_key/api_secret")
+    def test_reorder_metadata_fields_by_label(self, mocker):
+        """Test the reorder of metadata fields for label order by asc"""
+        mocker.return_value = MOCK_RESPONSE
+        api.reorder_metadata_fields('label', 'asc')
+        args, kargs = mocker.call_args
+
+        self.assertTrue(get_uri(args).endswith("/metadata_fields/reorder"))
+        self.assertEqual(get_method(mocker), "PUT")
+        self.assertEqual(get_json_body(mocker)['order_by'], "label")
+        self.assertEqual(get_json_body(mocker)['direction'], "asc")
+
+    @patch("urllib3.request.RequestMethods.request")
+    @unittest.skipUnless(cloudinary.config().api_secret, "requires api_key/api_secret")
+    def test_reorder_metadata_fields_by_external_id(self, mocker):
+        """Test the reorder of metadata fields for external_id order by desc"""
+        mocker.return_value = MOCK_RESPONSE
+        api.reorder_metadata_fields('external_id', 'desc')
+        args, kargs = mocker.call_args
+
+        self.assertTrue(get_uri(args).endswith("/metadata_fields/reorder"))
+        self.assertEqual(get_method(mocker), "PUT")
+        self.assertEqual(get_json_body(mocker)['order_by'], "external_id")
+        self.assertEqual(get_json_body(mocker)['direction'], "desc")
+
+    @patch("urllib3.request.RequestMethods.request")
+    @unittest.skipUnless(cloudinary.config().api_secret, "requires api_key/api_secret")
+    def test_reorder_metadata_fields_by_created_at(self, mocker):
+        """Test the reorder of metadata fields for created_at order by asc"""
+        mocker.return_value = MOCK_RESPONSE
+        api.reorder_metadata_fields('created_at', 'asc')
+        args, kargs = mocker.call_args
+
+        self.assertTrue(get_uri(args).endswith("/metadata_fields/reorder"))
+        self.assertEqual(get_method(mocker), "PUT")
+        self.assertEqual(get_json_body(mocker)['order_by'], "created_at")
+        self.assertEqual(get_json_body(mocker)['direction'], "asc")
+
 
 if __name__ == "__main__":
     unittest.main()