ebarimt-pos-sdk 0.0.1b2__tar.gz → 0.1.0__tar.gz

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: ebarimt-pos-sdk
-Version: 0.0.1b2
+Version: 0.1.0
 Summary: Python SDK for Ebarimt POS API 3.0
 Author: SenergyTech
 License: MIT

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ebarimt-pos-sdk"
-version = "0.0.1b2"
+version = "0.1.0"
 description = "Python SDK for Ebarimt POS API 3.0"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -11,12 +11,12 @@ dependencies = ["httpx>=0.27.0", "pydantic>=2.7.0"]
 
 [dependency-groups]
 dev = [
-  "pytest>=9.0.2",
-  "pytest-asyncio>=1.3.0",
-  "respx>=0.22.0",
-  "ruff>=0.5.0",
-  "mypy>=1.10.0",
-  "pytest-cov>=7.0.0",
+    "pytest>=9.0.2",
+    "pytest-asyncio>=1.3.0",
+    "respx>=0.22.0",
+    "ruff>=0.5.0",
+    "mypy>=1.10.0",
+    "pytest-cov>=7.0.0",
 ]
 
 [build-system]
@@ -26,22 +26,14 @@ build-backend = "uv_build"
 [tool.pytest.ini_options]
 asyncio_mode = "auto"
 testpaths = ["tests"]
+markers = ["integration: tests that require a real PosAPI server"]
 
 [tool.ruff]
 line-length = 100
 target-version = "py310"
+exclude = ["tests"]
+src = ["src"]
 
 [tool.ruff.lint]
 select = ["E", "F", "I", "B", "UP"]
 ignore = ["E501"]
-
-[tool.mypy]
-python_version = "3.10"
-warn_return_any = true
-warn_unused_ignores = true
-no_implicit_optional = true
-disallow_untyped_defs = true
-check_untyped_defs = true
-mypy_path = ["src"]
-files = ["src"]
-exclude = '^tests/'

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/__init__.py

@@ -1,4 +1,12 @@
 from .client import PosApiClient
+from .errors import (
+    PosApiBusinessError,
+    PosApiDecodeError,
+    PosApiError,
+    PosApiHttpError,
+    PosApiTransportError,
+    PosApiValidationError,
+)
 from .resources.receipt import (
     BarCodeType,
     CreateReceiptRequest,
@@ -38,4 +46,10 @@ __all__ = [
     "ReceiptItemResponse",
     "ReceiptType",
     "TaxType",
+    "PosApiBusinessError",
+    "PosApiDecodeError",
+    "PosApiError",
+    "PosApiHttpError",
+    "PosApiTransportError",
+    "PosApiValidationError",
 ]

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/errors.py

@@ -2,7 +2,10 @@
 
 from __future__ import annotations
 
+from typing import Literal
+
 import httpx
+from pydantic import ValidationError
 
 
 class PosApiError(Exception):
@@ -14,10 +17,16 @@ class PosApiError(Exception):
         *,
         request: httpx.Request | None = None,
         response: httpx.Response | None = None,
+        cause: Exception | None = None,
     ) -> None:
         super().__init__(message)
+        self.message = message
         self.request = request
         self.response = response
+        self.cause = cause
+
+    def __str__(self) -> str:
+        return self.message
 
 
 class PosApiTransportError(PosApiError):
@@ -31,18 +40,47 @@ class PosApiDecodeError(PosApiError):
 class PosApiValidationError(PosApiError):
     """Pydantic validation errors (request or response)."""
 
-
-class PosApiHttpError(PosApiError):
-    """Non-2xx response from server."""
-
     def __init__(
         self,
-        message: str,
         *,
-        request: httpx.Request,
-        response: httpx.Response,
+        stage: Literal["request", "response"],
+        model: type | str,
+        validation_error: ValidationError,
+        request: httpx.Request | None = None,
+        response: httpx.Response | None = None,
     ) -> None:
-        super().__init__(message, request=request, response=response)
+        self.stage = stage
+        self.model = model if isinstance(model, str) else model.__name__
+        self.validation_error = validation_error
+
+        message = f"Validation failed during {stage} for model '{self.model}'"
+
+        super().__init__(
+            message,
+            request=request,
+            response=response,
+            cause=validation_error,
+        )
+
+    @property
+    def errors(self) -> list:
+        """Return Pydantic-style validation errors."""
+        return self.validation_error.errors()
+
+    def __str__(self) -> str:
+        lines = [self.message]
+
+        for err in self.errors:
+            loc = ".".join(str(x) for x in err.get("loc", []))
+            msg = err.get("msg", "")
+            typ = err.get("type", "")
+            lines.append(f"  - {loc}: {msg} ({typ})")
+
+        return "\n".join(lines)
+
+
+class PosApiHttpError(PosApiError):
+    """Non-2xx response from server."""
 
 
 class PosApiBusinessError(PosApiError):

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/resources/bank_accounts/bank_accounts.py

@@ -1,6 +1,6 @@
 import httpx
 
-from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+from ..resource import BaseResource, HeaderTypes
 from .schema import BankAccount
 
 
