repoze.errorlog

repoze.errorlog implementuje WSGI middleware filtr, který zachycuje výjimky, a zapíše je do kácení Python modulu kanálu & nbsp; (nebo wsgi.errors filehandle, pokud není nakonfigurován žádný kanál). To také umožňuje procházení historie omezené výjimky přes prohlížeč UI.
Configuration
Chcete-li použít výchozí nastavení, můžete jen patří filtr v vaše aplikace PasteDeploy potrubí, např:
[Potrubí: hlavní]
potrubí = vejce: Pasta # cgitb
& Nbsp; vejce: repoze.errorlog # errorlog
& Nbsp; yourapp
Chcete-li přepsat výchozí nastavení, je třeba, aby se pro filtr samostatnou sekci. Možnosti konfigurace Paste v této době jsou kanálu, držet a cesta. Chcete-li konfigurovat repoze.errorlog používat protokolování Repoze kanál, který vysílá na protokolování kanálu, jako kdybyste poslat záznamníku z kódu, kde jste udělali "z těžebního dovozního getLogger; logger = getLogger ("Repoze") "a udržet 50 tracebacks kolem přes-the-web výjimka ze sledování, nakonfigurujte jako tak:
[Filter: errorlog]
channel = Repoze
zachovat = 50
path = / __ my_error_log__
ignorovat = RuntimeError my.module: MyError
Ve výchozím nastavení, žádný kanál je konfigurován, a tracebacks jsou zaslány na wsgi.errors souboru rukojeti (což by mělo chyby se ukázat v protokolu chyb vašeho serveru). Ve výchozím nastavení, délka historie výjimka ("držet"), je 20.
Ve výchozím nastavení je cesta protokol chyb je / __ error_log__; můžete změnit podle potřeby pro nasazení.
Parametr ignorovat zabraňuje výjimky pojmenované před přihlásit, nebo aby byly v historii výjimek (ačkoli oni jsou re-raise). Ve výchozím nastavení, žádné výjimky jsou ignorovány.
Chcete-li použít přetvořené filtr v potrubí:
[Potrubí: hlavní]
potrubí = vejce: Pasta # cgitb
& Nbsp; errorlog
& Nbsp; yourapp
Pokud nepoužíváte PasteDeploy, můžete nakonfigurovat ErrorLog middleware ručně:
app = ErrorLog (app, kanál = None, mějte = 20, path = '/ __ error_log__ ",
& Nbsp; ignored_exceptions = ())

Použití
Chcete-li zobrazit poslední tracebacks prostřednictvím prohlížeče (historie výjimka), navštivte / __ error_log__ dráhu na hostname tedy vašem serveru. Pohled bude předloženo zobrazující všechny nedávné tracebacks. Kliknutím na jeden se dostanete na stránku, která vám ukazuje TraceBack a vykreslení WSGI prostředí, které byl přítomen v době, kdy došlo k výjimce.
Integrace
Je-li repoze.errorlog umístěn do potrubí, dva klíče jsou umístěny do WSGI životního prostředí o každé žádosti (i když se výjimka není zvednutý a zachytil repoze.errorlog):
& Nbsp; repoze.errorlog.path - dráha, na které je uspořádán errorlog
& Nbsp; repoze.errorlog.entryid - vstup id příštího chyby
Middleware a aplikace, které loví výjimky může vytvářet URL
na aktuální chyby (užitečné informace o vývoj), když
vím, repoze.errorlog je v potrubí pomocí následující kód ::
& Nbsp; z paste.request dovozu construct_url
& Nbsp; path = prostř ['repoze.errorlog.path']
& Nbsp; entry = prostř ['repoze.errorlog.entryid']
& Nbsp; url = construct_url (prostř, PATH_INFO = cesta,
& Nbsp; QueryString = 'vstup =% s' entry%)

Co je nového v této verzi:

• Tato verze je poslední, která se bude udržovat podporu pro Python 2.4 / Python 2.5.
• Byla přidána podpora pro kontinuální integraci pomocí tox a Jenkinse.
• Přidána podpora pro PyPy.
• Added "setup.py dev" alias (běží setup.py rozvíjet a nainstaluje nos a pokrytí).
• Přesunuto do GitHub.

Požadavky na :

• Python