tinykv 0.2.0__tar.gz → 0.2.1__tar.gz

{tinykv-0.2.0 → tinykv-0.2.1}/CHANGELOG.md

@@ -9,6 +9,13 @@ Entries marked as **BC BREAK** indicate backward-incompatible changes.
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-03-11
+
+### Changed
+- Added an optional `if_not_exists` parameter to `create_schema()` to support
+  idempotent table creation when needed while preserving the default error on
+  existing tables. Close #1.
+
 ## [0.2.0] - 2026-03-11
 
 ### Changed

{tinykv-0.2.0 → tinykv-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: tinykv
-Version: 0.2.0
+Version: 0.2.1
 Summary: A lightweight Python SQLite key-value store built on sqlite3.
 Keywords: python,sqlite,sqlite3,key-value store,kv
 Author-email: Flavio Veloso Soares <flaviovs@magnux.com>
@@ -255,6 +255,10 @@ TinyKV requires the database table to exist before use. Create it with
     >>> conn = sqlite3.connect(':memory:')
     >>> tinykv.create_schema(conn)
 
+If you need idempotent setup, pass `if_not_exists=True`:
+
+    >>> tinykv.create_schema(conn, if_not_exists=True)
+
 You can use a custom table name:
 
     >>> tinykv.create_schema(conn, table='my_keys')

{tinykv-0.2.0 → tinykv-0.2.1}/README.md

@@ -226,6 +226,10 @@ TinyKV requires the database table to exist before use. Create it with
     >>> conn = sqlite3.connect(':memory:')
     >>> tinykv.create_schema(conn)
 
+If you need idempotent setup, pass `if_not_exists=True`:
+
+    >>> tinykv.create_schema(conn, if_not_exists=True)
+
 You can use a custom table name:
 
     >>> tinykv.create_schema(conn, table='my_keys')

{tinykv-0.2.0 → tinykv-0.2.1}/src/tinykv/__init__.py

@@ -34,7 +34,7 @@ def _validate_key(key: str) -> None:
         raise ValueError('key must not be empty')
 
 
-__version__ = '0.2.0'
+__version__ = '0.2.1'
 
 _DEF_TABLE = 'kv'
 _ALLOW_PICKLE_DEFAULT = object()
@@ -42,16 +42,20 @@ _ALLOW_PICKLE_DEFAULT = object()
 logger = logging.getLogger(__name__)
 
 
-def create_schema(conn: sqlite3.Connection, table: str = _DEF_TABLE) -> None:
+def create_schema(conn: sqlite3.Connection, table: str = _DEF_TABLE,
+                  if_not_exists: bool = False) -> None:
     """Create a database table for use with tinykv.
 
     Args:
         conn: The SQLite3 connection object.
         table: The table name (default: 'kv').
+        if_not_exists: If true, include SQLite's `IF NOT EXISTS` clause so
+            repeated schema creation is a no-op.
 
     """
     _validate_table_name(table)
-    conn.execute(f'CREATE TABLE {table} ('
+    if_not_exists_sql = 'IF NOT EXISTS ' if if_not_exists else ''
+    conn.execute(f'CREATE TABLE {if_not_exists_sql}{table} ('
                  'k TEXT NOT NULL, '
                  't TINYINT NOT NULL CHECK (t BETWEEN 1 AND 7), '
                  'v BLOB, '

{tinykv-0.2.0 → tinykv-0.2.1}/tests/test_tinykv.py

@@ -21,7 +21,7 @@ _TEST_DATA = {
 }
 
 
-class TestKV(unittest.TestCase):
+class TestKV(unittest.TestCase):  # pylint: disable=too-many-public-methods
 
     def setUp(self) -> None:
         # pylint: disable-next=consider-using-with
@@ -42,6 +42,13 @@ class TestKV(unittest.TestCase):
                 db.set(k, v)
                 self.assertEqual(db.get(k), v)
 
+    def test_create_schema_existing_table_raises_by_default(self) -> None:
+        with self.assertRaises(sqlite3.OperationalError):
+            create_schema(self._conn)
+
+    def test_create_schema_if_not_exists(self) -> None:
+        create_schema(self._conn, if_not_exists=True)
+
     def test_set_replace(self) -> None:
         db = TinyKV(self._conn, allow_pickle=True)