honua-admin 0.2.0__tar.gz → 0.2.2__tar.gz

{honua_admin-0.2.0 → honua_admin-0.2.2}/CHANGELOG.md

@@ -1,5 +1,25 @@
 # Changelog
 
+## [0.2.2](https://github.com/honua-io/honua-sdk-python/compare/python-admin-v0.2.1...python-admin-v0.2.2) (2026-11-07)
+
+
+### Features
+
+* page the admin service and layer lists ([#362](https://github.com/honua-io/honua-sdk-python/issues/362)) ([eee2d3e](https://github.com/honua-io/honua-sdk-python/commit/eee2d3e4a898bdb53753bdd6d45ef471193f46b2))
+
+
+### Documentation
+
+* neutral wording in honua-gp docstrings and docs ([#356](https://github.com/honua-io/honua-sdk-python/issues/356)) ([08d4113](https://github.com/honua-io/honua-sdk-python/commit/08d4113a801ce22b60463ae021dc843a4dc21caa))
+* neutralize Python client and geometry terminology ([#367](https://github.com/honua-io/honua-sdk-python/issues/367)) ([5f8b245](https://github.com/honua-io/honua-sdk-python/commit/5f8b245179550d1799a09a0efa1154604291e86a))
+
+## [0.2.1](https://github.com/honua-io/honua-sdk-python/compare/python-admin-v0.2.0...python-admin-v0.2.1) (2026-11-04)
+
+
+### Documentation
+
+* show how to verify a release's build provenance ([#354](https://github.com/honua-io/honua-sdk-python/issues/354)) ([712beb1](https://github.com/honua-io/honua-sdk-python/commit/712beb11be58d4f0378b424dff3903dab56b2eaf))
+
 ## [0.2.0](https://github.com/honua-io/honua-sdk-python/compare/python-admin-v0.1.13...python-admin-v0.2.0) (2026-11-04)
 
 

{honua_admin-0.2.0 → honua_admin-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: honua-admin
-Version: 0.2.0
+Version: 0.2.2
 Summary: Admin / control-plane client for Honua geospatial server
 Project-URL: Homepage, https://honua.io
 Project-URL: Documentation, https://honua-io.github.io/honua-sdk-python/latest/
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Scientific/Engineering :: GIS
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
-Requires-Dist: honua-sdk<0.3,>=0.2.0
+Requires-Dist: honua-sdk<0.3,>=0.2.2
 Description-Content-Type: text/markdown
 
 # honua-admin
@@ -46,9 +46,9 @@ and manage server state declaratively through manifests. Sync
   contract, so callers can gate control-plane calls on what the connected
   server actually supports (`manifest_apply`, `manifest_dry_run`,
   `metadata_resources`, ...).
-- **Services**: `list_services()`, `get_service_settings()`,
+- **Services**: `list_services()`, `list_services_page()`, `get_service_settings()`,
   `update_protocols()`, `update_mapserver_settings()`.
-- **Layers and data**: `list_layers()`, `publish_layer()`,
+- **Layers and data**: `list_layers()`, `list_layers_page()`, `publish_layer()`,
   `set_layer_enabled()` / `set_service_layers_enabled()`, and
   `discover_tables()` for source-database table discovery.
 - **Connections**: typed CRUD plus `test_connection()` /
@@ -136,6 +136,17 @@ Related: [honua-sdk](https://github.com/honua-io/honua-sdk-python/tree/trunk/pac
 [honua-sdk-js](https://github.com/honua-io/honua-sdk-js) (JS/TS SDKs + MCP server),
 [honua-sdk-dotnet](https://github.com/honua-io/honua-sdk-dotnet) (.NET SDKs).
 
+## Verify a release
+
+From 0.2.1, each PyPI release is built by this repository's publication workflow, which attaches
+the same wheel and sdist to the matching GitHub release and records a build-provenance attestation
+for them. 0.2.0 was published without an attestation; use 0.2.1 or later when you need to verify
+provenance. To check a downloaded file:
+
+```bash
+gh attestation verify honua_admin-<version>-py3-none-any.whl --repo honua-io/honua-sdk-python
+```
+
 ## License
 
 Apache-2.0

{honua_admin-0.2.0 → honua_admin-0.2.2}/README.md

@@ -20,9 +20,9 @@ and manage server state declaratively through manifests. Sync
   contract, so callers can gate control-plane calls on what the connected
   server actually supports (`manifest_apply`, `manifest_dry_run`,
   `metadata_resources`, ...).
-- **Services**: `list_services()`, `get_service_settings()`,
+- **Services**: `list_services()`, `list_services_page()`, `get_service_settings()`,
   `update_protocols()`, `update_mapserver_settings()`.
-- **Layers and data**: `list_layers()`, `publish_layer()`,
+- **Layers and data**: `list_layers()`, `list_layers_page()`, `publish_layer()`,
   `set_layer_enabled()` / `set_service_layers_enabled()`, and
   `discover_tables()` for source-database table discovery.
 - **Connections**: typed CRUD plus `test_connection()` /
@@ -110,6 +110,17 @@ Related: [honua-sdk](https://github.com/honua-io/honua-sdk-python/tree/trunk/pac
 [honua-sdk-js](https://github.com/honua-io/honua-sdk-js) (JS/TS SDKs + MCP server),
 [honua-sdk-dotnet](https://github.com/honua-io/honua-sdk-dotnet) (.NET SDKs).
 
+## Verify a release
+
+From 0.2.1, each PyPI release is built by this repository's publication workflow, which attaches
+the same wheel and sdist to the matching GitHub release and records a build-provenance attestation
+for them. 0.2.0 was published without an attestation; use 0.2.1 or later when you need to verify
+provenance. To check a downloaded file:
+
+```bash
+gh attestation verify honua_admin-<version>-py3-none-any.whl --repo honua-io/honua-sdk-python
+```
+
 ## License
 
 Apache-2.0

{honua_admin-0.2.0 → honua_admin-0.2.2}/honua_admin/__init__.py

@@ -13,6 +13,7 @@ except Exception:  # pragma: no cover -- editable / not-installed fallback
     __version__ = "0.0.0.dev0"
 
 from ._async_client import AsyncHonuaAdminClient
+from ._catalog import LayerListQuery, PublishedLayerPage, ServiceListPage, ServiceListQuery
 from ._client import HonuaAdminClient
 from ._models import (
     MINIMUM_SUPPORTED_CONTROL_PLANE_API_MAJOR,
@@ -132,6 +133,7 @@ __all__ = [
     "HonuaAdminClient",
     "ImportResult",
     "KeyRotationResult",
+    "LayerListQuery",
     "LayerStyleResponse",
     "LayerStyleUpdateRequest",
     "ManifestApplyEntry",
@@ -176,10 +178,13 @@ __all__ = [
     "OperationProposalDetail",
     "OperationProposalSummary",
     "PublishLayerRequest",
+    "PublishedLayerPage",
     "PublishedLayerSummary",
     "ResourceMetadata",
     "SecureConnectionDetail",
     "SecureConnectionSummary",
+    "ServiceListPage",
+    "ServiceListQuery",
     "ServiceSettingsResponse",
     "ServiceSummary",
     "StyleEncoding",

{honua_admin-0.2.0 → honua_admin-0.2.2}/honua_admin/_async_client.py

@@ -31,6 +31,7 @@ from honua_sdk.http import (
 )
 
 from . import _endpoints
+from ._catalog import LayerListQuery, PublishedLayerPage, ServiceListPage, ServiceListQuery
 from ._models import (
     DEFAULT_STYLE_ENCODING as _DEFAULT_STYLE_ENCODING,
 )
@@ -512,9 +513,7 @@ class AsyncHonuaAdminClient:
         )
         return _endpoints.unwrap_envelope(response)
 
-    # ======================================================================
     # File imports
-    # ======================================================================
 
     async def upload_file(
         self,
@@ -568,9 +567,7 @@ class AsyncHonuaAdminClient:
             return BackgroundImportResponse.from_dict(payload)
         return ImportResult.from_dict(payload)
 
-    # ======================================================================
     # Services
-    # ======================================================================
 
     async def list_services(
         self,
@@ -578,30 +575,41 @@ class AsyncHonuaAdminClient:
         timeout: float | httpx.Timeout | None = None,
         extra_headers: Mapping[str, str] | None = None,
     ) -> list[ServiceSummary]:
-        """List every service registered on the admin catalog.
-
-        Returns:
-            Typed :class:`ServiceSummary` objects for each service the
-            server reports. Empty when the server returns a non-list
-            payload (e.g. an empty envelope).
-
-        Per-request options (``timeout`` / ``extra_headers``) are forwarded
-        to :meth:`_request`.
+        """Read every page of the admin service list."""
+        collected: list[ServiceSummary] = []
+        page_number = _endpoints.DEFAULT_CATALOG_PAGE
+        while True:
+            page = await self.list_services_page(
+                ServiceListQuery(page=page_number), timeout=timeout, extra_headers=extra_headers
+            )
+            advanced = _endpoints._advance_catalog_page(collected, page)
+            if advanced is None:
+                return collected
+            page_number = advanced
 
-        Raises:
-            HonuaHttpError: The server responded with a non-success status.
-            HonuaTransportError: The request failed before any HTTP
-                response was received.
-        """
-        data = await self._request_json(
-            "GET",
-            "/api/v1/admin/services/",
-            timeout=timeout,
-            extra_headers=extra_headers,
+    async def list_services_page(
+        self,
+        query: ServiceListQuery | None = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+        extra_headers: Mapping[str, str] | None = None,
+    ) -> ServiceListPage:
+        """Return one page of admin services and the count of every match."""
+        selected = query or ServiceListQuery()
+        return ServiceListPage.from_dict(
+            await self._request_json(
+                "GET",
+                "/api/v1/admin/services/",
+                params=_endpoints.admin_catalog_params(
+                    page=selected.page,
+                    page_size=selected.page_size,
+                    name_query=selected.name_query,
+                    extra=(("folderId", selected.folder_id),),
+                ),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
         )
-        if not isinstance(data, list):
-            return []
-        return [ServiceSummary.from_dict(s) for s in data]
 
     async def get_service_settings(
         self,
@@ -786,9 +794,7 @@ class AsyncHonuaAdminClient:
         )
         return ServiceSettingsResponse.from_dict(data)
 
-    # ======================================================================
     # Metadata Resources
-    # ======================================================================
 
     async def list_metadata_resources(
         self,
@@ -1004,9 +1010,7 @@ class AsyncHonuaAdminClient:
             idempotency_key=idempotency_key,
         )
 
-    # ======================================================================
     # Manifests
-    # ======================================================================
 
     async def get_version(
         self,
@@ -1198,9 +1202,7 @@ class AsyncHonuaAdminClient:
         )
         return ManifestApplyResult.from_dict(data)
 
-    # ======================================================================
     # Migration Toolkit
-    # ======================================================================
 
     async def scan_migration_source(
         self,
@@ -1234,12 +1236,12 @@ class AsyncHonuaAdminClient:
     ) -> ToolboxTranslationReport:
         """POST /api/v1/admin/import/toolbox/translation/validate
 
-        Validate an SDK-translated ArcGIS toolbox manifest against the server's
+        Validate an SDK-translated source toolbox manifest against the server's
         canonical geoprocessing process catalog, and return the
         server-authoritative per-tool classification.
 
         The server owns the round-trip proof: it never parses toolbox sources
-        and never emulates ``arcpy``. The SDK proposes a mapping; the catalog
+        and never emulates the scripting API. The SDK proposes a mapping; the catalog
         decides whether that mapping is ``translated``,
         ``partially-translated``, or ``unsupported``, and returns the specific
         reasons a tool cannot be fully translated.
@@ -1270,9 +1272,7 @@ class AsyncHonuaAdminClient:
         )
         return ToolboxTranslationReport.from_dict(data)
 
-    # ======================================================================
     # Connections
-    # ======================================================================
 
     async def list_connections(
         self,
@@ -1561,9 +1561,7 @@ class AsyncHonuaAdminClient:
         )
         return KeyRotationResult.from_dict(data)
 
-    # ======================================================================
     # Layers
-    # ======================================================================
 
     async def list_layers(
         self,
@@ -1573,37 +1571,45 @@ class AsyncHonuaAdminClient:
         timeout: float | httpx.Timeout | None = None,
         extra_headers: Mapping[str, str] | None = None,
     ) -> list[PublishedLayerSummary]:
-        """List published layers belonging to a connection.
-
-        Args:
-            conn_id: Connection identifier; URL-encoded.
-            service_name: When provided, restrict to one service's layers.
-
-        Returns:
-            Matching :class:`PublishedLayerSummary` objects; empty when
-            the server returns a non-list payload.
-
-        Per-request options (``timeout`` / ``extra_headers``) are forwarded
-        to :meth:`_request`.
+        """Read every page of layers published on a connection."""
+        collected: list[PublishedLayerSummary] = []
+        page_number = _endpoints.DEFAULT_CATALOG_PAGE
+        while True:
+            page = await self.list_layers_page(
+                conn_id,
+                LayerListQuery(page=page_number, service_name=service_name),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
+            advanced = _endpoints._advance_catalog_page(collected, page)
+            if advanced is None:
+                return collected
+            page_number = advanced
 
-        Raises:
-            HonuaHttpError: The server responded with a non-success status.
-            HonuaTransportError: The request failed at the transport layer.
-        """
-        connection_id = encode_path_segment(conn_id)
-        params: dict[str, str] | None = None
-        if service_name is not None:
-            params = {"serviceName": service_name}
-        data = await self._request_json(
-            "GET",
-            f"/api/v1/admin/connections/{connection_id}/layers",
-            params=params,
-            timeout=timeout,
-            extra_headers=extra_headers,
+    async def list_layers_page(
+        self,
+        conn_id: str,
+        query: LayerListQuery | None = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+        extra_headers: Mapping[str, str] | None = None,
+    ) -> PublishedLayerPage:
+        """Return one page of layers published on a connection."""
+        selected = query or LayerListQuery()
+        return PublishedLayerPage.from_dict(
+            await self._request_json(
+                "GET",
+                f"/api/v1/admin/connections/{encode_path_segment(conn_id)}/layers",
+                params=_endpoints.admin_catalog_params(
+                    page=selected.page,
+                    page_size=selected.page_size,
+                    name_query=selected.name_query,
+                    extra=(("serviceName", selected.service_name),),
+                ),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
         )
-        if not isinstance(data, list):
-            return []
-        return [PublishedLayerSummary.from_dict(item) for item in data]
 
     async def publish_layer(
         self,
@@ -1736,9 +1742,7 @@ class AsyncHonuaAdminClient:
             return []
         return [PublishedLayerSummary.from_dict(item) for item in data]
 
-    # ======================================================================
     # Discovery
-    # ======================================================================
 
     async def discover_tables(
         self,
@@ -1771,9 +1775,7 @@ class AsyncHonuaAdminClient:
         )
         return TableDiscoveryResponse.from_dict(data)
 
-    # ======================================================================
     # Styles
-    # ======================================================================
 
     async def list_styles(
         self,
@@ -1997,9 +1999,7 @@ class AsyncHonuaAdminClient:
         )
         return LayerStyleResponse.from_dict(data)
 
-    # ======================================================================
     # Operation proposals
-    # ======================================================================
 
     async def list_proposals(
         self,
@@ -2155,9 +2155,7 @@ class AsyncHonuaAdminClient:
         )
         return OperationProposalDetail.from_dict(data)
 
-    # ======================================================================
     # Config
-    # ======================================================================
 
     async def get_config(
         self,

honua_admin-0.2.2/honua_admin/_catalog.py

@@ -0,0 +1,102 @@
+"""One page of the admin service list or the published-layer list."""
+
+from __future__ import annotations
+
+from dataclasses import dataclass
+from typing import Any
+
+from ._models import AdminServiceSummary, PublishedLayerSummary, _snake_keys
+
+
+def _page_int(value: Any, default: int) -> int:
+    if value is None:
+        return default
+    return int(value)
+
+
+def _require_page(data: Any, kind: str) -> dict[str, Any]:
+    if data is None:
+        return {}
+    if not isinstance(data, dict):
+        raise ValueError(f"{kind} data must be a page object.")
+    return _snake_keys(data)
+
+
+def _page_items(raw: Any, parse: Any, kind: str) -> list[Any]:
+    if raw is None:
+        return []
+    if not isinstance(raw, list) or any(not isinstance(item, dict) for item in raw):
+        raise ValueError(f"{kind} items must be a list of objects.")
+    return [parse(item) for item in raw]
+
+
+def _page_counts(parsed: dict[str, Any]) -> tuple[int, int, int]:
+    return (
+        _page_int(parsed.get("page"), 1),
+        _page_int(parsed.get("page_size"), 100),
+        _page_int(parsed.get("total"), 0),
+    )
+
+
+@dataclass(frozen=True, slots=True)
+class ServiceListQuery:
+    """Selects one page of the admin service list."""
+
+    page: int = 1
+    page_size: int = 100
+    name_query: str | None = None
+    folder_id: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class ServiceListPage:
+    """One page of admin services and the count of every match."""
+
+    items: list[AdminServiceSummary]
+    page: int
+    page_size: int
+    total: int
+    layer_total: int
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any] | None) -> ServiceListPage:
+        parsed = _require_page(data, "Service list")
+        page, page_size, total = _page_counts(parsed)
+        return cls(
+            items=_page_items(parsed.get("items"), AdminServiceSummary.from_dict, "Service list"),
+            page=page,
+            page_size=page_size,
+            total=total,
+            layer_total=_page_int(parsed.get("layer_total"), 0),
+        )
+
+
+@dataclass(frozen=True, slots=True)
+class LayerListQuery:
+    """Selects one page of layers published on a connection."""
+
+    page: int = 1
+    page_size: int = 100
+    name_query: str | None = None
+    service_name: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class PublishedLayerPage:
+    """One page of published layers and the count of every match."""
+
+    items: list[PublishedLayerSummary]
+    page: int
+    page_size: int
+    total: int
+
+    @classmethod
+    def from_dict(cls, data: dict[str, Any] | None) -> PublishedLayerPage:
+        parsed = _require_page(data, "Layer list")
+        page, page_size, total = _page_counts(parsed)
+        return cls(
+            items=_page_items(parsed.get("items"), PublishedLayerSummary.from_dict, "Layer list"),
+            page=page,
+            page_size=page_size,
+            total=total,
+        )

{honua_admin-0.2.0 → honua_admin-0.2.2}/honua_admin/_client.py

@@ -33,6 +33,7 @@ from honua_sdk.http import (
 )
 
 from . import _endpoints
+from ._catalog import LayerListQuery, PublishedLayerPage, ServiceListPage, ServiceListQuery
 from ._models import (
     DEFAULT_STYLE_ENCODING as _DEFAULT_STYLE_ENCODING,
 )
@@ -513,9 +514,7 @@ class HonuaAdminClient:
         )
         return _endpoints.unwrap_envelope(response)
 
-    # ======================================================================
     # File imports
-    # ======================================================================
 
     def upload_file(
         self,
@@ -569,9 +568,7 @@ class HonuaAdminClient:
             return BackgroundImportResponse.from_dict(payload)
         return ImportResult.from_dict(payload)
 
-    # ======================================================================
     # Services
-    # ======================================================================
 
     def list_services(
         self,
@@ -579,30 +576,41 @@ class HonuaAdminClient:
         timeout: float | httpx.Timeout | None = None,
         extra_headers: Mapping[str, str] | None = None,
     ) -> list[ServiceSummary]:
-        """List every service registered on the admin catalog.
-
-        Returns:
-            Typed :class:`ServiceSummary` objects for each service the
-            server reports. Empty when the server returns a non-list
-            payload (e.g. an empty envelope).
-
-        Per-request options (``timeout`` / ``extra_headers``) are forwarded
-        to :meth:`_request`.
+        """Read every page of the admin service list."""
+        collected: list[ServiceSummary] = []
+        page_number = _endpoints.DEFAULT_CATALOG_PAGE
+        while True:
+            page = self.list_services_page(
+                ServiceListQuery(page=page_number), timeout=timeout, extra_headers=extra_headers
+            )
+            advanced = _endpoints._advance_catalog_page(collected, page)
+            if advanced is None:
+                return collected
+            page_number = advanced
 
-        Raises:
-            HonuaHttpError: The server responded with a non-success status.
-            HonuaTransportError: The request failed before any HTTP
-                response was received.
-        """
-        data = self._request_json(
-            "GET",
-            "/api/v1/admin/services/",
-            timeout=timeout,
-            extra_headers=extra_headers,
+    def list_services_page(
+        self,
+        query: ServiceListQuery | None = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+        extra_headers: Mapping[str, str] | None = None,
+    ) -> ServiceListPage:
+        """Return one page of admin services and the count of every match."""
+        selected = query or ServiceListQuery()
+        return ServiceListPage.from_dict(
+            self._request_json(
+                "GET",
+                "/api/v1/admin/services/",
+                params=_endpoints.admin_catalog_params(
+                    page=selected.page,
+                    page_size=selected.page_size,
+                    name_query=selected.name_query,
+                    extra=(("folderId", selected.folder_id),),
+                ),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
         )
-        if not isinstance(data, list):
-            return []
-        return [ServiceSummary.from_dict(s) for s in data]
 
     def get_service_settings(
         self,
@@ -787,9 +795,7 @@ class HonuaAdminClient:
         )
         return ServiceSettingsResponse.from_dict(data)
 
-    # ======================================================================
     # Metadata Resources
-    # ======================================================================
 
     def list_metadata_resources(
         self,
@@ -1005,9 +1011,7 @@ class HonuaAdminClient:
             idempotency_key=idempotency_key,
         )
 
-    # ======================================================================
     # Manifests
-    # ======================================================================
 
     def get_version(
         self,
@@ -1199,9 +1203,7 @@ class HonuaAdminClient:
         )
         return ManifestApplyResult.from_dict(data)
 
-    # ======================================================================
     # Migration Toolkit
-    # ======================================================================
 
     def scan_migration_source(
         self,
@@ -1235,12 +1237,12 @@ class HonuaAdminClient:
     ) -> ToolboxTranslationReport:
         """POST /api/v1/admin/import/toolbox/translation/validate
 
-        Validate an SDK-translated ArcGIS toolbox manifest against the server's
+        Validate an SDK-translated source toolbox manifest against the server's
         canonical geoprocessing process catalog, and return the
         server-authoritative per-tool classification.
 
         The server owns the round-trip proof: it never parses toolbox sources
-        and never emulates ``arcpy``. The SDK proposes a mapping; the catalog
+        and never emulates the scripting API. The SDK proposes a mapping; the catalog
         decides whether that mapping is ``translated``,
         ``partially-translated``, or ``unsupported``, and returns the specific
         reasons a tool cannot be fully translated.
@@ -1271,9 +1273,7 @@ class HonuaAdminClient:
         )
         return ToolboxTranslationReport.from_dict(data)
 
-    # ======================================================================
     # Connections
-    # ======================================================================
 
     def list_connections(
         self,
@@ -1562,9 +1562,7 @@ class HonuaAdminClient:
         )
         return KeyRotationResult.from_dict(data)
 
-    # ======================================================================
     # Layers
-    # ======================================================================
 
     def list_layers(
         self,
@@ -1574,37 +1572,45 @@ class HonuaAdminClient:
         timeout: float | httpx.Timeout | None = None,
         extra_headers: Mapping[str, str] | None = None,
     ) -> list[PublishedLayerSummary]:
-        """List published layers belonging to a connection.
-
-        Args:
-            conn_id: Connection identifier; URL-encoded.
-            service_name: When provided, restrict to one service's layers.
-
-        Returns:
-            Matching :class:`PublishedLayerSummary` objects; empty when
-            the server returns a non-list payload.
-
-        Per-request options (``timeout`` / ``extra_headers``) are forwarded
-        to :meth:`_request`.
+        """Read every page of layers published on a connection."""
+        collected: list[PublishedLayerSummary] = []
+        page_number = _endpoints.DEFAULT_CATALOG_PAGE
+        while True:
+            page = self.list_layers_page(
+                conn_id,
+                LayerListQuery(page=page_number, service_name=service_name),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
+            advanced = _endpoints._advance_catalog_page(collected, page)
+            if advanced is None:
+                return collected
+            page_number = advanced
 
-        Raises:
-            HonuaHttpError: The server responded with a non-success status.
-            HonuaTransportError: The request failed at the transport layer.
-        """
-        connection_id = encode_path_segment(conn_id)
-        params: dict[str, str] | None = None
-        if service_name is not None:
-            params = {"serviceName": service_name}
-        data = self._request_json(
-            "GET",
-            f"/api/v1/admin/connections/{connection_id}/layers",
-            params=params,
-            timeout=timeout,
-            extra_headers=extra_headers,
+    def list_layers_page(
+        self,
+        conn_id: str,
+        query: LayerListQuery | None = None,
+        *,
+        timeout: float | httpx.Timeout | None = None,
+        extra_headers: Mapping[str, str] | None = None,
+    ) -> PublishedLayerPage:
+        """Return one page of layers published on a connection."""
+        selected = query or LayerListQuery()
+        return PublishedLayerPage.from_dict(
+            self._request_json(
+                "GET",
+                f"/api/v1/admin/connections/{encode_path_segment(conn_id)}/layers",
+                params=_endpoints.admin_catalog_params(
+                    page=selected.page,
+                    page_size=selected.page_size,
+                    name_query=selected.name_query,
+                    extra=(("serviceName", selected.service_name),),
+                ),
+                timeout=timeout,
+                extra_headers=extra_headers,
+            )
         )
-        if not isinstance(data, list):
-            return []
-        return [PublishedLayerSummary.from_dict(item) for item in data]
 
     def publish_layer(
         self,
@@ -1737,9 +1743,7 @@ class HonuaAdminClient:
             return []
         return [PublishedLayerSummary.from_dict(item) for item in data]
 
-    # ======================================================================
     # Discovery
-    # ======================================================================
 
     def discover_tables(
         self,
@@ -1772,9 +1776,7 @@ class HonuaAdminClient:
         )
         return TableDiscoveryResponse.from_dict(data)
 
-    # ======================================================================
     # Styles
-    # ======================================================================
 
     def list_styles(
         self,
@@ -1998,9 +2000,7 @@ class HonuaAdminClient:
         )
         return LayerStyleResponse.from_dict(data)
 
-    # ======================================================================
     # Operation proposals
-    # ======================================================================
 
     def list_proposals(
         self,
@@ -2156,9 +2156,7 @@ class HonuaAdminClient:
         )
         return OperationProposalDetail.from_dict(data)
 
-    # ======================================================================
     # Config
-    # ======================================================================
 
     def get_config(
         self,

honua_admin-0.2.2/honua_admin/_endpoints.py

@@ -0,0 +1,119 @@
+"""Pure response-parse and header helpers shared by the admin clients.
+
+The admin sync (:class:`HonuaAdminClient`) and async
+(:class:`AsyncHonuaAdminClient`) clients duplicate the
+``ApiResponse``-unwrap logic and the ``Idempotency-Key`` header policy
+character-for-character. Both modules pull those pieces from this
+module so the only differences left are the unavoidable ``await``
+keywords and the sync/async ``def`` declarations.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Mapping, Sequence
+from typing import Any, Protocol, TypeVar
+
+import httpx
+from honua_sdk.http import build_idempotency_headers
+
+IMPORT_UPLOAD_PATH = "/api/v1/admin/import/upload"
+SERVICE_ACCESS_POLICY_PATH = "/api/v1/admin/services/{name}/access-policy"
+
+
+DEFAULT_CATALOG_PAGE = 1
+DEFAULT_CATALOG_PAGE_SIZE = 100
+MAX_CATALOG_PAGE_SIZE = 100
+MAX_CATALOG_NAME_QUERY_LENGTH = 200
+
+
+def admin_catalog_params(
+    *,
+    page: int = DEFAULT_CATALOG_PAGE,
+    page_size: int = DEFAULT_CATALOG_PAGE_SIZE,
+    name_query: str | None = None,
+    extra: tuple[tuple[str, str | None], ...] = (),
+) -> dict[str, str]:
+    """Query string for one page of an admin catalog list."""
+    if page < 1:
+        raise ValueError("page must be at least 1.")
+    if page_size < 1 or page_size > MAX_CATALOG_PAGE_SIZE:
+        raise ValueError("page_size must be from 1 to 100.")
+    name = _blank_to_none(name_query)
+    if name is not None and len(name) > MAX_CATALOG_NAME_QUERY_LENGTH:
+        raise ValueError("name query is longer than 200 characters.")
+    params = {"page": str(page), "pageSize": str(page_size)}
+    if name is not None:
+        params["q"] = name
+    for key, value in extra:
+        trimmed = _blank_to_none(value)
+        if trimmed is not None:
+            params[key] = trimmed
+    return params
+
+
+def is_last_catalog_page(item_count: int, page_size: int, total: int, collected: int) -> bool:
+    """A short page, an empty page, or a full total ends the walk."""
+    return item_count == 0 or collected >= total or item_count < page_size
+
+
+_ItemT_co = TypeVar("_ItemT_co", covariant=True)
+
+
+class _CatalogPage(Protocol[_ItemT_co]):
+    @property
+    def items(self) -> Sequence[_ItemT_co]: ...
+
+    @property
+    def page(self) -> int: ...
+
+    @property
+    def page_size(self) -> int: ...
+
+    @property
+    def total(self) -> int: ...
+
+
+def _advance_catalog_page(collected: list[_ItemT_co], page: _CatalogPage[_ItemT_co]) -> int | None:
+    """Append this page and return the next page number, or None when the walk is done."""
+    collected.extend(page.items)
+    if is_last_catalog_page(len(page.items), page.page_size, page.total, len(collected)):
+        return None
+    return page.page + 1
+
+
+def _blank_to_none(value: str | None) -> str | None:
+    if value is None:
+        return None
+    trimmed = value.strip()
+    return trimmed or None
+
+
+def unwrap_envelope(response: httpx.Response) -> Any:
+    """Strip the ``{"success": true, "data": ...}`` envelope, if present.
+
+    * Empty bodies return ``None``.
+    * Bodies that are not JSON return ``response.text`` as a fallback.
+    * JSON objects with a ``data`` key return the inner value.
+    * Anything else returns the parsed payload verbatim.
+    """
+    if not response.content:
+        return None
+    try:
+        payload = response.json()
+    except ValueError:
+        return response.text
+    if isinstance(payload, Mapping) and "data" in payload:
+        return payload["data"]
+    return payload
+
+
+__all__ = [
+    "DEFAULT_CATALOG_PAGE",
+    "DEFAULT_CATALOG_PAGE_SIZE",
+    "MAX_CATALOG_NAME_QUERY_LENGTH",
+    "MAX_CATALOG_PAGE_SIZE",
+    "admin_catalog_params",
+    "build_idempotency_headers",
+    "is_last_catalog_page",
+    "unwrap_envelope",
+]

{honua_admin-0.2.0 → honua_admin-0.2.2}/honua_admin/_models.py

@@ -14,7 +14,7 @@ from typing import Any, Literal, TypeAlias
 # release line. Honua Server versions are ``<year>.<release>.<patch>`` SemVer triples
 # (2026.1.1); the major tracks the year, not compatibility, so the control-plane API
 # major carries the breaking-change signal. Builds that predate the server's version
-# identity (honua-server#4693) report ``1.0.0+<sha>`` and fall below the floor.
+# identity report ``1.0.0+<sha>`` and fall below the floor.
 # tests/admin/test_server_floor_baseline.py fails when this and the baseline disagree;
 # the JS and .NET SDKs carry the same value.
 MINIMUM_SUPPORTED_SERVER_VERSION = "2026.1.0-0"
@@ -102,9 +102,7 @@ def _parse_version_components(version: str | None) -> tuple[int, int, int] | Non
     return (parts[0], parts[1], parts[2])
 
 
-# ---------------------------------------------------------------------------
 # Response models (frozen)
-# ---------------------------------------------------------------------------
 
 
 @dataclass(frozen=True, slots=True)
@@ -845,9 +843,7 @@ class LayerStyleResponse:
         return cls(**_extract_fields(cls, d))
 
 
-# ---------------------------------------------------------------------------
 # OGC API - Styles (styleId-keyed; ADR-0048)
-# ---------------------------------------------------------------------------
 
 # Stylesheet encoding identifiers accepted by the styleId-keyed client. These
 # map to the ``Accept`` media types the OGC API - Styles surface negotiates on
@@ -977,9 +973,7 @@ class OgcStylesheet:
         return parsed
 
 
-# ---------------------------------------------------------------------------
 # Request models (mutable)
-# ---------------------------------------------------------------------------
 
 
 @dataclass
@@ -1081,9 +1075,7 @@ class LayerStyleUpdateRequest:
         return d
 
 
-# ---------------------------------------------------------------------------
 # Migration toolkit artifact models
-# ---------------------------------------------------------------------------
 
 
 @dataclass(frozen=True, slots=True)
@@ -1881,9 +1873,7 @@ class ToolboxTranslationReport:
         return {**identity, **d}
 
 
-# ---------------------------------------------------------------------------
 # Request models (mutable)
-# ---------------------------------------------------------------------------
 
 
 @dataclass
@@ -1920,7 +1910,7 @@ class ToolboxToolDescriptor:
 
 @dataclass
 class ToolboxTranslationManifest:
-    """Client-proposed translation manifest for one ArcGIS toolbox.
+    """Client-proposed translation manifest for one source toolbox.
 
     ``source_format`` is the source toolbox format: ``pyt``, ``atbx``, or
     ``tbx``. Redact local paths and credentials out of ``source_label`` before

{honua_admin-0.2.0 → honua_admin-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "honua-admin"
-version = "0.2.0"
+version = "0.2.2"
 description = "Admin / control-plane client for Honua geospatial server"
 readme = "README.md"
 license = "Apache-2.0"
@@ -27,7 +27,7 @@ classifiers = [
 dependencies = [
   # The floor tracks the honua-sdk release (release-please generic updater on the line
   # below) so honua-admin always requires the SDK it was released with.
-  "honua-sdk>=0.2.0,<0.3",  # x-release-please-version
+  "honua-sdk>=0.2.2,<0.3",  # x-release-please-version
 ]
 
 [project.scripts]

honua_admin-0.2.0/honua_admin/_endpoints.py

@@ -1,45 +0,0 @@
-"""Pure response-parse and header helpers shared by the admin clients.
-
-The admin sync (:class:`HonuaAdminClient`) and async
-(:class:`AsyncHonuaAdminClient`) clients duplicate the
-``ApiResponse``-unwrap logic and the ``Idempotency-Key`` header policy
-character-for-character. Both modules pull those pieces from this
-module so the only differences left are the unavoidable ``await``
-keywords and the sync/async ``def`` declarations.
-"""
-
-from __future__ import annotations
-
-from collections.abc import Mapping
-from typing import Any
-
-import httpx
-from honua_sdk.http import build_idempotency_headers
-
-IMPORT_UPLOAD_PATH = "/api/v1/admin/import/upload"
-SERVICE_ACCESS_POLICY_PATH = "/api/v1/admin/services/{name}/access-policy"
-
-
-def unwrap_envelope(response: httpx.Response) -> Any:
-    """Strip the ``{"success": true, "data": ...}`` envelope, if present.
-
-    * Empty bodies return ``None``.
-    * Bodies that are not JSON return ``response.text`` as a fallback.
-    * JSON objects with a ``data`` key return the inner value.
-    * Anything else returns the parsed payload verbatim.
-    """
-    if not response.content:
-        return None
-    try:
-        payload = response.json()
-    except ValueError:
-        return response.text
-    if isinstance(payload, Mapping) and "data" in payload:
-        return payload["data"]
-    return payload
-
-
-__all__ = [
-    "build_idempotency_headers",
-    "unwrap_envelope",
-]