Merge pull request #174 from IntelPython/use-meson-build

Move build system to `meson-python`

Author: antonwolfy

.github/AGENTS.md

@@ -4,7 +4,10 @@ CI/CD workflows, automation, security scanning, and package distribution.
 
 ## Workflows
 - **conda-package.yml** — main build/test pipeline (Linux/Windows, Python 3.10-3.14)
+- **conda-package-cf.yml** — build/test using only conda-forge channel (Linux/Windows, Python 3.10-3.14)
 - **build-with-clang.yml** — Linux Clang compiler compatibility validation
+- **build-with-standard-clang.yml** — standard Clang compiler compatibility validation
+- **build_pip.yml** — validates editable build
 - **pre-commit.yml** — code quality checks (flake8, etc.)
 - **openssf-scorecard.yml** — security posture scanning
 

.github/copilot-instructions.md

@@ -34,10 +34,10 @@ Higher-precedence file overrides; lower must not restate overridden guidance.
 - Never include secrets/tokens/credentials in files.
 
 ## Source-of-truth files
-- Build/config: `pyproject.toml`, `setup.py`
+- Build/config: `pyproject.toml`, `meson.build`
 - Recipe/deps: `conda-recipe/meta.yaml`, `conda-recipe/conda_build_config.yaml`
 - CI: `.github/workflows/*.{yml,yaml}`
-- API contracts: `mkl/__init__.py`, `mkl/_mkl_service.pyx`
+- API contracts: `mkl/__init__.py`, `mkl/_py_mkl_service.pyx`
 - Tests: `mkl/tests/test_mkl_service.py`
 
 ## MKL-specific constraints

.github/workflows/build-with-clang.yml

@@ -14,7 +14,7 @@ jobs:
 
     strategy:
       matrix:
-        python: ["3.10", "3.11", "3.12", "3.13"]
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
 
     env:
       ONEAPI_ROOT: /opt/intel/oneapi
@@ -37,10 +37,9 @@ jobs:
           sudo add-apt-repository "deb https://apt.repos.intel.com/oneapi all main"
           sudo apt-get update
 
-      - name: Install Intel OneAPI
+      - name: Install Intel oneAPI
         run: |
           sudo apt-get install intel-oneapi-compiler-dpcpp-cpp
-          sudo apt-get install intel-oneapi-tbb
           sudo apt-get install intel-oneapi-mkl-devel
 
       - name: Setup Python
@@ -55,12 +54,8 @@ jobs:
           fetch-depth: 0
 
       - name: Install mkl-service dependencies
-        uses: BSFishy/pip-action@8f2d471d809dc20b6ada98c91910b6ae6243f318 # v1
-        with:
-          packages: |
-            cython
-            setuptools>=77
-            pytest
+        run: |
+          pip install meson-python cython cmake ninja
 
       - name: List oneAPI folder content
         run: ls ${{ env.ONEAPI_ROOT }}/compiler
@@ -71,9 +66,10 @@ jobs:
           echo "$CMPLR_ROOT"
           export CC="$CMPLR_ROOT/bin/icx"
           export CFLAGS="${CFLAGS} -fno-fast-math"
-          python setup.py develop
+          pip install . --no-build-isolation --no-deps --verbose
 
       - name: Run mkl-service tests
         run: |
           source ${{ env.ONEAPI_ROOT }}/setvars.sh
+          pip install pytest
           pytest -s -v --pyargs mkl

.github/workflows/build-with-standard-clang.yml

@@ -0,0 +1,56 @@
+name: Build project with standard clang compiler
+
+on:
+  pull_request:
+  push:
+    branches: [master]
+
+permissions: read-all
+
+jobs:
+  build-with-standard-clang:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    env:
+      COMPILER_ROOT: /usr/bin
+
+    defaults:
+      run:
+        shell: bash -el {0}
+
+    steps:
+      - name: Cancel Previous Runs
+        uses: styfle/cancel-workflow-action@3155a141048f8f89c06b4cdae32e7853e97536bc # 0.13.0
+        with:
+          access_token: ${{ github.token }}
+
+      - name: Install Dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y clang
+
+      - name: Setup Python
+        uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: ${{ matrix.python }}
+          architecture: x64
+
+      - name: Checkout repo
+        uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+
+      - name: Install mkl-service dependencies
+        run: |
+          pip install meson-python cython cmake ninja mkl-devel
+
+      - name: Build mkl-service
+        run: |
+          export CC=${{ env.COMPILER_ROOT }}/clang
+          pip install -e ".[test]" --no-build-isolation --verbose
+          pip list
+          python -m pytest -v mkl/tests

