mew-bench 0.1.0__tar.gz

mew_bench-0.1.0/.clang-format

@@ -0,0 +1,3 @@
+BasedOnStyle: Google
+ColumnLimit: 100
+IndentWidth: 4

mew_bench-0.1.0/.clangd

@@ -0,0 +1,16 @@
+# clangd configuration for Zed (and any clangd-driven LSP).
+
+CompileFlags:
+  CompilationDatabase: .
+  Add:
+    - -std=c++17
+    - -Wno-unknown-warning-option
+
+Diagnostics:
+  # Google Benchmark uses some deprecated patterns internally; silencing
+  # those keeps the inline diagnostics focused on our own code.
+  Suppress:
+    - deprecated-declarations
+
+Index:
+  Background: Build

mew_bench-0.1.0/.dockerignore

@@ -0,0 +1,18 @@
+# Keep the build context to source only. Honored by both `docker build` and
+# Apple `container build` (BuildKit). Critically, the host `.venv` is macOS/wrong
+# -arch and would corrupt the in-container `uv sync` — never copy it in.
+.venv/
+.venv-ft/
+build/
+.git/
+.jj/
+docs/_build/
+
+# Caches and local artifacts — irrelevant to the build.
+**/__pycache__/
+**/*.pyc
+.pytest_cache/
+.ruff_cache/
+.mew-traces/
+*.trace/
+.DS_Store

mew_bench-0.1.0/.github/workflows/benchmark.yml.sketch

@@ -0,0 +1,98 @@
+# Sketch: benchmark a PR branch against master and post the comparison.
+#
+# Rename to `benchmark.yml` to activate. Notes before enabling:
+#   * Self-hosted (or at minimum a dedicated runner) is strongly recommended;
+#     GitHub-hosted runners share hardware and produce ±10-20% noise that
+#     swamps most real regressions.
+#   * Both runs must execute on the same physical machine for the comparison
+#     to be meaningful — keep them in one job, not two.
+#   * --repetitions 5 gives `mew compare` enough samples to compute
+#     a useful stddev. Tune up for noisier hardware.
+
+name: benchmarks
+
+on:
+  pull_request:
+    paths:
+      - "src/**"
+      - "benchmarks/**"
+
+permissions:
+  contents: read
+  pull-requests: write  # for the sticky comment
+
+concurrency:
+  group: benchmarks-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  bench:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          persist-credentials: false
+
+      - uses: astral-sh/setup-uv@v8
+        with:
+          python-version: "3.13"
+          enable-cache: true
+
+      # --- master baseline ---
+      - name: Check out master
+        run: git checkout origin/${{ github.base_ref }}
+      - name: Install (master)
+        run: uv sync --all-extras
+      - name: Benchmark master
+        run: uv run mew run benchmarks/ -o master.jsonl --repetitions 5
+
+      # --- PR head ---
+      - name: Check out PR head
+        run: git checkout ${{ github.event.pull_request.head.sha }}
+      - name: Install (PR)
+        run: uv sync --all-extras
+      - name: Benchmark PR
+        run: uv run mew run benchmarks/ -o pr.jsonl --repetitions 5
+
+      # --- compare ---
+      - name: Compare
+        # `--regression-threshold 5%` always prints the panel; add
+        # `--exit-non-zero-on-regression` once you trust the threshold to start
+        # gating merges. Per-benchmark allowlists live in
+        # `[tool.mew.regressions]` in pyproject.toml.
+        run: |
+          uv run mew compare pr.jsonl master.jsonl \
+            --stddev \
+            --regression-threshold 5% \
+            --exit-non-zero-on-regression \
+            | tee compare.txt
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: benchmarks
+          path: |
+            master.jsonl
+            pr.jsonl
+            compare.txt
+
+      - name: Render PR comment body
+        id: body
+        run: |
+          {
+            echo 'body<<EOF'
+            echo '## Benchmark comparison'
+            echo
+            echo 'Baseline: `master` · Variant: PR head'
+            echo
+            echo '```'
+            cat compare.txt
+            echo '```'
+            echo EOF
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Comment on PR
+        uses: marocchino/sticky-pull-request-comment@v2
+        with:
+          header: mew-benchmarks
+          message: ${{ steps.body.outputs.body }}

mew_bench-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,117 @@
+name: mew continuous integration checks
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+permissions: {}
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: lint · prek + ty
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Run linters, formatter and type checker
+        run: uvx prek run --all-files --show-diff-on-failure
+
+      - name: Type check the codebase
+        run: uv run --all-extras --group test ty check
+
+  test:
+    name: ${{ matrix.os }} · py${{ matrix.python-version }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+
+      - name: Install project and its dependencies
+        run: uv sync --all-extras --group test
+
+      - name: Run tests
+        run: uv run pytest -n auto
+
+  free-threaded:
+    name: free-threaded · py3.14t
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.14t"
+          enable-cache: true
+
+      # duckdb has no 3.14t wheel yet.
+      - name: Install project and its dependencies
+        run: uv sync --all-extras --group test --no-install-package duckdb
+
+      - name: Assert the GIL stays disabled after import
+        run: |
+          uv run --no-sync python - <<'PY'
+          import sys
+          assert not sys._is_gil_enabled(), "interpreter is not free-threaded"
+          import mew._core  # FREE_THREADED build must not re-enable the GIL
+          assert not sys._is_gil_enabled(), "importing mew._core re-enabled the GIL"
+          print("OK: GIL disabled after `import mew._core`")
+          PY
+
+      - name: Run tests
+        run: uv run --no-sync pytest -n auto
+
+  docs:
+    name: docs · sphinx
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.12"
+          enable-cache: true
+
+      - name: Install project and docs dependencies
+        run: uv sync --all-extras --group docs
+
+      - name: Build docs (warnings = errors)
+        run: uv run sphinx-build -W --keep-going -b html docs docs/_build/html
+
+      - name: Run doctests
+        run: uv run sphinx-build -b doctest docs docs/_build/doctest
+
+      - name: Check links
+        run: uv run sphinx-build -b linkcheck docs docs/_build/linkcheck
+        continue-on-error: true

mew_bench-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,86 @@
+name: Build wheels and upload to PyPI on release
+
+on:
+  workflow_dispatch:
+  pull_request:
+    paths:
+      - pyproject.toml
+      - CMakeLists.txt
+      - .github/workflows/release.yml
+  release:
+    types: [published]
+
+permissions: {}
+
+jobs:
+  wheels:
+    name: wheels · ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, ubuntu-24.04-arm, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          enable-cache: false
+
+      - uses: pypa/cibuildwheel@4726cd35bb13f7bde50cf2761f2499ac7b3aa32c # v4.1.1
+
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          persist-credentials: false
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@c771a70e6277c0a99b617c7a806ffedaca235ff9 # v9.0.0
+        with:
+          python-version: "3.12"
+          enable-cache: false
+
+      # `uv build` needs the backend importable without build isolation,
+      # which `no-build-isolation-package = ["mew-bench"]` asks for.
+      - run: uv sync --no-install-project
+      - run: uv build --sdist
+      - uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: publish · pypi
+    needs: [wheels, sdist]
+    if: github.event_name == 'release'
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Assert every artifact matches the release tag
+        env:
+          TAG: ${{ github.event.release.tag_name }}
+        run: |
+          for f in dist/*; do
+            case "${f##*/}" in
+              mew_bench-"${TAG#v}"-*.whl | mew_bench-"${TAG#v}".tar.gz) ;;
+              *) echo "::error::${f##*/} is not version ${TAG#v}"; exit 1 ;;
+            esac
+          done
+      - uses: pypa/gh-action-pypi-publish@dc37677b2e1c63e2034f94d8a5b11f265b73ba33 # v1.14.2

