dbression 0.1.2__tar.gz → 0.2.0__tar.gz

{dbression-0.1.2 → dbression-0.2.0}/CHANGELOG.md

@@ -7,6 +7,18 @@ adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [Unreleased]
 
+## [0.2.0] — 2026-06-01
+
+### Added
+
+- **SQLite as a `DatabaseEnvironment`.** Use `DatabaseEnvironment | sqlite` (alias
+  `sqlite3`) with `service=:memory:` or `service=<path-to-db-file>` in
+  `connection.properties`. No native deps — uses the Python stdlib `sqlite3`
+  driver via SQLAlchemy. `Execute Procedure` does not apply (SQLite has no
+  stored procedures); everything else (`Query`, `Execute`, `Insert`, `Delete`,
+  `Inspect *`, `Update`, captures, substitutions) works the same as on the
+  other backends.
+
 ## [0.1.2] — 2026-06-01
 
 SQL Server live-verification release. A real-world MSSQL DBFit suite (WD-Gehsteig
@@ -120,7 +132,8 @@ with code paths in place for SQL Server and Oracle.
   reject `python-oracledb` thin-mode authentication. Configuration is via
   `DBRESSION_ORACLE_CLIENT_LIB_DIR`.
 
-[Unreleased]: https://github.com/angrydat/dbression/compare/v0.1.2...HEAD
+[Unreleased]: https://github.com/angrydat/dbression/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/angrydat/dbression/releases/tag/v0.2.0
 [0.1.2]: https://github.com/angrydat/dbression/releases/tag/v0.1.2
 [0.1.1]: https://github.com/angrydat/dbression/releases/tag/v0.1.1
 [0.1.0]: https://github.com/angrydat/dbression/releases/tag/v0.1.0

{dbression-0.1.2 → dbression-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dbression
-Version: 0.1.2
+Version: 0.2.0
 Summary: Rage-quit your flaky DB regressions — modern, lightweight, multi-DB regression testing.
 Project-URL: Homepage, https://angrydata.info/dbression
 Project-URL: Repository, https://github.com/angrydat/dbression
@@ -9,7 +9,7 @@ Project-URL: Changelog, https://github.com/angrydat/dbression/blob/main/CHANGELO
 Author-email: Jürgen Zornig <info@angrydata.info>
 License: MIT
 License-File: LICENSE
-Keywords: database,dbfit,fitnesse,markdown,oracle,postgres,regression,sql,sqlserver,testing
+Keywords: database,dbfit,fitnesse,markdown,oracle,postgres,regression,sql,sqlite,sqlserver,testing
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
@@ -35,6 +35,10 @@ Requires-Dist: sqlalchemy>=2.0
 Requires-Dist: typer>=0.12
 Description-Content-Type: text/markdown
 
+<p align="center">
+  <img src="https://raw.githubusercontent.com/angrydat/dbression/main/docs/dbression_head.png" alt="dbression — database regression testing for schema changes, migrations, and critical queries" width="820">
+</p>
+
 # dbression
 
 > ### Rage-quit your flaky DB regressions.
@@ -48,7 +52,7 @@ anywhere. `dbression` is a Python re-implementation in the spirit of the fantast
 
 ```text
 $ dbression run tests/
-dbression 0.1.2 — Suite: tests @ postgresql+psycopg://wlk:***@db01/wlk
+dbression 0.2.0 — Suite: tests @ postgresql+psycopg://wlk:***@db01/wlk
 
 ✓ HelloSql                                  0.004s
   CommonSuite/
@@ -92,7 +96,8 @@ the model gets every detail it needs to suggest a fix, no screenshots, no contex
 
 ```bash
 # install (we use uv, but pip works too)
-uv tool install git+https://github.com/angrydat/dbression.git
+uv tool install dbression          # or: pipx install dbression
+                                   # or: pip install dbression
 
 # run
 dbression run tests/
@@ -328,6 +333,7 @@ Postgres, Oracle and SQL Server. Honest state of the parts:
 | PostgreSQL | ✅ verified against a real-world suite     |
 | Oracle | ✅ verified against a real-world 19c suite via `oracledb` (thin) |
 | SQL Server | ✅ verified against a real-world suite via `pymssql` |
+| SQLite | ✅ via stdlib `sqlite3` — no procedures (the DB has none) |
 | JUnit XML + JSON output | ✅                                        |
 | `.test.md` native Markdown format + `dbression convert` | ✅                                        |
 | Plugin entry-points for custom fixtures | ✅                                        |

{dbression-0.1.2 → dbression-0.2.0}/README.md

@@ -1,3 +1,7 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/angrydat/dbression/main/docs/dbression_head.png" alt="dbression — database regression testing for schema changes, migrations, and critical queries" width="820">
+</p>
+
 # dbression
 
 > ### Rage-quit your flaky DB regressions.
@@ -11,7 +15,7 @@ anywhere. `dbression` is a Python re-implementation in the spirit of the fantast
 
 ```text
 $ dbression run tests/
-dbression 0.1.2 — Suite: tests @ postgresql+psycopg://wlk:***@db01/wlk
+dbression 0.2.0 — Suite: tests @ postgresql+psycopg://wlk:***@db01/wlk
 
 ✓ HelloSql                                  0.004s
   CommonSuite/
@@ -55,7 +59,8 @@ the model gets every detail it needs to suggest a fix, no screenshots, no contex
 
 ```bash
 # install (we use uv, but pip works too)
-uv tool install git+https://github.com/angrydat/dbression.git
+uv tool install dbression          # or: pipx install dbression
+                                   # or: pip install dbression
 
 # run
 dbression run tests/
@@ -291,6 +296,7 @@ Postgres, Oracle and SQL Server. Honest state of the parts:
 | PostgreSQL | ✅ verified against a real-world suite     |
 | Oracle | ✅ verified against a real-world 19c suite via `oracledb` (thin) |
 | SQL Server | ✅ verified against a real-world suite via `pymssql` |
+| SQLite | ✅ via stdlib `sqlite3` — no procedures (the DB has none) |
 | JUnit XML + JSON output | ✅                                        |
 | `.test.md` native Markdown format + `dbression convert` | ✅                                        |
 | Plugin entry-points for custom fixtures | ✅                                        |

{dbression-0.1.2 → dbression-0.2.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dbression"
-version = "0.1.2"
+version = "0.2.0"
 description = "Rage-quit your flaky DB regressions — modern, lightweight, multi-DB regression testing."
 readme = "README.md"
 license = { text = "MIT" }
@@ -16,6 +16,7 @@ keywords = [
     "postgres",
     "oracle",
     "sqlserver",
+    "sqlite",
     "sql",
     "markdown",
     "fitnesse",

{dbression-0.1.2 → dbression-0.2.0}/src/dbression/db/engine.py

@@ -41,6 +41,7 @@ def _maybe_init_oracle_thick() -> None:
 _POSTGRES_ALIASES = {"postgres", "postgresql", "pg"}
 _ORACLE_ALIASES = {"oracle"}
 _MSSQL_ALIASES = {"sqlserver", "mssql", "ms-sql"}
+_SQLITE_ALIASES = {"sqlite", "sqlite3"}
 
 
 def make_engine(environment: str, config: ConnectionConfig) -> Engine:
@@ -55,6 +56,8 @@ def make_engine(environment: str, config: ConnectionConfig) -> Engine:
         url = _build_oracle_url(config, extra)
     elif env in _MSSQL_ALIASES:
         url = _build_mssql_url(config, extra)
+    elif env in _SQLITE_ALIASES:
+        url = _build_sqlite_url(config, extra)
     else:
         raise ValueError(f"Unknown DatabaseEnvironment: {environment!r}")
 
@@ -116,6 +119,30 @@ def _build_mssql_url(cfg: ConnectionConfig, extra: dict[str, str]) -> URL | str:
     )
 
 
+def _build_sqlite_url(cfg: ConnectionConfig, extra: dict[str, str]) -> URL | str:
+    """SQLite via the Python stdlib ``sqlite3`` driver. No native deps.
+
+    Path source order:
+
+    * ``connection-string=sqlite:///…``  — taken verbatim
+    * ``service=:memory:``               — in-memory DB
+    * ``service=<file-path>``            — file-backed DB (absolute or relative)
+    * ``database=<file-path>`` (extras)  — fallback alias
+
+    SQLite has no auth — ``username`` / ``password`` in connection.properties are
+    ignored. Stored procedures and `Execute Procedure` won't work (SQLite has none).
+    """
+    if cfg.connection_string:
+        return cfg.connection_string
+    path = cfg.service or extra.get("database") or ":memory:"
+    # SQLAlchemy SQLite URLs:
+    #   sqlite:///:memory:       — in-memory
+    #   sqlite:///relative.db    — relative to cwd (3 slashes)
+    #   sqlite:////abs/path.db   — absolute (4 slashes; the leading `/` of the path
+    #                              concatenates with the 3-slash prefix)
+    return f"sqlite:///{path}"
+
+
 def _split_host_port(service: str | None) -> tuple[str | None, int | None]:
     if not service:
         return None, None

dbression-0.2.0/tests/test_sqlite_engine.py

@@ -0,0 +1,60 @@
+"""SQLite engine smoke test — confirm the DatabaseEnvironment dispatch and end-to-end
+Query / Execute against an in-memory SQLite DB."""
+from __future__ import annotations
+
+from sqlalchemy import text
+
+from dbression.db.connection import ConnectionConfig
+from dbression.db.engine import make_engine
+from dbression.fixtures import resolve_fixture
+from dbression.fixtures.base import FixtureContext
+from dbression.parser.ast import Table
+from dbression.symbols import SymbolTable
+
+
+def _ctx(conn):
+    return FixtureContext(conn=conn, symbols=SymbolTable(), stored={})
+
+
+def test_sqlite_memory_via_database_environment():
+    cfg = ConnectionConfig(service=":memory:")
+    eng = make_engine("sqlite", cfg)
+    with eng.connect() as c:
+        assert c.execute(text("select 1")).scalar() == 1
+
+
+def test_sqlite_file_path_url_shape(tmp_path):
+    db = tmp_path / "x.db"
+    cfg = ConnectionConfig(service=str(db))
+    eng = make_engine("sqlite", cfg)
+    # Absolute path → 4 slashes
+    assert str(eng.url).startswith("sqlite:////")
+    with eng.connect() as c:
+        c.execute(text("create table t (a int)"))
+        c.execute(text("insert into t values (42)"))
+        assert c.execute(text("select a from t")).scalar() == 42
+
+
+def test_sqlite_runs_query_fixture():
+    cfg = ConnectionConfig(service=":memory:")
+    eng = make_engine("sqlite", cfg)
+    with eng.begin() as conn:
+        conn.execute(text("create table t (n int, name text)"))
+        conn.execute(text("insert into t values (1, 'a'), (2, 'b')"))
+    with eng.connect() as conn:
+        cls = resolve_fixture("Query")
+        tbl = Table(
+            name="Query",
+            header_args=["select n, name from t order by n"],
+            headers=["n", "name"],
+            rows=[["1", "a"], ["2", "b"]],
+        )
+        res = cls().run(tbl, _ctx(conn))
+        assert res.passed, res.message
+
+
+def test_sqlite_alias_sqlite3_also_works():
+    cfg = ConnectionConfig(service=":memory:")
+    eng = make_engine("sqlite3", cfg)
+    with eng.connect() as c:
+        assert c.execute(text("select 1")).scalar() == 1

{dbression-0.1.2 → dbression-0.2.0}/uv.lock

@@ -132,7 +132,7 @@ wheels = [
 
 [[package]]
 name = "dbression"
-version = "0.1.2"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "markdown-it-py" },