Boltons

_(May 24, 2016)_

Just a couple of [ecoutils][ecoutils] follow-ons, removing uuid
dependency and adding the ability to scrub identifiable data.

_(May 23, 2016)_

Big, big update. Lots of additions, a few bugfixes.

- [ecoutils][ecoutils] - Python runtime/environment profile generator
- [timeutils.strpdate][timeutils.strpdate] - like datetime.datetime.strpdate but for date
- [timeutils.daterange][timeutils.daterange] - like range() but for datetime.date objects
- [strutils.parse_int_list][strutils.parse_int_list]
and [strutils.format_int_list][strutils.format_int_list]
- [cacheutils][cacheutils]
- [cachedproperty][cacheutils.cachedproperty]
- [cacheutils.cachedmethod][cacheutils.cachedmethod]
- [cacheutils.cached][cacheutils.cached] now accepts a callable, as well.
- `cacheutils.make_cache_key` is now public, should others need it
- [statsutils.Stats][statsutils.Stats] update, several new methods,
including [Stats.describe][statsutils.Stats.describe]
- A few [socketutils][socketutils] platform tweaks
- `debugutils.wrap_trace` preview

16.2.2

---

_(May 3, 2016)_

many small tweaks to socketutils.BufferedSocket, including optional
inclusion of the delimiter in recv_until. also undid the enabling of bak
files with AtomicSaver on windows

- Small [socketutils.BufferedSocket][socketutils.BufferedSocket] tweaks
- make recv_until conditionally return the delimiter (by default it
does not). also fix a NetstringException inheritance typo
- [socketutils][socketutils]: rename BufferedSocket.recv_lock to
\_recv_lock, and same for send_lock.
- add a bunch of simple passthrough methods to better fill out
socket's API
- add .fileno/.close/.shutdown to [socketutils.BufferedSocket][socketutils.BufferedSocket]
- added type/family/proto
[socketutils.BufferedSocket][socketutils.BufferedSocket]
passthrough properties
- BufferedSocket: also lock on .shutdown()
- adding an rbuf_unconsumed attribute for post-close debugging, per
doublereedkurt's request
- `getsendbuffer()` returns a bytestring and `recv_size()` uses the proper
`._recvsize` on the first socket fetch
- [fileutils.AtomicSaver][fileutils.AtomicSaver]: revert bak file as
it was causing confusion, per [nvie/pip-tools351](https://github.com/nvie/pip-tools/issues/351)

_(April 29, 2016)_

This version sees the soft debut of [socketutils][socketutils], which
includes wrappers and tools for working with the built-in socket. A
lot of [socketutils.BufferedSocket][socketutils.BufferedSocket] changes.

- [BufferedSocket.recv_until][socketutils.BufferedSocket.recv_until] now
supports multibyte delimiters and also includes the delimiter in its returns.
- Better BufferedSocket timeout discipline throughout.
- Various BufferedSocket argument name changes, _maxbytes_ became
_maxsize_, _n_ became _size_, _marker_ became _delimiter_, etc.
- [BufferedSocket][socketutils.BufferedSocket] BufferedSocket became
threadsafe
- [BufferedSocket.recv][socketutils.BufferedSocket.recv] now always returns the
contents of the internal buffer before doing a socket call.
- [BufferedSocket.recv_close][socketutils.BufferedSocket.recv_close] now exists
to receive until the sending end closes the connection.
- Can now pass _recvsize_ to
[BufferedSocket][socketutils.BufferedSocket] constructor to tune
the size passed to the lower-level recv call.
- [socketutils][socketutils] got documented and tested.

_(April 18, 2016)_

adding shell args escaper-joiners to strutils (escape_shell_args,
args2cmd, args2sh) as well as a rare breaking fix to
[iterutils.pairwise][iterutils.pairwise].

- Argument joiners, functions to join command line arguments in
context-appropriate ways:
- [strutils.escape_shell_args][strutils.escape_shell_args]
- [strutils.args2cmd][strutils.args2cmd]
- [strutils.args2sh][strutils.args2sh]
- BREAKING: finally fixing
[iterutils.pairwise][iterutils.pairwise]. pairwise used to call to
`chunked`, now it calls to `windowed`. `pairwise([1, 2, 3, 4])` no
longer returns `[(1, 2), (3, 4)]`. Instead, it returns
`[(1, 2), (2, 3), (3, 4)]`, which is what I always mean when I say
pairwise, but not what the original contributor implemented.
- Adding a universal wheel distribution option!

_(March 6, 2016)_

Added [iterutils.same][iterutils.same], improvement of Windows
[fileutils.AtomicSaver][fileutils.AtomicSaver] behavior for old
filesystems, bugfix on [strutils.is_uuid][strutils.is_uuid], expansion
of [strutils.pluralize][strutils.pluralize], new trove classifiers and
docs improvements!

- [fileutils.replace][fileutils.replace]: use bak file option for
win32 ReplaceFile for slightly better corner case coverage on less
featureful filesystems
- [strutils.pluralize][strutils.pluralize]: Add more irregular plurals
- [strutils.is_uuid][strutils.is_uuid]: Catch un-parsable UUIDs.
- [iterutils.same][iterutils.same]: Return `True` when all values in
iterable are the same.

_(February 24, 2016)_

The centerpiece of this release is highly improved Windows support for
[fileutils.atomic_save][fileutils.atomic_save] via
[ReplaceFile](https://msdn.microsoft.com/en-us/library/windows/desktop/aa365512%28v=vs.85%29.aspx)
system call. This functionality is also made available directly via
[fileutils.replace][fileutils.replace], which is akin to Python 3.3+'s
[os.replace][os.replace], except that `os.replace`'s approach has
[arguably poorer behavior and atomicity](http://stupidpythonideas.blogspot.com/2014/07/getting-atomic-writes-right.html)
compared to `fileutils.replace`.

Also, a couple new strutils, and
[iterutils.backoff][iterutils.backoff] grew a jitter argument.

- [iterutils.backoff][iterutils.backoff] now supports start=0
- More comprehensive [iterutils.backoff][iterutils.backoff] argument checking/validation
- [fileutils.replace][fileutils.replace] and
[fileutils.atomic_rename][fileutils.atomic_rename] are now public
functions in [fileutils][fileutils] with cross-platform implementations ([discussion here](https://github.com/mahmoud/boltons/issues/60))
- [tableutils.Table][tableutils.Table]s have a metadata argument and
attribute for miscellaneous metadata.
- [strutils.is_ascii][strutils.is_ascii] and
[strutils.is_uuid][strutils.is_uuid]: About as straightforward as
they are handy.
- Tox testing improvements