More dbstatus updates

Author: rogerbinns

apsw/ext.py

@@ -1115,6 +1115,7 @@ def db_status_get(self) -> dict[str, int]:
             "SQLITE_DBSTATUS_CACHE_WRITE": self.db.status(apsw.SQLITE_DBSTATUS_CACHE_WRITE)[0],
             "SQLITE_DBSTATUS_CACHE_SPILL": self.db.status(apsw.SQLITE_DBSTATUS_CACHE_SPILL)[0],
             "SQLITE_DBSTATUS_DEFERRED_FKS": self.db.status(apsw.SQLITE_DBSTATUS_DEFERRED_FKS)[0],
+            "SQLITE_DBSTATUS_TEMPBUF_SPILL": self.db.status(apsw.SQLITE_DBSTATUS_TEMPBUF_SPILL)[0],
         }
 
     def __exit__(self, *_) -> None:
@@ -1186,6 +1187,7 @@ def __exit__(self, *_) -> None:
         "SQLITE_DBSTATUS_CACHE_WRITE": "SQLite pager cache writes",
         "SQLITE_DBSTATUS_CACHE_SPILL": "SQLite pager cache writes during transaction",
         "SQLITE_DBSTATUS_DEFERRED_FKS": "SQLite unresolved foreign keys",
+        "SQLITE_DBSTATUS_TEMPBUF_SPILL": "SQLite temp spill from full memory to disk",
         "ru_utime": "Time in user mode",
         "ru_stime": "Time in system mode",
         "ru_maxrss": "Maximum resident set size",

doc/changes.rst

@@ -32,6 +32,12 @@ having to go through the intermediate JSON text format.
 Added :func:`apsw.ext.Function` for calling SQL functions directly
 from Python.
 
+Updated :meth:`Connection.status` to use 64 bit API, and
+:func:`apsw.ext.ShowResourceUsage` to show `TEMPBUF_SPILL
+<https://sqlite.org/c3ref/c_dbstatus_options.html>`__.
+(`cache_size <https://sqlite.org/pragma.html#pragma_cache_size>`__
+controls the amount of memory available.)
+
 The `percentile extension <https://sqlite.org/percentile.html>`__ is
 enabled when enabling all extensions, which is standard for pypi
 downloads.

examples/main.py

@@ -1384,7 +1384,7 @@ def trace_hook(trace: dict) -> None:
 # block of code does.  We use the same query from above.
 #
 # Only statistics that have changed are shown in the summary. There are
-# 20 SQLite values tracked including caching, and 20 system values.
+# 21 SQLite values tracked including caching, and 20 system values.
 
 with apsw.ext.ShowResourceUsage(
     sys.stdout, db=connection, scope="thread"

tools/code2rst.py

@@ -117,6 +117,7 @@ def do_mappings():
         "Flags for sqlite3_serialize",
         "Win32 Directory Types",
         "Prepared Statement Scan Status",
+        "Datatypes for the CARRAY table-valued funtion with values",
     }
 
     for d in sorted(consts.keys()):

tools/genconstants.py

@@ -21,6 +21,7 @@
     "Conflict resolution modes": "conflict_resolution_modes",
     "Constants Defining Special Destructor Behavior": None,
     "Database Connection Configuration Options": "db_config",
+    "Datatypes for the CARRAY table-valued funtion": None,
     "Device Characteristics": "device_characteristics",
     "Extended Result Codes": "extended_result_codes",
     "File Locking Levels": "locking_level",