feat: Include abiflags in version dectection (enabling 3.13t)

[effigies]

Description

Currently, you can install free-threaded Python in GitHub actions (with deadsnakes or uv), and have tox.ini contain:

[gh-actions]
python =
  3.9: py39
  3.10: py310
  3.11: py311
  3.12: py312
  3.13: py313
  3.13t: py313t

But the version is detected as 3.13, since only the version information is considered, not the abiflags. This enables abiflags, which in turn enables this use case.

This is important for setting conditions in tox that only apply to free-threading builds, such as setting PYTHONGIL=0 or limiting dependencies to those with py3 or cp313t wheels.

You can see it in action in https://github.com/nipy/nibabel/actions/runs/12217554525/job/34081969908:

ROOT: 226 I running tox-gh-actions [tox_gh_actions/plugin.py:28]
ROOT: 227 D original envlist: ['py39-none', 'py310-none', 'py311-none', 'py312-none', 'py313-none', 'py313t-none', 'py39-min', 'py39-full', 'py39-full-x86', 'py39-full-x64', 'py39-pre-x86', 'py39-pre-x64', 'py310-full-x86', 'py310-full-x64', 'py310-pre-x86', 'py310-pre-x64', 'py311-full-x86', 'py311-full-x64', 'py311-pre-x86', 'py311-pre-x64', 'py312-full-x64', 'py312-pre-x64', 'py313-full-x64', 'py313-pre-x64', 'py313t-full-x64', 'py313t-pre-x64', 'py313-dev-x64', 'install', 'doctest', 'style', 'typecheck'] [tox_gh_actions/plugin.py:42]
ROOT: 227 D Python versions: ['3.13t', '3.13', '3'] [tox_gh_actions/plugin.py:45]
ROOT: 228 D tox-gh-actions config: {'python': {'3.9': ['py39'], '3.10': ['py310'], '3.11': ['py311'], '3.12': ['py312'], '3.13': ['py313'], '3.13t': ['py313t']}, 'env': {'ARCH': {'x64': ['x64'], 'x86': ['x86'], 'arm64': ['arm64']}, 'DEPENDS': {'none': ['none', 'install'], 'pre': ['pre'], 'dev': ['dev'], 'full': ['full', 'install'], 'min': ['min']}}} [tox_gh_actions/plugin.py:48]
ROOT: 228 D got factors for Python version: 3.13t [tox_gh_actions/plugin.py:137]
ROOT: 228 D using the following factors to decide envlist: ['py313t-x64-full', 'py313t-x64-install'] [tox_gh_actions/plugin.py:51]
ROOT: 228 D expiring envlist cache to override [tox_gh_actions/plugin.py:121]

Expected Behavior

When detecting a matching Python, 3.13t will be tried before falling back to 3.13 and 3.

[effigies]

This will break Windows, which doesn't have this attribute, unfortunately. It looks like it can be recovered from EXT_SUFFIX, which would be a pretty ugly hack, but I can do it...

[ymyzk]

Hello @effigies!

First of all, I apologize for the delay in reviewing this PR. I really appreciate your effort in integrating tox and tox-gh-actions for testing across various Python variants, including free-threaded builds. At the same time, I want to carefully design the API to ensure long-term compatibility, as it will be difficult to change once people start relying on it.

One major concern with the proposed approach is that the naming convention for tox environments, such as py313t (using a t suffix), is not yet standardized by tox: tox-dev/tox#3391. This means that running tox -e py313t with vanilla tox does not currently execute tests using python3.13t. Users would need to provide additional configurations to use python3.13t when specifying the py313t environment. I’d prefer to wait for the tox team’s decision on how to officially support free-threaded Python.

In the meantime, we might be able to leverage tox-gh-actions’ environment variable feature to enable matrix builds with free-threaded Python: https://github.com/ymyzk/tox-gh-actions?tab=readme-ov-file#factor-conditional-settings-environment-variable Here's an example I'm thinking of:

name: Python package
on:
  - push
  - pull_request
jobs:
  build:
    runs-on: ${{ matrix.platform }}
    strategy:
      matrix:
        abi: [standard, free-threaded]
        python-version: ['3.13', '3.14']

    steps:
    - ...
    - name: Install dependencies
      run: python -m pip install tox tox-gh-actions
    - name: Test with tox
      run: tox
      env:
        ABI: ${{ matrix.abi }}

[tox]
envlist = py{313,314}-{standard,freethreaded}

[gh-actions]
python =
    3.13: py313
    3.14: py314

[gh-actions:env]
ABI =
    standard: standard
    free-threaded: freethreaded

[testenv:py313-freethreaded]
basepython = python3.13t

[testenv:py314-freethreaded]
basepython = python3.14t
...

I’d definitely prefer a simpler solution like your proposal in the future, but I’m hesitant to make this design choice at this stage. Feel free to keep this PR open—I’d love to hear your thoughts and input from the community on this.

[dimaqq]

I'd love to see this move forward 🙇🏻

[ymyzk]

Hello everyone. Thank you, @effigies, again for creating this PR. After reviewing tox's direction to support free-threaded Python and running some experiments locally, I want to take a bit different path for supporting free-threaded builds. I just opened a PR #228 and let me explain my design choices.

First, I'd like to focus on supporting only free-threaded Python rather than than supporting arbitrary ABI flags considering that we don't expect many users using other ABI flags and getting ABI flags outside the POSIX environment is not necessarily trivial: https://github.com/ymyzk/tox-gh-actions/pull/199/files#diff-93212929fc29259673ac1c9dac7cb5f003076342a27aca2a67c811af95a5b7bcR165-R167

There's a paved path for detecting whether a Python is free-threaded or not and it's better to use that: sysconfig.get_config_var("Py_GIL_DISABLED") Ref: https://docs.python.org/3/howto/free-threading-python.html#identifying-free-threaded-python

The other minor difference is which keys to generate in get_python_version_keys. To better align with tox's implementation, I'd like to make python3.14t to generate [3.14t, 3] rather than [3.14t, 3.14, 3]. Ref: tox-dev/tox#3526 (comment)

[effigies]

Sounds good, thanks for picking this up. My fork works for the repo I was working on, but I'll be happy to switch back to base once your implementation is done. I'll close this.