opendatacube · Ariana-B · Jan 15, 2025 · Jan 15, 2025 · Jan 15, 2025 · Jan 15, 2025
diff --git a/.doctor-rst.yaml b/.doctor-rst.yaml
diff --git a/.github/workflows/doc-preview.yaml b/.github/workflows/doc-preview.yaml
@@ -0,0 +1,26 @@
+# This Workflow exists solely to push a link into
+# PR descriptions to a preview build of the docs
+# from the PRs source branch.
+#
+# It requires extra permissions, to write to the PR.
+#
+# It uses the unusual `pull_request_target` trigger, which
+# only gives it access to the target of the PR, not the source.
+# But this is a-okay because it doesn't even look at the source
+# code, it just updates the PR description with a link.
+name: Post RTD Preview Link to PRs
+on:
+  pull_request_target:
+     types:
+       - opened
+
+permissions:
+  pull-requests: write
+
+jobs:
+  documentation-preview:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: readthedocs/actions/preview@v1
+        with:
+          project-slug: "datacube-core"
diff --git a/.github/workflows/doc-qa.yaml b/.github/workflows/doc-qa.yaml
@@ -1,12 +1,9 @@
 name: Doc QA
 on:
   # Triggers the workflow on pull request events for the main branch
-  pull_request_target:
-    types:
-      - opened
-
-permissions:
-  pull-requests: write
+  pull_request:
+    paths:
+      - '**'
 
 jobs:
   pyspell:
@@ -41,13 +38,8 @@ jobs:
               key: ${{ runner.os }}-doctor-rst-${{ steps.extract_base_branch.outputs.branch }}
 
       -   name: "Run DOCtor-RST"
-          uses: docker://oskarstark/doctor-rst:1.23.0
+          uses: docker://oskarstark/doctor-rst:1.64.0
           with:
               args: --short --error-format=github --cache-file=/github/workspace/.cache/doctor-rst.cache
-
-  documentation-preview:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: readthedocs/actions/preview@v1
-        with:
-          project-slug: "datacube-core"
+          env:
+              DOCS_DIR: 'docs/'
diff --git a/.github/workflows/lint.yaml b/.github/workflows/lint.yaml
@@ -6,6 +6,8 @@ on:
       - '**'
 
   push:
+    branches:
+      - develop
     paths:
       - '**'
       - '!.github/**'

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
@@ -6,6 +6,8 @@ on:
       - '**'
 
   push:
+    branches:
+      - develop
     paths:
       - '**'
       - '!docs/**'

diff --git a/.github/workflows/test-conda-build.yml b/.github/workflows/test-conda-build.yml
@@ -5,6 +5,8 @@ on:
       - '**'
 
   push:
+    branches:
+      - develop
     paths:
       - '**'
 

diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -4,9 +4,8 @@ repos:
       hooks:
         - id: yamllint
     - repo: https://github.com/pre-commit/pre-commit-hooks
-      rev: v2.4.0
+      rev: v5.0.0
       hooks:
-        - id: flake8
         - id: end-of-file-fixer
         - id: check-docstring-first
         - id: check-json
@@ -18,10 +17,15 @@ repos:
           exclude: ^tests/drivers/fail_drivers
         - id: check-added-large-files
         - id: check-merge-conflict
-    -   repo: https://github.com/pre-commit/mirrors-pylint
-        rev: v3.0.0a5  # Use the sha / tag you want to point at
+    -   repo: https://github.com/pylint-dev/pylint
+        rev: v3.3.3  # Use the sha / tag you want to point at
         hooks:
         -   id: pylint
+            language_version: '3.12'  # Reqd of 2025-01-15
+    -   repo: https://github.com/pycqa/flake8
+        rev: '7.1.1'
+        hooks:
+        -   id: flake8
     - repo: https://github.com/Lucas-C/pre-commit-hooks
       rev: v1.5.5
       hooks:

diff --git a/README.rst b/README.rst
@@ -98,7 +98,7 @@ Run unit tests with:
 
    ``./check-code.sh integration_tests``
 
-   -  Assumes the sexistence of two password-less Postgres databases running on localhost called
+   -  Assumes the existence of two password-less Postgres databases running on localhost called
       ``pgintegration`` and ``pgisintegration``.
 
    -  Otherwise copy ``integration_tests/integration.conf`` to

diff --git a/datacube/__init__.py b/datacube/__init__.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Datacube

diff --git a/datacube/api/__init__.py b/datacube/api/__init__.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Modules for the Storage and Access Query API

diff --git a/datacube/api/core.py b/datacube/api/core.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 import logging
 import uuid

diff --git a/datacube/api/query.py b/datacube/api/query.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Storage Query and Access API module

diff --git a/datacube/cfg/__init__.py b/datacube/cfg/__init__.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 
 

diff --git a/datacube/cfg/api.py b/datacube/cfg/api.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 
 """

diff --git a/datacube/cfg/cfg.py b/datacube/cfg/cfg.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Low level config path resolution, loading and multi-format parsing functions.

diff --git a/datacube/cfg/exceptions.py b/datacube/cfg/exceptions.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Config reading/loading exceptions

diff --git a/datacube/cfg/opt.py b/datacube/cfg/opt.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 
 import os

diff --git a/datacube/cfg/utils.py b/datacube/cfg/utils.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 
 import re

diff --git a/datacube/config.py b/datacube/config.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 User configuration.

diff --git a/datacube/drivers/__init__.py b/datacube/drivers/__init__.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 This module implements a simple plugin manager for storage and index drivers.

diff --git a/datacube/drivers/_tools.py b/datacube/drivers/_tools.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 from threading import Lock
 from typing import Any

diff --git a/datacube/drivers/_types.py b/datacube/drivers/_types.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """ Defines abstract types for IO drivers.
 """

diff --git a/datacube/drivers/datasource.py b/datacube/drivers/datasource.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """ Defines abstract types for IO reader drivers.
 """

diff --git a/datacube/drivers/driver_cache.py b/datacube/drivers/driver_cache.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 import logging
 from typing import Dict, Any, Tuple, Iterable

diff --git a/datacube/drivers/indexes.py b/datacube/drivers/indexes.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 from typing import List, Optional
 

diff --git a/datacube/drivers/netcdf/__init__.py b/datacube/drivers/netcdf/__init__.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 from ._write import write_dataset_to_netcdf, create_netcdf_storage_unit
 from . import writer as netcdf_writer

diff --git a/datacube/drivers/netcdf/_write.py b/datacube/drivers/netcdf/_write.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 from pathlib import Path
 import logging

diff --git a/datacube/drivers/netcdf/driver.py b/datacube/drivers/netcdf/driver.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 from urllib.parse import urlsplit
 

diff --git a/datacube/drivers/netcdf/writer.py b/datacube/drivers/netcdf/writer.py
@@ -1,6 +1,6 @@
 # This file is part of the Open Data Cube, see https://opendatacube.org for more information
 #
-# Copyright (c) 2015-2024 ODC Contributors
+# Copyright (c) 2015-2025 ODC Contributors
 # SPDX-License-Identifier: Apache-2.0
 """
 Create netCDF4 Storage Units and write data to them
-Original file line number
+Diff line change
@@ Expand Up / @@ -6,6 +6,8 @@ on: @@
           - '**'
       push:
+        branches:
+          - develop
         paths:
           - '**'
           - '!.github/**'
@@ Expand Down @@