aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorNicholas Junge <nicholas.junge@web.de>2024-09-04 18:42:07 +0200
committerGitHub <noreply@github.com>2024-09-04 17:42:07 +0100
commit986423a62dd174e75282e432e9fbaf921c9c7ccc (patch)
tree1b76e6bb615d702368686e30c86596aa4314652b /docs
parentc19cfee61e136effb05a7fc8a037b0db3b13bd4c (diff)
downloadgoogle-benchmark-main.tar.gz
google-benchmark-main.zip
Bump oldest supported Python to 3.10, eliminate setuptools-scm (#1842)HEADmain
* Supply MacOS deployment target to delocate, use build+uv frontend This shaves off multiple minutes from the wheel builds alone. Also revert to trusted publishing for wheel uploads as it is now set up. * Bump oldest supported Python to 3.10, eliminate setuptools-scm The version is now a string again, under the same attribute as it was before. This is a pragmatic decision in order to be able to upload wheels again, possibly directly from main. We could in the future also set the Python version to a development version if we want to avoid accidental uploads of `main`. * Add a note on supported Python versions in the docs Also fixes the setuptools failure observed in the latest CI by pinning to the last version before v73 until the problem is identified and resolved.
Diffstat (limited to 'docs')
-rw-r--r--docs/dependencies.md6
-rw-r--r--docs/releasing.md19
2 files changed, 19 insertions, 6 deletions
diff --git a/docs/dependencies.md b/docs/dependencies.md
index 07760e1..98ce996 100644
--- a/docs/dependencies.md
+++ b/docs/dependencies.md
@@ -11,3 +11,9 @@ distributions include newer versions, for example:
* Ubuntu 20.04 provides CMake 3.16.3
* Debian 11.4 provides CMake 3.18.4
* Ubuntu 22.04 provides CMake 3.22.1
+
+## Python
+
+The Python bindings require Python 3.10+ as of v1.9.0 (2024-08-16) for installation from PyPI.
+Building from source for older versions probably still works, though. See the [user guide](python_bindings.md) for details on how to build from source.
+The minimum theoretically supported version is Python 3.8, since the used bindings generator (nanobind) only supports Python 3.8+.
diff --git a/docs/releasing.md b/docs/releasing.md
index 09bf937..ab664a8 100644
--- a/docs/releasing.md
+++ b/docs/releasing.md
@@ -8,16 +8,24 @@
* `git log $(git describe --abbrev=0 --tags)..HEAD` gives you the list of
commits between the last annotated tag and HEAD
* Pick the most interesting.
-* Create one last commit that updates the version saved in `CMakeLists.txt` and `MODULE.bazel`
- to the release version you're creating. (This version will be used if benchmark is installed
- from the archive you'll be creating in the next step.)
+* Create one last commit that updates the version saved in `CMakeLists.txt`, `MODULE.bazel`,
+ and `bindings/python/google_benchmark/__init__.py` to the release version you're creating.
+ (This version will be used if benchmark is installed from the archive you'll be creating
+ in the next step.)
```
-project (benchmark VERSION 1.8.0 LANGUAGES CXX)
+# CMakeLists.txt
+project (benchmark VERSION 1.9.0 LANGUAGES CXX)
```
```
-module(name = "com_github_google_benchmark", version="1.8.0")
+# MODULE.bazel
+module(name = "com_github_google_benchmark", version="1.9.0")
+```
+
+```
+# google_benchmark/__init__.py
+__version__ = "1.9.0"
```
* Create a release through github's interface
@@ -28,4 +36,3 @@ module(name = "com_github_google_benchmark", version="1.8.0")
* `git push --force --tags origin`
* Confirm that the "Build and upload Python wheels" action runs to completion
* Run it manually if it hasn't run.
- * IMPORTANT: When re-running manually, make sure to select the newly created `<tag>` as the workflow version in the "Run workflow" tab on the GitHub Actions page.