Adjust project metadata for supported python versions

[asnare]

Changes

What does this PR do?

This PR updates the project metadata and documentation for the versions of python that are supported, having discovered (see #2234) that version 3.10.0 is missing some functionality that we use: it was introduced in version 3.10.1. With this in mind:

• Previously: metadata expressed that 3.10+ was supported and the documentation matched, although the documentation noted that 3.14 isn't supported.
• Now: metadata now expresses a minimum version of 3.10.1 and a maximum of 3.13.x, to the extent that we can.

The documentation has been adjusted accordingly.

Relevant implementation details

During the normal installation flow with the Databricks CLI:

1. The Databricks CLI searches PATH for interpreters to use when setting up the virtual environment. Interpreters that do not meet the minimum version in labs.yml are excluded. (Full semantic versioning is supported in the comparison.) There is no way to specify a maximum version.
2. pip is used to install the package; this checks the required version in pyproject.yml and will halt with an error if the interpreter is 3.14+.

When setting up the virtual environment for BB, we rely on some functionality that introduced in python 3.10.1. Although not mentioned in the python documentation, the env_exec_cmd attribute isn't available in the virtual environment metadata in python 3.10.0. The relevant change between python 3.10.0 and 3.10.1 is here.

Linked issues

Resolves #2234: Most installations of 3.10 will be 3.10.1 or later, so this isn't really worth working around or the accompanying maintenance/testing burden. As such these changes are really about guarding against the odd edge case.

Functionality

• modified existing command: databricks labs install lakebridge

Tests

• manually tested:

  • Failure of install-transpile prior to this PR with 3.10.0:
    install-transpile-3.10.0.scrub.log
  • New: Refusal of fresh labs install with Python 3.10.0:
    install-lakebridge-3.10.0.scrub.log
  • New: Refusal of upgrade via labs install with existing version using Python 3.10.0:
    upgrade-lakebridge-3.10.0.scrub.log
  • New: Success of labs install and install-transpile with Python 3.10.1:
    install-transpile-3.10.1.scrub.log
  • New: Error (expected) of fresh labs install with Python 3.14.
    install-lakebridge-3.14.0.scrub.log

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 63.92%. Comparing base (f665611) to head (93ac8ec).

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #2235   +/-   ##
=======================================
  Coverage   63.92%   63.92%           
=======================================
  Files          99       99           
  Lines        8635     8635           
  Branches      889      889           
=======================================
  Hits         5520     5520           
  Misses       2943     2943           
  Partials      172      172           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[github-actions]

✅ 130/130 passed, 7 flaky, 5 skipped, 20m10s total

Flaky tests:

• 🤪 test_installs_and_runs_local_bladebridge (20.082s)
• 🤪 test_transpiles_informatica_to_sparksql_non_interactive[False] (14.563s)
• 🤪 test_transpiles_informatica_to_sparksql (15.4s)
• 🤪 test_transpile_teradata_sql_non_interactive[False] (15.657s)
• 🤪 test_transpiles_informatica_to_sparksql_non_interactive[True] (2.853s)
• 🤪 test_transpile_teradata_sql_non_interactive[True] (17.844s)
• 🤪 test_transpile_teradata_sql (4.813s)

_{Running from acceptance #3477}

[gueniai]

lgtm

[sundarshankar89]

LGTM