sysfce2 · pull · Nov 26, 2024 · Nov 26, 2024 · Nov 26, 2024 · Nov 26, 2024
diff --git a/.github/ISSUE_TEMPLATE/bug-report.md b/.github/ISSUE_TEMPLATE/bug-report.md
@@ -1,3 +1,11 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ""
+labels: bug
+assignees: ""
+---
+
 **Issue**
 
 Describe what's the expected behavior and what you're observing.

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
diff --git a/.github/workflows/check.yaml b/.github/workflows/check.yaml
@@ -22,6 +22,7 @@ jobs:
       fail-fast: false
       matrix:
         py:
+          - "3.13t"
           - "3.13"
           - "3.12"
           - "3.11"
@@ -31,6 +32,7 @@ jobs:
           - pypy-3.10
           - pypy-3.9
           - pypy-3.8
+          - graalpy-24.1
         os:
           - ubuntu-latest
           - macos-latest
@@ -40,6 +42,7 @@ jobs:
           - { os: macos-latest, py: "brew@3.10" }
           - { os: macos-latest, py: "brew@3.9" }
         exclude:
+          - { os: windows-latest, py: "graalpy-24.1" }
           - { os: windows-latest, py: "pypy-3.10" }
           - { os: windows-latest, py: "pypy-3.9" }
           - { os: windows-latest, py: "pypy-3.8" }
@@ -63,7 +66,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v4
         with:
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"
@@ -77,27 +80,41 @@ jobs:
         shell: bash
         run: echo ~/.local/bin >> $GITHUB_PATH
       - name: Install tox
-        if: matrix.py == '3.13'
+        if: matrix.py == '3.13' || matrix.py == '3.13t'
         run: uv tool install --python-preference only-managed --python 3.12 tox --with tox-uv
       - name: Install tox
-        if: matrix.py != '3.13'
+        if: "!(matrix.py == '3.13' || matrix.py == '3.13t')"
         run: uv tool install --python-preference only-managed --python 3.13 tox --with tox-uv
       - name: Setup brew python for test ${{ matrix.py }}
-        if: startsWith(matrix.py,'brew@')
+        if: startsWith(matrix.py, 'brew@')
         run: |
           set -e
           PY=$(echo '${{ matrix.py }}' | cut -c 6-)
           brew cleanup && brew upgrade python@$PY || brew install python@$PY
           echo "/usr/local/opt/python@$PY/libexec/bin" >>"${GITHUB_PATH}"
         shell: bash
       - name: Setup python for test ${{ matrix.py }}
-        if: "!( startsWith(matrix.py,'brew@') || endsWith(matrix.py, '-dev') )"
+        if: "!(startsWith(matrix.py, 'brew@') || endsWith(matrix.py, 't'))"
         uses: actions/setup-python@v5
         with:
           python-version: ${{ matrix.py }}
           allow-prereleases: true
+      # quansight-labs to install free-threaded python until actions/setup-python supports it
+      # https://github.com/actions/setup-python/issues/771
+      - name: Setup python for test ${{ matrix.py }}
+        if: endsWith(matrix.py, 't')
+        uses: quansight-labs/setup-python@v5.3.1
+        with:
+          python-version: ${{ matrix.py }}
       - name: Pick environment to run
+        if: matrix.py != '3.13t'
         run: python tasks/pick_tox_env.py ${{ matrix.py }}
+      - name: Pick environment to run
+        if: matrix.py == '3.13t' && runner.os != 'Windows'
+        run: python tasks/pick_tox_env.py ${{ matrix.py }} $Python_ROOT_DIR/bin/python
+      - name: Pick environment to run
+        if: matrix.py == '3.13t' && runner.os == 'Windows'
+        run: python tasks/pick_tox_env.py ${{ matrix.py }} $env:Python_ROOT_DIR\python.exe
       - name: Setup test suite
         run: tox run -vv --notest --skip-missing-interpreters false
       - name: Run test suite
@@ -132,7 +149,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v4
         with:
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"

diff --git a/.github/workflows/release.yaml b/.github/workflows/release.yaml
@@ -14,7 +14,7 @@ jobs:
         with:
           fetch-depth: 0
       - name: Install the latest version of uv
-        uses: astral-sh/setup-uv@v3
+        uses: astral-sh/setup-uv@v4
         with:
           enable-cache: true
           cache-dependency-glob: "pyproject.toml"
@@ -43,6 +43,6 @@ jobs:
           name: ${{ env.dists-artifact-name }}
           path: dist/
       - name: Publish to PyPI
-        uses: pypa/gh-action-pypi-publish@v1.12.2
+        uses: pypa/gh-action-pypi-publish@v1.12.3
         with:
           attestations: true
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -5,32 +5,32 @@ repos:
       - id: end-of-file-fixer
       - id: trailing-whitespace
   - repo: https://github.com/python-jsonschema/check-jsonschema
-    rev: 0.29.4
+    rev: 0.33.0
     hooks:
       - id: check-github-workflows
         args: ["--verbose"]
   - repo: https://github.com/codespell-project/codespell
