execsql2 2.19.2__py3-none-any.whl → 2.20.0__py3-none-any.whl

execsql/cli/run.py

@@ -206,9 +206,29 @@ def _ping_db(db: Any) -> None:
 # ---------------------------------------------------------------------------
 
 
-# B12/F014: shared sensitive-name filter used by env-var seeding, -a
-# value logging, and any future credential-redaction sites.
-_SENSITIVE_SUBSTRINGS = ("SECRET", "TOKEN", "PASSWORD", "PASSWD", "PRIVATE_KEY", "CREDENTIAL")
+# B12/F014: shared sensitive-name filter for env-var seeding and any
+# other name-based credential-redaction sites. Case-insensitive substring
+# matches: an env var whose name (uppercased) contains any of these is
+# not seeded into the substitution pool. "_KEY" uses a leading underscore
+# so it catches AWS_ACCESS_KEY_ID / SECRET_KEY without also blocking
+# KEYBOARD-style names. Substring matching catches the common service-
+# prefixed forms (STRIPE_KEY, OPENAI_API_KEY, SENTRY_DSN, SLACK_WEBHOOK);
+# GitHub PAT-suffixed names (GITHUB_PAT) and URL-encoded DSNs
+# (DATABASE_URL) are documented gaps — use a TOKEN- or SECRET-prefixed
+# name when storing those.
+_SENSITIVE_SUBSTRINGS = (
+    "SECRET",
+    "TOKEN",
+    "PASSWORD",
+    "PASSWD",
+    "PRIVATE_KEY",
+    "CREDENTIAL",
+    "_KEY",
+    "APIKEY",
+    "API_KEY",
+    "DSN",
+    "WEBHOOK",
+)
 
 
 def _seed_early_subvars() -> SubVarSet:
