Wrapture: la libreria di monkey patching di Graham Dumpleton per test e tracing

L’11 settembre 2026 Simon Willison segnala Wrapture, la libreria di Graham Dumpleton che usa il monkey patching per accelerare i test e abilitare un tracing “stile New Relic”. Chiede agli sviluppatori Python di non ignorarla¹.

Dal rilascio iniziale del 31 agosto, Dumpleton pubblica nuovi tutorial quasi ogni giorno. Willison raccoglie in un unico post tutti i link usciti fino all’11 settembre. La proposta è chiara: una sola libreria per testing e osservabilità, con esempi pratici e progressivi¹.

Le guide coprono una gamma ampia. Introducing wrapture presenta il progetto e il doppio focus su test e tracing. Unit testing with wrapture mostra un’alternativa a unittest.mock per scrivere test più rapidamente. Recording calls with wrapture registra le chiamate come timeline e le visualizza come alberi. Phased behaviour in wrapture gestisce metodi patchati che cambiano risposta tra chiamate successive. Beyond callables in wrapture estende il patching oltre le funzioni, includendo attributi, dizionari e generatori. Live tracing with wrapture osserva un’applicazione in esecuzione in tempo reale. Zero-code tracing with wrapture configura il tracing in un file TOML senza modificare il codice Python. Tracing Flask with wrapture strumenta un’app Flask tramite un pacchetto separato¹.

Per Willison, Wrapture si sta rivelando utile ma non ha ancora l’attenzione che merita¹. L’elenco dei tutorial mostra continuità e copertura: dal patching tipico dei test alla registrazione dettagliata delle chiamate, fino al tracing in produzione e alla configurazione senza modifiche al codice¹.

Il valore pratico emerge dai casi d’uso. Unit testing with wrapture velocizza sostituzioni e controlli che molti oggi risolvono con unittest.mock. Recording calls crea uno storico fedele delle interazioni, utile per indagare bug o comportamenti inattesi. Live tracing e Zero-code tracing portano all’osservabilità operativa senza disseminare print o interventi ad hoc nel sorgente. Su Flask c’è un percorso dedicato con un pacchetto separato¹.

Conta anche il ritmo di pubblicazione. La cadenza quasi quotidiana dei tutorial dal 31 agosto alza il “tempo di apprendimento” e abbassa la soglia d’ingresso. Chi arriva oggi trova un percorso ordinato: introduzione, test, registrazione, tracing in runtime, configurazione senza toccare il codice¹.

Per provarla senza perdersi, Willison indica un sentiero lineare. Partire da Introducing wrapture. Scrivere un primo test con Unit testing with wrapture. Accendere la registrazione con Recording calls. Passare a Live tracing per osservare in esecuzione; se non si vuole toccare il codice, usare Zero-code tracing con il file TOML. Su Flask, seguire la guida dedicata e il relativo pacchetto. Tutti i link sono nel post di Willison dell’11 settembre 2026¹.

La nota finale è implicita nel formato scelto: un blog che tiene il passo giorno per giorno riduce l’onboarding. Se la libreria guadagnerà attenzione, la documentazione c’è già, e cresce alla stessa velocità¹.