Added a hook to check whether provider exclusions for a specific python version match across relevant files

[dominikhei]

---

When working on #51756 , we initially planned to exclude the Tableau provider for Python 3.9. After quite a bit of trial and error, we eventually got it working. While this is admittedly a niche case, it quickly became clear that adding some automation and documentation around version exclusions would be helpful.

The first step to exclude a specific Python version for a provider, is to update three locations:

• provider/pyproject.toml (in two different places)
• provider/provider.yaml
• dev/breeze/global_constants.py

Note: There also is a fourth place in which the provider needs to be added, but this case is already covered by current tests.

In pyproject.toml, two notations are used for excluding versions:

• >=3.10
• ~=3.9, !=3.9 (example from Cloudant provider)

I have assumed the chance for <= exclusions is rather low and thus not considered it.

In global_constants.py, the matrix logic derives the provider name as follows:

• For providers in a nested folder structure (e.g., common/sql), the name becomes common.sql.
• Otherwise, the name is taken directly from the folder (e.g., amazon).

>=3.10 or ~=3.9, !=3.9 are treated as non-exclusions, as 3.10 is the lowest supported version. To handle this distinction, a constant called MIN_SUPPORTED_VERSION is used. This also ensures that when adding a new provider and having set requires-python = ">=3.10" in the pyproject.toml the hook does not fail.

Checks performed include:

• Ensuring that the classifiers section in pyproject.toml does not list any excluded version from requires-python.
• Verifying that the excluded versions across pyproject.toml and provider.yaml match and that this exclusion is also in the matrix in dev/breeze/global_constants.py .

Example output from the validation:

I've tested the logic with various test cases, but I'm happy to hear any feedback or corrections.

If this approach is deemed useful, I’d be keen to expand it further with documentation that clearly outlines how to exclude a provider for a specific python version.

[potiuk]

Yeah. Good idea. It's a relative;u new development that requires some manual work. But I suggest to (re)do the automation after #46891 is merged.

[dominikhei]

Yeah. Good idea. It's a relative;u new development that requires some manual work. But I suggest to (re)do the automation after #46891 is merged.

sounds good 👍

[potiuk]

Merged. You can rebase and double check (And likely fix some things)

[dominikhei]

Merged. You can rebase and double check (And likely fix some things)

Just came back from holidays, will rebase and test everything.