Wrapture: Dumpleton presenta una libreria Python per monkeypatching, test e tracing

“Attaccare osservazione a codice che non controlli, registrare cosa ci scorre dentro, e farlo senza disturbare il programma osservato”. Graham Dumpleton presenta così Wrapture, libreria Python mostrata il 31 agosto 2026 sul link blog di Simon Willison¹. L’obiettivo è pratico: avvolgere funzioni e metodi per osservare chiamate e argomenti, oppure forzare il valore di ritorno. Un unico strumento per due usi comuni: alternativa a unittest.mock nei test e tracing su progetti esistenti¹.

Il meccanismo chiave è il wrapping. Si “mette una guaina” attorno a una funzione o a un metodo. Da lì si può registrare come viene usata, o sostituirne l’output quando serve. Dumpleton richiama esplicitamente l’eredità di wrapt, e il percorso personale che lo ha portato da quel monkeypatching a un’integrazione tra mocking e tracciamento¹.

Configurazione al centro. L’annuncio mostra un file TOML che abilita l’osservazione senza toccare il codice applicativo. Si definisce cosa osservare, cosa catturare e dove salvare gli eventi. Ecco l’esempio pubblicato¹:

capture = "summary"

[[observe]]
target = "domain:Calculator"
name = ["outer", "inner"]

[[sink]]
type = "jsonlines"
path = "trace.jsonl"

Questa configurazione imposta una cattura “summary”. Osserva il target “domain:Calculator” per i nomi “outer” e “inner”. Scrive gli eventi in un sink “jsonlines” sul file “trace.jsonl”¹. Il messaggio è netto: si può aggiungere tracing a un progetto Python esistente tramite file di configurazione, senza inserire sonde nel codice¹.

Supporto a OpenTelemetry incluso. Willison sottolinea che Wrapture punta sia al rimpiazzo di unittest.mock nelle suite di test, sia all’attivazione del tracing in applicazioni già avviate, con un approccio dichiarativo e estendibile ai sistemi di osservabilità standard¹.

Il contesto dell’autore aiuta a leggere l’iniziativa. Dumpleton è noto per wrapt, mod_wsgi e per il lavoro sul Python agent di New Relic. Wrapture prosegue quella linea: tecniche di wrapping applicate, questa volta, a test e tracing nello stesso flusso operativo¹.

Stato del progetto: molto giovane. Willison parla di “poche settimane” di vita e lo definisce “molto promettente”. L’indicazione è di un cantiere in rapido movimento, già orientato a interoperare con OpenTelemetry e a offrire configurazioni dichiarative per l’osservazione¹.

Indicazioni pratiche. Il post di Willison rimanda al repository e alla documentazione di Wrapture; da lì si accede a esempi, guida e dettagli sull’uso in test e in produzione¹. L’esempio in pagina mostra anche l’emissione degli eventi su file in formato jsonlines, utile per ispezioni rapide o ingest in pipeline di analisi¹. Per chi deve osservare codice non controllato, questa via consente di iniziare con un file di configurazione e di sperimentare senza modifiche invasive.