execsql2 2.7.1__py3-none-any.whl → 2.9.0__py3-none-any.whl

execsql/cli/__init__.py

@@ -223,6 +223,25 @@ def main(
         "--dry-run",
         help=("Parse the script and print the command list without connecting to a database or executing anything."),
     ),
+    lint: bool = typer.Option(
+        False,
+        "--lint",
+        help=(
+            "Parse the script and perform static analysis without connecting to a database or executing anything. "
+            "Reports unmatched IF/ENDIF/LOOP/BATCH blocks (errors), potentially undefined variables, "
+            "and missing INCLUDE files (warnings). Exits 0 if no errors, 1 if errors found."
+        ),
+    ),
+    ping: bool = typer.Option(
+        False,
+        "--ping",
+        help=(
+            "Test database connectivity and exit. "
+            "Prints connection details and the server version on success (exit 0), "
+            "or the error message on failure (exit 1). "
+            "No script file is required."
+        ),
+    ),
     dsn: str | None = typer.Option(
         None,
         "--dsn",
@@ -254,6 +273,11 @@ def main(
         "--dump-keywords",
         help="Dump all metacommand keywords as JSON and exit.",
     ),
+    profile: bool = typer.Option(
+        False,
+        "--profile",
+        help="Record per-statement execution times and print a timing summary after the script completes.",
+    ),
     version: bool | None = typer.Option(
         None,
         "--version",
@@ -345,6 +369,10 @@ def main(
     positional = args or []
     if command is not None:
         script_name = None  # inline mode — no script file
+    elif ping:
+        # --ping does not require a script file; positional args are still
+        # available for server/db arguments if --dsn is not used.
+        script_name = None
     else:
         if not positional:
             _err_console.print(
@@ -415,6 +443,9 @@ def main(
         dsn=dsn,
         output_dir=output_dir,
         progress=progress,
+        profile=profile,
+        ping=ping,
+        lint=lint,
     )
 
 

execsql/cli/lint.py

@@ -0,0 +1,459 @@
+"""Static analysis (lint) for execsql scripts.
+
+:func:`_lint_script` inspects a parsed :class:`~execsql.script.CommandList`
+for common structural problems without connecting to a database or executing
+any commands.
+
+Checks performed
+----------------
+1. **Unmatched IF / ENDIF** — mismatched nesting depth (error).
+2. **Unmatched LOOP / END LOOP** — mismatched nesting depth (error).
+3. **Unmatched BEGIN BATCH / END BATCH** — mismatched nesting depth (error).
+4. **Potentially undefined variables** — ``!!$VAR!!`` tokens not preceded by a
+   ``SUB`` metacommand in the same parsed command list and not in the set of
+   built-in variables (warning).
+5. **Missing INCLUDE files** — INCLUDE target does not exist on disk relative
+   to the script directory (warning).
+6. **Empty script** — no commands found (warning).
+
+The function walks ``CommandList.cmdlist`` and also descends into any
+``CommandList`` objects stored in ``_state.savedscripts`` (i.e. named scripts
+defined with ``BEGIN SCRIPT … END SCRIPT`` in the same file).  SCRIPT blocks
+are analysed in isolation; nesting counters reset for each block.
+
+Exit-code contract
+------------------
+- Returns ``1`` when at least one **error**-severity issue is found.
+- Returns ``0`` when only warnings (or nothing) are found.
+"""
+
+from __future__ import annotations
+
+import re
+from pathlib import Path
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from execsql.script.engine import CommandList
+
+__all__ = ["_lint_script"]
+
+
+# ---------------------------------------------------------------------------
+# Compiled patterns for metacommand recognition
+# ---------------------------------------------------------------------------
+
+# IF block — "IF(...)" block form (single-command, no ENDIF needed)
+_RX_IF_INLINE = re.compile(
+    r"^\s*IF\s*\(\s*.+\s*\)\s*\{.+\}\s*$",
+    re.I,
+)
+# IF block form that opens a block requiring ENDIF
+_RX_IF_BLOCK = re.compile(r"^\s*IF\s*\(\s*.+\s*\)\s*$", re.I)
+_RX_ENDIF = re.compile(r"^\s*ENDIF\s*$", re.I)
+_RX_ELSE = re.compile(r"^\s*ELSE\s*$", re.I)
+_RX_ELSEIF = re.compile(r"^\s*ELSEIF\s*\(\s*.+\s*\)\s*$", re.I)
+_RX_ANDIF = re.compile(r"^\s*ANDIF\s*\(\s*.+\s*\)\s*$", re.I)
+_RX_ORIF = re.compile(r"^\s*ORIF\s*\(\s*.+\s*\)\s*$", re.I)
+
+# LOOP … END LOOP
+_RX_LOOP = re.compile(r"^\s*LOOP\s+(?:WHILE|UNTIL)\s*\(", re.I)
+_RX_END_LOOP = re.compile(r"^\s*END\s+LOOP\s*$", re.I)
+
+# BEGIN BATCH … END BATCH
+_RX_BEGIN_BATCH = re.compile(r"^\s*BEGIN\s+BATCH\s*$", re.I)
+_RX_END_BATCH = re.compile(r"^\s*END\s+BATCH\s*$", re.I)
+
+# SUB <varname> <value> — defines a substitution variable
+_RX_SUB = re.compile(r"^\s*SUB\s+(?P<name>[+~]?\w+)\s+", re.I)
+
+# INCLUDE <file>
+_RX_INCLUDE = re.compile(
+    r"^\s*INCLUDE(?:\s+IF\s+EXISTS?)?\s+(?P<path>\S+.*?)\s*$",
+    re.I,
+)
+
+# Variable reference — !!name!! where name may start with $, @, &, ~, #, +
+_RX_VAR_REF = re.compile(r"!!([$@&~#+]?\w+)!!", re.I)
+
+# Built-in system variables that are always defined (populated by _run before
+# any script commands execute).  Variable names are stored without the leading
+# ``$`` for case-insensitive set membership tests.
+_BUILTIN_VARS: frozenset[str] = frozenset(
+    {
+        # Start-time / environment
+        "SCRIPT_START_TIME",
+        "SCRIPT_START_TIME_UTC",
+        "DATE_TAG",
+        "DATETIME_TAG",
+        "DATETIME_UTC_TAG",
+        "LAST_ROWCOUNT",
+        "LAST_SQL",
+        "LAST_ERROR",
+        "ERROR_MESSAGE",
+        "USER",
+        "STARTING_PATH",
+        "PATHSEP",
+        "OS",
+        "PYTHON_EXECUTABLE",
+        "STARTING_SCRIPT",
+        "STARTING_SCRIPT_NAME",
+        "STARTING_SCRIPT_REVTIME",
+        "RUN_ID",
+        # Execution-time (set during runscripts — not available in --dry-run
+        # but always defined before any script command can reference them)
+        "CURRENT_TIME",
+        "CURRENT_TIME_UTC",
+        "CURRENT_SCRIPT",
+        "CURRENT_SCRIPT_PATH",
+        "CURRENT_SCRIPT_NAME",
+        "CURRENT_SCRIPT_LINE",
+        "SCRIPT_LINE",
+        "CURRENT_DIR",
+        "CURRENT_PATH",
+        "CURRENT_ALIAS",
+        "AUTOCOMMIT_STATE",
+        "TIMER",
+        "DB_USER",
+        "DB_SERVER",
+        "DB_NAME",
+        "DB_NEED_PWD",
+        "RANDOM",
+        "UUID",
+        "VERSION1",
+        "VERSION2",
+        "VERSION3",
+        "CANCEL_HALT_STATE",
+        "ERROR_HALT_STATE",
+        "METACOMMAND_ERROR_HALT_STATE",
+        "CONSOLE_WAIT_WHEN_ERROR_HALT_STATE",
+        "CONSOLE_WAIT_WHEN_DONE_STATE",
+        "CURRENT_DBMS",
+        "CURRENT_DATABASE",
+        "SYSTEM_CMD_EXIT_STATUS",
+        # Connection-populated
+        "DB_FILE",
+        "DB_PORT",
+        # Counter variables (@@name) are always valid — skip validation
+    },
+)
+
+
+# ---------------------------------------------------------------------------
+# Issue tuple helpers
+# ---------------------------------------------------------------------------
+
+_Issue = tuple[str, str, int, str]  # (severity, source, line_no, message)
+
+
+def _error(source: str, line_no: int, message: str) -> _Issue:
+    return ("error", source, line_no, message)
+
+
+def _warning(source: str, line_no: int, message: str) -> _Issue:
+    return ("warning", source, line_no, message)
+
+
+# ---------------------------------------------------------------------------
+# Core lint implementation
+# ---------------------------------------------------------------------------
+
+
+def _lint_cmdlist(
+    cmdlist: CommandList,
+    script_dir: Path | None,
+    defined_vars: set[str],
+) -> list[_Issue]:
+    """Lint a single :class:`CommandList` and return any issues found.
+
+    Args:
+        cmdlist: The parsed command list to analyse.
+        script_dir: Directory of the top-level script file, used for resolving
+            relative INCLUDE paths.  ``None`` for inline (``-c``) scripts.
+        defined_vars: Mutable set of variable names (without sigil) that have
+            been defined by preceding ``SUB`` metacommands.  The caller passes
+            in the set from the outer scope so that variables defined before an
+            EXECUTE SCRIPT call are visible inside the script block when
+            analysing top-level scripts.  For named-script analysis the caller
+            passes a *copy* so that local definitions don't leak.
+
+    Returns:
+        List of ``(severity, source, line_no, message)`` issue tuples.
+    """
+    issues: list[_Issue] = []
+
+    if_depth = 0
+    if_open_locs: list[tuple[str, int]] = []  # (source, line_no) of unmatched IF
+
+    loop_depth = 0
+    loop_open_locs: list[tuple[str, int]] = []
+
+    batch_depth = 0
+    batch_open_locs: list[tuple[str, int]] = []
+
+    for cmd in cmdlist.cmdlist:
+        src = cmd.source
+        lno = cmd.line_no
+        stmt = cmd.command.statement if cmd.command_type == "sql" else cmd.command.statement
+
+        if cmd.command_type == "sql":
+            # SQL statements: check for variable references only
+            for m in _RX_VAR_REF.finditer(stmt):
+                _check_var_ref(m.group(1), src, lno, defined_vars, issues)
+            continue
+
+        # Metacommand checks
+        for m in _RX_VAR_REF.finditer(stmt):
+            _check_var_ref(m.group(1), src, lno, defined_vars, issues)
+
+        # -- IF block (opens a block requiring ENDIF) --
+        if _RX_IF_BLOCK.match(stmt) and not _RX_IF_INLINE.match(stmt):
+            if_depth += 1
+            if_open_locs.append((src, lno))
+
+        elif _RX_ENDIF.match(stmt):
+            if if_depth == 0:
+                issues.append(_error(src, lno, "ENDIF without a matching preceding IF"))
+            else:
+                if_depth -= 1
+                if_open_locs.pop()
+
+        elif _RX_ELSEIF.match(stmt) or _RX_ELSE.match(stmt) or _RX_ANDIF.match(stmt) or _RX_ORIF.match(stmt):
+            if if_depth == 0:
+                kw = stmt.strip().split(None, 1)[0].upper()
+                issues.append(_error(src, lno, f"{kw} without a matching preceding IF"))
+
+        # -- LOOP --
+        elif _RX_LOOP.match(stmt):
+            loop_depth += 1
+            loop_open_locs.append((src, lno))
+
+        elif _RX_END_LOOP.match(stmt):
+            if loop_depth == 0:
+                issues.append(_error(src, lno, "END LOOP without a matching preceding LOOP"))
+            else:
+                loop_depth -= 1
+                loop_open_locs.pop()
+
+        # -- BATCH --
+        elif _RX_BEGIN_BATCH.match(stmt):
+            batch_depth += 1
+            batch_open_locs.append((src, lno))
+
+        elif _RX_END_BATCH.match(stmt):
+            if batch_depth == 0:
+                issues.append(_error(src, lno, "END BATCH without a matching preceding BEGIN BATCH"))
+            else:
+                batch_depth -= 1
+                batch_open_locs.pop()
+
+        # -- SUB variable definition --
+        sub_m = _RX_SUB.match(stmt)
+        if sub_m:
+            varname = sub_m.group("name").lstrip("+~")
+            defined_vars.add(varname.upper())
+
+        # -- INCLUDE file existence --
+        inc_m = _RX_INCLUDE.match(stmt)
+        if inc_m:
+            raw_path = inc_m.group("path").strip().strip("\"'")
+            # Only check if no substitution variables are in the path
+            if not _RX_VAR_REF.search(raw_path):
+                _check_include_path(raw_path, script_dir, src, lno, stmt, issues)
+
+    # Report unclosed blocks at end of command list
+    for osrc, olno in if_open_locs:
+        issues.append(_error(osrc, olno, "IF without a matching ENDIF"))
+    for osrc, olno in loop_open_locs:
+        issues.append(_error(osrc, olno, "LOOP without a matching END LOOP"))
+    for osrc, olno in batch_open_locs:
+        issues.append(_error(osrc, olno, "BEGIN BATCH without a matching END BATCH"))
+
+    return issues
+
+
+def _check_var_ref(
+    raw_name: str,
+    source: str,
+    line_no: int,
+    defined_vars: set[str],
+    issues: list[_Issue],
+) -> None:
+    """Emit a warning if *raw_name* looks like an undefined user variable.
+
+    Built-in system variables, environment-variable references (``&``-prefix),
+    column variables (``@``-prefix), counter variables (``@@``), parameter
+    variables (``#``-prefix), and ``$ARG_N`` are excluded from the check.
+
+    Args:
+        raw_name: Variable name token as captured from ``!!name!!`` (with sigil).
+        source: Source file name for the issue location.
+        line_no: Line number of the command containing the reference.
+        defined_vars: Set of variable names (upper-case, no sigil) that have
+            been defined by preceding SUB metacommands.
+        issues: Issue list to append to.
+    """
+    if not raw_name:
+        return
+
+    sigil = raw_name[0] if raw_name[0] in ("$", "@", "&", "~", "#", "+") else ""
+    name = raw_name[len(sigil) :]
+
+    # Skip non-$ sigil prefixes — these are always resolved at runtime
+    if sigil in ("@", "&", "~", "#", "+"):
+        return
+
+    # $ARG_N is set via -a/--assign-arg at invocation time
+    if re.match(r"^ARG_\d+$", name, re.I):
+        return
+
+    # Built-in system variables
+    if name.upper() in _BUILTIN_VARS:
+        return
+
+    # User-defined via SUB
+    if name.upper() in defined_vars:
+        return
+
+    issues.append(
+        _warning(
+            source,
+            line_no,
+            f"Potentially undefined variable: !!{raw_name}!! "
+            "(not defined by a preceding SUB; may be set by a config file or -a arg)",
+        ),
+    )
+
+
+def _check_include_path(
+    raw_path: str,
+    script_dir: Path | None,
+    source: str,
+    line_no: int,
+    stmt: str,
+    issues: list[_Issue],
+) -> None:
+    """Warn if the INCLUDE target does not exist on disk.
+
+    Args:
+        raw_path: Unquoted file path string from the INCLUDE metacommand.
+        script_dir: Directory of the top-level script file; used for relative
+            path resolution.  ``None`` for inline scripts.
+        source: Source file name for issue location.
+        line_no: Line number of the INCLUDE command.
+        stmt: Full metacommand statement text (for the IF EXISTS variant).
+        issues: Issue list to append to.
+    """
+    # IF EXISTS variant — missing file is intentional; skip
+    if re.match(r"^\s*INCLUDE\s+IF\s+EXISTS?", stmt, re.I):
+        return
+
+    p = Path(raw_path)
+    if not p.is_absolute() and script_dir is not None:
+        p = script_dir / p
+
+    if not p.exists():
+        issues.append(
+            _warning(
+                source,
+                line_no,
+                f"INCLUDE target does not exist: {raw_path!r}",
+            ),
+        )
+
+
+def _lint_script(
+    cmdlist: CommandList | None,
+    script_path: str | None = None,
+) -> list[_Issue]:
+    """Perform static analysis on a parsed command list.
+
+    Walks every :class:`~execsql.script.ScriptCmd` in *cmdlist* and any named
+    scripts accumulated in ``_state.savedscripts`` (those defined with
+    ``BEGIN SCRIPT … END SCRIPT`` in the same source file).
+
+    Args:
+        cmdlist: The top-level :class:`~execsql.script.CommandList` returned by
+            ``read_sqlfile()`` / ``read_sqlstring()``.  If ``None`` or empty,
+            a single "empty script" warning is returned.
+        script_path: Absolute or relative path to the SQL script file.  Used
+            to resolve relative INCLUDE paths.  Pass ``None`` for inline
+            (``-c``) scripts.
+
+    Returns:
+        List of ``(severity, source, line_no, message)`` tuples, one per issue
+        found.  An empty list means the script is clean.
+    """
+    import execsql.state as _state
+
+    issues: list[_Issue] = []
+
+    if cmdlist is None or not cmdlist.cmdlist:
+        issues.append(_warning("<script>", 0, "Script is empty — no commands found"))
+        return issues
+
+    script_dir = Path(script_path).resolve().parent if script_path else None
+
+    # Shared set of variables defined in the top-level script via SUB.
+    # Named scripts get a fresh copy so their internal definitions don't bleed
+    # back into the top-level analysis.
+    top_defined: set[str] = set()
+
+    issues.extend(_lint_cmdlist(cmdlist, script_dir, top_defined))
+
+    # Analyse each named SCRIPT block collected during parsing
+    for script_name, saved_cl in getattr(_state, "savedscripts", {}).items():
+        saved_issues = _lint_cmdlist(saved_cl, script_dir, set(top_defined))
+        for sev, src, lno, msg in saved_issues:
+            # Annotate with the script name if the source is the same file
+            issues.append((sev, src, lno, f"[script '{script_name}'] {msg}"))
+
+    return issues
+
+
+# ---------------------------------------------------------------------------
+# Rich output helper
+# ---------------------------------------------------------------------------
+
+
+def _print_lint_results(issues: list[_Issue], script_label: str) -> int:
+    """Print lint issues to the console using Rich formatting.
+
+    Args:
+        issues: List of ``(severity, source, line_no, message)`` tuples.
+        script_label: Human-readable label for the script (file path or
+            ``<inline>``), shown in the summary line.
+
+    Returns:
+        ``1`` if any errors were found, ``0`` if only warnings or nothing.
+    """
+    from execsql.cli.help import _console
+
+    n_errors = sum(1 for sev, *_ in issues if sev == "error")
+    n_warnings = sum(1 for sev, *_ in issues if sev == "warning")
+
+    _console.print(f"\n[bold cyan]Lint:[/bold cyan] {script_label}")
+    _console.print()
+
+    if not issues:
+        _console.print("[bold green]No issues found.[/bold green]")
+        _console.print()
+        return 0
+
+    for severity, source, line_no, message in issues:
+        loc = f"{source}:{line_no}" if line_no else source
+        if severity == "error":
+            _console.print(f"  [bold red]ERROR  [/bold red]  [dim]{loc}[/dim]  {message}")
+        else:
+            _console.print(f"  [bold yellow]WARNING[/bold yellow]  [dim]{loc}[/dim]  {message}")
+
+    _console.print()
+    parts = []
+    if n_errors:
+        parts.append(f"[bold red]{n_errors} error{'s' if n_errors != 1 else ''}[/bold red]")
+    if n_warnings:
+        parts.append(f"[bold yellow]{n_warnings} warning{'s' if n_warnings != 1 else ''}[/bold yellow]")
+    _console.print("  " + ", ".join(parts))
+    _console.print()
+
+    return 1 if n_errors > 0 else 0

execsql/cli/run.py

@@ -20,11 +20,15 @@ from execsql.cli.dsn import _parse_connection_string
 from execsql.cli.help import _console, _err_console
 from execsql.config import ConfigData, StatObj
 from execsql.exceptions import ConfigError, ErrInfo
-from execsql.script import SubVarSet, current_script_line, read_sqlfile, read_sqlstring, runscripts
+from execsql.script import SubVarSet, current_script_line, read_sqlfile, read_sqlstring, runscripts, substitute_vars
 from execsql.utils.fileio import FileWriter, Logger, filewriter_end
 from execsql.utils.gui import gui_connect, gui_console_isrunning, gui_console_off, gui_console_on, gui_console_wait_user
 
-__all__ = ["_connect_initial_db", "_print_dry_run", "_run"]
+__all__ = ["_connect_initial_db", "_ping_db", "_print_dry_run", "_print_profile", "_run"]
+
+# Lint helper — imported lazily inside _run() to keep start-up cost low, but
+# re-exported here so that tests and callers can reach it via cli.run.
+from execsql.cli.lint import _lint_script, _print_lint_results  # noqa: F401 — re-export
 
 
 # ---------------------------------------------------------------------------
@@ -33,7 +37,16 @@ __all__ = ["_connect_initial_db", "_print_dry_run", "_run"]
 
 
 def _print_dry_run(cmdlist: object) -> None:
-    """Print the parsed command list for --dry-run mode."""
+    """Print the parsed command list for --dry-run mode.
+
+    Substitution variables (``$VAR``, ``&ENV``, ``@COUNTER``) that are already
+    populated — from environment variables, ``--assign-arg`` values, or config —
+    are expanded in the displayed text.  System variables that are set at
+    execution time (e.g. ``$CURRENT_TIME``, ``$DB_NAME``, ``$TIMER``) will
+    appear unexpanded because ``set_system_vars()`` has not yet been called.
+    Local ``~``-prefixed script-scope variables are also not expanded (no script
+    execution context exists in dry-run mode).
+    """
     if cmdlist is None or not cmdlist.cmdlist:
         _console.print("[yellow]No commands found in script.[/yellow]")
         return
@@ -43,7 +56,129 @@ def _print_dry_run(cmdlist: object) -> None:
     for i, cmd in enumerate(cmdlist.cmdlist, 1):
         ctype = "SQL    " if cmd.command_type == "sql" else "METACMD"
         source_info = f"[dim]{cmd.source}:{cmd.line_no}[/dim]"
-        _console.print(f"  [dim]{i:>4}[/dim]  [bold green]{ctype}[/bold green]  {source_info}  {cmd.commandline()}")
+        raw = cmd.commandline()
+        try:
+            expanded = substitute_vars(raw)
+        except Exception:
+            # Cycle detection or other expansion errors — fall back to raw text.
+            expanded = raw
+        _console.print(f"  [dim]{i:>4}[/dim]  [bold green]{ctype}[/bold green]  {source_info}  {expanded}")
+
+
+# ---------------------------------------------------------------------------
+# Profile report helper
+# ---------------------------------------------------------------------------
+
+
+def _print_profile(profile_data: list[tuple]) -> None:
+    """Print a per-statement timing summary to stdout.
+
+    Args:
+        profile_data: List of ``(source, line_no, command_type, elapsed_secs,
+            command_text_preview)`` tuples collected during execution.
+    """
+    if not profile_data:
+        _console.print("[dim]Profile: no statements recorded.[/dim]")
+        return
+
+    total_secs = sum(row[3] for row in profile_data)
+    n = len(profile_data)
+
+    # Sort descending by elapsed time; show top 20 (or all if <= 20).
+    sorted_data = sorted(profile_data, key=lambda r: r[3], reverse=True)
+    display = sorted_data[:20]
+
+    _console.print()
+    _console.print(f"[bold cyan]Profile:[/bold cyan] {n} statement{'s' if n != 1 else ''} in {total_secs:.3f}s")
+    _console.print()
+
+    header = f"  {'Time (s)':<10}  {'Pct':<7}  {'Source:Line':<20}  {'Type':<7}  Command"
+    sep = f"  {'-' * 10}  {'-' * 7}  {'-' * 20}  {'-' * 7}  {'-' * 40}"
+    _console.print(f"[dim]{header}[/dim]")
+    _console.print(f"[dim]{sep}[/dim]")
+
+    for source, line_no, command_type, elapsed, preview in display:
+        pct = (elapsed / total_secs * 100) if total_secs > 0 else 0.0
+        source_col = f"{source}:{line_no}"
+        if len(source_col) > 20:
+            source_col = "..." + source_col[-17:]
+        ctype_label = "SQL    " if command_type == "sql" else "METACMD"
+        preview_short = preview[:50].replace("\n", " ").strip()
+        if len(preview) > 50:
+            preview_short += "..."
+        _console.print(
+            f"  [yellow]{elapsed:<10.3f}[/yellow]  "
+            f"[dim]{pct:<6.1f}%[/dim]  "
+            f"[cyan]{source_col:<20}[/cyan]  "
+            f"[green]{ctype_label:<7}[/green]  "
+            f"{preview_short}",
+        )
+
+    if len(sorted_data) > 20:
+        omitted = len(sorted_data) - 20
+        _console.print(
+            f"[dim]  ... {omitted} more statement{'s' if omitted != 1 else ''} not shown (top 20 by time)[/dim]",
+        )
+
+    _console.print()
+
+
+# ---------------------------------------------------------------------------
+# --ping helper
+# ---------------------------------------------------------------------------
+
+
+def _ping_db(db) -> None:
+    """Test connectivity for *db*, print connection details, and exit.
+
+    Attempts to execute ``SELECT version()`` (or ``SELECT sqlite_version()``
+    for SQLite) to retrieve the server version string.  If the query fails the
+    connection is still reported as successful — only the version line is
+    omitted.  On success the function raises :class:`SystemExit` with code 0.
+
+    Args:
+        db: An open :class:`~execsql.db.base.Database` instance.
+    """
+    dbms_id: str = db.type.dbms_id if db.type else "unknown"
+
+    # Try to fetch a human-readable server version string.
+    version_str: str | None = None
+    _version_queries = [
+        "SELECT version()",
+        "SELECT sqlite_version()",
+        "SELECT @@VERSION",
+    ]
+    for sql in _version_queries:
+        try:
+            curs = db.cursor()
+            curs.execute(sql)
+            row = curs.fetchone()
+            curs.close()
+            if row and row[0]:
+                version_str = str(row[0]).split("\n")[0].strip()
+            break
+        except Exception:
+            continue
+
+    # Build the connection descriptor.
+    if db.server_name:
+        port_part = f":{db.port}" if db.port else ""
+        location = f"{db.server_name}{port_part}/{db.db_name or ''}"
+    else:
+        location = db.db_name or "<in-memory>"
+
+    if version_str:
+        _console.print(
+            f"[bold green]Connected[/bold green] to [bold]{dbms_id}[/bold] "
+            f"[dim]{version_str}[/dim] at [cyan]{location}[/cyan]",
+        )
+    else:
+        _console.print(
+            f"[bold green]Connected[/bold green] to [bold]{dbms_id}[/bold] at [cyan]{location}[/cyan]",
+        )
+
+    db.close()
+    raise SystemExit(0)
 
 
 # ---------------------------------------------------------------------------
@@ -76,6 +211,9 @@ def _run(
     dsn: str | None = None,
     output_dir: str | None = None,
     progress: bool = False,
+    profile: bool = False,
+    ping: bool = False,
+    lint: bool = False,
 ) -> None:
     """Initialise state, connect to the database, load the script, and run it.
 
@@ -83,6 +221,17 @@ def _run(
     without going through the Typer CLI layer. All parameters mirror the
     corresponding CLI options; see [Syntax & Options](../syntax.md) for
     descriptions.
+
+    When *ping* is ``True``, the function connects to the database, prints
+    connection details (DBMS name, server version, and location), and calls
+    :func:`_ping_db` which raises ``SystemExit(0)``.  No script is loaded or
+    executed.  *script_name* and *command* may both be ``None`` in ping mode.
+
+    When *lint* is ``True``, the script is parsed and statically analysed for
+    structural issues (unmatched IF/ENDIF/LOOP/BATCH blocks, potentially
+    undefined variables, missing INCLUDE files, empty scripts) without
+    connecting to a database or executing anything.  Exits with code 0 if no
+    errors were found, or code 1 if errors were found.
     """
     import execsql.state as _state
 
@@ -212,10 +361,10 @@ def _run(
     if progress:
         conf.show_progress = True
 
-    # Positional arguments after the script name (or all positionals in inline mode)
+    # Positional arguments after the script name (or all positionals in inline/ping mode)
     # off=1: script file occupies positional[0]; connection args start at [1]
-    # off=0: no script file; all positionals are connection args
-    off = 0 if command is not None else 1
+    # off=0: no script file; all positionals are connection args (inline -c or --ping)
+    off = 0 if (command is not None or ping) else 1
     if len(positional) == off + 1:
         if conf.db_type in ("a", "l", "k"):
             conf.db_file = positional[off]
@@ -329,12 +478,13 @@ def _run(
             )
 
     # ------------------------------------------------------------------
-    # Load the SQL script
+    # Load the SQL script (skipped in --ping and --dry-run with no script)
     # ------------------------------------------------------------------
-    if command is not None:
-        read_sqlstring(command.replace("\\n", "\n").replace("\\t", "\t"), "<inline>")
-    else:
-        read_sqlfile(script_name)
+    if not ping:
+        if command is not None:
+            read_sqlstring(command.replace("\\n", "\n").replace("\\t", "\t"), "<inline>")
+        else:
+            read_sqlfile(script_name)
 
     # ------------------------------------------------------------------
     # Dry-run: print command list and exit without connecting to DB
@@ -343,6 +493,16 @@ def _run(
         _print_dry_run(_state.commandliststack[-1] if _state.commandliststack else None)
         raise SystemExit(0)
 
+    # ------------------------------------------------------------------
+    # Lint: static analysis without connecting to DB
+    # ------------------------------------------------------------------
+    if lint:
+        cmdlist = _state.commandliststack[-1] if _state.commandliststack else None
+        issues = _lint_script(cmdlist, script_name)
+        label = script_name or "<inline>"
+        exit_code = _print_lint_results(issues, label)
+        raise SystemExit(exit_code)
+
     # ------------------------------------------------------------------
     # Start GUI console if requested
     # ------------------------------------------------------------------
@@ -372,13 +532,22 @@ def _run(
     _state.subvars.add_substitution("$DB_SERVER", db.server_name)
     _state.subvars.add_substitution("$SYSTEM_CMD_EXIT_STATUS", "0")
 
+    # ------------------------------------------------------------------
+    # --ping: report connection details and exit (no script executed)
+    # ------------------------------------------------------------------
+    if ping:
+        _ping_db(db)  # raises SystemExit(0) on success
+
     # ------------------------------------------------------------------
     # Execute the script
     # ------------------------------------------------------------------
     atexit.register(_state.dbs.closeall)
     _state.dbs.do_rollback = True
 
-    _execute_script_direct(conf)
+    if profile:
+        _state.profile_data = []
+
+    _execute_script_direct(conf, profile=profile)
 
 
 # ---------------------------------------------------------------------------
@@ -437,8 +606,15 @@ def _execute_script_textual_console(conf: ConfigData) -> None:
     _state.exec_log.log_exit_end()
 
 
-def _execute_script_direct(conf: ConfigData) -> None:
-    """Run runscripts() in the current (main) thread — used when Textual is not active."""
+def _execute_script_direct(conf: ConfigData, *, profile: bool = False) -> None:
+    """Run runscripts() in the current (main) thread — used when Textual is not active.
+
+    Args:
+        conf: The active configuration object.
+        profile: When ``True``, print a per-statement timing summary after the
+            script completes.  Timing data must already have been activated on
+            ``_state.profile_data`` before this function is called.
+    """
     import execsql.state as _state
     import execsql.utils.gui as _gui
 
@@ -463,6 +639,8 @@ def _execute_script_direct(conf: ConfigData) -> None:
             if gui_console_isrunning():
                 gui_console_off()
         _state.exec_log.log_status_info(f"{_state.cmds_run} commands run")
+        if profile and _state.profile_data is not None:
+            _print_profile(_state.profile_data)
         sys.exit(exc.code)
     except ConfigError:
         raise
@@ -489,6 +667,8 @@ def _execute_script_direct(conf: ConfigData) -> None:
         if gui_console_isrunning():
             gui_console_off()
     _state.exec_log.log_status_info(f"{_state.cmds_run} commands run")
+    if profile and _state.profile_data is not None:
+        _print_profile(_state.profile_data)
     _state.exec_log.log_exit_end()
 
 

execsql/metacommands/__init__.py

@@ -36,6 +36,7 @@ from execsql.metacommands.connect import (
     x_daoflushdelay,
 )
 from execsql.metacommands.control import (
+    x_assert,
     x_if,
     x_if_orif,
     x_if_andif,
@@ -238,6 +239,7 @@ __all__ = [
     "x_pg_vacuum",
     "x_daoflushdelay",
     # control handlers
+    "x_assert",
     "x_if",
     "x_if_orif",
     "x_if_andif",

execsql/metacommands/control.py

@@ -34,6 +34,39 @@ from execsql.utils.fileio import EncodedFile, check_dir
 from execsql.utils.gui import GUI_HALT, GuiSpec, enable_gui, gui_console_isrunning
 
 
+def x_assert(**kwargs: Any) -> None:
+    """Evaluate a condition and raise ErrInfo if it is false.
+
+    Syntax::
+
+        -- !x! ASSERT <condition> ["message"]
+        -- !x! ASSERT <condition> ['message']
+        -- !x! ASSERT <condition>
+
+    Args:
+        **kwargs: Keyword arguments injected by the dispatch table.
+            ``condtest`` — the condition expression string.
+            ``message``  — optional user-supplied failure message; may be None.
+
+    Raises:
+        ErrInfo: When the condition evaluates to False (or raises internally
+            for an unrecognized condition).
+    """
+    condition: str = kwargs["condtest"].strip()
+    raw_message: str | None = kwargs.get("message")
+    if raw_message:
+        # Strip surrounding quotes that the regex captured
+        message: str = raw_message.strip("'\"")
+    else:
+        message = f"Assertion failed: {condition}"
+
+    result = _state.xcmd_test(condition)
+    if result:
+        _state.exec_log.log_user_msg(f"ASSERT passed: {condition}")
+    else:
+        raise ErrInfo(type="cmd", other_msg=message)
+
+
 def x_if(**kwargs: Any) -> None:
     tf_value = _state.xcmd_test(kwargs["condtest"])
     if tf_value:

execsql/metacommands/dispatch.py

@@ -36,6 +36,7 @@ from execsql.metacommands.connect import (
     x_use,
 )
 from execsql.metacommands.control import (
+    x_assert,
     x_begin_batch,
     x_break,
     x_end_batch,
@@ -1659,6 +1660,36 @@ def build_dispatch_table() -> MetaCommandList:
         category="action",
     )
 
+    # ------------------------------------------------------------------
+    # ASSERT
+    # ------------------------------------------------------------------
+    # Two registrations; MetaCommandList.add() prepends, so register the
+    # broader (no-message) pattern first and the more specific (with-message)
+    # pattern second — the second registration wins because it is prepended
+    # last and therefore tried first during dispatch.
+    #
+    # with-message: the trailing quoted token is captured as `message`;
+    #   everything between ASSERT and the message becomes `condtest`.
+    #   This handles conditions that themselves contain quoted strings, e.g.:
+    #     ASSERT $VAR = 'expected' 'wrong value'
+    #   The non-greedy (.+?) stops before the LAST quoted token on the line.
+    #
+    # no-message: full remainder after ASSERT goes into `condtest`.
+    mcl.add(
+        r"^\s*ASSERT\s+(?P<condtest>.+?)\s*$",
+        x_assert,
+        description="ASSERT",
+        category="action",
+        run_when_false=False,
+    )
+    mcl.add(
+        r"^\s*ASSERT\s+(?P<condtest>.+?)\s+(?P<message>(?:\"[^\"]*\"|'[^']*'))\s*$",
+        x_assert,
+        description="ASSERT",
+        category="action",
+        run_when_false=False,
+    )
+
     # ------------------------------------------------------------------
     # IF / ORIF / ANDIF / ELSEIF / ELSE / ENDIF
     # ------------------------------------------------------------------

execsql/script/engine.py

@@ -489,7 +489,23 @@ class CommandList:
             _state.subvars.add_substitution("$CURRENT_SCRIPT_NAME", Path(cmditem.source).name)
             _state.subvars.add_substitution("$CURRENT_SCRIPT_LINE", str(cmditem.line_no))
             _state.subvars.add_substitution("$SCRIPT_LINE", str(cmditem.line_no))
+            _profiling = _state.profile_data is not None
+            if _profiling:
+                import time as _time
+
+                _t0 = _time.perf_counter()
             cmditem.command.run(self.localvars.merge(self.paramvals), not _state.status.batch.in_batch())
+            if _profiling:
+                _elapsed = _time.perf_counter() - _t0
+                _state.profile_data.append(
+                    (
+                        cmditem.source,
+                        cmditem.line_no,
+                        cmditem.command_type,
+                        _elapsed,
+                        cmditem.command.commandline()[:100],
+                    ),
+                )
         self.cmdptr += 1
 
     def run_next(self) -> None:

execsql/state.py

@@ -94,6 +94,8 @@ __all__ = [
     "gui_console",
     "gui_manager_queue",
     "gui_manager_thread",
+    # Profiling
+    "profile_data",
     # Version
     "primary_vno",
     "secondary_vno",
@@ -191,6 +193,8 @@ _CONTEXT_ATTRS: frozenset[str] = frozenset(
         "gui_console",
         "gui_manager_queue",
         "gui_manager_thread",
+        # Profiling
+        "profile_data",
     },
 )
 
@@ -242,6 +246,8 @@ class RuntimeContext:
         "gui_console",
         "gui_manager_queue",
         "gui_manager_thread",
+        # Profiling
+        "profile_data",
     )
 
     def __init__(self) -> None:
@@ -289,6 +295,10 @@ class RuntimeContext:
         self.gui_manager_queue: _mp.Queue | None = None
         self.gui_manager_thread: _threading.Thread | None = None
 
+        # Profiling — None means profiling is disabled; a list means it is enabled.
+        # Each entry: (source, line_no, command_type, elapsed_secs, command_text_preview)
+        self.profile_data: list[tuple] | None = None
+
 
 # ---------------------------------------------------------------------------
 # Module proxy — transparently delegates context attr access to _ctx

{execsql2-2.7.1.dist-info → execsql2-2.9.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execsql2
-Version: 2.7.1
+Version: 2.9.0
 Summary: Runs a SQL script against a PostgreSQL, SQLite, MariaDB/MySQL, DuckDB, Firebird, MS-Access, MS-SQL-Server, or Oracle database, or an ODBC DSN. Provides metacommands to import and export data, copy data between databases, conditionally execute SQL and metacommands, and dynamically alter SQL and metacommands with substitution variables.
 Project-URL: Repository, https://github.com/geocoug/execsql
 Project-URL: Issues, https://github.com/geocoug/execsql/issues
@@ -221,6 +221,7 @@ execsql script.sql                          # read connection from config file
 | `-w`                                | Skip password prompt when a username is supplied                |
 | `--dsn URL`                         | Connection string (e.g. `postgresql://user:pass@host/db`)       |
 | `--dry-run`                         | Parse the script and report commands without executing          |
+| `--lint`                            | Static analysis: check structure and warn on issues (no DB)     |
 | `--progress`                        | Show a progress bar for long-running IMPORT operations          |
 | `--dump-keywords`                   | Print metacommand keywords as JSON and exit                     |
 | `--gui-framework {tkinter,textual}` | GUI framework for interactive prompts                           |
@@ -233,6 +234,7 @@ Run `execsql --help` for the full option list, or `execsql -m` to list all metac
 - Export query results in 20+ formats including CSV, TSV, JSON, YAML, XML, HTML, Markdown, LaTeX, XLSX, OpenDocument, Feather, Parquet, HDF5, DuckDB, SQLite, plain text, and Jinja2 templates.
 - Copy data between databases, including across different DBMS types.
 - Conditionally execute SQL and metacommands using `IF`/`ELSE`/`ENDIF` based on data values, DBMS type, or user input.
+- Validate data with `ASSERT` — halt the script with a clear error message if a condition is false (ideal for CI pipelines).
 - Loop over blocks of SQL and metacommands using `LOOP`/`ENDLOOP`.
 - Use substitution variables (`SUB`, `$ARG_x`, built-in variables like `$date_tag`) to parameterize scripts.
 - Include or chain scripts with `INCLUDE` and `SCRIPT`.

{execsql2-2.7.1.dist-info → execsql2-2.9.0.dist-info}/RECORD

@@ -7,12 +7,13 @@ execsql/format.py,sha256=-6iknDddqbkapMo4NKmT5LAynDLqMW5kHgDWRg0KSws,11990
 execsql/models.py,sha256=DxkGp9iWbuZDWPGmnxZp9mvEeyOwxEJNx94fxQQiLfQ,13538
 execsql/parser.py,sha256=mbNSMiAMR1NvNvFtQAZq6nxBOupMGJZXSimLWLtZeNs,15537
 execsql/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-execsql/state.py,sha256=Kg_cMr0DDEjFkEQ02BKO2xxeH7N03aBRj8UjvzQK-C0,14445
+execsql/state.py,sha256=BodGWiLD7I3s7LFd8Mb6SHMp3I1BhVE4rYcR0UZWAoM,14799
 execsql/types.py,sha256=HVWb4umIB9lpxCGgqk3xy1hoGYPfN39xci5mHF0Izq4,31882
-execsql/cli/__init__.py,sha256=s4283f04Z-SS5CdwsJj6t_oHuyL5sQELsUGTh6x45NU,14908
+execsql/cli/__init__.py,sha256=Y4lFKvKWyjtMgSLsmACHYG33DFpeAQxddIVrlKURwpg,16081
 execsql/cli/dsn.py,sha256=svaZtrUXFRL2W5G6FRRiKtR6kehOp7urrVhIx_642Z8,2820
 execsql/cli/help.py,sha256=Sn_TgSJiQeBx-xZH0fuP5OvR_wasSTumjWF9UHfIX5k,5414
-execsql/cli/run.py,sha256=seThMuXV0BmpG94lzOteoxlSjez-p-Ht4__5jjsJZAI,22829
+execsql/cli/lint.py,sha256=KluYROdjGJNUrVbO3cJym-H296zbih4no-F10HF0P4U,16165
+execsql/cli/run.py,sha256=i0ip8tm21Sm4EFbfBdcekETmiABzrRfeP84SqA4IF68,30158
 execsql/db/__init__.py,sha256=jTbuafuKOqYtXFR1wvCOoKK5Lr3l1uErfaIbIr6UywI,1063
 execsql/db/access.py,sha256=L79gUnAnnM9EJ_f4k42jr7DI0qGcKtLOnJTlBC7uPm0,17879
 execsql/db/base.py,sha256=hfMFj8fXY0T1aXLvWJHqb0aU4EQUDFOc-YrS29HH8U4,30405
@@ -58,13 +59,13 @@ execsql/importers/csv.py,sha256=Mu848WNzuhVO1ade-WurPyxqGOuVNRO8UwRF3-bav_I,4845
 execsql/importers/feather.py,sha256=g2B69d2uv9vmnXcmjFyTVsMP40LYEzFYkhk3gD26mGw,1900
 execsql/importers/ods.py,sha256=MJsdsjropzCvxAA3DDZfAL_AnmZ4yij7DnrjGyDJqHQ,2843
 execsql/importers/xls.py,sha256=e0Zfe47ZiCpA1Ae3XDJ1ko3sCiH3-8U6XLKi6NvD0jQ,3683
-execsql/metacommands/__init__.py,sha256=zYRUuCnU-e-HbPdp_zCgQIriR_YgRqHkais45Eo3FNk,11082
+execsql/metacommands/__init__.py,sha256=ejuY2GFHxNh5f_Yp_GOV0EBe2vuUcly0-zBrKiR3qes,11112
 execsql/metacommands/conditions.py,sha256=u-XdeIWj9QMht9hRGhvH0XlB9V09AliAPKDBHRXc02s,24540
 execsql/metacommands/connect.py,sha256=Nsm0D91i3RX-R2rzQQ-Br-gULaI6Uvdn9fqb7DOAVfE,14804
-execsql/metacommands/control.py,sha256=FCIWD-ZivHRZDqMS-2k37iR05HKHsv_7UPh5zJAg4I4,7693
+execsql/metacommands/control.py,sha256=CBCg0ZKSR-BGejBW5cXwk6aJ9VrYBzCg9C40ofi8qi8,8776
 execsql/metacommands/data.py,sha256=tRQBGTAuW-eJ2tBNWaoZI9OjTyNNyHJISo7gOdL-sm8,11370
 execsql/metacommands/debug.py,sha256=nmfQ2ijUbTQO3drnyV9EzFueGSTfMl-CddP_NlQyI14,8178
-execsql/metacommands/dispatch.py,sha256=aZq4QFY3AjqbplCr2iSoD13ayvT34wWns63a15a_JRM,82407
+execsql/metacommands/dispatch.py,sha256=I6HoBKMofRalL1Cmdsnj1jQFZSFXCgntTofFaIZWgWQ,83670
 execsql/metacommands/io.py,sha256=Duh60caM4go9JczbGYNMKKYpcMimwPzF6EQ_tshKxdE,2971
 execsql/metacommands/io_export.py,sha256=7lkCSnPhXy9FVau9_hT1u68NOVdG2DsWmvUh9hM1QWI,18359
 execsql/metacommands/io_fileops.py,sha256=RKqbWPTYiwiqCZYG-lpih0w1JVOY4RBFdWr3BJb_pnY,9669
@@ -75,7 +76,7 @@ execsql/metacommands/script_ext.py,sha256=TUgAldB2LSJAwZrCvDDi804hQ1d9BDQD2GDqHN
 execsql/metacommands/system.py,sha256=sUR5kLL7idTVg8WXIMdd-Kv7nkERIiaeL0beWsz8NyY,7293
 execsql/script/__init__.py,sha256=pIo0EJ7-vg67rSMbOvbri_BOUgLoGoSEUfJgxUN7ZS0,3380
 execsql/script/control.py,sha256=s-1eZdGARM6H1FwZ6VDdO_f50j7bvvRtTHesfUm9tbc,6144
-execsql/script/engine.py,sha256=5WOuSbQR1vrp_SawylshzLmdHco2oEjqZBSoxRg0Ggo,39638
+execsql/script/engine.py,sha256=d3iUGF_r4OQAlqKpd8pIuWGAjDlYvzYiKqi-2Ew1-Yo,40213
 execsql/script/variables.py,sha256=MOT9XEHucpuuuHQZM5bklxGMBQcwHzwTBxd0q3aO0XY,11641
 execsql/utils/__init__.py,sha256=0uR6JwVJQRX3vceByNBduCAf5dd5assKjeqJUWvpZoA,278
 execsql/utils/auth.py,sha256=onXzNkNZQZxGC5w7eey06sjvAIAX_Lf9g7nUJtcsel0,7009
@@ -89,24 +90,24 @@ execsql/utils/numeric.py,sha256=xh02ANSRk3nUpQ-rtm66ILoMqoi7HtzCoRMIOT9U8QI,1570
 execsql/utils/regex.py,sha256=diEzTZqU_HHwVMadPAvN1Vgzhl7I03eVaEFGCXyGGL8,3770
 execsql/utils/strings.py,sha256=5Dvzrk-9SIw2lpxXZQkiJbNyo1sy7iXXAtSULlZ0KG8,8488
 execsql/utils/timer.py,sha256=eDYf5VzCNFk7oo90InJucUm3XcBdhYMogjZMqeg9xzc,1899
-execsql2-2.7.1.data/data/execsql2_extras/README.md,sha256=sxwVyU0ZahCfANv56LahkyuM505kFjrMhe-1SvWE69E,4845
-execsql2-2.7.1.data/data/execsql2_extras/config_settings.sqlite,sha256=aY5cxR7Q7J6zJ4bC9lu5mHUrhy211Cq3MNKPQVCt02E,20480
-execsql2-2.7.1.data/data/execsql2_extras/example_config_prompt.sql,sha256=SY3Jxn1qcVm4kPW9xmmTfknHfvURXmeEYTbRjYrjGSw,7487
-execsql2-2.7.1.data/data/execsql2_extras/execsql.conf,sha256=_45iJ-KWZnB8uMW_gEg067MM5pmGJ-dVl7VbAZMunAE,9530
-execsql2-2.7.1.data/data/execsql2_extras/make_config_db.sql,sha256=WwyC6dK-Eh5CAVppiBCDHqiI1_wEI9U95Ytpr4lsZkg,8726
-execsql2-2.7.1.data/data/execsql2_extras/md_compare.sql,sha256=B8Wd7LZ0vnMY2qvA139JIEBkPObgRH2i5xj6PejTQt8,24092
-execsql2-2.7.1.data/data/execsql2_extras/md_glossary.sql,sha256=DJRHcU5NbFpxTTX-IwH3yRlsboj1q6BBGrUAHKn4Cuo,10796
-execsql2-2.7.1.data/data/execsql2_extras/md_upsert.sql,sha256=v_7GbWh_N1mBTmw3gvTrkagOVp2q0KmXvM8hE-DlFxY,112524
-execsql2-2.7.1.data/data/execsql2_extras/pg_compare.sql,sha256=9dWa8hnfy5dVJI-z2iGpd9JzQmI4j2ziMlEdpnr66ro,24352
-execsql2-2.7.1.data/data/execsql2_extras/pg_glossary.sql,sha256=pKjIIDsROAgJq2H-1qNEcRMAWManivcZ_AEVHzUUlic,9908
-execsql2-2.7.1.data/data/execsql2_extras/pg_upsert.sql,sha256=k7AFiGTLBy3nf-qO5QIaZrEYTAKvdxxU3JDLx9jqkzs,108315
-execsql2-2.7.1.data/data/execsql2_extras/script_template.sql,sha256=1Estacb_vm1FgK41k_G9nuduP1yiA-fQ1Kn4Z4mv5Ao,11153
-execsql2-2.7.1.data/data/execsql2_extras/ss_compare.sql,sha256=TsVxWm3cEpR5-EiMYXNhtaY0arSNeKZhsJdHdLA7xeI,24833
-execsql2-2.7.1.data/data/execsql2_extras/ss_glossary.sql,sha256=cLM7nN8JOIu9ZVP9oY9qdSK3hrnWJiDcX6nZmQQbQWI,13065
-execsql2-2.7.1.data/data/execsql2_extras/ss_upsert.sql,sha256=BCqmBykXBF-BpCgOFeG1qhf2XfScKsxPD17wd1hYfHw,120647
-execsql2-2.7.1.dist-info/METADATA,sha256=UEW6Lpayq5sSHyOOrXXz0SvdAw0MzuoEbRQQ1Chr2VI,16722
-execsql2-2.7.1.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
-execsql2-2.7.1.dist-info/entry_points.txt,sha256=sUOxkM-dN1eBGGpSpDLsAaE0yNXYQKWZAfxPOlMkQyk,90
-execsql2-2.7.1.dist-info/licenses/LICENSE.txt,sha256=LBdhuxejF8_bLCHZ2kWfmDXpDGUu914Gbd6_3JjCRe0,676
-execsql2-2.7.1.dist-info/licenses/NOTICE,sha256=sqVrM73Ys9zfvWC_P797lHfTnoPW_ETeBSrUTFaob0A,339
-execsql2-2.7.1.dist-info/RECORD,,
+execsql2-2.9.0.data/data/execsql2_extras/README.md,sha256=sxwVyU0ZahCfANv56LahkyuM505kFjrMhe-1SvWE69E,4845
+execsql2-2.9.0.data/data/execsql2_extras/config_settings.sqlite,sha256=aY5cxR7Q7J6zJ4bC9lu5mHUrhy211Cq3MNKPQVCt02E,20480
+execsql2-2.9.0.data/data/execsql2_extras/example_config_prompt.sql,sha256=SY3Jxn1qcVm4kPW9xmmTfknHfvURXmeEYTbRjYrjGSw,7487
+execsql2-2.9.0.data/data/execsql2_extras/execsql.conf,sha256=_45iJ-KWZnB8uMW_gEg067MM5pmGJ-dVl7VbAZMunAE,9530
+execsql2-2.9.0.data/data/execsql2_extras/make_config_db.sql,sha256=WwyC6dK-Eh5CAVppiBCDHqiI1_wEI9U95Ytpr4lsZkg,8726
+execsql2-2.9.0.data/data/execsql2_extras/md_compare.sql,sha256=B8Wd7LZ0vnMY2qvA139JIEBkPObgRH2i5xj6PejTQt8,24092
+execsql2-2.9.0.data/data/execsql2_extras/md_glossary.sql,sha256=DJRHcU5NbFpxTTX-IwH3yRlsboj1q6BBGrUAHKn4Cuo,10796
+execsql2-2.9.0.data/data/execsql2_extras/md_upsert.sql,sha256=v_7GbWh_N1mBTmw3gvTrkagOVp2q0KmXvM8hE-DlFxY,112524
+execsql2-2.9.0.data/data/execsql2_extras/pg_compare.sql,sha256=9dWa8hnfy5dVJI-z2iGpd9JzQmI4j2ziMlEdpnr66ro,24352
+execsql2-2.9.0.data/data/execsql2_extras/pg_glossary.sql,sha256=pKjIIDsROAgJq2H-1qNEcRMAWManivcZ_AEVHzUUlic,9908
+execsql2-2.9.0.data/data/execsql2_extras/pg_upsert.sql,sha256=k7AFiGTLBy3nf-qO5QIaZrEYTAKvdxxU3JDLx9jqkzs,108315
+execsql2-2.9.0.data/data/execsql2_extras/script_template.sql,sha256=1Estacb_vm1FgK41k_G9nuduP1yiA-fQ1Kn4Z4mv5Ao,11153
+execsql2-2.9.0.data/data/execsql2_extras/ss_compare.sql,sha256=TsVxWm3cEpR5-EiMYXNhtaY0arSNeKZhsJdHdLA7xeI,24833
+execsql2-2.9.0.data/data/execsql2_extras/ss_glossary.sql,sha256=cLM7nN8JOIu9ZVP9oY9qdSK3hrnWJiDcX6nZmQQbQWI,13065
+execsql2-2.9.0.data/data/execsql2_extras/ss_upsert.sql,sha256=BCqmBykXBF-BpCgOFeG1qhf2XfScKsxPD17wd1hYfHw,120647
+execsql2-2.9.0.dist-info/METADATA,sha256=9IJPnmBiSv11eTc7x9Xswfv0KiAwzwizxJX_umIXaSo,16955
+execsql2-2.9.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+execsql2-2.9.0.dist-info/entry_points.txt,sha256=sUOxkM-dN1eBGGpSpDLsAaE0yNXYQKWZAfxPOlMkQyk,90
+execsql2-2.9.0.dist-info/licenses/LICENSE.txt,sha256=LBdhuxejF8_bLCHZ2kWfmDXpDGUu914Gbd6_3JjCRe0,676
+execsql2-2.9.0.dist-info/licenses/NOTICE,sha256=sqVrM73Ys9zfvWC_P797lHfTnoPW_ETeBSrUTFaob0A,339
+execsql2-2.9.0.dist-info/RECORD,,