Migrate to meson build system with bundled PPL 1.2

- Replace setuptools with meson-python build backend
- Bundle PPL 1.2 source in subprojects/ppl-1.2/
- Compile PPL as static library with C++23 standard
- Fix std::auto_ptr -> std::unique_ptr for C++23 compatibility
- Fix deprecated std::iterator inheritance in PPL headers
- Add meson.build files for root project, PPL subproject, ppl/ extensions, and tests/
- Add ppl-config.h.mesondefine for meson feature detection
- Register all tests (doctests, unittest, Cython integration) via meson test
- Update all GitHub Actions workflows (test, doc, dist) for meson build
- Remove external PPL dependency from environment files
- Use trusted publishing for PyPI uploads
- Simplify cibuildwheel config (PPL bundled, only need system GMP)

Author: cxzhong

.github/workflows/dist.yml

@@ -2,123 +2,99 @@ name: Distributions
 
 on:
   push:
+    branches: [ "master", "meson" ]
+    tags: [ "*" ]
   pull_request:
   workflow_dispatch:
 
 concurrency:
-  # Cancel previous runs of this workflow for the same branch
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 jobs:
 
-  sdists_for_pypi:
-    name: Build sdist (and upload to PyPI on release tags)
+  sdist:
+    name: Build sdist
     runs-on: ubuntu-latest
-    env:
-      CAN_DEPLOY: ${{ secrets.SAGEMATH_PYPI_API_TOKEN != '' }}
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-python@v4
-      - name: make sdist
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install system dependencies
         run: |
-          python3 -m pip install build
-          python3 -m build --sdist
+          sudo apt-get update
+          sudo apt-get install -y libgmp-dev libmpfr-dev libmpc-dev
+
+      - name: Build sdist
+        run: |
+          pip install build
+          python -m build --sdist
+
       - uses: actions/upload-artifact@v5
         with:
