repoze.errorlog

repoze.errorlog implementerar en WSGI middle filter som fångar upp undantag och skriver dem till en Python loggning modul kanal & nbsp; (eller wsgi.errors filehandle, om ingen kanal är konfigurerad). Det gör också att bläddra på begränsat undantag historia via en webbläsare UI.
Konfiguration
Om du vill använda standardkonfigurationen, kan du bara inkludera filtret i programmets PasteDeploy pipeline, t.ex:
[Pipeline: main]
rörledning = ägg: Klistra # cgitb
& Nbsp; ägg: repoze.errorlog # errorlog
& Nbsp; yourapp
Om du vill åsidosätta standardkonfigurationen måste du göra en separat avdelning för filtret. Pastan konfigurationsalternativ vid denna tid är kanalen, håll och sökväg. För att konfigurera repoze.errorlog att använda Repoze loggning kanalen, som skickar till loggningskanalen som om du hade skicka till en logger från koden där du gjorde "från avverkning import getLogger; logger = getLogger ("Repoze") och för att hålla 50 tracebacks runt för through-the-web undantaget visning, konfigurera som så:
[Filter: errorlog]
kanal = Repoze
hålla = 50
path = / __ my_error_log__
ignorera = RuntimeError my.module: MyError
Som standard är ingen kanal konfigurerad och tracebacks skickas till wsgi.errors filen handtaget (vilket bör leda till felen att visa upp i din servers fellogg). Som standard är undantaget historik längd ("hålla") 20.
Som standard är felloggen väg / __ error_log__; Du kan ändra detta som behövs för distributionen.
Den ignorerar parametern förhindrar de undantag som nämns från att registreras eller hållas i undantags historia (även om de är reraised). Som standard är inga undantag ignoreras.
För att använda konfigureras filtret på gång:
[Pipeline: main]
rörledning = ägg: Klistra # cgitb
& Nbsp; errorlog
& Nbsp; yourapp
Om du inte använder PasteDeploy, kan du konfigurera errorlog middle manuellt:
app = errorlog (app, kanal = Ingen, håll = 20, path = '/ __ error_log__',
& Nbsp; ignored_exceptions = ())

Användning
Om du vill visa de senaste tracebacks via din webbläsare (undantag historik), besöka / __ error_log__ vägen vid värdnamn som representeras av din server. En vy kommer att presenteras som visar alla de senaste tracebacks. Genom att klicka på en kommer du till en sida som visar dig spårnings och en återgivning av WSGI miljö som var närvarande vid tidpunkten undantaget inträffade.
Integrera
När repoze.errorlog placeras i rörledningen, två nycklar placeras i wsgi miljön på varje begäran (även om ett undantag inte höjs och fångas av repoze.errorlog):
& Nbsp; repoze.errorlog.path - banan där errorlog är konfigurerad
& Nbsp; repoze.errorlog.entryid - posten id nästa felet
Middleware och applikationer som fångar undantag kan komponera en URL
till den aktuella felet (för hjälp utveckling återkoppling) när de
vet repoze.errorlog är på gång med hjälp av följande kod ::
& Nbsp; från paste.request import construct_url
& Nbsp; path = miljö ['repoze.errorlog.path']
& Nbsp; posten = miljö ['repoze.errorlog.entryid']
& Nbsp; url = construct_url (miljö, PATH_INFO = stig,
& Nbsp; queryString = inträde =% s '% inträde)

Vad är nytt i den här versionen:

• Det här utgåvan det sista som kommer att upprätthålla stöd för Python 2.4 / Python 2.5.
• Utökat stöd för kontinuerlig integration med hjälp tox och jenkins.
• Stöd för PyPy.
• Lade "setup.py dev 'alias (körningar setup.py utveckla plus installerar näsa och täckning).
• Flyttade till github.

Krav :

• Python