Logbook Changelog

Version 1.7.0

Released on October 3rd, 2023

  • Dropped support for Python 3.7

  • Passing (keyfile, certfile) to MailHandler’s secure argument is deprecated in favour of passing an ssl.SSLContext.

  • Python 3.12 support

Version 1.6.0

Released on July 30th, 2023

  • Dropped support for Python 2.7, 3.5, and 3.6.

  • Uses pyproject.toml based build.

  • Added nteventlog extra for NTEventLogHandler.

  • Supports SQLAlchemy 1.4 and 2.0.

  • Fix various deprecation warnings.

  • exc_info arg may be a BaseException instance (thanks Mattijs Ugen)

  • FileHandler supports path-like objects.

  • Fixed bug which prevented compilation on Cython 3

  • Wheels are generated for more platforms and architectures

Version 1.5.3

Released on October 16th, 2019

  • Fixed deprecated imports from collections module.

Version 1.5.2

Released on August 21st, 2019

  • No changes

Version 1.5.1

Released on August 20th, 2019

  • Added support for asyncio and contextvars

Version 1.4.3

Released on January 16th, 2019

  • Fixed Pypi release for 1.4.2

Version 1.4.2

Released on December 11th, 2018

  • Use correct record delimiters (null for UNIX, newline for network) in SyslogHandler (thanks Jonathan Kamens)

  • Try to reconnect to SyslogHandler TCP sockets when they are disconnected (thanks Jonathan Kamens)

  • Use RFC 5424 format for networking logging in SyslogHandler (thanks Jonathan Kamens)

Here you can see the full list of changes between each Logbook release.

Version 1.4.1

Released on October 14th, 2018

  • Fixed deprecated regular expression pattern (thanks Tsuyoshi Hombashi)

  • Fixed TimedRotatingFileHandler rotation (thanks Tucker Beck)

Version 1.4.0

Released on May 15th, 2018

  • Added support for checking if trace logs have been emitted in TestHandler (thanks @thedrow)

Version 1.3.0

Released on March 5th, 2018

  • Added support for controlling rotating file names – Logbook now allows users to customize the formatting of rollover/rotating files (thanks Tucker Beck)

Version 1.2.0

Released on February 8th, 2018

  • Added support for compressed log files, supporting both gzip and brotli compression methods (thanks Maor Marcus)

  • Fixed CPU usage for queuing handlers (thanks Adam Urbańczyk)

Version 1.1.0

Released on July 13th 2017

  • Added a handler for Riemann (thanks Šarūnas Navickas)

  • Added a handler for Slack (thanks @jonathanng)

  • Colorizing mixin can now force coloring on or off (thanks @ayalash)

Version 1.0.1

  • Fix PushOver handler cropping (thanks Sébastien Celles)

VERSION 1.0.0

Released on June 26th 2016

  • Added support for timezones for log timestamp formatting (thanks Mattijs Ugen)

  • Logbook has been a 0.x long enough to earn its 1.0.0 bump!

  • Logbook now uses SemVer for its versioning scheme

  • Various improvements to MailHandler and the usage of TLS/SMTP SSL (thanks Frazer McLean)

  • Fix log colorizing on Windows (thanks Frazer McLean)

  • Coverage reports using coveralls.io

  • Dropped compatibility for Python 3.2. At this point we did not actually remove any code that supports it, but the continuous integration tests no longer check against it, and we will no longer fix compatibility issues with 3.2.

  • Better coverage and tests on Windows (thanks Frazer McLean)

  • Added enable() and disable() methods for loggers (thanks Frazer McLean)

  • Many cleanups and overall project improvements (thanks Frazer McLean)

Version 0.12.0

Released on November 24th 2015

  • Added logbook.utils.deprecated to automatically emit warnings when certain functions are called (Thanks Ayala Shachar)

  • Added logbook.utils.suppressed_deprecations context to temporarily suppress deprecations (Thanks Ayala Shachar)

  • Added logbook.utils.logged_if_slow to emit logs when certain operations exceed a time threshold (Thanks Ayala Shachar)

  • Many PEP8 fixes and code cleanups (thanks Taranjeet Singh and Frazer McLean)

  • TestHandler constructor now receives an optional force_heavy_init=True, forcing all records to heavy-initialize

Version 0.11.3

Released on November 5th 2015

  • Windows-specific fixes and CI configuration (Thanks Frazer McLean)

  • Several Unicode-specific fixes (Thanks Frazer McLean)

  • Documentation cleanups

Version 0.11.2

Released on September 29th 2015

  • Fix importing issue with SQLAlchemy ticketing handler

Version 0.11.0

Released on September 29th 2015

  • Added TRACE log level for enabling logs below DEBUG

  • Improved SQLAlchemy session management (thanks @fintan)

  • Removed the bubble argument from NullHandler, preventing many future confusions

Version 0.10.1

Released on August 4th 2015

  • Small bugfix supporting exc_info=False without breaking formatting

Version 0.10.0

