strapi-kit 0.0.3__tar.gz → 0.0.4__tar.gz

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/CHANGELOG.md

@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Fixed
+
+- **Exception handling improvements** ([#23](https://github.com/MehdiZare/strapi-kit/pull/23))
+  - Use `StrapiError` instead of bare `Exception` in examples for precise error handling
+  - Catch `PydanticValidationError` specifically in Content-Type Builder parsing
+  - Add proper exception chaining when re-raising validation errors
+  - Fix docstring to document `ConfigurationError` instead of `ValueError`
+
+- **Singularization bug fix** ([#23](https://github.com/MehdiZare/strapi-kit/pull/23))
+  - Fix `api_id_to_singular()` for `-zzes` endings: `quizzes` → `quiz`, `buzzes` → `buzz`
+  - Use length-based heuristic to distinguish single-z doubled vs double-z base words
+
 ### Added
 
 - **Content-Type Builder API** ([#15](https://github.com/MehdiZare/strapi-kit/issues/15))

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: strapi-kit
-Version: 0.0.3
+Version: 0.0.4
 Summary: A modern Python client for Strapi CMS with import/export capabilities
 Project-URL: Homepage, https://github.com/mehdizare/strapi-kit
 Project-URL: Documentation, https://mehdizare.github.io/strapi-kit/
@@ -728,6 +728,7 @@ uid_to_endpoint("api::class.class")  # "classes"
 # Convert plural API ID to singular
 api_id_to_singular("articles")  # "article"
 api_id_to_singular("categories")  # "category"
+api_id_to_singular("quizzes")  # "quiz" (handles -zzes endings)
 api_id_to_singular("people")  # "person" (handles irregular plurals)
 api_id_to_singular("children")  # "child"
 

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/README.md

@@ -682,6 +682,7 @@ uid_to_endpoint("api::class.class")  # "classes"
 # Convert plural API ID to singular
 api_id_to_singular("articles")  # "article"
 api_id_to_singular("categories")  # "category"
+api_id_to_singular("quizzes")  # "quiz" (handles -zzes endings)
 api_id_to_singular("people")  # "person" (handles irregular plurals)
 api_id_to_singular("children")  # "child"
 

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/examples/basic_crud.py

@@ -7,6 +7,7 @@ using the synchronous client.
 from pydantic import SecretStr
 
 from strapi_kit import StrapiConfig, SyncClient
+from strapi_kit.exceptions import StrapiError
 
 
 def main() -> None:
@@ -27,7 +28,7 @@ def main() -> None:
         try:
             response = client.get("articles", params={"pagination[limit]": 5})
             print(f"Found {len(response.get('data', []))} articles")
-        except Exception as e:
+        except StrapiError as e:
             print(f"Error: {e}")
 
         # POST request - Create article
@@ -42,8 +43,11 @@ def main() -> None:
             }
             response = client.post("articles", json=new_article)
             article_id = response.get("data", {}).get("id")
+            if not article_id:
+                print("Error creating article: missing id in response")
+                return
             print(f"Created article with ID: {article_id}")
-        except Exception as e:
+        except StrapiError as e:
             print(f"Error creating article: {e}")
             print("Skipping update/get/delete operations")
             return  # Exit early if create fails
@@ -59,7 +63,7 @@ def main() -> None:
                 }
                 response = client.put(f"articles/{article_id}", json=update_data)
                 print(f"Updated article: {response.get('data', {}).get('title')}")
-        except Exception as e:
+        except StrapiError as e:
             print(f"Error: {e}")
 
         # GET request - Get single article
@@ -68,7 +72,7 @@ def main() -> None:
             if article_id:
                 response = client.get(f"articles/{article_id}")
                 print(f"Retrieved: {response.get('data', {}).get('title')}")
-        except Exception as e:
+        except StrapiError as e:
             print(f"Error: {e}")
 
         # DELETE request - Delete article
@@ -77,7 +81,7 @@ def main() -> None:
             if article_id:
                 response = client.delete(f"articles/{article_id}")
                 print("Article deleted successfully")
-        except Exception as e:
+        except StrapiError as e:
             print(f"Error: {e}")
 
 

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/src/strapi_kit/_version.py

@@ -28,7 +28,7 @@ version_tuple: VERSION_TUPLE
 commit_id: COMMIT_ID
 __commit_id__: COMMIT_ID
 
-__version__ = version = '0.0.3'
-__version_tuple__ = version_tuple = (0, 0, 3)
+__version__ = version = '0.0.4'
+__version_tuple__ = version_tuple = (0, 0, 4)
 
 __commit_id__ = commit_id = None

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/src/strapi_kit/client/base.py

@@ -12,6 +12,7 @@ if TYPE_CHECKING:
     from ..models.content_type import ContentTypeSchema as CTBContentTypeSchema
 
 import httpx
+from pydantic import ValidationError as PydanticValidationError
 from tenacity import (
     before_sleep_log,
     retry,
@@ -75,7 +76,7 @@ class BaseClient:
             parser: Response parser (defaults to VersionDetectingParser)
 
         Raises:
-            ValueError: If authentication token is invalid
+            ConfigurationError: If authentication token is invalid
         """
         self.config: ConfigProvider = config
         self.base_url = config.get_base_url()
@@ -492,9 +493,9 @@ class BaseClient:
             try:
                 content_type = ContentTypeListItem.model_validate(item)
                 result.append(content_type)
-            except Exception:
+            except PydanticValidationError as e:
                 # Skip malformed items
-                logger.warning(f"Failed to parse content type: {uid}")
+                logger.warning(f"Failed to parse content type: {uid}", exc_info=e)
                 continue
 
         return result
@@ -521,9 +522,9 @@ class BaseClient:
             try:
                 component = ComponentListItem.model_validate(item)
                 result.append(component)
-            except Exception:
+            except PydanticValidationError as e:
                 # Skip malformed items
-                logger.warning(f"Failed to parse component: {uid}")
+                logger.warning(f"Failed to parse component: {uid}", exc_info=e)
                 continue
 
         return result
@@ -546,4 +547,10 @@ class BaseClient:
         from ..models.content_type import ContentTypeSchema as CTBContentTypeSchema
 
         data = response_data.get("data", response_data)
-        return CTBContentTypeSchema.model_validate(data)
+        try:
+            return CTBContentTypeSchema.model_validate(data)
+        except PydanticValidationError as e:
+            raise ValidationError(
+                "Invalid content type schema response",
+                details={"errors": e.errors()},
+            ) from e

{strapi_kit-0.0.3 → strapi_kit-0.0.4}/src/strapi_kit/utils/uid.py

@@ -146,15 +146,26 @@ def api_id_to_singular(api_id: str) -> str:
     if name.endswith("ies"):
         return name[:-3] + "y"
 
-    # Handle -es for words ending in s, x, z, ch, sh (classes -> class)
+    # Handle -zzes specifically
+    # Words with single z double it when pluralized: quiz -> quizzes (remove -zes, keep 1 z)
+    # Words with double z just add es: buzz -> buzzes, fizz -> fizzes (remove -es, keep zz)
+    if name.endswith("zzes"):
+        # Common double-z words: buzz, fizz, fuzz, jazz, razz, etc. (pattern: consonant + vowel + zz)
+        # Common single-z words that double: quiz, whiz (pattern: vowel + i + z or similar)
+        # Heuristic: 4-letter bases (buzz, fizz, jazz, fuzz) become 6-letter plurals
+        #            4-letter bases like quiz become 7-letter plurals
+        # So length 6 -> likely double-z base (remove -es)
+        #    length 7+ -> likely single-z base that was doubled (remove -zes)
+        if len(name) <= 6:
+            return name[:-2]  # buzzes -> buzz, fizzes -> fizz
+        else:
+            return name[:-3]  # quizzes -> quiz, whizzes -> whiz
+
+    # Handle -es for words ending in s, x, z, ch, sh (classes -> class, buses -> bus)
     if name.endswith("es"):
-        # Check if removing -es gives a word ending in s, x, z, ch, sh
         base = name[:-2]
         if base.endswith(("s", "x", "z", "ch", "sh")):
             return base
-        # Also handle -ses, -zes (buses -> bus, quizzes -> quiz)
-        if name.endswith("ses") or name.endswith("zes"):
-            return name[:-2]
 
     # Handle standard -s removal (articles -> article)
     if name.endswith("s") and len(name) > 1: