Boltons

_(August 11, 2020)_

- Improve import time of [iterutils][iterutils] by deferring hashlib/socket imports
- Add custom `repr` parameter to [funcutils.format_invocation][funcutils.format_invocation]

20.2.0

---

_(June 21, 2020)_

- Added [iterutils.lstrip][iterutils.lstrip], [iterutils.rstrip][iterutils.rstrip], [iterutils.strip][iterutils.strip]
- More robust and complete [strutils.strip_ansi][strutils.strip_ansi]
- Add [iterutils.untyped_sorted][iterutils.untyped_sorted]
- Fixes to [IndexedSet][IndexedSet] rsub and index methods
- Expose text mode flag in [fileutils.AtomicSaver][fileutils.AtomicSaver]
- Add [strutils.int_list_complement][strutils.int_list_complement] and [strutils.int_list_to_int_tuples][strutils.int_list_to_int_tuples] to the _int_list_ suite.
- Docs: intersphinx links finally point to Python 3 docs

20.1.0

---

_(March 29, 2020)_

- Add [funcutils.update_wrapper][funcutils.update_wrapper], used to
make a wrapper function reflect various aspects of the wrapped
function's API.
- Fix [FunctionBuilder][FunctionBuilder] handling of functions without `__module__`
- Add `partial` support to [FunctionBuilder][FunctionBuilder]
- Fix [NetstringSocket][socketutils.NetstringSocket]'s handling of arguments in `read_ns`
- Fix [IndexedSet][IndexedSet]'s `index()` method to account for removals
- Add `seekable`, `readable`, and `writable` to SpooledIOBase
- Add a special case to `singularize`
- Fix various warnings for Py3.9

20.0.0

---

_(January 8, 2020)_

- New module [pathutils][pathutils]:
- [pathutils.augpath][pathutils.augpath] augments a path by modifying its components
- [pathutils.shrinkuser][pathutils.shrinkuser] inverts :func:`os.path.expanduser`.
- [pathutils.expandpath][pathutils.expandpath] shell-like environ and tilde expansion
- add `include_dirs` param to [fileutils.iter_find_files][fileutils.iter_find_files]
- Make [funcutils.format_invocation][funcutils.format_invocation] more deterministic
- add [strutils.unwrap_text][strutils.unwrap_text] which does what you think to wrapped text
- Py3 fixes
- [iterutils.chunked][iterutils.chunked] to work with the `bytes` type ([231][i231])
- [cacheutils.ThresholdCounter][cacheutils.ThresholdCounter]'s `get_common_count()`

[i231]: https://github.com/mahmoud/boltons/issues/231
[pathutils]: https://boltons.readthedocs.io/en/latest/pathutils.html
[pathutils.augpath]: https://boltons.readthedocs.io/en/latest/pathutils.html#boltons.pathutils.augpath
[pathutils.augpath]: https://boltons.readthedocs.io/en/latest/pathutils.html#boltons.pathutils.augpath
[pathutils.shrinkuser]: https://boltons.readthedocs.io/en/latest/pathutils.html#boltons.pathutils.shrinkuser
[pathutils.expandpath]: https://boltons.readthedocs.io/en/latest/pathutils.html#boltons.pathutils.expandpath
[strutils.unwrap_text]: https://boltons.readthedocs.io/en/latest/strutils.html#boltons.strutils.unwrap_text

_(October 28, 2019)_

Three funcutils:

- [funcutils.format_invocation][funcutils.format_invocation] for formatting simple function calls `func(pos1, pos2, kw_k=kw_v)`
- [funcutils.format_exp_repr][funcutils.format_exp_repr] for formatting a repr like `Type(pos, kw_k=kw_v)`
- [funcutils.format_nonexp_repr][funcutils.format_nonexp_repr] for formatting a repr like `<Type k=v>`

[funcutils.format_invocation]: https://boltons.readthedocs.io/en/latest/funcutils.html#boltons.funcutils.format_invocation
[funcutils.format_exp_repr]: https://boltons.readthedocs.io/en/latest/funcutils.html#boltons.funcutils.format_exp_repr
[funcutils.format_nonexp_repr]: https://boltons.readthedocs.io/en/latest/funcutils.html#boltons.funcutils.format_nonexp_repr

_(October 19, 2019)_

A bunch of small fixes and enhancements.

