Feat/cs 41199 label class implementation

.talismanrc

@@ -251,3 +251,13 @@ fileignoreconfig:
 - filename: tests/unit/taxonomies/test_taxonomy_unit.py
   checksum: 5dd2f73f683c293f71fd9002148747a7167a85981d6fb90e491cafddf7b96169
 version: ""
+
+fileignoreconfig:
+- filename: tests/unit/labels/test_label_unit.py
+  checksum: 6fbb2a05402d94988e585dd48ee8881416d19340134a89088f9884533a6218d1
+- filename: tests/api/labels/test_labels_api.py
+  checksum: 1111ead97107bf5348adb0fa2457ec5c4182278865d7e461bf2a42c90ef71588
+- filename: tests/mock/labels/test_labels_mock.py
+  checksum: 069ee74fe19848e7a5bc4510772c389421e03956c31ce8347f93cb67b7f16847
+version: ""
+

contentstack_management/__init__.py

@@ -22,6 +22,8 @@
 from ._errors import ArgumentException
 from .locale.locale import Locale
 from .taxonomies.taxonomy import Taxonomy
+from .labels.label import Label
+
 
 __all__ = (
 "ContentstackClient",
@@ -47,6 +49,7 @@
 "Entry",
 "Locale",
 "Taxonomy",
+"Label",
 )
 
 __title__ = 'contentstack-management-python'

contentstack_management/labels/__init__.py

@@ -0,0 +1 @@
+from contentstack_management import contentstack

contentstack_management/labels/label.py

@@ -0,0 +1,171 @@
+"""This class takes a base URL as an argument when it's initialized, 
+which is the endpoint for the RESTFUL API that we'll be interacting with.
+The create(), read(), update(), and delete() methods each correspond to 
+the CRUD operations that can be performed on the API """
+
+import json
+from ..common import Parameter
+from urllib.parse import quote
+from .._errors import ArgumentException
+
+class Label(Parameter):
+    """
+    This class takes a base URL as an argument when it's initialized, 
+    which is the endpoint for the RESTFUL API that
+    we'll be interacting with. The create(), read(), update(), and delete() 
+    methods each correspond to the CRUD 
+    operations that can be performed on the API """
+
+    def __init__(self, client, label_uid: str):
+        self.client = client
+        self.label_uid = label_uid
+        super().__init__(self.client)
+
+        self.path = "labels"
+
+    def find(self):
+        """
+        The Find label call fetches all the existing labels of the stack.
+        :return: Json, with label details.
+
+        -------------------------------
+        [Example:]
+
+            >>> from contentstack_management import contentstack
+            >>> client = contentstack.client(authtoken='your_authtoken')
+            >>> result = client.stack("api_key").label().find().json()
+
+        -------------------------------
+        """        
+        return self.client.get(self.path, headers = self.client.headers)
+
+
+
+    def fetch(self, label_uid: str = None):
+        """
+        The Get label call returns information about a particular label of a stack.
+
+        :param label_uid: The `label_uid` parameter is a string that represents the unique identifier of
+        a label. It is used to specify which label to fetch from the server
+        :type label_uid: str
+        :return: the result of the GET request made to the specified URL.
+        -------------------------------
+        [Example:]
+
+            >>> from contentstack_management import contentstack
+            >>> client = contentstack.client(authtoken='your_authtoken')
+            >>> result = client.stack('api_key').label('label_uid').fetch().json()
+
+        -------------------------------
+        """
+
+        if label_uid is not None and label_uid != '':
+            self.label_uid = label_uid
+
+        self.validate_uid()
+        url = f"{self.path}/{self.label_uid}"
+        return self.client.get(url, headers = self.client.headers)
+
+
+    def create(self, data: dict):
+        """
+        This call is used to create a label.
+
+        :param data: The `data` parameter is the payload that you want to send in the request body. It
+        should be a dictionary or a JSON serializable object that you want to send as the request body
+        :return: Json, with label details.
+
+        -------------------------------
+        [Example:]
+            >>> data ={
+            >>>        "label": {
+            >>>            "name": "Test",
+            >>>            "parent": [
+            >>>            "label_uid"
+            >>>            ],
+            >>>            "content_types": [
+            >>>            "content_type_uid"
+            >>>            ]
+            >>>        }
+            >>>        }
+            >>> from contentstack_management import contentstack
+            >>> client = contentstack.client(authtoken='your_authtoken')
+            >>> result = client.stack('api_key').label().create(data).json()
+
+        -------------------------------
+        """
+
+        data = json.dumps(data)
+        return self.client.post(self.path, headers = self.client.headers, data=data)
+
+    def update(self, data: dict, label_uid: str = None):
+        """
+        The "Update label" call is used to update an existing label.
+
+        :param data: The `data` parameter is a dictionary that contains the updated information that you
+        want to send to the server. This data will be converted to a JSON string before sending it in
+        the request
+        :type data: dict
+        :param label_uid: The `label_uid` parameter is a string that represents the unique identifier of
+        the label. It is used to specify which label should be updated with the provided data
+        :type label_uid: str
+        :return: the result of the `put` request made to the specified URL.
+        -------------------------------
+        [Example:]
+            >>> data = {
+            >>>        "label": {
+            >>>            "name": "Test",
+            >>>            "parent": [
+            >>>            "label_uid"
+            >>>            ],
+            >>>            "content_types": [
+            >>>            "content_type_uid"
+            >>>            ]
+            >>>        }
+            >>>        }
+            >>> from contentstack_management import contentstack
+            >>> client = contentstack.client(authtoken='your_authtoken')
+            >>> result = client.stack('api_key').label("label_uid").update(data).json()
+
+        -------------------------------
+        """
+        if label_uid is not None and label_uid != '':
+            self.label_uid = label_uid
+        self.validate_uid()
+        url = f"{self.path}/{self.label_uid}"
+        data = json.dumps(data)
+        return self.client.put(url, headers = self.client.headers, data=data)
+
+
+    def delete(self, label_uid: str = None): 
+        """
+        The "Delete label" call is used to delete a specific label.
+
+        :param label_uid: The `label_uid` parameter is a string that represents the unique identifier of
+        the label that you want to delete
+        :type label_uid: str
+        :return: the result of the `client.delete()` method, which is likely a response object or a
+        boolean value indicating the success of the deletion operation.
+        -------------------------------
+        [Example:]
+
+            >>> from contentstack_management import contentstack
+            >>> client = contentstack.client(authtoken='your_authtoken')
+            >>> result = client.stack('api_key').label('label_uid').delete().json()
+
+        -------------------------------
+        """
+        if label_uid is not None and label_uid != '':
+            self.label_uid = label_uid
+        self.validate_uid()
+        url = f"{self.path}/{self.label_uid}"
+        return self.client.delete(url, headers = self.client.headers)
+
+    def validate_uid(self):
+        """
+        The function checks if the label_uid is None or an empty string and raises an ArgumentException
+        if it is.
+        """
+
+        if self.label_uid is None or '':
+            raise ArgumentException("label Uid is required")