mew_bench-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.venv-ft
+
+# CMake / C++
+.cache/
+CMakeCache.txt
+CMakeFiles/
+cmake_install.cmake
+Makefile
+*.so
+*.dylib
+*.pyd
+_skbuild/
+compile_commands.json
+
+# IDE
+.vscode/
+.idea/
+.zed/
+
+# macOS
+.DS_Store
+
+# Test/coverage
+.pytest_cache/
+.ruff_cache/
+htmlcov/
+.coverage
+
+# flame graphs and profiles
+*.html
+
+# Sphinx
+docs/_build/
+docs/_generated/

mew_bench-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,28 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.16.0
+    hooks:
+      - id: ruff-check
+        args: [--fix, --exit-non-zero-on-fix]
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/mirrors-clang-format
+    rev: v22.1.8
+    hooks:
+      - id: clang-format
+        types_or: [c++, c]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+      - id: check-toml
+  - repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.12.0
+    hooks:
+      - id: uv-lock
+  - repo: https://github.com/woodruffw/zizmor-pre-commit
+    rev: v1.28.0
+    hooks:
+      - id: zizmor
+        args: [--fix, --min-severity=medium]

mew_bench-0.1.0/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# Read the Docs configuration for mew.
+# https://docs.readthedocs.com/platform/stable/config-file/v2.html
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+  apt_packages:
+    - cmake
+    - ninja-build
+  jobs:
+    post_create_environment:
+      - pip install uv
+    install:
+      - UV_PROJECT_ENVIRONMENT=$READTHEDOCS_VIRTUALENV_PATH uv sync --group docs
+
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: true
+
+formats:
+  - htmlzip

