Skip to content

Commit f05c4e3

Browse files
authored
Clarify entering breeze and manually forcing lowest dependencies (#48987)
Follow up after #48733 - using `--test-type` and `--force-lowest-dependencies` as flags in `breeze shell` was confusing (and `--test-type` option was missing in `breeze shell`) Instead of allowing the flag in `breeze shell` we describe the steps (cd + uv sync) how to trigger the various lowest dependencies manual operation.
1 parent ebda85e commit f05c4e3

File tree

5 files changed

+76
-91
lines changed

5 files changed

+76
-91
lines changed

contributing-docs/testing/unit_tests.rst

Lines changed: 14 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1244,16 +1244,17 @@ You can test minimum dependencies that are installed by Airflow by running (for
12441244
breeze testing core-tests --force-lowest-dependencies --test-type "Core"
12451245
12461246
You can also iterate on the tests and versions of the dependencies by entering breeze shell and
1247-
running the tests from there:
1247+
running the tests from there, after manually downgrading the dependencies:
12481248

12491249
.. code-block:: bash
12501250
1251-
breeze shell --force-lowest-dependencies
1252-
1251+
breeze shell # enter the container
1252+
cd airflow-core
1253+
uv sync --resolution lowest-direct
12531254
1254-
The way it works - when you run the breeze with ``--force-lowest-dependencies`` flag, breeze will use
1255-
attempt (with the help of ``uv``) to downgrade the dependencies to the lowest version that is compatible
1256-
with the dependencies specified in airflow dependencies. You will see it in the output of the breeze
1255+
The way it works - after you enter breeze container, you run the uv-sync in the airflow-core
1256+
folder to downgrade the dependencies to the lowest version that is compatible
1257+
with the dependencies specified in airflow-core dependencies. You will see it in the output of the breeze
12571258
command as a sequence of downgrades like this:
12581259

12591260
.. code-block:: diff
@@ -1279,11 +1280,13 @@ If you find that the tests are failing for some dependencies, make sure to add m
12791280
the dependency in the provider.yaml file of the appropriate provider and re-run it.
12801281

12811282
You can also iterate on the tests and versions of the dependencies by entering breeze shell and
1282-
running the tests from there:
1283+
manually downgrading dependencies for the provider and running the tests after that:
12831284

12841285
.. code-block:: bash
12851286
1286-
breeze shell --force-lowest-dependencies
1287+
breeze shell
1288+
cd providers/PROVIDER_ID
1289+
uv sync --resolution lowest-direct
12871290
12881291
Similarly as in case of "Core" tests, the dependencies will be downgraded to the lowest version that is
12891292
compatible with the dependencies specified in the provider dependencies and you will see the list of
@@ -1306,7 +1309,8 @@ downgraded dependencies will contain both Airflow and Google Provider dependenci
13061309
+ gcloud-aio-bigquery==6.1.2
13071310
- gcloud-aio-storage==9.2.0
13081311
1309-
You can reproduce the same set of dependencies in your local virtual environment by:
1312+
You can also (if your local virtualenv can install the dependencies for the provider)
1313+
reproduce the same set of dependencies in your local virtual environment by:
13101314

13111315
.. code-block:: bash
13121316
@@ -1317,7 +1321,7 @@ for airflow core, and
13171321

13181322
.. code-block:: bash
13191323
1320-
cd providers/provider_id
1324+
cd providers/PROVIDER_ID
13211325
uv sync --resolution lowest-direct
13221326
13231327
for the providers.

0 commit comments

Comments
 (0)