repoze.errorlog

repoze.errorlog εφαρμόζει ένα φίλτρο WSGI middleware, το οποίο αναχαιτίζει τις εξαιρέσεις και τους γράφει σε Python υλοτομίας ενότητα κανάλι & nbsp? (Ή οι wsgi.errors filehandle, εάν κανένα κανάλι έχει ρυθμιστεί). Επίσης, επιτρέπει την περιήγηση των περιορισμένων ιστορία εξαίρεση να γίνει μέσω ενός προγράμματος περιήγησης UI.
Διαμόρφωση
Αν θέλετε να χρησιμοποιήσετε την προεπιλεγμένη ρύθμιση, μπορείτε να συμπεριλάβετε μόνο το φίλτρο PasteDeploy αγωγού της εφαρμογής σας, για παράδειγμα:
[Αγωγού: κύρια]
Αγωγός = αυγό: Επικόλληση # cgitb
& Nbsp? Αυγό: repoze.errorlog # errorlog
& Nbsp? Yourapp
Αν θέλετε να παρακάμψετε την προεπιλεγμένη ρύθμιση, θα πρέπει να κάνει μια ξεχωριστή ενότητα για το φίλτρο. Οι επιλογές διαμόρφωσης Επικόλληση αυτή τη στιγμή είναι το κανάλι, να κρατήσει και τη διαδρομή. Για να ρυθμίσετε repoze.errorlog να χρησιμοποιήσετε το κανάλι Repoze υλοτομία, η οποία στέλνει στο κανάλι υλοτομία αν είχε στείλει σε ένα καταγραφικό από τον κώδικα όπου κάνατε »από την υλοτομία getLogger εισαγωγής? καταγραφικό = getLogger ("Repoze") »και να κρατήσει το 50 tracebacks γύρω για through-the-προβολή ιστοσελίδων εξαίρεση, να διαμορφώσετε όπως έτσι:
[Φίλτρο: errorlog]
κανάλι = Repoze
κρατήσει = 50
path = / __ my_error_log__
αγνοούν = RuntimeError my.module: MyError
Από προεπιλογή, κανένα κανάλι έχει διαμορφωθεί, και tracebacks αποστέλλονται στη λαβή αρχείο wsgi.errors (η οποία θα πρέπει να προκαλέσει τα λάθη για να εμφανιστούν στο αρχείο καταγραφής σφαλμάτων του διακομιστή σας). Από προεπιλογή, το μήκος ιστορία εξαίρεση («κρατήσει») είναι 20.
Από προεπιλογή, η πορεία της καταγραφής σφαλμάτων είναι / __ error_log__? μπορείτε να αλλάξετε αυτή ως αναγκαία για την ανάπτυξή σας.
Η παράμετρος αγνοούν εμποδίζει τις εξαιρέσεις που ονομάζεται από το να εισέλθει ή να παραμείνει στην ιστορία εξαίρεση (αν και κάνει re-raise). Από προεπιλογή, δεν υπάρχουν εξαιρέσεις αγνοούνται.
Για να χρησιμοποιήσετε το φίλτρο αναδιαρθρώνεται σε εξέλιξη:
[Αγωγού: κύρια]
Αγωγός = αυγό: Επικόλληση # cgitb
& Nbsp? Errorlog
& Nbsp? Yourapp
Αν δεν χρησιμοποιείτε PasteDeploy, μπορείτε να ρυθμίσετε το middleware ErrorLog χειροκίνητα:
app = ErrorLog (app, το κανάλι = Κανένα, να κρατήσει = 20, διαδρομή = "/ __ error_log__»,
& Nbsp? Ignored_exceptions = ())

Χρήση
Για να δείτε τις πρόσφατες tracebacks μέσω του browser (ιστορικό εξαίρεση) σας, επισκεφθείτε την / __ διαδρομή error_log__ στο όνομα που αντιπροσωπεύεται από το διακομιστή σας. Μια άποψη θα παρουσιαστούν σας δείχνει όλες τις πρόσφατες tracebacks. Κάνοντας κλικ σε μία από αυτές θα σας φέρει σε μια σελίδα που σας δείχνει το traceback και μια απόδοση του WSGI περιβάλλον που ήταν παρόντες κατά τη στιγμή παρουσιάστηκε η εξαίρεση.
Ολοκλήρωση
Όταν repoze.errorlog τοποθετείται μέσα στον αγωγό, τα δύο κλειδιά τοποθετούνται στο περιβάλλον WSGI για κάθε αίτηση (ακόμη και όταν η εξαίρεση δεν αυξάνεται και έχουν αλιευθεί με repoze.errorlog):
& Nbsp? Repoze.errorlog.path - η διαδρομή κατά την οποία η errorlog έχει ρυθμιστεί
& Nbsp? Repoze.errorlog.entryid - Το αναγνωριστικό εισόδου του επόμενου λάθους
Middleware και εφαρμογές που πιάνουν εξαιρέσεις μπορούν να συνθέσουν ένα URL
στο τρέχον σφάλμα (για χρήσιμη ανατροφοδότηση της ανάπτυξης), όταν
γνωρίζουν repoze.errorlog είναι σε εξέλιξη με τη χρήση του παρακάτω κώδικα ::
& Nbsp? Από paste.request construct_url εισαγωγής
& Nbsp? Μονοπάτι = Environ [«repoze.errorlog.path»]
& Nbsp? Εισόδου = Environ [«repoze.errorlog.entryid»]
& Nbsp? Url = construct_url (Environ, PATH_INFO = διαδρομή,
& Nbsp? QueryString = "εισόδου =% s 'την είσοδο%)

Τι είναι καινούργιο σε αυτήν την έκδοση:

• Αυτή η έκδοση είναι το τελευταίο πράγμα που θα διατηρήσουν την υποστήριξη για την Python 2.4 / Python 2.5.
• Προστέθηκε υποστήριξη για τη διαρκή ενσωμάτωση χρησιμοποιώντας tox και Jenkins.
• Προστέθηκε υποστήριξη για PyPy.
• «setup.py dev» Προστέθηκε ψευδώνυμο (τρέχει setup.py αναπτυχθεί και να εγκαθιστά τη μύτη και κάλυψη).
• Μεταφέρθηκε στο GitHub.

Απαιτήσεις :

• Python