tv --version tells you when to upgrade
If PyPI has a newer release than the one installed, tv --version says so and prints the upgrade command.
The notice
"A newer version is available: X (you have Y). Upgrade with: pip install -U "truvelocity-tevv[ui]"". When you are up to date it prints only the version.
Never in the way
One anonymous request to pypi.org for the package's public data, with a 2-second limit. Offline, behind a firewall or if PyPI is down, you just see the version. Nothing about you or your project is sent.
Scripts keep working
The version line goes to standard output as before; the notice goes to standard error.
Turn it off
TV_NO_UPDATE_CHECK=1 turns it off (air-gapped machines), and it is off whenever CI is set. Pre-releases are never offered.
The practice project on Docker
| Area | Change |
|---|---|
| docker compose up | The practice project's proxy image is built on your machine and never pulled (pull_policy: build). Before, some Docker setups stopped with pull access denied for truvelocity-tevv/proxy; the workaround was docker compose build first. |
| Offline model on Docker | The agent image is now harbor-expense-agent:sha-dd806dd, whose offline model names the approved amount. On the old image, the clean build failed REV-01 with --scripted and the decision was No-go. Existing projects: add EXPENSE_IMAGE=ghcr.io/shankonduru/harbor-expense-agent:sha-dd806dd to .env, or run tv practice-project --force (your .env is kept). |
Upgrade
Upgrade TruVelocity
pip install -U "truvelocity-tevv[ui,proxy]"
Check it (and, from now on, whether a newer one is out)
tv --version
How this release was checked
tv --version was checked against the real PyPI: an older version gets the notice, the current one prints only the version. The practice Compose file was checked with a proxy tag that exists in no registry: it built locally and all three services came up healthy. The Docker route with the offline model on the new image: 15 of 15 cases and the release bar passed.