Boltons

_(November 1, 2024)_

- Added `max_depth` parameter to [`fileutils.iter_find_files`][fileutils.iter_find_files]
- Added `enter` parameter to [`iterutils.research`][iterutils.research] to support traversing custom data types
- Add optional print tracing for [`iterutils.remap`][iterutils.remap] for easier debugging
- Fixed [`typeutils.Sentinel`][typeutils.make_sentinel] copy behavior to return self
- Tentative Python 3.13 support ([365][i365], [366][i366])

[i365]: https://github.com/mahmoud/boltons/issues/365
[i366]: https://github.com/mahmoud/boltons/issues/366

Per the RFC in issue [365][i339], boltons is now **Python 3 only**. 3.7+ for now.
If you're a Python 2 user, feel free to pin at `boltons<24.0.0`.

Other minor changes:

- Added Python 3.12 support ([361][i361])
- Fix [dictutils.OneToOne][dictutils.OneToOne]'s `update()` behavior with empty iterables

[i339]: https://github.com/mahmoud/boltons/issues/339
[i361]: https://github.com/mahmoud/boltons/issues/361

_(November 1, 2023)_

Tiny release to include more test files in the sdist (source distribution) on PyPI.

_(October 31, 2023)_

- Add `fill`/`end` parameters for [`iterutils.windowed`][iterutils.windowed] and [`iterutils.pairwise`][iterutils.pairwise], respectively ([350][i350])
- Fix cache eviction for [`cacheutils.LRU`][cacheutils.LRU] ([348][i348])
- Fix OrderedMultiDict (OMD) pickleability under Py3 ([337][i337])
- `funcutils.copy_function` maintains kw-only defaults ([336][i336])
- Support OMD `ior` ([341][i341])

[i350]: https://github.com/mahmoud/boltons/issues/350
[i348]: https://github.com/mahmoud/boltons/issues/348
[i341]: https://github.com/mahmoud/boltons/issues/341
[i337]: https://github.com/mahmoud/boltons/issues/337
[i336]: https://github.com/mahmoud/boltons/issues/336
[cacheutils.LRU]: http://boltons.readthedocs.org/en/latest/cacheutils.html#boltons.cacheutils.LRU
[iterutils.windowed]: http://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.windowed
[iterutils.pairwise]: http://boltons.readthedocs.org/en/latest/iterutils.html#boltons.iterutils.pairwise

_(February 19, 2023)_

- Overdue update for Python 3.10 and 3.11 support ([294][i294], [303][i303], [320][i320], [323][i323], [326][i326]/[327][i327])
- Add [iterutils.chunk_ranges][iterutils.chunk_ranges] ([312][i312])
- Improvements to `SpooledBytesIO`/`SpooledStringIO` ([305][i305])
- Bugfix for infinite daterange issue when start and stop is the same ([302][i302])
- Fix `Bits.as_list` behavior ([315][i315])

21.0.0

---

_(May 16, 2021)_

- Fix [OMD][dictutils.OrderedMultiDict].addlist when the added list is empty
- Add [funcutils.noop][funcutils.noop], satisfying [PEP 559](https://www.python.org/dev/peps/pep-0559/)
- Support lists for [iterutils.bucketize][iterutils.bucketize]
- Python 3.9 test fixes for OMD (PEP 584, see [271][i271])
- Make [typeutils.make_sentinel][typeutils.make_sentinel] more pickleable
- [jsonutils.reverse_iter_lines][jsonutils.reverse_iter_lines] now works on Py3 and Windows

[jsonutils.reverse_iter_lines]: http://boltons.readthedocs.org/en/latest/jsonutils.html#boltons.jsonutils.reverse_iter_lines
[funcutils.noop]: https://boltons.readthedocs.io/en/latest/funcutils.html#boltons.funcutils.noop
[i271]: https://github.com/mahmoud/boltons/issues/271

_(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