Add support for Python 3.15

[hugovk]

The earlier approach was something like:

      matrix:
        branch: ["main", "3.14", "3.13", "3.12"]
...
          python-version: ${{ matrix.branch == 'main' && '3.15' || matrix.branch }}
...
          --branches ${{ matrix.branch }}

Which do you prefer?

---

📚 Documentation preview 📚: https://python-docs-theme-previews--282.org.readthedocs.build/

[AA-Turner]

If it were me, I'd probably duplicate the jobs -- one for released & one for in-development.

[ezio-melotti]

A possible improvement is to compute the branch and extra opts once and assign them to env vars:

Suggested change

	include:
	- python-version: "3.15"
	branch: "main"
	include:
	- python-version: "3.15"
	branch: "main"
	extra_opts: '--select-output no-html'
	env:
	# set the branch name to either 'main' or the version number
	BRANCH: ${{ matrix.branch || matrix.version }}
	# define optional extra options if specified
	EXTRA_OPTS: ${{ matrix.extra_opts || '' }}

This keeps all the data and logic closer and avoids duplication. However we only need the branch and the extra opts once in the workflow, so your less-verbose solution is fine too.

[hugovk]

Yeah, that is quite a bit more verbose, let's stick with the current version. Thanks!

[ezio-melotti]

Suggested change

	--branches ${{ matrix.branch || matrix.python-version }}
	${{ matrix.branch == 'main' && '--select-output no-html' || '' }}
	--branches env.BRANCH env.EXTRA_OPTS