Skip to content

docs(contributing): fix unit‑test example paths for Airflow 3 - #51035

Merged
gopidesupavan merged 6 commits into
apache:mainfrom
aaron-y-chen:meta-fix_unit_tests_rst_relate_issue
May 26, 2025
Merged

gopidesupavan merged 6 commits into
apache:mainfrom
aaron-y-chen:meta-fix_unit_tests_rst_relate_issue

Conversation

@aaron-y-chen

@aaron-y-chen aaron-y-chen commented May 24, 2025 •

Copy link
Copy Markdown
Contributor

Hi folks! While following contributing-docs/testing/unit_tests.rst on a fresh Airflow 3.0 checkout, I noticed the shell snippets either fail outright or reference legacy paths/flags.

This PR refreshes the doc so newcomers can copy‑paste and succeed on the first try.

✨ What's fixed

Area Old example Issue New example
Pytest pytest tests/core/... path no longer exists pytest airflow-core/tests/unit/...
Breeze shortcut breeze core-testing … command removed breeze testing core-tests …
CLI flag --skip--docker-compose-down double hyphen --skip-docker-compose-down
Coverage report run airflow webserver, open /dev/coverage route not mounted in 3.x cd htmlcov && python -m http.server 5555, then open http://localhost:25555/ (Breeze maps 5555→25555)

✅ Verification

All updated commands were executed inside a Breeze container launched with:

breeze --python 3.9 --backend postgres

I aimed to modernise the docs for Airflow 3.x; however, if any of these changes would break needed compatibility with Airflow 2.x, or if you feel the update isn't necessary, please let me know and I'll gladly revise or withdraw.

Thanks for your review!

Comment thread scripts/cov/core_coverage.py Outdated
Comment thread scripts/cov/core_coverage.py Outdated
@gopidesupavan

Copy link
Copy Markdown
Member

Thanks for doing this, can you please double check the paths, with Airflow 3 we have removed some of the files. so may not be accurate the current list in the coverage file?

@aaron-y-chen

Copy link
Copy Markdown
Contributor Author

Sure, let me check on that.

@aaron-y-chen

Copy link
Copy Markdown
Contributor Author

Done. I checked all the files in core_coverage.py, restapi_coverage.py, cli_coverage.py, and other_coverage.py, and added some files which has dropped in coverage. Feel free to let me know if there's anything that needs improvement.

Comment thread scripts/cov/cov_runner.py
@gopidesupavan
gopidesupavan merged commit 1d0ce49 into apache:main May 26, 2025
sanederchik pushed a commit to sanederchik/airflow that referenced this pull request Jun 7, 2025
…#51035)

* docs(contributing): fix unit‑test example paths for Airflow 3

* fix all broken commands for pytest and breeze

* rm Webserver coverage test & simplify coverage report viewing

* fix incorrect paths in coverage report scripts

* rm deprecated file in core_coverage & improve run_tests

* add file has dropped in coverage to the list
jose-lehmkuhl pushed a commit to jose-lehmkuhl/airflow that referenced this pull request Jul 11, 2025
…#51035)

* docs(contributing): fix unit‑test example paths for Airflow 3

* fix all broken commands for pytest and breeze

* rm Webserver coverage test & simplify coverage report viewing

* fix incorrect paths in coverage report scripts

* rm deprecated file in core_coverage & improve run_tests

* add file has dropped in coverage to the list
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants