meshioplusplus 6.0.5__tar.gz

meshioplusplus-6.0.5/.clang-format

@@ -0,0 +1,19 @@
+---
+# Codifies the C++ style already in use across cpp/, bindings/, bindings_js/
+# (K&R braces, 4-space indent, no tabs). Does not apply to cpp/third_party
+# (vendored dependencies) or any fetched build directory.
+BasedOnStyle: Google
+Language: Cpp
+IndentWidth: 4
+UseTab: Never
+ColumnLimit: 100
+BreakBeforeBraces: Attach
+AccessModifierOffset: -4
+NamespaceIndentation: None
+PointerAlignment: Left
+ReferenceAlignment: Left
+AllowShortFunctionsOnASingleLine: Inline
+AllowShortIfStatementsOnASingleLine: false
+AllowShortLoopsOnASingleLine: false
+SortIncludes: Never
+DerivePointerAlignment: false

meshioplusplus-6.0.5/.codecov.yml

@@ -0,0 +1 @@
+comment: no

meshioplusplus-6.0.5/.flake8

@@ -0,0 +1,6 @@
+[flake8]
+exclude = venv, .tox
+ignore = E203, E266, E501, W503, C901, E741
+max-line-length = 88
+max-complexity = 18
+select = B,C,E,F,W,T4,B9

meshioplusplus-6.0.5/.gitattributes

@@ -0,0 +1,18 @@
+*.bin filter=lfs diff=lfs merge=lfs -text
+*.f3grid filter=lfs diff=lfs merge=lfs -text
+*.fem filter=lfs diff=lfs merge=lfs -text
+*.inp filter=lfs diff=lfs merge=lfs -text
+*.med filter=lfs diff=lfs merge=lfs -text
+*.msh filter=lfs diff=lfs merge=lfs -text
+*.obj filter=lfs diff=lfs merge=lfs -text
+*.ply filter=lfs diff=lfs merge=lfs -text
+*.vtk filter=lfs diff=lfs merge=lfs -text
+*.vtu filter=lfs diff=lfs merge=lfs -text
+*.ugrid filter=lfs diff=lfs merge=lfs -text
+*.mesh filter=lfs diff=lfs merge=lfs -text
+*.meshb filter=lfs diff=lfs merge=lfs -text
+*.tec filter=lfs diff=lfs merge=lfs -text
+*.su2 filter=lfs diff=lfs merge=lfs -text
+*.ele filter=lfs diff=lfs merge=lfs -text
+*.node filter=lfs diff=lfs merge=lfs -text
+*.vol filter=lfs diff=lfs merge=lfs -text

meshioplusplus-6.0.5/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: vicentemataixferrandiz # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

