repoze.errorlog

repoze.errorlog implementerer en WSGI middleware filter, som opfanger undtagelser og skriver dem til en Python logning modul kanal & nbsp; (eller wsgi.errors filehandle, hvis ingen kanal er konfigureret). Det giver også gennemse begrænset undtagelse historie via en browser UI.
Konfiguration
Hvis du ønsker at bruge standard konfiguration, kan du bare inkludere filteret i din ansøgning PasteDeploy pipeline, fx:
[Pipeline: main]
rørledning = æg: Paste # cgitb
& Nbsp; æg: repoze.errorlog # errorlog
& Nbsp; yourapp
Hvis du vil tilsidesætte standardkonfigurationen, skal du lave en separat sektion for filteret. Pastaen konfigurationsmuligheder på dette tidspunkt er kanal, holde og sti. Sådan konfigureres repoze.errorlog at bruge Repoze logning kanal, der sender til logning kanal som hvis du havde send til en logger fra kode, hvor du gjorde 'fra skovhugst import getLogger; logger = getLogger ("Repoze«) «og til at holde 50 tracebacks rundt for through-the-web undtagelsen visning, konfigurerer som så:
[Filter: errorlog]
kanal = Repoze
holde = 50
sti = / __ my_error_log__
ignorere = Runtimeerror my.module: MyError
Som standard er ingen kanal konfigureret, og tracebacks sendes til wsgi.errors fil håndtaget (som skulle forårsage fejl at dukke op i din servers fejllog). Som standard undtagelsen historie længde ("holde") er 20.
Som standard fejlloggen vej er / __ error_log__; du kan ændre dette som nødvendigt for din implementering.
Den ignorerer parameter forhindrer de undtagelser, der er nævnt i at blive registreret eller holdes i undtagelse historie (selvom de er reraised). Som standard er ingen undtagelser ignoreres.
Hvis du vil bruge omkonfigureres filter i støbeskeen:
[Pipeline: main]
rørledning = æg: Paste # cgitb
& Nbsp; errorlog
& Nbsp; yourapp
Hvis du ikke bruger PasteDeploy, kan du konfigurere ErrorLog middleware manuelt:
app = ErrorLog (app, kanal = Ingen, holde = 20, sti = '/ __ error_log__ «,
& Nbsp; ignored_exceptions = ())

Anvendelse
Hvis du vil se de seneste tracebacks via din browser (undtagelse historie), besøg / __ error_log__ sti på værtsnavnet repræsenteret af din server. En visning vil blive præsenteret som viser dig alle de seneste tracebacks. Hvis du klikker på en vil bringe dig til en side, der viser dig tilbagesporingsprocessen og en gengivelse af WSGI miljø, der var til stede på det tidspunkt undtagelsen opstod.
Integration
Når repoze.errorlog placeres i rørledningen, er to nøgler placeres i WSGI miljøet ved enhver anmodning (selv når en undtagelse ikke er hævet og fanget af repoze.errorlog):
& Nbsp; repoze.errorlog.path - stien, hvor errorlog er konfigureret
& Nbsp; repoze.errorlog.entryid - posten id af den næste fejl
Middleware og applikationer, der fanger undtagelser kan komponere en URL
til den aktuelle fejl (om feedback nyttig udvikling), når de
kender repoze.errorlog er på vej ved at bruge følgende kode ::
& Nbsp; fra paste.request import construct_url
& Nbsp; sti = miljø ['repoze.errorlog.path']
& Nbsp; post = miljø ['repoze.errorlog.entryid']
& Nbsp; url = construct_url (miljø, PATH_INFO = sti,
& Nbsp; QueryString = 'post =% s'% indrejse)

Hvad er nyt i denne udgivelse:

• Denne udgivelse er det sidste der vil opretholde støtten til Python 2.4 / Python 2.5.
• Tilføjet understøttelse af løbende integration ved hjælp tox og Jenkins.
• Tilføjet understøttelse af PYPY.
• Tilføjet 'setup.py dev' alias (kørsler setup.py udvikle plus installerer næse og dækning).
• Flyttet til GitHub.

Krav :

• Python