Use setuptools-git-versioning for dist versions (e.g. 1.2.3.dev12) (#289)

* Migrate project data from setup.py -> pyproject.toml

Preperation for using setuptools-git-versioning which will require a [project]
entry in pyproject.toml. Once that exists many keywords in setup.py would need
to be declared as dynamic in pyproject.toml. Since they're in practice static
I elected to bite the bullet and migrate everything.

An example error

```
********************************************************************************
The following seems to be defined outside of `pyproject.toml`:

`description = 'A WebAssembly runtime powered by Wasmtime'`

According to the spec (see the link below), however, setuptools CANNOT
consider this value unless `description` is listed as `dynamic`.

https://packaging.python.org/en/latest/specifications/pyproject-toml/#declaring-project-metadata-the-project-table

To prevent this problem, you can list `description` under `dynamic` or alternatively
remove the `[project]` table from your file and rely entirely on other means of
configuration.
********************************************************************************
```

* Use setuptools-git-versioning for dist versions (e.g. 1.2.3.dev12)

This change restores a `.devN` suffix to the version of distributions built
from an untagged commit. The suffix indicates they're a pre-release and makes
the version unique - so the dists can be automatically published to
test.py.pi.org.

Tagged commits will produce a version without any suffix, then be published to
both test.pypi.org and pypi.org.

The change replaces a previous mechanism that was disabled in #287, while
migrating CI to a PEP 517 build frontend/backend.

Differences
- Target version bumped from 33.0.0 -> 33.0.1
- Target version now stored in the file VERSION
- In ".devN" N now counts commits since the file VERSION was modified,
  previously N counted all commits back to the initial commit
- Distributions built from a dirty working tree will generate a version such
  as "1.2.3.post0+git.45fd99a2.dirty" using `dirty_template` config
- The `upload_dists` CI job no longer does a checkout or run of the project
  setup action. They should be unnecessary, as `setup.py` no longer runs `git`
- setuptools-git-versioning is a new build time dependency, it will be
  installed by any PEP 517 build frontend (e.g. python -m build, pip, uv)

Fixes #288

See
- https://setuptools-git-versioning.readthedocs.io
- https://packaging.python.org/en/latest/guides/writing-pyproject-toml/
- https://setuptools.pypa.io/en/latest/userguide/pyproject_config.html
- https://peps.python.org/pep-0517/

* Ignore all shared libraries download by ci/download-wasmtime.py

Prior to this change wasmtime/android-*/ was not ignored. This caused
setuptools-git-versioning to apply the `dirty_version` scheme, rather than the
desired `dev_version`. E.g.

```console
$ .venv/bin/python -m build
...
Successfully built
wasmtime-33.0.1.post0+git.a6f014a0.dirty-py3-none-android_26_x86_64.whl
```

Author: moreati

.github/workflows/main.yml

@@ -44,14 +44,12 @@ jobs:
     steps:
     - uses: actions/checkout@v4
       with:
-        # fetch all history so the git-commit-length-appended-to-version for
-        # publishes to `test.pypi.org` works. (see `git` command in `setup.py`)
+        # Fetch history & tags so setuptools-git-versioning can generate a
+        # unique .devN suffix on untagged builds uploaded to test.pypi.org.
+        # See `tool.setuptools-git-versioning` in `pyproject.toml`.
         fetch-depth: 0
     - uses: ./.github/actions/setup
     - run: pip install build
-    # If this is a tagged build use real version numbers
-    - run: echo "PROD=true" >> $GITHUB_ENV
-      if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags')
     - name: Build sdist (source distribution)
       run: |
         git clean -fdx wasmtime build
@@ -152,12 +150,6 @@ jobs:
     needs: build
     runs-on: ubuntu-latest
     steps:
-    - uses: actions/checkout@v4
-      with:
-        # fetch all history so the git-commit-length-appended-to-version for
-        # publishes to `test.pypi.org` works. (see `git` command in `setup.py`)
-        fetch-depth: 0
-    - uses: ./.github/actions/setup
     - uses: actions/download-artifact@v4
       with:
         name: dists

.gitignore

@@ -1,3 +1,5 @@
+# NB Coordinate changes here with pyproject.toml
+
 build
 html
 dist
@@ -8,9 +10,9 @@ __pycache__
 *.pyd
 .coverage
 htmlcov
-wasmtime/linux-*
-wasmtime/darwin-*
-wasmtime/win32-*
+wasmtime/*-*/*.dll
+wasmtime/*-*/*.dylib
+wasmtime/*-*/*.so
 wasmtime/include
 wasmtime/bindgen/generated
 tests/codegen/generated

MANIFEST.in

@@ -21,6 +21,7 @@ include .flake8
 include CONTRIBUTING.md
 include mypy.ini
 include pytest.ini
+include VERSION
 
 # Wasmtime shared library. Downloaded by ci/download-wasmtime.py
 # Included in binary distributions

VERSION

@@ -0,0 +1 @@
+33.0.1

pyproject.toml

@@ -1,9 +1,91 @@
 [build-system]
 requires = [
     "setuptools",
+    "setuptools-git-versioning>=2.0,<3",
 ]
 # Use an in-tree build backend, to customise the wheels we generate
 build-backend = "backend"
 backend-path = [
     "ci/_custom_build",
 ]
+
+[project]
+name = "wasmtime"
+dynamic = [
+    "version",
+]
+description = "A WebAssembly runtime powered by Wasmtime"
+license = "Apache-2.0 WITH LLVM-exception"
+readme = "README.md"
+authors = [
+    {name="The Wasmtime Project Developers", email="[email protected]"},
+]
+requires-python=">=3.9"
+dependencies = [
+    "importlib_resources>=5.10",
+]
+classifiers=[
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: Implementation :: CPython",
+    "Programming Language :: Python :: Implementation :: PyPy",
+    "Programming Language :: Rust",
+    "Topic :: Software Development :: Compilers",
+    "Topic :: Software Development :: Interpreters",
+]
+
+[project.optional-dependencies]
+testing = [
+    "coverage",
+    "pycparser",
+    "pytest-mypy",
+    "pytest",
+    # componentize-py only support x86_64 builds on Windows
+    # platform.machine() on Windows returns 'AMD64' for x86_64
+    "componentize-py; platform_system != 'Windows' or platform_machine == 'AMD64'",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/bytecodealliance/wasmtime-py"
+"Bug Tracker" = "https://github.com/bytecodealliance/wasmtime-py/issues"
+"Documentation" = "https://bytecodealliance.github.io/wasmtime-py/"
+"Source Code" = "https://github.com/bytecodealliance/wasmtime-py"
+
+[tool.setuptools]
+include-package-data = true
+packages = [
+    "wasmtime",
+    "wasmtime.bindgen",
+]
+
+[tool.setuptools.package-data]
+# NB Coordinate changes here with .gitignore
+"wasmtime" = [
+    # Wasmtime shared library. Downloaded by ci/download-wasmtime.py
+    "*-*/*.dll",
+    "*-*/*.dylib",
+    "*-*/*.so",
+    "py.typed",
+]
+"wasmtime.bindgen" = [
+    # WebAssmbly modules, python bindings. Generated by ci/build-rust.py
+    "generated/*.py",
+    "generated/*.wasm",
+    "generated/imports/*.py",
+]
+
+[tool.setuptools-git-versioning]
+# https://setuptools-git-versioning.readthedocs.io/en/stable/options/index.html
+enabled = true
+version_file = "VERSION"
+count_commits_from_version_file = true
+# Version for distributions built from an untagged commit.
+# Version "1.0.0.dev4" is a treated as a pre-release of Version "1.0.0".
+# {tag}: Version under development, read from `version_file`
+# {ccount}: Count of commits since `version_file` was last changed
+dev_template = "{tag}.dev{ccount}"