contentstack_management/stack/stack.py

@@ -13,7 +13,7 @@
 from ..environments.environment import Environment
 from ..locale.locale import Locale
 from ..taxonomies.taxonomy import Taxonomy
-
+from ..labels.label import Label
 
 
 class Stack(Parameter):
@@ -348,4 +348,7 @@ def locale(self, locale_code: str = None):
 
     def taxonomy(self, taxonomy_uid: str = None):
             return Taxonomy(self.client, taxonomy_uid)
+
+    def label(self, label_uid: str = None):
+            return Label(self.client, label_uid)
 

tests/api/labels/test_labels_api.py

@@ -0,0 +1,70 @@
+import os
+import unittest
+from dotenv import load_dotenv
+from contentstack_management import contentstack
+from tests.cred import get_credentials
+
+credentials = get_credentials()
+username = credentials["username"]
+password = credentials["password"]
+host = credentials["host"]
+api_key = credentials["api_key"]
+label_uid = credentials["label_uid"]
+
+class LabelApiTests(unittest.TestCase):
+
+    def setUp(self):
+        self.client = contentstack.ContentstackClient(host=host)
+        self.client.login(username, password)
+
+    def test_get_all_label(self):
+        response = self.client.stack(api_key).label().find()
+        self.assertEqual(response.request.url, f"{self.client.endpoint}labels")
+        self.assertEqual(response.status_code, 200)
+
+    def test_get_a_label(self):
+        response = self.client.stack(api_key).label(label_uid).fetch()
+        self.assertEqual(response.request.url,
+                         f"{self.client.endpoint}labels/{label_uid}")
+        self.assertEqual(response.status_code, 200)
+
+
+    def test_create(self):
+        data = {
+                "label": {
+                    "name": "Test",
+                    "parent": [
+                    "label_uid"
+                    ],
+                    "content_types": [
+                    "content_type_uid"
+                    ]
+                }
+                }
+        response = self.client.stack(api_key).label().create(data)
+        self.assertEqual(response.request.url, f"{self.client.endpoint}labels")
+        self.assertEqual(response.status_code, 201)
+
+    def test_update_label(self):
+        data = {
+                "label": {
+                    "name": "Test",
+                    "parent": [
+                    "label_uid"
+                    ],
+                    "content_types": [
+                    "content_type_uid"
+                    ]
+                }
+                }
+        response = self.client.stack(api_key).label(label_uid).update(data)
+        self.assertEqual(response.request.url,
+                         f"{self.client.endpoint}labels/{label_uid}")
+        self.assertEqual(response.status_code, 200)
+
+
+    def test_delete_label(self):
+        response = self.client.stack(api_key).label(label_uid).delete()
+        self.assertEqual(response.status_code, 200)
+
+

