apsw-sqlite3mc 3.52.0.0__tar.gz → 3.53.1.0__tar.gz

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/MANIFEST.in

@@ -25,10 +25,3 @@ include README.rst
 
 include setup.apsw
 
-# configure
-include sqlite3/configure/*
-include sqlite3/configure/autosetup/*
-# remove generated detritus
-exclude sqlite3/configure/config.log
-exclude sqlite3/configure/Makefile
-exclude sqlite3/configure/sqlite3.pc

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apsw_sqlite3mc
-Version: 3.52.0.0
+Version: 3.53.1.0
 Summary: SQLite3 Multiple Ciphers combined with Another Python SQLite Wrapper
 Home-page: https://github.com/utelle/apsw-sqlite3mc
 Author: Ulrich Telle
@@ -89,7 +89,7 @@ Setting the key on a new database is the only change needed to your code.
 
   >>> import apsw
   >>> print(apsw.mc_version)
-  SQLite3 Multiple Ciphers 2.2.7
+  SQLite3 Multiple Ciphers 2.3.4
   >>> con = apsw.Connection("database.sqlite3")
   >>> con.pragma("key", "my secret passphrase")
   ok

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/README.rst

@@ -59,7 +59,7 @@ Setting the key on a new database is the only change needed to your code.
 
   >>> import apsw
   >>> print(apsw.mc_version)
-  SQLite3 Multiple Ciphers 2.2.7
+  SQLite3 Multiple Ciphers 2.3.4
   >>> con = apsw.Connection("database.sqlite3")
   >>> con.pragma("key", "my secret passphrase")
   ok

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/apsw/__init__.pyi

@@ -990,8 +990,13 @@ class Blob:
 @final
 class ChangesetBuilder:
     """This object wraps a `sqlite3_changegroup <https://sqlite.org/session/changegroup.html>`__
-    letting you concatenate changesets and individual :class:`TableChange` into one larger
-    changeset."""
+    to build a changeset or patchset.   The contents can come from:
+
+    * Existing changesets
+    * Individual :class:`TableChange`
+    * :meth:`add_insert`, :meth:`add_update`, :meth:`add_delete`
+
+    See the :ref:`example <example_changesetbuilder>`"""
 
     def add(self, changeset: ChangesetInput) -> None:
         """:param changeset: The changeset as the bytes, or a stream
@@ -1012,12 +1017,62 @@ class ChangesetBuilder:
         Calls: `sqlite3changegroup_add_change <https://sqlite.org/session/sqlite3changegroup_add_change.html>`__"""
         ...
 
+    def add_delete(self, table: str, indirect: bool, row: SQLiteValues) -> None:
+        """Adds an ``delete`` change row.  You must have called :meth:`schema` first so
+         the table can be verified.
+
+        .. seealso::
+
+           * :meth:`add_insert`
+           * :meth:`add_update`
+
+
+         Calls: `sqlite3changegroup_change_begin <https://sqlite.org/session/sqlite3changegroup_change_begin.html>`__
+         Calls: `sqlite3changegroup_change_finish <https://sqlite.org/session/sqlite3changegroup_change_finish.html>`__"""
+        ...
+
+    def add_insert(self, table: str, indirect: bool, row: SQLiteValues) -> None:
+        """Adds an ``insert`` change row.  You must have called :meth:`schema` first so
+        the table can be verified.
+
+        .. seealso::
+
+          * :meth:`add_delete`
+          * :meth:`add_update`
+
+        Calls: `sqlite3changegroup_change_begin <https://sqlite.org/session/sqlite3changegroup_change_begin.html>`__
+        Calls: `sqlite3changegroup_change_finish <https://sqlite.org/session/sqlite3changegroup_change_finish.html>`__"""
+        ...
+
+    def add_update(self, table: str, indirect: bool, old: SQLiteValues, new: SQLiteValues) -> None:
+        """Adds an ``update`` change giving old and new rows. You must have called :meth:`schema` first so
+        the table can be verified.
+
+        See `sqlite3changegroup_change_finish <https://sqlite.org/session/sqlite3changegroup_change_finish.html>`__
+        for details on which columns of old and new you must provide values for.  Where no value should be
+        provided, use :attr:`apsw.no_change`.
+
+        .. seealso::
+
+          * :meth:`add_insert`
+          * :meth:`add_delete`
+
+        Calls: `sqlite3changegroup_change_begin <https://sqlite.org/session/sqlite3changegroup_change_begin.html>`__
+        Calls: `sqlite3changegroup_change_finish <https://sqlite.org/session/sqlite3changegroup_change_finish.html>`__"""
+        ...
+
     def close(self) -> None:
         """Releases the builder
 
         Calls: `sqlite3changegroup_delete <https://sqlite.org/session/sqlite3changegroup_delete.html>`__"""
         ...
 
+    def config(self, op: int, *args: Any) -> int:
+        """Configures the changegroup.
+
+        Calls: `sqlite3changegroup_config <https://sqlite.org/session/sqlite3changegroup_config.html>`__"""
+        ...
+
     def __init__(self):
         """Creates a new empty builder.
 
@@ -4465,6 +4520,8 @@ SQLITE_CARRAY_INT64: int = 1
 """For `Datatypes for the CARRAY table-valued function <https://sqlite.org/c3ref/c_carray_blob.html>'__"""
 SQLITE_CARRAY_TEXT: int = 3
 """For `Datatypes for the CARRAY table-valued function <https://sqlite.org/c3ref/c_carray_blob.html>'__"""
+SQLITE_CHANGEGROUP_CONFIG_PATCHSET: int = 1
+"""For `Options for sqlite3changegroup_config() <https://sqlite.org/session/c_changegroup_config_patchset.html>'__"""
 SQLITE_CHANGESETAPPLY_FKNOACTION: int = 8
 """For `Flags for sqlite3changeset_apply_v2 <https://sqlite.org/session/c_changesetapply_fknoaction.html>'__"""
 SQLITE_CHANGESETAPPLY_IGNORENOOP: int = 4
@@ -5495,6 +5552,12 @@ SQLITE_NOTADB SQLITE_NOTFOUND SQLITE_NOTICE SQLITE_OK SQLITE_PERM
 SQLITE_PROTOCOL SQLITE_RANGE SQLITE_READONLY SQLITE_ROW SQLITE_SCHEMA
 SQLITE_TOOBIG SQLITE_WARNING"""
 
+mapping_session_changegroup_config_options: dict[str | int, int | str]
+"""Options for sqlite3changegroup_config() mapping names to int and int to names.
+Doc at https://sqlite.org/session/c_changegroup_config_patchset.html
+
+SQLITE_CHANGEGROUP_CONFIG_PATCHSET"""
+
 mapping_session_changeset_apply_v2_flags: dict[str | int, int | str]
 """Flags for sqlite3changeset_apply_v2 mapping names to int and int to names.
 Doc at https://sqlite.org/session/c_changesetapply_fknoaction.html
@@ -7437,13 +7500,13 @@ class AsyncCursor:
       * :attr:`Cursor.description_full`
       * :attr:`Cursor.description`"""
 
-    description: Awaitable[tuple[tuple[str, str, None, None, None, None, None], ...]]
+    description: tuple[tuple[str, str, None, None, None, None, None], ...]
     """Based on the `DB-API cursor property
     <https://www.python.org/dev/peps/pep-0249/>`__, this returns the
     same as :meth:`get_description` but with 5 Nones appended because
     SQLite does not have the information."""
 
-    description_full: Awaitable[tuple[tuple[str, str, str, str, str], ...]]
+    description_full: tuple[tuple[str, str, str, str, str], ...]
     """Only present if SQLITE_ENABLE_COLUMN_METADATA was defined at
     compile time.
 
@@ -7571,7 +7634,7 @@ class AsyncCursor:
         """Returns the :attr:`connection` this cursor is part of"""
         ...
 
-    async def get_description(self) -> tuple[tuple[str, str], ...]:
+    def get_description(self) -> tuple[tuple[str, str], ...]:
         """If you are trying to get information about a table or view,
         then `pragma table_info <https://sqlite.org/pragma.html#pragma_table_info>`__
         is better.  If you want to know up front what columns and other

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/apsw/aio.py

@@ -2,6 +2,7 @@
 
 from __future__ import annotations
 
+import asyncio
 import contextlib
 import contextvars
 import logging
@@ -368,9 +369,6 @@ class AsyncIO:
                 return await task
 
     def __init__(self, *, thread_name: str = "asyncio apsw background worker"):
-        global asyncio
-        import asyncio
-
         self.queue: queue.SimpleQueue[_CallTracker | None] = queue.SimpleQueue()
         self.loop = asyncio.get_running_loop()
         threading.Thread(name=thread_name, target=self.worker_thread_run).start()
@@ -651,8 +649,6 @@ def Auto() -> Trio | AsyncIO | AnyIO:
 
     if found is None and "asyncio" in sys.modules:
         try:
-            import asyncio
-
             asyncio.get_running_loop()
             found = AsyncIO
         except:

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/apsw/ext.py

@@ -180,7 +180,7 @@ class TypesConverterCursorFactory:
         """Registers a callable that converts from a SQLite value"""
         self.converters[name] = callable
 
-    def __call__(self, connection: apsw.Connection) -> TypeConverterCursor:
+    def __call__(self, connection: apsw.Connection) -> TypesConverterCursorFactory.TypeConverterCursor:
         "Returns a new convertor :class:`cursor <apsw.Cursor>` for the `connection`"
         return TypesConverterCursorFactory.TypeConverterCursor(connection, self)
 
@@ -2224,7 +2224,7 @@ def get_column_names(row: Any) -> tuple[Sequence[str], VTColumnAccess]:
         * - Type
           - Access
           - Column names From
-        * - :external:func:`dataclasses.is_dataclass`
+        * - :func:`dataclasses.is_dataclass`
           - :attr:`VTColumnAccess.By_Attr`
           - :func:`dataclasses.fields`
         * - :func:`isinstance <isinstance>`\(:class:`tuple`) and :func:`hasattr <hasattr>`\(:code:`"_fields"`) - eg :func:`~collections.namedtuple`

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/apsw/shell.py

@@ -1922,11 +1922,9 @@ Enter ".help" for instructions
     def _csvin_wrapper(self, filename, dialect):
         # Returns a csv reader that works around python bugs and uses
         # dialect dict to configure reader
-        thefile = open(filename, "r", encoding=self.encoding[0])
-        for line in csv.reader(thefile, **dialect.copy()):
-            yield line
-        thefile.close()
-        return
+        with open(filename, "r", encoding=self.encoding[0]) as thefile:
+            for line in csv.reader(thefile, **dialect.copy()):
+                yield line
 
     def command_autoimport(self, cmd):
         """autoimport FILENAME ?TABLE?: Imports filename creating a table and automatically working out separators and data types (alternative to .import command)
@@ -2179,6 +2177,39 @@ Enter ".help" for instructions
         finally:
             self.pop_output()
 
+    def command_limit(self, cmd):
+        """limit ?NAME VALUE?: Show all limits, or set a specific one
+
+        With no arguments lists all limits.  Supply a name and value to
+        change.  For example:
+
+           .limit attached 10
+        """
+        if len(cmd) == 0:
+            outputs = {}
+            for k in apsw.mapping_limits:
+                if type(k) is not str:
+                    continue
+                pretty = k[len("SQLITE_LIMIT_") :].lower()
+                outputs[pretty] = self.db.limit(getattr(apsw, k), -1)
+            w = max(len(k) for k in outputs.keys())
+            for k, v in outputs.items():
+                self.write(self.stdout, " " * (w - len(k)))
+                self.write(self.stdout, k + ":  ")
+                self.write_value(v)
+                self.write(self.stdout, "\n")
+            return
+        elif len(cmd) != 2:
+            raise self.Error("Expected zero or two parameters")
+
+        key = "SQLITE_LIMIT_" + cmd[0].upper()
+        if key not in apsw.mapping_limits:
+            raise self.Error(f"Unknown limit option {key}")
+        v = self.db.limit(getattr(apsw, key), int(cmd[1]))
+        self.write(self.stdout, cmd[0].lower() + ": ")
+        self.write_value(v)
+        self.write(self.stdout, "\n")
+
     def command_load(self, cmd):
         """load FILE ?ENTRY?: Loads a SQLite extension library
 

{apsw_sqlite3mc-3.52.0.0 → apsw_sqlite3mc-3.53.1.0}/apsw/sqlite_extra.json

@@ -35,6 +35,10 @@
         "description": "A virtual table that returns suggested completions for a partial SQL input",
         "type": "extension"
     },
+    "compress": {
+        "description": "SQL compression functions",
+        "type": "extension"
+    },
     "csv": {
         "description": "A virtual table for reading CSV files",
         "type": "extension"
@@ -99,6 +103,10 @@
         "description": "Search a large vocabulary for close matches",
         "type": "extension"
     },
+    "sqlar": {
+        "description": "Utility functions for SQL archives",
+        "type": "extension"
+    },
     "sqlite3_dbdump": {
         "description": "Converts the content of a SQLite database into UTF-8 text SQL statements that can be used to exactly recreate the original database",
         "type": "executable"
@@ -175,6 +183,10 @@
         "description": "Shows low level content of a WAL file",
         "type": "executable"
     },
+    "sqlite3_sqlar": {
+        "description": "Command line SQL archive tool",
+        "type": "executable"
+    },
     "stmt": {
         "description": "Virtual table with information about all prepared statements on a connection",
         "type": "extension"
@@ -211,6 +223,10 @@
         "description": "Virtual table printing diagnostic information for interactive analysis and debugging",
         "type": "extension"
     },
+    "zipfile": {
+        "description": "Read/Write access to simple archives",
+        "type": "extension"
+    },
     "zorder": {
         "description": "Functions for z-order (Morton code) transformations",
         "type": "extension"