Merge branch 'release/v0.2.7'

Author: KelSolaar

.coveragerc

@@ -3,6 +3,8 @@ source = colour_datasets
 sigterm = True
 [report]
 exclude_lines =
-    pragma: no cover
+    if TYPE_CHECKING:
     if __name__ == .__main__.:
+    if typing.TYPE_CHECKING:
     pass
+    pragma: no cover

.github/ISSUE_TEMPLATE/feature-request.yml

@@ -7,7 +7,7 @@ body:
   - type: markdown
     attributes:
       value: >
-        Thank you for taking the time to file a feature request. Before continuing, please take some time to check the existing [issues](https://github.com/colour-science/colour-datasets/issues) and also the [draft release notes](https://gist.github.com/KelSolaar/4a6ebe9ec3d389f0934b154fec8df51d).
+        Thank you for taking the time to file a feature request. Before continuing, please take some time to check the existing [issues](https://github.com/colour-science/colour-datasets/issues).
 
   - type: textarea
     attributes:

.github/PULL_REQUEST_TEMPLATE.md

@@ -19,7 +19,7 @@ is available to guide the process: https://www.colour-science.org/contributing/.
 - [ ] Pre-commit hooks have been run and passed.
 
 <!-- The unit tests can be invoked with `uv run invoke tests` -->
-<!-- Pyright can be started with `pyright --threads --skipunannotated` -->
+<!-- Pyright can be started with `uv run pyright --threads --skipunannotated` -->
 
 **Documentation**
 

.github/workflows/continuous-integration-documentation.yml

@@ -25,6 +25,19 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python-version }}
+      - name: Clean Up Disk Space
+        run: |
+          df -h /
+
+          sudo rm -rf /usr/lib/jvm
+          sudo rm -rf /usr/local/.ghcup
+          sudo rm -rf /usr/local/lib/android
+          sudo rm -rf /usr/local/share/powershell
+          sudo rm -rf /usr/share/dotnet
+          sudo rm -rf /usr/share/swift
+          sudo rm -rf "$AGENT_TOOLSDIRECTORY"
+
+          df -h /
       - name: Install Dependencies
         run: |
           sudo apt-get update

.github/workflows/continuous-integration-quality-unit-tests.yml

@@ -20,10 +20,6 @@ jobs:
           echo "CI_SHA=${{ github.sha }}" >> $GITHUB_ENV
           echo "COVERALLS_REPO_TOKEN=${{ secrets.COVERALLS_REPO_TOKEN }}" >> $GITHUB_ENV
         shell: bash
-      - name: Set up Python 3.10 for Pre-Commit
-        uses: actions/setup-python@v5
-        with:
-          python-version: "3.10"
       - name: Set up Python ${{ matrix.python-version }}
         uses: actions/setup-python@v5
         with:
@@ -34,12 +30,13 @@ jobs:
         shell: bash
       - name: Install Package Dependencies
         run: |
-          uv sync --all-extras --no-dev
+          uv sync --all-extras
           uv run python -c "import imageio;imageio.plugins.freeimage.download()"
         shell: bash
-      - name: Pre-Commit (All Files)
+      - name: Prek (All Files)
+        if: matrix.os == 'macOS-latest'
         run: |
-          uv run pre-commit run --all-files
+          uv run prek run --all-files
         shell: bash
       - name: Test Optimised Python Execution
         run: |

.gitignore

@@ -1,22 +1,28 @@
+# Common Files
 *.egg-info
 *.pyc
 *.pyo
 .DS_Store
 .coverage*
-.fleet
-.idea
-.ipynb_checkpoints
+uv.lock
+
+# Common Directories
+.claude/
+.fleet/
+.idea/
+.ipynb_checkpoints/
 .python-version
-.sandbox
-.vs
-.vscode
+.vs/
+.vscode/
+.sandbox/
+build/
+dist/
+docs/_build/
+docs/generated/
+node_modules/
+references/
 
 __pycache__
 
-build
-dist
-docs/_build
-docs/generated
-references
+# Project Directories
 zenodo
-uv.lock

.pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
   - repo: https://github.com/pre-commit/pre-commit-hooks
-    rev: "v4.5.0"
+    rev: "v5.0.0"
     hooks:
       - id: check-added-large-files
       - id: check-case-conflict
@@ -15,32 +15,29 @@ repos:
       - id: requirements-txt-fixer
       - id: trailing-whitespace
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.2.6
+    rev: v2.4.1
     hooks:
       - id: codespell
-        args: ["--ignore-words-list=exitance,seperately"]
+        args:
+          ["--ignore-words-list=assertIn,exitance,seperately,socio-economic"]
         exclude: "BIBLIOGRAPHY.bib|CONTRIBUTORS.rst"
-  - repo: https://github.com/ikamensh/flynt
-    rev: "1.0.1"
-    hooks:
-      - id: flynt
-        args: [--verbose]
   - repo: https://github.com/PyCQA/isort
-    rev: "5.13.2"
+    rev: "6.0.1"
     hooks:
       - id: isort
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.1.14"
+    rev: "v0.12.4"
     hooks:
       - id: ruff-format
       - id: ruff
+        args: [--fix]
   - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.16.0
+    rev: 1.19.1
     hooks:
       - id: blacken-docs
-        language_version: python3.10
+        language_version: python3.11
   - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: "v3.1.0"
+    rev: "v4.0.0-alpha.8"
     hooks:
       - id: prettier
   - repo: https://github.com/pre-commit/pygrep-hooks

MANIFEST.in

@@ -162,7 +162,7 @@ Primary Dependencies
 
 - `python >= 3.10, < 3.14 <https://www.python.org/download/releases>`__
 - `cachetools <https://pypi.org/project/cachetools>`__
-- `colour-science >= 4.4 <https://pypi.org/project/colour-science>`__
+- `colour-science >= 4.5 <https://pypi.org/project/colour-science>`__
 - `imageio >= 2, < 3 <https://imageio.github.io>`__
 - `numpy >= 1.24, < 3 <https://pypi.org/project/numpy>`__
 - `scipy >= 1.10, < 2 <https://pypi.org/project/scipy>`__
@@ -217,7 +217,8 @@ The *Colour Developers* can be reached via different means:
 - `Facebook <https://www.facebook.com/python.colour.science>`__
 - `Github Discussions <https://github.com/colour-science/colour-datasets/discussions>`__
 - `Gitter <https://gitter.im/colour-science/colour>`__
-- `Twitter <https://twitter.com/colour_science>`__
+- `X <https://x.com/colour_science>`__
+- `Bluesky <https://bsky.app/profile/colour-science.bsky.social>`__
 
 About
 -----

README.rst

@@ -6,34 +6,34 @@ TODO
 
 -   colour_datasets/__init__.py
 
-    -   Line 74 : # TODO: Remove legacy printing support when deemed appropriate.
+    -   Line 81 : # TODO: Remove legacy printing support when deemed appropriate.
 
 
 -   colour_datasets/records/zenodo.py
 
-    -   Line 433 : # TODO: Remove the following space escaping: The new Zenodo API is not quoting filenames properly thus we are temporarily escaping spaces for now. https://github.com/colour-science/colour-datasets/issues/ 36issuecomment-1773464695
+    -   Line 437 : # TODO: Remove the following space escaping: The new Zenodo API is not quoting filenames properly thus we are temporarily escaping spaces for now. https://github.com/colour-science/colour-datasets/issues/ 36issuecomment-1773464695
 
 
 -   colour_datasets/utilities/common.py
 
-    -   Line 43 : # TODO: Use *colour* definition.
+    -   Line 47 : # TODO: Use *colour* definition.
 
 
 -   colour_datasets/loaders/kuopio.py
 
-    -   Line 304 : # TODO: Implement support for *Natural Colors*: https://sandbox.zenodo.org/record/315640 http://www.uef.fi/web/spectral/natural-colors
+    -   Line 310 : # TODO: Implement support for *Natural Colors*: https://sandbox.zenodo.org/record/315640 http://www.uef.fi/web/spectral/natural-colors
 
 
 -   colour_datasets/loaders/xrite2016.py
 
-    -   Line 108 : # TODO: Implement support for "CGATS" file format in "Colour": https://github.com/colour-science/colour/issues/354
+    -   Line 111 : # TODO: Implement support for "CGATS" file format in "Colour": https://github.com/colour-science/colour/issues/354
 
 
 -   colour_datasets/loaders/dyer2017.py
 
-    -   Line 141 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114. Those attributes are currently stored in "self._kwargs".
-    -   Line 923 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114.
-    -   Line 1420 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114.
+    -   Line 145 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114. Those attributes are currently stored in "self._kwargs".
+    -   Line 933 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114.
+    -   Line 1436 : # TODO: Re-instate "manufacturer", "model", "illuminant" and "type" attributes according to outcome of https://github.com/ampas/rawtoaces/issues/114.
 
 About
 -----