.github/workflows/build_pip.yml

@@ -0,0 +1,43 @@
+name: Editable build using pip
+
+on:
+  push:
+    branches:
+      - master
+  pull_request:
+
+permissions: read-all
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        shell: bash -el {0}
+
+    strategy:
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          fetch-depth: 0
+
+      - uses: conda-incubator/setup-miniconda@fc2d68f6413eb2d87b895e92f8584b5b94a10167 # v3.3.0
+        with:
+          miniforge-version: latest
+          channels: conda-forge
+          activate-environment: test
+          python-version: ${{ matrix.python }}
+
+      - name: Install MKL
+        run: |
+          conda install mkl-devel mkl
+
+      - name: Build with pip
+        run: |
+          pip install --no-cache-dir meson-python ninja cmake cython
+          pip install -e ".[test]" --no-build-isolation --verbose
+          pip list
+          python -m pytest -v mkl/tests

.github/workflows/conda-package-cf.yml

@@ -59,7 +59,6 @@ jobs:
         shell: bash -el {0}
         run: |
           echo "CONDA_BLD=/usr/share/miniconda/conda-bld/linux-64/" >> "$GITHUB_ENV"
-          echo "WHEELS_OUTPUT_FOLDER=$GITHUB_WORKSPACE/" >> "$GITHUB_ENV"
 
       - name: Build conda package
         run: |
@@ -79,12 +78,6 @@ jobs:
           name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }}
           path: ${{ env.CONDA_BLD }}${{ env.PACKAGE_NAME }}-*.conda
 
-      - name: Upload wheels artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Wheels Python ${{ matrix.python }}
-          path: ${{ env.WHEELS_OUTPUT_FOLDER }}mkl_service-*.whl
-
   build_windows:
     runs-on: windows-latest
 
@@ -132,7 +125,6 @@ jobs:
         shell: bash -el {0}
         run: |
           echo "CONDA_BLD=$CONDA\\conda-bld\\win-64\\" >> "$GITHUB_ENV"
-          echo "WHEELS_OUTPUT_FOLDER=$GITHUB_WORKSPACE\\" >> "$GITHUB_ENV"
 
       - name: Show Conda info
         run: |
@@ -151,12 +143,6 @@ jobs:
           name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }}
           path: ${{ env.CONDA_BLD }}${{ env.PACKAGE_NAME }}-*.conda
 
-      - name: Upload wheels artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Wheels Python ${{ matrix.python }}
-          path: ${{ env.WHEELS_OUTPUT_FOLDER }}mkl_service-*.whl
-
   test_linux:
     needs: build_linux
     runs-on:  ${{ matrix.runner }}
@@ -359,7 +345,6 @@ jobs:
         shell: bash -el {0}
         run: |
           echo "CONDA_BLD=$CONDA/conda-bld/osx-64/" >> "$GITHUB_ENV"
-          echo "WHEELS_OUTPUT_FOLDER=$GITHUB_WORKSPACE/" >> "$GITHUB_ENV"
 
       - name: Build conda package
         shell: bash -el {0}
@@ -380,12 +365,6 @@ jobs:
           name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Python ${{ matrix.python }}
           path: ${{ env.CONDA_BLD }}${{ env.PACKAGE_NAME }}-*.conda
 
-      - name: Upload wheels artifact
-        uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
-        with:
-          name: ${{ env.PACKAGE_NAME }} ${{ runner.os }} Wheels Python ${{ matrix.python }}
-          path: ${{ env.WHEELS_OUTPUT_FOLDER }}mkl_service-*.whl
-
   test_osx:
     needs: build_osx
     runs-on: ${{ matrix.runner }}

AGENTS.md

@@ -15,29 +15,44 @@ Originally part of Intel® Distribution for Python*, now a standalone package av
 
 ## Key components
 - **Python interface:** `mkl/__init__.py` — public API surface
-- **Cython wrapper:** `mkl/_mkl_service.pyx` — wraps MKL support functions
+- **Cython wrapper:** `mkl/_py_mkl_service.pyx` — wraps MKL support functions
 - **C init module:** `mkl/_mklinitmodule.c` — Linux-side MKL runtime preloading / initialization
 - **Helper:** `mkl/_init_helper.py` — Windows venv DLL loading helper
-- **Build system:** setuptools + Cython
+- **Build system:** meson-python + Cython
 
 ## Build dependencies
 **Required:**
 - Intel® oneMKL
+- meson-python
+- CMake
+- Ninja
 - Cython
 - Python 3.10+
 
