pgdevkit 0.3.8__py3-none-any.whl → 0.5.0__py3-none-any.whl

pgdevkit/areas.py

@@ -0,0 +1,64 @@
+"""Optional `-- area: NAME[, NAME...]` tag recognized in the leading comment
+block of a migration file or a `database/` code file (blank lines and `--`
+comments at the very top, stopping at the first real statement — like a file
+header). A file may declare more than one area, either as a comma-separated
+list on one line or across several `-- area:` lines (the areas union).
+
+A file with no such directive is "untagged" and is treated as shared/common:
+`only` filters always keep untagged files, and `exclude` filters never drop
+them — only a file that explicitly declares an excluded area is dropped.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+_AREA_LINE = re.compile(r"^\s*--\s*area\s*:\s*(.+?)\s*$", re.IGNORECASE)
+
+
+def parse_areas(content: str) -> frozenset[str]:
+    """Area names declared in `content`'s leading comment block."""
+    areas: set[str] = set()
+    for line in content.splitlines():
+        stripped = line.strip()
+        if not stripped:
+            continue
+        if not stripped.startswith("--"):
+            break
+        m = _AREA_LINE.match(stripped)
+        if m:
+            areas.update(a.strip() for a in m.group(1).split(",") if a.strip())
+    return frozenset(areas)
+
+
+def file_areas(path: Path) -> frozenset[str]:
+    """Area names declared in the file at `path`."""
+    return parse_areas(path.read_text(encoding="utf-8"))
+
+
+def area_allowed(
+    areas: frozenset[str],
+    *,
+    only: frozenset[str] | None = None,
+    exclude: frozenset[str] | None = None,
+) -> bool:
+    """Whether a file that declares `areas` passes an `only`/`exclude` filter."""
+    if exclude and areas & exclude:
+        return False
+    if only and areas and not (areas & only):
+        return False
+    return True
+
+
+def filter_by_area(
+    paths: list[Path],
+    *,
+    only: frozenset[str] | None = None,
+    exclude: frozenset[str] | None = None,
+) -> list[Path]:
+    """`paths` restricted by an `only`/`exclude` area filter. Returns `paths`
+    unchanged (no file reads) when neither filter is set."""
+    if not only and not exclude:
+        return paths
+    return [p for p in paths if area_allowed(file_areas(p), only=only, exclude=exclude)]

pgdevkit/cli.py

@@ -23,6 +23,29 @@ app = typer.Typer(name="pgdb", help="PostgreSQL database schema tools")
 console = Console()
 err_console = Console(stderr=True)
 
+_AREA_OPTION = typer.Option(
+    [], "--area", help="Restrict to files declaring this area (repeatable); untagged files always stay in scope"
+)
+_EXCLUDE_AREA_OPTION = typer.Option(
+    [], "--exclude-area", help="Skip files declaring this area (repeatable); untagged files are never excluded"
+)
+_SCHEMA_OPTION = typer.Option(
+    [],
+    "--schema",
+    help="Restrict to files referencing this DB schema (repeatable); "
+    "files with no detectable schema reference always stay in scope",
+)
+_EXCLUDE_SCHEMA_OPTION = typer.Option(
+    [],
+    "--exclude-schema",
+    help="Skip files referencing this DB schema (repeatable); "
+    "files with no detectable schema reference are never excluded",
+)
+
+
+def _as_set(values: list[str]) -> frozenset[str] | None:
+    return frozenset(values) if values else None
+
 testdb_app = typer.Typer(name="testdb", help="Manage the shared local Postgres test container")
 app.add_typer(testdb_app, name="testdb")
 
@@ -46,12 +69,23 @@ def compare(
     ),
     report_extra_db: bool = typer.Option(False, "--report-extra-db", help="Report objects in DB but not in scripts"),
     dialect: str = typer.Option("postgres", "--dialect", help="postgres (default) or mssql"),
+    area: list[str] = _AREA_OPTION,
+    exclude_area: list[str] = _EXCLUDE_AREA_OPTION,
+    schema: list[str] = _SCHEMA_OPTION,
+    exclude_schema: list[str] = _EXCLUDE_SCHEMA_OPTION,
     scripts_dir: Path = typer.Argument(..., help="Directory containing SQL scripts"),
 ) -> None:
     """Compare SQL scripts to a live database and report differences."""
     if not scripts_dir.is_dir():
         err_console.print(f"[red]Error:[/red] {scripts_dir} is not a directory")
         raise typer.Exit(2)
