execsql2 2.15.11__tar.gz → 2.16.1__tar.gz

{execsql2-2.15.11 → execsql2-2.16.1}/.gitignore

@@ -46,6 +46,7 @@ _execsql/
 
 # Claude
 .claude/
-ANALYSIS.md
-FINDINGS.md
 CLAUDE.md
+AUDIT.md
+DOC_AUDIT.md
+PROMPTS.md

{execsql2-2.15.11 → execsql2-2.16.1}/CHANGELOG.md

@@ -13,6 +13,84 @@ ______________________________________________________________________
 
 ______________________________________________________________________
 
+## [2.16.1] - 2026-04-30
+
+### Fixed
+
+- AST executor now correctly handles `~` (local) and `+` (outer-scope) substitution variables inside SCRIPT blocks. Previously, `-- !x! SUB ~var value` inside a SCRIPT body would write to a disconnected scope, causing the variable to be invisible to subsequent SQL statements and producing spurious "potential un-substituted variable" warnings. The fix pushes proper `CommandList` frames onto `commandliststack` at script and top-level boundaries, bridging the AST executor with the legacy metacommand handlers (`x_sub`, `x_rm_sub`, `xf_sub_defined`, `SUB_LOCAL`, prompt handlers, REPL `.vars`/`.stack`, etc.).
+- EXECUTE SCRIPT argument expressions (e.g., `val=!!#parent_param!!`) are now expanded in the caller's scope before the child script frame is created, fixing nested script calls that pass `~` or `#` variables as arguments.
+
+### Changed
+
+- `RuntimeContext` is now stored in `threading.local()` instead of a module-level global, making `_state.foo` access thread-safe. Each thread gets its own isolated context via lazy initialization. The `active_context` context manager is now safe for concurrent use across threads. Enables future PARALLEL blocks and concurrent `from execsql import run` calls.
+- `_run()` in `cli/run.py` decomposed into 8 standalone functions: `_seed_early_subvars()`, `_load_config()`, `_seed_script_subvars()`, `_load_script()`, `_apply_dsn()`, `_apply_cli_options()`, `_route_positionals()`, and `_setup_logging()`. Reduces `_run()` from ~380 lines to ~150 lines of orchestration with zero behavioral change.
+
+______________________________________________________________________
+
+## [2.16.0] - 2026-04-29
+
+### Added
+
+- `--parse-tree` CLI flag: parse a script into an Abstract Syntax Tree and print a visual tree structure showing block nesting (IF/LOOP/BATCH/SCRIPT), source line ranges, compound conditions (ANDIF/ORIF), and all metacommands. Requires no database connection or configuration.
+- AST parser module (`execsql.script.parser`) with `parse_script()` and `parse_string()` entry points. Produces a structured `Script` tree with typed nodes for all block constructs (IfBlock, LoopBlock, BatchBlock, ScriptBlock, SqlBlock, IncludeDirective).
+- AST node definitions (`execsql.script.ast`) with `format_tree()` for human-readable tree output.
+- AST-based execution engine is now the default (and only) engine. Scripts are parsed into a tree of typed nodes, then walked for execution. INCLUDE'd files are parsed and executed natively with circular-include detection. Control flow (IF/LOOP/BATCH) is driven by tree structure.
+- `active_context()` context manager in `execsql.state` for installing an isolated `RuntimeContext` as the active global context within a `with` block.
+- Plugin system (`execsql.plugins`) for extending execsql with custom metacommands, export formats, and import formats via Python entry points. Entry point groups: `execsql.metacommands`, `execsql.exporters`, `execsql.importers`. Plugins are discovered automatically at startup.
+- `--list-plugins` CLI flag to show all discovered plugins and exit.
+- Python library API: `from execsql import run` for programmatic script execution from notebooks, pipelines, and applications. Returns a `ScriptResult` with success/failure, command count, timing, errors, and final variable state. Supports DSN connection strings, pre-existing connections, substitution variables, and error control. Full RuntimeContext isolation between calls.
+- AST `Comment` node: the parser now preserves SQL comments in the tree. Consecutive single-line `--` comments are grouped into one node; `/* */` block comments are captured as single nodes. The `--parse-tree` output includes `<CMT>` tagged comment nodes.
+- `--parse-tree` visual improvements: color-coded type tags (`<SQL>`, `<CMD>`, `<CMT>`, `<IF>`, `<LOOP>`, etc.), dimmed line numbers, and content truncation for cleaner output.
+- Deprecation warning emitted when `enc_password` is used in config files, advising users to switch to keyring or environment variables.
+- Sensitive environment variables (`*SECRET*`, `*TOKEN*`, `*PASSWORD*`, etc.) are now filtered from automatic substitution variable exposure.
+
+### Changed
+
+- **Execution engine replaced.** The legacy flat command-list engine has been replaced by the AST-based executor. Scripts are now parsed into a tree of typed nodes and executed by walking the tree. INCLUDE'd files are parsed and executed natively with circular-include detection. All metacommands, SQL, and control flow work identically. This change is transparent to users.
+- **BREAK outside LOOP is now an error.** `BREAK` outside a loop block now raises an error (exit 1) instead of being silently ignored. This catches script bugs that were previously unreported.
+- `--lint` now uses the AST parser for structural validation. Unmatched IF/LOOP/BATCH/SCRIPT blocks are caught at parse time with precise source line ranges. No database connection or runtime state initialization is required. All prior lint checks (variable analysis, INCLUDE file existence, EXECUTE SCRIPT resolution, SUB_INI reading) are preserved.
+- Export format dispatch logic (`EXPORT` and `EXPORT QUERY` metacommands) refactored from duplicated ~180-line if/elif chains into shared `_dispatch_format()` function, eliminating code duplication and fixing missing zip-compatibility checks for `EXPORT QUERY`.
+- `MailSpec.send()` refactored: extracted `_expand()` helper to replace 12 repetitive substitution lines.
+- Default database type changed from Access (`-t a`) to SQLite (`-t l`). Upstream defaulted to Access, which requires Windows and pyodbc. Users targeting Access databases should pass `-t a` explicitly.
+
+### Fixed
+
+- **[Critical]** `WriteSpec.write()` and `MailSpec.send()` error-recovery paths crashed because `SubVarSet.substitute_all()` returns `(str, bool)` but callers treated the return as a plain string. All 14 call sites now unpack the tuple correctly.
+- **[Critical]** Error-recovery fallback in `WriteSpec.write()` and `io_write` called `.encode()` producing bytes passed to `sys.stdout.write()` which expects `str`. Removed the `.encode()` calls.
+- `WriteSpec.write()` no longer crashes with `IndexError` when `commandliststack` is empty during early initialization errors.
+- SQL injection vector in `exec_cmd()` across all 8 database adapters — stored procedure/function/view names are now quoted with `quote_identifier()`.
+- `DSN` and `SQL Server` adapters no longer encode SQL strings to bytes before execution.
+- Duplicate tuple entries in export format checks (`"txt-and"` and `"text-and"` each appeared twice).
+- Database adapters now clear `self.password` after successful connection, reducing credential exposure window.
+- Removed unused `_DEFAULT_CTX = RuntimeContext()` allocation in `state.py`.
+- Version bump commits no longer skip pre-commit hooks (`--no-verify` removed from bumpversion config).
+- `SubVarSet.substitute_all()` now enforces a 100-iteration depth limit to prevent infinite loops from cyclic variable references. The per-statement guard in the executor already had this protection, but direct callers (e.g. config loading) did not.
+- `ConfigData.export_output_dir` is now declared in `__init__` with a default of `None` instead of being dynamically added in the CLI entry point.
+- `Encrypt.ky` key table is now an immutable `MappingProxyType` instead of a mutable class-level dict.
+- `JsonDatatype` attributes are now declared as class variables in the class body instead of assigned externally after class definition.
+- `minimal_conf` test fixture expanded with commonly needed attributes (`import_encoding`, `script_encoding`, `export_output_dir`, `write_prefix`, `write_suffix`, `fold_col_hdrs`, `trim_col_hdrs`, etc.) to reduce ad-hoc attribute additions in individual tests.
+
+### Documentation
+
+- Fixed false `$ENV:` prefix claim in substitution variables reference — feature does not exist.
+- Documented environment variable filtering (SECRET, TOKEN, PASSWORD, etc.) in substitution variables reference.
+- Added missing exporter API docs (markdown, yaml, xlsx) and importer API docs (json).
+- Added 8 missing CLI flags to README Options table (-b, -e, -g, -i, -o, -s, -y, -z).
+- Added missing installation extras ([upsert], [firebird], [oracle]) to README and installation guide.
+- Fixed broken `PROMPT.md` link in logging guide.
+- Added explicit `{ #exampleN }` anchors to all 34 examples for reliable cross-referencing.
+- Updated architecture doc: corrected metacommand count (~225), export format count (20+), added debug/notebook/server/lsp packages to module map.
+- Updated metacommand developer guide to reflect io.py split into io_export.py, io_import.py, io_write.py, io_fileops.py.
+- Noted SQLite as the default database type in syntax reference.
+
+### Removed
+
+- `--ast` / `--no-ast` CLI flag — the AST executor is now the only execution engine; no opt-out.
+- Legacy flat command-list execution engine (`_parse_script_lines`, `read_sqlfile`, `read_sqlstring`, `runscripts`, `ScriptFile`, `CommandListWhileLoop`, `CommandListUntilLoop`, `ScriptExecSpec.execute()`).
+- Legacy `_execute_script_direct()` function and `_execute_include_legacy()` fallback path.
+
+______________________________________________________________________
+
 ## [2.15.11] - 2026-04-27
 
 ### Fixed