-**Conda environment:**
+**Build against an existing `mkl` installation:**
+
+Install the build dependencies via Conda:
+```bash
+conda install -c conda-forge mkl-devel cython meson-python cmake ninja
+```
+or via pip:
+```bash
+python -m pip install mkl-devel cython meson-python cmake ninja
+```
+then build without pulling a fresh `mkl` into an isolated build:
 ```bash
-conda install -c conda-forge mkl-devel cython
-python setup.py install
+python -m pip install --no-deps --no-build-isolation .
 ```
 
 ## CI/CD
 - **Platforms in CI workflows:** Linux, Windows
 - **Python versions:** 3.10, 3.11, 3.12, 3.13, 3.14
 - **Workflows:** `.github/workflows/`
   - `conda-package.yml` — main conda build/test pipeline
+  - `conda-package-cf.yml` — conda build/test using only conda-forge channel
   - `build-with-clang.yml` — Linux Clang compatibility
+  - `build-with-standard-clang.yml` — standard Clang compiler compatibility validation
+  - `build_pip.yml` — validates editable build
   - `pre-commit.yml` — code quality checks
   - `openssf-scorecard.yml` — security scanning
 
@@ -61,15 +76,16 @@ mkl.get_version_string()             # MKL version info
 - **Docs:** MKL support functions documented in [Intel oneMKL Developer Reference](https://www.intel.com/content/www/us/en/docs/onemkl/developer-reference-c/2025-2/support-functions.html)
 
 ## Code structure
-- **Cython layer:** `_mkl_service.pyx` + `_mkl_service.pxd` (C declarations)
+- **Cython layer:** `_py_mkl_service.pyx` + `_mkl_service.pxd` (C declarations)
 - **C init:** `_mklinitmodule.c` handles Linux preloading (`dlopen(..., RTLD_GLOBAL)`) for MKL runtime
 - **Windows loading helper:** `_init_helper.py` handles DLL path setup in Windows venv
 - **Python wrapper:** `__init__.py` imports `_py_mkl_service` (generated from `.pyx`)
-- **Version:** `_version.py` (dynamic via setuptools)
+- **Version:** `_version.py`
 
 ## Notes
 - RTLD_GLOBAL preloading is required on Linux (handled by `RTLD_for_MKL` context manager)
 - MKL must be available at runtime (conda: mkl, pip: relies on system MKL)
+- Do **not** add `mkl` to `[project].dependencies` in `pyproject.toml` (its PyPI wheel lacks `.dist-info`, which breaks `pip check`).
 - Threading functions affect NumPy, SciPy, and other MKL-backed libraries
 
 ## Directory map
@@ -85,4 +101,6 @@ Below directories have local `AGENTS.md` for deeper context:
 For broader IntelPython ecosystem context, see:
 - `mkl_umath` (MKL-backed NumPy ufuncs)
 - `mkl_random` (MKL-based random number generation)
+- `mkl_fft` (MKL-based fast fourier transform functions)
 - `dpnp` (Data Parallel NumPy)
+- `dpctl` (Data Parallel Control)

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 ### Changed
+* Migrated the build system from `setuptools` to `meson-python`, removing `setup.py` in favor of `meson.build` [gh-174](https://github.com/IntelPython/mkl-service/pull/174)
 
 ### Fixed
 

README.md

@@ -29,3 +29,28 @@ A short example, illustrating its use:
 ```
 
 For more information about the usage of support functions see [Developer Reference for Intel® oneAPI Math Kernel Library for C](https://www.intel.com/content/www/us/en/docs/onemkl/developer-reference-c/2025-2/support-functions.html).
+
+---
+
+## Building
+
+A C compiler and Intel(R) oneAPI Math Kernel Library (oneMKL) are required to build mkl-service from source.
+
+Executing
+```sh
+python -m pip install .
+```
+
+will pull in the required build dependencies, including `mkl`, and build `mkl-service`.
+
+If you already have `mkl` installed (from your system or a Conda environment) and
+want to reuse it instead of pulling a fresh copy into an isolated build, first
+install the build dependencies:
+```sh
+python -m pip install mkl-devel meson-python cmake ninja cython
+```
+
+then build against the existing installation with:
+```sh
+python -m pip install --no-build-isolation --no-deps .
+```

conda-recipe-cf/bld.bat

@@ -1,5 +1,4 @@
 @rem Remember to activate Intel Compiler, or remove these two lines to use Microsoft Visual Studio compiler
 
-set MKLROOT=%PREFIX%
-%PYTHON% setup.py build --force install --old-and-unmanageable
+%PYTHON% -m pip install --no-deps --no-build-isolation .
 if errorlevel 1 exit 1