feat: add taxonomy publish/unpublish/localize/unlocalize and terms localize/unlocalize

Closes parity gap with JS SDK and Java (feat/DX-9676-taxonomy-publish).

Taxonomy (taxonomy.py):
- publish(data) → POST /taxonomies/publish (collection-level)
- unpublish(data) → POST /taxonomies/unpublish (collection-level)
- localize(data, locale) → POST /taxonomies/{uid}?locale= (instance-level)
- unlocalize(locale) → DELETE /taxonomies/{uid}?locale= (instance-level)

Terms (terms.py):
- localize(data, locale) → POST /taxonomies/{t}/terms/{uid}?locale= (instance-level)
- unlocalize(locale) → DELETE /taxonomies/{t}/terms/{uid}?locale= (instance-level)

21/21 unit tests pass.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: OMpawar-21

contentstack_management/taxonomies/taxonomy.py

@@ -144,10 +144,73 @@ def delete(self, taxonomy_uid: str = None):
         return self.client.delete(url, headers = self.client.headers, params = self.params)
 
 
+    def publish(self, data: dict):
+        """
+        Publish one or more taxonomies to the specified environments and locales.
+        Call on a collection-level instance (no taxonomy_uid set).
+
+        :param data: ``{"locales": [...], "environments": [...], "items": [{"uid": "..."}]}``
+        :return: requests.Response
+
+        [Example:]
+            >>> data = {"locales": ["en-us"], "environments": ["production"], "items": [{"uid": "taxonomy_1"}]}
+            >>> client.stack('api_key').taxonomy().publish(data).json()
+        """
+        url = f"{self.path}/publish"
+        return self.client.post(url, headers=self.client.headers, data=json.dumps(data), params=self.params)
+
+    def unpublish(self, data: dict):
+        """
+        Unpublish one or more taxonomies from the specified environments and locales.
+        Call on a collection-level instance (no taxonomy_uid set).
+
+        :param data: ``{"locales": [...], "environments": [...], "items": [{"uid": "..."}]}``
+        :return: requests.Response
+
+        [Example:]
+            >>> data = {"locales": ["en-us"], "environments": ["production"], "items": [{"uid": "taxonomy_1"}]}
+            >>> client.stack('api_key').taxonomy().unpublish(data).json()
+        """
+        url = f"{self.path}/unpublish"
+        return self.client.post(url, headers=self.client.headers, data=json.dumps(data), params=self.params)
+
+    def localize(self, data: dict, locale: str):
+        """
+        Localize a taxonomy into the specified locale.
+        Requires a taxonomy_uid (instance-level).
+
+        :param data: ``{"taxonomy": {"name": "..."}}``
+        :param locale: Target locale code, e.g. ``"hi-in"``
+        :return: requests.Response
+
+        [Example:]
+            >>> client.stack('api_key').taxonomy('uid').localize({"taxonomy": {"name": "Hindi"}}, 'hi-in').json()
+        """
+        self.validate_taxonomy_uid()
+        self.add_param('locale', locale)
+        url = f"{self.path}/{self.taxonomy_uid}"
+        return self.client.post(url, headers=self.client.headers, data=json.dumps(data), params=self.params)
+
+    def unlocalize(self, locale: str):
+        """
+        Remove a locale variant of a taxonomy.
+        Requires a taxonomy_uid (instance-level).
+
+        :param locale: Locale code to remove, e.g. ``"hi-in"``
+        :return: requests.Response
+
+        [Example:]
+            >>> client.stack('api_key').taxonomy('uid').unlocalize('hi-in').json()
+        """
+        self.validate_taxonomy_uid()
+        self.add_param('locale', locale)
+        url = f"{self.path}/{self.taxonomy_uid}"
+        return self.client.delete(url, headers=self.client.headers, params=self.params)
+
     def validate_taxonomy_uid(self):
         if self.taxonomy_uid is None or '':
             raise ArgumentException(TAXONOMY_UID_REQUIRED)
-        
+
     def terms(self, terms_uid: str = None):
         self.validate_taxonomy_uid()
         return Terms(self.client, self.taxonomy_uid, terms_uid)

contentstack_management/terms/terms.py

@@ -282,14 +282,49 @@ def descendants(self, terms_uid: str = None):
         url = f"{self.path}/{self.terms_uid}/descendants"
         return self.client.get(url, headers = self.client.headers, params = self.params)
 
