plsqlwks 0.1.9.3__tar.gz → 0.2.1__tar.gz

{plsqlwks-0.1.9.3 → plsqlwks-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.1.9.3
+Version: 0.2.1
 Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
 Author: unu2000
 License-Expression: LicenseRef-plsqlwks-Donationware
@@ -98,6 +98,55 @@ protect it with `chmod 600`.
 `PLSQLWKS_ARRAYSIZE` sets the Oracle cursor array size. Both values must be
 positive integers.
 
+### Oracle Thin and Thick modes
+
+Thin mode is the default and needs no Oracle Client installation. To use an
+installed Oracle Client, start with `plsqlwks --thick`. Use `plsqlwks --thin` to
+override a workspace's thick preference for one invocation. The flags are
+mutually exclusive and are never saved to configuration.
+
+For a persistent preference, edit the selected workspace's `config.ini` (or the
+platform configuration file when using the default workspace):
+
+```ini
+[database]
+thick_mode = no
+oracle_client_lib_dir =
+oracle_client_config_dir =
+```
+
+Set `thick_mode = yes` to enable Thick mode. Invalid boolean values are errors.
+Both optional directories expand `~`; relative paths are resolved from the
+configuration file's directory. Blank values use Oracle's normal discovery.
+The directory settings are used only in Thick mode. All tabs and reconnects
+share one driver mode; restart after changing mode or client settings.
+
+Install an Oracle Instant Client **Basic** or **Basic Light** package compatible
+with your Python architecture, python-oracledb version, and database. Libraries
+are installed separately and are not bundled with PLSQLWKS. On Linux, normally
+leave `oracle_client_lib_dir` blank and configure `ldconfig` or `LD_LIBRARY_PATH`
+**before** launching Python. Setting that directory alone does not configure
+Linux's dependent-library search path. On macOS, an explicit library directory
+can be useful. When running through SSH or WSL, install the libraries where the
+Python process runs. For a full Oracle Client installation, configure its
+Oracle environment before launch.
+
+`oracle_client_config_dir` selects the directory containing Oracle network
+configuration such as `sqlnet.ora` and `tnsnames.ora`; when blank, Oracle uses
+its normal lookup, including `TNS_ADMIN`. Native network encryption is configured
+through Oracle Client's `sqlnet.ora` and the server's matching requirements.
+The existing `ORACLE_USER`, `ORACLE_DSN`, and password-file authentication remain
+in use. See the [Oracle Client initialization guide](https://python-oracledb.readthedocs.io/en/v3.4.2/user_guide/initialization.html)
+for platform setup and the [compatibility contract](doc/COMPATIBILITY.md) for
+validated combinations.
+
+Client-loading failures such as `DPI-1047` stop startup before the terminal UI,
+with no automatic fallback. Check library architecture, required system
+libraries, and the pre-launch library search path. Mode conflicts or changed
+initialization arguments require a process restart. Successful connection status
+includes `Thin mode` or `Thick mode`. Help, version, and plugin management commands
+do not initialize Oracle Client libraries.
+
 ## Install
 
 Python 3.10 or newer is required, along with a compatible terminal and a Python
@@ -488,6 +537,149 @@ plsqlwks and asks whether to overwrite it, save under another name, or cancel.
 Undo and redo update the unsaved-change marker by comparing the current content
 with the last successful save.
 
+## Windows PuTTY keyboard setup
+
+For Windows PuTTY 0.83 and 0.85, use a saved session with these settings before
+starting plsqlwks on the Linux/Unix host:
+
+| PuTTY panel | Setting |
+| --- | --- |
+| Connection → Data | Terminal-type string: `xterm-256color` |
+| Window → Translation | Remote character set: `UTF-8` |
+| Terminal → Keyboard | Backspace: `Control-? (127)`; Home/End: `Standard` |
+| Terminal → Keyboard | Function keys and keypad: `Xterm 216+` |
+| Terminal → Keyboard | Shifted arrow keys: `xterm-style bitmap` |
+| Terminal → Keyboard | Keep **Control-Alt is different from AltGr** enabled |
+| Terminal → Features | Enable **Disable application cursor keys mode** and **Disable application keypad mode** |
+| Terminal → Features | Leave **Disable bracketed paste mode** unchecked |
+| Terminal | Local echo and local line editing: `Force off` |
+
+Save the session and use a UTF-8 locale on the host. Disabling application cursor
+keys is necessary because curses enables that mode, and PuTTY otherwise drops
+arrow modifiers even when bitmap mode is selected.
+
+### Exact Ctrl shortcuts with the Windows helper
+
+Stock Windows PuTTY does not send Ctrl-Home/End, Ctrl-Shift-Home/End, or
+Ctrl-Delete at all, and consumes modified PageUp/PageDown for scrollback.
+Use the optional [Windows helper](tools/putty_keys.ps1) to make the original
+shortcuts work. Run it on the **Windows computer running PuTTY**; from a checkout:
+
+```powershell
+powershell.exe -NoProfile -File .\tools\putty_keys.ps1
+```
+
+Focus the PuTTY window running plsqlwks, then press **Ctrl-Alt-F12** to enable
+remapping for that window. The helper console confirms activation. It remaps
+one selected PuTTY window while the helper is running. Press Ctrl-Alt-F12 again
+to disable it before using another program in that terminal, or press Ctrl-C
+in the helper console to stop it. Enabling a different PuTTY window switches
+the selection to that window.
+
+With the helper enabled, `Ctrl-Home` / `Ctrl-End` move to the beginning/end of
+the editor buffer or the first/last result row. `Ctrl-Shift-Home` /
+`Ctrl-Shift-End` select to buffer boundaries. The helper also restores
+`Ctrl-Delete`, `Ctrl-Backspace`, `Ctrl-Enter`, `Ctrl-PageUp` / `Ctrl-PageDown`,
+`Shift-PageUp` / `Shift-PageDown`, and `Ctrl+=`. Plain Enter and Backspace keep
+their normal meaning. The helper requires only Windows PowerShell and its
+included .NET runtime; it requires no administrator rights or installation.
+Run the same command with `-SelfTest` to check its mappings without enabling it.
+
+### Alternatives without the helper
+
+Some physical combinations cannot reach plsqlwks distinctly in stock Windows
+PuTTY. Use the following alternatives; they also work in terminals that send
+these sequences, and the original bindings remain available elsewhere:
+
+| Existing shortcut | PuTTY alternative | Action |
+| --- | --- | --- |
+| `Ctrl-Home` / `Ctrl-End` | `Alt-Home` / `Alt-End` | Editor buffer start/end; first/last result row |
+| `Ctrl-Shift-Home` / `Ctrl-Shift-End` | `Alt-Shift-Home` / `Alt-Shift-End` | Select to editor buffer boundaries |
+| `Ctrl-Delete` | `Alt-Delete` | Delete next word |
+| `Ctrl-Enter` | `F5` or `Alt-X` | Execute selection/current statement |
+| `Ctrl-PageUp` / `Ctrl-PageDown` | `Alt-PageUp` / `Alt-PageDown` | Page focused results; otherwise switch file tabs |
+| `Shift-PageUp` / `Shift-PageDown` | `Ctrl-Shift-Up` / `Ctrl-Shift-Down` | Extend editor selection by page |
+| `Ctrl-Backspace` | `Alt-Backspace` | Delete previous word |
+| `Ctrl+=` | `Alt-O` → **Database** → **Reconnect** | Reconnect |
+
+PuTTY sends the same carriage return for Enter and Ctrl-Enter, and the same
+DEL byte for Backspace and Ctrl-Backspace. plsqlwks preserves newline and
+single-character deletion for those bytes. PuTTY consumes Ctrl/Shift-PageUp
+and PageDown for its own scrollback; changing the function-key setting does
+not free them. See the [PuTTY keyboard settings](https://the.earth.li/~sgtatham/putty/0.85/htmldoc/Chapter4.html#config-keyboard)
+and [scrollback shortcuts](https://the.earth.li/~sgtatham/putty/0.85/htmldoc/Chapter3.html#using-scrollback).
+
+Use left Alt for application shortcuts; AltGr remains available for characters
+on international keyboards. Shortcut digits and symbols refer to the character
+on the active Windows layout: for example, Czech top-row digits need Shift,
+so Alt-1 is typed with Alt-Shift-1. Use the layout's `+` or `=` character for
+autocomplete refresh. `Ctrl-C`, `Ctrl-X`, and `Ctrl-V` operate on the
+application/host clipboard with the existing internal fallback. SSH does not
+make that the Windows clipboard. Use PuTTY's native paste (`Shift-Insert` or
+right-click) to insert Windows clipboard text as bracketed paste, and PuTTY
+mouse selection to copy to Windows. Leave plsqlwks' Ctrl-letter shortcuts
+available to the server when customizing PuTTY clipboard settings.
+
+For troubleshooting, run `python3 rchar.py` from the checkout in the same PuTTY
+session to capture a key's actual bytes. Verify the session settings above
+before reporting a shortcut failure.
+
+## Windows Command Prompt keyboard setup
+
+Use plsqlwks through `ssh.exe` or WSL inside **Command Prompt (`cmd.exe`)**.
+The helper supports both the classic Windows console and Command Prompt hosted
+by Windows Terminal. plsqlwks itself runs on the Linux/Unix host or inside WSL,
+where Python provides curses.
+
+In one Command Prompt window, connect to the host or start WSL:
+
+```bat
+ssh user@host
+```
+
+or:
+
+```bat
+wsl.exe
+```
+
+Then run the installed application in that Linux/Unix shell:
+
+```sh
+TERM=xterm-256color plsqlwks
+```
+
+In a **second Command Prompt window**, start the Windows helper from the checkout:
+
+```bat
+tools\windows_keys.cmd
+```
+
+Keep that helper window open. Focus the terminal running plsqlwks and press
+**Ctrl-Alt-F12**; the helper confirms activation. The original shortcuts now
+reach the application, including **Ctrl-Home/End**, **Ctrl-Shift-Home/End**,
+modified arrows, word deletion, execution, paging, and `Ctrl+=`. `F11` executes
+the script instead of switching Windows Terminal to fullscreen.
+
+Use a dedicated terminal window for plsqlwks. The helper selects a window, so
+disable it with Ctrl-Alt-F12 before switching that window to another tab, pane,
+or program. Press Ctrl-C in the helper window to stop it. Left Alt is used for
+shortcuts; AltGr remains available for typing. Leave the classic console's
+**Use legacy console** option off. Use a UTF-8 locale on the Linux/Unix host.
+
+For Windows Terminal, set `"altGrAliasing": false` in the Command Prompt
+profile in its JSON settings. This keeps left Ctrl-Alt-C/R available for
+commit/rollback on international keyboards while preserving the real AltGr
+key. See Microsoft's [AltGr aliasing setting](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/profile-advanced#altgr-aliasing).
+
+The `.cmd` launcher uses the included Windows PowerShell runtime and applies
+its script execution policy only to that helper process. No administrator
+rights, installation, or permanent policy change is needed. Keep
+`windows_keys.cmd` and `putty_keys.ps1` together when copying them elsewhere.
+Run `tools\windows_keys.cmd -SelfTest` to check the helper without enabling it.
+The original `powershell.exe -NoProfile -File .\tools\putty_keys.ps1` command
+also works from Command Prompt and continues to support PuTTY.
+
 ## Keys
 
 ### Global
@@ -707,15 +899,27 @@ period; DATE and TIMESTAMP input uses ISO
 Character and CLOB input is preserved as entered. Types that cannot be compared
 without losing information, including time-zone timestamps and timestamps with
 precision above six, are read-only in the grid.
-In python-oracledb Thin mode, non-null `TIMESTAMP WITH TIME ZONE` and
-`TIMESTAMP WITH LOCAL TIME ZONE` values are shown and exported as explicit
-lossless-fetch-unavailable markers instead of misleading naive datetimes. Use
-an explicit `TO_CHAR` expression with the required precision and zone fields
-when the exact value is needed; named-zone timestamps are not supported by the
-current Thin driver.
+In both driver modes, ordinary SELECT/WITH queries format zoned timestamps on
+Oracle to preserve their zone and fractional precision. Query forms that cannot
+use this projection show explicit lossless-fetch-unavailable markers for
+non-null zoned values on the native fetch path. Use an explicit `TO_CHAR`
+expression with the required precision and zone fields for those query forms.
 Displayed CLOB and BLOB values are limited to the first 65,536 characters or
 bytes and include a truncation marker with the full size. Truncated LOB cells
 cannot be edited safely. Schema-browser DDL is always read in full.
+To copy DBMS_OUTPUT, show it with **F6** and focus it with **Tab**. Use
+**Shift+navigation** to select text and **Ctrl+C** to copy; **Ctrl+A** selects
+all output. **Alt-O -> Results -> Copy all DBMS_OUTPUT** also copies the whole
+buffer while another pane is focused. Tab/Esc returns to the editor. Home/End
+move within a displayed line; Ctrl+Home/End move to the output boundaries.
+
+Copying preserves the stored text, whitespace, blank lines, and statement
+headings, without screen wrapping or padding. The existing system clipboard
+providers are used when available, with the internal clipboard as a fallback
+(including remote PuTTY sessions). Ctrl+C still cancels a running operation
+before performing a copy. Selection belongs to its file tab, survives appended
+output and resizing, and resets when execution replaces the output.
+
 DBMS_OUTPUT is collected after each statement and after every fetched result
 page without replacing a real query grid. Output-read or cursor-cleanup failures
 are displayed as warnings while preserving successfully fetched rows. PL/SQL
@@ -980,6 +1184,39 @@ lifecycle change requires a restart. See the
 [managed-package guide](https://gitlab.com/unununu/plsqlwks/-/blob/main/doc/PLUGINS.md#managed-plugin-packages)
 for the exact manifest, source layout, validation, replacement, and trust rules.
 
+### Table DDL Export
+
+Install `plugins/packages/table-ddl-export-0.1.1.plwgn` with
+`plsqlwks plugin install` and restart. **Alt-O -> Database -> Export table DDL**
+lets you choose a schema, filter table names as you type, select tables, and
+optionally remap them to another schema. It automatically includes related
+sequences and directly referencing packages, functions, procedures, and views, and follows
+required source-schema tables and views recursively. Definitions, constraints, indexes,
+foreign keys and triggers are ordered by creation dependencies in a new
+unsaved SQL tab for review. Generation activates that tab and focuses its editor.
+See the [selection keys and remapping details](doc/PLUGIN_CATALOG.md#table-ddl-export).
+
+### Dependencies walker
+
+Install the optional dependency browser and restart PLSQLWKS:
+
+```bash
+plsqlwks plugin install plugins/packages/dependencies-walker-0.1.0.plwgn
+```
+
+Choose **Alt-O -> Database -> Dependencies walker** and enter an object name,
+optionally qualified by schema. Expand with Enter/Right, collapse with Left,
+and use **D** (Depends on) or **U** (Used by) to follow the selected object in
+either direction. Backspace restores the previous tree; **R** refreshes and
+Esc closes. Packages combine specification/body relationships with labels.
+
+The walker reads only visible Oracle-recorded dependencies, loads branches
+on demand, marks cycles, and leaves database-link references unexpanded.
+Dynamic SQL and foreign-key graphs are outside this view. See the
+[plugin catalog](https://gitlab.com/unununu/plsqlwks/-/blob/main/doc/PLUGIN_CATALOG.md#dependencies-walker)
+for all controls and installation details. No additional runtime dependency is
+required.
+
 ### Maintained csv2oratab integration
 
 The maintained `csv2oratab-0.1.0.plwgn` catalog package adds **Alt-O -> Data ->

{plsqlwks-0.1.9.3 → plsqlwks-0.2.1}/README.md

@@ -64,6 +64,55 @@ protect it with `chmod 600`.
 `PLSQLWKS_ARRAYSIZE` sets the Oracle cursor array size. Both values must be
 positive integers.
 
+### Oracle Thin and Thick modes
+
+Thin mode is the default and needs no Oracle Client installation. To use an
+installed Oracle Client, start with `plsqlwks --thick`. Use `plsqlwks --thin` to
+override a workspace's thick preference for one invocation. The flags are
+mutually exclusive and are never saved to configuration.
+
+For a persistent preference, edit the selected workspace's `config.ini` (or the
+platform configuration file when using the default workspace):
+
+```ini
+[database]
+thick_mode = no
+oracle_client_lib_dir =
+oracle_client_config_dir =
+```
+
+Set `thick_mode = yes` to enable Thick mode. Invalid boolean values are errors.
+Both optional directories expand `~`; relative paths are resolved from the
+configuration file's directory. Blank values use Oracle's normal discovery.
+The directory settings are used only in Thick mode. All tabs and reconnects
+share one driver mode; restart after changing mode or client settings.
+
+Install an Oracle Instant Client **Basic** or **Basic Light** package compatible
+with your Python architecture, python-oracledb version, and database. Libraries
+are installed separately and are not bundled with PLSQLWKS. On Linux, normally
+leave `oracle_client_lib_dir` blank and configure `ldconfig` or `LD_LIBRARY_PATH`
+**before** launching Python. Setting that directory alone does not configure
+Linux's dependent-library search path. On macOS, an explicit library directory
+can be useful. When running through SSH or WSL, install the libraries where the
+Python process runs. For a full Oracle Client installation, configure its
+Oracle environment before launch.
+
+`oracle_client_config_dir` selects the directory containing Oracle network
+configuration such as `sqlnet.ora` and `tnsnames.ora`; when blank, Oracle uses
+its normal lookup, including `TNS_ADMIN`. Native network encryption is configured
+through Oracle Client's `sqlnet.ora` and the server's matching requirements.
+The existing `ORACLE_USER`, `ORACLE_DSN`, and password-file authentication remain
+in use. See the [Oracle Client initialization guide](https://python-oracledb.readthedocs.io/en/v3.4.2/user_guide/initialization.html)
+for platform setup and the [compatibility contract](doc/COMPATIBILITY.md) for
+validated combinations.
+
+Client-loading failures such as `DPI-1047` stop startup before the terminal UI,
+with no automatic fallback. Check library architecture, required system
+libraries, and the pre-launch library search path. Mode conflicts or changed
+initialization arguments require a process restart. Successful connection status
+includes `Thin mode` or `Thick mode`. Help, version, and plugin management commands
+do not initialize Oracle Client libraries.
+
 ## Install
 
 Python 3.10 or newer is required, along with a compatible terminal and a Python
@@ -454,6 +503,149 @@ plsqlwks and asks whether to overwrite it, save under another name, or cancel.
 Undo and redo update the unsaved-change marker by comparing the current content
 with the last successful save.
 
+## Windows PuTTY keyboard setup
+
+For Windows PuTTY 0.83 and 0.85, use a saved session with these settings before
+starting plsqlwks on the Linux/Unix host:
+
+| PuTTY panel | Setting |
+| --- | --- |
+| Connection → Data | Terminal-type string: `xterm-256color` |
+| Window → Translation | Remote character set: `UTF-8` |
+| Terminal → Keyboard | Backspace: `Control-? (127)`; Home/End: `Standard` |
+| Terminal → Keyboard | Function keys and keypad: `Xterm 216+` |
+| Terminal → Keyboard | Shifted arrow keys: `xterm-style bitmap` |
+| Terminal → Keyboard | Keep **Control-Alt is different from AltGr** enabled |
+| Terminal → Features | Enable **Disable application cursor keys mode** and **Disable application keypad mode** |
+| Terminal → Features | Leave **Disable bracketed paste mode** unchecked |
+| Terminal | Local echo and local line editing: `Force off` |
+
+Save the session and use a UTF-8 locale on the host. Disabling application cursor
+keys is necessary because curses enables that mode, and PuTTY otherwise drops
+arrow modifiers even when bitmap mode is selected.
+
+### Exact Ctrl shortcuts with the Windows helper
+
+Stock Windows PuTTY does not send Ctrl-Home/End, Ctrl-Shift-Home/End, or
+Ctrl-Delete at all, and consumes modified PageUp/PageDown for scrollback.
+Use the optional [Windows helper](tools/putty_keys.ps1) to make the original
+shortcuts work. Run it on the **Windows computer running PuTTY**; from a checkout:
+
+```powershell
+powershell.exe -NoProfile -File .\tools\putty_keys.ps1
+```
+
+Focus the PuTTY window running plsqlwks, then press **Ctrl-Alt-F12** to enable
+remapping for that window. The helper console confirms activation. It remaps
+one selected PuTTY window while the helper is running. Press Ctrl-Alt-F12 again
+to disable it before using another program in that terminal, or press Ctrl-C
+in the helper console to stop it. Enabling a different PuTTY window switches
+the selection to that window.
+
+With the helper enabled, `Ctrl-Home` / `Ctrl-End` move to the beginning/end of
+the editor buffer or the first/last result row. `Ctrl-Shift-Home` /
+`Ctrl-Shift-End` select to buffer boundaries. The helper also restores
+`Ctrl-Delete`, `Ctrl-Backspace`, `Ctrl-Enter`, `Ctrl-PageUp` / `Ctrl-PageDown`,
+`Shift-PageUp` / `Shift-PageDown`, and `Ctrl+=`. Plain Enter and Backspace keep
+their normal meaning. The helper requires only Windows PowerShell and its
+included .NET runtime; it requires no administrator rights or installation.
+Run the same command with `-SelfTest` to check its mappings without enabling it.
+
+### Alternatives without the helper
+
+Some physical combinations cannot reach plsqlwks distinctly in stock Windows
+PuTTY. Use the following alternatives; they also work in terminals that send
+these sequences, and the original bindings remain available elsewhere:
+
+| Existing shortcut | PuTTY alternative | Action |
+| --- | --- | --- |
+| `Ctrl-Home` / `Ctrl-End` | `Alt-Home` / `Alt-End` | Editor buffer start/end; first/last result row |
+| `Ctrl-Shift-Home` / `Ctrl-Shift-End` | `Alt-Shift-Home` / `Alt-Shift-End` | Select to editor buffer boundaries |
+| `Ctrl-Delete` | `Alt-Delete` | Delete next word |
+| `Ctrl-Enter` | `F5` or `Alt-X` | Execute selection/current statement |
+| `Ctrl-PageUp` / `Ctrl-PageDown` | `Alt-PageUp` / `Alt-PageDown` | Page focused results; otherwise switch file tabs |
+| `Shift-PageUp` / `Shift-PageDown` | `Ctrl-Shift-Up` / `Ctrl-Shift-Down` | Extend editor selection by page |
+| `Ctrl-Backspace` | `Alt-Backspace` | Delete previous word |
+| `Ctrl+=` | `Alt-O` → **Database** → **Reconnect** | Reconnect |
+
+PuTTY sends the same carriage return for Enter and Ctrl-Enter, and the same
+DEL byte for Backspace and Ctrl-Backspace. plsqlwks preserves newline and
+single-character deletion for those bytes. PuTTY consumes Ctrl/Shift-PageUp
+and PageDown for its own scrollback; changing the function-key setting does
+not free them. See the [PuTTY keyboard settings](https://the.earth.li/~sgtatham/putty/0.85/htmldoc/Chapter4.html#config-keyboard)
+and [scrollback shortcuts](https://the.earth.li/~sgtatham/putty/0.85/htmldoc/Chapter3.html#using-scrollback).
+
+Use left Alt for application shortcuts; AltGr remains available for characters
+on international keyboards. Shortcut digits and symbols refer to the character
+on the active Windows layout: for example, Czech top-row digits need Shift,
+so Alt-1 is typed with Alt-Shift-1. Use the layout's `+` or `=` character for
+autocomplete refresh. `Ctrl-C`, `Ctrl-X`, and `Ctrl-V` operate on the
+application/host clipboard with the existing internal fallback. SSH does not
+make that the Windows clipboard. Use PuTTY's native paste (`Shift-Insert` or
+right-click) to insert Windows clipboard text as bracketed paste, and PuTTY
+mouse selection to copy to Windows. Leave plsqlwks' Ctrl-letter shortcuts
+available to the server when customizing PuTTY clipboard settings.
+
+For troubleshooting, run `python3 rchar.py` from the checkout in the same PuTTY
+session to capture a key's actual bytes. Verify the session settings above
+before reporting a shortcut failure.
+
+## Windows Command Prompt keyboard setup
+
+Use plsqlwks through `ssh.exe` or WSL inside **Command Prompt (`cmd.exe`)**.
+The helper supports both the classic Windows console and Command Prompt hosted
+by Windows Terminal. plsqlwks itself runs on the Linux/Unix host or inside WSL,
+where Python provides curses.
+
+In one Command Prompt window, connect to the host or start WSL:
+
+```bat
+ssh user@host
+```
+
+or:
+
+```bat
+wsl.exe
+```
+
+Then run the installed application in that Linux/Unix shell:
+
+```sh
+TERM=xterm-256color plsqlwks
+```
+
+In a **second Command Prompt window**, start the Windows helper from the checkout:
+
+```bat
+tools\windows_keys.cmd
+```
+
+Keep that helper window open. Focus the terminal running plsqlwks and press
+**Ctrl-Alt-F12**; the helper confirms activation. The original shortcuts now
+reach the application, including **Ctrl-Home/End**, **Ctrl-Shift-Home/End**,
+modified arrows, word deletion, execution, paging, and `Ctrl+=`. `F11` executes
+the script instead of switching Windows Terminal to fullscreen.
+
+Use a dedicated terminal window for plsqlwks. The helper selects a window, so
+disable it with Ctrl-Alt-F12 before switching that window to another tab, pane,
+or program. Press Ctrl-C in the helper window to stop it. Left Alt is used for
+shortcuts; AltGr remains available for typing. Leave the classic console's
+**Use legacy console** option off. Use a UTF-8 locale on the Linux/Unix host.
+
+For Windows Terminal, set `"altGrAliasing": false` in the Command Prompt
+profile in its JSON settings. This keeps left Ctrl-Alt-C/R available for
+commit/rollback on international keyboards while preserving the real AltGr
+key. See Microsoft's [AltGr aliasing setting](https://learn.microsoft.com/en-us/windows/terminal/customize-settings/profile-advanced#altgr-aliasing).
+
+The `.cmd` launcher uses the included Windows PowerShell runtime and applies
+its script execution policy only to that helper process. No administrator
+rights, installation, or permanent policy change is needed. Keep
+`windows_keys.cmd` and `putty_keys.ps1` together when copying them elsewhere.
+Run `tools\windows_keys.cmd -SelfTest` to check the helper without enabling it.
+The original `powershell.exe -NoProfile -File .\tools\putty_keys.ps1` command
+also works from Command Prompt and continues to support PuTTY.
+
 ## Keys
 
 ### Global
@@ -673,15 +865,27 @@ period; DATE and TIMESTAMP input uses ISO
 Character and CLOB input is preserved as entered. Types that cannot be compared
 without losing information, including time-zone timestamps and timestamps with
 precision above six, are read-only in the grid.
-In python-oracledb Thin mode, non-null `TIMESTAMP WITH TIME ZONE` and
-`TIMESTAMP WITH LOCAL TIME ZONE` values are shown and exported as explicit
-lossless-fetch-unavailable markers instead of misleading naive datetimes. Use
-an explicit `TO_CHAR` expression with the required precision and zone fields
-when the exact value is needed; named-zone timestamps are not supported by the
-current Thin driver.
+In both driver modes, ordinary SELECT/WITH queries format zoned timestamps on
+Oracle to preserve their zone and fractional precision. Query forms that cannot
+use this projection show explicit lossless-fetch-unavailable markers for
+non-null zoned values on the native fetch path. Use an explicit `TO_CHAR`
+expression with the required precision and zone fields for those query forms.
 Displayed CLOB and BLOB values are limited to the first 65,536 characters or
 bytes and include a truncation marker with the full size. Truncated LOB cells
 cannot be edited safely. Schema-browser DDL is always read in full.
+To copy DBMS_OUTPUT, show it with **F6** and focus it with **Tab**. Use
+**Shift+navigation** to select text and **Ctrl+C** to copy; **Ctrl+A** selects
+all output. **Alt-O -> Results -> Copy all DBMS_OUTPUT** also copies the whole
+buffer while another pane is focused. Tab/Esc returns to the editor. Home/End
+move within a displayed line; Ctrl+Home/End move to the output boundaries.
+
+Copying preserves the stored text, whitespace, blank lines, and statement
+headings, without screen wrapping or padding. The existing system clipboard
+providers are used when available, with the internal clipboard as a fallback
+(including remote PuTTY sessions). Ctrl+C still cancels a running operation
+before performing a copy. Selection belongs to its file tab, survives appended
+output and resizing, and resets when execution replaces the output.
+
 DBMS_OUTPUT is collected after each statement and after every fetched result
 page without replacing a real query grid. Output-read or cursor-cleanup failures
 are displayed as warnings while preserving successfully fetched rows. PL/SQL
@@ -946,6 +1150,39 @@ lifecycle change requires a restart. See the
 [managed-package guide](https://gitlab.com/unununu/plsqlwks/-/blob/main/doc/PLUGINS.md#managed-plugin-packages)
 for the exact manifest, source layout, validation, replacement, and trust rules.
 
+### Table DDL Export
+
+Install `plugins/packages/table-ddl-export-0.1.1.plwgn` with
+`plsqlwks plugin install` and restart. **Alt-O -> Database -> Export table DDL**
+lets you choose a schema, filter table names as you type, select tables, and
+optionally remap them to another schema. It automatically includes related
+sequences and directly referencing packages, functions, procedures, and views, and follows
+required source-schema tables and views recursively. Definitions, constraints, indexes,
+foreign keys and triggers are ordered by creation dependencies in a new
+unsaved SQL tab for review. Generation activates that tab and focuses its editor.
+See the [selection keys and remapping details](doc/PLUGIN_CATALOG.md#table-ddl-export).
+
+### Dependencies walker
+
+Install the optional dependency browser and restart PLSQLWKS:
+
+```bash
+plsqlwks plugin install plugins/packages/dependencies-walker-0.1.0.plwgn
+```
+
+Choose **Alt-O -> Database -> Dependencies walker** and enter an object name,
+optionally qualified by schema. Expand with Enter/Right, collapse with Left,
+and use **D** (Depends on) or **U** (Used by) to follow the selected object in
+either direction. Backspace restores the previous tree; **R** refreshes and
+Esc closes. Packages combine specification/body relationships with labels.
+
+The walker reads only visible Oracle-recorded dependencies, loads branches
+on demand, marks cycles, and leaves database-link references unexpanded.
+Dynamic SQL and foreign-key graphs are outside this view. See the
+[plugin catalog](https://gitlab.com/unununu/plsqlwks/-/blob/main/doc/PLUGIN_CATALOG.md#dependencies-walker)
+for all controls and installation details. No additional runtime dependency is
+required.
+
 ### Maintained csv2oratab integration
 
 The maintained `csv2oratab-0.1.0.plwgn` catalog package adds **Alt-O -> Data ->