eet-gateway-client 0.1.0__tar.gz

eet_gateway_client-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 EET Gateway contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eet_gateway_client-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: eet-gateway-client
+Version: 0.1.0
+Summary: Typed Python client for the EET Gateway HTTP API v1 (Czech EET 2.0), standard library only.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/hospodskej-cz/eet-2-0
+Project-URL: Documentation, https://github.com/hospodskej-cz/eet-2-0/tree/main/clients
+Keywords: eet,eet2,czech,fiscalization,pos
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Dynamic: license-file
+
+# eet-gateway-client (Python)
+
+Typed Python client for the [EET Gateway](https://github.com/hospodskej-cz/eet-2-0) HTTP API v1
+(Czech EET 2.0). Python 3.9+, standard library only. Česky a o ostatních jazycích:
+[clients/README.md](../README.md).
+
+```sh
+pip install ./clients/python      # from a checkout; not on PyPI yet
+```
+
+```python
+import os
+from datetime import datetime
+from eet_gateway_client import EetGatewayClient, IdempotencyConflictError, SaleStatus
+
+client = EetGatewayClient("http://localhost:8080", api_key=os.environ["EET_API_KEY"])
+
+result = client.submit_sale(
+    {
+        "porad_cis": "R-1001",
+        "dat_trzby": datetime.now().astimezone().isoformat(timespec="seconds"),
+        "celk_trzba": "123.50",
+    },
+    idempotency_key="R-1001",  # repeat the call with the same key after any error
+)
+if result.is_pending:  # queued | uncertain: the gateway keeps sending
+    result = client.wait_for_sale(result)
+
+print(result.status, result.pok)
+```
+
+- `submit_sale` returns a `SaleResult` for HTTP 200 (`accepted`, `verification_ok`, `rejected`),
+  202 (`queued`, `uncertain`) and 422 (`invalid`, see `result.issues`). 409 raises
+  `IdempotencyConflictError`; other error statuses raise `ApiError` subclasses; no answer raises
+  `TransportError` / `RequestTimeoutError` (all derive from `EetGatewayError`).
+- `SaleInput` (dataclass) is an alternative to a plain `dict`; `Decimal`, `float` and `datetime`
+  values are formatted for you.
+- Every operation of the API is covered: `submit_sale`, `submit_batch`, `get_sale`,
+  `get_sale_attempts`, `retry_sale`, `list_queue` / `iter_queue`, `list_registers`,
+  `validate_sales`, `health`, `get_openapi`, `get_docs`; `*_raw` variants take NDJSON, CSV or XML.
+- The client does not retry by itself, follows no redirects and sends the API key only to the
+  URL you gave it.
+
+Tests: `pip install -e ".[test]" && pytest`. With `EET_URL` set (see the
+[overview](../README.md#vývoj)) the integration tests run against a real gateway too.

eet_gateway_client-0.1.0/README.md

@@ -0,0 +1,45 @@
+# eet-gateway-client (Python)
+
+Typed Python client for the [EET Gateway](https://github.com/hospodskej-cz/eet-2-0) HTTP API v1
+(Czech EET 2.0). Python 3.9+, standard library only. Česky a o ostatních jazycích:
+[clients/README.md](../README.md).
+
+```sh
+pip install ./clients/python      # from a checkout; not on PyPI yet
+```
+
+```python
+import os
+from datetime import datetime
+from eet_gateway_client import EetGatewayClient, IdempotencyConflictError, SaleStatus
+
+client = EetGatewayClient("http://localhost:8080", api_key=os.environ["EET_API_KEY"])
+
+result = client.submit_sale(
+    {
+        "porad_cis": "R-1001",
+        "dat_trzby": datetime.now().astimezone().isoformat(timespec="seconds"),
+        "celk_trzba": "123.50",
+    },
+    idempotency_key="R-1001",  # repeat the call with the same key after any error
+)
+if result.is_pending:  # queued | uncertain: the gateway keeps sending
+    result = client.wait_for_sale(result)
+
+print(result.status, result.pok)
+```
+
+- `submit_sale` returns a `SaleResult` for HTTP 200 (`accepted`, `verification_ok`, `rejected`),
+  202 (`queued`, `uncertain`) and 422 (`invalid`, see `result.issues`). 409 raises
+  `IdempotencyConflictError`; other error statuses raise `ApiError` subclasses; no answer raises
+  `TransportError` / `RequestTimeoutError` (all derive from `EetGatewayError`).
+- `SaleInput` (dataclass) is an alternative to a plain `dict`; `Decimal`, `float` and `datetime`
+  values are formatted for you.
+- Every operation of the API is covered: `submit_sale`, `submit_batch`, `get_sale`,
+  `get_sale_attempts`, `retry_sale`, `list_queue` / `iter_queue`, `list_registers`,
+  `validate_sales`, `health`, `get_openapi`, `get_docs`; `*_raw` variants take NDJSON, CSV or XML.
+- The client does not retry by itself, follows no redirects and sends the API key only to the
+  URL you gave it.
+
+Tests: `pip install -e ".[test]" && pytest`. With `EET_URL` set (see the
+[overview](../README.md#vývoj)) the integration tests run against a real gateway too.

eet_gateway_client-0.1.0/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eet-gateway-client"
+version = "0.1.0"
+description = "Typed Python client for the EET Gateway HTTP API v1 (Czech EET 2.0), standard library only."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+dependencies = []
+keywords = ["eet", "eet2", "czech", "fiscalization", "pos"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.9",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+
+[project.optional-dependencies]
+test = ["pytest>=7"]
+
+[project.urls]
+Homepage = "https://github.com/hospodskej-cz/eet-2-0"
+Documentation = "https://github.com/hospodskej-cz/eet-2-0/tree/main/clients"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+eet_gateway_client = ["py.typed"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

eet_gateway_client-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eet_gateway_client-0.1.0/src/eet_gateway_client/__init__.py

@@ -0,0 +1,75 @@
+"""Python client for the EET Gateway HTTP API v1 (Czech EET 2.0). See clients/README.md."""
+
+from .client import OPERATIONS, EetGatewayClient, __version__
+from .errors import (
+    ApiError,
+    AuthenticationError,
+    BadRequestError,
+    ConflictError,
+    EetGatewayError,
+    IdempotencyConflictError,
+    InvalidResponseError,
+    NotFoundError,
+    PayloadTooLargeError,
+    RequestTimeoutError,
+    ServerError,
+    TransportError,
+    UnprocessableError,
+    UnsupportedMediaTypeError,
+)
+from .models import (
+    Attempt,
+    BatchResult,
+    BatchRow,
+    Certificate,
+    EetCheck,
+    Health,
+    Issue,
+    QueuePage,
+    Register,
+    SaleData,
+    SaleInput,
+    SaleResult,
+    SaleStatus,
+    SaleWarning,
+    ValidationBatch,
+    ValidationResult,
+    ValidationRow,
+)
+
+__all__ = [
+    "OPERATIONS",
+    "ApiError",
+    "Attempt",
+    "AuthenticationError",
+    "BadRequestError",
+    "BatchResult",
+    "BatchRow",
+    "Certificate",
+    "ConflictError",
+    "EetCheck",
+    "EetGatewayClient",
+    "EetGatewayError",
+    "Health",
+    "IdempotencyConflictError",
+    "InvalidResponseError",
+    "Issue",
+    "NotFoundError",
+    "PayloadTooLargeError",
+    "QueuePage",
+    "Register",
+    "RequestTimeoutError",
+    "SaleData",
+    "SaleInput",
+    "SaleResult",
+    "SaleStatus",
+    "SaleWarning",
+    "ServerError",
+    "TransportError",
+    "UnprocessableError",
+    "UnsupportedMediaTypeError",
+    "ValidationBatch",
+    "ValidationResult",
+    "ValidationRow",
+    "__version__",
+]