-    rev: v2.3.0
+    rev: v2.4.1
     hooks:
       - id: codespell
         args: ["--write-changes"]
   - repo: https://github.com/tox-dev/tox-ini-fmt
-    rev: "1.4.1"
+    rev: "1.5.0"
     hooks:
       - id: tox-ini-fmt
         args: ["-p", "fix"]
   - repo: https://github.com/tox-dev/pyproject-fmt
-    rev: "v2.5.0"
+    rev: "v2.6.0"
     hooks:
       - id: pyproject-fmt
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: "v0.7.2"
+    rev: "v0.11.11"
     hooks:
       - id: ruff-format
       - id: ruff
         args: ["--fix", "--unsafe-fixes", "--exit-non-zero-on-fix"]
   - repo: https://github.com/rbubley/mirrors-prettier
-    rev: "v3.3.3"
+    rev: "v3.5.3"
     hooks:
       - id: prettier
         additional_dependencies:

diff --git a/docs/changelog.rst b/docs/changelog.rst
@@ -5,6 +5,115 @@ Release History
 
 .. towncrier release notes start
 
+v20.31.2 (2025-05-08)
+---------------------
+
+No significant changes.
+
+
+v20.31.1 (2025-05-05)
+---------------------
+
+Bugfixes - 20.31.1
+~~~~~~~~~~~~~~~~~~
+- Upgrade embedded wheels:
+
+  * pip to ``25.1.1`` from ``25.1``
+  * setuptools to ``80.3.1`` from ``78.1.0`` (:issue:`2880`)
+
+v20.31.0 (2025-05-05)
+---------------------
+
+Features - 20.31.0
+~~~~~~~~~~~~~~~~~~
+- No longer bundle ``wheel`` wheels (except on Python 3.8), ``setuptools`` includes native ``bdist_wheel`` support.  Update ``pip`` to ``25.1``. (:issue:`2868`)
+
+Bugfixes - 20.31.0
+~~~~~~~~~~~~~~~~~~
+- ``get_embed_wheel()`` no longer fails with a :exc:`TypeError` when it is
+  called with an unknown *distribution*. (:issue:`2877`)
+- Fix ``HelpFormatter`` error with Python 3.14.0b1. (:issue:`2878`)
+
+v20.30.0 (2025-03-31)
+---------------------
+
+Features - 20.30.0
+~~~~~~~~~~~~~~~~~~
+- Add support for `GraalPy <https://github.com/oracle/graalpython>`_. (:issue:`2832`)
+
+Bugfixes - 20.30.0
+~~~~~~~~~~~~~~~~~~
+- Upgrade embedded wheels:
+
+  * setuptools to ``78.1.0`` from ``75.3.2`` (:issue:`2863`)
+
+v20.29.3 (2025-03-06)
+---------------------
+
+Bugfixes - 20.29.3
+~~~~~~~~~~~~~~~~~~
+- Ignore unreadable directories in ``PATH``. (:issue:`2794`)
+
+v20.29.2 (2025-02-10)
+---------------------
+
+Bugfixes - 20.29.2
+~~~~~~~~~~~~~~~~~~
+- Remove old virtualenv wheel from the source distribution - by :user:`gaborbernat`. (:issue:`2841`)
+- Upgrade embedded wheel pip to ``25.0.1`` from ``24.3.1`` - by :user:`gaborbernat`. (:issue:`2843`)
+
+v20.29.1 (2025-01-17)
+---------------------
+
+Bugfixes - 20.29.1
+~~~~~~~~~~~~~~~~~~
+- Fix PyInfo cache incompatibility warnings - by :user:`robsdedude`. (:issue:`2827`)
+
+v20.29.0 (2025-01-15)
+---------------------
+
+Features - 20.29.0
+~~~~~~~~~~~~~~~~~~
+- Add support for selecting free-threaded Python interpreters, e.g., `python3.13t`. (:issue:`2809`)
+
+Bugfixes - 20.29.0
+~~~~~~~~~~~~~~~~~~
+- Upgrade embedded wheels:
+
+  * setuptools to ``75.8.0`` from ``75.6.0`` (:issue:`2823`)
+
+v20.28.1 (2025-01-02)
+---------------------
+
+Bugfixes - 20.28.1
+~~~~~~~~~~~~~~~~~~
+- Skip tcsh tests on broken tcsh versions - by :user:`gaborbernat`. (:issue:`2814`)
+
+v20.28.0 (2024-11-25)
+---------------------
+
+Features - 20.28.0
+~~~~~~~~~~~~~~~~~~
+- Write CACHEDIR.TAG file on creation - by "user:`neilramsay`. (:issue:`2803`)
+
+v20.27.2 (2024-11-25)
+---------------------
+
+Bugfixes - 20.27.2
+~~~~~~~~~~~~~~~~~~
+- Upgrade embedded wheels:
+
+  * setuptools to ``75.3.0`` from ``75.2.0`` (:issue:`2798`)
+- Upgrade embedded wheels:
+
+  * wheel to ``0.45.0`` from ``0.44.0``
+  * setuptools to ``75.5.0`` (:issue:`2800`)
+- no longer forcibly echo off during windows batch activation (:issue:`2801`)
+- Upgrade embedded wheels:
+
+  * setuptools to ``75.6.0`` from ``75.5.0``
+  * wheel to ``0.45.1`` from ``0.45.0`` (:issue:`2804`)
+
 v20.27.1 (2024-10-28)
 ---------------------
 

diff --git a/docs/changelog/2798.bugfix.rst b/docs/changelog/2798.bugfix.rst
diff --git a/docs/development.rst b/docs/development.rst
@@ -106,7 +106,7 @@ that folder.
 Release
 ~~~~~~~
 
-virtualenv's release schedule is tied to ``pip``, ``setuptools`` and ``wheel``. We bundle the latest version of these
+virtualenv's release schedule is tied to ``pip`` and ``setuptools``. We bundle the latest version of these
 libraries so each time there's a new version of any of these, there will be a new virtualenv release shortly afterwards
 (we usually wait just a few days to avoid pulling in any broken releases).
 

diff --git a/docs/installation.rst b/docs/installation.rst
@@ -84,7 +84,7 @@ Python and OS Compatibility
 
 virtualenv works with the following Python interpreter implementations:
 
-- `CPython <https://www.python.org/>`_: ``3.12 >= python_version >= 3.7``
+- `CPython <https://www.python.org/>`_: ``3.13 >= python_version >= 3.7``
 - `PyPy <https://pypy.org/>`_: ``3.10 >= python_version >= 3.7``
 
 This means virtualenv works on the latest patch version of each of these minor versions. Previous patch versions are

diff --git a/docs/user_guide.rst b/docs/user_guide.rst
@@ -86,13 +86,14 @@ format is either:
 
     - the python implementation is all alphabetic characters (``python`` means any implementation, and if is missing it
       defaults to ``python``),
-    - the version is a dot separated version number,
+    - the version is a dot separated version number optionally followed by ``t`` for free-threading,
     - the architecture is either ``-64`` or ``-32`` (missing means ``any``).
 
     For example:
 
     - ``python3.8.1`` means any python implementation having the version ``3.8.1``,
     - ``3`` means any python implementation having the major version ``3``,
+    - ``3.13t`` means any python implementation having the version ``3.13`` with free threading,
     - ``cpython3`` means a ``CPython`` implementation having the version ``3``,
     - ``pypy2`` means a python interpreter with the ``PyPy`` implementation and major version ``2``.
 
@@ -139,8 +140,7 @@ Seeders
 -------
 These will install for you some seed packages (one or more of: :pypi:`pip`, :pypi:`setuptools`, :pypi:`wheel`) that
 enables you to install additional python packages into the created virtual environment (by invoking pip). Installing
-:pypi:`setuptools` and :pypi:`wheel` is disabled by default on Python 3.12+ environments. There are two
-main seed mechanisms available:
+:pypi:`setuptools` is disabled by default on Python 3.12+ environments. :pypi:`wheel` is only installed on Python 3.8, by default. There are two main seed mechanisms available:
 
 - ``pip`` - this method uses the bundled pip with virtualenv to install the seed packages (note, a new child process
   needs to be created to do this, which can be expensive especially on Windows).

diff --git a/pyproject.toml b/pyproject.toml
@@ -64,7 +64,7 @@ optional-dependencies.test = [
   "packaging>=23.1",
   "pytest>=7.4",
   "pytest-env>=0.8.2",
-  "pytest-freezer>=0.4.8; platform_python_implementation=='PyPy' or (platform_python_implementation=='CPython' and sys_platform=='win32' and python_version>='3.13')",
+  "pytest-freezer>=0.4.8; platform_python_implementation=='PyPy' or platform_python_implementation=='GraalVM' or (platform_python_implementation=='CPython' and sys_platform=='win32' and python_version>='3.13')",
   "pytest-mock>=3.11.1",
   "pytest-randomly>=3.12",
   "pytest-timeout>=2.1",
@@ -87,6 +87,8 @@ entry-points."virtualenv.create".cpython3-mac-brew = "virtualenv.create.via_glob
 entry-points."virtualenv.create".cpython3-mac-framework = "virtualenv.create.via_global_ref.builtin.cpython.mac_os:CPython3macOsFramework"
 entry-points."virtualenv.create".cpython3-posix = "virtualenv.create.via_global_ref.builtin.cpython.cpython3:CPython3Posix"
 entry-points."virtualenv.create".cpython3-win = "virtualenv.create.via_global_ref.builtin.cpython.cpython3:CPython3Windows"
+entry-points."virtualenv.create".graalpy-posix = "virtualenv.create.via_global_ref.builtin.graalpy:GraalPyPosix"
+entry-points."virtualenv.create".graalpy-win = "virtualenv.create.via_global_ref.builtin.graalpy:GraalPyWindows"
 entry-points."virtualenv.create".pypy3-posix = "virtualenv.create.via_global_ref.builtin.pypy.pypy3:PyPy3Posix"
 entry-points."virtualenv.create".pypy3-win = "virtualenv.create.via_global_ref.builtin.pypy.pypy3:Pypy3Windows"
 entry-points."virtualenv.create".venv = "virtualenv.create.via_global_ref.venv:Venv"