geopython · webb-ben · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026 · Feb 2, 2026
diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -34,16 +34,42 @@ jobs:
         env:
           POSTGRES_DB: test
           POSTGRES_PASSWORD: ${{ secrets.DatabasePassword || 'postgres' }}
-
+      mysql:
+        image: mysql:8.0
+        env:
+          MYSQL_ROOT_PASSWORD: mysql
+          MYSQL_DATABASE: test_geo_app
+          MYSQL_USER: pygeoapi
+          MYSQL_PASSWORD: mysql
+        ports:
+          - 3306:3306
+      elasticsearch:
+        image: docker.elastic.co/elasticsearch/elasticsearch:8.17.0
+        ports:
+          - 9200:9200
+          - 9300:9300
+        env:
+          discovery.type: single-node
+          xpack.security.enabled: "false"
+          ES_JAVA_OPTS: "-Xms512m -Xmx512m"
+      opensearch:
+        image: opensearchproject/opensearch:2.18.0
+        ports:
+          - 9209:9200
+        env:
+          discovery.type: single-node
+          DISABLE_SECURITY_PLUGIN: "true"
+          OPENSEARCH_JAVA_OPTS: "-Xms512m -Xmx512m"
+      mongodb:
+        image: mongo:8.0.4
+        ports:
+          - 27017:27017
+      sensorthings:
+        image: ghcr.io/cgs-earth/sensorthings-action:0.1.2
+        volumes:
+          - /var/run/docker.sock:/var/run/docker.sock
+
     steps:
-    - name: Pre-pull Docker Images
-      run: |
-        docker pull container-registry.oracle.com/database/express:21.3.0-xe &
-        docker pull appropriate/curl:latest &
-        docker pull elasticsearch:8.17.0 &
-        docker pull opensearchproject/opensearch:2.18.0 &
-        docker pull mongo:8.0.4 &
-        docker pull postgis/postgis:14-3.2 &
     - name: Clear up GitHub runner diskspace
       run: |
         echo "Space before"
@@ -60,43 +86,21 @@ jobs:
       name: Setup Python ${{ matrix.python-version }}
       with:
         python-version: ${{ matrix.python-version }}
+    - name: Install and run Oracle
+      run: |
+        docker run \
+          -d \
+          --name oracledb \
+          -e ORACLE_PWD=oracle \
+          -v ${{ github.workspace }}/tests/data/oracle/init-db:/opt/oracle/scripts/startup \
+          -p 1521:1521 \
+          container-registry.oracle.com/database/express:21.3.0-xe
     - name: Configure sysctl limits
       run: |
         sudo swapoff -a
         sudo sysctl -w vm.swappiness=1
         sudo sysctl -w fs.file-max=262144
         sudo sysctl -w vm.max_map_count=262144
-    - name: "Install and run MySQL 📦"
-      uses: mirromutth/mysql-action@v1.1
-      with:
-        host port: 3306 
-        mysql version: '8.0' 
-        mysql database: test_geo_app
-        mysql root password: mysql # This is a dummy password here; not actually used in prod
-        mysql user: pygeoapi 
-        mysql password: mysql 
-
-    - name: Install and run Elasticsearch 📦
-      uses: getong/elasticsearch-action@v1.2
-      with:
-        elasticsearch version: '8.17.0'
-        host port: 9200
-        container port: 9200
-        host node port: 9300
-        node port: 9300
-        discovery type: 'single-node'
-    - name: Install and run OpenSearch 📦
-      uses: esmarkowski/opensearch-github-action@v1.0.0
-      with:
-        version: 2.18.0
-        security-disabled: true
-        port: 9209
-    - name: Install and run MongoDB
-      uses: supercharge/mongodb-github-action@1.12.0
-      with:
-        mongodb-version: '8.0.4'
-    - name: Install and run SensorThingsAPI
-      uses: cgs-earth/sensorthings-action@v0.1.2
     - name: Install sqlite and gpkg dependencies
       uses: awalsh128/cache-apt-pkgs-action@v1.4.3
       with:
@@ -113,9 +117,6 @@ jobs:
 #      with:
 #        packages: gdal-bin libgdal-dev
 #        version: 3.11.3
-    - name: Install and run Oracle
-      run: |
-        docker run -d --name oracledb -e ORACLE_PWD=oracle -v ${{ github.workspace }}/tests/data/oracle/init-db:/opt/oracle/scripts/startup -p 1521:1521 container-registry.oracle.com/database/express:21.3.0-xe
     - name: Install requirements 📦
       run: |
         pip3 install setuptools
