Trucco cache-friendly per uvx in GitHub Actions: usare UV_EXCLUDE_NEWER

Simon Willison suggerisce di fissare UV_EXCLUDE_NEWER con una data e di includerla nella chiave di cache di GitHub Actions. Così i comandi uvx risolvono gli strumenti “as-of” quella data e aggiornano solo quando alzi la soglia temporale¹.

Il post è del 14 luglio 2026. Il fulcro è una variabile d’ambiente: UV_EXCLUDE_NEWER. La imposti a una data precisa. La inserisci nella chiave di cache. uvx seleziona la versione più recente valida a quella data e smette di interrogare PyPI a ogni run per cercare novità irrilevanti rispetto alla soglia fissata¹.

Il meccanismo è lineare:

• fissi la data in UV_EXCLUDE_NEWER (es. “2026-07-12”);
• includi la stessa data nella chiave di cache;
• uvx risolve e usa gli artefatti coerenti con quella data;
• quando alzi la data, la chiave cambia, la cache si invalida e uvx ricalcola le versioni “as-of” il nuovo valore¹.

Esempio minimo di chiave che incorpora la data:

• UV_EXCLUDE_NEWER=2026-07-12
• chiave di cache: uvx-2026-07-12

Questo schema riduce traffico verso PyPI e rende prevedibile l’aggiornamento degli strumenti invocati con uvx nei workflow. Il vantaggio pratico è chiaro: eviti che ogni esecuzione scarichi di nuovo lo strumento e le sue dipendenze, ma puoi forzare un refresh quando serve, modificando una sola variabile¹.

Niente pin rigidi, niente lock file extra. Solo una data come interruttore. Finché non la tocchi, restano stabili sia la risoluzione di uvx sia la cache di GitHub Actions collegata a quella chiave. Quando decidi di muovere la finestra temporale, basta alzare la data. uvx allora prende le versioni più recenti compatibili con il nuovo “as-of” e la cache si ricostruisce in modo pulito¹.

Il contesto è l’uso di uvx tool-name nei workflow. La semantica “as-of” di UV_EXCLUDE_NEWER agisce da soglia temporale, mentre la chiave di cache che replica la data governa riuso e invalidazione. Insieme, rispondono all’esigenza esplicita: evitare download e risoluzioni ripetute a ogni run, senza rinunciare a un upgrade controllato quando serve¹.

Nel post, Willison elenca anche altri articoli recenti pubblicati sul suo sito: “The new GPT-5.6 family: Luna, Terra, Sol” del 9 luglio 2026; “sqlite-utils 4.0, now with database schema migrations” del 7 luglio 2026; “sqlite-utils 4.0rc2, mostly written by Claude Fable (for about $149.25)” del 5 luglio 2026¹.

Regola pratica: alza la data solo quando vuoi aggiornare gli strumenti e rigenerare la cache. È un singolo cambio che coordina upgrade e invalidazione, senza sorprese tra una run e l’altra¹.