Update documentation

Author: Erlend E. Aasland

Doc/library/sqlite3.rst

@@ -515,6 +515,16 @@ Connection Objects
 
       .. XXX what's a db_row-based solution?
 
+   .. method:: statement_cache()
+
+      Returns the LRU statement cache for this connection.  The statement
+      cache is implemented using :meth:`functools.lru_cache`, so it's
+      possible to inspect its state by calling :func:`~functools.cache_info`
+      or :func:`~functools.cache_parameters` on the returned object.  The
+      cache can be cleared by calling :func:`~functools.cache_clear` on
+      the returned object.
+
+      .. versionadded:: 3.10
 
    .. attribute:: text_factory
 

Doc/whatsnew/3.10.rst

@@ -1231,6 +1231,12 @@ Add audit events for :func:`~sqlite3.connect/handle`,
 :meth:`~sqlite3.Connection.load_extension`.
 (Contributed by Erlend E. Aasland in :issue:`43762`.)
 
+
+:mod:`sqlite3` now utilizes :meth:`functools.lru_cache` to implement the
+connection statement cache. The statement cache can be accessed via the new
+method :meth:`sqlite3.Connection.statement_cache`.
+(Contributed by Erlend E. Aasland in :issue:`42862`.)
+
 sys
 ---