@@ -131,6 +132,7 @@ jobs:
         pip3 install GDAL==`gdal-config --version`
     - name: setup test data ⚙️
       run: |
+        python3 tests/load_oracle_data.py
         python3 tests/load_es_data.py tests/data/ne_110m_populated_places_simple.geojson geonameid
         python3 tests/load_opensearch_data.py tests/data/ne_110m_populated_places_simple.geojson geonameid
         python3 tests/load_mongo_data.py tests/data/ne_110m_populated_places_simple.geojson
@@ -140,7 +142,6 @@ jobs:
         psql postgresql://postgres:${{ secrets.DatabasePassword || 'postgres' }}@localhost:5432/test -f tests/data/postgres_manager_full_structure.backup.sql
         mysql -h 127.0.0.1 -P 3306 -u root -p'mysql' test_geo_app < tests/data/mysql_data.sql
         docker ps
-        python3 tests/load_oracle_data.py
     - name: run API tests ⚙️
       run: pytest tests/api --ignore-glob='*_live.py'
     - name: run Formatter tests ⚙️

diff --git a/.github/workflows/vulnerabilities.yml b/.github/workflows/vulnerabilities.yml
@@ -24,7 +24,7 @@ jobs:
     - name: Checkout pygeoapi
       uses: actions/checkout@master
     - name: Scan vulnerabilities with trivy
-      uses: aquasecurity/trivy-action@master
+      uses: aquasecurity/trivy-action@v0.35.0
       with:
         scan-type: fs
         exit-code: 1
@@ -36,7 +36,7 @@ jobs:
       run: |
         docker buildx build -t ${{ github.repository }}:${{ github.sha }} --platform linux/amd64 --no-cache -f Dockerfile .
     - name: Scan locally built Docker image for vulnerabilities with trivy
-      uses: aquasecurity/trivy-action@master
+      uses: aquasecurity/trivy-action@v0.35.0
       env:
         TRIVY_DB_REPOSITORY: public.ecr.aws/aquasecurity/trivy-db:2
         TRIVY_JAVA_DB_REPOSITORY: public.ecr.aws/aquasecurity/trivy-java-db:1

diff --git a/Dockerfile b/Dockerfile
@@ -34,7 +34,7 @@
 #
 # =================================================================
 
-FROM ubuntu:noble-20260113
+FROM ubuntu:noble
 
 LABEL maintainer="Just van den Broecke <justb4@gmail.com>"
 

diff --git a/SECURITY.md b/SECURITY.md
@@ -13,5 +13,5 @@ The pygeoapi Project Steering Committee (PSC) will release patches for security
 
 | Version | Supported          |
 | ------- | ------------------ |
-| 0.10.x  | :white_check_mark: |
-| < 0.10  | :x:                |
+| 0.2x    | :white_check_mark: |
+| < 0.20  | :x:                |
diff --git a/docs/source/administration.rst b/docs/source/administration.rst
@@ -32,7 +32,7 @@ To generate the OpenAPI document as JSON, run:
 
 .. code-block:: bash
 
-   pygeoapi openapi generate /path/to/my-pygeoapi-config.yml --format json --output-file /path/to/my-pygeoapi-openapi.yml
+   pygeoapi openapi generate /path/to/my-pygeoapi-config.yml --format json --output-file /path/to/my-pygeoapi-openapi.json
 
 .. note::
    Generate as YAML or JSON?  If your OpenAPI YAML definition is slow to render as JSON,

diff --git a/docs/source/conf.py b/docs/source/conf.py
@@ -112,7 +112,7 @@ def __getattr__(cls, name):
 # built documents.
 #
 # The short X.Y version.
-version = '0.23.dev0'
+version = '0.24.dev0'
 # The full version, including alpha/beta/rc tags.
 release = version
 

diff --git a/docs/source/configuration.rst b/docs/source/configuration.rst
@@ -243,6 +243,8 @@ default.
                   begin: 2000-10-30T18:24:39Z  # start datetime in RFC3339
                   end: 2007-10-30T08:57:29Z  # end datetime in RFC3339
                   trs: http://www.opengis.net/def/uom/ISO-8601/0/Gregorian  # TRS
