🔧 Maintenance round (#887)

## Description

This PR combines several maintenance updates:

- Remove dependency on `setuptools-scm`
- Use `ruff format` instead of `blacken-docs`
- Use `macos-26` and `macos-26-intel` as default macOS runners
- Rename `LICENSE.md` to `LICENSE`

## Checklist

- [x] ~~The pull request only contains commits that are focused and
relevant to this change.~~
- [x] ~~I have added appropriate tests that cover the new/changed
functionality.~~
- [x] ~~I have updated the documentation to reflect these changes.~~
- [x] ~~I have added entries to the changelog for any noteworthy
additions, changes, fixes, or removals.~~
- [x] ~~I have added migration instructions to the upgrade guide (if
needed).~~
- [x] The changes follow the project's style guidelines and introduce no
new warnings.
- [x] The changes are fully tested and pass the CI checks.
- [x] I have reviewed my own code changes.

---------

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: denialhaag

.github/workflows/ci.yml

@@ -32,8 +32,8 @@ jobs:
           [
             ubuntu-24.04,
             ubuntu-24.04-arm,
-            macos-15,
-            macos-15-intel,
+            macos-26,
+            macos-26-intel,
             windows-2025,
           ]
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-python-tests.yml@b59d15aa4f266e713afad51e132bde6e3a28a6b3 # v1.18.1

.github/workflows/upstream.yml

@@ -18,7 +18,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        runs-on: [ubuntu-24.04, macos-15, windows-2025]
+        runs-on: [ubuntu-24.04, macos-26, windows-2025]
     uses: munich-quantum-toolkit/workflows/.github/workflows/reusable-qiskit-upstream-tests.yml@b59d15aa4f266e713afad51e132bde6e3a28a6b3 # v1.18.1
     with:
       runs-on: ${{ matrix.runs-on }}

.license-tools-config.json

@@ -35,6 +35,7 @@
     ".*build.*",
     ".*\\.rst",
     ".*\\.ipynb",
-    "Dockerfile"
+    "Dockerfile",
+    "LICENSE"
   ]
 }

.pre-commit-config.yaml

@@ -109,30 +109,22 @@ repos:
     rev: v3.8.1
     hooks:
       - id: prettier
-        types_or: [yaml, markdown, html, css, scss, javascript, json]
+        types_or: [yaml, markdown, html, css, scss, javascript, json, json5]
         priority: 1
 
   ## Python linting using ruff
   - repo: https://github.com/astral-sh/ruff-pre-commit
     rev: v0.15.9
     hooks:
       - id: ruff-format
+        types_or: [python, pyi, jupyter, markdown]
         priority: 1
       - id: ruff-check
         require_serial: true
         priority: 2
 
   # Priority 2+: Final checks and fixers
 
-  ## Also run Black on examples in the documentation (needs to run after ruff format)
-  - repo: https://github.com/adamchainz/blacken-docs
-    rev: 1.20.0
-    hooks:
-      - id: blacken-docs
-        language: python
-        additional_dependencies: [black==26.*]
-        priority: 2
-
   ## Static type checking using ty (needs to run after lockfile update/ruff format, and ruff lint)
   - repo: local
     hooks:

LICENSE.md LICENSELICENSE.md renamed to LICENSE

@@ -91,9 +91,7 @@ The following code gives an example on the usage:
 from mqt.bench import BenchmarkLevel, get_benchmark
 
 # Get a benchmark circuit on algorithmic level representing the GHZ state with 5 qubits
-qc_algorithmic_level = get_benchmark(
-    benchmark="ghz", level=BenchmarkLevel.ALG, circuit_size=5
-)
+qc_algorithmic_level = get_benchmark(benchmark="ghz", level=BenchmarkLevel.ALG, circuit_size=5)
 
 # Draw the circuit
 print(qc_algorithmic_level.draw())

README.md

@@ -90,12 +90,8 @@ Please see the [API documentation](https://mqt.readthedocs.io/projects/bench/en/
 from mqt.bench import get_benchmark, BenchmarkLevel
 from mqt.bench.targets import get_target_for_gateset, get_device
 
-benchmark_alg_level = get_benchmark(
-    benchmark="dj", level=BenchmarkLevel.ALG, circuit_size=5
-)
-benchmark_independent_level = get_benchmark(
-    benchmark="dj", level=BenchmarkLevel.INDEP, circuit_size=5
-)
+benchmark_alg_level = get_benchmark(benchmark="dj", level=BenchmarkLevel.ALG, circuit_size=5)
+benchmark_independent_level = get_benchmark(benchmark="dj", level=BenchmarkLevel.INDEP, circuit_size=5)
 benchmark_native_gates_level = get_benchmark(
     benchmark="dj",
     level=BenchmarkLevel.NATIVEGATES,

UPGRADING.md

@@ -10,7 +10,6 @@
 
 from __future__ import annotations
 
-import warnings
 from importlib import metadata
 from pathlib import Path
 from typing import TYPE_CHECKING
@@ -25,15 +24,8 @@
 try:
     version = metadata.version("mqt.bench")
 except ModuleNotFoundError:
-    msg = (
-        "Package should be installed to produce documentation! "
-        "Assuming a modern git archive was used for version discovery."
-    )
-    warnings.warn(msg, stacklevel=1)
-
-    from setuptools_scm import get_version
-
-    version = get_version(root=str(ROOT), fallback_root=ROOT)
+    msg = "mqt.bench must be installed to build the documentation"
+    raise ModuleNotFoundError(msg) from None
 
 # Filter git details from version
 release = version.split("+")[0]

docs/conf.py

@@ -15,7 +15,7 @@ authors = [
 ]
 keywords = ["MQT",  "quantum computing", "benchmarking", "performance", "testing"]
 license = "MIT"
-license-files = ["LICENSE.md"]
+license-files = ["LICENSE"]
 requires-python = ">=3.10, !=3.14.1"
 dynamic = ["version"]
 
@@ -64,7 +64,6 @@ test = [
 docs = [
     "furo>=2025.09.25",
     "myst-nb>=1.3.0",
-    "setuptools-scm>=9.2.2",
     "openqasm-pygments>=0.2.0",
     "sphinx>=8.1.3",
     "sphinx>=8.2.3; python_version >= '3.11'",
@@ -159,6 +158,7 @@ unsafe-fixes = true
 show-fixes = true
 
 [tool.ruff.format]
+preview = true
 docstring-code-format = true
 
 [tool.ruff.lint]
@@ -252,14 +252,13 @@ bench = "bench"
 benchs = "benchs"
 
 
-[tool.repo-review]
-ignore = [
-    "GH200", # We use Renovate instead of Dependabot
-    "MY100", # We use ty instead of mypy
-    "PC140", # We use ty instead of mypy
-    "PC160", # We use a mirror of crate-ci/typos
-    "PC170", # We do not use rST files anymore
-]
+[tool.repo-review.ignore]
+GH200 = "We use Renovate instead of Dependabot"
+MY100 = "We use ty instead of mypy"
+PC111 = "We use ruff instead of blacken-docs"
+PC140 = "We use ty instead of mypy"
+PC160 = "We use a mirror of crate-ci/typos"
+PC170 = "We do not use rST files anymore"
 
 
 [tool.ty.terminal]