mew_bench-0.1.0/CLAUDE.md

@@ -0,0 +1,27 @@
+# Project Mew
+
+Microbenchmarking Python code snippets, and reporting results.
+
+## Tech stack
+
+* Google Benchmark as a microbenchmarking library
+* Python bindings via nanobind
+* stdlib `argparse` for the CLI (no third-party CLI dependency)
+* a small in-house ANSI module (`mew._console`) for terminal tables/colors — the runtime is zero-dependency
+* vite + echarts as a visualization tool for a lightweight browser app
+
+## Public Python API
+
+Lightweight and small surface.
+
+* Central: @mew.benchmark decorator to apply to a function to turn it into a benchmark.
+* Need to pass a `State` object or similar that binds a `benchmark::State` C++ object.
+* A @mew.parametrize decorator that defines a benchmark family mirroring the Google Benchmark concept. Needs to produce a sequence of callables that only take an input `State`, see previous.
+* A reporter class that writes the results. This can be a wrapper around the C++ BenchmarkReporter class.
+
+## Development setup
+
+* Use `uv` and `uvx` for all things Python related, like dependency installation and removals, and linting.
+* Prefer `prek` as a pre-commit runner tool.
+* Add tests under tests/. Test the core functionality first.
+* Use CMake for the Google Benchmark + nanobind setup, and `scikit-build-core` for PEP 517 wheel creation.

mew_bench-0.1.0/CMakeLists.txt