+    if report_extra_db and (area or exclude_area or schema or exclude_schema):
+        console.print(
+            "[yellow]⚠[/yellow]  --report-extra-db with --area/--exclude-area/--schema/--exclude-schema will "
+            "report every DB object outside the filtered area(s)/schema(s) as \"missing in scripts\", since the "
+            "live database has no concept of areas — and isn't itself filtered by --schema either — only the "
+            "scripts side is filtered."
+        )
 
     try:
         conninfo = build_conninfo(
@@ -71,7 +105,14 @@ def compare(
         raise typer.Exit(2)
 
     with console.status("Parsing SQL scripts..."):
-        scripts_schema = parse_directory(scripts_dir, dialect=backend.dialect)
+        scripts_schema = parse_directory(
+            scripts_dir,
+            dialect=backend.dialect,
+            areas=_as_set(area),
+            exclude_areas=_as_set(exclude_area),
+            schemas=_as_set(schema),
+            exclude_schemas=_as_set(exclude_schema),
+        )
 
     with console.status("Introspecting database..."):
         db_schema = backend.introspect(conninfo)
@@ -110,7 +151,11 @@ def fetch_missing(
     only: list[str] = typer.Option([], "--only", help="Only fetch schema.name (repeatable); default is everything"),
 ) -> None:
     """Find tables/views/functions that exist in the database but aren't
-    tracked under scripts_dir, and reverse-engineer their DDL into new files."""
+    tracked under scripts_dir, and reverse-engineer their DDL into new files.
+
+    No --area/--exclude-area here (unlike compare/migrate): this diffs the
+    full live database against scripts, so filtering the scripts side by
+    area would misreport objects tracked under other areas as missing."""
     if not scripts_dir.is_dir():
         err_console.print(f"[red]Error:[/red] {scripts_dir} is not a directory")
         raise typer.Exit(2)
@@ -163,17 +208,33 @@ def fetch_missing(
 
 
 @testdb_app.command("up")
-def testdb_up() -> None:
+def testdb_up(
+    area: list[str] = _AREA_OPTION,
+    exclude_area: list[str] = _EXCLUDE_AREA_OPTION,
+    schema: list[str] = _SCHEMA_OPTION,
+    exclude_schema: list[str] = _EXCLUDE_SCHEMA_OPTION,
+) -> None:
     """Ensure the container is running, the workspace DB exists, and schema is applied."""
-    testdb.ensure_testdb()
+    testdb.ensure_testdb(
+        areas=_as_set(area), exclude_areas=_as_set(exclude_area), schemas=_as_set(schema),
+        exclude_schemas=_as_set(exclude_schema),
+    )
     info = testdb.status()
     console.print(f"[green]Test DB ready:[/green] {info['database']} ({info['dsn']})")
 
 
 @testdb_app.command("reset")
-def testdb_reset() -> None:
+def testdb_reset(
+    area: list[str] = _AREA_OPTION,
+    exclude_area: list[str] = _EXCLUDE_AREA_OPTION,
+    schema: list[str] = _SCHEMA_OPTION,
+    exclude_schema: list[str] = _EXCLUDE_SCHEMA_OPTION,
+) -> None:
     """Drop and recreate only this workspace's database, then reapply schema + seed data."""
-    testdb.reset_testdb()
+    testdb.reset_testdb(
+        areas=_as_set(area), exclude_areas=_as_set(exclude_area), schemas=_as_set(schema),
+        exclude_schemas=_as_set(exclude_schema),
+    )
     info = testdb.status()
     console.print(f"[green]Test DB reset:[/green] {info['database']}")
 
@@ -245,6 +306,10 @@ def migrate_check(
         help="schema.table recording applied migrations "
         "(default: tool.pgdevkit.migrations_table in pyproject.toml, else public.schema_migrations)",
     ),
+    area: list[str] = _AREA_OPTION,
+    exclude_area: list[str] = _EXCLUDE_AREA_OPTION,
+    schema: list[str] = _SCHEMA_OPTION,
+    exclude_schema: list[str] = _EXCLUDE_SCHEMA_OPTION,
 ) -> None:
     """List which migration files under migrations_dir are applied vs. pending."""
     if not migrations_dir.is_dir():
@@ -253,7 +318,13 @@ def migrate_check(
 
     conninfo = build_conninfo(url, entra_user)
     tracking_table = tracking_table or migrate.default_tracking_table(migrations_dir)
-    local_files = migrate.list_migration_files(migrations_dir)
+    local_files = migrate.list_migration_files(
+        migrations_dir,
+        areas=_as_set(area),
+        exclude_areas=_as_set(exclude_area),
+        schemas=_as_set(schema),
+        exclude_schemas=_as_set(exclude_schema),
+    )
     try:
         applied = migrate.applied_migrations(conninfo, tracking_table)
     except migrate.TrackingTableMissing:
@@ -292,6 +363,10 @@ def migrate_apply(
     ),
     ask: bool = typer.Option(False, "--ask", help="Show and confirm each migration before running it"),
     yes: bool = typer.Option(False, "--yes", "-y", help="Skip the confirm-target prompt"),
+    area: list[str] = _AREA_OPTION,
+    exclude_area: list[str] = _EXCLUDE_AREA_OPTION,
+    schema: list[str] = _SCHEMA_OPTION,
+    exclude_schema: list[str] = _EXCLUDE_SCHEMA_OPTION,
 ) -> None:
     """Apply pending migration files, in filename order, tracking each in tracking_table."""
     if not migrations_dir.is_dir():
@@ -300,6 +375,8 @@ def migrate_apply(
 
     conninfo = build_conninfo(url, entra_user)
     tracking_table = tracking_table or migrate.default_tracking_table(migrations_dir)
+    areas, exclude_areas = _as_set(area), _as_set(exclude_area)
+    schemas, exclude_schemas = _as_set(schema), _as_set(exclude_schema)
     target_desc = url.rsplit("@", 1)[-1] if "@" in url else url
     if not yes:
         typer.confirm(f"About to run migrations against {target_desc}. Continue?", abort=True)
@@ -308,12 +385,23 @@ def migrate_apply(
         targets = [migrations_dir / file]
     else:
         try:
-            targets = migrate.pending_migrations(migrations_dir, conninfo, tracking_table)
+            targets = migrate.pending_migrations(
+                migrations_dir,
+                conninfo,
+                tracking_table,
+                areas=areas,
+                exclude_areas=exclude_areas,
+                schemas=schemas,
+                exclude_schemas=exclude_schemas,
+            )
         except migrate.TrackingTableMissing:
             err_console.print(
                 f"[yellow]⚠[/yellow]  {tracking_table} not found — treating every migration as pending"
             )
-            targets = migrate.list_migration_files(migrations_dir)
+            targets = migrate.list_migration_files(
+                migrations_dir, areas=areas, exclude_areas=exclude_areas, schemas=schemas,
+                exclude_schemas=exclude_schemas,
+            )
 
     if not targets:
         console.print("No pending migrations.")

pgdevkit/dialect.py

@@ -43,6 +43,16 @@ _MSSQL_TYPE_SYNONYMS = {
 }
 
 
+# Schemas that hold system catalog views/tables, never a file any project
+# using pgdevkit manages -- a reference to one (e.g. an idempotency guard
+# querying it, or a `SELECT ... FROM information_schema/pg_catalog/sys ...`)
+# is never a real schema-membership or cross-file-dependency signal. Shared
+# by `schemas.py` (schema-reference filtering) and `testdb/schema.py`
+# (dependency-safe apply ordering), which both walk the same sqlglot Table
+# nodes for a related-but-different purpose.
+SYSTEM_SCHEMAS = {"pg_catalog", "information_schema", "sys"}
+
+
 @dataclass(frozen=True)
 class Dialect:
     """A thin wrapper around a sqlglot dialect name plus the handful of

pgdevkit/fetch_missing.py

@@ -50,7 +50,12 @@ def layer_folder_for(scripts_dir: Path, schema: str) -> Path:
 
 def find_missing_objects(scripts_dir: Path, conninfo: str) -> list[MissingObject]:
     """Tables, views, and functions that exist in the live database but
-    aren't tracked as .sql files under scripts_dir."""
+    aren't tracked as .sql files under scripts_dir.
+
+    Deliberately not area-filterable: this diffs the *full* database against
+    scripts with report_extra_db=True, so narrowing the scripts side to one
+    area would make every object tracked only under a different area look
+    "missing" too — and --write would reconstruct a duplicate file for it."""
     scripts = parse_directory(scripts_dir)
     db = introspect_db(conninfo)
     diffs = compute_diff(scripts, db, report_extra_db=True)

pgdevkit/migrate.py

@@ -18,6 +18,10 @@ import sqlglot
 from psycopg import errors as pg_errors
 from psycopg import sql as pg_sql
 
+from .areas import filter_by_area
+from .schemas import filter_by_schema
+from .sql_text import strip_line_comments
+
 _IDENTIFIER = r"[A-Za-z_][A-Za-z0-9_]*"
 _DEFAULT_TRACKING_TABLE = "public.schema_migrations"
 
@@ -122,61 +126,12 @@ def _split_sql(sql: str) -> list[str]:
     return stmts
 
 
-def _strip_line_comments(sql: str) -> str:
-    """Drop '--' line comments, respecting string literals and $$...$$ blocks."""
-    buf: list[str] = []
-    i = 0
-    in_string = False
-    in_line_comment = False
-    dollar_tag: str | None = None
-
-    while i < len(sql):
-        c = sql[i]
-        if in_line_comment:
-            if c == "\n":
-                in_line_comment = False
-                buf.append(c)
-        elif dollar_tag is not None:
-            buf.append(c)
-            if c == "$" and sql[i:i + len(dollar_tag)] == dollar_tag:
-                buf.extend(list(dollar_tag[1:]))
-                i += len(dollar_tag)
-                dollar_tag = None
-                continue
-        elif in_string:
-            if c == "'" and i + 1 < len(sql) and sql[i + 1] == "'":
-                buf.append(c)
-                buf.append(sql[i + 1])
-                i += 2
-                continue
-            elif c == "'":
-                in_string = False
-            buf.append(c)
-        elif c == "-" and i + 1 < len(sql) and sql[i + 1] == "-":
-            in_line_comment = True
-        elif c == "$":
-            m = re.match(r"\$([A-Za-z0-9_]*)\$", sql[i:])
-            if m:
-                dollar_tag = m.group(0)
-                buf.extend(list(dollar_tag))
-                i += len(dollar_tag)
-                continue
-            buf.append(c)
-        elif c == "'":
-            in_string = True
-            buf.append(c)
-        else:
-            buf.append(c)
-        i += 1
-    return "".join(buf)
-
-
 def _created_table_names(stmts: list[str]) -> list[str]:
     """Names of tables any CREATE TABLE statement targets, parsed via sqlglot (falls back to
     regex on comment-stripped text for statements sqlglot's postgres dialect can't parse)."""
     names: list[str] = []
     for stmt in stmts:
-        stripped = _strip_line_comments(stmt)
+        stripped = strip_line_comments(stmt)
         if not re.search(r"CREATE\s+TABLE", stripped, re.IGNORECASE):
             continue  # skip sqlglot entirely for statements that can't be a CREATE TABLE
         try:
@@ -218,7 +173,7 @@ def _idempotent_target(stmt: str) -> tuple[str, ...] | None:
     COLUMN. None if the statement isn't one of these shapes — including any CREATE OR
     REPLACE, which is never safe to treat as a no-op just because the object exists, since
     the migration could be replacing it with different content."""
-    stripped = _strip_line_comments(stmt).strip()
+    stripped = strip_line_comments(stmt).strip()
     if re.search(r"\bOR\s+REPLACE\b", stripped, re.IGNORECASE):
         return None
 
@@ -274,8 +229,17 @@ def already_fully_applied(conninfo: str, path: Path) -> bool:
         return all(_target_exists(con, cast(tuple[str, ...], t)) for t in targets)
 
 
-def list_migration_files(migrations_dir: Path) -> list[Path]:
-    return sorted(migrations_dir.glob("*.sql"))
+def list_migration_files(
+    migrations_dir: Path,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> list[Path]:
+    files = sorted(migrations_dir.glob("*.sql"))
+    files = filter_by_area(files, only=areas, exclude=exclude_areas)
+    return filter_by_schema(files, only=schemas, exclude=exclude_schemas)
 
 
 def applied_migrations(conninfo: str, tracking_table: str) -> dict[str, tuple[datetime, str]]:
@@ -291,9 +255,21 @@ def applied_migrations(conninfo: str, tracking_table: str) -> dict[str, tuple[da
         return {r[0]: (r[1], r[2]) for r in rows}
 
 
-def pending_migrations(migrations_dir: Path, conninfo: str, tracking_table: str) -> list[Path]:
+def pending_migrations(
+    migrations_dir: Path,
+    conninfo: str,
+    tracking_table: str,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> list[Path]:
     applied = applied_migrations(conninfo, tracking_table)
-    return [p for p in list_migration_files(migrations_dir) if p.name not in applied]
+    files = list_migration_files(
+        migrations_dir, areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas
+    )
+    return [p for p in files if p.name not in applied]
 
 
 def record_applied(conninfo: str, tracking_table: str, filename: str) -> bool:

pgdevkit/parser.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import os
 import re
 import logging
 from pathlib import Path
@@ -7,7 +8,9 @@ from pathlib import Path
 import sqlglot
 import sqlglot.expressions as exp
 
+from .areas import area_allowed, parse_areas
 from .dialect import Dialect, POSTGRES, resolve_dialect
+from .schemas import schema_allowed, sql_schemas
 from .models import (
     ColumnDef, ConstraintDef, CompositeTypeDef, DatabaseSchema,
     EnumDef, FunctionDef, IndexDef, TableDef, ViewDef,
@@ -39,18 +42,44 @@ _DO_COMPOSITE = re.compile(
 )
 
 
-def parse_directory(scripts_dir: Path, *, dialect: str | Dialect = "postgres") -> DatabaseSchema:
+def _iter_sql_files(scripts_dir: Path):
+    for root, dirs, files in os.walk(scripts_dir):
+        dirs[:] = [d for d in dirs if d not in IGNORED_DIR_NAMES]
+        for name in files:
+            if name.endswith(".sql"):
+                yield Path(root) / name
+
+
+def parse_directory(
+    scripts_dir: Path,
+    *,
+    dialect: str | Dialect = "postgres",
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> DatabaseSchema:
     resolved = resolve_dialect(dialect)
     db_schema = DatabaseSchema()
-    for sql_file in sorted(scripts_dir.rglob("*.sql")):
-        if IGNORED_DIR_NAMES.intersection(sql_file.relative_to(scripts_dir).parts[:-1]):
+    for sql_file in sorted(_iter_sql_files(scripts_dir)):
+        # Read once and reuse for the area/schema checks and parsing, rather
+        # than filtering the file list up front (which would need its own read).
+        content = sql_file.read_text(encoding="utf-8")
+        if (areas or exclude_areas) and not area_allowed(parse_areas(content), only=areas, exclude=exclude_areas):
+            continue
+        if (schemas or exclude_schemas) and not schema_allowed(
+            sql_schemas(content, resolved), only=schemas, exclude=exclude_schemas
+        ):
             continue
-        _parse_file(sql_file, db_schema, resolved)
+        _parse_file(sql_file, db_schema, resolved, content=content)
     return db_schema
 
 
-def _parse_file(path: Path, db_schema: DatabaseSchema, dialect: Dialect = POSTGRES) -> None:
-    content = path.read_text(encoding="utf-8")
+def _parse_file(
+    path: Path, db_schema: DatabaseSchema, dialect: Dialect = POSTGRES, content: str | None = None
+) -> None:
+    if content is None:
+        content = path.read_text(encoding="utf-8")
     try:
         exprs = sqlglot.parse(content, dialect=dialect.sqlglot_name, error_level=sqlglot.ErrorLevel.WARN)
     except Exception as e:

pgdevkit/schemas.py

@@ -0,0 +1,118 @@
+"""Schema-membership filtering, composable with (but independent of) the
+`-- area:` tag filtering in `areas.py`.
+
+Unlike area, which is an explicit opt-in tag, a file's schema membership is
+derived by parsing its SQL: every schema-qualified (or default-schema, when
+unqualified) table/view/function/index/schema reference across every
+statement in the file, DDL or DML alike.
+
+A file whose schema(s) can't be determined -- content sqlglot can't parse at
+all, or with no table/schema reference in it (e.g. a DO block touching no
+table) -- is treated the same as an untagged file for `-- area:`: `only`
+filters always keep it, `exclude` filters never drop it. Being unable to
+prove a file belongs to an excluded schema is not the same as proving it
+doesn't, so this errs toward keeping the file in scope rather than silently
+dropping it.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+
+import sqlglot
+import sqlglot.expressions as exp
+
+from .dialect import Dialect, POSTGRES, SYSTEM_SCHEMAS
+from .sql_text import strip_line_comments
+
+_CREATE_SCHEMA_RE = re.compile(
+    r"CREATE\s+SCHEMA\s+(?:IF\s+NOT\s+EXISTS\s+)?(?:AUTHORIZATION\s+)?\"?(\w+)\"?", re.IGNORECASE
+)
+_QUALIFIED_REF_RE = re.compile(r"\b(\w+)\.\w+")
+
+
+def _regex_fallback(sql: str) -> frozenset[str]:
+    """Crude schema scan used when sqlglot can't parse `sql` at all, or found
+    no reference. Errs toward over-matching (any `schema.name`-shaped token)
+    rather than under-matching -- a false positive here only keeps a file in
+    scope for one extra schema filter, where a false negative would silently
+    drop it from an `only` filter. Comments are stripped first so a schema
+    merely *mentioned* in one (e.g. "-- see billing.invoice for context")
+    isn't mistaken for a real reference; string literals are left as-is
+    (matching one inside a literal is the same over-matching tradeoff as
+    above, not worth the complexity of also blanking them out)."""
+    stripped = strip_line_comments(sql)
+    schemas = set(_CREATE_SCHEMA_RE.findall(stripped))
+    schemas.update(m.group(1) for m in _QUALIFIED_REF_RE.finditer(stripped))
+    return frozenset(s for s in schemas if s.lower() not in SYSTEM_SCHEMAS)
+
+
+def sql_schemas(content: str, dialect: Dialect = POSTGRES) -> frozenset[str]:
+    """Schema names referenced anywhere in `content`: every table/view/
+    function/index reference's schema (its `dialect.default_schema` when
+    unqualified), plus any `CREATE SCHEMA name`. Falls back to a regex scan
+    when sqlglot can't parse the content, or finds no reference at all."""
+    try:
+        exprs = sqlglot.parse(content, dialect=dialect.sqlglot_name, error_level=sqlglot.ErrorLevel.IGNORE)
+    except Exception:  # noqa: BLE001
+        return _regex_fallback(content)
+
+    schemas: set[str] = set()
+    for e in exprs:
+        if e is None:
+            continue
+        for t in e.find_all(exp.Table):
+            # T-SQL's `EXEC('...dynamic sql...')` parses as a Table subquery
+            # whose "name" is the whole literal string, not a real
+            # identifier -- e.g. a quoted "CREATE SCHEMA app". Guard against
+            # treating that as a schema-qualified (or default-schema) table
+            # reference by rejecting a name containing whitespace -- a real
+            # identifier, quoted or not (even one with hyphens or other
+            # punctuation), never has any, while embedded SQL text always
+            # does. Still accepts an empty name, the legitimate shape
+            # sqlglot gives a bare `CREATE SCHEMA x` (whose schema name ends
+            # up in `db`, not `this`).
+            if t.name and re.search(r"\s", t.name):
+                continue
+            db_node = t.args.get("db")
+            name = db_node.name if db_node else dialect.default_schema
+            if name.lower() not in SYSTEM_SCHEMAS:
+                schemas.add(name)
+
+    if not schemas:
+        return _regex_fallback(content)
+    return frozenset(schemas)
+
+
+def file_schemas(path: Path, dialect: Dialect = POSTGRES) -> frozenset[str]:
+    """Schema names referenced in the file at `path`."""
+    return sql_schemas(path.read_text(encoding="utf-8"), dialect)
+
+
+def schema_allowed(
+    schemas: frozenset[str],
+    *,
+    only: frozenset[str] | None = None,
+    exclude: frozenset[str] | None = None,
+) -> bool:
+    """Whether a file that references `schemas` passes an `only`/`exclude` filter."""
+    if exclude and schemas & exclude:
+        return False
+    if only and schemas and not (schemas & only):
+        return False
+    return True
+
+
+def filter_by_schema(
+    paths: list[Path],
+    *,
+    only: frozenset[str] | None = None,
+    exclude: frozenset[str] | None = None,
+    dialect: Dialect = POSTGRES,
+) -> list[Path]:
+    """`paths` restricted by an `only`/`exclude` schema filter. Returns `paths`
+    unchanged (no file reads) when neither filter is set."""
+    if not only and not exclude:
+        return paths
+    return [p for p in paths if schema_allowed(file_schemas(p, dialect), only=only, exclude=exclude)]

pgdevkit/sql_text.py

@@ -0,0 +1,56 @@
+"""Small text-level SQL helpers shared by modules that can't import each
+other directly (`migrate.py` imports `schemas.py`, so `schemas.py` can't
+import back from `migrate.py`)."""
+
+from __future__ import annotations
+
+import re
+
+
+def strip_line_comments(sql: str) -> str:
+    """Drop '--' line comments, respecting string literals and $$...$$ blocks."""
+    buf: list[str] = []
+    i = 0
+    in_string = False
+    in_line_comment = False
+    dollar_tag: str | None = None
+
+    while i < len(sql):
+        c = sql[i]
+        if in_line_comment:
+            if c == "\n":
+                in_line_comment = False
+                buf.append(c)
+        elif dollar_tag is not None:
+            buf.append(c)
+            if c == "$" and sql[i:i + len(dollar_tag)] == dollar_tag:
+                buf.extend(list(dollar_tag[1:]))
+                i += len(dollar_tag)
+                dollar_tag = None
+                continue
+        elif in_string:
+            if c == "'" and i + 1 < len(sql) and sql[i + 1] == "'":
+                buf.append(c)
+                buf.append(sql[i + 1])
+                i += 2
+                continue
+            elif c == "'":
+                in_string = False
+            buf.append(c)
+        elif c == "-" and i + 1 < len(sql) and sql[i + 1] == "-":
+            in_line_comment = True
+        elif c == "$":
+            m = re.match(r"\$([A-Za-z0-9_]*)\$", sql[i:])
+            if m:
+                dollar_tag = m.group(0)
+                buf.extend(list(dollar_tag))
+                i += len(dollar_tag)
+                continue
+            buf.append(c)
+        elif c == "'":
+            in_string = True
+            buf.append(c)
+        else:
+            buf.append(c)
+        i += 1
+    return "".join(buf)

pgdevkit/testdb/api.py

@@ -68,24 +68,53 @@ async def _drop_database(db_name: str) -> None:
         await con.execute(SQL("DROP DATABASE IF EXISTS {}").format(Identifier(db_name)))
 
 
-async def _apply(config: ProjectConfig, db_name: str, force_reset: bool) -> None:
+async def _apply(
+    config: ProjectConfig,
+    db_name: str,
+    force_reset: bool,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> None:
     async with await psycopg.AsyncConnection.connect(_db_dsn(db_name), autocommit=True) as con:
         await apply_schema(
             con,
             config.root / config.database_dir,
             extensions=config.extensions,
             force_reset=force_reset,
+            areas=areas,
+            exclude_areas=exclude_areas,
+            schemas=schemas,
+            exclude_schemas=exclude_schemas,
         )
 
 
-def ensure_testdb(project_root: Path | None = None, force_reset: bool = False) -> dict[str, str]:
+def ensure_testdb(
+    project_root: Path | None = None,
+    force_reset: bool = False,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> dict[str, str]:
     """Ensure the shared container is running, this workspace's database
     exists, and its schema is applied. Returns the {PREFIX}POSTGRES_* env
     vars for this workspace (or the mssql equivalent's env vars, per
-    `config.engine`)."""
+    `config.engine`).
+
+    `areas`/`exclude_areas` and `schemas`/`exclude_schemas` restrict which
+    database/ files get applied -- e.g. for a test DB scoped to one area or
+    schema. Neither filters what gets *dropped* by force_reset/clean, only
+    what gets (re)applied."""
     config, db_name = _resolve(project_root)
     if config.engine == "mssql":
-        return _mssql_api().ensure_testdb(config, db_name, force_reset)
+        return _mssql_api().ensure_testdb(
+            config, db_name, force_reset,
+            areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas,
+        )
 
     ensure_container()
 
@@ -93,16 +122,29 @@ def ensure_testdb(project_root: Path | None = None, force_reset: bool = False) -
         if force_reset:
             await _drop_database(db_name)
         await _ensure_database(db_name)
-        await _apply(config, db_name, force_reset)
+        await _apply(
+            config, db_name, force_reset,
+            areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas,
+        )
 
     asyncio.run(_run())
     return _env_for(config, db_name)
 
 
-def reset_testdb(project_root: Path | None = None) -> dict[str, str]:
+def reset_testdb(
+    project_root: Path | None = None,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> dict[str, str]:
     """Drop and recreate only this workspace's database, then reapply
     schema and seed data."""
-    return ensure_testdb(project_root, force_reset=True)
+    return ensure_testdb(
+        project_root, force_reset=True,
+        areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas,
+    )
 
 
 def clean_testdb(project_root: Path | None = None, all: bool = False) -> None:

pgdevkit/testdb/mssql/api.py

@@ -101,7 +101,16 @@ async def _insert_test_data(json_file: Path, table: str, force_reset: bool, conn
     await asyncio.to_thread(_run)
 
 
-async def _apply(config: ProjectConfig, db_name: str, force_reset: bool) -> None:
+async def _apply(
+    config: ProjectConfig,
+    db_name: str,
+    force_reset: bool,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> None:
     def _connect() -> Any:
         return mssql_python.connect(_db_dsn(db_name), autocommit=True)
 
@@ -110,7 +119,10 @@ async def _apply(config: ProjectConfig, db_name: str, force_reset: bool) -> None
         database_dir = config.root / config.database_dir
         if not database_dir.is_dir():
             return
-        for file, sql in _iter_sql_files(database_dir, MSSQL):
+        for file, sql in _iter_sql_files(
+            database_dir, MSSQL,
+            areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas,
+        ):
             for batch in query.split_tsql_batches(sql):
 
                 def _exec(batch: str = batch) -> None:
@@ -126,14 +138,26 @@ async def _apply(config: ProjectConfig, db_name: str, force_reset: bool) -> None
         await asyncio.to_thread(conn.close)
 
 
-def ensure_testdb(config: ProjectConfig, db_name: str, force_reset: bool) -> dict[str, str]:
+def ensure_testdb(
+    config: ProjectConfig,
+    db_name: str,
+    force_reset: bool,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+) -> dict[str, str]:
     ensure_mssql_container()
 
     async def _run() -> None:
         if force_reset:
             await _drop_database(db_name)
         await _ensure_database(db_name)
-        await _apply(config, db_name, force_reset)
+        await _apply(
+            config, db_name, force_reset,
+            areas=areas, exclude_areas=exclude_areas, schemas=schemas, exclude_schemas=exclude_schemas,
+        )
 
     asyncio.run(_run())
     return _env_for(config, db_name)

pgdevkit/testdb/schema.py

@@ -13,9 +13,11 @@ import sqlglot.expressions as exp
 from psycopg.rows import dict_row
 from psycopg.sql import SQL, Identifier, Placeholder
 
+from ..areas import area_allowed, parse_areas
 from ..db.complex_types import ComplexHelper
-from ..dialect import Dialect, POSTGRES
+from ..dialect import Dialect, POSTGRES, SYSTEM_SCHEMAS
 from ..parser import IGNORED_DIR_NAMES
+from ..schemas import schema_allowed, sql_schemas
 
 logger = logging.getLogger(__name__)
 logging.getLogger("sqlglot").setLevel(logging.ERROR)
@@ -65,16 +67,14 @@ _SCHEMA_QUALIFIED_TYPES = {
 }
 
 
-# Schemas that hold system catalog views/tables, never a file this project
-# manages -- a reference to one is never a real cross-file dependency to
-# wait for. Matters most for T-SQL, where "IF NOT EXISTS (SELECT ... FROM
-# sys.schemas/sys.tables/sys.objects ...) BEGIN CREATE ... END" is the
-# idiomatic idempotency-guard pattern (T-SQL has no native "CREATE TABLE IF
-# NOT EXISTS"/"CREATE SCHEMA IF NOT EXISTS"), so without this exclusion
-# nearly every T-SQL file would pick up a spurious, never-resolvable
-# dependency on "sys.*" and get shuffled into the delayed-retry path, whose
-# reverse-order resolution can then apply files out of their intended order.
-_SYSTEM_SCHEMAS = {"pg_catalog", "information_schema", "sys"}
+# SYSTEM_SCHEMAS (see dialect.py) matters most here for T-SQL, where
+# "IF NOT EXISTS (SELECT ... FROM sys.schemas/sys.tables/sys.objects ...)
+# BEGIN CREATE ... END" is the idiomatic idempotency-guard pattern (T-SQL has
+# no native "CREATE TABLE IF NOT EXISTS"/"CREATE SCHEMA IF NOT EXISTS"), so
+# without this exclusion nearly every T-SQL file would pick up a spurious,
+# never-resolvable dependency on "sys.*" and get shuffled into the
+# delayed-retry path, whose reverse-order resolution can then apply files
+# out of their intended order.
 
 _DECLARE_RE = re.compile(
     r"CREATE\s+(?:OR\s+REPLACE\s+)?(?:TABLE|VIEW|FUNCTION|PROCEDURE|TYPE|SCHEMA)\s+(\w+\.\w+)", re.IGNORECASE
@@ -89,7 +89,7 @@ def _get_sql_deps_regex_fallback(sql: str) -> set[str]:
     is fine."""
     declares = set(_DECLARE_RE.findall(sql))
     deps = set(_DEPEND_RE.findall(sql))
-    deps = {d for d in deps if d.split(".", 1)[0].lower() not in _SYSTEM_SCHEMAS}
+    deps = {d for d in deps if d.split(".", 1)[0].lower() not in SYSTEM_SCHEMAS}
     return deps - declares
 
 
@@ -109,7 +109,7 @@ def _get_sql_deps(sql: str, dialect: Dialect = POSTGRES) -> set[str]:
         for t in e.find_all(exp.Table):
             db_node = t.args.get("db")
             if t.args.get("this") is not None and db_node is not None:
-                if db_node.name.lower() in _SYSTEM_SCHEMAS:
+                if db_node.name.lower() in SYSTEM_SCHEMAS:
                     continue
                 # exp.table_name(), not str(t): str() includes " AS alias" for
                 # an aliased reference (e.g. "FROM editing.visit v"), which
@@ -119,8 +119,21 @@ def _get_sql_deps(sql: str, dialect: Dialect = POSTGRES) -> set[str]:
     return deps
 
 
-def _iter_sql_files(database_dir: Path, dialect: Dialect = POSTGRES):
-    """Yield (Path, sql_content) pairs in dependency-safe execution order."""
+def _iter_sql_files(
+    database_dir: Path,
+    dialect: Dialect = POSTGRES,
+    *,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
+):
+    """Yield (Path, sql_content) pairs in dependency-safe execution order.
+
+    A file dropped by the area/schema filter is skipped entirely -- as if it
+    didn't exist -- so it never delivers a dependency another (in-scope)
+    file waits on; that's the same tradeoff `list_migration_files`/
+    `parse_directory` make for migrations/database code files."""
     files: list[Path] = []
     for root, dirs, dbfiles in os.walk(database_dir):
         dirs[:] = [d for d in dirs if d not in IGNORED_DIR_NAMES]
@@ -138,6 +151,12 @@ def _iter_sql_files(database_dir: Path, dialect: Dialect = POSTGRES):
 
     for file in sorted(files, key=lambda p: (_get_type_order(p), p.name)):
         content = file.read_text(encoding="utf-8")
+        if (areas or exclude_areas) and not area_allowed(parse_areas(content), only=areas, exclude=exclude_areas):
+            continue
+        if (schemas or exclude_schemas) and not schema_allowed(
+            sql_schemas(content, dialect), only=schemas, exclude=exclude_schemas
+        ):
+            continue
         deps = _get_sql_deps(content, dialect)
         if file.parent.name in _SCHEMA_QUALIFIED_TYPES:
             schema = _strip_layer_prefix(file.parent.parent.name)
@@ -242,6 +261,10 @@ async def apply_schema(
     force_reset: bool = False,
     *,
     dialect: Dialect = POSTGRES,
+    areas: frozenset[str] | None = None,
+    exclude_areas: frozenset[str] | None = None,
+    schemas: frozenset[str] | None = None,
+    exclude_schemas: frozenset[str] | None = None,
 ) -> None:
     """Apply every .sql file under database_dir (in dependency-safe order)
     and seed any matching .test_data.json files. Safe to call repeatedly.
@@ -249,7 +272,12 @@ async def apply_schema(
     `migrations/` subdirectories are never applied here — they're for
     one-time manual application against real (already-provisioned)
     databases, not for building a fresh schema. The base object files under
-    `database_dir` must reflect the current, final schema on their own."""
+    `database_dir` must reflect the current, final schema on their own.
+
+    `areas`/`exclude_areas` and `schemas`/`exclude_schemas` restrict which
+    files get applied, the same as `pgdevkit migrate`/`compare` — handy for
+    standing up a test DB scoped to one area or schema instead of the whole
+    project."""
     await con.set_autocommit(True)
     for extension in extensions:
         await con.execute(SQL("CREATE EXTENSION IF NOT EXISTS {e}").format(e=Identifier(extension)))
@@ -265,7 +293,14 @@ async def apply_schema(
             await _insert_test_data(json_file, f"{schema_name}.{table_stem}", force_reset, con, complex_helper)
 
     failures: list[tuple[Path, str]] = []
-    for file, sql in _iter_sql_files(database_dir, dialect):
+    for file, sql in _iter_sql_files(
+        database_dir,
+        dialect,
+        areas=areas,
+        exclude_areas=exclude_areas,
+        schemas=schemas,
+        exclude_schemas=exclude_schemas,
+    ):
         try:
             await _apply(file, sql)
         except Exception as e:  # noqa: BLE001

{pgdevkit-0.3.8.dist-info → pgdevkit-0.5.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: pgdevkit
-Version: 0.3.8
+Version: 0.5.0
 Summary: A helper for developing with Postgres
 Requires-Python: >=3.14
 Requires-Dist: docker>=7.1.0
@@ -79,6 +79,94 @@ which parses/introspects/diffs like any other column type; see
 handled on the CRUD side (write-side serialization only, no auto-parsing on
 read — `mssql-python` doesn't distinguish `json` columns from `nvarchar`).
 
+### Area and schema filtering
+
+Two independent, composable ways to narrow which files a command touches:
+**area** is an explicit opt-in tag; **schema** is derived automatically from
+each file's own SQL.
+
+#### Area tagging
+
+Any migration file or `database/` code file can declare one or more areas by
+starting with a `-- area:` comment:
+
+```sql
+-- area: billing
+CREATE TABLE billing.invoices (id int primary key);
+```
+
+A file can declare more than one area, either comma-separated on one line
+(`-- area: billing, reporting`) or across several `-- area:` lines — the
+declared areas union. The directive is only recognized in the file's leading
+comment block (blank lines and `--` comments at the very top, stopping at the
+first real statement); a `-- area:` comment later in the file doesn't count.
+A file with no directive is untagged, and untagged files are treated as
+shared/common.
+
+#### Schema filtering
+
+No tag needed — schema membership is parsed straight out of the SQL itself:
+every schema-qualified (or default-schema, when unqualified) table/view/
+function/index reference across every statement in the file, DDL or DML
+alike, plus any `CREATE SCHEMA name`. A file whose schema(s) can't be
+determined (unparseable content, or no table/schema reference in it at all)
+is treated the same as an untagged file — always kept.
+
+#### Options
+
+`pgdb compare`, `pgdb migrate check`, `pgdb migrate apply`, `pgdb testdb up`,
+and `pgdb testdb reset` all accept:
+
+- `--area NAME` (repeatable) — restrict to files declaring one of the given
+  areas, **plus every untagged file** (untagged files always stay in scope).
+- `--exclude-area NAME` (repeatable) — drop files declaring one of the given
+  areas; untagged files are never dropped by this.
+- `--schema NAME` (repeatable) — restrict to files referencing one of the
+  given schemas, **plus every file with no detectable schema reference**.
+- `--exclude-schema NAME` (repeatable) — drop files referencing one of the
+  given schemas; files with no detectable reference are never dropped.
+
+All four can be combined — a file must pass every filter it's subject to (an
+area match doesn't excuse a schema mismatch, and vice versa), and a file
+matching both an included and an excluded value on the same axis is
+excluded. Passing none of them applies no filtering (the default, unchanged
+behavior).
+
+```bash
+pgdb migrate apply path/to/database/_migration_scripts --url ... --area billing
+pgdb compare path/to/database/ --url ... --exclude-area reporting
+pgdb migrate check path/to/database/_migration_scripts --url ... --schema billing --exclude-schema reporting
+pgdb testdb up --schema billing
+```
+
+`compare`'s default report (no `--report-extra-db`) only checks that the
+filtered scripts exist correctly in the DB, so it composes safely with area
+and schema filtering. Passing `--report-extra-db` together with either kind
+of filter also reports every DB object outside the filtered area(s)/
+schema(s) as "missing in scripts" — since the live database has no concept
+of areas, and isn't itself filtered by `--schema` either — only the scripts
+side is filtered — so treat that combination's "missing in scripts" results
+with that in mind (the CLI prints a warning when you combine them).
+
+`pgdb fetch-missing` deliberately has **no** `--area`/`--exclude-area` (or
+`--schema`/`--exclude-schema`): it diffs the full database against scripts
+to find genuinely untracked objects, so narrowing the scripts side would
+make every object tracked under a different area/schema look "missing" too
+— and `--write` would then reconstruct a duplicate file for something that
+already exists.
+
+`pgdevkit.areas` exposes the tag-filtering logic for scripting:
+`parse_areas`/`file_areas` read a file's declared areas, and
+`area_allowed`/`filter_by_area` apply the `only`/`exclude` semantics above.
+`pgdevkit.schemas` exposes the equivalent for schema filtering:
+`sql_schemas`/`file_schemas` detect a file's referenced schemas, and
+`schema_allowed`/`filter_by_schema` apply the same `only`/`exclude`
+semantics. `pgdevkit.migrate.list_migration_files`/`pending_migrations` and
+`pgdevkit.parser.parse_directory` take both pairs of keyword arguments
+(`areas`/`exclude_areas` and `schemas`/`exclude_schemas`);
+`pgdevkit.fetch_missing.find_missing_objects` takes neither, for the reason
+above.
+
 ## `pgdb testdb`
 
 Manages a single shared, Podman-backed Postgres container for local tests
@@ -109,6 +197,13 @@ def ensure_test_postgres():
 
 CLI: `pgdb testdb up|reset|run-sql|status|shell|clean`.
 
+`up`/`reset` accept `--area`/`--exclude-area` and `--schema`/`--exclude-schema`
+(see "Area and schema filtering" above) to scope which `database/` files get
+applied — e.g. `pgdb testdb up --schema billing` for a test DB with only the
+`billing` schema's tables/views/functions, without waiting on the rest of the
+project's schema to apply. `ensure_testdb`/`reset_testdb` take the same
+keyword arguments when called from Python (e.g. from a pytest fixture).
+
 Container connection defaults (`localhost:54322`, `postgres`/`testpwd`) can
 be overridden with `PGDEVKIT_TESTDB_HOST`, `PGDEVKIT_TESTDB_PORT`,
 `PGDEVKIT_TESTDB_USER`, `PGDEVKIT_TESTDB_PASSWORD`. Before touching the
@@ -259,3 +354,29 @@ async with pool.connection() as con:
     widget = await pg_retrieve(con, Widget, {"id": 1})
     await pg_upsert(con, Widget(id=1, name="thing"), Widget)
 ```
+
+## Releasing
+
+Bump `version` in `pyproject.toml` as part of your PR, same as any other
+change. Once that PR merges to `main` and the `Python Test` workflow passes
+for that commit, `.github/workflows/auto-release.yml` automatically tags it
+`vX.Y.Z`, cuts a GitHub Release (skipping if that version was already
+released, e.g. a merge that didn't touch the version), and dispatches
+`python-publish.yml` to publish it to PyPI — no manual release step, and no
+extra secret to configure. Two non-obvious GitHub Actions quirks shaped
+this (see the comments at the top of `auto-release.yml` for the full
+reasoning, since both were hit and confirmed the hard way):
+
+- A release created with the default `GITHUB_TOKEN` does **not** trigger
+  other workflows' `release: published` listeners (an anti-recursion
+  safeguard) — `workflow_dispatch` is the documented exception, so
+  `auto-release.yml` dispatches `python-publish.yml` directly (`gh workflow
+  run`) instead of relying on the release to cascade into it.
+- `python-publish.yml` deliberately stays a plain, directly-triggered
+  top-level workflow rather than something `auto-release.yml` calls via
+  `workflow_call`: PyPI's OIDC trusted publishing does not support
+  reusable/called workflows and silently rejects the token in that shape.
+
+`workflow_dispatch` (or an actual GitHub UI release) on `python-publish.yml`
+still works as a manual fallback if you ever need to re-publish a version
+without going through `auto-release.yml`.

{pgdevkit-0.3.8.dist-info → pgdevkit-0.5.0.dist-info}/RECORD

@@ -1,15 +1,18 @@
 pgdevkit/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pgdevkit/cli.py,sha256=xP4fZB0Dg3wivhb00DcP2w2Vnp8BRyaR2o1wD7jopFc,17574
+pgdevkit/areas.py,sha256=iEmOObYxhZyDFl2iQVf1OQJN4JtZ-H3EL-qMfxYZdSQ,2203
+pgdevkit/cli.py,sha256=vVUg4Feln7Mc0DbZIFGPNkOVRsl2AL3ZOXM30hRoWLc,21179
 pgdevkit/connection.py,sha256=x49aXKsJfyOsDTlqURs9idQUWaD-RO-XdtAqsG3guBI,4000
-pgdevkit/dialect.py,sha256=PL5Y8QPZNnoHIvAPomczGQX7IjZwxMgKGuREX80SwFA,3105
+pgdevkit/dialect.py,sha256=gZwn4UNZ8PYBPC4CnYnfA95C7ppv7sWmpZSF8pjSPVw,3659
 pgdevkit/diff.py,sha256=Y2TbjwpFHYik0wZDhoI--9EAlIfp4AUg8BUubkOXyUg,9295
-pgdevkit/fetch_missing.py,sha256=soSNqnbA06A0-b_OI7plf772eurFVfYNz20EGO6BxO8,8190
+pgdevkit/fetch_missing.py,sha256=vb8hXWBKMWgqkxHso5SuhX9l6rxNXfaybAEsajPLYow,8495
 pgdevkit/introspect.py,sha256=QYIlRuZk4lBHGxaW7zb_kFRIuNfi3AxH0Q2F_GKzlVI,7870
 pgdevkit/lakebase.py,sha256=0PABOk4p-2klLTY8QAUibQf9QeyNHKywUWEWGdkUY8k,3165
-pgdevkit/migrate.py,sha256=pU7xVssJiAHfFFU60DP2cwpjQ1Tf8Hscc_Q6wIqeSfM,13677
+pgdevkit/migrate.py,sha256=UvR5hrkkM7yO65eUL3ZPwJ5405e6nJWMJDyIwu78ugA,12945
 pgdevkit/models.py,sha256=dAZ8f7pgDsxoLVrDWsM4h0qwJ0pOzXDdWMGsnjrW80E,2103
 pgdevkit/mssql_introspect.py,sha256=Fhv1N4zHYEDZ0PEy0OIpawUmoIFeoi-Lm97pmEyDmYY,12031
-pgdevkit/parser.py,sha256=gbXqp5vlCD-JxlvENuJtGIuFvL3U6ndeBOySgkwWPzw,15820
+pgdevkit/parser.py,sha256=FmXL6-eCFzP_0FNyTrg4wF3aPzPeq7re2i0xvrSJIcs,16885
+pgdevkit/schemas.py,sha256=zZsg3m9FtI7IUG8e8HfRruCh6-O6bdpbA7Kjnk3AYJg,5053
+pgdevkit/sql_text.py,sha256=ednfdfxGBTWYqQ5Q3l3Zv9vrjjFmLiRlGKyq3tcozco,1744
 pgdevkit/backends/__init__.py,sha256=ys4VBglMImRtnudJBlTPVBNevDMRippuwAJOz0yRKiY,610
 pgdevkit/backends/base.py,sha256=0i0KLCYVWlpVFnUoq2t0LCRE_abyWPPIhw1bMxmW9KQ,1048
 pgdevkit/backends/mssql.py,sha256=pocBdoQ14ZnYLutXEOStVmJvmpclXGs3gaxHN0uJCMk,1068
@@ -24,22 +27,22 @@ pgdevkit/db/mssql_crud.py,sha256=yN4izZ0fsFwAs14008JECHH4dqjNbdHUHGEG8kidyNs,113
 pgdevkit/db/mssql_sql.py,sha256=DO3UMsTFN9pg0tNdaPGb0wf6lWlHGcqwqzkrGVhJF2g,2292
 pgdevkit/testdb/__init__.py,sha256=LpdC2XMBxqn9JrGmXhIho3sK8O1aNo_aD7leKyBr-Lo,204
 pgdevkit/testdb/_docker.py,sha256=kj_0xrGO_mxHlK83ilsB-yE0ELX1kpH22ruYrS-N3iU,1467
-pgdevkit/testdb/api.py,sha256=l1hqX7lLLLzk3hMgbtg7EpbZ7SdwPVPwupBCPu3xRRg,6038
+pgdevkit/testdb/api.py,sha256=QE0UmtUNI1dc1MG4MdyatSbswHj4mAc-aWSjtL35x0w,7407
 pgdevkit/testdb/config.py,sha256=vjcDr3jH3-5VakNAEMqQu_ZHPXiYIvM1_BSETSJW5QU,2164
 pgdevkit/testdb/constants.py,sha256=xi8uIoEgN9LrRkr41j3mmWB9PqqU0r8aCUb2JJXBAs0,1165
 pgdevkit/testdb/container.py,sha256=kELTb6qaECAO9a5Bwvx1btv6i5QKRFAa9PX6auWymNo,2807
 pgdevkit/testdb/naming.py,sha256=Kyk5qEfxUkbggUG5bD7U7CJ_kAET332VPQNB-O5kvTY,1318
 pgdevkit/testdb/query.py,sha256=iYpy_EoYIq5USfwr6pNktmDjcGi_yQx0vHvjHZNGRr0,3854
-pgdevkit/testdb/schema.py,sha256=0N0Q_BQGh2kuAqa_j-DdbjYlTUOOZSEtaoUOApxQg_Y,12049
+pgdevkit/testdb/schema.py,sha256=fuW5juQWoMW9J2mzPQxLZDlF4ZExEPCVhbQ5DCUMhNg,13349
 pgdevkit/testdb/mssql/__init__.py,sha256=U4S_2y3zgLZVfMenHRaJFBW8yqh2mUBuI291LGQVOJ8,35
-pgdevkit/testdb/mssql/api.py,sha256=42RAuJeiZlK1WJaTIYoj6l8GEAbEyt6LgAoF3G2jxnw,7537
+pgdevkit/testdb/mssql/api.py,sha256=Q5Gt8t4LbDtDkMXXSQdd2_Ud7nhelF2UpD8KoUjI3qg,8203
 pgdevkit/testdb/mssql/constants.py,sha256=7n_NcYuhabbtb18CqG_H_rRbI7Wb_qu_l4nKk3281vI,2847
 pgdevkit/testdb/mssql/container.py,sha256=_rG0AMDXrNwok_E60Xai0DZdRiZ6Ba1j3GaLUnSAueg,3364
 pgdevkit/docs/database-layout.md,sha256=4GBwv4PA2cKHl2BxwLd-awLOe9he9ie4X6CpQWjIEyI,6820
 pgdevkit/skills/pgdevkit/SKILL.md,sha256=6uxe6BQwOLexGiBpf00VTFTHOiWJo5k2Qqzu172rb4I,12156
 pgdevkit/skills/pgdevkit/references/dynamic-sql.md,sha256=aTR1sx81moiTwaMaiOecaqk-9rT8y5Zxz7W1BoC3vK0,2774
 pgdevkit/skills/pgdevkit/references/temporal-tables.md,sha256=LwZnItvQWI7bB0oRHxIfUc0ynnq7N0V5Mnv-QHvFN3Q,1364
-pgdevkit-0.3.8.dist-info/METADATA,sha256=jQlfYkvzEolSPiofscelGtur9rzWQClSvOMQxIuc7Uo,11346
-pgdevkit-0.3.8.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
-pgdevkit-0.3.8.dist-info/entry_points.txt,sha256=FK2P55lf0WaGlOZJIINOGgCt8WB7ep0OnPsgnrp80bg,42
-pgdevkit-0.3.8.dist-info/RECORD,,
+pgdevkit-0.5.0.dist-info/METADATA,sha256=1RXl13YLU2NmB8E4YXpLGc3pNr4EUp1C4INsK0pLJ-s,17629
+pgdevkit-0.5.0.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+pgdevkit-0.5.0.dist-info/entry_points.txt,sha256=FK2P55lf0WaGlOZJIINOGgCt8WB7ep0OnPsgnrp80bg,42
+pgdevkit-0.5.0.dist-info/RECORD,,