pyplaykit 1.30.2__tar.gz → 1.30.4__tar.gz

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/CHANGELOG.md

@@ -11,6 +11,35 @@ Versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [1.30.4] — 2026-08-20
+
+### Fixed
+
+- **API reference docs (GAP-23) are now actually generated and complete.** The CI "Generate API reference docs" step previously produced an empty or near-empty reference and was masked by `continue-on-error`. Root cause: pdoc's submodule discovery **respects a package's `__all__`**, and several PyPlayKit packages (`utils`, `utils.secrets`, `utils.contract`, `components`, `pyplaykit`) define `__all__` to list their public *symbols* — not their submodules — so pdoc silently excluded ~65 submodules (`utils.api_client`, `utils.tdm`, `core.quality_gate`, …), documenting only the top-level package pages. A secondary hazard: pdoc aborts the *entire* build on the first submodule it cannot import.
+  - New resilient driver **`scripts/generate_api_docs.py`** discovers every submodule via `pkgutil` (ignoring `__all__`), test-imports each, and hands pdoc an explicit spec list of the modules that import cleanly — excluding (with a logged, non-silent warning) any module whose optional dependency is genuinely absent, instead of aborting. The reference now covers **69 modules** (was 4 top-level pages) and is always produced. `scripts/generate_api_docs.sh` is now a thin wrapper around it.
+
+### Added
+
+- **`docs` optional-dependency extra** — `pip install '.[docs]'` installs the full optional set (mirrors `all` plus the pure-Python extras: mcp, contracts, pact, accessibility, mongodb, telemetry, prometheus, dashboard, vault, aws, azure) so the generated API reference is complete with no modules skipped. The publish workflow now installs `.[docs]` before generating docs.
+
+---
+
+## [1.30.3] — 2026-08-20
+
+### Added
+
+- **`ApiClient.options()` and `ApiClient.head()` shortcuts** — the client had GET/POST/PUT/PATCH/DELETE convenience methods but no `OPTIONS` (needed for CORS-preflight and capability probes) or `HEAD` shortcut, so `api_client.options(endpoint)` raised `AttributeError`. Both now delegate to the existing `request()` verb dispatcher, exactly like the other shortcuts, and accept `params`/`headers`.
+- **`BasePage.has_any_visible(selector)`** — returns `True` when *at least one* element matches, via `page.locator(selector).count() > 0`. `is_visible()` wraps Playwright's strict-mode `expect(...).to_be_visible()`, which raises when a selector resolves to multiple elements (rows, cards, list items); `has_any_visible()` is the correct check for repeated elements. `is_visible()`'s docstring now points to it.
+
+### Fixed
+
+- **`SoapClient` now accepts `verify_ssl` (default `True`)** — the constructor built its zeep `Transport` with default settings and offered no way to disable TLS verification, so on a corporate network behind a TLS-inspection proxy (whose internal CA is not in Python's trust store) every call raised `SSLCertVerificationError`, with the only escape being the internal `_zeep_client` injection hook. Passing `verify_ssl=False` now configures the underlying `requests` session with `verify=False` for both the WSDL fetch and operation calls.
+- **`GraphQLClient` now accepts `verify_ssl` (default `True`)** — for parity with `ApiClient` (which already supported it). Previously callers had to hand-build an `httpx.HTTPTransport(verify=False)` and pass it via `transport=`; `verify_ssl=False` is now a direct passthrough to the underlying `ApiClient`.
+
+_(Note: `BasePage.wait_for_url_contains()` — which previously passed a Python predicate to Playwright's `to_have_url()` and raised "value must be a string or regular expression" — was already fixed to use `page.wait_for_url("**{url_part}**")` and shipped in 1.30.2.)_
+
+---
+
 ## [1.30.2] — 2026-08-20
 
 ### Changed

{pyplaykit-1.30.2/pyplaykit.egg-info → pyplaykit-1.30.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyplaykit
-Version: 1.30.2
+Version: 1.30.4
 Summary: Enterprise Python + Playwright automation framework
 Author-email: Shan Konduru <shankonduru@gmail.com>
 License: MIT
@@ -121,6 +121,42 @@ Requires-Dist: mysql-connector-python>=8.0.0; extra == "all"
 Requires-Dist: snowflake-connector-python>=3.0.0; extra == "all"
 Requires-Dist: allure-pytest==2.16.0; extra == "all"
 Requires-Dist: pytest-html==4.2.0; extra == "all"
+Provides-Extra: docs
+Requires-Dist: httpx>=0.27.0; extra == "docs"
+Requires-Dist: jmespath>=1.0.0; extra == "docs"
+Requires-Dist: gql[httpx]>=3.5.0; extra == "docs"
+Requires-Dist: zeep>=4.2.1; extra == "docs"
+Requires-Dist: pandas>=2.0.0; extra == "docs"
+Requires-Dist: openpyxl>=3.1.0; extra == "docs"
+Requires-Dist: xlrd>=2.0.1; extra == "docs"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "docs"
+Requires-Dist: pyodbc>=4.0.0; extra == "docs"
+Requires-Dist: oracledb>=1.0.0; extra == "docs"
+Requires-Dist: ibm_db>=3.0.0; extra == "docs"
+Requires-Dist: ibm_db_dbi>=3.0.0; extra == "docs"
+Requires-Dist: IfxPy>=3.0.0; extra == "docs"
+Requires-Dist: IfxPyDbi>=3.0.0; extra == "docs"
+Requires-Dist: mysql-connector-python>=8.0.0; extra == "docs"
+Requires-Dist: snowflake-connector-python>=3.0.0; extra == "docs"
+Requires-Dist: allure-pytest==2.16.0; extra == "docs"
+Requires-Dist: pytest-html==4.2.0; extra == "docs"
+Requires-Dist: fastmcp>=2.0.0; extra == "docs"
+Requires-Dist: jsonschema>=4.0; extra == "docs"
+Requires-Dist: openapi-spec-validator>=0.5; extra == "docs"
+Requires-Dist: schemathesis>=3.0; extra == "docs"
+Requires-Dist: pact-python>=2.0; extra == "docs"
+Requires-Dist: axe-playwright-python>=0.1.3; extra == "docs"
+Requires-Dist: pymongo>=4.0.0; extra == "docs"
+Requires-Dist: opentelemetry-api>=1.0; extra == "docs"
+Requires-Dist: opentelemetry-sdk>=1.0; extra == "docs"
+Requires-Dist: opentelemetry-exporter-otlp>=1.0; extra == "docs"
+Requires-Dist: prometheus-client>=0.17; extra == "docs"
+Requires-Dist: fastapi>=0.100; extra == "docs"
+Requires-Dist: uvicorn>=0.20; extra == "docs"
+Requires-Dist: hvac>=1.0; extra == "docs"
+Requires-Dist: boto3>=1.26; extra == "docs"
+Requires-Dist: azure-keyvault-secrets>=4.0; extra == "docs"
+Requires-Dist: azure-identity>=1.0; extra == "docs"
 
 # PyPlayKit - Enterprise Test Automation Framework
 

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/core/base_page.py

@@ -129,7 +129,13 @@ class BasePage:
         return self.wait_for_visible(selector).inner_text().strip()
 
     def is_visible(self, selector: str, timeout: float = 5000) -> bool:
-        """Return visibility state for selector, auto-waiting for it to be visible."""
+        """Return visibility state for a selector, auto-waiting for it to be visible.
+
+        Use this only when ``selector`` resolves to **exactly one** element. For a
+        selector that may match repeated elements (rows, cards, list items), use
+        :meth:`has_any_visible` instead — ``expect(...).to_be_visible()`` is
+        strict-mode and raises when the locator resolves to multiple elements.
+        """
         locator = self.page.locator(selector)
         try:
             expect(locator).to_be_visible(timeout=timeout)
@@ -137,6 +143,15 @@ class BasePage:
         except AssertionError:
             return False
 
+    def has_any_visible(self, selector: str) -> bool:
+        """Return True if **at least one** element matches ``selector``.
+
+        Use for repeated elements (table rows, cards, list items) where you only
+        need to confirm presence, not uniqueness. Unlike :meth:`is_visible`, this
+        never raises on a multi-element match — it counts matches instead.
+        """
+        return self.page.locator(selector).count() > 0
+
     def get_title(self) -> str:
         """Return current page title."""
         return self.page.title()

{pyplaykit-1.30.2 → pyplaykit-1.30.4/pyplaykit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyplaykit
-Version: 1.30.2
+Version: 1.30.4
 Summary: Enterprise Python + Playwright automation framework
 Author-email: Shan Konduru <shankonduru@gmail.com>
 License: MIT
@@ -121,6 +121,42 @@ Requires-Dist: mysql-connector-python>=8.0.0; extra == "all"
 Requires-Dist: snowflake-connector-python>=3.0.0; extra == "all"
 Requires-Dist: allure-pytest==2.16.0; extra == "all"
 Requires-Dist: pytest-html==4.2.0; extra == "all"
+Provides-Extra: docs
+Requires-Dist: httpx>=0.27.0; extra == "docs"
+Requires-Dist: jmespath>=1.0.0; extra == "docs"
+Requires-Dist: gql[httpx]>=3.5.0; extra == "docs"
+Requires-Dist: zeep>=4.2.1; extra == "docs"
+Requires-Dist: pandas>=2.0.0; extra == "docs"
+Requires-Dist: openpyxl>=3.1.0; extra == "docs"
+Requires-Dist: xlrd>=2.0.1; extra == "docs"
+Requires-Dist: psycopg2-binary>=2.9.0; extra == "docs"
+Requires-Dist: pyodbc>=4.0.0; extra == "docs"
+Requires-Dist: oracledb>=1.0.0; extra == "docs"
+Requires-Dist: ibm_db>=3.0.0; extra == "docs"
+Requires-Dist: ibm_db_dbi>=3.0.0; extra == "docs"
+Requires-Dist: IfxPy>=3.0.0; extra == "docs"
+Requires-Dist: IfxPyDbi>=3.0.0; extra == "docs"
+Requires-Dist: mysql-connector-python>=8.0.0; extra == "docs"
+Requires-Dist: snowflake-connector-python>=3.0.0; extra == "docs"
+Requires-Dist: allure-pytest==2.16.0; extra == "docs"
+Requires-Dist: pytest-html==4.2.0; extra == "docs"
+Requires-Dist: fastmcp>=2.0.0; extra == "docs"
+Requires-Dist: jsonschema>=4.0; extra == "docs"
+Requires-Dist: openapi-spec-validator>=0.5; extra == "docs"
+Requires-Dist: schemathesis>=3.0; extra == "docs"
+Requires-Dist: pact-python>=2.0; extra == "docs"
+Requires-Dist: axe-playwright-python>=0.1.3; extra == "docs"
+Requires-Dist: pymongo>=4.0.0; extra == "docs"
+Requires-Dist: opentelemetry-api>=1.0; extra == "docs"
+Requires-Dist: opentelemetry-sdk>=1.0; extra == "docs"
+Requires-Dist: opentelemetry-exporter-otlp>=1.0; extra == "docs"
+Requires-Dist: prometheus-client>=0.17; extra == "docs"
+Requires-Dist: fastapi>=0.100; extra == "docs"
+Requires-Dist: uvicorn>=0.20; extra == "docs"
+Requires-Dist: hvac>=1.0; extra == "docs"
+Requires-Dist: boto3>=1.26; extra == "docs"
+Requires-Dist: azure-keyvault-secrets>=4.0; extra == "docs"
+Requires-Dist: azure-identity>=1.0; extra == "docs"
 
 # PyPlayKit - Enterprise Test Automation Framework
 

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/pyplaykit.egg-info/requires.txt

@@ -79,6 +79,43 @@ xlrd>=2.0.1
 ibm_db>=3.0.0
 ibm_db_dbi>=3.0.0
 
+[docs]
+httpx>=0.27.0
+jmespath>=1.0.0
+gql[httpx]>=3.5.0
+zeep>=4.2.1
+pandas>=2.0.0
+openpyxl>=3.1.0
+xlrd>=2.0.1
+psycopg2-binary>=2.9.0
+pyodbc>=4.0.0
+oracledb>=1.0.0
+ibm_db>=3.0.0
+ibm_db_dbi>=3.0.0
+IfxPy>=3.0.0
+IfxPyDbi>=3.0.0
+mysql-connector-python>=8.0.0
+snowflake-connector-python>=3.0.0
+allure-pytest==2.16.0
+pytest-html==4.2.0
+fastmcp>=2.0.0
+jsonschema>=4.0
+openapi-spec-validator>=0.5
+schemathesis>=3.0
+pact-python>=2.0
+axe-playwright-python>=0.1.3
+pymongo>=4.0.0
+opentelemetry-api>=1.0
+opentelemetry-sdk>=1.0
+opentelemetry-exporter-otlp>=1.0
+prometheus-client>=0.17
+fastapi>=0.100
+uvicorn>=0.20
+hvac>=1.0
+boto3>=1.26
+azure-keyvault-secrets>=4.0
+azure-identity>=1.0
+
 [graphql-client]
 gql[httpx]>=3.5.0
 httpx>=0.27.0

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "pyplaykit"
-version = "1.30.2"
+version = "1.30.4"
 description = "Enterprise Python + Playwright automation framework"
 readme = "README.md"
 license = { text = "MIT" }
@@ -172,6 +172,47 @@ all = [
   "allure-pytest==2.16.0",
   "pytest-html==4.2.0",
 ]
+# Full optional-dependency set — used to generate a COMPLETE API reference
+# (pip install '.[docs]') so no module is skipped during the pdoc walk. Mirrors
+# 'all' plus every pure-Python optional extra whose module imports its dependency
+# at load time (secrets, telemetry, contracts, dashboard, mongodb, mcp, ...).
+docs = [
+  "httpx>=0.27.0",
+  "jmespath>=1.0.0",
+  "gql[httpx]>=3.5.0",
+  "zeep>=4.2.1",
+  "pandas>=2.0.0",
+  "openpyxl>=3.1.0",
+  "xlrd>=2.0.1",
+  "psycopg2-binary>=2.9.0",
+  "pyodbc>=4.0.0",
+  "oracledb>=1.0.0",
+  "ibm_db>=3.0.0",
+  "ibm_db_dbi>=3.0.0",
+  "IfxPy>=3.0.0",
+  "IfxPyDbi>=3.0.0",
+  "mysql-connector-python>=8.0.0",
+  "snowflake-connector-python>=3.0.0",
+  "allure-pytest==2.16.0",
+  "pytest-html==4.2.0",
+  "fastmcp>=2.0.0",
+  "jsonschema>=4.0",
+  "openapi-spec-validator>=0.5",
+  "schemathesis>=3.0",
+  "pact-python>=2.0",
+  "axe-playwright-python>=0.1.3",
+  "pymongo>=4.0.0",
+  "opentelemetry-api>=1.0",
+  "opentelemetry-sdk>=1.0",
+  "opentelemetry-exporter-otlp>=1.0",
+  "prometheus-client>=0.17",
+  "fastapi>=0.100",
+  "uvicorn>=0.20",
+  "hvac>=1.0",
+  "boto3>=1.26",
+  "azure-keyvault-secrets>=4.0",
+  "azure-identity>=1.0",
+]
 
 [project.scripts]
 pyplaykit = "pyplaykit.cli:main"

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/utils/api_client.py

@@ -356,6 +356,24 @@ class ApiClient:
         """Shortcut for DELETE requests."""
         return self.request("DELETE", endpoint, headers=headers)
 
+    def options(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        headers: dict[str, str] | None = None,
+    ) -> ApiResponse:
+        """Shortcut for OPTIONS requests (e.g. CORS preflight / capability probes)."""
+        return self.request("OPTIONS", endpoint, params=params, headers=headers)
+
+    def head(
+        self,
+        endpoint: str,
+        params: dict[str, Any] | None = None,
+        headers: dict[str, str] | None = None,
+    ) -> ApiResponse:
+        """Shortcut for HEAD requests (headers/status only, no body)."""
+        return self.request("HEAD", endpoint, params=params, headers=headers)
+
     # ── Internal helpers ───────────────────────────────────────────────────────
 
     def _build_url(self, endpoint: str, params: dict[str, Any] | None = None) -> str:

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/utils/graphql_client.py

@@ -92,6 +92,7 @@ class GraphQLClient:
         retries: int = 1,
         logger=None,
         transport=None,
+        verify_ssl: bool = True,
     ) -> None:
         self._endpoint = endpoint
         self._http = ApiClient(
@@ -100,6 +101,7 @@ class GraphQLClient:
             retries=retries,
             logger=logger,
             transport=transport,
+            verify_ssl=verify_ssl,
         )
         self._logger = logger
 

{pyplaykit-1.30.2 → pyplaykit-1.30.4}/utils/soap_client.py

@@ -79,6 +79,7 @@ class SoapClient:
         password: str | None = None,
         timeout_seconds: int = 30,
         logger=None,
+        verify_ssl: bool = True,
         _zeep_client=None,
     ) -> None:
         """Create a SoapClient.
@@ -89,6 +90,11 @@ class SoapClient:
             password:        Optional WS-Security UsernameToken password.
             timeout_seconds: HTTP request timeout.
             logger:          Optional logger for request/response logging.
+            verify_ssl:      Verify TLS certificates (default True). Set False on
+                             corporate networks behind a TLS-inspection proxy whose
+                             internal CA is not in Python's trust store — this
+                             configures the underlying ``requests`` session with
+                             ``verify=False`` for both the WSDL fetch and calls.
             _zeep_client:    Inject a pre-built zeep Client for testing.
         """
         self._wsdl = wsdl
@@ -101,7 +107,14 @@ class SoapClient:
             import zeep
             import zeep.transports
 
-            transport = zeep.transports.Transport(timeout=timeout_seconds)
+            session = None
+            if not verify_ssl:
+                import requests
+                session = requests.Session()
+                session.verify = False
+            transport = zeep.transports.Transport(
+                timeout=timeout_seconds, session=session
+            )
             self._client = zeep.Client(wsdl=wsdl, transport=transport)
 
             if username and password: