setech 1.0.0__tar.gz

setech-1.0.0/LICENCE

@@ -0,0 +1,7 @@
+Copyright 2024 "Sefinance"
+
+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.

setech-1.0.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.1
+Name: setech
+Version: 1.0.0
+Summary: Setech utilities
+Author-email: Eriks Karls <eriks.karls@sefinance.lv>
+Project-URL: Homepage, https://pypi.org/project/setech/
+Keywords: setech,logging,api-client,utility,utils
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: ~=3.10
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Requires-Dist: httpx[http2]~=0.27.0
+Requires-Dist: pydantic~=2.6
+Requires-Dist: num2words~=0.5
+
+# Example code
+```python
+# client.py
+from setech import SyncClient
+
+
+class LocalClient(SyncClient):
+    name = "local"
+    _base_url = "https://obligari.serveo.net/ping/local"
+
+    def __init__(self, nonce=None):
+        super().__init__(nonce)
+        self._session.headers.update(
+            {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; rv:123.0) Gecko/20100101 Firefox/123.0"}
+        )
+
+    def send_post_ping(self, var1: str, var2: int) -> bool:
+        res = self.post("/some-post", json={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_put_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-put", data={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_get_ping(self, var1: str, var2: int) -> bool:
+        res = self.get("/some-get", params={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_patch_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-patch", data=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+
+    def send_trace_ping(self, var1: str, var2: int) -> bool:
+        res = self.trace("/some-trace", params=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+```
+
+```python
+# main.py
+from .client import LocalClient
+
+
+client = LocalClient()
+client.send_post_ping("asd", 123)
+client.send_put_ping("asd", 123)
+client.send_get_ping("asd", 123)
+client.send_patch_ping("asd", 123)
+client.send_trace_ping("asd", 123)
+```
+
+## Log output
+### Simple
+```text
+[14d709e02c0c] Preparing POST request to "https://obligari.serveo.net/ping/local/some-post"
+[14d709e02c0c] Sending request with payload=b'{"variable_one": "asd", "second_variable": 123}'
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":62}'
+[14d709e02c0c] Preparing GET request to "https://obligari.serveo.net/ping/local/some-get"
+[14d709e02c0c] Sending request with payload=None
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":63}'
+```
+### Structured
+```json
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing POST request to \"https://obligari.serveo.net/ping/local/some-post\"", "extra_data": {"hooks": {"response": []}, "method": "POST", "url": "https://obligari.serveo.net/ping/local/some-post", "headers": {}, "files": [], "data": [], "json": {"variable_one": "asd", "second_variable": 123}, "params": {}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=b'{\"variable_one\": \"asd\", \"second_variable\": 123}'", "extra_data": {"payload": "{\"variable_one\": \"asd\", \"second_variable\": 123}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":72}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":72}"}}
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing GET request to \"https://obligari.serveo.net/ping/local/some-get\"", "extra_data": {"hooks": {"response": []}, "method": "GET", "url": "https://obligari.serveo.net/ping/local/some-get", "headers": {}, "files": [], "data": [], "json": null, "params": {"variable_one": "asd", "second_variable": 123}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=None", "extra_data": {"payload": "{}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":74}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":73}"}}
+```

setech-1.0.0/README.md

@@ -0,0 +1,69 @@
+# Example code
+```python
+# client.py
+from setech import SyncClient
+
+
+class LocalClient(SyncClient):
+    name = "local"
+    _base_url = "https://obligari.serveo.net/ping/local"
+
+    def __init__(self, nonce=None):
+        super().__init__(nonce)
+        self._session.headers.update(
+            {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; rv:123.0) Gecko/20100101 Firefox/123.0"}
+        )
+
+    def send_post_ping(self, var1: str, var2: int) -> bool:
+        res = self.post("/some-post", json={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_put_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-put", data={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_get_ping(self, var1: str, var2: int) -> bool:
+        res = self.get("/some-get", params={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_patch_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-patch", data=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+
+    def send_trace_ping(self, var1: str, var2: int) -> bool:
+        res = self.trace("/some-trace", params=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+```
+
+```python
+# main.py
+from .client import LocalClient
+
+
+client = LocalClient()
+client.send_post_ping("asd", 123)
+client.send_put_ping("asd", 123)
+client.send_get_ping("asd", 123)
+client.send_patch_ping("asd", 123)
+client.send_trace_ping("asd", 123)
+```
+
+## Log output
+### Simple
+```text
+[14d709e02c0c] Preparing POST request to "https://obligari.serveo.net/ping/local/some-post"
+[14d709e02c0c] Sending request with payload=b'{"variable_one": "asd", "second_variable": 123}'
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":62}'
+[14d709e02c0c] Preparing GET request to "https://obligari.serveo.net/ping/local/some-get"
+[14d709e02c0c] Sending request with payload=None
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":63}'
+```
+### Structured
+```json
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing POST request to \"https://obligari.serveo.net/ping/local/some-post\"", "extra_data": {"hooks": {"response": []}, "method": "POST", "url": "https://obligari.serveo.net/ping/local/some-post", "headers": {}, "files": [], "data": [], "json": {"variable_one": "asd", "second_variable": 123}, "params": {}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=b'{\"variable_one\": \"asd\", \"second_variable\": 123}'", "extra_data": {"payload": "{\"variable_one\": \"asd\", \"second_variable\": 123}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":72}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":72}"}}
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing GET request to \"https://obligari.serveo.net/ping/local/some-get\"", "extra_data": {"hooks": {"response": []}, "method": "GET", "url": "https://obligari.serveo.net/ping/local/some-get", "headers": {}, "files": [], "data": [], "json": null, "params": {"variable_one": "asd", "second_variable": 123}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=None", "extra_data": {"payload": "{}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":74}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":73}"}}
+```

setech-1.0.0/pyproject.toml

@@ -0,0 +1,83 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "setech"
+dynamic = ["version"]
+description = "Setech utilities"
+readme = "README.md"
+requires-python = "~=3.10"
+license = { file = "LICENSE" }
+keywords = ["setech", "logging", "api-client", "utility", "utils"]
+authors = [
+  { name = "Eriks Karls", email = "eriks.karls@sefinance.lv" },
+]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3 :: Only",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+]
+dependencies = [
+  "httpx[http2]~=0.27.0",
+  "pydantic~=2.6",
+  "num2words~=0.5"
+]
+
+
+[project.urls]
+"Homepage" = "https://pypi.org/project/setech/"
+
+
+[tool.setuptools.dynamic]
+version = { attr = "setech.__version__" }
+
+
+[tool.bumpversion]
+current_version = "1.0.0"
+commit = true
+tag = true
+tag_name = "v{new_version}"
+tag_message = "Bump version: {current_version} → {new_version}"
+allow_dirty = false
+parse = "(?P<major>\\d+)\\.(?P<minor>\\d+)\\.(?P<patch>\\d+)"
+serialize = ["{major}.{minor}.{patch}"]
+message = "Bump version: {current_version} → {new_version}"
+
+
+[[tool.bumpversion.files]]
+filename = "src/setech/__init__.py"
+
+
+[tool.black]
+line-length = 120
+target-version = ['py311']
+include = '\.pyi?$'
+extend-exclude = '''(
+    | .git/*
+)'''
+workers = 4
+
+
+[tool.isort]
+profile = "black"
+line_length = 120
+skip = ["env", "venv", ".venv", ".git"]
+
+
+[tool.mypy]
+python_version = "3.11"
+exclude = ['^\.?venv/',]
+plugins = ["pydantic.mypy"]
+warn_unused_configs = true
+disallow_untyped_defs = true
+implicit_optional = true
+warn_redundant_casts = true
+warn_no_return = true
+ignore_missing_imports = false

setech-1.0.0/setup.cfg

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

setech-1.0.0/src/setech/__init__.py

@@ -0,0 +1,4 @@
+from setech.api_client import AsyncClient, SyncClient
+
+__version__ = "1.0.0"
+__all__ = ["SyncClient", "AsyncClient"]

setech-1.0.0/src/setech/api_client/__init__.py

@@ -0,0 +1,4 @@
+from .async_client import AsyncClient
+from .sync_client import SyncClient
+
+__all__ = ["AsyncClient", "SyncClient"]

setech-1.0.0/src/setech/api_client/_base.py

@@ -0,0 +1,124 @@
+import logging
+from abc import ABC, abstractmethod
+from typing import Any, Coroutine
+
+import httpx
+from pydantic import HttpUrl
+
+from setech.utils import get_logger, get_nonce, shortify_log_dict
+
+_TypeSyncAsyncResponse = httpx.Response | Coroutine[Any, Any, httpx.Response]
+
+
+class BaseClient(ABC):
+    base_url: HttpUrl
+    _session: httpx._client.BaseClient
+    _nonce: str
+    _logger: logging.Logger
+
+    def __init__(self, nonce: str = "", session: httpx._client.BaseClient | None = None):
+        self._nonce = nonce or get_nonce()
+        self._session = session or httpx.Client()
+        self._logger = get_logger("APIClient")
+
+    @abstractmethod
+    def get(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def post(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def put(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def patch(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def delete(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def head(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def options(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def trace(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def connect(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    @abstractmethod
+    def _request(self, method: str, endpoint: str, **kwargs: Any) -> _TypeSyncAsyncResponse:
+        pass
+
+    def _make_full_url(self, endpoint: str) -> str:
+        return f"{self.base_url}{endpoint}"
+
+    def prepare_authentication(self, request: httpx.Request) -> httpx.Request:
+        return request
+
+    def _prepare_request(self, method: str, endpoint: str, **kwargs: Any) -> httpx.Request:
+        full_url = self._make_full_url(endpoint)
+
+        self._debug_log_request(method, full_url)
+        request: httpx.Request = self._session.build_request(method=method, url=full_url, **kwargs)
+        self._debug_log_prepared_request(request)
+        self._debug(f"Prepared {request.method} request to '{request.url}'", extra=request.__dict__)
+
+        self._info_log_request_sending(
+            request, kwargs.get("content") or kwargs.get("files") or kwargs.get("data") or kwargs.get("json")
+        )
+        return request
+
+    def _debug_log_request(self, method: str, full_url: str) -> None:
+        self._debug(f"Preparing {method} request for '{full_url}'")
+
+    def _debug_log_prepared_request(self, request: httpx.Request) -> None:
+        self._debug(f"Prepared {request.method} request to '{request.url}'", extra=request.__dict__)
+
+    def _info_log_request_sending(self, request: httpx.Request, log_payload: Any) -> None:
+        self._info(
+            f"Sending {request.method} request to '{request.url}' with payload={shortify_log_dict(log_payload)!r}",
+            extra={"payload": shortify_log_dict(log_payload)},
+        )
+
+    def _info_log_response(self, response: httpx.Response) -> None:
+        str_repr_content = response.content.decode("utf8")[:500]
+        self._info(
+            f"Response {response.status_code=} {str_repr_content=}",
+            extra={"status_code": response.status_code, "content": str_repr_content},
+        )
+
+    def _info(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        self._log("INFO", f"[{self._nonce}] {msg}", *args, **kwargs)
+
+    def _debug(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        self._log("DEBUG", f"[{self._nonce}] {msg}", *args, **kwargs)
+
+    def _warn(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        self._log("WARNING", f"[{self._nonce}] {msg}", *args, **kwargs)
+
+    def _error(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        self._log("ERROR", f"[{self._nonce}] {msg}", *args, **kwargs)
+
+    def _critical(self, msg: str, *args: Any, **kwargs: Any) -> None:
+        self._log("CRITICAL", f"[{self._nonce}] {msg}", *args, **kwargs)
+
+    def _log(
+        self, level: str, msg: object, *args: object, stacklevel: int = 5, extra: dict | None = None, **kwargs: Any
+    ) -> None:
+        extra = extra or {}
+        extra.update(nonce=self._nonce)
+        self._logger.log(
+            logging.getLevelNamesMapping()[level], msg, *args, stacklevel=stacklevel, extra=extra, **kwargs
+        )

setech-1.0.0/src/setech/api_client/async_client.py

@@ -0,0 +1,46 @@
+from typing import Any
+
+import httpx
+
+from ._base import BaseClient
+
+
+class AsyncClient(BaseClient):
+    _session: httpx.AsyncClient
+
+    def __init__(self, nonce: str = "", session: httpx.AsyncClient | None = None):
+        super().__init__(nonce, session or httpx.AsyncClient(http2=True))
+
+    async def get(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def post(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("POST", endpoint, json=json, data=data, **kwargs)
+
+    async def put(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("PUT", endpoint, json=json, data=data, **kwargs)
+
+    async def patch(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, json=json, data=data, **kwargs)
+
+    async def delete(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def head(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def options(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def trace(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def connect(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return await self._request("GET", endpoint, params=params, **kwargs)
+
+    async def _request(self, method: str, endpoint: str, **kwargs: Any) -> httpx.Response:
+        request = self._prepare_request(method, endpoint, **kwargs)
+        response = await self._session.send(request, auth=self.prepare_authentication)
+        self._info_log_response(response)
+
+        return response

setech-1.0.0/src/setech/api_client/sync_client.py

@@ -0,0 +1,47 @@
+from abc import ABC
+from typing import Any
+
+import httpx
+
+from ._base import BaseClient
+
+
+class SyncClient(BaseClient, ABC):
+    _session: httpx.Client
+
+    def __init__(self, nonce: str = "", session: httpx.Client | None = None):
+        super().__init__(nonce, session or httpx.Client(http2=True))
+
+    def get(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("GET", endpoint, params=params, **kwargs)
+
+    def post(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("POST", endpoint, json=json, data=data, **kwargs)
+
+    def put(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("PUT", endpoint, json=json, data=data, **kwargs)
+
+    def patch(self, endpoint: str, *, json: Any = None, data: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("PATCH", endpoint, json=json, data=data, **kwargs)
+
+    def delete(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("DELETE", endpoint, params=params, **kwargs)
+
+    def head(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("HEAD", endpoint, params=params, **kwargs)
+
+    def options(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("OPTIONS", endpoint, params=params, **kwargs)
+
+    def trace(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("TRACE", endpoint, params=params, **kwargs)
+
+    def connect(self, endpoint: str, *, params: Any = None, **kwargs: Any) -> httpx.Response:
+        return self._request("CONNECT", endpoint, params=params, **kwargs)
+
+    def _request(self, method: str, endpoint: str, **kwargs: Any) -> httpx.Response:
+        request = self._prepare_request(method, endpoint, **kwargs)
+        response = self._session.send(request, auth=self.prepare_authentication)
+        self._info_log_response(response)
+
+        return response

setech-1.0.0/src/setech/constants/__init__.py

@@ -0,0 +1,3 @@
+from .date import LATVIAN_MONTH_MAP_GEN, LATVIAN_MONTH_MAP_NOM
+
+__all__ = ["LATVIAN_MONTH_MAP_NOM", "LATVIAN_MONTH_MAP_GEN"]

setech-1.0.0/src/setech/constants/date.py

@@ -0,0 +1,28 @@
+LATVIAN_MONTH_MAP_NOM = {
+    1: "janvāris",
+    2: "februāris",
+    3: "marts",
+    4: "aprīlis",
+    5: "maijs",
+    6: "jūnijs",
+    7: "jūlijs",
+    8: "augusts",
+    9: "septembris",
+    10: "oktobris",
+    11: "novembris",
+    12: "decembris",
+}
+LATVIAN_MONTH_MAP_GEN = {
+    1: "janvārī",
+    2: "februārī",
+    3: "martā",
+    4: "aprīlī",
+    5: "maijā",
+    6: "jūnijā",
+    7: "jūlijā",
+    8: "augustā",
+    9: "septembrī",
+    10: "oktobrī",
+    11: "novembrī",
+    12: "decembrī",
+}

setech-1.0.0/src/setech/logging/__init__.py

@@ -0,0 +1,3 @@
+from .formatters import LogJSONFormatter
+
+__all__ = ["LogJSONFormatter"]

setech-1.0.0/src/setech/logging/formatters.py

@@ -0,0 +1,47 @@
+import datetime
+import json
+import os
+from logging import Formatter, LogRecord
+
+from setech.utils import SetechJSONEncoder
+
+
+class LogJSONFormatter(Formatter):
+    default_time_format = "%Y-%m-%d %H:%M:%S"
+
+    def format(self, record: LogRecord) -> str:
+        record_default_keys = [
+            "name",
+            "msg",
+            "args",
+            "levelname",
+            "levelno",
+            "pathname",
+            "exc_info",
+            "filename",
+            "lineno",
+            "funcName",
+            "created",
+            "msecs",
+            "relativeCreated",
+            "thread",
+            "threadName",
+            "processName",
+            "process",
+            "message",
+            "asctime",
+            "module",
+            "exc_text",
+            "stack_info",
+        ]
+        structured_data = dict(
+            app=os.environ.get("APP_NAME", "dev"),
+            level=record.levelname,
+            name=record.name,
+            date_time=datetime.datetime.fromtimestamp(record.created).strftime(self.default_time_format),
+            location=f"{record.pathname or record.filename}:{record.funcName}:{record.lineno}",
+            message=record.getMessage(),
+            extra_data={k: record.__dict__[k] for k in record.__dict__.keys() if k not in record_default_keys},
+        )
+
+        return json.dumps(structured_data, cls=SetechJSONEncoder)

setech-1.0.0/src/setech/utils/__init__.py

@@ -0,0 +1,21 @@
+from .numeric import round_decimal
+from .parse import SetechJSONEncoder
+from .ssn import generate_aged_latvian_personal_code, generate_random_latvian_personal_code
+from .text import convert_datetime_to_latvian_words, convert_number_to_latvian_words
+from .validators import validate_iban, validate_latvian_personal_code
+from .various import get_logger, get_nonce, shorten_dict_values, shortify_log_dict
+
+__all__ = [
+    "round_decimal",
+    "SetechJSONEncoder",
+    "convert_datetime_to_latvian_words",
+    "convert_number_to_latvian_words",
+    "generate_aged_latvian_personal_code",
+    "generate_random_latvian_personal_code",
+    "validate_iban",
+    "validate_latvian_personal_code",
+    "get_logger",
+    "get_nonce",
+    "shorten_dict_values",
+    "shortify_log_dict",
+]

setech-1.0.0/src/setech/utils/numeric.py

@@ -0,0 +1,21 @@
+import decimal
+
+
+def round_decimal(dec: decimal.Decimal, precision: int = 4) -> decimal.Decimal:
+    """
+    :param dec: Decimal value to round
+    :param precision: how many digits since the start of the value to keep
+            dec=123.456, precision=7 -> 123.4560,
+            dec=123.456, precision=5 -> 123.46,
+            dec=123.456, precision=3 -> 123,
+            dec=123.456, precision=2 -> 120;
+    :return: rounded Decimal
+    """
+    with decimal.localcontext() as ctx:
+        ctx.rounding = decimal.ROUND_HALF_UP
+        value = decimal.Decimal(dec)
+        dec_tuple = dec.as_tuple()
+        whole_numbers = len(dec_tuple.digits) + dec_tuple.exponent  # type: ignore
+        ctx.prec = precision + whole_numbers
+        value = value * 1
+    return value

setech-1.0.0/src/setech/utils/parse.py

@@ -0,0 +1,70 @@
+import dataclasses
+import datetime
+import decimal
+import json
+from typing import Any
+
+from pydantic import BaseModel
+
+__all__ = [
+    "SetechJSONEncoder",
+    "str_as_date",
+    "str_as_date_or_none",
+    "as_decimal",
+    "as_decimal_or_none",
+]
+
+
+def str_as_date(date_str: str, date_format: str = "%Y-%m-%d") -> datetime.date:
+    datetime_object = datetime.datetime.strptime(date_str, date_format)
+    return datetime_object.date()
+
+
+def str_as_date_or_none(date_str: str | None, date_format: str = "%Y-%m-%d") -> datetime.date | None:
+    if not isinstance(date_str, str):
+        return None
+    try:
+        return str_as_date(date_str, date_format)
+    except (ValueError, TypeError):
+        return None
+
+
+def as_decimal(decimal_str: str | int | float) -> decimal.Decimal:
+    return decimal.Decimal(str(decimal_str))
+
+
+def as_decimal_or_none(decimal_str: str | int | float | None) -> decimal.Decimal | None:
+    if not isinstance(decimal_str, (str | int | float)):
+        return None
+    try:
+        return as_decimal(decimal_str)
+    except (decimal.DecimalException, TypeError):
+        return None
+
+
+class SetechJSONEncoder(json.JSONEncoder):
+    def default(self, obj: Any) -> Any:
+        try:
+            if isinstance(obj, decimal.Decimal):
+                return str(obj)
+            if isinstance(obj, (datetime.datetime, datetime.date)):
+                return obj.isoformat()
+            if isinstance(obj, BaseModel):
+                return obj.model_dump_json()
+            if isinstance(obj, datetime.timedelta):
+                return dict(__type__="timedelta", total_seconds=obj.total_seconds())
+            if hasattr(obj, "as_dict"):
+                if callable(getattr(obj, "as_dict")):
+                    return super().default(obj.as_dict())
+                return super().default(obj.as_dict)
+            if dataclasses.is_dataclass(obj):
+                return super().default(dataclasses.asdict(obj))
+            if isinstance(obj, set):
+                return list(obj)
+            if hasattr(obj, "__dict__"):
+                return obj.__dict__
+            return super().default(obj)
+        except TypeError as exc:
+            if "not JSON serializable" in str(exc):
+                return str(obj)
+            raise exc

setech-1.0.0/src/setech/utils/ssn.py

@@ -0,0 +1,134 @@
+import datetime
+from random import randint
+from typing import NamedTuple
+
+__all__ = [
+    "generate_random_latvian_personal_code",
+    "generate_aged_latvian_personal_code",
+    "PersonalCode",
+]
+
+START_LEGACY_DATE: datetime.date = datetime.date(1923, 1, 1)
+FINAL_LEGACY_DATE: datetime.date = datetime.date(2017, 7, 1)
+
+
+def generate_random_latvian_personal_code(anonymous: bool = False) -> str:
+    if anonymous:
+        return PersonalCode.generate_anonymous_with_check_digit().dashed
+    return PersonalCode.generate_legacy_with_check_digit().dashed
+
+
+def generate_aged_latvian_personal_code(years: int) -> str:
+    return PersonalCode.generate_legacy_with_check_digit(years).dashed
+
+
+class PersonalCode(NamedTuple):
+    first_part: str
+    second_part: str
+    has_check_digit: bool = False
+
+    @classmethod
+    def generate_anonymous_personal_code(cls) -> "PersonalCode":
+        pc = f"3{randint(2 * 10 ** 9, 10 * 10 ** 9 - 1)}"
+        first_part = pc[:6]
+        second_part = pc[6:]
+        instance = cls(first_part, second_part)
+        return instance
+
+    @classmethod
+    def generate_anonymous_with_check_digit(cls) -> "PersonalCode":
+        tmp = cls.generate_anonymous_personal_code()
+        check_digit = tmp._get_checksum_digit()
+        if check_digit == 10:
+            return tmp.generate_anonymous_with_check_digit()
+        second_part = tmp.second_part[:-1] + str(check_digit)
+        instance = cls(tmp.first_part, second_part, True)
+        return instance
+
+    @classmethod
+    def generate_legacy_with_check_digit(cls, years: int = None) -> "PersonalCode":
+        if years is not None:
+            if years < (datetime.date.today() - FINAL_LEGACY_DATE).days // 365:
+                raise ValueError(
+                    "Too young for legacy Personal Code! years < "
+                    f"{(datetime.date.today() - FINAL_LEGACY_DATE).days // 365}"
+                )
+            min_age_in_days = abs(years) * 365
+            max_age_in_days = abs(years + 1) * 365
+            birthdate = datetime.date.today() - datetime.timedelta(days=randint(min_age_in_days, max_age_in_days))
+        else:
+            max_age_in_days = (FINAL_LEGACY_DATE - START_LEGACY_DATE).days
+            min_age_in_days = 1
+            birthdate = FINAL_LEGACY_DATE - datetime.timedelta(days=randint(min_age_in_days, max_age_in_days))
+        return cls._create_from_birthday(birthdate)
+
+    @classmethod
+    def generate_legacy_for_birthday(cls, *args: datetime.date | int) -> "PersonalCode":
+        if len(args) == 1:
+            if not isinstance(args[0], datetime.date):
+                raise ValueError(
+                    f"Calling method with one parameter, it must be of type `datetime.date` not `{type(args[0])}`"
+                )
+            birthday = args[0]
+        elif len(args) == 3:
+            if isinstance(args[0], int) and isinstance(args[1], int) and isinstance(args[2], int):
+                birthday = datetime.date(args[0], args[1], args[2])
+            else:
+                raise ValueError(
+                    "When calling method with three parameters, "
+                    f"they all must be of type `int` not `{[type(arg) for arg in args]}`"
+                )
+        else:
+            raise ValueError(
+                "Method must be called with either one argument which is `datetime.date` or three int parameters "
+                "which represent year, month, day representing dates between "
+                f"{START_LEGACY_DATE} and {FINAL_LEGACY_DATE}"
+            )
+        if not START_LEGACY_DATE <= birthday < FINAL_LEGACY_DATE:
+            raise ValueError(
+                "Legacy non-anonymous personal codes are generated for "
+                f"birthdays since {START_LEGACY_DATE} till {FINAL_LEGACY_DATE}!\n"
+                f"{START_LEGACY_DATE} <= {birthday} < {FINAL_LEGACY_DATE}"
+            )
+        return cls._create_from_birthday(birthday)
+
+    @classmethod
+    def _create_from_birthday(cls, birthday: datetime.date) -> "PersonalCode":
+        first_part = f"{birthday.day:02d}{birthday.month:02d}{str(birthday.year)[2:]}"
+        century_digit = 2 if birthday.year // 2000 else 1 if birthday.year // 1900 else 0
+        second_part = f"{century_digit}{randint(0, 999):03}"
+        tmp = cls(first_part, second_part)
+        check_digit = tmp._get_checksum_digit()
+        if check_digit == 10:
+            return cls.generate_legacy_with_check_digit()
+        second_part = f"{second_part}{check_digit}"
+        return cls(first_part, second_part, True)
+
+    def as_tuple(self) -> tuple[str, str]:
+        return self.first_part, self.second_part
+
+    def __str__(self) -> str:
+        return f"{self.first_part}{self.second_part}"
+
+    def _get_checksum_digit(self) -> int:
+        _factors = [1, 6, 3, 7, 9, 10, 5, 8, 4, 2]
+        return (1101 - sum(map(lambda p, f: int(p) * f, str(self)[:10], _factors))) % 11
+
+    @property
+    def dashed(self) -> str:
+        return f"{self.first_part}-{self.second_part}"
+
+    @property
+    def is_valid(self) -> bool:
+        return str(self._get_checksum_digit()) == self.second_part[-1]
+
+    @property
+    def date_of_birth(self) -> datetime.date:
+        if int(self.first_part[:2]) > 31:
+            raise ValueError("Unable to get date of birth for anonymous personal codes!")
+        return datetime.date(
+            (1800 if self.second_part[0] == "0" else 1900 if self.second_part[0] == "1" else 2000)
+            + int(self.first_part[4:]),
+            int(self.first_part[2:4]),
+            int(self.first_part[:2]),
+        )

setech-1.0.0/src/setech/utils/text.py

@@ -0,0 +1,35 @@
+import datetime
+import decimal
+
+from num2words import num2words  # type: ignore
+
+from setech.constants import LATVIAN_MONTH_MAP_GEN, LATVIAN_MONTH_MAP_NOM
+
+
+def convert_number_to_latvian_words(number: decimal.Decimal, with_currency: bool = True) -> str:
+    """Convert a number into words in Latvian language."""
+    if not number:
+        return ""
+
+    whole_part = int(number)
+    fraction_part = round((number - whole_part) * 100)
+    text = num2words(whole_part, lang="lv")
+
+    if with_currency:
+        text += f" eiro, {fraction_part:02d} centi"
+    else:
+        text += f", {fraction_part:02d}"
+
+    if whole_part in [100, 1000]:
+        text = "viens " + text
+
+    return text
+
+
+def convert_datetime_to_latvian_words(date: datetime.date | None = None, genitive: bool = False) -> str:
+    """Convert a date into words in Latvian language."""
+    if date is None:
+        date = datetime.date.today()
+    date_sign_contract = date.strftime("%Y. gada %d. ")
+    date_sign_contract += (LATVIAN_MONTH_MAP_GEN if genitive else LATVIAN_MONTH_MAP_NOM)[date.month]
+    return date_sign_contract

setech-1.0.0/src/setech/utils/validators.py

@@ -0,0 +1,31 @@
+import re
+from string import ascii_uppercase
+
+from setech.utils.ssn import PersonalCode
+
+
+def validate_iban(iban: str) -> bool:
+    # Sanitization and sanity check
+    _iban = iban.upper().replace(" ", "")
+    if not re.search(r"^[A-Z0-9]{10,32}$", _iban):
+        return False
+    char_map = {str(i): i for i in range(10)}
+    char_map.update({l: i for i, l in enumerate(ascii_uppercase, start=10)})
+
+    letters = {ord(k): str(v) for k, v in char_map.items()}
+
+    zeros_iban = _iban[:2] + "00" + _iban[4:]
+    iban_inverted = zeros_iban[4:] + zeros_iban[:4]
+    iban_numbered = iban_inverted.translate(letters)
+
+    verification_chars = 98 - (int(iban_numbered) % 97)
+
+    if f"{int(verification_chars):02}" == _iban[2:4]:
+        iban_inverted = _iban[4:] + _iban[:4]
+        iban_numbered = iban_inverted.translate(letters)
+        return int(iban_numbered) % 97 == 1
+    return False
+
+
+def validate_latvian_personal_code(personal_code: str) -> bool:
+    return PersonalCode(personal_code[:6], personal_code[-5:], True).is_valid

setech-1.0.0/src/setech/utils/various.py

@@ -0,0 +1,35 @@
+import dataclasses
+import json
+import logging
+from dataclasses import asdict
+from typing import Any
+from uuid import uuid4
+
+from .parse import SetechJSONEncoder
+
+__all__ = ["get_logger", "get_nonce", "shorten_dict_values", "shortify_log_dict"]
+
+
+def get_logger(name: str = "service") -> logging.Logger:
+    return logging.getLogger(name)
+
+
+def shorten_dict_values(dct: dict) -> dict:
+    res = {}
+    for k, v in dct.items():
+        if isinstance(v, str) and len(v) > 64:
+            v = f"{v[:30]}...{v[-30:]}"
+        elif isinstance(v, dict):
+            v = shorten_dict_values(v)
+        res[k] = v
+    return res
+
+
+def shortify_log_dict(dct: Any) -> dict[str, Any]:
+    if dataclasses.is_dataclass(dct):
+        dct = asdict(dct)
+    return json.loads(json.dumps(shorten_dict_values(dct), cls=SetechJSONEncoder))
+
+
+def get_nonce() -> str:
+    return uuid4().hex[:12]

setech-1.0.0/src/setech.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.1
+Name: setech
+Version: 1.0.0
+Summary: Setech utilities
+Author-email: Eriks Karls <eriks.karls@sefinance.lv>
+Project-URL: Homepage, https://pypi.org/project/setech/
+Keywords: setech,logging,api-client,utility,utils
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: ~=3.10
+Description-Content-Type: text/markdown
+License-File: LICENCE
+Requires-Dist: httpx[http2]~=0.27.0
+Requires-Dist: pydantic~=2.6
+Requires-Dist: num2words~=0.5
+
+# Example code
+```python
+# client.py
+from setech import SyncClient
+
+
+class LocalClient(SyncClient):
+    name = "local"
+    _base_url = "https://obligari.serveo.net/ping/local"
+
+    def __init__(self, nonce=None):
+        super().__init__(nonce)
+        self._session.headers.update(
+            {"User-Agent": "Mozilla/5.0 (Windows NT 10.0; rv:123.0) Gecko/20100101 Firefox/123.0"}
+        )
+
+    def send_post_ping(self, var1: str, var2: int) -> bool:
+        res = self.post("/some-post", json={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_put_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-put", data={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_get_ping(self, var1: str, var2: int) -> bool:
+        res = self.get("/some-get", params={"variable_one": var1, "second_variable": var2})
+        return res.json().get("status")
+
+    def send_patch_ping(self, var1: str, var2: int) -> bool:
+        res = self.put("/some-patch", data=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+
+    def send_trace_ping(self, var1: str, var2: int) -> bool:
+        res = self.trace("/some-trace", params=(("variable_one", var1), ("variable_one", var2)))
+        return res.json().get("status")
+```
+
+```python
+# main.py
+from .client import LocalClient
+
+
+client = LocalClient()
+client.send_post_ping("asd", 123)
+client.send_put_ping("asd", 123)
+client.send_get_ping("asd", 123)
+client.send_patch_ping("asd", 123)
+client.send_trace_ping("asd", 123)
+```
+
+## Log output
+### Simple
+```text
+[14d709e02c0c] Preparing POST request to "https://obligari.serveo.net/ping/local/some-post"
+[14d709e02c0c] Sending request with payload=b'{"variable_one": "asd", "second_variable": 123}'
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":62}'
+[14d709e02c0c] Preparing GET request to "https://obligari.serveo.net/ping/local/some-get"
+[14d709e02c0c] Sending request with payload=None
+[14d709e02c0c] Response response.status_code=200 str_repr_content='{"status":true,"request_id":63}'
+```
+### Structured
+```json
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing POST request to \"https://obligari.serveo.net/ping/local/some-post\"", "extra_data": {"hooks": {"response": []}, "method": "POST", "url": "https://obligari.serveo.net/ping/local/some-post", "headers": {}, "files": [], "data": [], "json": {"variable_one": "asd", "second_variable": 123}, "params": {}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:24", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=b'{\"variable_one\": \"asd\", \"second_variable\": 123}'", "extra_data": {"payload": "{\"variable_one\": \"asd\", \"second_variable\": 123}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":72}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":72}"}}
+{"app": "dev", "level": "DEBUG", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:71", "message": "[cfbdadc56f53] Preparing GET request to \"https://obligari.serveo.net/ping/local/some-get\"", "extra_data": {"hooks": {"response": []}, "method": "GET", "url": "https://obligari.serveo.net/ping/local/some-get", "headers": {}, "files": [], "data": [], "json": null, "params": {"variable_one": "asd", "second_variable": 123}, "auth": null, "cookies": null}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:74", "message": "[cfbdadc56f53] Sending request with payload=None", "extra_data": {"payload": "{}"}}
+{"app": "dev", "level": "INFO", "name": "APIClient", "date_time": "2024-03-09 22:59:25", "location": "api_client/client.py:_request:81", "message": "[cfbdadc56f53] Response response.status_code=200 str_repr_content='{\"status\":true,\"request_id\":74}'", "extra_data": {"status_code": 200, "content": "{\"status\":true,\"request_id\":73}"}}
+```

setech-1.0.0/src/setech.egg-info/SOURCES.txt

@@ -0,0 +1,25 @@
+LICENCE
+README.md
+pyproject.toml
+src/setech/__init__.py
+src/setech/py.typed
+src/setech.egg-info/PKG-INFO
+src/setech.egg-info/SOURCES.txt
+src/setech.egg-info/dependency_links.txt
+src/setech.egg-info/requires.txt
+src/setech.egg-info/top_level.txt
+src/setech/api_client/__init__.py
+src/setech/api_client/_base.py
+src/setech/api_client/async_client.py
+src/setech/api_client/sync_client.py
+src/setech/constants/__init__.py
+src/setech/constants/date.py
+src/setech/logging/__init__.py
+src/setech/logging/formatters.py
+src/setech/utils/__init__.py
+src/setech/utils/numeric.py
+src/setech/utils/parse.py
+src/setech/utils/ssn.py
+src/setech/utils/text.py
+src/setech/utils/validators.py
+src/setech/utils/various.py

setech-1.0.0/src/setech.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

setech-1.0.0/src/setech.egg-info/requires.txt

@@ -0,0 +1,3 @@
+httpx[http2]~=0.27.0
+pydantic~=2.6
+num2words~=0.5

setech-1.0.0/src/setech.egg-info/top_level.txt

@@ -0,0 +1 @@
+setech