Released on July 14th 2015

  • Removed the global handler which was installed by default so far. The rationale is to ease adoption for 3rd party libraries who don’t want output to go to stderr by default. The old behavior can still be restored by setting the LOGBOOK_INSTALL_DEFAULT_HANDLER environment variable

  • Fix small Python 3 compatibility issues

Version 0.9.1

Released on May 4th 2015

  • Minor fixes

Version 0.9.0

Released on February 12th 2015

  • Added frame correction option, to properly mark log record origins (Thanks Roey Darwish)

  • Fixed MailHandler infinite recursion bug (Thanks Tal Yalon)

Version 0.8.1

Released on November 30th 2014

  • Fix support for gevent, along with various other fixes (Thanks Tal Yalon)

Version 0.8.0

Released on November 11th 2014. Codename “improve_some_more”

  • Added Pushover handler (thanks @owo)

  • Default logging format now includes seconds and microseconds (#110)

  • Several fixes regarding possible deadlocks in log formatting (thanks Guy Rozendorn)

  • Fixed packaging so that the speedups module now gets packaged by default (#122)

  • ThreadedWrapperHandler now supports maxsize (#121) (thanks Ken Jung)

  • Fixes in rotating handlers (thanks zhangliyong)

  • Added Pushover handler (thanks Ossama W. Obeid)

  • RedisHandler now supports lpush as an option (thanks Bruno Rocha)

Version 0.7.0

Released on May 12th 2014. Codename “not_just_yet”

  • Restored Python 3.2 support (thanks @rnortman)

  • NullHandlers now respect filters - allows to only drop/mute certain records (#73)

  • redirect_logging now sets the legacy root logger’s level to DEBUG by default. This can be changed by specifying set_root_logger_level=False (#96)

  • Bugfixes

Version 0.6.0

Released on October 3rd 2013. Codename “why_not_production_ready”

  • Added Redis handler (Thanks a lot @guillermo-carrasco for this PR)

  • Fixed email encoding bug (Thanks Raphaël Vinot)

Version 0.5.0

Released on August 10th 2013.

  • Drop 2.5, 3.2 support, code cleanup

  • The exc_info argument now accepts True, like in the standard logging module

Version 0.4.2

Released on June 2nd 2013.

  • Fixed Python 3.x compatibility, including speedups

  • Dropped Python 2.4 support. Python 2.4 support caused a lot of hacks in the code and introduced duplication to the test code. In addition, it is impossible to cover 2.4-3.x with a single tox installation, which may introduce unwitting code breakage. Travis also does not support Python 2.4 so the chances of accidentally breaking this support were very high as it was…

Version 0.4.1

Released on December 12th. Codename “121212”

Version 0.4

Released on October 24th. Codename “Phoenix”

  • Added preliminary RabbitMQ and CouchDB support.

  • Added logbook.notifiers.NotifoHandler

  • channel is now documented to be used for filtering purposes if wanted. Previously this was an opaque string that was not intended for filtering of any kind.

Version 0.3

Released on October 23rd. Codename “Informant”

Version 0.2.1

Bugfix release, Released on September 22nd.

  • Fixes Python 2.5 compatibility.

Version 0.2

Released on September 21st. Codename “Walls of Text”

  • Implemented default with statement for handlers which is an alias for threadbound.

  • applicationbound and threadbound return the handler now.

  • Implemented channel recording on the log records.

  • The logbook.more.FingersCrossedHandler now is set to ERROR by default and has the ability to create new loggers from a factory function.

  • Implemented maximum buffer size for the logbook.more.FingersCrossedHandler as well as a lock for thread safety.

  • Added ability to filter for context.

  • Moved bubbling flags and filters to the handler object.

  • Moved context processors on their own stack.

  • Removed the iter_context_handlers function.

  • Renamed NestedHandlerSetup to NestedSetup because it can now also configure processors.

  • Added the logbook.Processor class.

  • There is no difference between logger attached handlers and context specific handlers any more.

  • Added a function to redirect warnings to logbook (logbook.compat.redirected_warnings()).

  • Fixed and improved logbook.LoggerGroup.

  • The logbook.TestHandler now keeps the record open for further inspection.

  • The traceback is now removed from a log record when the record is closed. The formatted traceback is a cached property instead of a function.

  • Added ticketing handlers that send logs directly into a database.

  • Added MongoDB backend for ticketing handlers

  • Added a logbook.base.dispatch_record() function to dispatch records to handlers independently of a logger (uses the default record dispatching logic).

  • Renamed logger_name to channel.

  • Added a multi processing log handler (logbook.more.MultiProcessingHandler).

  • Added a twitter handler.

  • Added a ZeroMQ handler.

  • Added a Growl handler.

  • Added a Libnotify handler.

  • Added a monitoring file handler.

  • Added a handler wrapper that moves the actual handling into a background thread.

  • The mail handler can now be configured to deliver each log record not more than n times in m seconds.

  • Added support for Python 2.5

  • Added a logbook.queues.SubscriberGroup to deal with multiple subscribers.

  • Added a logbook.compat.LoggingHandler for redirecting logbook log calls to the standard library’s logging module.

Version 0.1

First public release.