{execsql2-2.15.11 → execsql2-2.16.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: execsql2
-Version: 2.15.11
+Version: 2.16.1
 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
@@ -173,7 +173,8 @@ pip install execsql2[oracle]      # Oracle (oracledb)
 pip install execsql2[odbc]        # ODBC DSN (pyodbc)
 
 # Feature bundles
-pip install execsql2[formats]    # ODS, Excel, Jinja2, Feather, Parquet, HDF5
+pip install execsql2[formats]         # ODS, Excel, Jinja2, Feather, Parquet, HDF5
+pip install execsql2[upsert]          # pg-upsert for PostgreSQL upsert operations
 pip install execsql2[auth]            # OS keyring integration
 pip install execsql2[auth-plaintext]  # Keyring + plaintext file backend (headless Linux)
 pip install execsql2[auth-encrypted]  # Keyring + encrypted file backend (headless Linux)
@@ -219,31 +220,41 @@ execsql script.sql                          # read connection from config file
 
 ## Options
 
-| Flag                                | Description                                                     |
-| ----------------------------------- | --------------------------------------------------------------- |
-| `-t {p,m,s,l,k,a,f,o,d}`            | Database type                                                   |
-| `-u USER`                           | Database username                                               |
-| `-p PORT`                           | Server port                                                     |
-| `-a VALUE`                          | Set substitution variable `$ARG_x`                              |
-| `-c SCRIPT`                         | Execute inline SQL or metacommand string                        |
-| `-d`                                | Auto-create export directories                                  |
-| `-f ENCODING`                       | Script file encoding (default: UTF-8)                           |
-| `-l`                                | Write run log to `~/execsql.log`                                |
-| `-m`                                | List metacommands and exit                                      |
-| `-n`                                | Create a new SQLite or PostgreSQL database if it does not exist |
-| `-v {0,1,2,3}`                      | GUI level (0=none, 1=password, 2=selection, 3=full)             |
-| `-w`                                | Skip password prompt when a username is supplied                |
-| `--dsn URL`                         | Connection string (e.g. `postgresql://user:pass@host/db`)       |
-| `--output-dir DIR`                  | Default base directory for EXPORT output files                  |
-| `--dry-run`                         | Parse the script and report commands without executing          |
-| `--lint`                            | Static analysis: check structure and warn on issues (no DB)     |
-| `--ping`                            | Test database connectivity and exit                             |
-| `--profile`                         | Show per-statement timing summary after execution               |
-| `--progress`                        | Show a progress bar for long-running IMPORT operations          |
-| `--config FILE`                     | Load an explicit config file (highest priority after CLI args)  |
-| `--debug`                           | Start in step-through debug mode (REPL pauses before each stmt) |
-| `--dump-keywords`                   | Print metacommand keywords as JSON and exit                     |
-| `--gui-framework {tkinter,textual}` | GUI framework for interactive prompts                           |
+| Flag                                  | Description                                                      |
+| ------------------------------------- | ---------------------------------------------------------------- |
+| `-t {p,m,s,l,k,a,f,o,d}`              | Database type                                                    |
+| `-u USER`                             | Database username                                                |
+| `-p PORT`                             | Server port                                                      |
+| `-a VALUE`                            | Set substitution variable `$ARG_x`                               |
+| `-b` / `--boolean-int`                | Treat integers 0 and 1 as boolean values                         |
+| `-c SCRIPT`                           | Execute inline SQL or metacommand string                         |
+| `-d`                                  | Auto-create export directories                                   |
+| `-e ENCODING` / `--database-encoding` | Character encoding used in the database                          |
+| `-f ENCODING`                         | Script file encoding (default: UTF-8)                            |
+| `-g ENCODING` / `--output-encoding`   | Encoding for WRITE and EXPORT output                             |
+| `-i ENCODING` / `--import-encoding`   | Encoding for data files used with IMPORT                         |
+| `-l`                                  | Write run log to `~/execsql.log`                                 |
+| `-m`                                  | List metacommands and exit                                       |
+| `-n`                                  | Create a new SQLite or PostgreSQL database if it does not exist  |
+| `-o` / `--online-help`                | Open the online documentation in the default browser             |
+| `-s N` / `--scan-lines`               | Lines to scan for IMPORT format detection (0 = scan entire file) |
+| `-v {0,1,2,3}`                        | GUI level (0=none, 1=password, 2=selection, 3=full)              |
+| `-w`                                  | Skip password prompt when a username is supplied                 |
+| `-y` / `--encodings`                  | List available encoding names and exit                           |
+| `-z KB` / `--import-buffer`           | Import buffer size in KB (default: 32)                           |
+| `--dsn URL`                           | Connection string (e.g. `postgresql://user:pass@host/db`)        |
+| `--output-dir DIR`                    | Default base directory for EXPORT output files                   |
+| `--dry-run`                           | Parse the script and report commands without executing           |
+| `--lint`                              | Static analysis: check structure and warn on issues (no DB)      |
+| `--parse-tree`                        | Print the script's AST structure and exit (no DB)                |
+| `--list-plugins`                      | List discovered plugins and exit                                 |
+| `--ping`                              | Test database connectivity and exit                              |
+| `--profile`                           | Show per-statement timing summary after execution                |
+| `--progress`                          | Show a progress bar for long-running IMPORT operations           |
+| `--config FILE`                       | Load an explicit config file (highest priority after CLI args)   |
+| `--debug`                             | Start in step-through debug mode (REPL pauses before each stmt)  |
+| `--dump-keywords`                     | Print metacommand keywords as JSON and exit                      |
+| `--gui-framework {tkinter,textual}`   | GUI framework for interactive prompts                            |
 
 Run `execsql --help` for the full option list, or `execsql -m` to list all metacommands.
 
@@ -260,6 +271,61 @@ Run `execsql --help` for the full option list, or `execsql -m` to list all metac
 - Display query results in a GUI dialog; optionally prompt the user to select a row, enter a value, or submit a form.
 - Write status messages or tabular output to the console or a file during execution.
 - Automatically log each run, recording databases used, scripts executed, and user responses.
+- Extend with custom metacommands, exporters, and importers via the plugin system.
+
+# Library API
+
+execsql can be used as a Python library for programmatic script execution:
+
+```python
+from execsql import run
+
+# Execute a script file
+result = run(script="pipeline.sql", dsn="postgresql://user:pass@host/db")
+
+# Execute inline SQL
+result = run(
+    sql="CREATE TABLE t (id INT);\nINSERT INTO t VALUES (1);",
+    dsn="sqlite:///my.db",
+    new_db=True,
+)
+
+# With substitution variables
+result = run(
+    script="etl.sql",
+    dsn="sqlite:///data.db",
+    variables={"SCHEMA": "public", "DATE": "2026-01-01"},
+)
+
+# Check results
+print(result.success)       # True
+print(result.commands_run)  # 2
+print(result.elapsed)       # 0.003 (seconds)
+print(result.variables)     # {"SCHEMA": "public", ...}
+```
+
+Error handling:
+
+```python
+result = run(sql="SELECT * FROM nonexistent;", dsn="sqlite:///:memory:")
+if not result.success:
+    for err in result.errors:
+        print(f"{err.source}:{err.line}: {err.message}")
+
+# Or raise on failure
+result.raise_on_error()  # raises ExecSqlError
+```
+
+Use a pre-existing database connection instead of a DSN:
+
+```python
+from execsql.db.factory import db_SQLite
+conn = db_SQLite("my.db", new_db=True)
+result = run(sql="SELECT 1;", connection=conn)
+# run() does NOT close this connection — you manage its lifecycle
+```
+
+Each call to `run()` uses an isolated `RuntimeContext`, so multiple calls do not share state.
 
 # An Illustration
 

{execsql2-2.15.11 → execsql2-2.16.1}/README.md

@@ -51,7 +51,8 @@ pip install execsql2[oracle]      # Oracle (oracledb)
 pip install execsql2[odbc]        # ODBC DSN (pyodbc)
 
 # Feature bundles
-pip install execsql2[formats]    # ODS, Excel, Jinja2, Feather, Parquet, HDF5
+pip install execsql2[formats]         # ODS, Excel, Jinja2, Feather, Parquet, HDF5
+pip install execsql2[upsert]          # pg-upsert for PostgreSQL upsert operations
 pip install execsql2[auth]            # OS keyring integration
 pip install execsql2[auth-plaintext]  # Keyring + plaintext file backend (headless Linux)
 pip install execsql2[auth-encrypted]  # Keyring + encrypted file backend (headless Linux)
@@ -97,31 +98,41 @@ execsql script.sql                          # read connection from config file
 
 ## Options
 
-| Flag                                | Description                                                     |
-| ----------------------------------- | --------------------------------------------------------------- |
-| `-t {p,m,s,l,k,a,f,o,d}`            | Database type                                                   |
-| `-u USER`                           | Database username                                               |
-| `-p PORT`                           | Server port                                                     |
-| `-a VALUE`                          | Set substitution variable `$ARG_x`                              |
-| `-c SCRIPT`                         | Execute inline SQL or metacommand string                        |
-| `-d`                                | Auto-create export directories                                  |
-| `-f ENCODING`                       | Script file encoding (default: UTF-8)                           |
-| `-l`                                | Write run log to `~/execsql.log`                                |
-| `-m`                                | List metacommands and exit                                      |
-| `-n`                                | Create a new SQLite or PostgreSQL database if it does not exist |
-| `-v {0,1,2,3}`                      | GUI level (0=none, 1=password, 2=selection, 3=full)             |
-| `-w`                                | Skip password prompt when a username is supplied                |
-| `--dsn URL`                         | Connection string (e.g. `postgresql://user:pass@host/db`)       |
-| `--output-dir DIR`                  | Default base directory for EXPORT output files                  |
-| `--dry-run`                         | Parse the script and report commands without executing          |
-| `--lint`                            | Static analysis: check structure and warn on issues (no DB)     |
-| `--ping`                            | Test database connectivity and exit                             |
-| `--profile`                         | Show per-statement timing summary after execution               |
-| `--progress`                        | Show a progress bar for long-running IMPORT operations          |
-| `--config FILE`                     | Load an explicit config file (highest priority after CLI args)  |
-| `--debug`                           | Start in step-through debug mode (REPL pauses before each stmt) |
-| `--dump-keywords`                   | Print metacommand keywords as JSON and exit                     |
-| `--gui-framework {tkinter,textual}` | GUI framework for interactive prompts                           |
+| Flag                                  | Description                                                      |
+| ------------------------------------- | ---------------------------------------------------------------- |
+| `-t {p,m,s,l,k,a,f,o,d}`              | Database type                                                    |
+| `-u USER`                             | Database username                                                |
+| `-p PORT`                             | Server port                                                      |
+| `-a VALUE`                            | Set substitution variable `$ARG_x`                               |
+| `-b` / `--boolean-int`                | Treat integers 0 and 1 as boolean values                         |
+| `-c SCRIPT`                           | Execute inline SQL or metacommand string                         |
+| `-d`                                  | Auto-create export directories                                   |
+| `-e ENCODING` / `--database-encoding` | Character encoding used in the database                          |
+| `-f ENCODING`                         | Script file encoding (default: UTF-8)                            |
+| `-g ENCODING` / `--output-encoding`   | Encoding for WRITE and EXPORT output                             |
+| `-i ENCODING` / `--import-encoding`   | Encoding for data files used with IMPORT                         |
+| `-l`                                  | Write run log to `~/execsql.log`                                 |
+| `-m`                                  | List metacommands and exit                                       |
+| `-n`                                  | Create a new SQLite or PostgreSQL database if it does not exist  |
+| `-o` / `--online-help`                | Open the online documentation in the default browser             |
+| `-s N` / `--scan-lines`               | Lines to scan for IMPORT format detection (0 = scan entire file) |
+| `-v {0,1,2,3}`                        | GUI level (0=none, 1=password, 2=selection, 3=full)              |
+| `-w`                                  | Skip password prompt when a username is supplied                 |
+| `-y` / `--encodings`                  | List available encoding names and exit                           |
+| `-z KB` / `--import-buffer`           | Import buffer size in KB (default: 32)                           |
+| `--dsn URL`                           | Connection string (e.g. `postgresql://user:pass@host/db`)        |
+| `--output-dir DIR`                    | Default base directory for EXPORT output files                   |
+| `--dry-run`                           | Parse the script and report commands without executing           |
+| `--lint`                              | Static analysis: check structure and warn on issues (no DB)      |
+| `--parse-tree`                        | Print the script's AST structure and exit (no DB)                |
+| `--list-plugins`                      | List discovered plugins and exit                                 |
+| `--ping`                              | Test database connectivity and exit                              |
+| `--profile`                           | Show per-statement timing summary after execution                |
+| `--progress`                          | Show a progress bar for long-running IMPORT operations           |
+| `--config FILE`                       | Load an explicit config file (highest priority after CLI args)   |
+| `--debug`                             | Start in step-through debug mode (REPL pauses before each stmt)  |
+| `--dump-keywords`                     | Print metacommand keywords as JSON and exit                      |
+| `--gui-framework {tkinter,textual}`   | GUI framework for interactive prompts                            |
 
 Run `execsql --help` for the full option list, or `execsql -m` to list all metacommands.
 
@@ -138,6 +149,61 @@ Run `execsql --help` for the full option list, or `execsql -m` to list all metac
 - Display query results in a GUI dialog; optionally prompt the user to select a row, enter a value, or submit a form.
 - Write status messages or tabular output to the console or a file during execution.
 - Automatically log each run, recording databases used, scripts executed, and user responses.
+- Extend with custom metacommands, exporters, and importers via the plugin system.
+
+# Library API
+
+execsql can be used as a Python library for programmatic script execution:
+
+```python
+from execsql import run
+
+# Execute a script file
+result = run(script="pipeline.sql", dsn="postgresql://user:pass@host/db")
+
+# Execute inline SQL
+result = run(
+    sql="CREATE TABLE t (id INT);\nINSERT INTO t VALUES (1);",
+    dsn="sqlite:///my.db",
+    new_db=True,
+)
+
+# With substitution variables
+result = run(
+    script="etl.sql",
+    dsn="sqlite:///data.db",
+    variables={"SCHEMA": "public", "DATE": "2026-01-01"},
+)
+
+# Check results
+print(result.success)       # True
+print(result.commands_run)  # 2
+print(result.elapsed)       # 0.003 (seconds)
+print(result.variables)     # {"SCHEMA": "public", ...}
+```
+
+Error handling:
+
+```python
+result = run(sql="SELECT * FROM nonexistent;", dsn="sqlite:///:memory:")
+if not result.success:
+    for err in result.errors:
+        print(f"{err.source}:{err.line}: {err.message}")
+
+# Or raise on failure
+result.raise_on_error()  # raises ExecSqlError
+```
+
+Use a pre-existing database connection instead of a DSN:
+
+```python
+from execsql.db.factory import db_SQLite
+conn = db_SQLite("my.db", new_db=True)
+result = run(sql="SELECT 1;", connection=conn)
+# run() does NOT close this connection — you manage its lifecycle
+```
+
+Each call to `run()` uses an isolated `RuntimeContext`, so multiple calls do not share state.
 
 # An Illustration
 

{execsql2-2.15.11 → execsql2-2.16.1}/docs/about/contributors.md

@@ -1,4 +1,7 @@
 # Contributors
 
+R. Dreas Nielsen
+:   Original author of [execsql](https://execsql.readthedocs.io/) (v1.0 through v1.130.1). Designed and implemented the metacommand language, substitution variable system, database adapters, export/import framework, GUI prompt system, and all core functionality that execsql2 is built on.
+
 Elizabeth Shea
 :   Brainstorming, testing, coding of the conditional expression parser, coding of the 'with arguments' and 'with parameters' clauses of the [SCRIPT](../reference/metacommands.md#beginscript) metacommand, coding of the WHILE and UNTIL clauses of the [EXECUTE SCRIPT](../reference/metacommands.md#executescript) metacommand, coding of [deferred variable substitution](../reference/substitution_vars.md#deferred_substitution), corrections to the [PROMPT ENTRY_FORM](../reference/metacommands.md#prompt_entry) metacommand, examples, implementation of the ["+" prefix](../reference/substitution_vars.md#outer_scope_referent) for substitution variables, and other minor corrections.