- [tbutils.TracebackInfo][tbutils.TracebackInfo]'s from_frame now respects `level` arg
- [OrderedMultiDict.sorted()][OrderedMultiDict.sorted] now maintains all items, not just the most recent
- [setutils.complement()][setutils.complement] now supports `__rsub__` for better interop with the builtin `set`
- [FunctionBuilder][FunctionBuilder] fixed a few py3 warnings related to inspect module usage (`formatargspec`)
- [iterutils.bucketize][iterutils.bucketize] now takes a string key which works like an attribute getter, similar to other iterutils functions
- Docstring fixes across the board
- CI fixes for Travis default dist change

[OrderedMultiDict.sorted]: http://boltons.readthedocs.org/en/latest/dictutils.html#boltons.dictutils.OrderedMultiDict.sorted

_(February 28, 2019)_

Couple of enhancements, couple of cleanups.

- [queueutils][queueutils] now supports float-based priorities ([204][i204])
- [FunctionBuilder][funcutils.FunctionBuilder] has a new
`get_arg_names()` method, and its `get_defaults_dict()` method
finally includes kwonly argument defaults.
- [strutils.gzip_bytes][strutils.gzip_bytes] arrives to match
[strutils.gunzip_bytes][strutils.gunzip_bytes]

[i204]: https://github.com/mahmoud/boltons/issues/204

_(February 12, 2019)_

Quick release to enhance [FunctionBuilder][funcutils.FunctionBuilder]
and [funcutils.wraps][funcutils.wraps] to maintain function
annotations on Python 3+. ([133][i133], [134][i134], [203][i203])

[i133]: https://github.com/mahmoud/boltons/issues/133
[i134]: https://github.com/mahmoud/boltons/issues/134
[i203]: https://github.com/mahmoud/boltons/issues/203

_(February 10, 2019)_

A very big release indeed, perhaps the biggest yet. A big, big thank you to all the contributors!

- New types and utilities
- [dictutils.ManyToMany][dictutils.ManyToMany] arrives, to complement [dictutils.OneToOne][dictutils.OneToOne]
- [dictutils.FrozenDict][dictutils.FrozenDict] brings immutable mapping to a module near you ([105][i105])
- [setutils.complement()][setutils.complement] introduces "negative" sets, useful for exclusion and many other set operations
- [iterutils.soft_sorted()][iterutils.soft_sorted] allows for looser, more flexible sorting of sequences
- [iterutils.flatten_iter()][iterutils.flatten_iter] and [iterutils.flatten()][iterutils.flatten], to collapse nested iterables. ([118][i118])
- [mathutils.Bits][mathutils.Bits] type for representing a bitstring and translating
between integer, bytestring, hex, and boolean sequence representations.
- funcutils improvements
- [FunctionBuilder][funcutils.FunctionBuilder] and [funcutils.wraps][funcutils.wraps] now support coroutines/async ([194][i194])
- [FunctionBuilder.add_arg()][funcutils.FunctionBuilder.add_arg] allows the addition of arguments to the signature, to match [FunctionBuilder.remove_arg()][funcutils.FunctionBuilder.remove_arg] ([201][i201])
- Similarly [funcutils.wraps()][funcutils.wraps] now takes an "expected" argument, to complement "injected" ([161][i161])
- Other bugfixes and improvements
- [cacheutils.LRI][cacheutils.LRI] is now threadsafe and correctly evicts when duplicate keys are added ([155][i155], [157][i157])
- [dictutils.subdict()][dictutils.subdict] now does its best to return the same type of dictionary it was passed.
- [urlutils][urlutils] now has better IPv6 support and URL can be used more natively like a string
- Improve singularization in [strutils][strutils]
- Fix some deprecation warnings in Python 3.7 ([165][i165], [196][i196])
- Document the change in dict constructor behavior affecting [dictutils.OMD][dictutils.OMD] under Python 3.7+ ([179][i179])

[i105]: https://github.com/mahmoud/boltons/issues/105
[i118]: https://github.com/mahmoud/boltons/issues/118
[i155]: https://github.com/mahmoud/boltons/issues/155
[i157]: https://github.com/mahmoud/boltons/issues/157
[i161]: https://github.com/mahmoud/boltons/issues/161
[i165]: https://github.com/mahmoud/boltons/issues/165
[i179]: https://github.com/mahmoud/boltons/issues/179
[i194]: https://github.com/mahmoud/boltons/issues/194
[i195]: https://github.com/mahmoud/boltons/issues/195
[i196]: https://github.com/mahmoud/boltons/issues/196
[i201]: https://github.com/mahmoud/boltons/issues/201