switch to mkdocstring

.github/workflows/deploy_mkdocs.yml

@@ -33,13 +33,5 @@ jobs:
             stac_fastapi/api[docs] \
             stac_fastapi/extensions[docs] \
 
-      - name: update API docs
-        run: |
-          pdocs as_markdown \
-            --output_dir docs/src/api/ \
-            --exclude_source \
-            --overwrite \
-            stac_fastapi
-
       - name: Deploy docs
         run: mkdocs gh-deploy --force -f docs/mkdocs.yml

CONTRIBUTING.md

@@ -36,13 +36,6 @@ To manually deploy docs (note you should never need to do this because GitHub
 Actions deploys automatically for new commits.):
 
 ```bash
-Create API documentations
-$ pdocs as_markdown \
-  --output_dir docs/src/api/ \
-  --exclude_source \
-  --overwrite \
-  stac_fastapi
-
 # deploy
 $ mkdocs gh-deploy -f docs/mkdocs.yml
 ```

Dockerfile.docs

@@ -4,21 +4,14 @@ FROM python:3.11-slim
 RUN apt update && apt install -y build-essential
 
 RUN python -m pip install --upgrade pip
-RUN python -m pip install mkdocs mkdocs-material pdocs
 
 COPY . /opt/src
 
 WORKDIR /opt/src
 
 RUN python -m pip install \
-    stac_fastapi/types \
-    stac_fastapi/api \
-    stac_fastapi/extensions
+    "stac_fastapi/types[docs]" \
+    "stac_fastapi/api[docs]" \
+    "stac_fastapi/extensions[docs]"
 
-CMD ["pdocs", \
-    "as_markdown", \
-    "--output_dir", \
-    "docs/api/", \
-    "--exclude_source", \
-    "--overwrite", \
-    "stac_fastapi"]
+CMD ["mkdocs", "build", "-f", "docs/mkdocs.yml"]

docker-compose.docs.yml

@@ -1,18 +1,9 @@
-version: '3'
-
 services:
   docs:
     container_name: stac-fastapi-docs-dev
     build:
       context: .
       dockerfile: Dockerfile.docs
     platform: linux/amd64
-    environment:
-      - POSTGRES_USER=username
-      - POSTGRES_PASS=password
-      - POSTGRES_DBNAME=postgis
-      - POSTGRES_HOST_READER=database
-      - POSTGRES_HOST_WRITER=database
-      - POSTGRES_PORT=5432
     volumes:
       - .:/opt/src

docs/mkdocs.yml

@@ -30,24 +30,39 @@ nav:
           - models: api/stac_fastapi/api/models.md
           - openapi: api/stac_fastapi/api/openapi.md
           - routes: api/stac_fastapi/api/routes.md
-          - version: api/stac_fastapi/api/version.md
       - stac_fastapi.extensions:
           - module: api/stac_fastapi/extensions/index.md
           - core:
               - module: api/stac_fastapi/extensions/core/index.md
-              - context: api/stac_fastapi/extensions/core/context.md
-              - free_text:
-                - module: api/stac_fastapi/extensions/core/free_text/index.md
-                - free_text: api/stac_fastapi/extensions/core/free_text/free_text.md
-                - request: api/stac_fastapi/extensions/core/free_text/request.md
-              - filter:
-                  - module: api/stac_fastapi/extensions/core/filter/index.md
-                  - filter: api/stac_fastapi/extensions/core/filter/filter.md
-                  - request: api/stac_fastapi/extensions/core/filter/request.md
+              - aggregation:
+                - module: api/stac_fastapi/extensions/core/aggregation/index.md
+                - aggregation: api/stac_fastapi/extensions/core/aggregation/aggregation.md
+                - client: api/stac_fastapi/extensions/core/aggregation/client.md
+                - request: api/stac_fastapi/extensions/core/aggregation/request.md
+                - types: api/stac_fastapi/extensions/core/aggregation/types.md
+              - collection_search:
+                - module: api/stac_fastapi/extensions/core/collection_search/index.md
+                - collection_search: api/stac_fastapi/extensions/core/collection_search/collection_search.md
+                - client: api/stac_fastapi/extensions/core/collection_search/client.md
+                - request: api/stac_fastapi/extensions/core/collection_search/request.md
               - fields:
                   - module: api/stac_fastapi/extensions/core/fields/index.md
                   - fields: api/stac_fastapi/extensions/core/fields/fields.md
                   - request: api/stac_fastapi/extensions/core/fields/request.md
