Jaraco.collections

=======

In ``DictFilter``, deprecated ``include_keys`` parameter and usage
without ``include_pattern``. Future versions will honor
``include_pattern`` as a required keyword argument. All other
uses are deprecated. For uses that currently rely on ``include_keys``,
use ``Projection`` instead/in addition. For example, instead of::

filtered = DictFilter(orig, include_keys=['a'], include_pattern='b+')

Use::

filtered = DictFilter(Projection(['a'], orig), include_pattern='b+')

=======

In ``Projection``, harmonize the implementation and optimize using
``set`` instead of ``tuple``.

======

``DictFilter.__len__`` no longer relies on the iterable. Improves
efficiency and fixes ``RecursionError`` on PyPy (12).

======

Made ``DictStack`` mutable.

======

Added ``RangeMap.left``.

======

Revised ``DictFilter``:

- Fixed issue where ``DictFilter.__contains__`` would raise a ``KeyError``.
- Relies heavily now on ``collections.abc.Mapping`` base class.