Skip to content

Conversation

@henry3260
Copy link
Contributor

@henry3260 henry3260 commented Jan 31, 2026

What

Implemented a timeout mechanism for the automatic Breeze self-upgrade check.

Introduced the BREEZE_SELF_UPGRADE_TIMEOUT environment variable to allow users to configure the timeout duration (default: 10 seconds).

Added error handling to catch subprocess.TimeoutExpired and subprocess.CalledProcessError, ensuring the CLI startup does not crash or hang indefinitely if the upgrade check fails.

Why

Currently, if we run a Breeze command with a typo (e.g., breeze ci upgradee), the terminal doesn't show the error message immediately. Instead, it just blocks/hangs while checking for updates in the background. This makes it hard for users to realize they made a simple typo.

closes: #61125


Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

  • Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
  • For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
  • When adding dependency, check compliance with the ASF 3rd Party License Policy.
  • For significant user-facing changes create newsfragment: {pr_number}.significant.rst or {issue_number}.significant.rst, in airflow-core/newsfragments.

Add a timeout to the  command so that Breeze startup doesn't hang when the check is slow or unresponsive.
@boring-cyborg boring-cyborg bot added area:dev-tools backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch labels Jan 31, 2026
@henry3260 henry3260 changed the title Fix cli timeout Add BREEZE_SELF_UPGRADE_TIMEOUT in reinstall_if_setup_changed Jan 31, 2026
@henry3260 henry3260 marked this pull request as draft January 31, 2026 16:09
…Modified, TimeoutExpired, and CalledProcessError.
@henry3260
Copy link
Contributor Author

I'm not sure if we strictly need to use the latest Breeze version every time. If anyone has another idea about this, please feel free to leave a comment.

@henry3260 henry3260 marked this pull request as ready for review January 31, 2026 17:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Running certain breeze commands can hang during startup. Example: breeze ci upgrad222 may not return and appears to block indefinitely

1 participant