Use colour checks configuration.

.gitignore

@@ -1,24 +1,24 @@
+# Common Files
 *.egg-info
 *.pyc
 *.pyo
 .DS_Store
 .coverage*
-.fleet
-.idea
-.ipynb_checkpoints
-.vs
-.vscode
-.sandbox
+uv.lock
 
-__pycache__
+# Common Directories
+.fleet/
+.idea/
+.ipynb_checkpoints/
+.python-version
+.vs/
+.vscode/
+.sandbox/
+build/
+dist/
+docs/_build/
+docs/generated/
+node_modules/
+references/
 
-build
-dist
-docs/_build
-docs/_static/Basics_*.png
-docs/_static/Examples_*.png
-docs/_static/Plotting_*.png
-docs/_static/Tutorial_*.png
-docs/generated
-poetry.lock
-references
+__pycache__

.pre-commit-config.yaml

@@ -1,13 +1,12 @@
 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
       - id: check-merge-conflict
       - id: check-symlinks
       - id: check-yaml
-        exclude: config-aces-reference.ocio.yaml
       - id: debug-statements
       - id: end-of-file-fixer
       - id: mixed-line-ending
@@ -16,35 +15,30 @@ repos:
       - id: requirements-txt-fixer
       - id: trailing-whitespace
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.2.6
+    rev: v2.3.0
     hooks:
       - id: codespell
-        args: ["--ignore-words-list=co-ordinates,exitance,fro,hart,ist"]
-        exclude: "BIBLIOGRAPHY.bib|CONTRIBUTORS.rst"
-  - repo: https://github.com/ikamensh/flynt
-    rev: "1.0.1"
-    hooks:
-      - id: flynt
-        args: [--verbose]
+        args: ["--ignore-words-list=socio-economic"]
+        exclude: "BIBLIOGRAPHY.bib|CONTRIBUTORS.rst|.*.ipynb"
   - repo: https://github.com/PyCQA/isort
     rev: "5.13.2"
     hooks:
       - id: isort
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.1.14"
+    rev: "v0.8.2"
     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
   - repo: https://github.com/pre-commit/mirrors-prettier
-    rev: "v3.1.0"
+    rev: "v4.0.0-alpha.8"
     hooks:
       - id: prettier
-        exclude: config-aces-reference.ocio.yaml
   - repo: https://github.com/pre-commit/pygrep-hooks
     rev: "v1.10.0"
     hooks:

CONTRIBUTING.rst

@@ -9,7 +9,7 @@ If you would like to contribute to **Colour**, please refer to the following gui
 About
 -----
 
-| **Colour** by Colour Developers
-| Copyright 2013 Colour Developers – `[email protected] <[email protected]>`__
+| **Colour - CLF IO** by Colour Developers
+| Copyright 2024 Colour Developers – `[email protected] <[email protected]>`__
 | This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause
 | `https://github.com/colour-science/colour <https://github.com/colour-science/colour>`__

LICENSE

@@ -1,4 +1,4 @@
-Copyright 2013 Colour Developers
+Copyright 2024 Colour Developers
 
 Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:
 

README.rst

@@ -167,6 +167,6 @@ About
 -----
 
 | **Colour - CLF IO** by Colour Developers
-| Copyright 2015 Colour Developers – `[email protected] <[email protected]>`__
+| Copyright 2024 Colour Developers – `[email protected] <[email protected]>`__
 | This software is released under terms of BSD-3-Clause: https://opensource.org/licenses/BSD-3-Clause
 | `https://github.com/colour-science/colour-clf-io <https://github.com/colour-science/colour-clf-io>`__

colour_clf_io/__init__.py

@@ -18,19 +18,41 @@
 
 from __future__ import annotations
 
-__application_name__ = "Colour - CLF IO"
-
-__major_version__ = "0"
-__minor_version__ = "0"
-__change_version__ = "0"
-__version__ = ".".join((__major_version__, __minor_version__, __change_version__))
+import typing
 
+if typing.TYPE_CHECKING:
+    from pathlib import Path
 
-# Security issues in lxml should be addressed and no longer be a concern:
+# NOTE: Security issues in lxml should be addressed and no longer be a concern:
 # https://discuss.python.org/t/status-of-defusedxml-and-recommendation-in-docs/34762/6
+import lxml.etree
+
+from .elements import (
+    CalibrationInfo,
+    ExponentParams,
+    ExponentStyle,
+    Info,
+    LogParams,
+    LogStyle,
+    RangeStyle,
+    SatNode,
+    SOPNode,
+)
+from .process_list import ProcessList
+from .process_nodes import (
+    ASC_CDL,
+    LUT1D,
+    LUT3D,
+    Exponent,
+    Log,
+    Matrix,
+    ProcessNode,
+    Range,
+)
+from .values import ASC_CDL_Style, BitDepth, Channel, Interpolation1D, Interpolation3D
 
 __author__ = "Colour Developers"
-__copyright__ = "Copyright 2013 Colour Developers"
+__copyright__ = "Copyright 2024 Colour Developers"
 __license__ = "BSD-3-Clause - https://opensource.org/licenses/BSD-3-Clause"
 __maintainer__ = "Colour Developers"
 __email__ = "[email protected]"
@@ -64,34 +86,15 @@
     "Log",
 ]
 
-import lxml.etree
+__application_name__ = "Colour - CLF IO"
 
-from .elements import (
-    CalibrationInfo,
-    ExponentParams,
-    ExponentStyle,
-    Info,
-    LogParams,
-    LogStyle,
-    RangeStyle,
-    SatNode,
-    SOPNode,
-)
-from .process_list import ProcessList
-from .process_nodes import (
-    ASC_CDL,
-    LUT1D,
-    LUT3D,
-    Exponent,
-    Log,
-    Matrix,
-    ProcessNode,
-    Range,
-)
-from .values import ASC_CDL_Style, BitDepth, Channel, Interpolation1D, Interpolation3D
+__major_version__ = "0"
+__minor_version__ = "1"
+__change_version__ = "0"
+__version__ = f"{__major_version__}.{__minor_version__}.{__change_version__}"
 
 
-def read_clf(path) -> ProcessList:
+def read_clf(path: str | Path) -> ProcessList | None:
     """
     Read given *CLF* file and return the resulting `ProcessList`.
 
@@ -108,15 +111,15 @@ def read_clf(path) -> ProcessList:
     ------
     :class: ParsingError
         If the given file does not contain a valid CLF document.
-
     """
-    xml = lxml.etree.parse(path)  # noqa: S320
+
+    xml = lxml.etree.parse(str(path))  # noqa: S320
     xml_process_list = xml.getroot()
-    root = ProcessList.from_xml(xml_process_list)
-    return root
+
+    return ProcessList.from_xml(xml_process_list)
 
 
-def parse_clf(text):
+def parse_clf(text: str | bytes) -> ProcessList | None:
     """
     Read given string as a *CLF* document and return the resulting `ProcessList`.
 
@@ -133,8 +136,8 @@ def parse_clf(text):
     ------
     :class: ParsingError
         If the given string does not contain a valid CLF document.
-
     """
+
     xml = lxml.etree.fromstring(text)  # noqa: S320
-    root = ProcessList.from_xml(xml)
-    return root
+
+    return ProcessList.from_xml(xml)