Migrate the build system to Meson/meson-python (#301)

Co-authored-by: Ülgen Sarıkavak <ulgensrkvk@gmail.com>

Author: agriyakhetarpal

.github/workflows/cd.yml

@@ -91,7 +91,7 @@ jobs:
           path: ./wheelhouse/*.whl
           if-no-files-found: error
 
-  windows_arm64_wheels: # Not tested
+  windows_arm64_wheels: # TODO: for later: use windows-11-arm runners as they're available now
     name: arm64-windows
     runs-on: windows-latest
     permissions:
@@ -108,21 +108,25 @@ jobs:
           cache: false
           check-latest: true
 
+      - name: Resolve Windows Meson cross file
+        id: meson-cross-file
+        shell: pwsh
+        run: |
+          $crossFile = (Resolve-Path (Join-Path $env:GITHUB_WORKSPACE 'meson_cross_files/windows-arm64.ini')).Path -replace '\\', '/'
+          "path=$crossFile" >> $env:GITHUB_OUTPUT
+
       - name: Build binary distribution (wheel) on Windows (arm64)
         # We need to use cibuildwheel because it has experimental support for cross-compiling
         # to arm64 and setup-python does not have arm64 support on Windows right now
         uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084 # v3.4.1
         with:
           package-dir: .
           output-dir: wheelhouse
-        # Cross-compile for arm64 target via Zig toolchain
         env:
-          USE_ZIG: "1"
-          GOOS: windows
-          GOARCH: arm64
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS_WINDOWS: ARM64
           CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+          CIBW_CONFIG_SETTINGS_WINDOWS: "setup-args=--cross-file=${{ steps.meson-cross-file.outputs.path }}"
           CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: delvewheel repair -w {dest_dir} {wheel}
           CIBW_TEST_SKIP: "*-win_arm64"
 
@@ -149,21 +153,23 @@ jobs:
           go-version: "1.26.1"
           cache: false
 
-        # Note: cibuildwheel will manage installing 32-bit Python on Windows. We
-        # do not need to do that manually unless we use setup-python instead.
+      - name: Resolve Windows Meson cross file
+        id: meson-cross-file
+        shell: pwsh
+        run: |
+          $crossFile = (Resolve-Path (Join-Path $env:GITHUB_WORKSPACE 'meson_cross_files/windows-386.ini')).Path -replace '\\', '/'
+          "path=$crossFile" >> $env:GITHUB_OUTPUT
+
       - name: Build binary distribution (wheel) on Windows (i686)
         uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084 # v3.4.1
         with:
           package-dir: .
           output-dir: wheelhouse
-        # Cross-compile for i686 target via Zig toolchain
         env:
-          USE_ZIG: "1"
-          GOOS: windows
-          GOARCH: 386
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS_WINDOWS: x86
           CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+          CIBW_CONFIG_SETTINGS_WINDOWS: "setup-args=--cross-file=${{ steps.meson-cross-file.outputs.path }}"
           CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: delvewheel repair -w {dest_dir} {wheel}
           CIBW_TEST_COMMAND: |
             hugo version

.github/workflows/ci.yml

@@ -35,6 +35,42 @@ jobs:
       - name: Run style checks
         uses: j178/prek-action@6ad80277337ad479fe43bd70701c3f7f8aa74db3 # v2.0.3
 
+  editable_install:
+    needs: [style]
+    name: editable-install-smoke
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - uses: actions/checkout@de0fac2e4500dabe0009e67214ff5f5447ce83dd # v6.0.2
+        with:
+          persist-credentials: false
+          submodules: recursive
+
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+        with:
+          python-version: "3.14"
+
+      - name: Set up Go toolchain
+        id: setup-go
+        uses: actions/setup-go@4a3601121dd01d1626a1e23e37211e3254c1c06c # v6.4.0
+        with:
+          go-version: "1.26.1"
+          cache: false
+          check-latest: true
+
+      - name: Restore Hugo builder cache
+        uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
+        with:
+          path: ~/.cache/hugo-go
+          key: editable-install-hugo-${{ runner.os }}-${{ steps.setup-go.outputs.go-version }}
+
+      - name: Install Python dependencies
+        run: python -m pip install nox[uv]
+
+      - name: Smoke test editable install entry points
+        run: nox -s editable
+
   build_wheels:
     needs: [style]
     name: ${{ matrix.runs-on }}-python-${{ matrix.python-version }}
@@ -79,7 +115,7 @@ jobs:
       - name: Restore Hugo builder cache
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ./hugo_cache/
+          path: ~/.cache/hugo-go
           key: ${{ matrix.runs-on }}-hugo-${{ steps.setup-go.outputs.go-version }}
 
       - name: Install Python dependencies
@@ -136,40 +172,41 @@ jobs:
       - name: Restore Hugo builder cache
         uses: actions/cache@27d5ce7f107fe9357f9df03efb73ab90386fccae # v5.0.5
         with:
-          path: ./hugo_cache/
+          path: ~/.cache/hugo-go
           key: zig-${{ matrix.runs-on }}-${{ matrix.architecture}}-hugo-experimental-${{ steps.setup-go.outputs.go-version }}
 
       - name: Install Python dependencies
         run: python -m pip install build virtualenv nox auditwheel
 
       - name: Build binary distribution (wheel) on Linux
         if: matrix.runs-on == 'ubuntu-latest'
-        # Cross-compile for arm64 target via Zig toolchain
-        env:
-          USE_ZIG: 1
-          GOOS: linux
-          GOARCH: arm64
-        run: |
-          python -m build --wheel . --outdir wheelhouse/
+        run: python -m build --wheel . --outdir wheelhouse -Csetup-args=--cross-file="$GITHUB_WORKSPACE/meson_cross_files/linux-arm64.ini"
         # can't repair arm64 wheels on Linux x86_64 right now
         # auditwheel repair --plat manylinux_2_28_aarch64 -w wheelhouse/ dist/*.whl
 
+      - name: Resolve Windows Meson cross file
+        if: matrix.runs-on == 'windows-latest'
+        id: meson-cross-file
+        shell: pwsh
+        env:
+          MATRIX_ARCH: ${{ matrix.architecture }}
+        run: |
+          $crossFileName = if ($env:MATRIX_ARCH -eq 'arm64') { 'windows-arm64.ini' } else { 'windows-386.ini' }
+          $crossFile = (Resolve-Path (Join-Path $env:GITHUB_WORKSPACE "meson_cross_files/$crossFileName")).Path -replace '\\', '/'
+          "path=$crossFile" >> $env:GITHUB_OUTPUT
+
       - name: Build binary distribution (wheel) on Windows (arm64)
         if: matrix.runs-on == 'windows-latest' && matrix.architecture == 'arm64'
-        # We need to use cibuildwheel because it has experimental support for cross-compiling
-        # to arm64 and setup-python does not have arm64 support on Windows right now
+        # TODO: FIXME: use windows-11-arm runners as they're available now, and drop this
         uses: pypa/cibuildwheel@8d2b08b68458a16aeb24b64e68a09ab1c8e82084 # v3.4.1
         with:
           package-dir: .
           output-dir: wheelhouse
-        # Cross-compile for arm64 target via Zig toolchain
         env:
-          USE_ZIG: "1"
-          GOOS: windows
-          GOARCH: arm64
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS_WINDOWS: ARM64
           CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+          CIBW_CONFIG_SETTINGS_WINDOWS: "setup-args=--cross-file=${{ steps.meson-cross-file.outputs.path }}"
           CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: delvewheel repair -w {dest_dir} {wheel}
           CIBW_TEST_SKIP: "*-win_arm64"
 
@@ -181,14 +218,11 @@ jobs:
         with:
           package-dir: .
           output-dir: wheelhouse
-        # Cross-compile for i686 target via Zig toolchain
         env:
-          USE_ZIG: "1"
-          GOOS: windows
-          GOARCH: 386
           CIBW_BUILD: "cp312-*"
           CIBW_ARCHS_WINDOWS: x86
           CIBW_BEFORE_BUILD_WINDOWS: "pip install delvewheel"
+          CIBW_CONFIG_SETTINGS_WINDOWS: "setup-args=--cross-file=${{ steps.meson-cross-file.outputs.path }}"
           CIBW_REPAIR_WHEEL_COMMAND_WINDOWS: delvewheel repair -w {dest_dir} {wheel}
           CIBW_TEST_COMMAND: |
             hugo version

.github/workflows/update-hugo.yml

@@ -27,7 +27,7 @@ jobs:
         run: |
           set -euo pipefail
 
-          CURRENT_VERSION=$(grep -oP 'HUGO_VERSION = "\K[0-9.]+' setup.py)
+          CURRENT_VERSION=$(grep -oP "version\s*:\s*'\K[0-9.]+" meson.build)
           echo "Current version: $CURRENT_VERSION"
 
           # Find the next Hugo release after our current version
@@ -60,8 +60,7 @@ jobs:
             RELEASE_TYPE="patch"
           fi
 
-          sed -i "s/HUGO_VERSION = \"$CURRENT_VERSION\"/HUGO_VERSION = \"$LATEST_VERSION\"/" setup.py
-          sed -i "s/HUGO_VERSION = \"$CURRENT_VERSION\"/HUGO_VERSION = \"$LATEST_VERSION\"/" src/hugo/cli.py
+          sed -i "s/version\s*:\s*'$CURRENT_VERSION'/version : '$LATEST_VERSION'/" meson.build
 
           # Update the Hugo submodule to the new version tag
           cd hugo
@@ -88,7 +87,7 @@ jobs:
           git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
           git remote set-url origin "https://x-access-token:${GH_TOKEN}@github.com/$GITHUB_REPOSITORY"
           git checkout -b "update-hugo-v${LATEST_VERSION}"
-          git add setup.py src/hugo/cli.py hugo
+          git add meson.build hugo
           git commit -m "Update Hugo to v${LATEST_VERSION}"
           git push origin "update-hugo-v${LATEST_VERSION}"
           gh pr create \

.gitignore

@@ -182,13 +182,13 @@ src/hugo/binaries/*
 # Hugo builder cache
 hugo_cache/
 
-# Hugo version file
-hugo/VERSION
-
 # Documentation
 /docs/public
 /docs/resources
 *.lock
 
 # Generated stamp file for sdist builds
-hugo/.hugo_commit_date
+hugo-src/.hugo_commit_date
+
+# Generated by meson configure_file
+src/hugo/_version.py

.gitmodules

@@ -1,3 +1,3 @@
 [submodule "hugo"]
-	path = hugo
+	path = hugo-src
 	url = https://github.com/gohugoio/hugo.git