@@ -19,14 +19,14 @@ class BankAccountsResource(BaseResource):
             "GET",
             self._path,
             params=httpx.QueryParams({"tin": tin}),
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        success_response = _ensure_http_success(result.response)
+        response = self._ensure_http_success(result.response)
 
         output: list[BankAccount] = []
 
-        for data in success_response.json():
+        for data in self._decode_json(response):
             output.append(BankAccount.model_validate(data))
 
         return output
@@ -41,14 +41,14 @@ class BankAccountsResource(BaseResource):
             "GET",
             self._path,
             params=httpx.QueryParams({"tin": tin}),
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        success_response = _ensure_http_success(result.response)
+        response = self._ensure_http_success(result.response)
 
         output: list[BankAccount] = []
 
-        for data in success_response.json():
+        for data in self._decode_json(response):
             output.append(BankAccount.model_validate(data))
 
         return output

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/resources/info/info.py

@@ -1,4 +1,4 @@
-from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+from ..resource import BaseResource, HeaderTypes
 from .schema import ReadInfoResponse
 
 
@@ -11,20 +11,20 @@ class InfoResource(BaseResource):
         result = self._sync.send(
             "GET",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return ReadInfoResponse.model_validate(result.response.json())
+        return ReadInfoResponse.model_validate(self._decode_json(result.response))
 
     async def aread(self, *, headers: HeaderTypes | None = None) -> ReadInfoResponse:
         result = await self._async.send(
             "GET",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return ReadInfoResponse.model_validate(result.response.json())
+        return ReadInfoResponse.model_validate(self._decode_json(result.response))

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/resources/receipt/receipt.py

@@ -2,13 +2,7 @@ from __future__ import annotations
 
 from typing import Any
 
-from ..resource import (
-    BaseResource,
-    HeaderTypes,
-    _build_headers,
-    _ensure_http_success,
-    _validate_payload,
-)
+from ..resource import BaseResource, HeaderTypes
 from .schema import (
     CreateReceiptRequest,
     CreateReceiptResponse,
@@ -16,8 +10,6 @@ from .schema import (
     DeleteReceiptResponse,
 )
 
-_DEFAULT_HEADERS = {"Accept": "application/json"}
-
 
 class ReceiptResource(BaseResource):
     @property
@@ -30,18 +22,18 @@ class ReceiptResource(BaseResource):
         *,
         headers: HeaderTypes | None = None,
     ) -> CreateReceiptResponse:
-        payload = _validate_payload(model=CreateReceiptRequest, payload=payload)
+        payload = self._validate_payload(model=CreateReceiptRequest, payload=payload)
 
         result = self._sync.send(
             "POST",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
             payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return CreateReceiptResponse.model_validate(result.response.json())
+        return CreateReceiptResponse.model_validate(self._decode_json(result.response))
 
     async def acreate(
         self,
@@ -49,47 +41,47 @@ class ReceiptResource(BaseResource):
         *,
         headers: HeaderTypes | None = None,
     ) -> CreateReceiptResponse:
-        payload = _validate_payload(model=CreateReceiptRequest, payload=payload)
+        payload = self._validate_payload(model=CreateReceiptRequest, payload=payload)
 
         result = await self._async.send(
             "POST",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
             payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return CreateReceiptResponse.model_validate(result.response.json())
+        return CreateReceiptResponse.model_validate(self._decode_json(result.response))
 
     def delete(
         self, payload: DeleteReceiptRequest | dict[str, Any], *, headers: HeaderTypes | None = None
     ) -> DeleteReceiptResponse:
-        payload = _validate_payload(model=DeleteReceiptRequest, payload=payload)
+        payload = self._validate_payload(model=DeleteReceiptRequest, payload=payload)
 
         result = self._sync.send(
             "POST",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
             payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return DeleteReceiptResponse.model_validate(result.response.json())
+        return DeleteReceiptResponse.model_validate(self._decode_json(result.response))
 
     async def adelete(
         self, payload: DeleteReceiptRequest | dict[str, Any], *, headers: HeaderTypes | None = None
     ) -> DeleteReceiptResponse:
-        payload = _validate_payload(model=DeleteReceiptRequest, payload=payload)
+        payload = self._validate_payload(model=DeleteReceiptRequest, payload=payload)
 
         result = await self._async.send(
             "POST",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
             payload=payload.model_dump(mode="json", by_alias=True, exclude_none=True),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
-        return DeleteReceiptResponse.model_validate(result.response.json())
+        return DeleteReceiptResponse.model_validate(self._decode_json(result.response))

ebarimt_pos_sdk-0.1.0/src/ebarimt_pos_sdk/resources/resource.py

@@ -0,0 +1,91 @@
+# src/ebarimt_pos_sdk/resources/receipt.py
+from __future__ import annotations
+
+from abc import abstractmethod
+from typing import Any, TypeVar
+
+import httpx
+from pydantic import BaseModel, ValidationError
+
+from ..errors import PosApiDecodeError, PosApiHttpError, PosApiValidationError
+from ..transport import AsyncTransport, HeaderTypes, SyncTransport
+
+T = TypeVar("T", bound=BaseModel)
+
+
+class BaseResource:
+    def __init__(
+        self,
+        *,
+        sync: SyncTransport,
+        async_: AsyncTransport,
+        headers: HeaderTypes | None = None,
+    ) -> None:
+        self._sync = sync
+        self._async = async_
+        self._headers = headers
+
+    @property
+    @abstractmethod
+    def _path(self) -> str: ...
+
+    @staticmethod
+    def _decode_json(response: httpx.Response) -> Any:
+        try:
+            return response.json()
+        except Exception as exc:
+            raise PosApiDecodeError(
+                "Failed to decode JSON response",
+                response=response,
+            ) from exc
+
+    @staticmethod
+    def _ensure_http_success(response: httpx.Response) -> httpx.Response:
+        try:
+            return response.raise_for_status()
+        except httpx.HTTPStatusError as exc:
+            raise PosApiHttpError(
+                f"HTTP {exc.response.status_code}",
+                request=exc.request,
+                response=exc.response,
+            ) from exc
+
+    @staticmethod
+    def _validate_payload(model: type[T], payload: T | dict[str, Any]) -> T:
+        if isinstance(payload, model):
+            return payload
+        try:
+            return model.model_validate(payload)
+        except ValidationError as exc:
+            raise PosApiValidationError(
+                stage="request",
+                model=model,
+                validation_error=exc,
+            ) from exc
+
+    @staticmethod
+    def _validate_response(model: type[T], response: Any) -> T:
+        try:
+            return model.model_validate(response)
+        except ValidationError as exc:
+            raise PosApiValidationError(
+                stage="response",
+                model=model,
+                validation_error=exc,
+            ) from exc
+
+    @staticmethod
+    def _build_headers(*headers: HeaderTypes | None) -> httpx.Headers:
+        """Merges headers and returns one header.
+
+        Note:
+            Highest priority header should be the last.
+
+        Returns:
+            httpx.Headers: Merged header.
+        """
+        out = httpx.Headers()
+        for header in headers:
+            if header is not None:
+                out.update(header)
+        return out

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/resources/send_data/send_data.py

@@ -1,5 +1,4 @@
-
-from ..resource import BaseResource, HeaderTypes, _build_headers, _ensure_http_success
+from ..resource import BaseResource, HeaderTypes
 
 
 class SendDataResource(BaseResource):
@@ -11,10 +10,10 @@ class SendDataResource(BaseResource):
         result = self._sync.send(
             "GET",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
         return None
 
@@ -22,9 +21,9 @@ class SendDataResource(BaseResource):
         result = await self._async.send(
             "GET",
             self._path,
-            headers=_build_headers(self._headers, headers),
+            headers=self._build_headers(self._headers, headers),
         )
 
-        _ensure_http_success(result.response)
+        self._ensure_http_success(result.response)
 
         return None

{ebarimt_pos_sdk-0.0.1b2 → ebarimt_pos_sdk-0.1.0}/src/ebarimt_pos_sdk/settings.py

@@ -23,6 +23,7 @@ class PosApiSettings:
     # e.g. {"Authorization": "Bearer ..."} or {"X-API-KEY": "..."}
     default_headers: HeaderTypes | None = None
 
+    @property
     def normalized_base_url(self) -> str:
         """Normalizes base_url for clients to use.
 

ebarimt_pos_sdk-0.0.1b2/src/ebarimt_pos_sdk/resources/resource.py

@@ -1,66 +0,0 @@
-# src/ebarimt_pos_sdk/resources/receipt.py
-from __future__ import annotations
-
-from abc import abstractmethod
-from typing import Any, TypeVar
-
-import httpx
-from pydantic import BaseModel
-
-from ..errors import PosApiHttpError
-from ..transport import AsyncTransport, HeaderTypes, SyncTransport
-
-T = TypeVar("T", bound=BaseModel)
-
-
-class BaseResource:
-    def __init__(
-        self,
-        *,
-        sync: SyncTransport,
-        async_: AsyncTransport,
-        headers: HeaderTypes | None = None,
-    ) -> None:
-        self._sync = sync
-        self._async = async_
-        self._headers = headers
-
-    @property
-    @abstractmethod
-    def _path(self) -> str: ...
-
-
-def _ensure_http_success(response: httpx.Response) -> httpx.Response:
-    try:
-        response.raise_for_status()
-    except httpx.HTTPStatusError as exc:
-        raise PosApiHttpError(
-            f"HTTP {exc.response.status_code}",
-            request=exc.request,
-            response=exc.response,
-        ) from exc
-    return response
-
-
-def _validate_payload(model: type[T], payload: T | dict[str, Any]) -> T:
-    if isinstance(payload, model):
-        return payload
-    return model.model_validate(payload)
-
-
-def _build_headers(*headers: HeaderTypes | None) -> httpx.Headers:
-    """Merges headers and returns one header.
-
-    Note:
-        Highest priority header should be the last.
-
-    Returns:
-        httpx.Headers: Merged header.
-    """
-    out = httpx.Headers()
-    for header in headers:
-        out.update(header)
-    return out
-
-
-__all__ = ["_ensure_http_success", "_validate_payload", "_build_headers"]