repoze.errorlog

repoze.errorlog implementa un filtro WSGI middleware che intercetta le eccezioni e li scrive una registrazione Python canale del modulo & nbsp; (o le wsgi.errors filehandle, se nessun canale è configurato). Consente inoltre la navigazione della storia eccezione limitata tramite un interfaccia utente del browser.
Configurazione
Se si desidera utilizzare la configurazione predefinita, si può semplicemente inserire il filtro nella conduttura PasteDeploy dell'applicazione, ad esempio:
[Gasdotto: main]
gasdotto = uovo: Paste # cgitb
& Nbsp; uovo: repoze.errorlog # errorlog
& Nbsp; yourapp
Se si desidera ignorare la configurazione predefinita, è necessario fare una sezione separata per il filtro. Le opzioni di configurazione Incolla in questo momento sono il canale, mantenere e il percorso. Per configurare repoze.errorlog di utilizzare il canale di registrazione Repoze, che invia al canale di registrazione come se si fosse inviare a un logger di codice in cui l'avete fatto 'dal disboscamento import getLogger; logger = getLogger ("Repoze") 'e per mantenere 50 traceback giro per through-the-web di visualizzazione eccezione, configurare in questo modo:
[Filtro: errorlog]
channel = Repoze
mantenere = 50
path = / __ my_error_log__
ignorare = RuntimeError my.module: MyError
Per impostazione predefinita, nessun canale è configurato, e traceback vengono inviati al gestore di file wsgi.errors (che dovrebbe causare gli errori di presentarsi in log degli errori del server). Per impostazione predefinita, la lunghezza della storia eccezione ('tenere') è 20.
Per impostazione predefinita, il percorso del log degli errori è / __ error_log__; è possibile modificare questo come necessario per la distribuzione.
Il parametro di ignorare impedisce le eccezioni denominati vengano registrati o tenuti nella storia eccezione (anche se sono contro rilanciato). Per impostazione predefinita, senza eccezioni vengono ignorati.
Per utilizzare il filtro riconfigurato in cantiere:
[Gasdotto: main]
gasdotto = uovo: Paste # cgitb
& Nbsp; errorlog
& Nbsp; yourapp
Se non si utilizza PasteDeploy, è possibile configurare il middleware ErrorLog manualmente:
app = ErrorLog (app, canale = None, mantenere = 20, path = '/ __ error_log__',
& Nbsp; ignored_exceptions = ())

Uso
Per visualizzare le recenti traceback tramite il browser (cronologia eccezione), visitare il percorso / __ error_log__ al hostname rappresentato dal server. Una vista sarà presentato mostrando tutti traceback recenti. Cliccando su una vi porterà ad una pagina che mostra il traceback e un rendering dell'ambiente WSGI che era presente al momento si è verificata l'eccezione.
Integrazione
Quando repoze.errorlog viene inserito nella tubazione, due chiavi sono posti nell'ambiente WSGI su ogni richiesta (anche se un'eccezione non viene generato e catturato da repoze.errorlog):
& Nbsp; repoze.errorlog.path - il percorso in cui il log degli errori è configurata
& Nbsp; repoze.errorlog.entryid - l'id ingresso del prossimo errore
Middleware e le applicazioni che catturano le eccezioni possono comporre una URL
per l'errore corrente (per il feedback utili allo sviluppo) quando
conoscere repoze.errorlog è in cantiere, utilizzando il seguente codice ::
& Nbsp; da paste.request construct_url import
& Nbsp; path = environ ['repoze.errorlog.path']
& Nbsp; ingresso = environ ['repoze.errorlog.entryid']
& Nbsp; url = construct_url (environ, PATH_INFO = percorso,
& Nbsp; querystring = 'ingresso =% s' entrata%)

Cosa c'è di nuovo in questa versione:

• Questa versione è l'ultima che manterrà il supporto per Python 2.4 / Python 2.5.
• Aggiunto il supporto per l'integrazione continua con tox e Jenkins.
• Supporto di PyPy.
• Aggiunto 'dev setup.py' alias (piste setup.py sviluppano più installa naso e la copertura).
• Spostato a github.

Requisiti :

• Python