apsw-sqlite3mc 3.53.2.0__tar.gz → 3.53.4.0__tar.gz

{apsw_sqlite3mc-3.53.2.0 → apsw_sqlite3mc-3.53.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: apsw_sqlite3mc
-Version: 3.53.2.0
+Version: 3.53.4.0
 Summary: SQLite3 Multiple Ciphers combined with Another Python SQLite Wrapper
 Home-page: https://github.com/utelle/apsw-sqlite3mc
 Author: Ulrich Telle
@@ -90,7 +90,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.3.5
+  SQLite3 Multiple Ciphers 2.4.0
   >>> con = apsw.Connection("database.sqlite3")
   >>> con.pragma("key", "my secret passphrase")
   ok

{apsw_sqlite3mc-3.53.2.0 → apsw_sqlite3mc-3.53.4.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.3.5
+  SQLite3 Multiple Ciphers 2.4.0
   >>> con = apsw.Connection("database.sqlite3")
   >>> con.pragma("key", "my secret passphrase")
   ok

{apsw_sqlite3mc-3.53.2.0 → apsw_sqlite3mc-3.53.4.0}/apsw/__init__.pyi

@@ -856,8 +856,8 @@ class Backup:
 @final
 class Blob:
     """This object is created by :meth:`Connection.blob_open` and provides
-    access to a blob in the database.  It behaves like a Python file.
-    It wraps a `sqlite3_blob
+    access to a blob in the database.  It behaves like a Python
+    :class:`file <io.RawIOBase>` in binary mode.  It wraps a `sqlite3_blob
     <https://sqlite.org/c3ref/blob.html>`_.
 
     .. note::
@@ -893,6 +893,9 @@ class Blob:
         Calls: `sqlite3_blob_close <https://sqlite.org/c3ref/blob_close.html>`__"""
         ...
 
+    closed: bool
+    """Indicates if the blob has been closed."""
+
     def __enter__(self) -> Blob:
         """You can use a blob as a `context manager
         <https://docs.python.org/3/reference/datamodel.html#with-statement-context-managers>`_
@@ -913,6 +916,20 @@ class Blob:
         *with* block is raised after closing the blob."""
         ...
 
+    def fileno(self) -> int:
+        """Always raises :exc:`OSError` because there is no
+        underlying file descriptor."""
+        ...
+
+    def flush(self) -> None:
+        """Does nothing.  There is no intermediate buffer, and SQLite's overall
+        transaction/savepoint handling deals with database commits."""
+        ...
+
+    def isatty(self) -> False:
+        """Blobs are never interactive."""
+        ...
+
     def length(self) -> int:
         """Returns the size of the blob in bytes.
 
@@ -951,6 +968,24 @@ class Blob:
 
     readinto = read_into ## OLD-NAME
 
+    def readable(self) -> True:
+        """You can always read from a blob"""
+        ...
+
+    def readall(self) -> bytes:
+        """Read all data until the end of the blob"""
+        ...
+
+    def readline(self, size: int = -1) -> bytes:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedReader`."""
+        ...
+
+    def readlines(self, hint: int = -1) -> list[bytes]:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedReader`."""
+        ...
+
     def reopen(self, rowid: int) -> None:
         """Change this blob object to point to a different row.  It can be
         faster than closing an existing blob an opening a new one.
@@ -968,13 +1003,28 @@ class Blob:
         :raises ValueError: If the resulting offset is before the beginning (less than zero) or beyond the end of the blob."""
         ...
 
+    def seekable(self) -> True:
+        """You can always seek in a blob"""
+        ...
+
     def tell(self) -> int:
         """Returns the current offset."""
         ...
 
-    def write(self, data: Buffer) -> None:
+    def truncate(self, size = None) -> None:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You cannot change the size of a blob."""
+        ...
+
+    def writable(self) -> bool:
+        """Returns True if the blob was open for writing, else False."""
+        ...
+
+    def write(self, data: Buffer) -> int:
         """Writes the data to the blob.
 
+        Returns the number of bytes written, which will be all of them.
+
         :param data: Buffer to write
 
         :raises TypeError: Wrong data type
@@ -987,6 +1037,11 @@ class Blob:
         Calls: `sqlite3_blob_write <https://sqlite.org/c3ref/blob_write.html>`__"""
         ...
 
+    def writelines(self, lines) -> None:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedWriter`."""
+        ...
+
 @final
 class ChangesetBuilder:
     """This object wraps a `sqlite3_changegroup <https://sqlite.org/session/changegroup.html>`__
@@ -1748,7 +1803,9 @@ class Connection:
         """If *keep* is *None* then all registered virtual tables are dropped.
 
         Otherwise *keep* is a sequence of strings, naming the virtual tables that
-        are kept, dropping all others."""
+        are kept, dropping all others.
+
+        Calls: `sqlite3_drop_modules <https://sqlite.org/c3ref/drop_modules.html>`__"""
         ...
 
     def enable_load_extension(self, enable: bool) -> None:
@@ -1926,7 +1983,9 @@ class Connection:
         ...
 
     def get_autocommit(self) -> bool:
-        """Returns if the Connection is in auto commit mode (ie not in a transaction).
+        """Returns if the Connection is in auto commit mode (ie not in a
+        transaction).  It is recommended to use :meth:`txn_state` instead
+        which is more reliable.
 
         Calls: `sqlite3_get_autocommit <https://sqlite.org/c3ref/get_autocommit.html>`__"""
         ...
@@ -1993,6 +2052,9 @@ class Connection:
 
     def last_insert_rowid(self) -> int:
         """Returns the integer key of the most recent insert in the database.
+        It is recommended to use SQL `RETURNING <https://sqlite.org/lang_returning.html>`__
+        instead because that ensures you get the rowid directly from the
+        SQL that made the change.
 
         Calls: `sqlite3_last_insert_rowid <https://sqlite.org/c3ref/last_insert_rowid.html>`__"""
         ...
@@ -6050,8 +6112,8 @@ class AsyncBlob:
     """This represents a :class:`Blob` when in async mode.
 
     This object is created by :meth:`Connection.blob_open` and provides
-    access to a blob in the database.  It behaves like a Python file.
-    It wraps a `sqlite3_blob
+    access to a blob in the database.  It behaves like a Python
+    :class:`file <io.RawIOBase>` in binary mode.  It wraps a `sqlite3_blob
     <https://sqlite.org/c3ref/blob.html>`_.
 
     .. note::
@@ -6096,8 +6158,25 @@ class AsyncBlob:
         Calls: `sqlite3_blob_close <https://sqlite.org/c3ref/blob_close.html>`__"""
         ...
 
+    closed: bool
+    """Indicates if the blob has been closed."""
 
 
+
+    def fileno(self) -> int:
+        """Always raises :exc:`OSError` because there is no
+        underlying file descriptor."""
+        ...
+
+    async def flush(self) -> None:
+        """Does nothing.  There is no intermediate buffer, and SQLite's overall
+        transaction/savepoint handling deals with database commits."""
+        ...
+
+    def isatty(self) -> False:
+        """Blobs are never interactive."""
+        ...
+
     def length(self) -> int:
         """Returns the size of the blob in bytes.
 
@@ -6134,6 +6213,24 @@ class AsyncBlob:
         Calls: `sqlite3_blob_read <https://sqlite.org/c3ref/blob_read.html>`__"""
         ...
 
+    def readable(self) -> True:
+        """You can always read from a blob"""
+        ...
+
+    async def readall(self) -> bytes:
+        """Read all data until the end of the blob"""
+        ...
+
+    async def readline(self, size: int = -1) -> bytes:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedReader`."""
+        ...
+
+    async def readlines(self, hint: int = -1) -> list[bytes]:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedReader`."""
+        ...
+
     async def reopen(self, rowid: int) -> None:
         """Change this blob object to point to a different row.  It can be
         faster than closing an existing blob an opening a new one.
@@ -6151,13 +6248,28 @@ class AsyncBlob:
         :raises ValueError: If the resulting offset is before the beginning (less than zero) or beyond the end of the blob."""
         ...
 
+    def seekable(self) -> True:
+        """You can always seek in a blob"""
+        ...
+
     def tell(self) -> int:
         """Returns the current offset."""
         ...
 
-    async def write(self, data: Buffer) -> None:
+    async def truncate(self, size = None) -> None:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You cannot change the size of a blob."""
+        ...
+
+    def writable(self) -> bool:
+        """Returns True if the blob was open for writing, else False."""
+        ...
+
+    async def write(self, data: Buffer) -> int:
         """Writes the data to the blob.
 
+        Returns the number of bytes written, which will be all of them.
+
         :param data: Buffer to write
 
         :raises TypeError: Wrong data type
@@ -6170,6 +6282,11 @@ class AsyncBlob:
         Calls: `sqlite3_blob_write <https://sqlite.org/c3ref/blob_write.html>`__"""
         ...
 
+    async def writelines(self, lines) -> None:
+        """Always raises :exc:`io.UnsupportedOperation`.
+        You can wrap with :class:`io.BufferedWriter`."""
+        ...
+
 class AsyncConnection:
     """This represents a :class:`Connection` when in async mode.
 
@@ -6354,7 +6471,7 @@ class AsyncConnection:
               the first statement"""
         ...
 
-    def changes(self) -> int:
+    async def changes(self) -> int:
         """Returns the number of database rows that were changed (or inserted
         or deleted) by the most recently completed INSERT, UPDATE, or DELETE
         statement.
@@ -6677,7 +6794,9 @@ class AsyncConnection:
         """If *keep* is *None* then all registered virtual tables are dropped.
 
         Otherwise *keep* is a sequence of strings, naming the virtual tables that
-        are kept, dropping all others."""
+        are kept, dropping all others.
+
+        Calls: `sqlite3_drop_modules <https://sqlite.org/c3ref/drop_modules.html>`__"""
         ...
 
     async def enable_load_extension(self, enable: bool) -> None:
@@ -6819,8 +6938,10 @@ class AsyncConnection:
             * `FTS5 documentation <https://www.sqlite.org/fts5.html#custom_tokenizers>`__"""
         ...
 
-    def get_autocommit(self) -> bool:
-        """Returns if the Connection is in auto commit mode (ie not in a transaction).
+    async def get_autocommit(self) -> bool:
+        """Returns if the Connection is in auto commit mode (ie not in a
+        transaction).  It is recommended to use :meth:`txn_state` instead
+        which is more reliable.
 
         Calls: `sqlite3_get_autocommit <https://sqlite.org/c3ref/get_autocommit.html>`__"""
         ...
@@ -6835,7 +6956,7 @@ class AsyncConnection:
         <Connection.row_trace>`"""
         ...
 
-    in_transaction: bool
+    in_transaction: Awaitable[bool]
     """It is recommended to use :meth:`txn_state` instead which is more reliable.
 
     Calls: `sqlite3_get_autocommit <https://sqlite.org/c3ref/get_autocommit.html>`__"""
@@ -6859,8 +6980,11 @@ class AsyncConnection:
 
     Calls: `sqlite3_is_interrupted <https://sqlite.org/c3ref/interrupt.html>`__"""
 
-    def last_insert_rowid(self) -> int:
+    async def last_insert_rowid(self) -> int:
         """Returns the integer key of the most recent insert in the database.
+        It is recommended to use SQL `RETURNING <https://sqlite.org/lang_returning.html>`__
+        instead because that ensures you get the rowid directly from the
+        SQL that made the change.
 
         Calls: `sqlite3_last_insert_rowid <https://sqlite.org/c3ref/last_insert_rowid.html>`__"""
         ...
@@ -7288,7 +7412,7 @@ class AsyncConnection:
         Calls: `sqlite3_table_column_metadata <https://sqlite.org/c3ref/table_column_metadata.html>`__"""
         ...
 
-    def total_changes(self) -> int:
+    async def total_changes(self) -> int:
         """Returns the total number of database rows that have be modified,
         inserted, or deleted since the database connection was opened.
 

{apsw_sqlite3mc-3.53.2.0 → apsw_sqlite3mc-3.53.4.0}/apsw/sqlite_extra.json

@@ -27,10 +27,6 @@
         "description": "A VFS shim that writes a checksum on each page of an SQLite database file",
         "type": "extension"
     },
-    "closure": {
-        "description": "A virtual table that finds the transitive closure of a parent/child relationship in a real table",
-        "type": "extension"
-    },
     "completion": {
         "description": "A virtual table that returns suggested completions for a partial SQL input",
         "type": "extension"