Merge pull request #205 from stac-utils/feature/update-for-titiler-0.19

update for titiler 0.19

.github/workflows/tests/benchmarks.py

@@ -26,7 +26,7 @@ def test_benchmark_tile(benchmark, tile, search_id):
 
     def f(input_tile):
         response = httpx.get(
-            f"http://{host}:{port}/searches/{search_id}/tiles/{input_tile}?assets=asset"
+            f"http://{host}:{port}/searches/{search_id}/tiles/WebMercatorQuad/{input_tile}?assets=asset"
         )
         assert response.status_code == 200
         return response

.gitignore

@@ -103,3 +103,5 @@ ENV/
 log-config.yml
 
 .pgdata/
+
+dev_notebooks/

CHANGES.md

@@ -1,5 +1,43 @@
 # Release Notes
 
+## 1.5.0 (2024-11-28)
+
+* update titiler requirement to `>=0.19.0,<0.20`
+
+* Use `@attrs.define` instead of dataclass for factories **breaking change**
+
+* Remove default `WebMercatorQuad` tile matrix set in `/tiles`, `/tilesjson.json`, `/map` and `/WMTSCapabilities.xml` endpoints **breaking change**
+
+    ```
+    # Before
+    /tiles/{z}/{x}/{y}
+    /tilejson.json
+    /map
+    /WMTSCapabilities.xml
+
+    # Now
+    /tiles/WebMercatorQuad/{z}/{x}/{y}
+    /WebMercatorQuad/tilejson.json
+    /WebMercatorQuad/map
+    /WebMercatorQuad/WMTSCapabilities.xml
+    ```
+
+* Use `.as_dict()` method when passing option to rio-tiler Reader's methods to avoid parameter conflicts when using custom Readers.
+
+* add OGC Tiles `/tiles` and `/tiles/{tileMatrixSet}` endpoints
+
+* add `/point` prefix to `/{lon},{lat}/assets` endpoint **breaking change**
+
+* rename `reader` attribute to `backend` in `MosaicTilerFactory` **breaking change**
+
+* rename `titiler/pgstac/mosaic.py → titiler/pgstac/backend.py` **breaking change**
+
+* rename `titiler.pgstac.mosaic.CustomSTACReader → titiler.pgstac.reader.SimpleSTACReader` **breaking change**
+
+* rename factory's method to match the one from `titiler.core/titiler.mosaic` **breaking change**
+
+* split `_assets_routes` into `assets_tile` and `assets_point` **breaking change**
+
 ## 1.4.0 (2024-09-06)
 
 * add `/collections/{collection_id}/items/{item_id}/assets/{asset_id}` optional endpoints (`TITILER_PGSTAC_API_ENABLE_ASSETS_ENDPOINTS=TRUE|FALSE`)

Dockerfile.uvicorn

@@ -2,14 +2,17 @@ ARG PYTHON_VERSION=3.11
 
 FROM python:${PYTHON_VERSION}-slim
 
+# ref: https://github.com/rasterio/rasterio-wheels/issues/136, https://github.com/docker-library/python/issues/989
+RUN apt update && apt install -y libexpat1
+
 WORKDIR /tmp
 
 COPY titiler/ titiler/
 COPY pyproject.toml pyproject.toml
 COPY README.md README.md
 COPY LICENSE LICENSE
 
-RUN pip install --no-cache-dir --upgrade .["psycopg-binary"] uvicorn
+RUN python -m pip install --no-cache-dir --upgrade .["psycopg-binary"] uvicorn
 RUN rm -rf titiler/ pyproject.toml README.md LICENSE
 
 # http://www.uvicorn.org/settings/

docs/mkdocs.yml

@@ -31,7 +31,8 @@ nav:
     - Mosaic metadata specification: advanced/metadata.md
     - Mosaic list: advanced/searches_list.md
     - Custom search model: advanced/custom_search.md
-    - Custom TileJSON endpoint : advanced/custom_tilejson.md
+    - Custom TileJSON endpoint: advanced/custom_tilejson.md
+    - Zarr/NetCDF support: advanced/support_multidim_dataset.md
   - Examples:
     - demo: notebooks/demo.ipynb
   - API:
@@ -41,7 +42,7 @@ nav:
       - extensions: api/titiler/pgstac/extensions.md
       - factory: api/titiler/pgstac/factory.md
       - model: api/titiler/pgstac/model.md
-      - mosaic: api/titiler/pgstac/mosaic.md
+      - backend: api/titiler/pgstac/backend.md
       - reader: api/titiler/pgstac/reader.md
       - settings: api/titiler/pgstac/settings.md
       - utils: api/titiler/pgstac/utils.md

docs/src/advanced/custom_tilejson.md

@@ -23,15 +23,9 @@ from starlette.requests import Request
 class MosaicTilerFactory(TitilerPgSTACFactory.MosaicTilerFactory):
     """Custom factory."""
 
-    def _tilejson_routes(self) -> None:
+    def tilejson(self) -> None:
         """Custom TileJSON endpoint."""
 
-        @self.router.get(
-            "/tilejson.json",
-            response_model=TileJSON,
-            responses={200: {"description": "Return a tilejson"}},
-            response_model_exclude_none=True,
-        )
         @self.router.get(
             "/{tileMatrixSetId}/tilejson.json",
             response_model=TileJSON,
@@ -40,15 +34,19 @@ class MosaicTilerFactory(TitilerPgSTACFactory.MosaicTilerFactory):
         )
         def tilejson(
             request: Request,
-            search_id=Depends(self.path_dependency),
-            tileMatrixSetId: Annotated[  # type: ignore
+            tileMatrixSetId: Annotated[
                 Literal[tuple(self.supported_tms.list())],
-                f"Identifier selecting one of the TileMatrixSetId supported (default: '{self.default_tms}')",
-            ] = self.default_tms,
+                Path(
+                    description="Identifier selecting one of the TileMatrixSetId supported."
+                ),
+            ],
+            ########################################################
+            # CUSTOM: add `layer=` query-parameter
             layer: Annotated[
                 str,
                 Query(description="Name of default configuration"),
             ] = None,
+            ########################################################
             tile_format: Annotated[
                 Optional[ImageType],
                 Query(
@@ -69,6 +67,7 @@ class MosaicTilerFactory(TitilerPgSTACFactory.MosaicTilerFactory):
                 Optional[int],
                 Query(description="Overwrite default maxzoom."),
             ] = None,
+            search_id=Depends(self.path_dependency),
             layer_params=Depends(self.layer_dependency),
             dataset_params=Depends(self.dataset_dependency),
             pixel_selection=Depends(self.pixel_selection_dependency),