+              - filter:
+                  - module: api/stac_fastapi/extensions/core/filter/index.md
+                  - filter: api/stac_fastapi/extensions/core/filter/filter.md
+                  - request: api/stac_fastapi/extensions/core/filter/request.md
+              - free_text:
+                - module: api/stac_fastapi/extensions/core/free_text/index.md
+                - free_text: api/stac_fastapi/extensions/core/free_text/free_text.md
+                - request: api/stac_fastapi/extensions/core/free_text/request.md
+              - pagination:
+                  - module: api/stac_fastapi/extensions/core/pagination/index.md
+                  - pagination: api/stac_fastapi/extensions/core/pagination/pagination.md
+                  - offset_pagination: api/stac_fastapi/extensions/core/pagination/offset_pagination.md
+                  - token_pagination: api/stac_fastapi/extensions/core/pagination/token_pagination.md
+                  - request: api/stac_fastapi/extensions/core/pagination/request.md
               - query:
                   - module: api/stac_fastapi/extensions/core/query/index.md
                   - query: api/stac_fastapi/extensions/core/query/query.md
@@ -57,14 +72,9 @@ nav:
                   - request: api/stac_fastapi/extensions/core/sort/request.md
                   - sort: api/stac_fastapi/extensions/core/sort/sort.md
               - transaction: api/stac_fastapi/extensions/core/transaction.md
-              - pagination:
-                  - module: api/stac_fastapi/extensions/core/pagination/index.md
-                  - pagination: api/stac_fastapi/extensions/core/pagination/pagination.md
-                  - token_pagination: api/stac_fastapi/extensions/core/pagination/token_pagination.md
-              - version: api/stac_fastapi/extensions/version.md
           - third_party:
+              - module: api/stac_fastapi/extensions/third_party/index.md
               - bulk_transactions: api/stac_fastapi/extensions/third_party/bulk_transactions.md
-              - index: api/stac_fastapi/extensions/third_party/index.md
       - stac_fastapi.types:
           - module: api/stac_fastapi/types/index.md
           - config: api/stac_fastapi/types/config.md
@@ -77,7 +87,6 @@ nav:
           - rfc3339: api/stac_fastapi/types/rfc3339.md
           - search: api/stac_fastapi/types/search.md
           - stac: api/stac_fastapi/types/stac.md
-          - version: api/stac_fastapi/types/version.md
   - Migration Guides:
     - v2.5 -> v3.0: migrations/v3.0.0.md
     - v3.0 -> v4.0: migrations/v4.0.0.md
@@ -89,6 +98,27 @@ plugins:
   - search
   - mkdocstrings:
       enable_inventory: true
+      handlers:
+        python:
+          paths: [src]
+          options:
+            docstring_section_style: list
+            docstring_style: google
+            line_length: 100
+            separate_signature: true
+            show_root_heading: true
+            show_signature_annotations: true
+            show_source: false
+            show_symbol_type_toc: true
+            signature_crossrefs: true
+            extensions:
+              - griffe_inherited_docstrings
+          inventories:
+            - https://docs.python.org/3/objects.inv
+            - https://docs.pydantic.dev/latest/objects.inv
+            - https://fastapi.tiangolo.com/objects.inv
+            - https://www.starlette.io/objects.inv
+            - https://www.attrs.org/en/stable/objects.inv
 
 # Theme
 theme:

docs/src/api/stac_fastapi/api/app.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.app
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/config.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.config
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/errors.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.errors
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/index.md

@@ -0,0 +1,14 @@
+# Module stac_fastapi.api
+
+Api submodule.
+
+## Sub-modules
+
+* [stac_fastapi.api.app](app.md)
+* [stac_fastapi.api.config](config.md)
+* [stac_fastapi.api.errors](errors.md)
+* [stac_fastapi.api.middleware](middleware.md)
+* [stac_fastapi.api.models](models.md)
+* [stac_fastapi.api.openapi](openapi.md)
+* [stac_fastapi.api.routes](routes.md)
+

docs/src/api/stac_fastapi/api/middleware.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.middleware
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/models.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.models
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/openapi.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.openapi
+    options:
+      show_source: true

docs/src/api/stac_fastapi/api/routes.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.api.routes
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/aggregation/aggregation.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.core.aggregation.aggregation
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/aggregation/client.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.core.aggregation.client
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/aggregation/index.md