-          path: "dist/*.tar.gz"
-          name: dist
-      - uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          user: __token__
-          password: ${{ secrets.SAGEMATH_PYPI_API_TOKEN }}
-          skip_existing: true
-          verbose: true
-        if: env.CAN_DEPLOY == 'true' && github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
+          name: dist-sdist
+          path: dist/*.tar.gz
 
   build_wheels:
     name: Build wheels on ${{ matrix.os }}
     runs-on: ${{ matrix.os }}
-    needs: sdists_for_pypi
+    needs: sdist
     strategy:
       fail-fast: false
       matrix:
         os:
           - ubuntu-latest
           - macos-latest
           - ubuntu-24.04-arm
-          - macos-15-intel
     env:
-      # SPKGs to install as system packages
-      SPKGS: _bootstrap _prereq gmp mpfr mpc
-      # Non-Python packages to install as spkgs
-      TARGETS_PRE: gmp mpfr mpc ppl-ensure
-      # Environment during wheel build
-      CIBW_ENVIRONMENT: "PATH=$(pwd)/local/bin:$PATH CPATH=$(pwd)/local/include:$CPATH LIBRARY_PATH=$(pwd)/local/lib:$LIBRARY_PATH LD_LIBRARY_PATH=$(pwd)/local/lib:$LD_LIBRARY_PATH PKG_CONFIG_PATH=$(pwd)/local/share/pkgconfig:$PKG_CONFIG_PATH ACLOCAL_PATH=/usr/share/aclocal"
-      # Use 'build', not 'pip wheel'
+      CIBW_BUILD: "cp312-* cp313-* cp314-*"
+      CIBW_SKIP: "*-musllinux*"
+      CIBW_BEFORE_BUILD_LINUX: >-
+        yum install -y gmp-devel || apt-get install -y libgmp-dev
+      CIBW_BEFORE_BUILD_MACOS: >-
+        brew install gmp
+      CIBW_ENVIRONMENT_MACOS: >-
+        CPATH=$(brew --prefix gmp)/include:$CPATH
+        LIBRARY_PATH=$(brew --prefix gmp)/lib:$LIBRARY_PATH
       CIBW_BUILD_FRONTEND: build
+      CIBW_TEST_COMMAND: >-
+        python {project}/tests/runtests.py
     steps:
       - uses: actions/checkout@v4
-        with:
-          repository:   sagemath/sage
-          ref:          develop
-
-      - uses: actions/download-artifact@v6
-        with:
-          name: dist
-          path: dist
 
       - uses: actions/setup-python@v5
-        # As of 2024-02-03, the macOS M1 runners do not have preinstalled python or pipx.
-        # Installing pipx follows the approach of https://github.com/pypa/cibuildwheel/pull/1743
-        id: python
         with:
-          python-version: "3.12 - 3.14"
-          update-environment: false
+          python-version: "3.13"
 
-      - name: Build platform wheels
-        # We build the wheel from the sdist.
-        # But we must run cibuildwheel with the unpacked source directory, not a tarball,
-        # so that SAGE_ROOT is copied into the build containers.
-        #
-        # In the CIBW_BEFORE_ALL phase, we install libraries using the Sage distribution.
-        # https://cibuildwheel.readthedocs.io/en/stable/options/#before-all
-        run: |
-          "${{ steps.python.outputs.python-path }}" -m pip install pipx
-          export PATH=build/bin:$PATH
-          export CIBW_BEFORE_ALL="( $(sage-print-system-package-command debian --yes --no-install-recommends install $(sage-get-system-packages debian $SPKGS)) || $(sage-print-system-package-command fedora --yes --no-install-recommends install $(sage-get-system-packages fedora $SPKGS | sed s/pkg-config/pkgconfig/)) || ( $(sage-print-system-package-command homebrew --yes --no-install-recommends install $(sage-get-system-packages homebrew $SPKGS)) || $(sage-print-system-package-command alpine --yes --no-install-recommends install $(sage-get-system-packages alpine $SPKGS)) || echo error ignored) ) && ./bootstrap && ./configure --enable-build-as-root --enable-fat-binary --disable-meson-check --disable-boost && MAKE=\"make -j6\" make V=0 $TARGETS_PRE"
-          mkdir -p unpacked
-          for pkg in pplpy; do
-              (cd unpacked && tar xfz - ) < dist/$pkg*.tar.gz
-              "${{ steps.python.outputs.python-path }}" -m pipx run cibuildwheel==3.2.1 unpacked/$pkg*
-          done
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.23
+        with:
+          output-dir: wheelhouse
 
       - uses: actions/upload-artifact@v5
         with:
           name: wheels-${{ matrix.os }}
           path: ./wheelhouse/*.whl
 
-  pypi-publish:
-    # https://github.com/pypa/gh-action-pypi-publish
-    name: Upload wheels to PyPI
-    needs: build_wheels
+  pypi_publish:
+    name: Upload to PyPI
+    needs: [sdist, build_wheels]
     if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags')
     runs-on: ubuntu-latest
-    env:
-      CAN_DEPLOY: ${{ secrets.SAGEMATH_PYPI_API_TOKEN != '' }}
+    environment: pypi
+    permissions:
+      id-token: write
     steps:
-
       - uses: actions/download-artifact@v6
         with:
-          name: wheels
-          path: wheelhouse
+          path: dist
+          merge-multiple: true
 
-      - name: Publish package distributions to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
+      - uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          user: __token__
-          password: ${{ secrets.SAGEMATH_PYPI_API_TOKEN }}
-          packages_dir: wheelhouse/
-          skip_existing: true
+          packages-dir: dist/
+          skip-existing: true
           verbose: true
-        if: env.CAN_DEPLOY == 'true'

.github/workflows/doc.yml

@@ -1,6 +1,6 @@
 name: Documentation
 on:
-  push: { branches: [ "master" ] }
+  push: { branches: [ "master", "meson" ] }
   pull_request: { branches: [ "master" ] }
 
 concurrency:
@@ -11,40 +11,47 @@ jobs:
   build-manual:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
-        with: { submodules: recursive }
-      - uses: conda-incubator/setup-miniconda@v2
-        with: { miniforge-variant: "Mambaforge", miniforge-version: "latest" }
-      - name: Install pplpy dependencies
-        shell: bash -l {0}
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install system dependencies
         run: |
-          mamba env update --quiet -n test -f environment.yml
-          conda list
+          sudo apt-get update
+          sudo apt-get install -y libgmp-dev libmpfr-dev libmpc-dev
+
+      - name: Install Python build dependencies
+        run: |
+          pip install --upgrade pip
+          pip install meson-python meson ninja cython cysignals "gmpy2>=2.1.0b1"
+
       - name: Install pplpy
-        shell: bash -l {0}
         run: |
-          pip install --verbose --no-index --no-build-isolation .
-      - name: Install test dependencies
+          pip install --no-build-isolation --verbose .
+
+      - name: Install doc dependencies
         run: |
-          mamba env update --quiet -n test -f environment.test.yml
-          conda list
+          pip install sphinx linkchecker
+
       - name: Build documentation
-        shell: bash -l {0}
-        run:
+        run: |
           sphinx-build docs/source html/pplpy
+
       - name: Detect broken links
-        shell: bash -l {0}
         run: |
           python -m http.server 8880 --directory html &
           sleep 1
           # We ignore _modules since sphinx puts all modules in the module
           # overview but does not generate pages for .pyx modules.
-          # We also ignore a url that is generated by sphinx itself (version 7.2.6).
+          # We also ignore a url that is generated by sphinx itself.
           linkchecker --check-extern --ignore-url='_modules/|https://www.sphinx-doc.org/' http://localhost:8880
-      - uses: JamesIves/github-pages-deploy-action@3.7.1
+
+      - uses: JamesIves/github-pages-deploy-action@v4
         with:
-          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-          BRANCH: gh-pages
-          FOLDER: html/pplpy/
-          TARGET_FOLDER: docs/
+          token: ${{ secrets.GITHUB_TOKEN }}
+          branch: gh-pages
+          folder: html/pplpy/
+          target-folder: docs/
         if: ${{ github.event_name == 'push' }}

.github/workflows/test.yml

@@ -1,6 +1,6 @@
 name: Test
 on:
-  push: { branches: [ "master" ] }
+  push: { branches: [ "master", "meson" ] }
   pull_request: { branches: [ "master" ] }
 
 concurrency:
@@ -15,45 +15,43 @@ jobs:
       matrix:
         python: ["3.12", "3.13", "3.14"]
     steps:
-      - uses: actions/checkout@v2
-        with: { submodules: recursive }
+      - uses: actions/checkout@v4
 
-      - name: Setup Conda environment
-        uses: conda-incubator/setup-miniconda@v3
+      - uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.python }}
-          # Disabled for now due to
-          # https://github.com/conda-incubator/setup-miniconda/issues/379
-          # miniforge-version: latest
-          use-mamba: true
-          channels: conda-forge
-          channel-priority: true
-
-      - name: Install dependencies
-        shell: bash -l {0}
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libgmp-dev libmpfr-dev libmpc-dev
+
+      - name: Install Python build dependencies
         run: |
-          conda install --quiet ppl gmp mpfr mpc
+          pip install --upgrade pip
+          pip install meson-python meson ninja cython cysignals "gmpy2>=2.1.0b1"
 
-      - name: Build
-        shell: bash -l {0}
+      - name: Build and install
         run: |
-          pip install --verbose .
+          pip install --no-build-isolation --verbose .
 
       - name: Install test dependencies
         run: |
-          conda env update --quiet -n test -f environment.test.yml
-          conda list
+          pip install sphinx cython-lint
 
       - name: Lint
-        shell: bash -l {0}
         run: |
           cython-lint --ignore=E265,E266,E501,E741 --exclude='ppl_decl.pxd' ppl/
 
-      - name: Run tests
-        shell: bash -l {0}
+      - name: Build (meson)
+        run: |
+          meson setup builddir
+          meson compile -C builddir
+
+      - name: Test (meson test)
         run: |
-          python setup.py test
+          meson test -C builddir -v
 
       - name: Show logs
-        run: grep "" /dev/null `find -name '*.log'` || true
+        run: cat builddir/meson-logs/testlog.txt || true
         if: ${{ always() }}

environment.test.yml

@@ -5,7 +5,6 @@ channels:
 dependencies:
   - sphinx
   - pip
-  - setuptools
   - pip:
     - linkchecker
-    - cython-lint 
+    - cython-lint

environment.yml

@@ -3,8 +3,8 @@ channels:
   - conda-forge
   - defaults
 dependencies:
-  - setuptools
+  - meson
+  - meson-python
   - gmpy2
   - cysignals
   - cython
-  - ppl

meson.build

@@ -0,0 +1,19 @@
+project('pplpy', 'cpp', 'cython',
+  version: '0.8.10',
+  default_options: [
+    'cpp_std=c++23',
+  ],
+)
+
+# ---------- Python ----------
+py = import('python').find_installation(pure: false)
+
+# ---------- PPL (bundled subproject) ----------
+ppl_proj = subproject('ppl-1.2')
+ppl_dep = ppl_proj.get_variable('ppl_dep')
+
+# ---------- Build the ppl package ----------
+subdir('ppl')
+
+# ---------- Tests ----------
+subdir('tests')