- Update to 22.1.0:
Removed:
* Python 3.6 is not supported anymore.
* Pickling is now only possible with protocol version 3 and newer.
Deprecated:
* The entire structlog.threadlocal module is deprecated. Please use the
primitives from structlog.contextvars instead.
* If you're using the modern APIs (bind_threadlocal() / merge_threadlocal())
it's enough to replace them 1:1 with their contextvars counterparts. The old
approach around wrap_dict() has been discouraged for a while.
* Currently there are no concrete plans to remove the module, but no patches
against it will be accepted from now on. #409
Added:
* structlog.processors.StackInfoRenderer now has an additional_ignores
parameter that allows you to filter out your own logging layer. #396
* Added structlog.WriteLogger, a faster – but more low-level – alternative to
structlog.PrintLogger. It works the way PrintLogger used to work in previous
versions. #403#404
* structlog.make_filtering_bound_logger()-returned loggers now also have a
log() method to match the structlog.stdlib.BoundLogger signature closer. #413
* Added structured logging of tracebacks via the structlog.tracebacks module,
and most notably the structlog.tracebacks.ExceptionDictTransformer which can be
used with the new structlog.processors.ExceptionRenderer to render JSON
tracebacks. #407
* structlog.stdlib.recreate_defaults(log_level=logging.NOTSET) that recreates
structlog's defaults on top of standard library's logging. It optionally also
configures logging to log to standard out at the passed log level. #428
* structlog.processors.EventRenamer allows you to rename the hitherto
hard-coded event dict key event to something else. Optionally, you can rename
another key to event at the same time, too. So adding EventRenamer(to="msg",
OBS-URL: https://build.opensuse.org/request/show/990495
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-structlog?expand=0&rev=13
- Update to 21.5.0:
* Added the structlog.processors.LogfmtRenderer processor to render
log lines using the logfmt format. #376
* Added the structlog.stdlib.ExtraAdder processor that adds extra
attributes of logging.LogRecord objects to the event dictionary.
This processor can be used for adding data passed in the extra
parameter of the logging module's log methods to the event
dictionary. #209#377
* Added the structlog.processor.CallsiteParameterAdder processor that
adds parameters of the callsite that an event dictionary orginated
from to the event dictionary. This processor can be used to enrich
events dictionaries with information such as the function name,
line number and filename that an event dictionary orignated from. #380
- Update to 21.4.0:
* Fixed import when running in optimized mode (PYTHONOPTIMIZE=2
or python -OO). #373
* Added the structlog.threadlocal.bound_threadlocal and
structlog.contextvars.bound_contextvars decorator/context managers
to temporarily bind key/value pairs to a thread-local and context-local
context. #371
- Update to 21.3.0:
* structlog.dev.ConsoleRenderer now has sort_keys boolean parameter
that allows to disable the sorting of keys on output. #358
* structlog.processors.TimeStamper now works well with FreezeGun
even when it gets applied before the loggers are configured. #364
* structlog.stdlib.AsyncBoundLogger now determines the running loop
when logging, not on instantiation. That has a minor performance
impact, but makes it more robust when loops change
OBS-URL: https://build.opensuse.org/request/show/958252
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-structlog?expand=0&rev=12
- Update to 21.2.0:
Highlights:
* Support for for beautiful (and helpful!) exceptions by integrating
ConsoleRenderer with rich or better-exceptions.
* Helpers to access thread-local and context-local context.
* Deeper contextvars support.
Backward-incompatible changes:
* To implement pretty exceptions (see Changes below),
structlog.dev.ConsoleRenderer now formats exceptions itself.
Make sure to remove format_exc_info from your processor chain if you
configure structlog manually. This change is not really breaking
because the old use-case will keep working as before. However if
you pass pretty_exceptions=True (which is the default if either
rich or better-exceptions is installed), a warning will be raised
and the exception will be renderered without prettyfication.
Changes:
* structlog is now importable if sys.stdout is None (e.g. when
running using pythonw). #313
* structlog.threadlocal.get_threadlocal() and
structlog.contextvars.get_contextvars() can now be used to get a copy
of the current thread-local/context-local context that has been bound
using structlog.threadlocal.bind_threadlocal() and
structlog.contextvars.bind_contextvars(). #331#337
* structlog.threadlocal.get_merged_threadlocal(bl) and
structlog.contextvars.get_merged_contextvars(bl) do the same, but
also merge the context from a bound logger bl. Same pull requests as
previous change.
* structlog.contextvars.bind_contextvars() now returns a mapping of
keys to contextvars.Tokens, allowing you to reset values using the
new structlog.contextvars.reset_contextvars(). #339
OBS-URL: https://build.opensuse.org/request/show/925035
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-structlog?expand=0&rev=11
Backward-incompatible changes:
* Python 2.7 and 3.5 aren't supported anymore. The package meta
data should ensure that you keep getting 20.1.0 on those versions. #244
* structlog is now fully type-annotated. This won't break your
applications, but if you use Mypy, it will most likely break your CI.
Deprecations:
* Accessing the _context attribute of a bound logger is now deprecated.
Please use the new structlog.get_context().
Changes:
* structlog has now type hints for all of its APIs! Since structlog
is highly dynamic and configurable, this led to a few concessions
like a specialized structlog.stdlib.get_logger() whose only difference
to structlog.get_logger() is that it has the correct type hints.
We consider them provisional for the time being – i.e. the backward
compatibility does not apply to them in its full strength until we
feel we got it right. Please feel free to provide feedback! #223, #282
* Added structlog.make_filtering_logger that can be used like
configure(wrapper_class=make_filtering_bound_logger(logging.INFO)).
It creates a highly optimized bound logger whose inactive methods
only consist of a return None. This is now also the default logger.
* As a complement, structlog.stdlib.add_log_level() can now
additionally be imported as structlog.processors.add_log_level
since it just adds the method name to the event dict.
* structlog.processors.add_log_level() is now part of the default configuration.
* structlog.stdlib.ProcessorFormatter no longer uses exceptions for
control flow, allowing foreign_pre_chain processors to use
sys.exc_info() to access the real exception.
* Added structlog.BytesLogger to avoid unnecessary encoding round trips.
Concretely this is useful with orjson which returns bytes. #271
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-structlog?expand=0&rev=7
Backward-incompatible changes:
* Python 3.4 is not supported anymore. It has been unsupported by
the Python core team for a while now and its PyPI downloads are negligible.
It's very unlikely that structlog will break under 3.4 anytime soon,
but we don't test it anymore.
Changes:
* Full Python 3.8 support for structlog.stdlib.
* Added more pass-through properties to structlog.stdlib.BoundLogger.
To makes it easier to use it as a drop-in replacement for logging.Logger. #198
* structlog.stdlib.ProcessorFormatter now takes a logger object as an
optional keyword argument. This makes ProcessorFormatter work properly
with stuctlog.stdlib.filter_by_level(). #219
* structlog.dev.ConsoleRenderer now uses no colors by default, if
colorama is not available. #215
* structlog.dev.ConsoleRenderer now initializes colorama lazily, to
prevent accidental side-effects just by importing structlog. #210
* Added new processor structlog.dev.set_exc_info() that will set
exc_info=True if the method's name is exception and exc_info isn't
set at all. This is only necessary when the standard library integration
is not used. It fixes the problem that in the default configuration,
structlog.get_logger().exception("hi") in an except block would not print the
exception without passing exc_info=True to it explicitly. #130, #173, #200, #204
* A best effort has been made to make as much of structlog pickleable as possible
to make it friendlier with multiprocessing and similar libraries.
Some classes can only be pickled on Python 3 or using the dill library
though and that is very unlikely to change.
* So far, the configuration proxy, structlog.processor.TimeStamper,
structlog.BoundLogger, structlog.PrintLogger and structlog.dev.ConsoleRenderer
have been made pickelable. Please report if you need any another class fixed. #126
OBS-URL: https://build.opensuse.org/package/show/devel:languages:python/python-structlog?expand=0&rev=3