@@ -0,0 +1,10 @@
+# Module stac_fastapi.extensions.core.aggregation
+
+Aggregation Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.aggregation.aggregation](aggregation.md)
+* [stac_fastapi.extensions.core.aggregation.client](client.md)
+* [stac_fastapi.extensions.core.aggregation.request](request.md)
+* [stac_fastapi.extensions.core.aggregation.types](types.md)

docs/src/api/stac_fastapi/extensions/core/aggregation/request.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.core.aggregation.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/aggregation/types.md

@@ -0,0 +1,3 @@
+::: stac_fastapi.extensions.core.aggregation.types
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/collection_search/client.md

@@ -0,0 +1,4 @@
+
+::: stac_fastapi.extensions.core.collection_search.client
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/collection_search/collection_search.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.collection_search.collection_search
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/collection_search/index.md

@@ -0,0 +1,9 @@
+# Module stac_fastapi.extensions.core.collection_search
+
+Collection-Search Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.collection_search.collection_search](collection_search.md)
+* [stac_fastapi.extensions.core.collection_search.client](client.md)
+* [stac_fastapi.extensions.core.collection_search.request](request.md)

docs/src/api/stac_fastapi/extensions/core/collection_search/request.md

@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.core.collection_search.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/fields/fields.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.fields.fields
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/fields/index.md

@@ -0,0 +1,8 @@
+# Module stac_fastapi.extensions.core.fields
+
+Fields Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.fields.fields](fields.md)
+* [stac_fastapi.extensions.core.fields.request](request.md)

docs/src/api/stac_fastapi/extensions/core/fields/request.md

@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.core.fields.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/filter/filter.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.filter.filter
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/filter/index.md

@@ -0,0 +1,8 @@
+# Module stac_fastapi.extensions.core.filter
+
+Filter Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.filter.filter](filter.md)
+* [stac_fastapi.extensions.core.filter.request](request.md)

docs/src/api/stac_fastapi/extensions/core/filter/request.md

@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.core.filter.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/free_text/free_text.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.free_text.free_text
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/free_text/index.md

@@ -0,0 +1,8 @@
+# Module stac_fastapi.extensions.core.free_text
+
+Free-Text Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.free_text.free_text](free_text.md)
+* [stac_fastapi.extensions.core.free_text.request](request.md)

docs/src/api/stac_fastapi/extensions/core/free_text/request.md

@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.core.free_text.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/index.md

@@ -0,0 +1,13 @@
+# Module stac_fastapi.extensions
+
+Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.fields](fields/index.md)
+* [stac_fastapi.extensions.core.filter](filter/index.md)
+* [stac_fastapi.extensions.core.free_text](free_text/index.md)
+* [stac_fastapi.extensions.core.pagination](pagination/index.md)
+* [stac_fastapi.extensions.core.query](query/index.md)
+* [stac_fastapi.extensions.core.sort](sort/index.md)
+* [stac_fastapi.extensions.core.transaction](transaction.md)

docs/src/api/stac_fastapi/extensions/core/pagination/index.md

@@ -0,0 +1,10 @@
+# Module stac_fastapi.extensions.core.pagination
+
+Pagination Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.pagination.pagination](pagination.md)
+* [stac_fastapi.extensions.core.pagination.offset_pagination](offset_pagination.md)
+* [stac_fastapi.extensions.core.pagination.token_pagination](token_pagination.md)
+* [stac_fastapi.extensions.core.pagination.request](request.md)

docs/src/api/stac_fastapi/extensions/core/pagination/offset_pagination.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.pagination.offset_pagination
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/pagination/pagination.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.pagination.pagination
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/pagination/request.md

@@ -0,0 +1,6 @@
+
+
+
+::: stac_fastapi.extensions.core.pagination.request
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/pagination/token_pagination.md

@@ -0,0 +1,5 @@
+
+
+::: stac_fastapi.extensions.core.pagination.token_pagination
+    options:
+      show_source: true

docs/src/api/stac_fastapi/extensions/core/query/index.md

@@ -0,0 +1,8 @@
+# Module stac_fastapi.extensions.core.query
+
+Query Extensions submodule.
+
+## Sub-modules
+
+* [stac_fastapi.extensions.core.query.query](query.md)
+* [stac_fastapi.extensions.core.query.request](request.md)