Prepare v5.0.0.

CHANGELOG.rst

@@ -1,3 +1,51 @@
+v5.0.0 (UNRELEASED)
+===================
+
+- Require Python 3.7 or later (breaking change).
+
+- Remove deprecated submodules (breaking change).
+
+  The ``cache``, ``fifo``, ``lfu``, ``lru``, ``mru``, ``rr`` and
+  ``ttl`` submodules have been deleted.  Therefore, statements like
+
+  ``from cachetools.ttl import TTLCache``
+
+  will no longer work. Use
+
+  ``from cachetools import TTLCache``
+
+  instead.
+
+- Pass ``self`` to ``@cachedmethod`` key function (breaking change).
+
+  The ``key`` function passed to the ``@cachedmethod`` decorator is
+  now called as ``key(self, *args, **kwargs)``.
+
+  The default key function has been changed to ignore its first
+  argument, so this should only affect applications using custom key
+  functions with the ``@cachedmethod`` decorator.
+
+- Change exact time of expiration in ``TTLCache`` (breaking change).
+
+  ``TTLCache`` items now get expired if their expiration time is less
+  than *or equal to* ``timer()``.  For applications using the default
+  ``timer()``, this should be barely noticable, but it may affect the
+  use of custom timers with larger tick intervals.  Note that this
+  also implies that a ``TTLCache`` with ``ttl=0`` can no longer hold
+  any items, since they will expire immediately.
+
+- Change ``Cache.__repr__()`` format (breaking change).
+
+  String representations of cache instances now use a more compact and
+  efficient format, e.g.
+
+  ``LRUCache({1: 1, 2: 2}, maxsize=10, currsize=2)``
+
+- Add TLRU cache implementation.
+
+- Documentation improvements.
+
+
 v4.2.4 (2021-09-30)
 ===================
 

src/cachetools/__init__.py

@@ -13,7 +13,7 @@
     "cachedmethod",
 )
 
-__version__ = "4.2.4"
+__version__ = "5.0.0"
 
 import collections
 import collections.abc