Merge pull request #98 from contentstack/staging

DX | 09-06-2025 | Release

Author: harshithad0703

.talismanrc

@@ -354,4 +354,18 @@ fileignoreconfig:
   checksum: c7323b95249759bc67c33d3a89d3d2e8b3ed3d146b944682d451ebebe22567c0
 - filename: .github/workflows/secrets-scan.yml
   checksum: d79ec3f3288964f7d117b9ad319a54c0ebc152e35f69be8fde95522034fdfb2a
-version: ""
+- filename: tests/api/global_fields/test_global_fields_api.py
+  checksum: 1cd57383fcad33cfaddc03aec9a7ee3e85b27de35e4545462fca33e74768e812
+- filename: tests/unit/global_fields/test_global_fields_unittest.py
+  checksum: 9bb05624cf1dadb770b3cf17fbfe915cf3133d622110da30a7dfebdeab0a315c
+- filename: tests/api/global_fields/test_global_fields_api.py
+  checksum: ef69455a51168ea34d62a68caea0984504d3feeafb78010947fa99d7c54d9e9c
+- filename: tests/unit/bulk_operations/test_bulk_releases_unit.py
+  checksum: 6f21d8928139fe511b7477d25276c3d73d0f500d5b489ac69939f34f5ae6cad9
+- filename: tests/api/global_fields/test_global_fields_api.py
+  checksum: ef69455a51168ea34d62a68caea0984504d3feeafb78010947fa99d7c54d9e9c
+- filename: tests/unit/release_items/test_release_items_unit.py
+  checksum: f92e78bc9aa8fcdf4cf8490eaa81c7ce8ce518767d9becf1393e847cc2ee12c4
+- filename: tests/unit/global_fields/test_global_fields_unittest.py
+  checksum: 46297a6fbf321dfe4b85a3d2c1089614af8c9590d8352238c800ad69955b4b6a
+version: "1.0"

CHANGELOG.md

@@ -2,6 +2,13 @@
 
 ## Content Management SDK For Python
 ---
+## v1.4.0
+
+#### Date:  09 June 2025
+
+- Release 2.0 support.
+- Nested Global fields support
+---
 ## v1.3.3
 
 #### Date:  12 May 2025

contentstack_management/__init__.py

@@ -69,10 +69,10 @@
 )
 
 __title__ = 'contentstack-management-python'
-__author__ = 'ishaileshmishra'
+__author__ = 'dev-ex'
 __status__ = 'debug'
 __region__ = 'na'
-__version__ = '1.3.3'
+__version__ = '1.4.0'
 __host__ = 'api.contentstack.io'
 __protocol__ = 'https://'
 __api_version__ = 'v3'

contentstack_management/auditlogs/auditlog.py

@@ -3,9 +3,7 @@
 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 Auditlog(Parameter):

contentstack_management/bulk_operations/bulk_operation.py

@@ -227,4 +227,96 @@ def update(self, data: dict):
         data = json.dumps(data)
         return self.client.post(url, headers = self.client.headers, data = data, params=self.params)
 