tests/cred.py

@@ -33,6 +33,7 @@
 default_environments_name = "environments_name" #Default environment name
 default_locale_code = "locale_code" #Default locale code
 default_taxonomy_uid = "taxonomy_uid" #Default taxonomy code
+default_label_uid = "label_uid" #Default label code
 
 
 def get_credentials():
@@ -72,6 +73,6 @@ def get_credentials():
         "environments_name": os.getenv("ENVIRONMENT_NAME", default_environments_name),
         "locale_code": os.getenv("LOCALE_CODE", default_locale_code),
         "taxonomy_uid": os.getenv("TAXONOMY_UID", default_taxonomy_uid),
-
+        "label_uid": os.getenv("LABEL_UID", default_label_uid),
     }
     return credentials

tests/mock/labels/test_labels_mock.py

@@ -0,0 +1,84 @@
+import json
+import os
+import unittest
+
+from dotenv import load_dotenv
+from contentstack_management import contentstack
+from tests.cred import get_credentials
+
+credentials = get_credentials()
+username = credentials["username"]
+password = credentials["password"]
+api_key = credentials["api_key"]
+host = credentials["host"]
+label_uid = credentials["label_uid"]
+
+
+class LabelMockTests(unittest.TestCase):
+
+    def setUp(self):
+
+        self.client = contentstack.ContentstackClient(host = host)
+        self.client.login(username, password)
+
+
+    def read_file(self, file_name):
+        file_path= f"tests/resources/mock_labels/{file_name}"
+        infile = open(file_path, 'r')
+        data = infile.read()
+        infile.close()
+        return data
+
+
+    def test_get_all_label(self):
+        response = self.client.stack(api_key).label().find().json()
+        read_mock_label_data  = self.read_file("find.json")
+        mock_label_data = json.loads(read_mock_label_data)
+        self.assertEqual(mock_label_data.keys(), response.keys())
+
+    def test_get_a_label(self):
+        response = self.client.stack(api_key).label(label_uid).fetch().json()
+        read_mock_label_data  = self.read_file("fetch.json")
+        mock_label_data = json.loads(read_mock_label_data)
+        self.assertEqual(mock_label_data.keys(), response.keys())
+
+    def test_create(self):
+        data = {
+                "label": {
+                    "name": "Test",
+                    "parent": [
+                    "label_uid"
+                    ],
+                    "content_types": [
+                    "content_type_uid"
+                    ]
+                }
+        }
+        response = self.client.stack(api_key).label().create(data).json()
+        read_mock_label_data  = self.read_file("create.json")
+        mock_label_data = json.loads(read_mock_label_data)
+        self.assertEqual(mock_label_data.keys(), response.keys())
+
+    def test_update_label(self):
+        data = {
+                "label": {
+                    "name": "Test",
+                    "parent": [
+                    "label_uid"
+                    ],
+                    "content_types": [
+                    "content_type_uid"
+                    ]
+                }
+        }
+        response = self.client.stack(api_key).label(label_uid).update(data).json()
+        read_mock_label_data  = self.read_file("update.json")
+        mock_label_data = json.loads(read_mock_label_data)
+        self.assertEqual(mock_label_data.keys(), response.keys())
+
+    def test_delete_label(self):
+        response = self.client.stack(api_key).label(label_uid).delete().json()
+        read_mock_label_data  = self.read_file("delete.json")
+        mock_label_data = json.loads(read_mock_label_data)
+        self.assertEqual(mock_label_data['notice'], response['notice'])
+