repoze.errorlog

repoze.errorlog реалізує WSGI проміжного фільтра, який перехоплює виключення і записує їх у модулі реєстрації Python каналу і NBSP; (або wsgi.errors FILEHANDLE, якщо канал не налаштований). Вона також дозволяє перегляду обмеженого історії винятків через інтерфейс браузера.
Конфігурація
Якщо ви хочете використовувати налаштування за замовчуванням, ви можете просто включити фільтр в PasteDeploy трубопроводу вашого застосування, наприклад:
[Трубопроводу: головну]
Трубопровід = яйце: Вставити # cgitb
І NBSP; яйце: repoze.errorlog # ErrorLog
І NBSP; YourApp
Якщо ви хочете, щоб перевизначити конфігурацію за замовчуванням, потрібно зробити окремий розділ для фільтра. Параметри конфігурації Вставити в цей час є канал, зберігати і шлях. Щоб налаштувати repoze.errorlog використовувати реєстрації Repoze канал, який посилає на лісоповал каналу як якщо б ви відправити його в логгер від коду, де ви робили 'з реєстрації getLogger імпорту; Реєстратор = getLogger ("Repoze") "і зберегти 50 ел.пошти навколо через-веб-перегляду виняток, налаштувати так:
[Фільтр: ErrorLog]
канал = Repoze
тримати = 50
PATH = / __ my_error_log__
ігнорувати = RuntimeError my.module: MyError
За замовчуванням, жоден канал не буде налаштована, а ел.пошти направляються в wsgi.errors Дескриптор файлу (який повинен привести до помилки, щоб показати в журналі помилок вашого сервера). За замовчуванням, довжина історія виняток ('тримати') 20.
За замовчуванням, шлях журналі помилок системи / __ error_log__; Ви можете змінити це необхідним для розгортання.
Ігнорувати параметр запобігає винятку названі від того увійшли або тримати в історії виключення (хоча вони ре-рейз). За замовчуванням, ніякі виняток, не ігноруються.
Щоб використовувати реконфигурировать фільтр в трубопроводі:
[Трубопроводу: головну]
Трубопровід = яйце: Вставити # cgitb
І NBSP; ErrorLog
І NBSP; YourApp
Якщо ви не використовуєте PasteDeploy, ви можете налаштувати ErrorLog проміжне вручну:
НЕ додаток = ErrorLog (додаток, канал = None, тримати = 20, шлях = '/ __ error_log__',
І NBSP; ignored_exceptions = ())

Використання
Для перегляду останніх ел.пошти через ваш браузер (історія винятків), відвідайте / __ error_log__ шлях в ім'я хоста, який представляє ваш сервер. Подивитися будуть представлені показуючи вам всі останні пошту. Натиснувши на одну приведе вас на сторінку, яка показує вам відслідковує і надання навколишнього середовища 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; PATH = середу ['repoze.errorlog.path']
І NBSP; запис = середу ['repoze.errorlog.entryid']
І NBSP; URL = construct_url (середа, path_info = шлях,
І NBSP; рядка запиту = "Вступ =% S '% початкового)

Що нового У цьому випуску:

• Цей реліз останній, який займатиметься підтримкою Python 2.4 / Python 2.5.
• Додана підтримка для безперервної інтеграції з використанням Струмі і Дженкінс.
• Додана підтримка PyPy.
• долучення "setup.py DEV" псевдонім (працює setup.py розробки плюс встановлює ніс і освітлення).
• Переїхав в GitHub.

Вимоги

• Python