+    def add_items(self, data: dict, headers: dict = None):
+        """
+        The Add items to bulk operation request allows you to add multiple entries and assets to a bulk operation.
+        
+        :return: The `add_items` method is returning the result of the `post` request made by the
+        `client.post` method.
+        -------------------------------
+            [Example:]
+                >>> data = {
+                >>>        "release": "release_uid"
+                >>>        "action": "publish",
+                >>>        "locale": ["en-us", "hi-in"]
+                >>>        "reference": true
+                >>>        "items": [
+                >>>            {
+                >>>            "uid": "blt63177c0f00f20b61",
+                >>>            "content_type_uid": "my_blog"
+                >>>            }
+                >>>        ]
+                >>>  }
+                >>> import contentstack_management
+                >>> client = contentstack_management.Client(authtoken='your_authtoken')
+                >>> result = client.stack('api_key').bulk_operation().add_items(data).json()
+
+        -------------------------------
+        """
+        if headers is not None:
+            self.client.headers.update(headers)
+        url = f"{self.path}/release/items"
+        data = json.dumps(data)
+        return self.client.post(url, headers = self.client.headers, data = data, params=self.params)
+    
+    def update_items(self, data: dict, headers: dict = None):
+        """
+        The update items to bulk operation request allows you to update multiple entries and assets to a bulk operation.
+        
+        :return: The `update_items` method is returning the result of the `put` request made by the
+        `client.post` method.
+        -------------------------------
+            [Example:]
+                >>> data = {
+                >>>        "release": "release_uid",
+                >>>        "items": [
+                >>>            {
+                >>>                "uid": "entry_uid",
+                >>>                "locale": "en-us"
+                >>>            },
+                >>>            {
+                >>>                "uid": "entry_uid",
+                >>>                "locale": "en-us",
+                >>>                "variant_id": "entry_variant_id"
+                >>>            }
+                >>>        ]
+                >>>        or
+                >>>        [ '$all' ]
+                >>>    }
+                >>> import contentstack_management
+                >>> client = contentstack_management.Client(authtoken='your_authtoken')
+                >>> result = client.stack('api_key').bulk_operation().update_items(data).json()
+
+        -------------------------------
+        """
+        if headers is not None:
+            self.client.headers.update(headers)
+        url = f"{self.path}/release/update_items"
+        data = json.dumps(data)
+        return self.client.put(url, headers = self.client.headers, data = data, params=self.params)
+    
+    def job_status(self, job_uid: str, headers: dict = None):
+        """
+        The Job status request allows you to get the status of a bulk operation job.
+        
+        :param job_uid: The `job_uid` parameter is a string that represents the unique identifier of the job
+        whose status you want to retrieve
+        :type job_uid: str
+        :return: The `job_status` method is returning the result of the `get` request made by the
+        `client.get` method.
+        -------------------------------
+            [Example:]
+                >>> import contentstack_management
+                >>> client = contentstack_management.Client(authtoken='your_authtoken')
+                >>> result = client.stack('api_key').bulk_operation().job_status('job_uid').json()
+
+        -------------------------------
+        """
+        if job_uid is None:
+            raise ArgumentException("job_uid", "job_uid cannot be None")
+        if headers is not None:
+            self.client.headers.update(headers)
+        url = f"{self.path}/jobs/{quote(job_uid)}"
+        return self.client.get(url, headers = self.client.headers, params=self.params)
+    
 

contentstack_management/content_types/content_type.py

@@ -340,7 +340,7 @@ def imports(self, file_path):
             >>> response = content_type.imports()
         --------------------------------
         """
-        url = f"content_types/import"
+        url = "content_types/import"
         self.client.headers['Content-Type'] = "multipart/form-data"
         files = {'content_type': open(f"{file_path}", 'rb')}
         return self.client.post(url, headers=self.client.headers, params=self.params, files=files)

contentstack_management/contentstack.py

@@ -1,4 +1,3 @@
-import contentstack_management
 from enum import Enum
 from ._api_client import _APIClient
 from contentstack_management.organizations import organization

contentstack_management/delivery_token/delivery_token.py

@@ -5,7 +5,6 @@
 
 import json
 from ..common import Parameter
-from urllib.parse import quote
 from .._errors import ArgumentException
 
 class DeliveryToken(Parameter):

contentstack_management/environments/environment.py

@@ -5,7 +5,6 @@
 
 import json
 from ..common import Parameter
-from urllib.parse import quote
 from .._errors import ArgumentException
 
 class Environment(Parameter):

contentstack_management/extensions/extension.py

@@ -5,7 +5,6 @@
 
 import json
 from ..common import Parameter
-from urllib.parse import quote
 from .._errors import ArgumentException
 from requests_toolbelt.multipart.encoder import MultipartEncoder