Update top-level Python project for CMake compatibility.

This commit reimplements the (no longer recommended) setuptools based
build system using a standards-based in-tree PEP517 build backend.
The implementation is partially based on
  https://codeberg.org/ziglang/zig-pypi/src/branch/main/make_wheels.py
which is licensed under BSD-0-clause.

It also adds a new option `YOSYS_BUILD_PYTHON_ONLY` that is available
only if the binary or the library aren't going to be installed, which
turns off these targets entirely, as well as some dependent ones
(e.g. tests).

Co-authored-by: Mohamed Gaber <me@donn.website>

.github/workflows/wheels.yml

@@ -36,13 +36,11 @@ jobs:
               runner: "macos-15",
               archs: "arm64",
             },
-            ## Windows is disabled because of an issue with compiling FFI as
-            ## under MinGW in the GitHub Actions environment (SHELL variable has
-            ## whitespace.)
+            ## Windows still needs to be tested.
             # {
-            #   name: "Windows Server 2019",
+            #   name: "Windows Server 2025",
             #   family: "windows",
-            #   runner: "windows-2019",
+            #   runner: "windows-2025",
             #   archs: "AMD64",
             # },
           ]
@@ -77,17 +75,14 @@ jobs:
         name: "[Windows] Flex/Bison"
         run: |
           choco install winflexbison3
-      - if: ${{ matrix.os.family == 'macos' && matrix.os.archs == 'arm64' }}
-        name: "[macOS/arm64] Install Python 3.8 (see: https://cibuildwheel.pypa.io/en/stable/faq/#macos-building-cpython-38-wheels-on-arm64)"
-        uses: actions/setup-python@v5
-        with:
-          python-version: 3.8
       - name: Build wheels
-        uses: pypa/cibuildwheel@v2.21.1
+        uses: pypa/cibuildwheel@v3.4.1
         env:
           # * APIs not supported by PyPy
           # * Musllinux disabled because it increases build time from 48m to ~3h
           CIBW_SKIP: >
+            cp38*
+            cp39*
             pp*
             *musllinux*
           CIBW_ARCHS: ${{ matrix.os.archs }}
@@ -104,7 +99,6 @@ jobs:
             OPTFLAGS=-O3
             PKG_CONFIG_PATH=./ffi/pfx/lib/pkgconfig
             MACOSX_DEPLOYMENT_TARGET=11
-            makeFlags='CONFIG=clang'
             PATH="$PWD/bison/src:$PATH"
           CIBW_BEFORE_BUILD: bash ./.github/workflows/wheels/cibw_before_build.sh
           CIBW_TEST_COMMAND: python3 {project}/tests/pyosys/run_tests.py

.github/workflows/wheels/_run_cibw_linux.py

@@ -1,52 +0,0 @@
-#!/usr/bin/env python3
-# Copyright (C) 2024 Efabless Corporation
-#
-# Permission to use, copy, modify, and/or distribute this software for any
-# purpose with or without fee is hereby granted, provided that the above
-# copyright notice and this permission notice appear in all copies.
-#
-# THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
-# WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
-# MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
-# ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
-# WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
-# ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
-# OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
-"""
-This runs the cibuildwheel step from the wheels workflow locally.
-"""
-
-import os
-import yaml
-import platform
-import subprocess
-from pathlib import Path
-
-__yosys_root__ = Path(__file__).absolute().parents[3]
-
-for source in ["ffi", "bison"]:
-    if not (__yosys_root__ / source).is_dir():
-        print(
-            "You need to download ffi and bison in a similar manner to wheels.yml first."
-        )
-        exit(-1)
-
-with open(__yosys_root__ / ".github" / "workflows" / "wheels.yml") as f:
-    workflow = yaml.safe_load(f)
-
-env = os.environ.copy()
-
-steps = workflow["jobs"]["build_wheels"]["steps"]
-cibw_step = None
-for step in steps:
-    if (step.get("uses") or "").startswith("pypa/cibuildwheel"):
-        cibw_step = step
-        break
-
-for key, value in cibw_step["env"].items():
-    if key.endswith("WIN") or key.endswith("MAC"):
-        continue
-    env[key] = value
-
-env["CIBW_ARCHS"] = os.getenv("CIBW_ARCHS", platform.machine())
-subprocess.check_call(["cibuildwheel"], env=env)

.github/workflows/wheels/cibw_before_build.sh

@@ -1,9 +1,6 @@
 set -e
 set -x
 
-# Don't use Python objects from previous compiles
-make clean-py
-
 # DEBUG: show python3 and python3-config outputs
 if [ "$(uname)" != "Linux" ]; then
     # https://github.com/pypa/cibuildwheel/issues/2021