python3-commons 0.18.4__tar.gz → 0.18.6__tar.gz

{python3_commons-0.18.4/src/python3_commons.egg-info → python3_commons-0.18.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-commons
-Version: 0.18.4
+Version: 0.18.6
 Summary: Re-usable Python3 code
 Author-email: Oleg Korsak <kamikaze.is.waiting.you@gmail.com>
 License-Expression: GPL-3.0
@@ -19,6 +19,7 @@ Provides-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: certifi==2026.4.22; extra == "api-client"
 Requires-Dist: python3_commons[object-storage]; extra == "api-client"
 Provides-Extra: audit
 Requires-Dist: lxml~=6.1.0; extra == "audit"
@@ -26,6 +27,7 @@ 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"
+Requires-Dist: certifi==2026.4.22; extra == "authn"
 Requires-Dist: python3_commons[api-client]; extra == "authn"
 Provides-Extra: authz
 Requires-Dist: python3_commons[database]; extra == "authz"
@@ -40,6 +42,7 @@ 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: certifi==2026.4.22; 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"

{python3_commons-0.18.4 → python3_commons-0.18.6}/pyproject.toml

@@ -29,6 +29,7 @@ all = [
 ]
 api-client = [
     "aiohttp[speedups]>=3.13.5,<3.15.0",
+    "certifi==2026.4.22",
     "python3_commons[object-storage]"
 ]
 audit = [
@@ -38,6 +39,7 @@ audit = [
 ]
 authn = [
     "aiohttp[speedups]>=3.13.5,<3.15.0",
+    "certifi==2026.4.22",
     "python3_commons[api-client]"
 ]
 authz = [
@@ -57,6 +59,7 @@ object-storage = [
 ]
 soap-client = [
     "aiohttp[speedups]>=3.13.5,<3.15.0",
+    "certifi==2026.4.22",
     "lxml~=6.1.0",
     "requests~=2.33.1",
     "zeep[async]~=4.3.2",

python3_commons-0.18.6/src/python3_commons/soap_client.py

@@ -0,0 +1,250 @@
+"""
+Async SOAP client built on aiohttp + zeep.
+"""
+
+from __future__ import annotations
+
+import asyncio
+import concurrent.futures
+import logging
+import ssl
+from collections.abc import AsyncIterator, Sequence
+from contextlib import asynccontextmanager
+from dataclasses import dataclass
+from typing import TYPE_CHECKING, Any, Self
+
+import certifi
+
+try:
+    import aiohttp
+    from aiohttp import ClientSession, ClientTimeout, TCPConnector
+    from requests import Response
+    from requests.cookies import RequestsCookieJar
+    from zeep import AsyncClient
+    from zeep.exceptions import TransportError
+    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
+
+if TYPE_CHECKING:
+    from zeep.plugins import Plugin
+
+logger = logging.getLogger(__name__)
+
+
+def _make_ssl_context(*, verify: bool) -> ssl.SSLContext | bool:
+    if not verify:
+        return False  # aiohttp accepts False to disable verification
+
+    return ssl.create_default_context(cafile=certifi.where())
+
+
+@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 soap_client("https://example.com/service?wsdl") as client:
+            result = await client.service.SomeOperation(...)
+    """
+
+    def __init__(
+        self,
+        *,
+        session: ClientSession,
+        config: TransportConfig,
+        _owns_session: bool = False,
+    ) -> None:
+        super().__init__()
+        self._session = session
+        self._config = config
+        self._owns_session = _owns_session
+
+    @classmethod
+    def from_config(
+        cls,
+        config: TransportConfig | None = None,
+        *,
+        session: ClientSession | None = None,
+    ) -> Self:
+        config = config or TransportConfig()
+        owns_session = session is None
+
+        if owns_session:
+            session = ClientSession(
+                connector=TCPConnector(ssl=_make_ssl_context(verify=config.verify_ssl)),
+                timeout=ClientTimeout(total=config.operation_timeout),
+                headers={'User-Agent': f'Zeep/{get_version()} (www.python-zeep.org)'},
+            )
+
+        return cls(session=session, config=config, _owns_session=owns_session)
+
+    async def aclose(self) -> None:
+        if self._owns_session:
+            await self._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
+        r.headers = dict(response.headers)
+        r.encoding = response.charset
+        r.url = str(response.url)
+
+        jar = RequestsCookieJar()
+
+        for name, morsel in response.cookies.items():
+            jar.set(name, morsel.value)
+
+        r.cookies = jar
+
+        return r
+
+    def load(self, url: str) -> bytes:
+        """
+        Sync entry-point zeep calls during WSDL document init.
+
+        Creates a short-lived session confined to its own event loop so there
+        is no cross-loop session sharing with the operational session.
+        """
+        if not url:
+            return b''
+
+        async def _fetch() -> bytes:
+            async with (
+                ClientSession(
+                    connector=TCPConnector(ssl=_make_ssl_context(verify=self._config.verify_ssl)),
+                    timeout=ClientTimeout(total=self._config.timeout),
+                    headers={'User-Agent': f'Zeep/{get_version()} (www.python-zeep.org)'},
+                ) as session,
+                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
+
+        # load() is always called from within a running event loop (during
+        # AsyncClient.__init__ inside the soap_client context manager), so
+        # run_until_complete on the running loop would raise. Always delegate
+        # to a thread with its own fresh event loop.
+        with concurrent.futures.ThreadPoolExecutor(max_workers=1) as pool:
+            return pool.submit(asyncio.run, _fetch()).result()
+
+
+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)
+
+    async with self._session.post(
+        address,
+        data=message,
+        headers=headers,
+        proxy=self._config.proxy,
+        timeout=ClientTimeout(total=timeout) if timeout is not None else None,
+    ) as resp:
+        body = await resp.read()
+        logger.debug('SOAP ← %s (HTTP %d)\n%s', address, resp.status, body)
+
+        return self._build_response(resp, body)
+
+
+async def post_xml(
+    self,
+    address: str,
+    envelope: Any,
+    headers: dict[str, str],
+) -> Response:
+    return await self.post(address, etree_to_string(envelope), 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:
+    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 yielding a ready-to-use zeep AsyncClient.
+
+    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)
+
+    try:
+        yield build_soap_client(wsdl_url, transport, plugins)
+    finally:
+        await transport.aclose()

{python3_commons-0.18.4 → python3_commons-0.18.6/src/python3_commons.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python3-commons
-Version: 0.18.4
+Version: 0.18.6
 Summary: Re-usable Python3 code
 Author-email: Oleg Korsak <kamikaze.is.waiting.you@gmail.com>
 License-Expression: GPL-3.0
@@ -19,6 +19,7 @@ Provides-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: certifi==2026.4.22; extra == "api-client"
 Requires-Dist: python3_commons[object-storage]; extra == "api-client"
 Provides-Extra: audit
 Requires-Dist: lxml~=6.1.0; extra == "audit"
@@ -26,6 +27,7 @@ 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"
+Requires-Dist: certifi==2026.4.22; extra == "authn"
 Requires-Dist: python3_commons[api-client]; extra == "authn"
 Provides-Extra: authz
 Requires-Dist: python3_commons[database]; extra == "authz"
@@ -40,6 +42,7 @@ 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: certifi==2026.4.22; 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"

{python3_commons-0.18.4 → python3_commons-0.18.6}/src/python3_commons.egg-info/requires.txt

@@ -7,6 +7,7 @@ python3_commons[api-client,audit,authn,authz,cache,database,object-storage,soap-
 
 [api-client]
 aiohttp[speedups]<3.15.0,>=3.13.5
+certifi==2026.4.22
 python3_commons[object-storage]
 
 [audit]
@@ -16,6 +17,7 @@ python3_commons[object-storage]
 
 [authn]
 aiohttp[speedups]<3.15.0,>=3.13.5
+certifi==2026.4.22
 python3_commons[api-client]
 
 [authz]
@@ -35,6 +37,7 @@ object-storage-client==0.0.23
 
 [soap-client]
 aiohttp[speedups]<3.15.0,>=3.13.5
+certifi==2026.4.22
 lxml~=6.1.0
 requests~=2.33.1
 zeep[async]~=4.3.2

{python3_commons-0.18.4 → python3_commons-0.18.6}/uv.lock

@@ -1051,6 +1051,7 @@ all = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
     { name = "asyncpg" },
+    { name = "certifi" },
     { name = "lxml" },
     { name = "object-storage-client" },
     { name = "requests" },
@@ -1061,7 +1062,7 @@ all = [
 api-client = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
-    { name = "lxml" },
+    { name = "certifi" },
     { name = "object-storage-client" },
 ]
 audit = [
@@ -1073,14 +1074,14 @@ audit = [
 authn = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
-    { name = "lxml" },
+    { name = "certifi" },
     { name = "object-storage-client" },
 ]
 authz = [
     { name = "aiobotocore" },
     { name = "aiohttp", extra = ["speedups"] },
     { name = "asyncpg" },
-    { name = "lxml" },
+    { name = "certifi" },
     { name = "object-storage-client" },
     { name = "sqlalchemy", extra = ["asyncio"] },
 ]
@@ -1097,6 +1098,7 @@ object-storage = [
 ]
 soap-client = [
     { name = "aiohttp", extra = ["speedups"] },
+    { name = "certifi" },
     { name = "lxml" },
     { name = "requests" },
     { name = "zeep", extra = ["async"] },
@@ -1126,7 +1128,9 @@ requires-dist = [
     { 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 = "certifi", marker = "extra == 'api-client'", specifier = "==2026.4.22" },
+    { name = "certifi", marker = "extra == 'authn'", specifier = "==2026.4.22" },
+    { name = "certifi", marker = "extra == 'soap-client'", specifier = "==2026.4.22" },
     { 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" },

python3_commons-0.18.4/src/python3_commons/soap_client.py

@@ -1,299 +0,0 @@
-"""
-Async SOAP client built on aiohttp + zeep.
-"""
-
-from __future__ import annotations
-
-import asyncio
-import concurrent.futures
-import logging
-from collections.abc import AsyncIterator, Sequence
-from contextlib import asynccontextmanager
-from dataclasses import dataclass
-from typing import TYPE_CHECKING, Any, Self
-
-try:
-    import aiohttp
-    from aiohttp import ClientSession, ClientTimeout, TCPConnector
-    from requests import Response
-    from requests.cookies import RequestsCookieJar
-    from zeep import AsyncClient
-    from zeep.exceptions import TransportError
-    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
-
-if TYPE_CHECKING:
-    from zeep.plugins import Plugin
-
-logger = logging.getLogger(__name__)
-
-
-@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()
-
-    def load(self, url: str) -> bytes:
-        """Sync entry-point zeep calls during WSDL document init."""
-        if not url:
-            return b''
-
-        async def _fetch() -> bytes:
-            connector = TCPConnector(ssl=self._config.verify_ssl)
-
-            async with ClientSession(
-                connector=connector,
-                timeout=ClientTimeout(total=self._config.timeout),
-                headers={'User-Agent': f'Zeep/{get_version()} (www.python-zeep.org)'},
-            ) as session, 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
-
-        try:
-            loop = asyncio.get_event_loop()
-
-            return loop.run_until_complete(_fetch())
-        except RuntimeError:
-            with concurrent.futures.ThreadPoolExecutor(max_workers=1) as pool:
-                future = pool.submit(asyncio.run, _fetch())
-
-                return future.result()
-
-    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)
-
-    try:
-        client = build_soap_client(wsdl_url, transport, plugins)  # WSDL loaded here (sync via load())
-
-        yield client
-    finally:
-        await transport.aclose()