meshioplusplus-6.0.5/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,23 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: "[BUG]"
+labels: Needs triage
+assignees: ""
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+A minimal code example that reproduces the problem would be a big help if you can provide it. Attach a small mesh file if necessary.
+
+**Diagnose**
+I may ask you to cut and paste the output of the following command.
+```
+pip freeze | grep meshioplusplus
+```
+
+**Did I help?**
+
+If I was able to resolve your problem, consider [sponsoring](https://github.com/sponsors/nschloe) my work on meshio++, or [buy me a coffee](https://ko-fi.com/nschloe) to say thanks.

meshioplusplus-6.0.5/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,21 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: "[REQUEST]"
+labels: Needs triage
+assignees: ''
+---
+
+Consider posting in https://github.com/<org>/meshioplusplus/discussions for feedback before raising a feature request.
+
+**How would you improve meshio++?**
+
+Give as much detail as you can. Example code of how you would like it to work would help.
+
+**What problem does it solved for you?**
+
+What problem do you have that this feature would solve? I may be able to suggest an existing way of solving it.
+
+**Did I help**
+
+If I was able to resolve your problem, consider [sponsoring](https://github.com/sponsors/nschloe) my work on meshio++, or [buy me a coffee](https://ko-fi.com/nschloe) to say thanks.

meshioplusplus-6.0.5/.github/ISSUE_TEMPLATE/new_format.md

@@ -0,0 +1,18 @@
+---
+name: New Format
+about: Suggest support for a new mesh format
+labels: new format
+assignees: ''
+---
+
+Would you like support for a new mesh format in meshio++? First check the existing issues, there are a number of format requests already. It's often easy to get rudimentary support for a format, so don't be afraid to start a PR!
+
+Consider posting in https://github.com/<org>/meshioplusplus/discussions for feedback before raising a feature request.
+
+**Format specification?**
+
+Most formats have a detailed specification somewhere online. Make sure to post a link to that.
+
+**Did I help**
+
+If I was able to resolve your problem, consider [sponsoring](https://github.com/sponsors/nschloe) my work on meshio++, or [buy me a coffee](https://ko-fi.com/nschloe) to say thanks.

meshioplusplus-6.0.5/.github/workflows/ci.yml

@@ -0,0 +1,130 @@
+name: ci
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+# Cancel superseded runs on the same ref.
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - uses: pre-commit/action@v3.0.1
+
+  cpp-tests:
+    name: C++ tests (GoogleTest / CTest)
+    needs: [lint]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: recursive  # vendored Eigen (MED transpose)
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Install native libraries
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libhdf5-dev libnetcdf-dev zlib1g-dev libtbb-dev
+      - name: Install build tools
+        run: python -m pip install --upgrade pip pybind11 cmake ninja
+      - name: Configure (STL parallel backend + TBB)
+        run: >-
+          cmake -S . -B build -G Ninja
+          -DMESHIOPLUSPLUS_BUILD_TESTS=ON
+          -DMESHIOPLUSPLUS_PARALLEL_BACKEND=STL
+          -DPython_EXECUTABLE=$(which python)
+          -Dpybind11_DIR=$(python -c "import pybind11; print(pybind11.get_cmake_dir())")
+      - name: Build
+        run: cmake --build build
+      - name: Run C++ tests
+        run: ctest --test-dir build --output-on-failure
+      - name: Configure (OpenMP parallel backend)
+        run: >-
+          cmake -S . -B build-omp -G Ninja
+          -DMESHIOPLUSPLUS_BUILD_TESTS=ON
+          -DMESHIOPLUSPLUS_PARALLEL_BACKEND=OPENMP
+          -DPython_EXECUTABLE=$(which python)
+          -Dpybind11_DIR=$(python -c "import pybind11; print(pybind11.get_cmake_dir())")
+      - name: Build (OpenMP)
+        run: cmake --build build-omp
+      - name: Run C++ tests (OpenMP)
+        run: ctest --test-dir build-omp --output-on-failure
+
+  test:
+    needs: [lint]
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          lfs: true
+          submodules: recursive  # vendored Eigen (MED transpose)
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      # System HDF5/netCDF/zlib light up the native C++ paths.  When they are
+      # absent (Windows), the h5py/netCDF4 Python wheels and the stdlib zlib
+      # keep every format working via the fallback shims, so the suite still
+      # passes -- this is the same story users get on a plain `pip install`.
+      - name: Install native libraries (Linux)
+        if: runner.os == 'Linux'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libhdf5-dev libnetcdf-dev zlib1g-dev liblzma-dev libtbb-dev
+
+      - name: Install native libraries (macOS)
+        if: runner.os == 'macOS'
+        # libomp lets the AUTO parallel backend use OpenMP on Apple clang
+        # (libc++ has no parallel STL).
+        run: brew install hdf5 netcdf libomp
+
+      # macOS 13.3+ deployment target: required for std::format (its
+      # floating-point formatting symbols live in the OS libc++ dylib).
+      - name: Set macOS deployment target
+        if: runner.os == 'macOS'
+        shell: bash
+        run: echo 'MACOSX_DEPLOYMENT_TARGET=13.3' >> "$GITHUB_ENV"
+
+      - name: Configure build (Linux/macOS - native paths on)
+        if: runner.os != 'Windows'
+        shell: bash
+        run: echo 'CMAKE_ARGS=-DMESHIOPLUSPLUS_WITH_HDF5=ON -DMESHIOPLUSPLUS_WITH_NETCDF=ON -DMESHIOPLUSPLUS_WITH_ZLIB=ON' >> "$GITHUB_ENV"
+
+      - name: Configure build (Windows - Python fallbacks)
+        if: runner.os == 'Windows'
+        shell: pwsh
+        run: echo "CMAKE_ARGS=-DMESHIOPLUSPLUS_WITH_HDF5=OFF -DMESHIOPLUSPLUS_WITH_NETCDF=OFF -DMESHIOPLUSPLUS_WITH_ZLIB=OFF" >> $env:GITHUB_ENV
+
+      - name: Install meshio++ and test deps
+        run: |
+          python -m pip install --upgrade pip
+          pip install pytest pytest-codeblocks pytest-cov h5py netCDF4
+          pip install . --verbose
+
+      - name: Run tests
+        run: pytest tests/ --codeblocks --cov meshioplusplus --cov-report xml --cov-report term
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.12' && runner.os == 'Linux'
+        uses: codecov/codecov-action@v4
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+        continue-on-error: true

meshioplusplus-6.0.5/.github/workflows/docs.yml

@@ -0,0 +1,46 @@
+name: docs
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+# Allow the GITHUB_TOKEN to deploy to GitHub Pages.
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# One concurrent Pages deployment; don't cancel an in-progress deploy.
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+      - name: Install and build (VitePress)
+        run: |
+          cd doc
+          npm install
+          npm run docs:build
+      - uses: actions/configure-pages@v5
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: doc/.vitepress/dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

meshioplusplus-6.0.5/.github/workflows/wasm.yml

@@ -0,0 +1,77 @@
+name: wasm
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*"]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+# Cancel superseded runs on the same ref.
+concurrency:
+  group: wasm-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-wasm:
+    name: Build + smoke-test (Emscripten)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        # No submodules: this build always configures with
+        # -DMESHIOPLUSPLUS_WITH_HDF5=OFF (see build/configure-wasm.sh), so the
+        # vendored Eigen submodule (only used by MED, which needs HDF5) would
+        # sit unused -- CMake's EXISTS guard degrades gracefully when it's
+        # absent, same as any other source checkout without submodules.
+
+      - name: Set up Emscripten
+        uses: mymindstorm/setup-emsdk@v14
+        with:
+          # Pinned to the version verified locally; bump deliberately.
+          version: "6.0.3"
+
+      - name: Configure + build (WASM)
+        run: ./build/configure-wasm.sh --build
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Smoke test
+        run: node wasm/test/smoke.mjs
+
+      - name: Package sanity check (npm pack --dry-run)
+        working-directory: wasm
+        run: npm pack --dry-run
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wasm-package
+          path: wasm/
+          if-no-files-found: error
+
+  publish-npm:
+    name: Publish to npm
+    needs: build-wasm
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: npm
+      url: https://www.npmjs.com/package/@meshioplusplus/wasm
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: wasm-package
+          path: wasm
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          registry-url: "https://registry.npmjs.org"
+
+      - name: Publish to npm
+        working-directory: wasm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

meshioplusplus-6.0.5/.github/workflows/wheels.yml

@@ -0,0 +1,117 @@
+name: wheels
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  build_wheels:
+    name: Wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          submodules: recursive  # vendored Eigen (MED transpose)
+
+      - name: Build wheels
+        # v2.21's manylinux alias table predates _2_34, and it hardcodes cp38 for its
+        # own before_all bootstrapping - manylinux_2_34 (AlmaLinux 9) doesn't ship
+        # cp38 (EOL'd Oct 2024), so that probe failed with "No such file or
+        # directory" before the actual build ever started. v3.1.0 added _2_34 alias
+        # support and v4.0.0 dropped cibuildwheel's own cp38 dependency; neither
+        # change affects us since CIBW_BUILD never targets cp38 wheels.
+        uses: pypa/cibuildwheel@v4.1.0
+        env:
+          # Portable wheels: the optional HDF5/netCDF/zlib native paths are
+          # turned OFF, so the only build requirement is a C++20 compiler.
+          # HDF5/netCDF formats and VTU zlib work through the h5py/netCDF4
+          # runtime extras and the stdlib, exactly as the fallback shims intend.
+          # The parallel backend is AUTO -> OpenMP (MSVC's built-in OpenMP on Windows,
+          # libomp on macOS; delvewheel/delocate bundle it automatically). Linux wheels
+          # are forced to SEQ instead - see the manylinux_2_34 comment below.
+          # macOS 13.3+ is required for std::format (its floating-point
+          # formatting symbols live in the OS libc++ dylib).
+          CIBW_BUILD: "cp39-* cp310-* cp311-* cp312-*"
+          CIBW_SKIP: "*-musllinux* *_i686 *-win32"
+          CIBW_ARCHS_MACOS: "x86_64 arm64"
+          # macOS: libomp gives Apple clang an OpenMP runtime (libc++ has no PSTL).
+          CIBW_BEFORE_ALL_MACOS: "brew install libomp"
+          # manylinux2014's stock compiler (devtoolset-10, GCC 10) has no <format>
+          # (needs GCC 13+ per the C++20 std::format requirement above).
+          # manylinux_2_28 (AlmaLinux 8, glibc 2.28) + gcc-toolset-13 was tried first and
+          # never fully worked: even with MESHIOPLUSPLUS_STATIC_RUNTIME, auditwheel still
+          # rejected the wheel for GLIBC_2.32-2.38 symbols pulled directly from
+          # libc.so.6/libm.so.6 - gcc-toolset-13's own runtime calls glibc functions
+          # newer than AlmaLinux 8 ships, and unlike libstdc++, glibc can't be statically
+          # linked out of a normal .so. manylinux_2_34 (AlmaLinux 9, glibc 2.34) is a
+          # much closer match to what gcc-toolset-13 actually targets, but even there
+          # MESHIOPLUSPLUS_STATIC_RUNTIME is still required for the GLIBCXX/CXXABI side
+          # (libstdc++'s SONAME version tracks the compiler, not the target glibc, so
+          # gcc-toolset-13 always wants GLIBCXX_3.4.32 regardless of image).
+          # Verified end-to-end in a real manylinux_2_34 container (build -> `ldd`/
+          # `objdump -T` show zero libstdc++/GLIBCXX/CXXABI deps and GLIBC capped at
+          # 2.34 -> `auditwheel -v repair` succeeds -> installed the repaired wheel into
+          # a clean venv and ran the full pytest suite: 1018 passed).
+          # cibuildwheel v2.21's built-in alias table doesn't include manylinux_2_34
+          # yet (it tried to pull the literal image name "manylinux_2_34" from Docker
+          # Hub and failed) - the full quay.io reference works regardless of alias table.
+          CIBW_MANYLINUX_X86_64_IMAGE: "quay.io/pypa/manylinux_2_34_x86_64"
+          CIBW_MANYLINUX_AARCH64_IMAGE: "quay.io/pypa/manylinux_2_34_aarch64"
+          CIBW_BEFORE_ALL_LINUX: "yum install -y gcc-toolset-13-gcc gcc-toolset-13-gcc-c++"
+          # AUTO's OpenMP preference is forced to SEQ here too: gcc-toolset-13's libgomp
+          # has no static-link option GCC recognizes ("-static-libgomp" isn't a real GCC
+          # flag, unlike -static-libgcc/-static-libstdc++), so it would stay a dynamic
+          # dependency and could still hit a versioned-symbol rejection. These wheels
+          # already trade native HDF5/netCDF/zlib for portability (see above) - SEQ
+          # keeps that trade consistent; TBB/OpenMP builds remain available from source.
+          CIBW_ENVIRONMENT_LINUX: >-
+            CC="/opt/rh/gcc-toolset-13/root/usr/bin/gcc"
+            CXX="/opt/rh/gcc-toolset-13/root/usr/bin/g++"
+            CMAKE_ARGS="-DMESHIOPLUSPLUS_WITH_HDF5=OFF -DMESHIOPLUSPLUS_WITH_NETCDF=OFF -DMESHIOPLUSPLUS_WITH_ZLIB=OFF -DMESHIOPLUSPLUS_PARALLEL_BACKEND=SEQ -DMESHIOPLUSPLUS_STATIC_RUNTIME=ON"
+          # -v surfaces which specific symbol/library trips the manylinux policy check,
+          # instead of auditwheel's generic "too-recent versioned symbols" message.
+          CIBW_REPAIR_WHEEL_COMMAND_LINUX: "auditwheel -v repair -w {dest_dir} {wheel}"
+          CIBW_ENVIRONMENT: >-
+            CMAKE_ARGS="-DMESHIOPLUSPLUS_WITH_HDF5=OFF -DMESHIOPLUSPLUS_WITH_NETCDF=OFF -DMESHIOPLUSPLUS_WITH_ZLIB=OFF"
+            MACOSX_DEPLOYMENT_TARGET="13.3"
+          CIBW_TEST_REQUIRES: "pytest h5py"
+          CIBW_TEST_COMMAND: "python -c \"import meshioplusplus; print(meshioplusplus.__version__, meshioplusplus._core.__parallel_backend__)\""
+
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: ./wheelhouse/*.whl
+
+  build_sdist:
+    name: Source distribution
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build sdist
+        run: pipx run build --sdist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  publish:
+    name: Publish to PyPI
+    needs: [build_wheels, build_sdist]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment:
+      name: pypi
+      url: https://pypi.org/p/meshioplusplus
+    permissions:
+      id-token: write # OIDC trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@release/v1

meshioplusplus-6.0.5/.gitignore

@@ -0,0 +1,48 @@
+*.bin
+*.dat
+*.dato
+*.e
+*.geo
+*.h5
+*.h5m
+*.msh
+*.off
+*.pvtu
+*.pyc
+*.xdmf
+*.xmf
+*.xml
+# The compiled pybind11 extension (built in-place by `pip install -e .` /
+# scikit-build-core editable installs) - a stray committed copy of this once
+# got bundled into every manylinux wheel via wheel.packages, silently
+# reintroducing whatever toolchain built it regardless of the actual CI build.
+src/meshioplusplus/*.so
+src/meshioplusplus/*.pyd
+.cache/
+MANIFEST
+README.rst
+# Ignore build artifacts but keep the tracked configure scripts
+# (an ignored *directory* cannot have re-included children, so use build/*).
+build/*
+!build/configure.sh
+!build/configure.bat
+!build/configure-wasm.sh
+build-tests/
+build-omp/
+build-tbb/
+# Emscripten build output copied into the npm package staging dir -- built by
+# build/configure-wasm.sh, not committed (mirrors build/* above).
+wasm/dist/
+# CMake FetchContent downloads (e.g. GoogleTest) land here inside a build dir
+_deps/
+dist/
+doc/_build/
+*.egg-info/
+.pytest_cache/
+.coverage
+.tox/
+foo.vtk
+.vscode/*
+!.vscode/tasks.json
+# Jupyter
+.ipynb_checkpoints/

meshioplusplus-6.0.5/.gitmodules

@@ -0,0 +1,3 @@
+[submodule "cpp/third_party/eigen"]
+	path = cpp/third_party/eigen
+	url = https://gitlab.com/libeigen/eigen.git

meshioplusplus-6.0.5/.pre-commit-config.yaml

@@ -0,0 +1,16 @@
+repos:
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.13.2
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/psf/black
+    rev: 24.1.1
+    hooks:
+      - id: black
+        language_version: python3
+
+  - repo: https://github.com/PyCQA/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8

meshioplusplus-6.0.5/.vscode/tasks.json

@@ -0,0 +1,69 @@
+{
+  // See https://go.microsoft.com/fwlink/?LinkId=733558
+  // for the documentation about the tasks.json format
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "label": "Build: Python extension (editable install)",
+      "detail": "Rebuild meshioplusplus._core in-place (uv venv, HDF5+zlib on; netCDF off — this machine's static libnetcdf.a fails to link against OpenMPI HDF5).",
+      "type": "shell",
+      "command": "CMAKE_ARGS=\"-DMESHIOPLUSPLUS_WITH_HDF5=ON -DMESHIOPLUSPLUS_WITH_NETCDF=OFF -DMESHIOPLUSPLUS_WITH_ZLIB=ON\" uv pip install --python .venv --no-build-isolation -e .",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "problemMatcher": ["$gcc"]
+    },
+    {
+      "label": "Test: pytest (all)",
+      "detail": "Run the full Python test suite.",
+      "type": "shell",
+      "command": ".venv/bin/pytest tests/ -q",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": {
+        "kind": "test",
+        "isDefault": true
+      },
+      "problemMatcher": []
+    },
+    {
+      "label": "Test: pytest (current file)",
+      "detail": "Run pytest on the file open in the active editor.",
+      "type": "shell",
+      "command": ".venv/bin/pytest '${file}' -q",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": "test",
+      "problemMatcher": []
+    },
+    {
+      "label": "C++: Configure + build tests",
+      "detail": "Configure (OpenMP backend, netCDF off — see Python build task note) and build the GoogleTest suite into build/cpp-release.",
+      "type": "shell",
+      "command": "./build/configure.sh --backend OPENMP --tests --build --without-netcdf",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": "build",
+      "problemMatcher": ["$gcc"]
+    },
+    {
+      "label": "C++: Run tests (ctest)",
+      "detail": "Run the GoogleTest/CTest suite (requires 'C++: Configure + build tests' first).",
+      "type": "shell",
+      "command": "ctest --test-dir build/cpp-release --output-on-failure",
+      "options": {
+        "cwd": "${workspaceFolder}"
+      },
+      "group": "test",
+      "problemMatcher": [],
+      "dependsOn": ["C++: Configure + build tests"]
+    }
+  ]
+}