Skip to content

Improve Beam CLI upgrade guidance - #73

Merged
luke-lombardi merged 2 commits into
masterfrom
agent/improve-beam-upgrade-dx
Jul 23, 2026
Merged

Improve Beam CLI upgrade guidance#73
luke-lombardi merged 2 commits into
masterfrom
agent/improve-beam-upgrade-dx

Conversation

@luke-lombardi

Copy link
Copy Markdown
Contributor

What changed

  • show the resolved Python interpreter behind the running beam command
  • recommend upgrading with that interpreter instead of a potentially unrelated bare pip
  • add a post-upgrade beam --version verification step
  • declare packaging as a direct runtime dependency
  • add regression coverage for the upgrade notice

Why

A user can run beam through a pyenv shim while a bare pip points at another Python environment. In that case, pip install --upgrade beam-client may report a new package version without updating the Beam CLI that is actually running. A clean wheel installation also exposed that the version-check module imported packaging without declaring it directly, which could crash the CLI before the guidance appeared.

Impact

The update-required message is now actionable for pyenv, virtualenv, and other multi-Python setups: it identifies the real environment, provides a copyable command that upgrades that exact installation, and tells the user how to verify the result.

Validation

  • .venv/bin/pytest -q
  • .venv/bin/ruff check src tests
  • .venv/bin/python -m build --wheel
  • isolated clean-wheel test through a shimmed beam executable against a mock minimum-version endpoint

@luke-lombardi
luke-lombardi marked this pull request as ready for review July 23, 2026 18:00
@luke-lombardi
luke-lombardi merged commit e2c0bc7 into master Jul 23, 2026
3 checks passed
@luke-lombardi
luke-lombardi deleted the agent/improve-beam-upgrade-dx branch July 23, 2026 18:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant