style: enforce MPL header

docs/conf.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """Sphinx docs configuration."""
 
 project = "scverse-doc"

pyproject.toml

@@ -125,6 +125,7 @@ lint.select = [
   "B",      # flake8-bugbear
   "BLE",    # flake8-blind-except
   "C4",     # flake8-comprehensions
+  "CPY",    # flake8-copyright
   "D",      # pydocstyle
   "E",      # Error detected by Pycodestyle
   "F",      # Errors detected by Pyflakes
@@ -149,8 +150,10 @@ lint.ignore = [
   "E741",   # allow I, O, l as variable names -> I is the identity matrix
   "TID252", # Allow relative imports
 ]
+lint.per-file-ignores."**/*.ipynb" = [ "CPY001" ]  # Missing copyright notice in notebook is fine
 lint.per-file-ignores."docs/*" = [ "I" ]
 lint.per-file-ignores."tests/*" = [ "D" ]
+lint.flake8-copyright.notice-rgx = "SPDX-License-Identifier: MPL-2\\.0"
 lint.pydocstyle.convention = "numpy"
 
 [tool.mypy]

scripts/sync_brand_tokens.py

@@ -1,4 +1,5 @@
 #!/usr/bin/env -S uv run --script
+# SPDX-License-Identifier: MPL-2.0
 # /// script
 # requires-python = ">=3.12"
 # dependencies = []

src/scverse_doc/__init__.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The scverse Sphinx theme and shared documentation configuration.
 
 A package’s `conf.py` needs few lines:

src/scverse_doc/_color.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """Colour maths for deriving accessible accent shades.
 
 Package accents are chosen for brand recognition, not for contrast.

src/scverse_doc/autodoc/__init__.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The layout of the API pages.
 
 Ships :mod:`~sphinx.ext.autosummary` templates for modules and classes.

src/scverse_doc/config.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The extension stack and the shared defaults.
 
 Sets up the extensions in :data:`EXTENSIONS`, so `conf.py` lists only ``scverse_doc``,

src/scverse_doc/napoleon.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """Prose return sections in NumPy-style docstrings.
 
 :mod:`sphinx.ext.napoleon` reads a NumPy-style ``Returns`` section as a list of ``name : type`` entries.

src/scverse_doc/registry.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The scverse package registry.
 
 :data:`packages` and :func:`core_packages` give the `listed packages`_ as :class:`Package` objects;

src/scverse_doc/source.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """Links into the source repository: the repository icon, “edit this page”, and ``[source]``.
 
 Declare the repository with :confval:`source_repository`.

src/scverse_doc/theme/__init__.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The scverse theme: brand chrome, the per-package accent, and the ecosystem dropdown.
 
 :mod:`scverse_doc` selects this theme; on its own, set ``html_theme = "scverse"``.

tests/roots/autodoc/apimod.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """A module to document."""
 
 from typing import Generic, TypeVar

tests/roots/autodoc/apipkg/__init__.py

@@ -1 +1,2 @@
+# SPDX-License-Identifier: MPL-2.0
 """A package to document recursively."""

tests/roots/autodoc/apipkg/sub/__init__.py

@@ -1 +1,2 @@
+# SPDX-License-Identifier: MPL-2.0
 """A subpackage."""

tests/roots/autodoc/apipkg/sub/deep.py

@@ -1 +1,2 @@
+# SPDX-License-Identifier: MPL-2.0
 """A module two levels down."""

tests/roots/autodoc/conf.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 import sys
 from pathlib import Path
 

tests/roots/entry-point/conf.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 project = "pertpy"
 # ``scverse_doc`` is not listed: Sphinx must load the theme from its entry point,
 # and the theme must bring ``scverse_doc.source`` with it – late enough that

tests/roots/minimal/conf.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 project = "pertpy"
 extensions = ["scverse_doc", "sphinx.ext.linkcode"]
 source_repository = "https://github.com/scverse/pertpy"

tests/roots/override/conf.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 project = "not-an-scverse-package"
 extensions = ["scverse_doc"]
 html_theme_options = {"show_toc_level": 4, "announcement": ""}

tests/test_build.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """End-to-end builds of the fixture documentation trees."""
 
 from __future__ import annotations

tests/test_color.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """Contrast guarantees for the derived accents."""
 
 from __future__ import annotations

tests/test_registry.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The fetched registry and the intersphinx mapping built from it."""
 
 from __future__ import annotations

tests/test_source.py

@@ -1,3 +1,4 @@
+# SPDX-License-Identifier: MPL-2.0
 """The repository description derived from the ``source_*`` config values."""
 
 from __future__ import annotations