+    def localize(self, data: dict, locale: str):
+        """
+        Localize a term into the specified locale.
+        Requires both taxonomy_uid and terms_uid (instance-level).
+
+        :param data: ``{"term": {"name": "..."}}``
+        :param locale: Target locale code, e.g. ``"hi-in"``
+        :return: requests.Response
+
+        [Example:]
+            >>> client.stack('api_key').taxonomy('t_uid').terms('term_uid').localize({"term": {"name": "Hindi"}}, 'hi-in').json()
+        """
+        self.validate_taxonomy_uid()
+        self.validate_terms_uid()
+        self.add_param('locale', locale)
+        url = f"{self.path}/{self.terms_uid}"
+        return self.client.post(url, headers=self.client.headers, data=json.dumps(data), params=self.params)
+
+    def unlocalize(self, locale: str):
+        """
+        Remove a locale variant of a term.
+        Requires both taxonomy_uid and terms_uid (instance-level).
+
+        :param locale: Locale code to remove, e.g. ``"hi-in"``
+        :return: requests.Response
+
+        [Example:]
+            >>> client.stack('api_key').taxonomy('t_uid').terms('term_uid').unlocalize('hi-in').json()
+        """
+        self.validate_taxonomy_uid()
+        self.validate_terms_uid()
+        self.add_param('locale', locale)
+        url = f"{self.path}/{self.terms_uid}"
+        return self.client.delete(url, headers=self.client.headers, params=self.params)
+
     def validate_taxonomy_uid(self):
         if self.taxonomy_uid is None or '':
             raise ArgumentException(TAXONOMY_UID_REQUIRED)
-    
+
     def validate_terms_uid(self):
         if self.terms_uid is None or '':
             raise ArgumentException(TERMS_UID_REQUIRED)
-        
+
     def validate_term_string(self, term_string):
         if term_string is None or '':
             raise ArgumentException(TERM_STRING_REQUIRED)

tests/unit/taxonomies/test_taxonomy_unit.py

@@ -71,3 +71,28 @@ def test_delete_taxonomy(self):
         response = self.client.stack(api_key).taxonomy(taxonomy_uid).delete()
         self.assertEqual(response.request.url, f"{self.client.endpoint}taxonomies/{taxonomy_uid}")
         self.assertEqual(response.request.method, "DELETE")
+
+    def test_publish(self):
+        data = {"locales": ["en-us"], "environments": ["production"], "items": [{"uid": taxonomy_uid}]}
+        response = self.client.stack(api_key).taxonomy().publish(data)
+        self.assertEqual(response.request.url, f"{self.client.endpoint}taxonomies/publish")
+        self.assertEqual(response.request.method, "POST")
+
+    def test_unpublish(self):
+        data = {"locales": ["en-us"], "environments": ["production"], "items": [{"uid": taxonomy_uid}]}
+        response = self.client.stack(api_key).taxonomy().unpublish(data)
+        self.assertEqual(response.request.url, f"{self.client.endpoint}taxonomies/unpublish")
+        self.assertEqual(response.request.method, "POST")
+
+    def test_localize(self):
+        data = {"taxonomy": {"name": "Taxonomy Hindi"}}
+        response = self.client.stack(api_key).taxonomy(taxonomy_uid).localize(data, "hi-in")
+        self.assertIn(f"taxonomies/{taxonomy_uid}", response.request.url)
+        self.assertIn("locale=hi-in", response.request.url)
+        self.assertEqual(response.request.method, "POST")
+
+    def test_unlocalize(self):
+        response = self.client.stack(api_key).taxonomy(taxonomy_uid).unlocalize("hi-in")
+        self.assertIn(f"taxonomies/{taxonomy_uid}", response.request.url)
+        self.assertIn("locale=hi-in", response.request.url)
+        self.assertEqual(response.request.method, "DELETE")

tests/unit/terms/test_terms_unit.py

@@ -95,5 +95,18 @@ def test_descendants(self):
         self.assertEqual(response.request.method, "GET")
         self.assertEqual(response.request.headers["Content-Type"], "application/json")
 
+    def test_localize(self):
+        data = {"term": {"name": "Term Hindi"}}
+        response = self.client.stack(api_key).taxonomy(taxonomy_uid).terms(terms_uid).localize(data, "hi-in")
+        self.assertIn(f"taxonomies/{taxonomy_uid}/terms/{terms_uid}", response.request.url)
+        self.assertIn("locale=hi-in", response.request.url)
+        self.assertEqual(response.request.method, "POST")
+
+    def test_unlocalize(self):
+        response = self.client.stack(api_key).taxonomy(taxonomy_uid).terms(terms_uid).unlocalize("hi-in")
+        self.assertIn(f"taxonomies/{taxonomy_uid}/terms/{terms_uid}", response.request.url)
+        self.assertIn("locale=hi-in", response.request.url)
+        self.assertEqual(response.request.method, "DELETE")
+
 if __name__ == '__main__':
     unittest.main()