release

rogerbinns · Oct 6, 2023 · ca28f31 · ca28f31
1 parent 0671911
commit ca28f31
Show file tree

Hide file tree

Showing 41 changed files with 1,236 additions and 1,384 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -1,4 +1,4 @@
 # Sphinx build info version 1
 # This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
-config: 22e5b5a366d8c091154229ef6a20f2e9
+config: ca78e81c3b9a965fdf82635b8983adea
 tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/_modules/apsw/bestpractice.html b/_modules/apsw/bestpractice.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>apsw.bestpractice &mdash; APSW 3.43.1.0 documentation</title>
+  <title>apsw.bestpractice &mdash; APSW 3.43.1.1 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
@@ -13,7 +13,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=b2705db7"></script>
+        <script src="../../_static/documentation_options.js?v=1608d9ae"></script>
         <script src="../../_static/doctools.js?v=888ff710"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -36,7 +36,7 @@
               <img src="../../_static/apswlogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                3.43.1.0
+                3.43.1.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -218,7 +218,7 @@ <h1>Source code for apsw.bestpractice</h1><div class="highlight"><pre>
 
   <div role="contentinfo">
     <p>&#169; <a href="../../copyright.html">Copyright</a> 2004-2023, Roger Binns &lt;[email protected]&gt;.
-      <span class="lastupdated">Last updated on Sep 13, 2023.
+      <span class="lastupdated">Last updated on Oct 06, 2023.
       </span></p>
   </div>
 

diff --git a/_modules/apsw/ext.html b/_modules/apsw/ext.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>apsw.ext &mdash; APSW 3.43.1.0 documentation</title>
+  <title>apsw.ext &mdash; APSW 3.43.1.1 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
@@ -13,7 +13,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=b2705db7"></script>
+        <script src="../../_static/documentation_options.js?v=1608d9ae"></script>
         <script src="../../_static/doctools.js?v=888ff710"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -36,7 +36,7 @@
               <img src="../../_static/apswlogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                3.43.1.0
+                3.43.1.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -1883,7 +1883,7 @@ <h1>Source code for apsw.ext</h1><div class="highlight"><pre>
 
   <div role="contentinfo">
     <p>&#169; <a href="../../copyright.html">Copyright</a> 2004-2023, Roger Binns &lt;[email protected]&gt;.
-      <span class="lastupdated">Last updated on Sep 13, 2023.
+      <span class="lastupdated">Last updated on Oct 06, 2023.
       </span></p>
   </div>
 

diff --git a/_modules/apsw/shell.html b/_modules/apsw/shell.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>apsw.shell &mdash; APSW 3.43.1.0 documentation</title>
+  <title>apsw.shell &mdash; APSW 3.43.1.1 documentation</title>
       <link rel="stylesheet" href="../../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../../_static/css/theme.css" type="text/css" />
     <link rel="shortcut icon" href="../../_static/favicon.ico"/>
@@ -13,7 +13,7 @@
 
         <script src="../../_static/jquery.js?v=5d32c60e"></script>
         <script src="../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../../_static/documentation_options.js?v=b2705db7"></script>
+        <script src="../../_static/documentation_options.js?v=1608d9ae"></script>
         <script src="../../_static/doctools.js?v=888ff710"></script>
         <script src="../../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../../_static/js/theme.js"></script>
@@ -36,7 +36,7 @@
               <img src="../../_static/apswlogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                3.43.1.0
+                3.43.1.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../../search.html" method="get">
@@ -104,6 +104,8 @@ <h1>Source code for apsw.shell</h1><div class="highlight"><pre>
 
 <span class="kn">from</span> <span class="nn">__future__</span> <span class="kn">import</span> <span class="n">annotations</span>
 
+<span class="c1"># mypy: ignore-errors</span>
+
 <span class="kn">import</span> <span class="nn">argparse</span>
 <span class="kn">import</span> <span class="nn">base64</span>
 <span class="kn">import</span> <span class="nn">code</span>
@@ -3718,7 +3720,7 @@ <h1>Source code for apsw.shell</h1><div class="highlight"><pre>
 
   <div role="contentinfo">
     <p>&#169; <a href="../../copyright.html">Copyright</a> 2004-2023, Roger Binns &lt;[email protected]&gt;.
-      <span class="lastupdated">Last updated on Sep 13, 2023.
+      <span class="lastupdated">Last updated on Oct 06, 2023.
       </span></p>
   </div>
 