+                  resolution: P1D  # ISO 8601 duration
+                  default: 2000-10-30T18:24:39Z  # default time
               # additional extents can be added as desired (1..n)
               foo:
                   url: https://example.org/def  # required URL of the extent
@@ -290,6 +292,10 @@ default.
           type: process  # REQUIRED (collection, process, or stac-collection)
           processor:
               name: HelloWorld  # Python path of process definition
+          # optional, allow for internal HTTP request execution
+          # if set to True, enables requests to link local ranges and loopback
+          # default: False
+          allow_internal_requests: True
 
 
 .. seealso::

diff --git a/docs/source/plugins.rst b/docs/source/plugins.rst
@@ -306,11 +306,11 @@ The below template provides a minimal example (let's call the file ``mycooledrda
 
            self.covjson = {...}
 
-       def get_instances(self):
+       def instances(self):
            return ['foo', 'bar']
 
-       def get_instance(self, instance):
-           return instance in get_instances()
+       def instance(self, instance):
+           return instance in instances()
 
        def position(self, **kwargs):
            return self.covjson
@@ -320,8 +320,8 @@ The below template provides a minimal example (let's call the file ``mycooledrda
 
 
 For brevity, the ``position`` function returns ``self.covjson`` which is a
-dictionary of a CoverageJSON representation.  ``get_instances`` returns a list
-of instances associated with the collection/plugin, and ``get_instance`` returns
+dictionary of a CoverageJSON representation.  ``instances`` returns a list
+of instances associated with the collection/plugin, and ``instance`` returns
 a boolean of whether a given instance exists/is valid.  EDR query types are subject
 to the query functions defined in the plugin.  In the example above, the plugin
 implements ``position`` and ``trajectory`` queries, which will be advertised as
@@ -410,6 +410,7 @@ Below is a sample process definition as a Python dictionary:
                       'it back as output. Intended to demonstrate a simple '
                       'process with a single literal input.',
        'jobControlOptions': ['sync-execute', 'async-execute'],  # whether the process can be executed in sync or async mode
+       'outputTransmission': ['value', 'reference'],  # whether the process can return inline data or URL references
        'keywords': ['hello world', 'example', 'echo'],  # keywords associated with the process
        'links': [{  # a list of 1..n  # link objects relevant to the process
            'type': 'text/html',

diff --git a/docs/source/publishing/ogcapi-edr.rst b/docs/source/publishing/ogcapi-edr.rst
@@ -103,7 +103,7 @@ SensorThingsEDR
 ^^^^^^^^^^^^^^^
 
 The SensorThings API EDR Provider for pygeaopi extends the feature provider to
-produce CoverageJSON representations from SensorThings responses repsonses. This provider
+produce CoverageJSON representations from SensorThings responses. This provider
 relies on using the ObservedProperty Entity to create the `parameter-name` set.
 
 .. code-block:: yaml

diff --git a/docs/source/publishing/ogcapi-features.rst b/docs/source/publishing/ogcapi-features.rst
@@ -585,7 +585,7 @@ To publish a GeoParquet file (with a geometry column) the geopandas package is a
       - type: feature
         name: Parquet
         data: 
-          source: ./tests/data/parquet/random.parquet
+          source: ./tests/data/parquet/naive/random.parquet
         id_field: id
         time_field: time
         x_field:
@@ -595,11 +595,34 @@ To publish a GeoParquet file (with a geometry column) the geopandas package is a
           - minlat
           - maxlat
 
-For GeoParquet data, the `x_field` and `y_field` must be specified in the provider definition,
+For older versions of parquet data that don't comply to GeoParquet v1.1, the `x_field` and `y_field` must be specified in the provider definition,
 and they must be arrays of two column names that contain the x and y coordinates of the
 bounding box of each geometry. If the geometries in the data are all points, the `x_field` and `y_field`
 can be strings instead of arrays and refer to a single column each.
 
+.. code-block:: yaml 
+
+    providers:
+      - type: feature
+        name: Parquet
+        id_field: id
+        data: 
+          source:  ./tests/data/parquet/geoparquet1.1/nyc_subset_overture.parquet
+          batch_size: 10000
+          batch_readahead: 2
+
+
+For GeoParquet data which complies to spec version 1.1, all geometry metadata will be automatically
+detected. 
+
+Note that for any version of parquet, you may optionally specify ``batch_size`` and ``batch_readahead`` in the ``data`` section of the parquet provider config.
+``batch_size`` controls how many rows are fetched per batch. Large batch sizes speed up data processing, but add more I/O time like increased latency when fetching data from an object store, and . If not defined it will 
+default to 20,000 rows. 
+
+``batch_readahead`` controls how many batches are buffered in memory. If not specified it will default to 2. 
+Since OGC API Features payloads are often paginated and fairly small, it generally makes sense to specify a small number to avoid reading too many batches ahead of time, especially when fetching from an object store.
+
+
 .. _PostgreSQL:
 
 PostgreSQL
@@ -627,6 +650,18 @@ Must have PostGIS installed.
          geom_field: foo_geom
          count: true # Optional; Default true; Enable/disable count for improved performance.
 
+This can be represented as a connection dictionary or as a connection string as follows:
+
+.. code-block:: yaml
+
+   providers:
+       - type: feature
+         name: PostgreSQL
+         data: postgresql://postgres:postgres@127.0.0.1:3010/test
+         id_field: osm_id
+         table: hotosm_bdi_waterways
+         geom_field: foo_geom
+
 A number of database connection options can be also configured in the provider in order to adjust properly the sqlalchemy engine client.
 These are optional and if not specified, the default from the engine will be used. Please see also `SQLAlchemy docs <https://docs.sqlalchemy.org/en/14/core/engines.html#custom-dbapi-connect-arguments-on-connect-routines>`_.
 

diff --git a/docs/source/publishing/ogcapi-maps.rst b/docs/source/publishing/ogcapi-maps.rst
@@ -113,6 +113,15 @@ required.  An optional style name can be defined via `options.style`.
                name: png
                mimetype: image/png
 
+.. note::
+  According to the `Standard <https://docs.ogc.org/is/20-058/20-058.html#_5df53b56-5468-4c9d-acac-6abfddd83ccf>`_, OGC API - Maps
+  supports a `crs` parameter, expressed as an uri. Currently, this provider supports WGS84 and Web Mercator; for a matter of convenience, they can be expressed in
+  a number of different ways, other than the uri format.
+
+  - `EPSG:4326`
+  - `EPSG:3857`
+  - `4326`
+  - `3857`
 
 Data visualization examples
 ---------------------------

diff --git a/docs/source/pubsub.rst b/docs/source/pubsub.rst
@@ -85,6 +85,11 @@ Brokers
 
 The following protocols are supported:
 
+.. note::
+
+   Pub/Sub client dependencies will vary based on the selected broker.  ``requirements-pubsub.txt`` contains all requirements for supported brokers, as a reference point.
+
+
 MQTT
 ^^^^
 
@@ -99,6 +104,23 @@ Example directive:
            channel: messages/a/data  # optional
            hidden: false # default
 
+Kafka
+^^^^^
+
+Example directive:
+
+.. code-block:: yaml
+
+   pubsub:
+       name: Kafka
+       broker:
+           url: tcp://localhost:9092
+           channel: messages-a-data
+           # if using authentication:
+           # sasl_mechanism: PLAIN  # default PLAIN
+           # sasl_security_protocol: SASL_PLAINTEXT  # default SASL_PLAINTEXT
+           hidden: true  # default false
+
 HTTP
 ^^^^
 
@@ -113,12 +135,16 @@ Example directive:
            channel: messages-a-data  # optional
            hidden: true  # default false
 
+Additional information
+----------------------
+
 .. note::
 
    For any Pub/Sub endpoints requiring authentication, encode the ``url`` value as follows:
 
    * ``mqtt://username:password@localhost:1883``
    * ``https://username:password@localhost``
+   * ``tcp://username:password@localhost:9092``
 
    As with any section of the pygeoapi configuration, environment variables may be used as needed, for example
    to set username/password information in a URL.  If ``pubsub.broker.url`` contains authentication, and
@@ -131,5 +157,6 @@ Example directive:
 
    If a ``channel`` is not defined, only the relevant OGC API endpoint is used.
 
+
 .. _`OGC API Publish-Subscribe Workflow - Part 1: Core`: https://docs.ogc.org/DRAFTS/25-030.html
 .. _`AsyncAPI`: https://www.asyncapi.com
diff --git a/pygeoapi/__init__.py b/pygeoapi/__init__.py
@@ -30,7 +30,7 @@
 #
 # =================================================================
 
-__version__ = '0.23.dev0'
+__version__ = '0.24.dev0'
 
 import click
 try: