python3-commons 0.17.8__tar.gz → 0.18.0__tar.gz

{python3_commons-0.17.8/src/python3_commons.egg-info → python3_commons-0.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-commons
-Version: 0.17.8
+Version: 0.18.0
 Summary: Re-usable Python3 code
 Author-email: Oleg Korsak <kamikaze.is.waiting.you@gmail.com>
 License-Expression: GPL-3.0
@@ -16,15 +16,14 @@ Requires-Dist: msgpack~=1.1.2
 Requires-Dist: msgspec==0.21.1
 Requires-Dist: pydantic-settings~=2.14.0
 Provides-Extra: all
-Requires-Dist: python3_commons[api-client,audit,authn,authz,cache,database,object-storage]; extra == "all"
+Requires-Dist: python3_commons[api-client,audit,authn,authz,cache,database,object-storage,soap-client]; extra == "all"
 Provides-Extra: api-client
 Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "api-client"
 Requires-Dist: lxml~=6.1.0; extra == "api-client"
-Requires-Dist: zeep~=4.3.2; extra == "api-client"
 Requires-Dist: python3_commons[object-storage]; extra == "api-client"
 Provides-Extra: audit
 Requires-Dist: lxml~=6.1.0; extra == "audit"
-Requires-Dist: zeep~=4.3.2; extra == "audit"
+Requires-Dist: zeep[async]~=4.3.2; extra == "audit"
 Requires-Dist: python3_commons[object-storage]; extra == "audit"
 Provides-Extra: authn
 Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "authn"
@@ -40,6 +39,11 @@ Requires-Dist: SQLAlchemy[asyncio]~=2.0.49; extra == "database"
 Provides-Extra: object-storage
 Requires-Dist: aiobotocore~=3.5.0; extra == "object-storage"
 Requires-Dist: object-storage-client==0.0.23; extra == "object-storage"
+Provides-Extra: soap-client
+Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "soap-client"
+Requires-Dist: lxml~=6.1.0; extra == "soap-client"
+Requires-Dist: requests~=2.33.1; extra == "soap-client"
+Requires-Dist: zeep[async]~=4.3.2; extra == "soap-client"
 Dynamic: license-file
 
 Re-usable Python3 code

{python3_commons-0.17.8 → python3_commons-0.18.0}/pyproject.toml

@@ -25,17 +25,16 @@ dependencies = [
 
 [project.optional-dependencies]
 all = [
-    "python3_commons[api-client,audit,authn,authz,cache,database,object-storage]"
+    "python3_commons[api-client,audit,authn,authz,cache,database,object-storage,soap-client]"
 ]
 api-client = [
     "aiohttp[speedups]>=3.13.5,<3.15.0",
     "lxml~=6.1.0",
-    "zeep~=4.3.2",
     "python3_commons[object-storage]"
 ]
 audit = [
     "lxml~=6.1.0",
-    "zeep~=4.3.2",
+    "zeep[async]~=4.3.2",
     "python3_commons[object-storage]"
 ]
 authn = [
@@ -57,6 +56,12 @@ object-storage = [
     "aiobotocore~=3.5.0",
     "object-storage-client==0.0.23"
 ]
+soap-client = [
+    "aiohttp[speedups]>=3.13.5,<3.15.0",
+    "lxml~=6.1.0",
+    "requests~=2.33.1",
+    "zeep[async]~=4.3.2",
+]
 
 
 [dependency-groups]

python3_commons-0.18.0/src/python3_commons/audit.py

@@ -0,0 +1,22 @@
+import io
+import logging
+from typing import TYPE_CHECKING
+
+from python3_commons import object_storage
+
+if TYPE_CHECKING:
+    from python3_commons.conf import S3Settings
+
+logger = logging.getLogger(__name__)
+
+
+async def write_audit_data(settings: S3Settings, key: str, data: bytes) -> None:
+    if settings.aws_secret_access_key:
+        try:
+            await object_storage.put_object(settings.s3_bucket, f'audit/{key}', io.BytesIO(data), len(data))
+        except Exception:
+            logger.exception('Failed storing object in storage.')
+        else:
+            logger.debug('Stored object in storage: %s', key)
+    else:
+        logger.debug('S3 is not configured, not storing object in storage: %s', key)

{python3_commons-0.17.8 → python3_commons-0.18.0}/src/python3_commons/auth.py

@@ -101,13 +101,13 @@ class OIDCAuthError(OIDCError):
 # TODO: use api_client
 class OIDCClient:
     def __init__(
-            self,
-            authority_url: str,
-            client_id: str,
-            client_secret: str | None = None,
-            *,
-            timeout: float = 10.0,
-            session: aiohttp.ClientSession | None = None,
+        self,
+        authority_url: str,
+        client_id: str,
+        client_secret: str | None = None,
+        *,
+        timeout: float = 10.0,
+        session: aiohttp.ClientSession | None = None,
     ) -> None:
         self._token_url = f'{authority_url}/protocol/openid-connect/token'  # TODO: get it from openid-configuration
         self._client_id = client_id
@@ -126,11 +126,11 @@ class OIDCClient:
             await self._session.close()
 
     async def fetch_token(
-            self,
-            *,
-            username: str,
-            password: str,
-            scope: str = 'openid profile email',
+        self,
+        *,
+        username: str,
+        password: str,
+        scope: str = 'openid profile email',
     ) -> OIDCTokenResponse:
         if self._session is None:
             msg = 'ClientSession not initialized'
@@ -150,9 +150,9 @@ class OIDCClient:
 
         try:
             async with self._session.post(
-                    self._token_url,
-                    data=data,
-                    headers={'Content-Type': 'application/x-www-form-urlencoded'},
+                self._token_url,
+                data=data,
+                headers={'Content-Type': 'application/x-www-form-urlencoded'},
             ) as resp:
                 payload = await resp.read()
                 decoder = msgspec.json.Decoder(type=OIDCTokenResponse)

python3_commons-0.18.0/src/python3_commons/soap_client.py

@@ -0,0 +1,310 @@
+"""
+Async SOAP client built on aiohttp + zeep.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import logging
+from collections.abc import AsyncIterator, Sequence
+from contextlib import asynccontextmanager
+from dataclasses import dataclass
+from datetime import UTC, datetime
+from typing import TYPE_CHECKING, Any, Self
+from uuid import uuid4
+
+try:
+    import aiohttp
+    from aiohttp import ClientSession, ClientTimeout, TCPConnector
+    from lxml import etree
+    from requests import Response
+    from requests.cookies import RequestsCookieJar
+    from zeep import AsyncClient
+    from zeep.exceptions import TransportError
+    from zeep.plugins import HistoryPlugin, Plugin
+    from zeep.transports import Transport
+    from zeep.utils import get_version
+    from zeep.wsdl.utils import etree_to_string
+except ImportError as e:
+    msg = 'Install python3-commons[soap-client] to use this feature'
+
+    raise RuntimeError(msg) from e
+
+from python3_commons.audit import write_audit_data
+from python3_commons.conf import s3_settings
+
+if TYPE_CHECKING:
+    from zeep.wsdl.definitions import AbstractOperation
+
+logger = logging.getLogger(__name__)
+
+
+class ZeepAuditPlugin(Plugin):
+    def __init__(self, audit_name: str = 'zeep') -> None:
+        super().__init__()
+        self.audit_name = audit_name
+
+    def store_audit_in_s3(self, envelope, operation: AbstractOperation, direction: str) -> None:
+        xml = etree.tostring(envelope, encoding='UTF-8', pretty_print=True)
+        now = datetime.now(tz=UTC)
+        date_path = now.strftime('%Y/%m/%d')
+        timestamp = now.strftime('%H%M%S')
+        path = f'{date_path}/{self.audit_name}/{operation.name}/{timestamp}_{str(uuid4())[-12:]}_{direction}.xml'
+        coro = write_audit_data(s3_settings, path, xml)
+
+        try:
+            loop = asyncio.get_running_loop()
+        except RuntimeError:
+            loop = None
+
+        if loop and loop.is_running():
+            loop.create_task(coro)
+        else:
+            asyncio.run(coro)
+
+    def ingress(self, envelope, http_headers, operation: AbstractOperation):
+        self.store_audit_in_s3(envelope, operation, 'ingress')
+
+        return envelope, http_headers
+
+    def egress(self, envelope, http_headers, operation: AbstractOperation, binding_options):
+        self.store_audit_in_s3(envelope, operation, 'egress')
+
+        return envelope, http_headers
+
+
+@dataclass(frozen=True, slots=True)
+class TransportConfig:
+    """Immutable transport settings passed to AsyncTransport."""
+
+    timeout: int = 300
+    """Total timeout in seconds for WSDL fetches."""
+
+    operation_timeout: int = 60
+    """Total timeout in seconds for SOAP operation calls."""
+
+    verify_ssl: bool = True
+    proxy: str | None = None
+
+
+class AsyncTransport(Transport):
+    """
+    Async transport for zeep using aiohttp.
+
+    Usage::
+
+        async with AsyncTransport.from_config(config) as transport:
+            client = AsyncClient(wsdl_url, transport=transport)
+            result = await client.service.SomeOperation(...)
+    """
+
+    def __init__(
+        self,
+        *,
+        session: ClientSession,
+        wsdl_session: ClientSession,
+        config: TransportConfig,
+        _owns_session: bool = False,
+        _owns_wsdl_session: bool = False,
+    ) -> None:
+        super().__init__()
+        self._session = session
+        self._wsdl_session = wsdl_session
+        self._config = config
+        self._owns_session = _owns_session
+        self._owns_wsdl_session = _owns_wsdl_session
+
+    @classmethod
+    def from_config(
+        cls,
+        config: TransportConfig | None = None,
+        *,
+        session: ClientSession | None = None,
+        wsdl_session: ClientSession | None = None,
+    ) -> AsyncTransport:
+        """
+        Create a transport, optionally sharing an existing ClientSession.
+
+        If *session* / *wsdl_session* are omitted the transport owns (and
+        will close) the sessions it creates.
+        """
+        config = config or TransportConfig()
+        connector = TCPConnector(ssl=config.verify_ssl)
+        user_agent = f'Zeep/{get_version()} (www.python-zeep.org)'
+
+        owns_session = session is None
+        owns_wsdl_session = wsdl_session is None
+
+        if owns_session:
+            session = ClientSession(
+                connector=connector,
+                timeout=ClientTimeout(total=config.operation_timeout),
+                headers={'User-Agent': user_agent},
+            )
+
+        if owns_wsdl_session:
+            wsdl_session = ClientSession(
+                connector=connector,
+                timeout=ClientTimeout(total=config.timeout),
+                headers={'User-Agent': user_agent},
+            )
+
+        return cls(
+            session=session,
+            wsdl_session=wsdl_session,
+            config=config,
+            _owns_session=owns_session,
+            _owns_wsdl_session=owns_wsdl_session,
+        )
+
+    async def aclose(self) -> None:
+        if self._owns_session:
+            await self._session.close()
+        if self._owns_wsdl_session:
+            await self._wsdl_session.close()
+
+    async def __aenter__(self) -> Self:
+        return self
+
+    async def __aexit__(self, *_: object) -> None:
+        await self.aclose()
+
+    @staticmethod
+    def _build_response(response: aiohttp.ClientResponse, body: bytes) -> Response:
+        """Convert an aiohttp response into a requests.Response for zeep."""
+        r = Response()
+        r.status_code = response.status
+        r._content = body  # noqa: SLF001  (zeep reads this attribute directly)
+        r.headers = dict(response.headers)
+        r.encoding = response.charset
+        r.url = str(response.url)
+
+        # Bridge aiohttp SimpleCookie → RequestsCookieJar so zeep / requests
+        # cookie handling works correctly.
+        jar = RequestsCookieJar()
+
+        for name, morsel in response.cookies.items():
+            jar.set(name, morsel.value)
+
+        r.cookies = jar
+
+        return r
+
+    async def _load_remote_data(self, url: str) -> bytes:
+        """Fetch WSDL / XSD documents (called by zeep during init)."""
+
+        async def _fetch() -> bytes:
+            async with self._wsdl_session.get(url, proxy=self._config.proxy) as resp:
+                content = await resp.read()
+
+                if resp.status >= 400:
+                    raise TransportError(
+                        status_code=resp.status,
+                        message=content.decode(errors='ignore'),
+                    )
+
+                return content
+
+        return await _fetch()
+
+    async def post(
+        self,
+        address: str,
+        message: bytes,
+        headers: dict[str, str],
+        *,
+        timeout: int | None = None,
+    ) -> Response:
+        logger.debug('SOAP POST → %s\n%s', address, message)
+
+        request_timeout = ClientTimeout(total=timeout) if timeout is not None else None
+
+        async def _post() -> Response:
+            async with self._session.post(
+                address,
+                data=message,
+                headers=headers,
+                proxy=self._config.proxy,
+                timeout=request_timeout,
+            ) as resp:
+                body = await resp.read()
+                logger.debug('SOAP ← %s (HTTP %d)\n%s', address, resp.status, body)
+
+                return self._build_response(resp, body)
+
+        return await _post()
+
+    async def post_xml(
+        self,
+        address: str,
+        envelope: Any,
+        headers: dict[str, str],
+    ) -> Response:
+        message = etree_to_string(envelope)
+
+        return await self.post(address, message, headers)
+
+    async def get(
+        self,
+        address: str,
+        params: dict[str, str],
+        headers: dict[str, str],
+    ) -> Response:
+        async with self._session.get(
+            address,
+            params=params,
+            headers=headers,
+            proxy=self._config.proxy,
+        ) as resp:
+            body = await resp.read()
+
+            return self._build_response(resp, body)
+
+
+def build_soap_client(
+    wsdl_url: str,
+    transport: AsyncTransport,
+    plugins: Sequence[Plugin] | None = None,
+) -> AsyncClient:
+    """
+    Construct a zeep AsyncClient with the supplied transport and plugins.
+
+    Raises ValueError if *wsdl_url* is empty or None.
+    """
+    if not wsdl_url:
+        msg = 'wsdl_url must be a non-empty string.'
+
+        raise ValueError(msg)
+
+    return AsyncClient(wsdl_url, transport=transport, plugins=list(plugins or []))
+
+
+@asynccontextmanager
+async def soap_client(
+    wsdl_url: str,
+    *,
+    config: TransportConfig | None = None,
+    session: ClientSession | None = None,
+    plugins: Sequence[Plugin] | None = None,
+) -> AsyncIterator[AsyncClient]:
+    """
+    Async context manager that yields a ready-to-use zeep AsyncClient and
+    cleans up the transport on exit.
+
+    Example::
+
+        async with soap_client('https://example.com/service?wsdl') as client:
+            result = await client.service.GetData(id=42)
+    """
+    transport = AsyncTransport.from_config(config, session=session)
+
+    async with transport:
+        yield build_soap_client(wsdl_url, transport, plugins)
+
+
+def get_history_plugin(client: AsyncClient) -> HistoryPlugin | None:
+    """Return the first HistoryPlugin attached to *client*, or None."""
+    return next(
+        (p for p in client.plugins if isinstance(p, HistoryPlugin)),
+        None,
+    )

{python3_commons-0.17.8 → python3_commons-0.18.0/src/python3_commons.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-commons
-Version: 0.17.8
+Version: 0.18.0
 Summary: Re-usable Python3 code
 Author-email: Oleg Korsak <kamikaze.is.waiting.you@gmail.com>
 License-Expression: GPL-3.0
@@ -16,15 +16,14 @@ Requires-Dist: msgpack~=1.1.2
 Requires-Dist: msgspec==0.21.1
 Requires-Dist: pydantic-settings~=2.14.0
 Provides-Extra: all
-Requires-Dist: python3_commons[api-client,audit,authn,authz,cache,database,object-storage]; extra == "all"
+Requires-Dist: python3_commons[api-client,audit,authn,authz,cache,database,object-storage,soap-client]; extra == "all"
 Provides-Extra: api-client
 Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "api-client"
 Requires-Dist: lxml~=6.1.0; extra == "api-client"
-Requires-Dist: zeep~=4.3.2; extra == "api-client"
 Requires-Dist: python3_commons[object-storage]; extra == "api-client"
 Provides-Extra: audit
 Requires-Dist: lxml~=6.1.0; extra == "audit"
-Requires-Dist: zeep~=4.3.2; extra == "audit"
+Requires-Dist: zeep[async]~=4.3.2; extra == "audit"
 Requires-Dist: python3_commons[object-storage]; extra == "audit"
 Provides-Extra: authn
 Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "authn"
@@ -40,6 +39,11 @@ Requires-Dist: SQLAlchemy[asyncio]~=2.0.49; extra == "database"
 Provides-Extra: object-storage
 Requires-Dist: aiobotocore~=3.5.0; extra == "object-storage"
 Requires-Dist: object-storage-client==0.0.23; extra == "object-storage"
+Provides-Extra: soap-client
+Requires-Dist: aiohttp[speedups]<3.15.0,>=3.13.5; extra == "soap-client"
+Requires-Dist: lxml~=6.1.0; extra == "soap-client"
+Requires-Dist: requests~=2.33.1; extra == "soap-client"
+Requires-Dist: zeep[async]~=4.3.2; extra == "soap-client"
 Dynamic: license-file
 
 Re-usable Python3 code

{python3_commons-0.17.8 → python3_commons-0.18.0}/src/python3_commons.egg-info/SOURCES.txt

@@ -36,6 +36,7 @@ src/python3_commons/generators.py
 src/python3_commons/helpers.py
 src/python3_commons/object_storage.py
 src/python3_commons/permissions.py
+src/python3_commons/soap_client.py
 src/python3_commons.egg-info/PKG-INFO
 src/python3_commons.egg-info/SOURCES.txt
 src/python3_commons.egg-info/dependency_links.txt

{python3_commons-0.17.8 → python3_commons-0.18.0}/src/python3_commons.egg-info/requires.txt

@@ -3,17 +3,16 @@ msgspec==0.21.1
 pydantic-settings~=2.14.0
 
 [all]
-python3_commons[api-client,audit,authn,authz,cache,database,object-storage]
+python3_commons[api-client,audit,authn,authz,cache,database,object-storage,soap-client]
 
 [api-client]
 aiohttp[speedups]<3.15.0,>=3.13.5
 lxml~=6.1.0
-zeep~=4.3.2
 python3_commons[object-storage]
 
 [audit]
 lxml~=6.1.0
-zeep~=4.3.2
+zeep[async]~=4.3.2
 python3_commons[object-storage]
 
 [authn]
@@ -34,3 +33,9 @@ SQLAlchemy[asyncio]~=2.0.49
 [object-storage]
 aiobotocore~=3.5.0
 object-storage-client==0.0.23
+
+[soap-client]
+aiohttp[speedups]<3.15.0,>=3.13.5
+lxml~=6.1.0
+requests~=2.33.1
+zeep[async]~=4.3.2

{python3_commons-0.17.8 → python3_commons-0.18.0}/uv.lock

@@ -129,6 +129,18 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
 ]
 
+[[package]]
+name = "anyio"
+version = "4.13.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/19/14/2c5dd9f512b66549ae92767a9c7b330ae88e1932ca57876909410251fe13/anyio-4.13.0.tar.gz", hash = "sha256:334b70e641fd2221c1505b3890c69882fe4a2df910cba14d97019b90b24439dc", size = 231622, upload-time = "2026-03-24T12:59:09.671Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/da/42/e921fccf5015463e32a3cf6ee7f980a6ed0f395ceeaa45060b61d86486c2/anyio-4.13.0-py3-none-any.whl", hash = "sha256:08b310f9e24a9594186fd75b4f73f4a4152069e3853f1ed8bfbf58369f4ad708", size = 114353, upload-time = "2026-03-24T12:59:08.246Z" },
+]
+
 [[package]]
 name = "asyncpg"
 version = "0.31.0"
@@ -467,6 +479,43 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/15/32/77ee8a6c1564fc345a491a4e85b3bf360e4cf26eac98c4532d2fdb96e01f/greenlet-3.5.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d60097128cb0a1cab9ea541186ea13cd7b847b8449a7787c2e2350da0cb82d86", size = 245324, upload-time = "2026-04-27T12:24:40.295Z" },
 ]
 
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
 [[package]]
 name = "identify"
 version = "2.6.19"
@@ -1004,29 +1053,28 @@ all = [
     { name = "asyncpg" },
     { name = "lxml" },
     { name = "object-storage-client" },
+    { name = "requests" },
     { name = "sqlalchemy", extra = ["asyncio"] },
     { name = "valkey", extra = ["libvalkey"] },
-    { name = "zeep" },
+    { name = "zeep", extra = ["async"] },
 ]
 api-client = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
     { name = "lxml" },
     { name = "object-storage-client" },
-    { name = "zeep" },
 ]
 audit = [
     { name = "aiobotocore" },
     { name = "lxml" },
     { name = "object-storage-client" },
-    { name = "zeep" },
+    { name = "zeep", extra = ["async"] },
 ]
 authn = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
     { name = "lxml" },
     { name = "object-storage-client" },
-    { name = "zeep" },
 ]
 authz = [
     { name = "aiobotocore" },
@@ -1035,7 +1083,6 @@ authz = [
     { name = "lxml" },
     { name = "object-storage-client" },
     { name = "sqlalchemy", extra = ["asyncio"] },
-    { name = "zeep" },
 ]
 cache = [
     { name = "valkey", extra = ["libvalkey"] },
@@ -1048,6 +1095,12 @@ object-storage = [
     { name = "aiobotocore" },
     { name = "object-storage-client" },
 ]
+soap-client = [
+    { name = "aiohttp", extra = ["speedups"] },
+    { name = "lxml" },
+    { name = "requests" },
+    { name = "zeep", extra = ["async"] },
+]
 
 [package.dev-dependencies]
 dev = [
@@ -1071,25 +1124,28 @@ requires-dist = [
     { name = "aiobotocore", marker = "extra == 'object-storage'", specifier = "~=3.5.0" },
     { name = "aiohttp", extras = ["speedups"], marker = "extra == 'api-client'", specifier = ">=3.13.5,<3.15.0" },
     { name = "aiohttp", extras = ["speedups"], marker = "extra == 'authn'", specifier = ">=3.13.5,<3.15.0" },
+    { name = "aiohttp", extras = ["speedups"], marker = "extra == 'soap-client'", specifier = ">=3.13.5,<3.15.0" },
     { name = "asyncpg", marker = "extra == 'database'", specifier = "~=0.31.0" },
     { name = "lxml", marker = "extra == 'api-client'", specifier = "~=6.1.0" },
     { name = "lxml", marker = "extra == 'audit'", specifier = "~=6.1.0" },
+    { name = "lxml", marker = "extra == 'soap-client'", specifier = "~=6.1.0" },
     { name = "msgpack", specifier = "~=1.1.2" },
     { name = "msgspec", specifier = "==0.21.1" },
     { name = "object-storage-client", marker = "extra == 'object-storage'", specifier = "==0.0.23" },
     { name = "pydantic-settings", specifier = "~=2.14.0" },
     { name = "python3-commons", extras = ["api-client"], marker = "extra == 'authn'" },
     { name = "python3-commons", extras = ["api-client"], marker = "extra == 'authz'" },
-    { name = "python3-commons", extras = ["api-client", "audit", "authn", "authz", "cache", "database", "object-storage"], marker = "extra == 'all'" },
+    { name = "python3-commons", extras = ["api-client", "audit", "authn", "authz", "cache", "database", "object-storage", "soap-client"], marker = "extra == 'all'" },
     { name = "python3-commons", extras = ["database"], marker = "extra == 'authz'" },
     { name = "python3-commons", extras = ["object-storage"], marker = "extra == 'api-client'" },
     { name = "python3-commons", extras = ["object-storage"], marker = "extra == 'audit'" },
+    { name = "requests", marker = "extra == 'soap-client'", specifier = "~=2.33.1" },
     { name = "sqlalchemy", extras = ["asyncio"], marker = "extra == 'database'", specifier = "~=2.0.49" },
     { name = "valkey", extras = ["libvalkey"], marker = "extra == 'cache'", specifier = "~=6.1.1" },
-    { name = "zeep", marker = "extra == 'api-client'", specifier = "~=4.3.2" },
-    { name = "zeep", marker = "extra == 'audit'", specifier = "~=4.3.2" },
+    { name = "zeep", extras = ["async"], marker = "extra == 'audit'", specifier = "~=4.3.2" },
+    { name = "zeep", extras = ["async"], marker = "extra == 'soap-client'", specifier = "~=4.3.2" },
 ]
-provides-extras = ["all", "api-client", "audit", "authn", "authz", "cache", "database", "object-storage"]
+provides-extras = ["all", "api-client", "audit", "authn", "authz", "cache", "database", "object-storage", "soap-client"]
 
 [package.metadata.requires-dev]
 dev = [
@@ -1462,3 +1518,9 @@ sdist = { url = "https://files.pythonhosted.org/packages/e8/06/4f1d3ff61e9301635
 wheels = [
     { url = "https://files.pythonhosted.org/packages/cd/78/f43f3feb70d67cbe260ec5b682ecc3c1850c8f437f1df707495126e51817/zeep-4.3.2-py3-none-any.whl", hash = "sha256:ed08c3179709172bfaaa9b76a6a545f8a57043ec6218e64e9deb81ff1e0ff79b", size = 101853, upload-time = "2025-09-15T10:26:02.12Z" },
 ]
+
+[package.optional-dependencies]
+async = [
+    { name = "httpx" },
+    { name = "packaging" },
+]

python3_commons-0.17.8/src/python3_commons/audit.py

@@ -1,67 +0,0 @@
-import asyncio
-import io
-import logging
-from datetime import UTC, datetime
-from typing import TYPE_CHECKING
-from uuid import uuid4
-
-try:
-    from lxml import etree
-    from zeep.plugins import Plugin
-except ImportError as e:
-    msg = 'Install python3-commons[api-client] to use this feature'
-    raise RuntimeError(msg) from e
-
-from python3_commons import object_storage
-from python3_commons.conf import S3Settings, s3_settings
-
-if TYPE_CHECKING:
-    from zeep.wsdl.definitions import AbstractOperation
-
-logger = logging.getLogger(__name__)
-
-
-async def write_audit_data(settings: S3Settings, key: str, data: bytes) -> None:
-    if settings.aws_secret_access_key:
-        try:
-            await object_storage.put_object(settings.s3_bucket, f'audit/{key}', io.BytesIO(data), len(data))
-        except Exception:
-            logger.exception('Failed storing object in storage.')
-        else:
-            logger.debug('Stored object in storage: %s', key)
-    else:
-        logger.debug('S3 is not configured, not storing object in storage: %s', key)
-
-
-class ZeepAuditPlugin(Plugin):
-    def __init__(self, audit_name: str = 'zeep') -> None:
-        super().__init__()
-        self.audit_name = audit_name
-
-    def store_audit_in_s3(self, envelope, operation: AbstractOperation, direction: str) -> None:
-        xml = etree.tostring(envelope, encoding='UTF-8', pretty_print=True)
-        now = datetime.now(tz=UTC)
-        date_path = now.strftime('%Y/%m/%d')
-        timestamp = now.strftime('%H%M%S')
-        path = f'{date_path}/{self.audit_name}/{operation.name}/{timestamp}_{str(uuid4())[-12:]}_{direction}.xml'
-        coro = write_audit_data(s3_settings, path, xml)
-
-        try:
-            loop = asyncio.get_running_loop()
-        except RuntimeError:
-            loop = None
-
-        if loop and loop.is_running():
-            loop.create_task(coro)
-        else:
-            asyncio.run(coro)
-
-    def ingress(self, envelope, http_headers, operation: AbstractOperation):
-        self.store_audit_in_s3(envelope, operation, 'ingress')
-
-        return envelope, http_headers
-
-    def egress(self, envelope, http_headers, operation: AbstractOperation, binding_options):
-        self.store_audit_in_s3(envelope, operation, 'egress')
-
-        return envelope, http_headers