diff --git a/_modules/index.html b/_modules/index.html
@@ -3,7 +3,7 @@
 <head>
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-  <title>Overview: module code &mdash; APSW 3.43.1.0 documentation</title>
+  <title>Overview: module code &mdash; APSW 3.43.1.1 documentation</title>
       <link rel="stylesheet" href="../_static/pygments.css" type="text/css" />
       <link rel="stylesheet" href="../_static/css/theme.css" type="text/css" />
     <link rel="shortcut icon" href="../_static/favicon.ico"/>
@@ -13,7 +13,7 @@
 
         <script src="../_static/jquery.js?v=5d32c60e"></script>
         <script src="../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
-        <script src="../_static/documentation_options.js?v=b2705db7"></script>
+        <script src="../_static/documentation_options.js?v=1608d9ae"></script>
         <script src="../_static/doctools.js?v=888ff710"></script>
         <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>
     <script src="../_static/js/theme.js"></script>
@@ -36,7 +36,7 @@
               <img src="../_static/apswlogo.png" class="logo" alt="Logo"/>
           </a>
               <div class="version">
-                3.43.1.0
+                3.43.1.1
               </div>
 <div role="search">
   <form id="rtd-search-form" class="wy-form" action="../search.html" method="get">
@@ -112,7 +112,7 @@ <h1>All modules for which code is available</h1>
 
   <div role="contentinfo">
     <p>&#169; <a href="../copyright.html">Copyright</a> 2004-2023, Roger Binns &lt;[email protected]&gt;.
-      <span class="lastupdated">Last updated on Sep 13, 2023.
+      <span class="lastupdated">Last updated on Oct 06, 2023.
       </span></p>
   </div>
 

diff --git a/_sources/changes.rst.txt b/_sources/changes.rst.txt
@@ -3,12 +3,24 @@ Change History
 
 .. currentmodule:: apsw
 
+3.43.1.1
+========
+
+:doc:`Exception <exceptions>` handling has been updated, with multiple
+exceptions in the same SQLite control flow being chained together.
+Previously more would have used the :ref:`unraisable <unraisable>`
+mechanism.  (:issue:`489`)
+
+Only use alloca with msvc because it doesn't support `VLA
+<https://en.wikipedia.org/wiki/Variable-length_array>`__.  The arrays
+are used for fastcall. (:issue:`487`)
+
 3.43.1.0
 ========
 
 All C code calling into Python and all C code called by Python uses
 vectorcall / fastcall (see :pep:`590`) which reduces the overhead of
