Contentstack 2.2.0__tar.gz → 2.3.0__tar.gz

{contentstack-2.2.0 → contentstack-2.3.0}/Contentstack.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Contentstack
-Version: 2.2.0
+Version: 2.3.0
 Summary: Contentstack is a headless CMS with an API-first approach.
 Home-page: https://github.com/contentstack/contentstack-python
 Author: Contentstack

{contentstack-2.2.0 → contentstack-2.3.0}/Contentstack.egg-info/SOURCES.txt

@@ -21,6 +21,7 @@ contentstack/https_connection.py
 contentstack/image_transform.py
 contentstack/query.py
 contentstack/stack.py
+contentstack/taxonomy.py
 contentstack/utility.py
 contentstack/variants.py
 tests/test_assets.py
@@ -30,4 +31,5 @@ tests/test_entry.py
 tests/test_global_fields.py
 tests/test_live_preview.py
 tests/test_query.py
-tests/test_stack.py
+tests/test_stack.py
+tests/test_taxonomies.py

{contentstack-2.2.0 → contentstack-2.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: Contentstack
-Version: 2.2.0
+Version: 2.3.0
 Summary: Contentstack is a headless CMS with an API-first approach.
 Home-page: https://github.com/contentstack/contentstack-python
 Author: Contentstack

{contentstack-2.2.0 → contentstack-2.3.0}/contentstack/__init__.py

@@ -22,7 +22,7 @@ __all__ = (
 __title__ = 'contentstack-delivery-python'
 __author__ = 'contentstack'
 __status__ = 'debug'
-__version__ = 'v2.2.0'
+__version__ = 'v2.3.0'
 __endpoint__ = 'cdn.contentstack.io'
 __email__ = 'support@contentstack.com'
 __developer_email__ = 'mobile@contentstack.com'

{contentstack-2.2.0 → contentstack-2.3.0}/contentstack/stack.py

@@ -6,6 +6,7 @@ from urllib3.util import Retry
 from contentstack.asset import Asset
 from contentstack.assetquery import AssetQuery
 from contentstack.contenttype import ContentType
+from contentstack.taxonomy import Taxonomy
 from contentstack.globalfields import GlobalField
 from contentstack.https_connection import HTTPSConnection
 from contentstack.image_transform import ImageTransform
@@ -204,6 +205,14 @@ class Stack:
         """
         return ContentType(self.http_instance, content_type_uid)
     
+    def taxonomy(self):
+        """
+        taxonomy defines the structure or schema of a page or a section
+        of your web or mobile property.
+        :return: taxonomy
+        """
+        return Taxonomy(self.http_instance)
+    
     def global_field(self, global_field_uid=None):
         """
         Global field defines the structure or schema of a page or a section

contentstack-2.3.0/contentstack/taxonomy.py

@@ -0,0 +1,64 @@
+import json
+from urllib import parse
+from urllib.parse import quote
+
+
+
+class Taxonomy:
+    def __init__(self, http_instance):
+        self.http_instance = http_instance
+        self._filters: dict = {}
+
+    def _add(self, field: str, condition: dict) -> "TaxonomyQuery":
+        self._filters[field] = condition
+        return self
+
+    def in_(self, field: str, terms: list) -> "TaxonomyQuery":
+        return self._add(field, {"$in": terms})
+
+    def or_(self, *conds: dict) -> "TaxonomyQuery":
+        return self._add("$or", list(conds))
+
+    def and_(self, *conds: dict) -> "TaxonomyQuery":
+        return self._add("$and", list(conds))
+
+    def exists(self, field: str) -> "TaxonomyQuery":
+        return self._add(field, {"$exists": True})
+
+    def equal_and_below(self, field: str, term_uid: str, levels: int = 10) -> "TaxonomyQuery":
+        cond = {"$eq_below": term_uid, "levels": levels}
+        return self._add(field, cond)
+
+    def below(self, field: str, term_uid: str, levels: int = 10) -> "TaxonomyQuery":
+        cond = {"$below": term_uid, "levels": levels}
+        return self._add(field, cond)
+
+    def equal_and_above(self, field: str, term_uid: str, levels: int = 10) -> "TaxonomyQuery":
+        cond = {"$eq_above": term_uid, "levels": levels}
+        return self._add(field, cond)
+
+    def above(self, field: str, term_uid: str, levels: int = 10) -> "TaxonomyQuery":
+        cond = {"$above": term_uid, "levels": levels}
+        return self._add(field, cond)
+
+    def find(self, params=None):
+        """
+        This method fetches entries filtered by taxonomy from the stack.
+        """
+        self.local_param = {}
+        self.local_param['environment'] = self.http_instance.headers['environment']
+
+        # Ensure query param is always present
+        query_string = json.dumps(self._filters or {})
+        query_encoded = quote(query_string, safe='{}":,[]')  # preserves JSON characters
+
+        # Build the base URL
+        endpoint = self.http_instance.endpoint
+        url = f'{endpoint}/taxonomies/entries?environment={self.local_param["environment"]}&query={query_encoded}'
+
+        # Append any additional params manually
+        if params:
+            other_params = '&'.join(f'{k}={v}' for k, v in params.items())
+            url += f'&{other_params}'
+        return self.http_instance.get(url)
+

contentstack-2.3.0/tests/test_taxonomies.py

@@ -0,0 +1,99 @@
+import logging
+import unittest
+import config
+import contentstack
+import pytest
+
+API_KEY = config.APIKEY
+DELIVERY_TOKEN = config.DELIVERYTOKEN
+ENVIRONMENT = config.ENVIRONMENT
+HOST = config.HOST
+
+class TestTaxonomyAPI(unittest.TestCase):
+    def setUp(self):
+        self.stack = contentstack.Stack(API_KEY, DELIVERY_TOKEN, ENVIRONMENT, host=HOST)
+    
+    def test_01_taxonomy_complex_query(self):
+        """Test complex taxonomy query combining multiple filters"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.and_(
+            {"taxonomies.category": {"$in": ["test"]}},
+            {"taxonomies.test1": {"$exists": True}}
+        ).or_(
+            {"taxonomies.status": {"$in": ["active"]}},
+            {"taxonomies.priority": {"$in": ["high"]}}
+        ).find({'limit': 10})
+        if result is not None:
+            self.assertIn('entries', result)
+            
+    def test_02_taxonomy_in_query(self):
+        """Test taxonomy query with $in filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.in_("taxonomies.category", ["category1", "category2"]).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_03_taxonomy_exists_query(self):
+        """Test taxonomy query with $exists filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.exists("taxonomies.test1").find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_04_taxonomy_or_query(self):
+        """Test taxonomy query with $or filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.or_(
+            {"taxonomies.category": {"$in": ["category1"]}},
+            {"taxonomies.test1": {"$exists": True}}
+        ).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_05_taxonomy_and_query(self):
+        """Test taxonomy query with $and filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.and_(
+            {"taxonomies.category": {"$in": ["category1"]}},
+            {"taxonomies.test1": {"$exists": True}}
+        ).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_06_taxonomy_equal_and_below(self):
+        """Test taxonomy query with $eq_below filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.equal_and_below("taxonomies.color", "blue", levels=1).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_07_taxonomy_below(self):
+        """Test taxonomy query with $below filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.below("taxonomies.hierarchy", "parent_uid", levels=2).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_08_taxonomy_equal_and_above(self):
+        """Test taxonomy query with $eq_above filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.equal_and_above("taxonomies.hierarchy", "child_uid", levels=3).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_09_taxonomy_above(self):
+        """Test taxonomy query with $above filter"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.above("taxonomies.hierarchy", "child_uid", levels=2).find()
+        if result is not None:
+            self.assertIn('entries', result)
+    
+    def test_10_taxonomy_find_with_params(self):
+        """Test taxonomy find with additional parameters"""
+        taxonomy = self.stack.taxonomy()
+        result = taxonomy.in_("taxonomies.category", ["test"]).find({'limit': 5})
+        if result is not None:
+            self.assertIn('entries', result)
+    
+if __name__ == '__main__':
+    unittest.main()