icecream

Removed: Support for Python 3.8.
Fixed: Issues #229 and #60, which means improved lists output.

Big thanks to the community! This release was made possible by the people who contributed to the library.

Added: You can pass a pre-configured ic instance to builtins.
Added: You can configure IceCream to output to either stdout or stderr.

Big thanks to the community! This release was made possible by the people who contributed to the library 🚀

Added: Configurable line wrap length. Improved: The package no longer includes tests in the production installation.

Fixed: Pretty-printing of SymPy (and similar) objects.

Previously, calling ic() on structures containing SymPy objects could raise a TypeError because pprint.pformat(sort_dicts=True) attempted to sort unorderable keys. IceCream now keeps sort_dicts=True on the fast path and falls back to sort_dicts=False when pprint raises, ensuring robust output without crashes.

Changed: Improved printing for variables of type str.

Fixed issues that affected the output of multiline strings and strings containing special characters such as escaped newlines and tabs.

Strings are now printed exactly as they are, faithfully representing their actual value.

• Changed: Drop support for all Python versions prior to Python 3.8, which are now long past EOL. Notably: Python 2 is no longer supported.
• Changed: Update the 'executing' dependency to >= v2.1.0 to improve source code analysis and support Python 3.13.

Added: The contextAbsPath= parameter to ic.configureOutput() which, when True, outputs absolute paths, like /path/to/foo.py, instead of just filenames, like foo.py. See #122. Huge thank you to @HelinXu!
Changed: Raise TypeError if no arguments are provided to ic.configureOutput().

• Added: Ability to register and unregister singledispatch argumentToString functions. See https://github.com/gruns/icecream/pull/115. Huge thank you to @atusy!

• Added: Support for Python 3.9.
• Changed: Use timestamps in the local timezone instead of less helpful UTC timestamps.

• Added: install() and uninstall() functions that add or remove ic() from the builtins module.
• Changed: Switch to ast.literal_eval() to determine if an argument and value are the same, and thus only the value should be output. Huge thank you to Ed Cardinal and Alex Hall.

• Added: Support for Python 3.8.
• Removed: Support for Python 3.4.
• Changed: Switched core AST parsing engine to Alex Hall's executing (https://github.com/alexmojaki/executing). Huge thank you to Alex Hall.
• Changed: Whitespace in arguments is no longer collapsed. Indentation in multiline arguments is now preserved.

Fixed: Support multiline container arguments. e.g. ic([a, b]) Fixed: Include LICENSE.txt in source distributions. Changed: Collapse argument whitespace, e.g. ic([ a, b ]) -> ic| [a, b].

================================================================================

Added: Colorize output with pygments. Added: Test Python style with pycodestyle. Fixed: Parse and print tuple arguments correctly, e.g. ic((a, b)). Fixed: Fail gracefully when the underlying source code changes during execution. Changed: Print values (e.g. 1, 'foo', etc) by themselves, nonredundantly. For example, ic(3) now prints 'ic| 3' instead of 'ic| 3: 3'.

================================================================================

• Removed: Support for Python 3.3, which reached EOL on 2017-09-29.
• Fixed: ic() invocations that fail to find or access source code (e.g. eval(), exec(), python -i, etc) now print an error message instead of throwing an IOError (Python 2) or OSError (Python 3).

First release.

This changelog wasn't maintained prior to v1.3.