1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540
|
Changelog
=========
Versions are year-based with a strict backward compatibility policy.
The third digit is only for regressions.
20.1.0 (2020-01-28)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
*none*
Deprecations:
^^^^^^^^^^^^^
- This is the last version to support Python 2.7 (including PyPy) and 3.5.
All following versions will only support Python 3.6 or later.
Changes:
^^^^^^^^
- Added a new module ``structlog.contextvars`` that allows to have a global but context-local ``structlog`` context the same way as with ``structlog.threadlocal`` since 19.2.0.
`#201 <https://github.com/hynek/structlog/issues/201>`_,
`#236 <https://github.com/hynek/structlog/pull/236>`_
- Added a new module ``structlog.testing`` for first class testing support.
The first entry is the context manager ``capture_logs()`` that allows to make assertions about structured log calls.
`#14 <https://github.com/hynek/structlog/issues/14>`_,
`#234 <https://github.com/hynek/structlog/pull/234>`_
- Added ``structlog.threadlocal.unbind_threadlocal()``.
`#239 <https://github.com/hynek/structlog/pull/239>`_
- The logger created by ``structlog.get_logger()`` is not detected as an abstract method anymore, when attached to an abstract base class.
`#229 <https://github.com/hynek/structlog/issues/229>`_
- ``colorama`` isn't initialized lazily on Windows anymore because it breaks rendering.
`#232 <https://github.com/hynek/structlog/issues/232>`_,
`#242 <https://github.com/hynek/structlog/pull/242>`_
----
19.2.0 (2019-10-16)
-------------------
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.
Deprecations:
^^^^^^^^^^^^^
*none*
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 <https://github.com/hynek/structlog/issues/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 <https://github.com/hynek/structlog/issues/219>`_
- ``structlog.dev.ConsoleRenderer`` now uses no colors by default, if ``colorama`` is not available.
`#215 <https://github.com/hynek/structlog/issues/215>`_
- ``structlog.dev.ConsoleRenderer`` now initializes ``colorama`` lazily, to prevent accidental side-effects just by importing ``structlog``.
`#210 <https://github.com/hynek/structlog/issues/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 <https://github.com/hynek/structlog/issues/130>`_,
`#173 <https://github.com/hynek/structlog/issues/173>`_,
`#200 <https://github.com/hynek/structlog/issues/200>`_,
`#204 <https://github.com/hynek/structlog/issues/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 <https://pypi.org/project/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 <https://github.com/hynek/structlog/issues/126>`_
- Added a new thread-local API that allows binding values to a thread-local context explicitly without affecting the default behavior of ``bind()``.
`#222 <https://github.com/hynek/structlog/issues/222>`_,
`#225 <https://github.com/hynek/structlog/issues/225>`_
- Added ``pass_foreign_args`` argument to ``structlog.stdlib.ProcessorFormatter``.
It allows to pass a foreign log record's ``args`` attribute to the event dictionary under the ``positional_args`` key.
`#228 <https://github.com/hynek/structlog/issues/228>`_
- ``structlog.dev.ConsoleRenderer`` now calls ``str()`` on the event value.
`#221 <https://github.com/hynek/structlog/issues/221>`_
----
19.1.0 (2019-02-02)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- As announced in 18.1.0, ``pip install -e .[dev]`` now installs all development dependencies.
Sorry for the inconveniences this undoubtedly will cause!
Deprecations:
^^^^^^^^^^^^^
*none*
Changes:
^^^^^^^^
- ``structlog.ReturnLogger`` and ``structlog.PrintLogger`` now have a ``fatal()`` log method.
`#181 <https://github.com/hynek/structlog/issues/181>`_
- Under certain (rather unclear) circumstances, the frame extraction could throw an ``SystemError: error return without exception set``.
A workaround has been added.
`#174 <https://github.com/hynek/structlog/issues/174>`_
- ``structlog`` now tolerates passing through ``dict``\ s to stdlib logging.
`#187 <https://github.com/hynek/structlog/issues/187>`_,
`#188 <https://github.com/hynek/structlog/pull/188>`_,
`#189 <https://github.com/hynek/structlog/pull/189>`_
----
18.2.0 (2018-09-05)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
*none*
Deprecations:
^^^^^^^^^^^^^
*none*
Changes:
^^^^^^^^
- Added ``structlog.stdlib.add_log_level_number()`` processor that adds the level *number* to the event dictionary.
Can be used to simplify log filtering.
`#151 <https://github.com/hynek/structlog/pull/151>`_
- ``structlog.processors.JSONRenderer`` now allows for overwriting the *default* argument of its serializer.
`#77 <https://github.com/hynek/structlog/pull/77>`_,
`#163 <https://github.com/hynek/structlog/pull/163>`_
- Added ``try_unbind()`` that works like ``unbind()`` but doesn't raise a ``KeyError`` if one of the keys is missing.
`#171 <https://github.com/hynek/structlog/pull/171>`_
----
18.1.0 (2018-01-27)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
*none*
Deprecations:
^^^^^^^^^^^^^
- The meaning of the ``structlog[dev]`` installation target will change from "colorful output" to "dependencies to develop ``structlog``" in 19.1.0.
The main reason behind this decision is that it's impossible to have a ``structlog`` in your normal dependencies and additionally a ``structlog[dev]`` for developement (``pip`` will report an error).
Changes:
^^^^^^^^
- Empty strings are valid events now.
`#110 <https://github.com/hynek/structlog/issues/110>`_
- Do not encapsulate Twisted failures twice with newer versions of Twisted.
`#144 <https://github.com/hynek/structlog/issues/144>`_
- ``structlog.dev.ConsoleRenderer`` now accepts a *force_colors* argument to output colored logs even if the destination is not a tty.
Use this option if your logs are stored in files that are intended to be streamed to the console.
- ``structlog.dev.ConsoleRenderer`` now accepts a *level_styles* argument for overriding the colors for individual levels, as well as to add new levels.
See the docs for ``ConsoleRenderer.get_default_level_styles()`` for usage.
`#139 <https://github.com/hynek/structlog/pull/139>`_
- ``structlog.stdlib.BoundLogger.exception()`` now uses the ``exc_info`` argument if it has been passed instead of setting it unconditionally to ``True``.
`#149 <https://github.com/hynek/structlog/pull/149>`_
- Default configuration now uses plain ``dict``\ s on Python 3.6+ and PyPy since they are ordered by default.
- Added ``structlog.is_configured()`` to check whether or not ``structlog`` has been configured.
- Added ``structlog.get_config()`` to introspect current configuration.
----
17.2.0 (2017-05-15)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
*none*
Deprecations:
^^^^^^^^^^^^^
*none*
Changes:
^^^^^^^^
- ``structlog.stdlib.ProcessorFormatter`` now accepts *keep_exc_info* and *keep_stack_info* arguments to control what to do with this information on log records.
Most likely you want them both to be ``False`` therefore it's the default.
`#109 <https://github.com/hynek/structlog/issues/109>`_
- ``structlog.stdlib.add_logger_name()`` now works in ``structlog.stdlib.ProcessorFormatter``'s ``foreign_pre_chain``.
`#112 <https://github.com/hynek/structlog/issues/112>`_
- Clear log record args in ``structlog.stdlib.ProcessorFormatter`` after rendering.
This fix is for you if you tried to use it and got ``TypeError: not all arguments converted during string formatting`` exceptions.
`#116 <https://github.com/hynek/structlog/issues/116>`_,
`#117 <https://github.com/hynek/structlog/issues/117>`_
----
17.1.0 (2017-04-24)
-------------------
The main features of this release are massive improvements in standard library's ``logging`` integration.
Have a look at the updated `standard library chapter <https://www.structlog.org/en/stable/standard-library.html>`_ on how to use them!
Special thanks go to
`Fabian Büchler <https://github.com/fabianbuechler>`_,
`Gilbert Gilb's <https://github.com/gilbsgilbs>`_,
`Iva Kaneva <https://github.com/if-fi>`_,
`insolite <https://github.com/insolite>`_,
and `sky-code <https://github.com/sky-code>`_,
that made them possible.
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- The default renderer now is ``structlog.dev.ConsoleRenderer`` if you don't configure ``structlog``.
Colors are used if available and human-friendly timestamps are prepended.
This is in line with our backward `compatibility policy <https://www.structlog.org/en/stable/backward-compatibility.html>`_ that explicitly excludes default settings.
Changes:
^^^^^^^^
- Added ``structlog.stdlib.render_to_log_kwargs()``.
This allows you to use ``logging``-based formatters to take care of rendering your entries.
`#98 <https://github.com/hynek/structlog/issues/98>`_
- Added ``structlog.stdlib.ProcessorFormatter`` which does the opposite:
This allows you to run ``structlog`` processors on arbitrary ``logging.LogRecords``.
`#79 <https://github.com/hynek/structlog/issues/79>`_,
`#105 <https://github.com/hynek/structlog/issues/105>`_
- UNIX epoch timestamps from ``structlog.processors.TimeStamper`` are more precise now.
- Added *repr_native_str* to ``structlog.processors.KeyValueRenderer`` and ``structlog.dev.ConsoleRenderer``.
This allows for human-readable non-ASCII output on Python 2 (``repr()`` on Python 2 behaves like ``ascii()`` on Python 3 in that regard).
As per compatibility policy, it's on (original behavior) in ``KeyValueRenderer`` and off (humand-friendly behavior) in ``ConsoleRenderer``.
`#94 <https://github.com/hynek/structlog/issues/94>`_
- Added *colors* argument to ``structlog.dev.ConsoleRenderer`` and made it the default renderer.
`#78 <https://github.com/hynek/structlog/pull/78>`_
- Fixed bug with Python 3 and ``structlog.stdlib.BoundLogger.log()``.
Error log level was not reproductible and was logged as exception one time out of two.
`#92 <https://github.com/hynek/structlog/pull/92>`_
- Positional arguments are now removed even if they are empty.
`#82 <https://github.com/hynek/structlog/pull/82>`_
----
16.1.0 (2016-05-24)
-------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- Python 3.3 and 2.6 aren't supported anymore.
They may work by chance but any effort to keep them working has ceased.
The last Python 2.6 release was on October 29, 2013 and isn't supported by the CPython core team anymore.
Major Python packages like Django and Twisted dropped Python 2.6 a while ago already.
Python 3.3 never had a significant user base and wasn't part of any distribution's LTS release.
Changes:
^^^^^^^^
- Add a ``drop_missing`` argument to ``KeyValueRenderer``.
If ``key_order`` is used and a key is missing a value, it's not rendered at all instead of being rendered as ``None``.
`#67 <https://github.com/hynek/structlog/pull/67>`_
- Exceptions without a ``__traceback__`` are now also rendered on Python 3.
- Don't cache loggers in lazy proxies returned from ``get_logger()``.
This lead to in-place mutation of them if used before configuration which in turn lead to the problem that configuration was applied only partially to them later.
`#72 <https://github.com/hynek/structlog/pull/72>`_
----
16.0.0 (2016-01-28)
-------------------
Changes:
^^^^^^^^
- ``structlog.processors.ExceptionPrettyPrinter`` and ``structlog.processors.format_exc_info`` now support passing of Exceptions on Python 3.
- Clean up the context when exiting ``structlog.threadlocal.tmp_bind`` in case of exceptions.
`#64 <https://github.com/hynek/structlog/issues/64>`_
- Be more more lenient about missing ``__name__``\ s.
`#62 <https://github.com/hynek/structlog/pull/62>`_
- Add ``structlog.dev.ConsoleRenderer`` that renders the event dictionary aligned and with colors.
- Use `six <https://six.readthedocs.io/>`_ for compatibility.
- Add ``structlog.processors.UnicodeDecoder`` that will decode all byte string values in an event dictionary to Unicode.
- Add ``serializer`` parameter to ``structlog.processors.JSONRenderer`` which allows for using different (possibly faster) JSON encoders than the standard library.
----
15.3.0 (2015-09-25)
-------------------
Changes:
^^^^^^^^
- Tolerate frames without a ``__name__``, better.
`#58 <https://github.com/hynek/structlog/pull/58>`_
- Officially support Python 3.5.
- Add ``structlog.ReturnLogger.failure`` and ``structlog.PrintLogger.failure`` as preparation for the new Twisted logging system.
----
15.2.0 (2015-06-10)
-------------------
Changes:
^^^^^^^^
- Allow empty lists of processors.
This is a valid use case since `#26 <https://github.com/hynek/structlog/issues/26>`_ has been merged.
Before, supplying an empty list resulted in the defaults being used.
- Prevent Twisted's ``log.err`` from quoting strings rendered by ``structlog.twisted.JSONRenderer``.
- Better support of ``logging.Logger.exception`` within ``structlog``.
`#52 <https://github.com/hynek/structlog/pull/52>`_
- Add option to specify target key in ``structlog.processors.TimeStamper`` processor.
`#51 <https://github.com/hynek/structlog/pull/51>`_
----
15.1.0 (2015-02-24)
-------------------
Changes:
^^^^^^^^
- Tolerate frames without a ``__name__``.
----
15.0.0 (2015-01-23)
-------------------
Changes:
^^^^^^^^
- Add ``structlog.stdlib.add_log_level`` and ``structlog.stdlib.add_logger_name`` processors.
`#44 <https://github.com/hynek/structlog/pull/44>`_
- Add ``structlog.stdlib.BoundLogger.log``.
`#42 <https://github.com/hynek/structlog/pull/42>`_
- Pass positional arguments to stdlib wrapped loggers that use string formatting.
`#19 <https://github.com/hynek/structlog/pull/19>`_
- ``structlog`` is now dually licensed under the `Apache License, Version 2 <https://choosealicense.com/licenses/apache/>`_ and the `MIT <https://choosealicense.com/licenses/mit/>`_ license.
Therefore it is now legal to use structlog with `GPLv2 <https://choosealicense.com/licenses/gpl-2.0/>`_-licensed projects.
`#28 <https://github.com/hynek/structlog/pull/28>`_
- Add ``structlog.stdlib.BoundLogger.exception``.
`#22 <https://github.com/hynek/structlog/pull/22>`_
----
0.4.2 (2014-07-26)
------------------
Changes:
^^^^^^^^
- Fixed a memory leak in greenlet code that emulates thread locals.
It shouldn't matter in practice unless you use multiple wrapped dicts within one program that is rather unlikely.
`#8 <https://github.com/hynek/structlog/pull/8>`_
- ``structlog.PrintLogger`` now is thread-safe.
- Test Twisted-related code on Python 3 (with some caveats).
- Drop support for Python 3.2.
There is no justification to add complexity for a Python version that nobody uses.
If you are one of the `0.350% <https://alexgaynor.net/2014/jan/03/pypi-download-statistics/>`_ that use Python 3.2, please stick to the 0.4 branch; critical bugs will still be fixed.
- Officially support Python 3.4.
- Allow final processor to return a dictionary.
See the adapting chapter.
`#26`_
- ``from structlog import *`` works now (but you still shouldn't use it).
----
0.4.1 (2013-12-19)
------------------
Changes:
^^^^^^^^
- Don't cache proxied methods in ``structlog.threadlocal._ThreadLocalDictWrapper``.
This doesn't affect regular users.
- Various doc fixes.
----
0.4.0 (2013-11-10)
------------------
Backward-incompatible changes:
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Changes:
^^^^^^^^
- Add ``structlog.processors.StackInfoRenderer`` for adding stack information to log entries without involving exceptions.
Also added it to default processor chain.
`#6 <https://github.com/hynek/structlog/pull/6>`_
- Allow optional positional arguments for ``structlog.get_logger`` that are passed to logger factories.
The standard library factory uses this for explicit logger naming.
`#12 <https://github.com/hynek/structlog/pull/12>`_
- Add ``structlog.processors.ExceptionPrettyPrinter`` for development and testing when multiline log entries aren't just acceptable but even helpful.
- Allow the standard library name guesser to ignore certain frame names.
This is useful together with frameworks.
- Add meta data (e.g. function names, line numbers) extraction for wrapped stdlib loggers.
`#5 <https://github.com/hynek/structlog/pull/5>`_
----
0.3.2 (2013-09-27)
------------------
Changes:
^^^^^^^^
- Fix stdlib's name guessing.
----
0.3.1 (2013-09-26)
------------------
Changes:
^^^^^^^^
- Add forgotten ``structlog.processors.TimeStamper`` to API documentation.
----
0.3.0 (2013-09-23)
------------------
Changes:
^^^^^^^^
- Greatly enhanced and polished the documentation and added a new theme based on Write The Docs, requests, and Flask.
- Add Python Standard Library-specific BoundLogger that has an explicit API instead of intercepting unknown method calls.
See ``structlog.stdlib.BoundLogger``.
- ``structlog.ReturnLogger`` now allows arbitrary positional and keyword arguments.
- Add Twisted-specific BoundLogger that has an explicit API instead of intercepting unknown method calls.
See ``structlog.twisted.BoundLogger``.
- Allow logger proxies that are returned by ``structlog.get_logger`` and ``structlog.wrap_logger`` to cache the BoundLogger they assemble according to configuration on first use.
See the chapter on performance and the ``cache_logger_on_first_use`` argument of ``structlog.configure`` and ``structlog.wrap_logger``.
- Extract a common base class for loggers that does nothing except keeping the context state.
This makes writing custom loggers much easier and more straight-forward.
See ``structlog.BoundLoggerBase``.
----
0.2.0 (2013-09-17)
------------------
Changes:
^^^^^^^^
- Promote to stable, thus henceforth a strict backward compatibility policy is put into effect.
- Add ``key_order`` option to ``structlog.processors.KeyValueRenderer`` for more predictable log entries with any ``dict`` class.
- ``structlog.PrintLogger`` now uses proper I/O routines and is thus viable not only for examples but also for production.
- Enhance Twisted support by offering JSONification of non-structlog log entries.
- Allow for custom serialization in ``structlog.twisted.JSONRenderer`` without abusing ``__repr__``.
----
0.1.0 (2013-09-16)
------------------
Initial release.
|