-passing and receiving positional and keyword arguments. (:issue:`477`
+passing and receiving positional and keyword arguments. (:issue:`477`,
 :issue:`446`):
 
 * Conversion of arguments from Python values to C values drops generic

diff --git a/_sources/example.rst.txt b/_sources/example.rst.txt
@@ -59,7 +59,7 @@ Checking APSW and SQLite versions
 .. code-block:: output
 
           Using APSW file /space/apsw/apsw/__init__.cpython-311-x86_64-linux-gnu.so
-             APSW version 3.43.1.0
+             APSW version 3.43.1.1
     SQLite header version 3043001
        SQLite lib version 3.43.1
        Using amalgamation True
@@ -1211,7 +1211,7 @@ feedback and allows cancelling.
     progress handler called
     progress handler called
     progress handler called
-    (9820078994,)
+    (9973029666,)
 
 
 .. index:: File Control (example code)
@@ -1316,7 +1316,8 @@ with  :meth:`Connection.setcommithook`.
 .. code-block:: output
 
     in commit hook
-    commits okay at this time
+    no commits out of hours
+    commit was not allowed
 
 
 .. index:: Update hook (example code)
@@ -1613,10 +1614,10 @@ useful instead.
     │ .local     │ 1534       │
     │ .o         │ 20304      │
     │ .ps1       │ 9033       │
-    │ .py        │ 11773809   │
-    │ .pyc       │ 13256978   │
+    │ .py        │ 11776971   │
+    │ .pyc       │ 13267393   │
     │ .rst       │ 9561       │
-    │ .sh        │ 3932       │
+    │ .sh        │ 3941       │
     │ .so        │ 27584936   │
     │ .stdlib    │ 10752      │
     │ .supp      │ 70         │
@@ -1887,9 +1888,9 @@ Python.
     
     Dump output
     
-    -- SQLite dump (by APSW 3.43.1.0)
+    -- SQLite dump (by APSW 3.43.1.1)
     -- SQLite version 3.43.1
-    -- Date: Wed Sep 13 15:58:02 2023
+    -- Date: Fri Oct  6 07:11:15 2023
     -- Tables like: csvtest%
     -- Database: /space/apsw/dbfile
     -- User: rogerb @ clamps
@@ -1935,7 +1936,7 @@ SQLite provides statistics by :meth:`status`
 
 .. code-block:: output
 
-    SQLite memory usage 438680 max 2346512
+    SQLite memory usage 433992 max 2341792
 
 
 .. index:: Tracing (example code)

diff --git a/_sources/exceptions.rst.txt b/_sources/exceptions.rst.txt
@@ -12,27 +12,33 @@ systems as needed.  Exceptions raised in Python code called by SQLite
 will have that exception present when control returns to Python, and
 SQLite will understand that an error occurred.
 
+Chaining
+--------
+
+When an error is reported to SQLite, it may take further actions.  For
+example errors in :doc:`VFS <vfs>` can result in error recovery
+attempts, while an error in a window function step method will result
+in the final method being called to do clean up.  Your code
+implementing those could also have additional exceptions.
+
+When multiple exceptions occur in the same SQLite control flow then
+they will be :pep:`chained <3134>`.  Python's traceback printing code
+will show `all the exceptions
+<https://docs.python.org/3/library/exceptions.html#exception-context>`__.
+
+
 .. _unraisable:
 
 Unraisable
 ----------
 
 There are a few places where it is not possible for a Python exception
-to be reported to SQLite as an error, typically because SQLite does
-not allow an error to be signalled in that context.  Another example
-would be in :doc:`VFS <vfs>` code, because SQLite takes actions to
-recover from errors (eg it may try to rollback a transaction on a
-write error).  Python wants to return to callers, not continue
-execution while the exception is pending.  (Also only one exception
-can be active at a time.)
-
-Unraisable exceptions in VFS code are handled by calling
-:meth:`VFS.excepthook` or :meth:`VFSFile.excepthook` (:ref:`more info
-<vfserrors>`).  In other code `sys.unraisablehook
-<https://docs.python.org/3/library/sys.html#sys.unraisablehook>`__ is
-called, and if that is not present then `sys.excepthook
-<https://docs.python.org/3/library/sys.html#sys.excepthook>`__ is
-called.
+to be reported to SQLite as an error, and Python C code does not allow
+destructors to report exceptions.  These exceptions are reported via
+`sys.unraisablehook
+<https://docs.python.org/3/library/sys.html#sys.unraisablehook>`__,
+and if that is not present then `sys.excepthook
+<https://docs.python.org/3/library/sys.html#sys.excepthook>`__.
 
 `sqlite3_log <https://www.sqlite.org/c3ref/log.html>`__ is also called
 so that you will have the context of when the exception happened

diff --git a/_sources/install.rst.txt b/_sources/install.rst.txt
@@ -136,12 +136,12 @@ edit the :file:`setup.apsw` file inside.
 
 .. downloads-begin
 
-* `apsw-3.43.1.0.zip
-  <https://github.com/rogerbinns/apsw/releases/download/3.43.1.0/apsw-3.43.1.0.zip>`__
+* `apsw-3.43.1.1.zip
+  <https://github.com/rogerbinns/apsw/releases/download/3.43.1.1/apsw-3.43.1.1.zip>`__
   (Source, includes this HTML Help)
 
-* `apsw-3.43.1.0-sigs.zip 
-  <https://github.com/rogerbinns/apsw/releases/download/3.43.1.0/apsw-3.43.1.0-sigs.zip>`__
+* `apsw-3.43.1.1-sigs.zip 
+  <https://github.com/rogerbinns/apsw/releases/download/3.43.1.1/apsw-3.43.1.1-sigs.zip>`__
   GPG signatures for all files
 
 .. downloads-end
@@ -164,7 +164,7 @@ Verify
   To verify a file use --verify specifying the corresponding
   ``.asc`` filename.  This example verifies the source::
 
-      $ gpg --verify apsw-3.43.1.0.zip.asc
+      $ gpg --verify apsw-3.43.1.1.zip.asc
       gpg: Signature made ... date ... using DSA key ID 0DFBD904
       gpg: Good signature from "Roger Binns <[email protected]>"