Merge pull request #1 from TI-Sin-Problemas/develop

Complete API endpoints and catalogs

Author: Ahuahuachi

pyproject.toml

@@ -4,9 +4,9 @@ build-backend = "hatchling.build"
 
 [project]
 name = "facturapi-python"
-version = "0.0.2"
+version = "0.1.0"
 authors = [{ name = "TI Sin Problemas", email = "pypi@tisinproblemas.com" }]
-description = "Unofficial Facturapi.io Python wrapper"
+description = "Unofficial Facturapi.io Python client"
 readme = "README.md"
 license = { file = "LICENSE" }
 requires-python = ">=3.7"

src/facturapi/catalogs.py

@@ -0,0 +1,57 @@
+"""Catalogs API endpoint"""
+from .http import BaseClient
+
+
+class CatalogsClient(BaseClient):
+    """Catalogs API client"""
+
+    endpoint = "catalogs"
+
+    def search_products(self, search: str, page: int = None, limit: int = None) -> dict:
+        """Search in SAT's Products/Services catalog, which contains the key to include in the
+        invoice
+
+        Args:
+            search (str): Text to search on the description of the category.
+            page (int, optional): Page of results to return, beginning from page 1.
+            Defaults to None.
+            limit (int, optional): Number from 1 to 100, represents the maximum quiantity of
+            results to return. Defaults to None.
+
+        Returns:
+            dict: List of products or services matching the query
+        """
+        params = {"q": search}
+
+        if page:
+            params.update({"page": page})
+        if limit:
+            params.update({"limit": limit})
+
+        url = self._get_request_url(["products"])
+        return self._execute_request("GET", url, params).json()
+
+    def search_units_of_measurement(
+        self, search: str, page: int = None, limit: int = None
+    ) -> dict:
+        """Search in SAT's Units of Measurement catalog
+
+        Args:
+            search (str): Test to search in the description of the unit of measurement
+            page (int, optional): Page of results to return, beginning from page 1.
+            Defaults to None.
+            limit (int, optional): Number from 1 to 100, represents the maximum quiantity of
+            results to return. Defaults to None.
+
+        Returns:
+            dict: List of units of measurement
+        """
+        params = {"q": search}
+
+        if page:
+            params.update({"page": page})
+        if limit:
+            params.update({"limit": limit})
+
+        url = self._get_request_url(["units"])
+        return self._execute_request("GET", url, params).json()