@@ -0,0 +1,186 @@
+cmake_minimum_required(VERSION 3.21)
+project(mew LANGUAGES CXX)
+
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_CXX_STANDARD_REQUIRED ON)
+set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+
+# Emit compile_commands.json for clangd / IDE LSPs. Also force-set here in
+# case the project is built without scikit-build-core (e.g. raw `cmake -B`).
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON CACHE INTERNAL "")
+
+# The file lands in ${CMAKE_BINARY_DIR}; with build-dir = "build/{wheel_tag}"
+# in pyproject.toml that path varies per ABI, so clangd's auto-discovery
+# (which probes ./build/ and the source root) won't find it. Symlink it to
+# the source root so IDE tooling picks it up without configuration.
+add_custom_target(
+    symlink_compile_commands ALL
+    COMMAND ${CMAKE_COMMAND} -E create_symlink
+        ${CMAKE_BINARY_DIR}/compile_commands.json
+        ${CMAKE_CURRENT_SOURCE_DIR}/compile_commands.json
+    BYPRODUCTS ${CMAKE_CURRENT_SOURCE_DIR}/compile_commands.json
+    COMMENT "Symlinking compile_commands.json to source root"
+    VERBATIM)
+
+if(NOT CMAKE_BUILD_TYPE)
+    set(CMAKE_BUILD_TYPE Release)
+endif()
+
+# AddressSanitizer build, driven by -DMEW_ASAN=ON or MEW_ASAN=1 in the env.
+# `add_compile_options` covers the fetched googlebenchmark target so its
+# objects stay instrumented; the per-target repeat below is required for
+# nanobind's stubgen sanitizer detector.
+option(MEW_ASAN "Build with AddressSanitizer" OFF)
+# Compare the value, not just DEFINED: `MEW_ASAN=0 cmake …` must not enable it.
+if(NOT MEW_ASAN AND DEFINED ENV{MEW_ASAN} AND "$ENV{MEW_ASAN}")
+    set(MEW_ASAN ON)
+endif()
+if(MEW_ASAN)
+    add_compile_options(-fsanitize=address -fno-omit-frame-pointer)
+    add_link_options(-fsanitize=address)
+endif()
+
+# ThreadSanitizer build, driven by -DMEW_TSAN=ON or MEW_TSAN=1 in the env.
+# Mutually exclusive with ASAN — the two runtimes can't co-load.
+option(MEW_TSAN "Build with ThreadSanitizer" OFF)
+if(NOT MEW_TSAN AND DEFINED ENV{MEW_TSAN} AND "$ENV{MEW_TSAN}")
+    set(MEW_TSAN ON)
+endif()
+if(MEW_TSAN AND MEW_ASAN)
+    message(FATAL_ERROR "MEW_TSAN and MEW_ASAN cannot be enabled at the same time")
+endif()
+if(MEW_TSAN)
+    add_compile_options(-fsanitize=thread -fno-omit-frame-pointer)
+    add_link_options(-fsanitize=thread)
+endif()
+
+# --- Python + nanobind --------------------------------------------------------
+# Optional, not required: a missing SABI module must degrade to a version-specific
+# build rather than fail the configure, and this also works outside scikit-build-core,
+# where SKBUILD_SABI_COMPONENT is undefined.
+find_package(Python 3.11
+    REQUIRED COMPONENTS Interpreter Development.Module
+    OPTIONAL_COMPONENTS Development.SABIModule)
+
+if(SKBUILD_SABI_COMPONENT AND NOT TARGET Python::SABIModule)
+    message(FATAL_ERROR
+        "scikit-build-core is building a stable-ABI wheel, but Python::SABIModule "
+        "was not found. Install the Python SABI development files, or clear "
+        "tool.scikit-build.wheel.py-api to build an untagged wheel.")
+endif()
+
+execute_process(
+    COMMAND "${Python_EXECUTABLE}" -m nanobind --cmake_dir
+    OUTPUT_STRIP_TRAILING_WHITESPACE
+    OUTPUT_VARIABLE nanobind_ROOT
+)
+find_package(nanobind CONFIG REQUIRED)
+
+# --- Google Benchmark ---------------------------------------------------------
+include(FetchContent)
+
+set(MEW_BENCHMARK_COMMIT
+    "a8460680f0df91fd26205e0931708a26c3b4094d"
+    CACHE STRING "Google Benchmark commit SHA to fetch")
+
+set(BENCHMARK_ENABLE_TESTING OFF CACHE BOOL "" FORCE)
+set(BENCHMARK_ENABLE_GTEST_TESTS OFF CACHE BOOL "" FORCE)
+set(BENCHMARK_ENABLE_INSTALL OFF CACHE BOOL "" FORCE)
+set(BENCHMARK_ENABLE_WERROR OFF CACHE BOOL "" FORCE)
+
+FetchContent_Declare(
+    googlebenchmark
+    GIT_REPOSITORY https://github.com/google/benchmark.git
+    GIT_TAG ${MEW_BENCHMARK_COMMIT}
+)
+FetchContent_MakeAvailable(googlebenchmark)
+
+# Report the commit FetchContent actually checked out, not just the requested
+# tag. A stale or diverged `_deps` checkout (e.g. a CMake cache that kept an old
+# pin) would otherwise make BENCHMARK_COMMIT lie about what was really built.
+# Falls back to the requested pin when there is no `.git` (vendored sdist).
+find_package(Git QUIET)
+set(MEW_BENCHMARK_BUILT_COMMIT "${MEW_BENCHMARK_COMMIT}")
+if(Git_FOUND AND IS_DIRECTORY "${googlebenchmark_SOURCE_DIR}/.git")
+    execute_process(
+        COMMAND "${GIT_EXECUTABLE}" -C "${googlebenchmark_SOURCE_DIR}" rev-parse HEAD
+        OUTPUT_VARIABLE MEW_BENCHMARK_BUILT_COMMIT
+        OUTPUT_STRIP_TRAILING_WHITESPACE
+        RESULT_VARIABLE _mew_rev_parse_status
+        ERROR_QUIET)
+    if(NOT _mew_rev_parse_status EQUAL 0)
+        set(MEW_BENCHMARK_BUILT_COMMIT "${MEW_BENCHMARK_COMMIT}")
+    endif()
+endif()
+
+message(STATUS "Google Benchmark requested: ${MEW_BENCHMARK_COMMIT}")
+message(STATUS "Google Benchmark built:     ${MEW_BENCHMARK_BUILT_COMMIT}")
+
+# --- _core extension ----------------------------------------------------------
+set(_MEW_SOURCES
+    src/_mew/module.cpp
+    src/_mew/state.cpp
+    src/_mew/registry.cpp
+    src/_mew/reporter.cpp
+)
+
+# nanobind keeps whichever of STABLE_ABI / FREE_THREADED fits the interpreter:
+# `cp312` abi3 on stock CPython, a `Py_MOD_GIL_NOT_USED` wheel on free-threaded
+# builds (the limited API has no free-threaded variant). Inert on a GIL build.
+nanobind_add_module(
+    _core
+    STABLE_ABI
+    FREE_THREADED
+    NB_STATIC
+    ${_MEW_SOURCES}
+)
+
+target_include_directories(_core PRIVATE src/_mew)
+target_link_libraries(_core PRIVATE benchmark::benchmark)
+target_compile_definitions(_core PRIVATE
+    MEW_BENCHMARK_COMMIT="${MEW_BENCHMARK_BUILT_COMMIT}"
+)
+
+# Repeat the sanitizer flag on _core itself: nanobind's stubgen detector only
+# scans per-target COMPILE_OPTIONS / LINK_OPTIONS. Without this it skips
+# preloading libclang_rt.asan and stubgen aborts on `import _core`.
+if(MEW_ASAN)
+    target_compile_options(_core PRIVATE -fsanitize=address -fno-omit-frame-pointer)
+    target_link_options(_core PRIVATE -fsanitize=address)
+endif()
+if(MEW_TSAN)
+    target_compile_options(_core PRIVATE -fsanitize=thread -fno-omit-frame-pointer)
+    target_link_options(_core PRIVATE -fsanitize=thread)
+endif()
+
+install(TARGETS _core LIBRARY DESTINATION mew)
+
+# Emit the .pyi stub next to the Python sources so IDEs and type checkers
+# pick it up via the src/-layout (which shadows site-packages for `mew._core`).
+nanobind_add_stub(
+    _core_stub
+    MODULE _core
+    OUTPUT ${CMAKE_CURRENT_SOURCE_DIR}/src/mew/_core.pyi
+    PATTERN_FILE ${CMAKE_CURRENT_SOURCE_DIR}/src/_mew/stubgen.pat
+    PYTHON_PATH $<TARGET_FILE_DIR:_core>
+    DEPENDS _core
+)
+
+# Run `ruff format` on the freshly-generated stub. Skipped if ruff isn't
+# available (e.g. building from an sdist without dev extras).
+execute_process(
+    COMMAND ${Python_EXECUTABLE} -m ruff --version
+    RESULT_VARIABLE _ruff_available
+    OUTPUT_QUIET ERROR_QUIET
+)
+if(_ruff_available EQUAL 0)
+    add_custom_command(
+        TARGET _core_stub POST_BUILD
+        COMMAND ${Python_EXECUTABLE} -m ruff check --fix --exit-zero --quiet
+            ${CMAKE_CURRENT_SOURCE_DIR}/src/mew/_core.pyi
+        COMMAND ${Python_EXECUTABLE} -m ruff format --quiet
+            ${CMAKE_CURRENT_SOURCE_DIR}/src/mew/_core.pyi
+        COMMENT "ruff fix + format _core.pyi"
+        VERBATIM
+    )
+endif()