@@ -517,15 +537,12 @@ def _setup_logging(
         for n, repl in enumerate(sub_vars):
             var = f"$ARG_{n + 1}"
             subvars.add_substitution(var, repl)
-            # B12/F014: -a values are user input that may contain
-            # secrets. Redact the value in the log line when the
-            # surrounding -a payload looks sensitive (matches the
-            # existing env-var filter at _seed_early_subvars).
-            display_repl = repl
-            if any(s in str(repl).upper() for s in _SENSITIVE_SUBSTRINGS):
-                display_repl = "***"
+            # `-a` values are positional and opaque (no name to denylist
+            # against). High-entropy secrets (sk-live-*, AKIA*, ghp_*,
+            # JWTs) pass any substring/value heuristic, so log the
+            # assignment confirmation without the value.
             logger.log_status_info(
-                f"Command-line substitution variable assignment: {var} set to {{{display_repl}}}",
+                f"Command-line substitution variable assignment: {var} set to {{***}}",
             )
 
     return logger

execsql/db/access.py

@@ -107,7 +107,11 @@ class AccessDatabase(Database):
                 else:
                     connstr = cs % db_name
                 try:
-                    self.conn = pyodbc.connect(connstr)
+                    # Access is file-based but a UNC path on an
+                    # unreachable share can still block forever; cap
+                    # the connect attempt at 30 s to match the other
+                    # adapters.
+                    self.conn = pyodbc.connect(connstr, timeout=30)
                 except Exception:
                     if _state.exec_log is not None:
                         _state.exec_log.log_status_info(

execsql/db/base.py

@@ -239,8 +239,14 @@ class Database(ABC):
         if self.conn:
             try:
                 self.conn.rollback()
-            except Exception:
-                pass  # Best-effort; connection may already be closed.
+            except Exception as e:
+                # Best-effort; connection may already be closed. Still
+                # log so a cascading rollback failure isn't invisible
+                # in a CI / cron log.
+                if _state.exec_log is not None:
+                    _state.exec_log.log_status_info(
+                        f"Rollback failed on {self.__class__.__name__}: {e!r}",
+                    )
 
     def needs_explicit_commit_after_ddl(self) -> bool:
         """Return True if this adapter's driver does NOT auto-commit DDL.

execsql/db/dsn.py

@@ -90,7 +90,9 @@ class DsnDatabase(Database):
                 parts.append(f"PWD={_odbc_quote(self.password)}")
             connstr = ";".join(parts) + ";"
             kwargs = {"autocommit": autocommit} if autocommit else {}
-            self.conn = pyodbc.connect(connstr, **kwargs)
+            # 30 s connect timeout matches the Postgres adapter default
+            # so a wedged DSN peer cannot hang a script indefinitely.
+            self.conn = pyodbc.connect(connstr, timeout=30, **kwargs)
 
         def _try_connect():
             try:

execsql/db/firebird.py

@@ -18,7 +18,7 @@ __all__ = ["FirebirdDatabase"]
 
 
 class FirebirdDatabase(Database):
-    """Firebird adapter using the firebird-driver (fdb) package."""
+    """Firebird adapter using the firebird-driver package."""
 
     def __init__(
         self,
@@ -31,10 +31,11 @@ class FirebirdDatabase(Database):
         password: str | None = None,
     ) -> None:
         try:
-            import fdb as firebird_lib  # noqa: F401
+            from firebird import driver as firebird_lib  # noqa: F401
         except Exception:
             fatal_error(
-                "The fdb module is required to connect to Firebird.   See https://pypi.python.org/pypi/fdb/",
+                "The firebird-driver module is required to connect to Firebird.   "
+                "See https://pypi.org/project/firebird-driver/",
             )
         from execsql.types import dbt_firebird
 
@@ -67,7 +68,10 @@ class FirebirdDatabase(Database):
 
     def open_db(self) -> None:
         """Open a connection to the Firebird database."""
-        import fdb as firebird_lib
+        from firebird import driver as firebird_lib
+
+        # 30 s connect timeout matches the Postgres adapter default.
+        connect_timeout = 30
 
         def db_conn():
             if self.user and self.password:
@@ -78,6 +82,7 @@ class FirebirdDatabase(Database):
                     user=self.user,
                     password=self.password,
                     charset=self.encoding,
+                    timeout=connect_timeout,
                 )
             else:
                 return firebird_lib.connect(
@@ -85,6 +90,7 @@ class FirebirdDatabase(Database):
                     database=self.db_name,
                     port=self.port,
                     charset=self.encoding,
+                    timeout=connect_timeout,
                 )
 
         if self.conn is None:

execsql/db/mysql.py

@@ -152,6 +152,10 @@ class MySQLDatabase(Database):
         """Open a connection to the MySQL or MariaDB server."""
         import pymysql as mysql_lib
 
+        # 30 s default matches the Postgres adapter so a wedged peer
+        # can't hang a script indefinitely.
+        connect_timeout = 30
+
         def db_conn():
             if self.user and self.password:
                 return mysql_lib.connect(
@@ -162,6 +166,7 @@ class MySQLDatabase(Database):
                     password=self.password,
                     charset=self.encoding,
                     local_infile=True,
+                    connect_timeout=connect_timeout,
                 )
             else:
                 return mysql_lib.connect(
@@ -170,6 +175,7 @@ class MySQLDatabase(Database):
                     port=self.port,
                     charset=self.encoding,
                     local_infile=True,
+                    connect_timeout=connect_timeout,
                 )
 
         if self.conn is None:

execsql/db/sqlserver.py

@@ -113,7 +113,10 @@ class SqlServerDatabase(Database):
                             f"DATABASE={self.db_name};Trusted_Connection=yes"
                         )
                     try:
-                        self.conn = pyodbc.connect(connstr)
+                        # 30 s connect timeout matches the Postgres adapter
+                        # default; pyodbc treats `timeout` as the login-and-
+                        # query timeout on the connection.
+                        self.conn = pyodbc.connect(connstr, timeout=30)
                     except Exception:
                         if _state.exec_log is not None:
                             _state.exec_log.log_status_info(

execsql/format.py

@@ -45,6 +45,13 @@ METACOMMAND_RE = re.compile(r"^\s*--\s*!x!\s*(.*)", re.IGNORECASE)
 
 # Multi-word keywords — checked longest-first before single-word fallback.
 # Order matters: more-specific variants must precede their prefixes.
+# Only entries that appear at the *start* of a `-- !x!` payload belong
+# here — `parse_keyword()` matches against the beginning of the payload,
+# not embedded sub-clauses. `IN ZIPFILE` / `WITH TEMPLATE` are EXPORT
+# sub-clauses and never appear at the start, so they don't go here.
+# When adding a new dispatch keyword, mirror it here (or fix the missing
+# entry via the `tests/test_format.py` drift check that pulls names from
+# the dispatch table).
 MULTIWORD_KEYWORDS = [
     "METACOMMAND_ERROR_HALT",
     "ON ERROR_HALT",
@@ -77,18 +84,31 @@ MULTIWORD_KEYWORDS = [
     "SUB_INI",
     "PROMPT ENTRY_FORM",
     "PROMPT SELECT_SUB",
+    "PROMPT SELECT_ROWS",
     "PROMPT ENTER_SUB",
     "PROMPT DIRECTORY",
+    "PROMPT CREDENTIALS",
     "PROMPT CONNECT",
     "PROMPT COMPARE",
     "PROMPT MESSAGE",
     "PROMPT DISPLAY",
     "PROMPT ACTION",
+    "PROMPT OPENFILE",
+    "PROMPT SAVEFILE",
     "PROMPT PAUSE",
-    "PROMPT FILE",
+    # PROMPT ASK COMPARE must precede PROMPT ASK so longest-match wins;
+    # parse_keyword iterates in list order, not by length.
+    "PROMPT ASK COMPARE",
     "PROMPT ASK",
-    "WITH TEMPLATE",
-    "IN ZIPFILE",
+    "PROMPT MAP",
+    "APPEND SCRIPT",
+    "PG_UPSERT CHECK",
+    "PG_UPSERT QA",
+    "RESET COUNTER",
+    "RESET DIALOG_CANCELED",
+    "SET COUNTER",
+    "WRITE CREATE_TABLE",
+    "WRITE SCRIPT",
     "SHOW SCRIPTS",
 ]
 
@@ -98,9 +118,18 @@ BLOCK_CLOSE = frozenset({"ENDIF", "END LOOP", "ENDLOOP", "END SCRIPT", "END BATC
 PIVOT = frozenset({"ELSE", "ELSEIF"})  # decrease depth before emit, increase after
 CONTINUATION = frozenset({"ANDIF", "ORIF"})  # emit at depth-1, no depth change
 
-# Inline IF: "IF (cond) { command }" — self-contained, no ENDIF, no depth change.
-# Mirrors src/execsql/cli/lint.py:_RX_IF_INLINE so formatter and linter agree.
+# Inline IF: "IF (cond) { command }" — self-contained, no ENDIF, no depth
+# change. Pattern must accept the same payloads as
+# src/execsql/script/parser.py:_IF_INLINE_RX. Kept as a separate compiled
+# pattern (not an import) so execsql-format doesn't pull in the AST parser
+# module graph at startup; tests/test_format.py has a drift check that
+# asserts both regexes recognise the same inputs.
 _IF_INLINE_RE = re.compile(r"^\s*IF\s*\(\s*.+\s*\)\s*\{.+\}\s*$", re.I)
+
+# Matches both untagged `$$` and tagged `$tag$` dollar-quote markers
+# (PostgreSQL PL/pgSQL / DO-block syntax). Tags are letter-or-underscore
+# followed by word characters; the empty tag (just `$$`) is also valid.
+_DOLLAR_QUOTE_RE = re.compile(r"\$([A-Za-z_][A-Za-z0-9_]*)?\$")
 # BLOCK_OPEN keywords whose bodies are guaranteed-SQL (not metacommand-driven).
 # Blank lines inside these belong to the SQL accumulator, not the output stream.
 _SQL_BODY_BLOCKS = frozenset({"BEGIN SQL", "BEGIN BATCH"})
@@ -180,9 +209,16 @@ def _is_comment_line(line: str, in_block: bool) -> tuple[bool, bool]:
 def _sqlglot_format(
     sql_lines: list[str],
     sql_indent: int = 4,
-    leading_comma: bool = False,
+    leading_comma: bool = False,  # noqa: ARG001 — leading-comma layout is applied as a textual post-pass on the assembled output; sqlglot's own `leading_comma=True` is non-idempotent under inline comments.
 ) -> list[str]:
-    """Format a list of SQL-only lines (no comment-only lines) via sqlglot."""
+    """Format a list of SQL-only lines (no comment-only lines) via sqlglot.
+
+    Always emits trailing-comma style; if the caller wants leading commas
+    they are produced by ``_apply_leading_comma`` at the end of
+    ``format_file``. sqlglot's own ``leading_comma=True`` reshuffles inline
+    comments and is therefore non-idempotent on SQL with mid-statement
+    comments, which is the dominant real-world case.
+    """
     sqlglot = _require_sqlglot()
     import sqlglot.errors as sqlglot_errors
 
@@ -211,7 +247,6 @@ def _sqlglot_format(
                             pad=sql_indent,
                             indent=sql_indent,
                             max_text_width=120,
-                            leading_comma=leading_comma,
                         ),
                     )
         stmts = [s for s in statements if s]
@@ -508,13 +543,105 @@ def format_metacommand(payload: str, depth: int, indent: int) -> str:
     return f"{prefix}-- !x! {keyword}"
 
 
+def _is_comment_only(s: str) -> bool:
+    """Strict comment classifier for the leading-comma post/pre passes."""
+    st = s.strip()
+    return st.startswith("--") or st.startswith("/*") or st.startswith("*/")
+
+
+def _normalize_to_trailing_comma(text: str) -> str:
+    """Rewrite leading-comma SQL (`, foo`) back to trailing-comma style.
+
+    Symmetric inverse of ``_apply_leading_comma``. Used as a pre-pass so
+    that sqlglot — which migrates inline ``/* marker */`` comments under
+    leading-comma input — sees a consistent trailing-comma shape on
+    every invocation. Comments between the two SQL lines stay in place.
+    """
+    lines = text.split("\n")
+
+    def find_prev_sql_line(idx: int) -> int:
+        k = idx - 1
+        while k >= 0 and (not lines[k].strip() or _is_comment_only(lines[k])):
+            k -= 1
+        return k
+
+    for i, line in enumerate(lines):
+        stripped = line.lstrip()
+        if not stripped.startswith(",") or _is_comment_only(line):
+            continue
+        # Don't try to rewrite leading-comma inside a comment-only line.
+        # Move the comma onto the previous SQL line as a trailing `,`.
+        prev = find_prev_sql_line(i)
+        if prev < 0:
+            continue
+        # Drop the `, ` (or `,`) at the start of this line.
+        indent_len = len(line) - len(stripped)
+        rest = stripped[1:].lstrip()
+        lines[i] = line[:indent_len] + rest
+        # Append `,` to the prev SQL line (preserving any existing right-side
+        # trailing whitespace — there shouldn't be any after format_file).
+        prev_rstripped = lines[prev].rstrip()
+        if not prev_rstripped.endswith(","):
+            lines[prev] = prev_rstripped + ","
+    return "\n".join(lines)
+
+
+def _apply_leading_comma(text: str) -> str:
+    """Rewrite trailing-comma SQL to leading-comma style as a textual pass.
+
+    Walks the assembled output line-by-line. For every line that ends with
+    ``,`` (and is not a comment), strip the comma and prepend ``, `` to the
+    next non-blank, non-comment line — preserving that target line's
+    indent. Comments between the two SQL lines stay in place. The
+    transformation is idempotent: rerunning it on its own output is a
+    no-op (the source line no longer ends with ``,``).
+
+    This decouples our user-facing ``--leading-comma`` flag from
+    sqlglot's own ``leading_comma=True`` mode, which is non-idempotent
+    when inline ``/* marker */`` comments are present — sqlglot moves
+    the markers around between passes (verified in tests/test_format.py
+    TestIdempotency).
+    """
+    lines = text.split("\n")
+    i = 0
+    n = len(lines)
+    while i < n:
+        rstripped = lines[i].rstrip()
+        if rstripped.endswith(",") and not _is_comment_only(lines[i]):
+            j = i + 1
+            while j < n and (not lines[j].strip() or _is_comment_only(lines[j])):
+                j += 1
+            if j < n:
+                stripped = lines[i].rstrip()
+                comma_idx = stripped.rfind(",")
+                lines[i] = stripped[:comma_idx] + stripped[comma_idx + 1 :]
+                target = lines[j]
+                indent_len = len(target) - len(target.lstrip())
+                lines[j] = target[:indent_len] + ", " + target[indent_len:]
+        i += 1
+    return "\n".join(lines)
+
+
 def format_file(source: str, indent: int = 4, use_sql: bool = True, leading_comma: bool = False) -> str:
     """Format the source text of an execsql script and return the result."""
+    # Normalize any leading-comma SQL in the source to trailing commas so
+    # that sqlglot always sees the same comma shape regardless of how
+    # the user saved the file. The post-pass at the bottom of this
+    # function re-applies leading commas when the caller asked for them.
+    # This is what makes leading_comma=True idempotent under inline
+    # comments — sqlglot itself migrates `/* marker */` comments when
+    # parsing leading-comma input.
+    source = _normalize_to_trailing_comma(source)
+
     depth = 0
     sql_acc: list[str] = []
     output: list[str] = []
 
     in_dollar_quote = False
+    # When in_dollar_quote, the tag string we are inside ("" for `$$`,
+    # "body" for `$body$`, etc.). Nested markers with a different tag
+    # are ignored — only a matching close marker re-opens us.
+    current_dq_tag: str | None = None
     in_block_comment = False
     # Track whether we are inside an open SQL statement (last SQL line
     # did not end with ';').  Blank lines mid-statement should NOT flush
@@ -527,7 +654,7 @@ def format_file(source: str, indent: int = 4, use_sql: bool = True, leading_comm
     in_explicit_sql_block = False
 
     def flush_sql() -> None:
-        nonlocal in_dollar_quote, in_sql_statement
+        nonlocal in_dollar_quote, current_dq_tag, in_sql_statement
         if sql_acc:
             # If any line in the accumulated block is inside a $$-delimited
             # region, skip sqlglot formatting entirely.  PL/pgSQL function
@@ -596,9 +723,19 @@ def format_file(source: str, indent: int = 4, use_sql: bool = True, leading_comm
                 output.append(format_metacommand(payload, depth, indent))
 
         else:
-            # Track $$ boundaries to prevent sqlglot from mangling PL/pgSQL
-            if "$$" in raw_line and raw_line.count("$$") % 2 == 1:
-                in_dollar_quote = not in_dollar_quote
+            # Track $$ and $tag$ boundaries to prevent sqlglot from mangling
+            # PL/pgSQL. Walk every dollar-quote marker on the line; toggle
+            # state only when we hit the matching open or close.
+            for m in _DOLLAR_QUOTE_RE.finditer(raw_line):
+                tag = m.group(1) or ""
+                if not in_dollar_quote:
+                    in_dollar_quote = True
+                    current_dq_tag = tag
+                elif tag == current_dq_tag:
+                    in_dollar_quote = False
+                    current_dq_tag = None
+                # else: tag mismatch — a foreign-tagged marker inside our
+                # quoted region; ignore (PG would treat it as literal text).
             sql_acc.append(raw_line)
             # Update statement tracking: if this SQL line ends with ';'
             # (and isn't a comment), the statement is complete.
@@ -610,6 +747,8 @@ def format_file(source: str, indent: int = 4, use_sql: bool = True, leading_comm
     flush_sql()
 
     result = "\n".join(output)
+    if leading_comma:
+        result = _apply_leading_comma(result)
     if not result.endswith("\n"):
         result += "\n"
     return result
@@ -665,6 +804,12 @@ def main() -> None:
             "--leading-comma",
             help="Place commas at the start of lines instead of the end.",
         ),
+        encoding: str = typer.Option(
+            "utf-8",
+            "--encoding",
+            metavar="NAME",
+            help="Text encoding used to read and write SQL files (default utf-8).",
+        ),
     ) -> None:
         use_sql = not no_sql
         paths = collect_paths(targets)
@@ -673,12 +818,23 @@ def main() -> None:
             raise typer.Exit(code=1)
 
         any_changed = False
+        any_errors = False
         for path in paths:
             try:
-                source = path.read_text(encoding="utf-8")
+                source = path.read_text(encoding=encoding)
             except OSError as exc:
                 _err_console.print(f"[bold red]Error:[/bold red] reading {path}: {exc}")
-                raise typer.Exit(code=1) from None
+                any_errors = True
+                # Collect read errors instead of short-circuiting so a single
+                # unreadable file doesn't hide the rest of the report.
+                continue
+            except UnicodeDecodeError as exc:
+                _err_console.print(
+                    f"[bold red]Error:[/bold red] decoding {path} as {encoding}: {exc}. "
+                    f"Try [bold]--encoding cp1252[/bold] or another text encoding.",
+                )
+                any_errors = True
+                continue
 
             formatted = format_file(source, indent=indent, use_sql=use_sql, leading_comma=leading_comma)
 
@@ -688,12 +844,12 @@ def main() -> None:
                     any_changed = True
             elif in_place:
                 if formatted != source:
-                    path.write_text(formatted, encoding="utf-8")
+                    path.write_text(formatted, encoding=encoding)
                     _console.print(f"reformatted {path}")
             else:
                 sys.stdout.write(formatted)
 
-        if check and any_changed:
+        if any_errors or (check and any_changed):
             raise typer.Exit(code=1)
 
     app()

execsql/utils/mail.py

@@ -51,16 +51,19 @@ class Mailer:
         conf = _state.conf
         if conf.smtp_host is None:
             raise ErrInfo(type="error", other_msg="Can't send email; the email host is not configured.")
+        # 30 s connect/read timeout matches the DB-adapter default so a
+        # silently-dropped SMTP peer can't hang a script (or a CI run).
+        smtp_timeout = 30
         if conf.smtp_port is None:
             if conf.smtp_ssl:
-                self.smtpconn = smtplib.SMTP_SSL(conf.smtp_host)
+                self.smtpconn = smtplib.SMTP_SSL(conf.smtp_host, timeout=smtp_timeout)
             else:
-                self.smtpconn = smtplib.SMTP(conf.smtp_host)
+                self.smtpconn = smtplib.SMTP(conf.smtp_host, timeout=smtp_timeout)
         else:
             if conf.smtp_ssl:
-                self.smtpconn = smtplib.SMTP_SSL(conf.smtp_host, conf.smtp_port)
+                self.smtpconn = smtplib.SMTP_SSL(conf.smtp_host, conf.smtp_port, timeout=smtp_timeout)
             else:
-                self.smtpconn = smtplib.SMTP(conf.smtp_host, conf.smtp_port)
+                self.smtpconn = smtplib.SMTP(conf.smtp_host, conf.smtp_port, timeout=smtp_timeout)
         self.smtpconn.ehlo_or_hello_if_needed()
         if conf.smtp_tls:
             self.smtpconn.starttls()

{execsql2-2.19.2.data → execsql2-2.20.0.data}/data/execsql2_extras/README.md

@@ -2,7 +2,7 @@
 
 Several types of templates are provided that may be useful in conjunction with execsql. These are:
 
-- **execsql.conf** — An annotated version of the configuration file that includes all configuration settings and notes on their usage.
+- **execsql.conf** — An annotated reference of every configuration setting with notes on its usage. Generate a fresh copy in any directory with `execsql --init-config > execsql.conf`; the canonical content ships inside the installed package and is loaded via `importlib.resources` (no need to find or copy a source file).
 
 - **script_template.sql** — A framework for SQL scripts that make use of several execsql features. It includes sections for custom configuration settings, custom logfile creation, and reporting of unexpected script exits (through user cancellation or errors).
 

{execsql2-2.19.2.dist-info → execsql2-2.20.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execsql2
-Version: 2.19.2
+Version: 2.20.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: Homepage, https://execsql2.readthedocs.io
 Project-URL: Repository, https://github.com/geocoug/execsql
@@ -44,88 +44,87 @@ Requires-Dist: rich>=13.0
 Requires-Dist: textual>=1.0
 Requires-Dist: typer>=0.12
 Provides-Extra: all
-Requires-Dist: defusedxml; extra == 'all'
-Requires-Dist: duckdb; extra == 'all'
-Requires-Dist: firebird-driver; extra == 'all'
-Requires-Dist: jinja2; extra == 'all'
-Requires-Dist: keyring; extra == 'all'
-Requires-Dist: odfpy; extra == 'all'
-Requires-Dist: openpyxl; extra == 'all'
-Requires-Dist: oracledb; extra == 'all'
+Requires-Dist: defusedxml>=0.7; extra == 'all'
+Requires-Dist: duckdb>=1.0; extra == 'all'
+Requires-Dist: firebird-driver>=1.10; extra == 'all'
+Requires-Dist: jinja2>=3.1; extra == 'all'
+Requires-Dist: keyring>=25.0; extra == 'all'
+Requires-Dist: odfpy>=1.4; extra == 'all'
+Requires-Dist: openpyxl>=3.1; extra == 'all'
+Requires-Dist: oracledb>=3.0; extra == 'all'
 Requires-Dist: pg-upsert>=1.22.1; extra == 'all'
-Requires-Dist: polars; extra == 'all'
-Requires-Dist: psycopg2-binary; extra == 'all'
-Requires-Dist: pymysql; extra == 'all'
-Requires-Dist: pyodbc; extra == 'all'
-Requires-Dist: pyyaml; extra == 'all'
+Requires-Dist: polars>=1.0; extra == 'all'
+Requires-Dist: psycopg2-binary>=2.9; extra == 'all'
+Requires-Dist: pymysql>=1.1; extra == 'all'
+Requires-Dist: pyodbc>=5.0; extra == 'all'
+Requires-Dist: pyyaml>=6.0; extra == 'all'
 Requires-Dist: sqlglot>=25.0; extra == 'all'
-Requires-Dist: tables; extra == 'all'
+Requires-Dist: tables>=3.10; extra == 'all'
 Requires-Dist: tkintermapview>=1.29; extra == 'all'
-Requires-Dist: xlrd; extra == 'all'
+Requires-Dist: xlrd>=2.0; extra == 'all'
 Provides-Extra: all-db
-Requires-Dist: duckdb; extra == 'all-db'
-Requires-Dist: firebird-driver; extra == 'all-db'
-Requires-Dist: oracledb; extra == 'all-db'
-Requires-Dist: psycopg2-binary; extra == 'all-db'
-Requires-Dist: pymysql; extra == 'all-db'
-Requires-Dist: pyodbc; extra == 'all-db'
+Requires-Dist: duckdb>=1.0; extra == 'all-db'
+Requires-Dist: firebird-driver>=1.10; extra == 'all-db'
+Requires-Dist: oracledb>=3.0; extra == 'all-db'
+Requires-Dist: psycopg2-binary>=2.9; extra == 'all-db'
+Requires-Dist: pymysql>=1.1; extra == 'all-db'
+Requires-Dist: pyodbc>=5.0; extra == 'all-db'
 Provides-Extra: auth
-Requires-Dist: keyring; extra == 'auth'
+Requires-Dist: keyring>=25.0; extra == 'auth'
 Provides-Extra: auth-encrypted
-Requires-Dist: keyring; extra == 'auth-encrypted'
-Requires-Dist: keyrings-alt; extra == 'auth-encrypted'
-Requires-Dist: pycryptodome; extra == 'auth-encrypted'
+Requires-Dist: keyring>=25.0; extra == 'auth-encrypted'
+Requires-Dist: keyrings-alt>=5.0; extra == 'auth-encrypted'
+Requires-Dist: pycryptodome>=3.20; extra == 'auth-encrypted'
 Provides-Extra: auth-plaintext
-Requires-Dist: keyring; extra == 'auth-plaintext'
-Requires-Dist: keyrings-alt; extra == 'auth-plaintext'
+Requires-Dist: keyring>=25.0; extra == 'auth-plaintext'
+Requires-Dist: keyrings-alt>=5.0; extra == 'auth-plaintext'
 Provides-Extra: dev
 Requires-Dist: build>=1.2.2.post1; extra == 'dev'
 Requires-Dist: bump-my-version>=1.2.7; extra == 'dev'
-Requires-Dist: defusedxml; extra == 'dev'
-Requires-Dist: jinja2; extra == 'dev'
-Requires-Dist: markdown-include>=0.8; extra == 'dev'
+Requires-Dist: defusedxml>=0.7; extra == 'dev'
+Requires-Dist: jinja2>=3.1; extra == 'dev'
 Requires-Dist: mkdocstrings-python>=2.0.3; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
-Requires-Dist: odfpy; extra == 'dev'
-Requires-Dist: openpyxl; extra == 'dev'
-Requires-Dist: polars; extra == 'dev'
+Requires-Dist: odfpy>=1.4; extra == 'dev'
+Requires-Dist: openpyxl>=3.1; extra == 'dev'
+Requires-Dist: polars>=1.0; extra == 'dev'
 Requires-Dist: pre-commit>=3.5.0; extra == 'dev'
 Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
-Requires-Dist: pyyaml; extra == 'dev'
+Requires-Dist: pyyaml>=6.0; extra == 'dev'
 Requires-Dist: ruff>=0.4; extra == 'dev'
 Requires-Dist: sqlglot>=25.0; extra == 'dev'
-Requires-Dist: tables; extra == 'dev'
+Requires-Dist: tables>=3.10; extra == 'dev'
 Requires-Dist: tox-uv>=1.13.1; extra == 'dev'
 Requires-Dist: twine>=6.1.0; extra == 'dev'
-Requires-Dist: xlrd; extra == 'dev'
-Requires-Dist: zensical>=0.0.28; extra == 'dev'
+Requires-Dist: xlrd>=2.0; extra == 'dev'
+Requires-Dist: zensical==0.0.28; extra == 'dev'
 Provides-Extra: duckdb
-Requires-Dist: duckdb; extra == 'duckdb'
+Requires-Dist: duckdb>=1.0; extra == 'duckdb'
 Provides-Extra: firebird
-Requires-Dist: firebird-driver; extra == 'firebird'
+Requires-Dist: firebird-driver>=1.10; extra == 'firebird'
 Provides-Extra: formats
-Requires-Dist: defusedxml; extra == 'formats'
-Requires-Dist: jinja2; extra == 'formats'
-Requires-Dist: odfpy; extra == 'formats'
-Requires-Dist: openpyxl; extra == 'formats'
-Requires-Dist: polars; extra == 'formats'
-Requires-Dist: pyyaml; extra == 'formats'
-Requires-Dist: tables; extra == 'formats'
-Requires-Dist: xlrd; extra == 'formats'
+Requires-Dist: defusedxml>=0.7; extra == 'formats'
+Requires-Dist: jinja2>=3.1; extra == 'formats'
+Requires-Dist: odfpy>=1.4; extra == 'formats'
+Requires-Dist: openpyxl>=3.1; extra == 'formats'
+Requires-Dist: polars>=1.0; extra == 'formats'
+Requires-Dist: pyyaml>=6.0; extra == 'formats'
+Requires-Dist: tables>=3.10; extra == 'formats'
+Requires-Dist: xlrd>=2.0; extra == 'formats'
 Provides-Extra: formatter
 Requires-Dist: sqlglot>=25.0; extra == 'formatter'
 Provides-Extra: map
 Requires-Dist: tkintermapview>=1.29; extra == 'map'
 Provides-Extra: mssql
-Requires-Dist: pyodbc; extra == 'mssql'
+Requires-Dist: pyodbc>=5.0; extra == 'mssql'
 Provides-Extra: mysql
-Requires-Dist: pymysql; extra == 'mysql'
+Requires-Dist: pymysql>=1.1; extra == 'mysql'
 Provides-Extra: odbc
-Requires-Dist: pyodbc; extra == 'odbc'
+Requires-Dist: pyodbc>=5.0; extra == 'odbc'
 Provides-Extra: oracle
-Requires-Dist: oracledb; extra == 'oracle'
+Requires-Dist: oracledb>=3.0; extra == 'oracle'
 Provides-Extra: postgres
-Requires-Dist: psycopg2-binary; extra == 'postgres'
+Requires-Dist: psycopg2-binary>=2.9; extra == 'postgres'
 Provides-Extra: upsert
 Requires-Dist: pg-upsert>=1.22.1; extra == 'upsert'
 Description-Content-Type: text/markdown
@@ -404,13 +403,12 @@ execsql-format --no-sql --in-place scripts/
 ```yaml
 repos:
   - repo: https://github.com/geocoug/execsql
-    rev: v2.18.0
+    rev: v2.20.0
     hooks:
       - id: execsql-format
-        args: [--in-place]
 ```
 
-See the [formatter documentation](https://execsql2.readthedocs.io/en/latest/guides/formatter/) for all options.
+The hook rewrites `*.sql` files in place by default. See the [formatter documentation](https://execsql2.readthedocs.io/en/latest/guides/formatter/) for `--check`, `--indent`, and other options.
 
 # VS Code Syntax Highlighting
 

{execsql2-2.19.2.dist-info → execsql2-2.20.0.dist-info}/RECORD

@@ -3,7 +3,7 @@ execsql/__main__.py,sha256=HdbK-SAhyUmfB6xINY5AzxdMSxGzWSGEG_2dv42Jn64,315
 execsql/api.py,sha256=ZFTo_XZPhG21w2vxaeS1lS6o5XmF1FUJRIaypgTOjA8,20919
 execsql/config.py,sha256=OOrCcn9m3CNuXkxVOLp7uMhQikzUS2wh_QVhvIzRqIM,33296
 execsql/exceptions.py,sha256=EkM5cw2s0D9QCOgS4BU29FEyOnEtCxJ0esPT6l1hT9s,9205
-execsql/format.py,sha256=3EXAnuFYPp595jRLjoou3ATc4WSbYwPhrDmyzjTLMoE,26416
+execsql/format.py,sha256=dC2cHGUldOTq1YRENm7vtIIv4vtUswRhxuqeMp99d70,33648
 execsql/models.py,sha256=kCTUQg9-vReM6WNFfB_ZrEppuOW5u1uMBQThSkfPC0o,13264
 execsql/parser.py,sha256=P3ea8k7T_XLMrbhpFNZXwytdShrY302MKnhosqza1lo,15493
 execsql/plugins.py,sha256=2voLwT6eFap6BCBoZYndNNC_bMEJO1f_aP6xQTVXwYI,12815
@@ -14,21 +14,21 @@ execsql/cli/__init__.py,sha256=aJknKKIGxYCXpny0cyHXfqJsJ95dBtlEXXhPASFG8GQ,23114
 execsql/cli/dsn.py,sha256=svaZtrUXFRL2W5G6FRRiKtR6kehOp7urrVhIx_642Z8,2820
 execsql/cli/help.py,sha256=ThwdZuMIfLPxLAPpGWwXFY_UfyWvYOCjdlBNK20Vzd8,5718
 execsql/cli/lint.py,sha256=YqKzFNUhyb_Th69hYgKk1ZZVjCsZfJMIiUGqp06JwNs,17236
-execsql/cli/run.py,sha256=4plvi8ZaGea5fUeOhtS2f4MrVnGTaetvJyz7qX07s0I,37706
+execsql/cli/run.py,sha256=0gmn7f7RjSYatOUZ34QIzK8gP_vgQFZE6U4P6EKU2H4,38188
 execsql/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 execsql/data/execsql.conf.template,sha256=Sq1Huwb_Uf_lI7zW7m3h11fqU6zjGpGnCU4OVJ_tCe0,10696
 execsql/db/__init__.py,sha256=jTbuafuKOqYtXFR1wvCOoKK5Lr3l1uErfaIbIr6UywI,1063
-execsql/db/access.py,sha256=GcY5Pq_vXdp8Thzm6aSLg9vfp5koovGiYKXipQtRt50,19167
-execsql/db/base.py,sha256=UUiYSztUen8xCWVCxDkRQeD098Yv1iA3WPl_qo4XjDI,34686
-execsql/db/dsn.py,sha256=59OzMAuCIfHcdOZNarK9TlDzaBJjhZ1SFFMvyXlH6u8,6086
+execsql/db/access.py,sha256=sRJOJJo1psSO5RV6QPsFY1YJE5wc5aNOYCFDtxIn_Wo,19413
+execsql/db/base.py,sha256=0Cy_M3GHdkQDJMbMeWpNyUIPux9m1cVDy21MGMjhJCI,35002
+execsql/db/dsn.py,sha256=CZd5NhUSVvK3irv2maeWsSqBsZjhFsTxIuT29Z0rP2A,6240
 execsql/db/duckdb.py,sha256=79lRzKRhw1Pjfqcrba27S4Oq8a8AbDO_d0XkaNKKPQo,3197
 execsql/db/factory.py,sha256=YHdgyqQYy16548O3fGyElLC5C7DdIgva4Z29OsDxXjs,5367
-execsql/db/firebird.py,sha256=p_7RFWhFI7y5ukKCMXeDPE0wjeQ6dpO4IK6uz2dYjrc,9224
-execsql/db/mysql.py,sha256=gOm1IRzFmxnT4ekGEXiF2yM3jB6r4p38Cmtt1Utj27Y,17712
+execsql/db/firebird.py,sha256=cV5wUzQHoz7yugHdNxAn8IW7fL3v1riIsGLykCZhZwA,9480
+execsql/db/mysql.py,sha256=Z0vI_nQ6vhG3sYa2fv5NOO3JmAsH6_jVjM8FuujQpqI,17961
 execsql/db/oracle.py,sha256=1_odb5xmlm8vjdJdQXz7SHm9dzIbZ5sxP_IxTklH3kA,12018
 execsql/db/postgres.py,sha256=UNzrXzMniEyT3Z7qjCA_HLEUY0PVr1cJShuhAxtl5l0,21241
 execsql/db/sqlite.py,sha256=xooU6bvD9Y3frRpnbyesE63r6E1fwEHkkcN1YD_UIUE,11519
-execsql/db/sqlserver.py,sha256=sxtOrcN1pGJQ0x7CctrKIL9XFIaHCDVIVvEvxzEOdzY,8744
+execsql/db/sqlserver.py,sha256=j2ViLoBWzizgaL0u6V4iHfjinrlJ4rpBD3XZiKKdwSU,8968
 execsql/debug/__init__.py,sha256=j6EGUR0dHzUhWN1mHHtf1-Lhjq3Sb1V-vmnq2Ztgj1M,178
 execsql/debug/repl.py,sha256=JObeoEXh15qyk4Q3WQCCqMcBtojlIcu_Xg-ZRDZJi5Q,25491
 execsql/exporters/__init__.py,sha256=-Cnji-OgodJV8ftcDcOyTof0kQMy9J5kKVC8GVFpc3o,670
@@ -95,29 +95,28 @@ execsql/utils/datetime.py,sha256=rMCXAbvj6bxKCYzC97vrludO6PU5DYQ39buZ0smDC5A,357
 execsql/utils/errors.py,sha256=C-9hlpJ7GM5gpDBdTsT4xFhK0OHNjonHgbq7fMl-Vvc,8577
 execsql/utils/fileio.py,sha256=38Z0WBvfaMa624aw3jo9ZOSlUCsacIeJWOhQKYe9YlU,31012
 execsql/utils/gui.py,sha256=kpJkvi8zblXFdO4PgsF8yE_gkOJrsDwWoQWmaDpjJEQ,23402
-execsql/utils/mail.py,sha256=MeSYjG9Qr8zdrEvkvg0C3YcLKaA5Op9xqeKbfvj-RLs,5500
+execsql/utils/mail.py,sha256=ojdROW6Ti7paVpVMIxRXh7opOdE61fE2duS8xoA6d2Q,5758
 execsql/utils/numeric.py,sha256=xh02ANSRk3nUpQ-rtm66ILoMqoi7HtzCoRMIOT9U8QI,1570
 execsql/utils/regex.py,sha256=diEzTZqU_HHwVMadPAvN1Vgzhl7I03eVaEFGCXyGGL8,3770
 execsql/utils/strings.py,sha256=UQNjpRCEFa1UO6feU-M-9e24wWAvizs_iu_4fFusLxo,8516
 execsql/utils/timer.py,sha256=eDYf5VzCNFk7oo90InJucUm3XcBdhYMogjZMqeg9xzc,1899
-execsql2-2.19.2.data/data/execsql2_extras/README.md,sha256=sxwVyU0ZahCfANv56LahkyuM505kFjrMhe-1SvWE69E,4845
-execsql2-2.19.2.data/data/execsql2_extras/config_settings.sqlite,sha256=aY5cxR7Q7J6zJ4bC9lu5mHUrhy211Cq3MNKPQVCt02E,20480
-execsql2-2.19.2.data/data/execsql2_extras/example_config_prompt.sql,sha256=2e8KzzVWhho8KxYVHETSVmZdhW7wodioDsqBLSL6m4s,7487
-execsql2-2.19.2.data/data/execsql2_extras/execsql.conf,sha256=Sq1Huwb_Uf_lI7zW7m3h11fqU6zjGpGnCU4OVJ_tCe0,10696
-execsql2-2.19.2.data/data/execsql2_extras/make_config_db.sql,sha256=WwyC6dK-Eh5CAVppiBCDHqiI1_wEI9U95Ytpr4lsZkg,8726
-execsql2-2.19.2.data/data/execsql2_extras/md_compare.sql,sha256=qYYVAjSeHZzjszxV3Bv6bg8Ckbq2kMHl87_gh4sywMU,24140
-execsql2-2.19.2.data/data/execsql2_extras/md_glossary.sql,sha256=hkZ2Onn57LAKKsuXxzhR8tPtcWXkmWEQkwPE58-Tm2k,10796
-execsql2-2.19.2.data/data/execsql2_extras/md_upsert.sql,sha256=_CAK4BzEboRXTNy03SJR-oOjcEdSNMuRBPL6noWUptY,112560
-execsql2-2.19.2.data/data/execsql2_extras/pg_compare.sql,sha256=1zJd4hVUKHR0tncc2qTBC9B4qVV4Us2ITkJpsjN3tMw,24352
-execsql2-2.19.2.data/data/execsql2_extras/pg_glossary.sql,sha256=IKuwna-_8b20ljSkXZruuiQigrCpo7ueQdUqd1MXiuI,9908
-execsql2-2.19.2.data/data/execsql2_extras/pg_upsert.sql,sha256=HpPJtTHvpEjQy03j-3iPxDEOHMRkudOg7O4D4YR38UI,108315
-execsql2-2.19.2.data/data/execsql2_extras/script_template.sql,sha256=2J35ddZPguJ-vwTsz83wErv0jiWUyJcdW_JM0mNKDXA,11155
-execsql2-2.19.2.data/data/execsql2_extras/ss_compare.sql,sha256=j1qVNUPXQsEU7-DoVgDJCGcE0EuIl7whLBT3fgeiMAo,24833
-execsql2-2.19.2.data/data/execsql2_extras/ss_glossary.sql,sha256=2gLxv34xzKt0vy7hSzJH7a9JiMC3ETrv9MofxQwAibU,13065
-execsql2-2.19.2.data/data/execsql2_extras/ss_upsert.sql,sha256=G_8rQ0VzuKIZHWs24O_WrfzpC5S27R1JsL-bFBR3SUQ,117730
-execsql2-2.19.2.dist-info/METADATA,sha256=MM_IlZJUBFm8AmOYmEx3sydmztTSX89EZcJ3aSJtcm4,22340
-execsql2-2.19.2.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
-execsql2-2.19.2.dist-info/entry_points.txt,sha256=sUOxkM-dN1eBGGpSpDLsAaE0yNXYQKWZAfxPOlMkQyk,90
-execsql2-2.19.2.dist-info/licenses/LICENSE.txt,sha256=LBdhuxejF8_bLCHZ2kWfmDXpDGUu914Gbd6_3JjCRe0,676
-execsql2-2.19.2.dist-info/licenses/NOTICE,sha256=McYzgxYav3U1OaVsY4Su1sfBrfmplpRdA9b6-gCDQCg,342
-execsql2-2.19.2.dist-info/RECORD,,
+execsql2-2.20.0.data/data/execsql2_extras/README.md,sha256=vX4NTL095dUoA_hesyRMGYBorEZ_Y_tJ9qrd-MVV09I,5032
+execsql2-2.20.0.data/data/execsql2_extras/config_settings.sqlite,sha256=aY5cxR7Q7J6zJ4bC9lu5mHUrhy211Cq3MNKPQVCt02E,20480
+execsql2-2.20.0.data/data/execsql2_extras/example_config_prompt.sql,sha256=2e8KzzVWhho8KxYVHETSVmZdhW7wodioDsqBLSL6m4s,7487
+execsql2-2.20.0.data/data/execsql2_extras/make_config_db.sql,sha256=WwyC6dK-Eh5CAVppiBCDHqiI1_wEI9U95Ytpr4lsZkg,8726
+execsql2-2.20.0.data/data/execsql2_extras/md_compare.sql,sha256=qYYVAjSeHZzjszxV3Bv6bg8Ckbq2kMHl87_gh4sywMU,24140
+execsql2-2.20.0.data/data/execsql2_extras/md_glossary.sql,sha256=hkZ2Onn57LAKKsuXxzhR8tPtcWXkmWEQkwPE58-Tm2k,10796
+execsql2-2.20.0.data/data/execsql2_extras/md_upsert.sql,sha256=_CAK4BzEboRXTNy03SJR-oOjcEdSNMuRBPL6noWUptY,112560
+execsql2-2.20.0.data/data/execsql2_extras/pg_compare.sql,sha256=1zJd4hVUKHR0tncc2qTBC9B4qVV4Us2ITkJpsjN3tMw,24352
+execsql2-2.20.0.data/data/execsql2_extras/pg_glossary.sql,sha256=IKuwna-_8b20ljSkXZruuiQigrCpo7ueQdUqd1MXiuI,9908
+execsql2-2.20.0.data/data/execsql2_extras/pg_upsert.sql,sha256=HpPJtTHvpEjQy03j-3iPxDEOHMRkudOg7O4D4YR38UI,108315
+execsql2-2.20.0.data/data/execsql2_extras/script_template.sql,sha256=2J35ddZPguJ-vwTsz83wErv0jiWUyJcdW_JM0mNKDXA,11155
+execsql2-2.20.0.data/data/execsql2_extras/ss_compare.sql,sha256=j1qVNUPXQsEU7-DoVgDJCGcE0EuIl7whLBT3fgeiMAo,24833
+execsql2-2.20.0.data/data/execsql2_extras/ss_glossary.sql,sha256=2gLxv34xzKt0vy7hSzJH7a9JiMC3ETrv9MofxQwAibU,13065
+execsql2-2.20.0.data/data/execsql2_extras/ss_upsert.sql,sha256=G_8rQ0VzuKIZHWs24O_WrfzpC5S27R1JsL-bFBR3SUQ,117730
+execsql2-2.20.0.dist-info/METADATA,sha256=2j1tQ7oxlDAfsmIPQwgDxxn9O34FN7MbKT1nLznLi-M,22603
+execsql2-2.20.0.dist-info/WHEEL,sha256=mffPy8wBnZQn2VnJUU5jE99KsxaSfiyMHV9Yt0aLVxs,87
+execsql2-2.20.0.dist-info/entry_points.txt,sha256=sUOxkM-dN1eBGGpSpDLsAaE0yNXYQKWZAfxPOlMkQyk,90
+execsql2-2.20.0.dist-info/licenses/LICENSE.txt,sha256=LBdhuxejF8_bLCHZ2kWfmDXpDGUu914Gbd6_3JjCRe0,676
+execsql2-2.20.0.dist-info/licenses/NOTICE,sha256=McYzgxYav3U1OaVsY4Su1sfBrfmplpRdA9b6-gCDQCg,342
+execsql2-2.20.0.dist-info/RECORD,,

execsql2-2.19.2.data/data/execsql2_extras/execsql.conf

@@ -1,359 +0,0 @@
-# execsql.conf — Configuration file for execsql
-#
-# Documentation: https://execsql2.readthedocs.io/en/latest/reference/configuration/
-#
-# This file uses INI format. Section names are case-sensitive (lowercase).
-# Property names are not case-sensitive. Lines starting with # are comments.
-#
-# execsql searches for this file in the following locations (in order):
-#   1. System-wide: /etc/execsql.conf (Linux/macOS) or %APPDATA%\execsql.conf (Windows)
-#   2. User: ~/.config/execsql.conf
-#   3. Script directory: same directory as the SQL script
-#   4. Working directory: current directory
-#
-# Later files override earlier ones. CLI arguments override everything.
-# Generate this template with: execsql --init-config > execsql.conf
-
-
-[connect]
-# Connection information for the initial database connection.
-
-# Database type.
-#   p: PostgreSQL    l: SQLite       m: MySQL/MariaDB   k: DuckDB
-#   f: Firebird      s: SQL Server   a: MS Access       o: Oracle    d: DSN
-#db_type=l
-
-# Server name for client-server databases.
-#server=
-
-# Database name for client-server databases.
-#db=
-
-# Database file path for file-based databases (SQLite, DuckDB, Access).
-#db_file=
-
-# Port number for server-based databases. Only needed if not the default.
-#port=
-
-# User name for client-server databases.
-#username=
-
-# User name for password-protected MS Access databases if not "Admin".
-#access_username=
-
-# Whether to prompt for a password.
-# Values: Yes or No.  Default: Yes.
-#password_prompt=Yes
-
-# Whether to use the OS credential store (keyring) for password storage.
-# Requires: pip install execsql2[auth]
-# Values: Yes or No.  Default: Yes.
-#use_keyring=Yes
-
-# Whether to create a new database if it does not exist (SQLite, PostgreSQL, DuckDB).
-# Values: Yes or No.  Default: No.
-#new_db=No
-
-
-[encoding]
-# Character encoding for text input and output.
-
-#database=
-#script=utf8
-#import=utf8
-#output=utf8
-
-# How to handle incompatible encodings.
-# Values: ignore, replace, xmlcharrefreplace, or backslashreplace.
-#error_response=
-
-
-[input]
-# Settings for handling imported data.
-
-# Whether to convert numeric values to double precision when using MS Access.
-# Values: Yes or No.  Default: No.
-#access_use_numeric=No
-
-# Whether to treat integer values of 0 and 1 as Booleans.
-# Values: Yes or No.  Default: Yes.
-#boolean_int=Yes
-
-# Whether to recognize only full words as Boolean, not "Y", "N", "T", and "F".
-# Values: Yes or No.  Default: No.
-#boolean_words=No
-
-# Whether to replace non-alphanumeric characters in column names with underscores.
-# Values: Yes or No.  Default: No.
-#clean_column_headers=No
-
-# Whether to create column headers when missing from an input file.
-# Headers will be "Col1", "Col2", etc.
-# Values: Yes or No.  Default: No.
-#create_column_headers=No
-
-# Whether to deduplicate column names by appending "_N" (column number).
-# Values: Yes or No.  Default: No.
-#dedup_column_headers=No
-
-# Whether to completely delete columns with missing headers.
-# Values: Yes or No.  Default: No.
-#delete_empty_columns=No
-
-# Whether to import completely empty rows.
-# Values: Yes or No.  Default: Yes.
-#empty_rows=Yes
-
-# Whether empty strings in input data are preserved or replaced by NULL.
-# Values: Yes or No.  Default: Yes.
-#empty_strings=Yes
-
-# Whether to fold column headers to lowercase, uppercase, or leave unchanged.
-# Values: No, Lower, or Upper.  Default: No.
-#fold_column_headers=No
-
-# The size of the import buffer, in KB, for the Postgres fast file reading feature.
-#import_buffer=
-
-# Whether to ignore extra columns in imported data that are not in the target table.
-# Values: Yes or No.  Default: No.
-#import_only_common_columns=No
-
-# Interval (in rows) at which to report import progress. 0 disables.
-# Value: A non-negative integer.  Default: 0.
-#import_progress_interval=0
-
-# The number of rows to buffer when importing data.
-# Value: A positive non-zero integer.  Default: 1000.
-#import_row_buffer=1000
-
-# The maximum value that will be assigned an integer data type when creating tables.
-#max_int=2147483647
-
-# Whether IMPORT treats all columns as text instead of inferring data types.
-# Values: Yes or No.  Default: No.
-#only_strings=No
-
-# Whether newlines embedded in imported text should be replaced with a space.
-# Values: Yes or No.  Default: No.
-#replace_newlines=No
-
-# The number of lines to scan in an input file to identify delimiters and quotes.
-# Value: A positive non-zero integer.  Default: 100.
-#scan_lines=100
-
-# Whether to show a progress bar for long-running IMPORT operations.
-# Values: Yes or No.  Default: No.
-#show_progress=No
-
-# Whether to trim spaces/underscores from column headers.
-# Values: None, Both, Left, or Right.  Default: None.
-#trim_column_headers=None
-
-# Whether to trim leading/trailing whitespace from imported text.
-# Values: Yes or No.  Default: No.
-#trim_strings=No
-
-
-[output]
-# Settings for data export and output.
-
-# Whether WRITE output should also be sent to the log file.
-# Values: Yes or No.  Default: No.
-#log_write_messages=No
-
-# Whether to create non-existent directories for WRITE or EXPORT output.
-# Values: Yes or No.  Default: No.
-#make_export_dirs=No
-
-# Whether to quote all text values in delimited exports.
-# Values: Yes or No.  Default: No.
-#quote_all_text=No
-
-# The number of rows to buffer from the database when exporting.
-# Value: A positive non-zero integer.  Default: 1000.
-#export_row_buffer=1000
-
-# The length for text data types when exporting to HDF5.
-# Value: A positive non-zero integer.  Default: 1000.
-#hdf5_text_len=1000
-
-# The URI of a CSS file to use when exporting to HTML.
-#css_file=
-
-# CSS style commands to embed in HTML exports.
-#css_styles=
-
-# Seconds to keep retrying when an output file has an access conflict.
-# Value: A positive non-zero number.  Default: 600.
-#outfile_open_timeout=600
-
-# The template processor for template-based exports.
-# Value: jinja.
-#template_processor=
-
-# Internal buffer size (in MB) for ZIP exports.
-# Value: A positive non-zero integer.  Default: 10.
-#zip_buffer_mb=10
-
-
-[interface]
-# Settings for GUI dialogs and console output.
-
-# GUI backend framework.
-# Values: tkinter or textual.  Default: tkinter.
-#gui_framework=tkinter
-
-# GUI dialog usage level.
-#   0: none (default)
-#   1: passwords and PAUSE metacommands
-#   2: also database selection dialogs
-#   3: open a console window immediately
-#gui_level=0
-
-# The height (in lines) of the console window.
-# Value: An integer >= 5.  Default: 25.
-#console_height=25
-
-# The width (in characters) of the console window.
-# Value: An integer >= 20.  Default: 100.
-#console_width=100
-
-# Whether the console stays open at the end of the script.
-# Values: Yes or No.  Default: No.
-#console_wait_when_done=No
-
-# Whether the console stays open when an error halt occurs.
-# Values: Yes or No.  Default: No.
-#console_wait_when_error_halt=No
-
-# Whether to write warning messages to the console.
-# Values: Yes or No.  Default: No.
-#write_warnings=No
-
-# Text to prefix to WRITE output (with a space separator). "clear" removes a previous prefix.
-#write_prefix=
-
-# Text to append to WRITE output (with a space separator). "clear" removes a previous suffix.
-#write_suffix=
-
-
-[email]
-# Settings for the EMAIL metacommand.
-
-# SMTP server connection.
-#host=
-#port=
-#username=
-#password=
-
-# Whether to use implicit TLS (port 465). Preferred over use_tls.
-# Values: Yes or No.  Default: No.
-#use_ssl=No
-
-# Whether to use STARTTLS (port 587).
-# Values: Yes or No.  Default: No.
-#use_tls=No
-
-# Email body format.
-# Values: plain or html.  Default: plain.
-#email_format=plain
-
-# Custom CSS styles for HTML email.
-#message_css=
-
-# Obfuscated password (XOR, not cryptographically secure — use keyring instead).
-# See: https://execsql2.readthedocs.io/en/latest/reference/security/#credentials
-#enc_password=
-
-
-[config]
-# General program configuration and additional config file chaining.
-
-# Path to an additional configuration file to load.
-#config_file=
-
-# Whether to allow the SYSTEM_CMD (SHELL) metacommand.
-# Set to No to prevent scripts from executing OS commands.
-# Also controllable via --no-system-cmd CLI flag.
-# Values: Yes or No.  Default: Yes.
-#allow_system_cmd=Yes
-
-# Whether to allow the RM_FILE metacommand (which deletes a file).
-# Set to No to prevent scripts from deleting files.
-# Also controllable via --no-rm-file CLI flag.
-# Values: Yes or No.  Default: Yes.
-#allow_rm_file=Yes
-
-# Whether to allow the SERVE metacommand (which opens an HTTP server on
-# a local port to serve a single file). Set to No to disable.
-# Also controllable via --no-serve CLI flag.
-# Values: Yes or No.  Default: Yes.
-#allow_serve=Yes
-
-# Root directory under which INCLUDE / EXECUTE SCRIPT targets must
-# resolve. When set, attempts to include files outside this root via
-# ../, absolute paths, drive letters, or UNC paths are rejected with
-# an error. Default: no containment (any readable path is permitted).
-#include_root=
-
-# Root directory under which SERVE targets must resolve. Same
-# containment semantics as include_root. Default: no containment.
-#serve_root=
-
-# Root directory under which Jinja2 / string.Template loader paths
-# must resolve. Same containment semantics as include_root.
-# Default: no containment.
-#template_root=
-
-# Maximum byte size of any single substitution-variable expansion,
-# enforced by the substitute_vars() engine to defeat exponential-
-# expansion bombs. Default: 10 MB (10485760).
-#max_substitution_bytes=10485760
-
-# Whether to log all data variable assignments.
-# Values: Yes or No.  Default: Yes.
-#log_datavars=Yes
-
-# Whether to log all executed SQL statements.
-# Values: Yes or No.  Default: No.
-#log_sql=No
-
-# Maximum log file size in MB before rotation. 0 disables rotation.
-# Value: A non-negative integer.  Default: 0.
-#max_log_size_mb=0
-
-# Whether to place execsql.log in the user's home directory instead of the script directory.
-# Values: Yes or No.  Default: No.
-#user_logfile=No
-
-# Seconds between DAO query creation and ODBC data access (MS Access only).
-# Must be >= 5.0.
-#dao_flush_delay_secs=5.0
-
-# Platform-specific additional config files.
-#linux_config_file=
-#macos_config_file=
-#win_config_file=
-
-
-[variables]
-# Substitution variables defined at startup. No pre-defined keys.
-# Example:
-#   output_dir = /data/exports
-#   env_name = production
-
-
-[include_required]
-# Script files to include before the main script (required — error if missing).
-# Keys are integers defining include order; values are file paths.
-# Example:
-#   1 = /opt/execsql/common/setup.sql
-#   2 = /opt/execsql/common/helpers.sql
-
-
-[include_optional]
-# Script files to include before the main script (optional — skipped if missing).
-# Same format as [include_required].
-# Example:
-#   1 = local_overrides.sql