plsqlwks 0.2.4__tar.gz → 0.2.5__tar.gz

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.2.4
+Version: 0.2.5
 Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
 Author: unu2000
 License-Expression: LicenseRef-plsqlwks-Donationware
@@ -619,7 +619,7 @@ 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-P copy/paste internally, Ctrl-Shift-C/Ctrl-Shift-P
+autocomplete refresh. Ctrl-C/Ctrl-Alt-P copy/paste internally, Ctrl-Shift-C/Ctrl-Shift-P
 use the Windows system clipboard, and Alt-Shift-C/Alt-Shift-P use the Linux
 clipboard. Ctrl-V and Ctrl-Shift-V retain their configured paste sources;
 Ctrl-Shift-V defaults to internal paste. SSH does not expose the Windows clipboard to the host. Use
@@ -698,12 +698,14 @@ two external methods may access shared contents.
 | --- | --- | --- |
 | System (Windows) | `Ctrl-Shift-C` | `Ctrl-Shift-P` |
 | WSL/Linux | `Alt-Shift-C` | `Alt-Shift-P` |
-| Internal | `Ctrl-C` | `Ctrl-P` |
+| Internal | `Ctrl-C` | `Ctrl-Alt-P` |
 
 Each fixed shortcut uses only its assigned target. Copying externally leaves
 the internal clipboard unchanged. `Ctrl-C` interrupts a running database
 operation first; otherwise it copies internally. `Ctrl-Alt-C` still commits or
-applies the active insert draft, and `Ctrl-Alt-R` rolls back.
+applies the active insert draft, and `Ctrl-Alt-R` rolls back. `Ctrl-P` finds the
+previous occurrence of the last search string, retaining case sensitivity and
+wrapping at the start of the worksheet.
 The copy shortcuts work for editor selections, result cells/ranges,
 DBMS_OUTPUT selections and schema-browser object names. Paste works in the
 worksheet, paste-enabled prompts and editable cell text dialogs.
@@ -741,7 +743,8 @@ entries to `actions`, keeping the other actions:
 
 ```json
 { "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksInternalCopy" },
-{ "command": { "action": "sendInput", "input": "\u0010" }, "id": "User.PlsqlwksInternalPaste" },
+{ "command": { "action": "sendInput", "input": "\u001b[112;7u" }, "id": "User.PlsqlwksInternalPaste" },
+{ "command": { "action": "sendInput", "input": "\u0010" }, "id": "User.PlsqlwksPreviousMatch" },
 { "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksSystemCopy" },
 { "command": { "action": "sendInput", "input": "\u001b[112;6u" }, "id": "User.PlsqlwksSystemPaste" },
 { "command": { "action": "sendInput", "input": "\u001b[99;4u" }, "id": "User.PlsqlwksWslCopy" },
@@ -755,7 +758,8 @@ the entries below, keeping the other keybindings:
 
 ```json
 { "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+c" },
-{ "id": "User.PlsqlwksInternalPaste", "keys": "ctrl+p" },
+{ "id": "User.PlsqlwksInternalPaste", "keys": "ctrl+alt+p" },
+{ "id": "User.PlsqlwksPreviousMatch", "keys": "ctrl+p" },
 { "id": "User.PlsqlwksSystemCopy", "keys": "ctrl+shift+c" },
 { "id": "User.PlsqlwksSystemPaste", "keys": "ctrl+shift+p" },
 { "id": "User.PlsqlwksWslCopy", "keys": "alt+shift+c" },
@@ -793,11 +797,14 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | Key | Action |
 | --- | --- |
 | `Alt-O` | Open the top-left commands menu |
+| `Alt-I` | Show connection information for the active tab |
 | `F1` | Help |
 | `F6` | Switch between DBMS_OUTPUT and normal results |
 | `F7` | Cycle fullscreen grid, fullscreen editor, and 2/3 editor + 1/3 grid |
 | `F8` | Toggle result grid / row-detail output |
 | `F9` | Show/focus/hide schema browser |
+| `Shift-F9` | Toggle Schema Browser between normal and half-screen width |
+| `Shift-Alt-F9` | Toggle Schema Browser between full-screen and its previous width |
 | `F12` | Choose autocommit or manual transaction mode |
 | `Ctrl-Up` / `Ctrl-Down` | Scroll the focused pane or visible DBMS_OUTPUT by one line |
 | `Ctrl-W` | Close current file tab |
@@ -808,6 +815,25 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Ctrl-Alt-C` | Insert the active result-grid draft, or commit when no draft is active |
 | `Ctrl-Alt-R` | Roll back the current transaction |
 
+### Connection information
+
+Press `Alt-I`, or choose **Alt-O → Database → Connection information**, from the
+editor, results or schema browser. A centered dialog shows the connected user,
+current schema, service, database and unique database name, container, instance,
+server host, session SID, server timestamp with fractional seconds and timezone,
+database/session time zones, Oracle version, driver version and Thin/Thick mode,
+autocommit and read-only mode. The information is refreshed from the active tab's
+existing session without changing worksheet results, transactions or unread
+DBMS_OUTPUT. A busy active session uses the existing operation-running feedback;
+a disconnected session shows `Not connected` without reconnecting.
+
+The dialog keeps **[ OK ]** visible. Press Enter or Space to accept, or Esc/Ctrl-Q
+to close. Use Up/Down, PageUp/PageDown or Home/End to scroll long details; resize
+the terminal to change the layout. Requests cancelled or completed after switching
+away from their tab do not open a late dialog. The Windows keyboard helper forwards
+Alt-I; a Windows Terminal profile that consumes it can forward `\u001bi` with a
+`sendInput` action bound to `alt+i`.
+
 ### Editor
 
 | Key | Action |
@@ -845,10 +871,10 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Alt-O` -> **Editor** -> **Replace text** | Open Find/Replace at the replacement field |
 | `Ctrl-G` | Go to line |
 | `Ctrl-N` | Move to the next search occurrence |
-| `Alt-O → Editor → Previous search match` | Move to the previous search occurrence |
+| `Ctrl-P` / `Alt-O → Editor → Previous search match` | Move to the previous search occurrence |
 | `Ctrl-U` | Uppercase selected SQL code |
 | `Ctrl-L` | Lowercase selected SQL code |
-| `Ctrl-C` / `Ctrl-P` | Copy/paste internally |
+| `Ctrl-C` / `Ctrl-Alt-P` | Copy/paste internally |
 | `Ctrl-Shift-C` / `Ctrl-Shift-P` | Copy/paste the System (Windows) clipboard |
 | `Alt-Shift-C` / `Alt-Shift-P` | Copy/paste the WSL/Linux clipboard |
 | `Ctrl-X` | Cut selected text |
@@ -889,9 +915,9 @@ The dialog provides `Find next`, `Replace`, `Replace all`, and `Cancel` actions.
 and lowercase letters. `Replace` changes the selected matching occurrence, or
 the next match from the cursor, and then selects the following match. `Replace
 all` changes every match in the current buffer. Either replacement operation is
-recorded as one undoable edit. `Ctrl-N` repeats the last search forward;
-**Alt-O → Editor → Previous search match** repeats it backward. Both retain the
-case setting and wrap around.
+recorded as one undoable edit. `Ctrl-N` repeats the last search forward and
+`Ctrl-P` repeats it backward. Both retain the case setting and wrap around.
+**Alt-O → Editor → Previous search match** provides the same backward search.
 
 Editor paste expands every tab character to two spaces and keeps multiline
 text in one undoable edit. This applies to all fixed and configured paste shortcuts and
@@ -1212,7 +1238,28 @@ validate this opt-in mode with the applications in use.
 
 ### Schema Browser
 
-The `F9` schema browser groups tables, views, procedures, functions, package specifications, package bodies, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns, routines or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
+Press `F9` to open or focus Schema Browser. While it is focused, `F9` closes it
+and returns to the SQL buffer. Press `Tab` to keep the browser open and focus
+the SQL buffer, so you can edit SQL beside the tree; press `F9` to return to it.
+Filters, selected objects, expanded branches and cached metadata are retained.
+
+`Shift-F9` opens/focuses the browser and toggles its normal width with a left
+half-screen pane; the SQL buffer and results stay on the right. `Shift-Alt-F9`
+opens/focuses a full-screen browser with its filter header and status line, and
+pressing it again restores the previous normal or half-screen width. From a
+full-screen browser, Tab, returning to the editor with Esc, or loading/inserting
+SQL also restores that previous width. Shift-F9 switches a full-screen browser
+to half-screen. Closing it with F9 retains the side-by-side width for reopening.
+Browser sizes last for the current application session.
+
+Opening/focusing the browser exits an incompatible F7 editor/grid fullscreen
+view, restoring the saved SQL/results split or the two-thirds-editor layout.
+F7 retains its existing editor/grid layout cycle. A terminal that consumes the
+new shortcuts can forward `\u001b[20;2~` for Shift-F9 and `\u001b[20;4~` for
+Shift-Alt-F9 with Windows Terminal `sendInput` actions. The Windows keyboard
+helper forwards both shortcuts while preserving AltGr combinations.
+
+The `F9` schema browser groups tables, views, procedures, functions, package specifications, package bodies, types, type bodies, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns, routines or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
 
 Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load DDL`, or `Copy object name`. `Insert SELECT` adds a `select *` statement for the SQL-safe, unqualified object name to the current buffer and focuses the editor; it does not execute the query. `Copy object name` places that SQL-ready, unqualified identifier on the clipboard. For standalone procedures, functions and other object types, `Enter` offers `Load DDL` (the default) and `Copy object name`.
 
@@ -1237,6 +1284,18 @@ Edit the input values before running it. Insertion does not execute or compile
 the call. Unsupported or incomplete signatures report a reason and leave the
 buffer unchanged.
 
+Press `Space` on a standalone procedure or function to expand its callable
+signature with parameter directions, types and the function return type. Press
+`Enter` on the signature to insert the same owner-qualified call template as for
+package routines. The parent object's Enter menu still offers Load DDL and Copy
+object name. Signatures load asynchronously and are cached until refresh.
+
+The **Types** group includes object and collection types; **Type bodies** lists
+their implementations separately. Enter offers Load DDL or Copy object name.
+Loading a type fetches its specification only; loading a type body fetches its
+body only, with owner-qualified DDL and a single slash terminator. Type attributes
+and methods do not expand into child rows.
+
 Press `Space` on a table or view to expand or collapse its column subtree,
 including while filtering. Column names appear in database order and are loaded
 in the background on first expansion, then cached. Columns are informational
@@ -1253,8 +1312,12 @@ object branches, retaining the filter and group expansion state.
 | `Esc` | Clear a nonempty filter, or return to the editor when the filter is empty |
 | `Up` / `Down` | Move through browser entries |
 | `PageUp` / `PageDown` | Move through browser entries by page |
-| `Enter` | Expand a group, choose an object action, or insert a package routine call |
-| `Space` | Expand/collapse table/view columns or package routines; on groups, expand/collapse with an empty filter or add a space to an active filter |
+| `Tab` | Focus the SQL buffer, keeping the browser open |
+| `F9` | Close the browser and focus the SQL buffer |
+| `Shift-F9` | Toggle normal/half-screen width and focus the browser |
+| `Shift-Alt-F9` | Toggle full-screen/previous width and focus the browser |
+| `Enter` | Expand a group, choose an object action, or insert a routine call |
+| `Space` | Expand/collapse table/view columns, package routines or standalone signatures; on groups, expand/collapse with an empty filter or add a space to an active filter |
 | `Ctrl-F` | Edit the object-name filter, including spaces |
 | `Ctrl-R` | Refresh database objects/statuses and clear column/routine subtrees and caches |
 
@@ -1268,7 +1331,7 @@ object branches, retaining the filter and group expansion state.
 | `PageUp` / `PageDown` | Scroll cell text by page |
 | `Home` / `End` | Move to the first/last cell-viewer line |
 | `Ctrl-S` (editor) | Save the multiline edit |
-| `Ctrl-P` / `Ctrl-Shift-P` / `Alt-Shift-P` / configured V keys / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
+| `Ctrl-Alt-P` / `Ctrl-Shift-P` / `Alt-Shift-P` / configured V keys / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
 | `Enter` (editor) | Insert a newline |
 | `F10` / `Esc` / `Ctrl-Q` (editor) | Cancel the multiline edit |
 

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/README.md

@@ -583,7 +583,7 @@ 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-P copy/paste internally, Ctrl-Shift-C/Ctrl-Shift-P
+autocomplete refresh. Ctrl-C/Ctrl-Alt-P copy/paste internally, Ctrl-Shift-C/Ctrl-Shift-P
 use the Windows system clipboard, and Alt-Shift-C/Alt-Shift-P use the Linux
 clipboard. Ctrl-V and Ctrl-Shift-V retain their configured paste sources;
 Ctrl-Shift-V defaults to internal paste. SSH does not expose the Windows clipboard to the host. Use
@@ -662,12 +662,14 @@ two external methods may access shared contents.
 | --- | --- | --- |
 | System (Windows) | `Ctrl-Shift-C` | `Ctrl-Shift-P` |
 | WSL/Linux | `Alt-Shift-C` | `Alt-Shift-P` |
-| Internal | `Ctrl-C` | `Ctrl-P` |
+| Internal | `Ctrl-C` | `Ctrl-Alt-P` |
 
 Each fixed shortcut uses only its assigned target. Copying externally leaves
 the internal clipboard unchanged. `Ctrl-C` interrupts a running database
 operation first; otherwise it copies internally. `Ctrl-Alt-C` still commits or
-applies the active insert draft, and `Ctrl-Alt-R` rolls back.
+applies the active insert draft, and `Ctrl-Alt-R` rolls back. `Ctrl-P` finds the
+previous occurrence of the last search string, retaining case sensitivity and
+wrapping at the start of the worksheet.
 The copy shortcuts work for editor selections, result cells/ranges,
 DBMS_OUTPUT selections and schema-browser object names. Paste works in the
 worksheet, paste-enabled prompts and editable cell text dialogs.
@@ -705,7 +707,8 @@ entries to `actions`, keeping the other actions:
 
 ```json
 { "command": { "action": "sendInput", "input": "\u0003" }, "id": "User.PlsqlwksInternalCopy" },
-{ "command": { "action": "sendInput", "input": "\u0010" }, "id": "User.PlsqlwksInternalPaste" },
+{ "command": { "action": "sendInput", "input": "\u001b[112;7u" }, "id": "User.PlsqlwksInternalPaste" },
+{ "command": { "action": "sendInput", "input": "\u0010" }, "id": "User.PlsqlwksPreviousMatch" },
 { "command": { "action": "sendInput", "input": "\u001b[99;6u" }, "id": "User.PlsqlwksSystemCopy" },
 { "command": { "action": "sendInput", "input": "\u001b[112;6u" }, "id": "User.PlsqlwksSystemPaste" },
 { "command": { "action": "sendInput", "input": "\u001b[99;4u" }, "id": "User.PlsqlwksWslCopy" },
@@ -719,7 +722,8 @@ the entries below, keeping the other keybindings:
 
 ```json
 { "id": "User.PlsqlwksInternalCopy", "keys": "ctrl+c" },
-{ "id": "User.PlsqlwksInternalPaste", "keys": "ctrl+p" },
+{ "id": "User.PlsqlwksInternalPaste", "keys": "ctrl+alt+p" },
+{ "id": "User.PlsqlwksPreviousMatch", "keys": "ctrl+p" },
 { "id": "User.PlsqlwksSystemCopy", "keys": "ctrl+shift+c" },
 { "id": "User.PlsqlwksSystemPaste", "keys": "ctrl+shift+p" },
 { "id": "User.PlsqlwksWslCopy", "keys": "alt+shift+c" },
@@ -757,11 +761,14 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | Key | Action |
 | --- | --- |
 | `Alt-O` | Open the top-left commands menu |
+| `Alt-I` | Show connection information for the active tab |
 | `F1` | Help |
 | `F6` | Switch between DBMS_OUTPUT and normal results |
 | `F7` | Cycle fullscreen grid, fullscreen editor, and 2/3 editor + 1/3 grid |
 | `F8` | Toggle result grid / row-detail output |
 | `F9` | Show/focus/hide schema browser |
+| `Shift-F9` | Toggle Schema Browser between normal and half-screen width |
+| `Shift-Alt-F9` | Toggle Schema Browser between full-screen and its previous width |
 | `F12` | Choose autocommit or manual transaction mode |
 | `Ctrl-Up` / `Ctrl-Down` | Scroll the focused pane or visible DBMS_OUTPUT by one line |
 | `Ctrl-W` | Close current file tab |
@@ -772,6 +779,25 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Ctrl-Alt-C` | Insert the active result-grid draft, or commit when no draft is active |
 | `Ctrl-Alt-R` | Roll back the current transaction |
 
+### Connection information
+
+Press `Alt-I`, or choose **Alt-O → Database → Connection information**, from the
+editor, results or schema browser. A centered dialog shows the connected user,
+current schema, service, database and unique database name, container, instance,
+server host, session SID, server timestamp with fractional seconds and timezone,
+database/session time zones, Oracle version, driver version and Thin/Thick mode,
+autocommit and read-only mode. The information is refreshed from the active tab's
+existing session without changing worksheet results, transactions or unread
+DBMS_OUTPUT. A busy active session uses the existing operation-running feedback;
+a disconnected session shows `Not connected` without reconnecting.
+
+The dialog keeps **[ OK ]** visible. Press Enter or Space to accept, or Esc/Ctrl-Q
+to close. Use Up/Down, PageUp/PageDown or Home/End to scroll long details; resize
+the terminal to change the layout. Requests cancelled or completed after switching
+away from their tab do not open a late dialog. The Windows keyboard helper forwards
+Alt-I; a Windows Terminal profile that consumes it can forward `\u001bi` with a
+`sendInput` action bound to `alt+i`.
+
 ### Editor
 
 | Key | Action |
@@ -809,10 +835,10 @@ See Microsoft's [send input action](https://learn.microsoft.com/en-us/windows/te
 | `Alt-O` -> **Editor** -> **Replace text** | Open Find/Replace at the replacement field |
 | `Ctrl-G` | Go to line |
 | `Ctrl-N` | Move to the next search occurrence |
-| `Alt-O → Editor → Previous search match` | Move to the previous search occurrence |
+| `Ctrl-P` / `Alt-O → Editor → Previous search match` | Move to the previous search occurrence |
 | `Ctrl-U` | Uppercase selected SQL code |
 | `Ctrl-L` | Lowercase selected SQL code |
-| `Ctrl-C` / `Ctrl-P` | Copy/paste internally |
+| `Ctrl-C` / `Ctrl-Alt-P` | Copy/paste internally |
 | `Ctrl-Shift-C` / `Ctrl-Shift-P` | Copy/paste the System (Windows) clipboard |
 | `Alt-Shift-C` / `Alt-Shift-P` | Copy/paste the WSL/Linux clipboard |
 | `Ctrl-X` | Cut selected text |
@@ -853,9 +879,9 @@ The dialog provides `Find next`, `Replace`, `Replace all`, and `Cancel` actions.
 and lowercase letters. `Replace` changes the selected matching occurrence, or
 the next match from the cursor, and then selects the following match. `Replace
 all` changes every match in the current buffer. Either replacement operation is
-recorded as one undoable edit. `Ctrl-N` repeats the last search forward;
-**Alt-O → Editor → Previous search match** repeats it backward. Both retain the
-case setting and wrap around.
+recorded as one undoable edit. `Ctrl-N` repeats the last search forward and
+`Ctrl-P` repeats it backward. Both retain the case setting and wrap around.
+**Alt-O → Editor → Previous search match** provides the same backward search.
 
 Editor paste expands every tab character to two spaces and keeps multiline
 text in one undoable edit. This applies to all fixed and configured paste shortcuts and
@@ -1176,7 +1202,28 @@ validate this opt-in mode with the applications in use.
 
 ### Schema Browser
 
-The `F9` schema browser groups tables, views, procedures, functions, package specifications, package bodies, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns, routines or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
+Press `F9` to open or focus Schema Browser. While it is focused, `F9` closes it
+and returns to the SQL buffer. Press `Tab` to keep the browser open and focus
+the SQL buffer, so you can edit SQL beside the tree; press `F9` to return to it.
+Filters, selected objects, expanded branches and cached metadata are retained.
+
+`Shift-F9` opens/focuses the browser and toggles its normal width with a left
+half-screen pane; the SQL buffer and results stay on the right. `Shift-Alt-F9`
+opens/focuses a full-screen browser with its filter header and status line, and
+pressing it again restores the previous normal or half-screen width. From a
+full-screen browser, Tab, returning to the editor with Esc, or loading/inserting
+SQL also restores that previous width. Shift-F9 switches a full-screen browser
+to half-screen. Closing it with F9 retains the side-by-side width for reopening.
+Browser sizes last for the current application session.
+
+Opening/focusing the browser exits an incompatible F7 editor/grid fullscreen
+view, restoring the saved SQL/results split or the two-thirds-editor layout.
+F7 retains its existing editor/grid layout cycle. A terminal that consumes the
+new shortcuts can forward `\u001b[20;2~` for Shift-F9 and `\u001b[20;4~` for
+Shift-Alt-F9 with Windows Terminal `sendInput` actions. The Windows keyboard
+helper forwards both shortcuts while preserving AltGr combinations.
+
+The `F9` schema browser groups tables, views, procedures, functions, package specifications, package bodies, types, type bodies, triggers, sequences, indexes, and private synonyms from the current schema. Type while the browser is focused to filter object names with a case-insensitive substring match; groups without matches are hidden and matching groups expand automatically without changing their saved expansion state. Exact quoted and mixed-case names are preserved when columns, routines or definitions are loaded, with Oracle-safe quoting applied to metadata requests.
 
 Press `Enter` on a table or view to choose `Insert SELECT` (the default), `Load DDL`, or `Copy object name`. `Insert SELECT` adds a `select *` statement for the SQL-safe, unqualified object name to the current buffer and focuses the editor; it does not execute the query. `Copy object name` places that SQL-ready, unqualified identifier on the clipboard. For standalone procedures, functions and other object types, `Enter` offers `Load DDL` (the default) and `Copy object name`.
 
@@ -1201,6 +1248,18 @@ Edit the input values before running it. Insertion does not execute or compile
 the call. Unsupported or incomplete signatures report a reason and leave the
 buffer unchanged.
 
+Press `Space` on a standalone procedure or function to expand its callable
+signature with parameter directions, types and the function return type. Press
+`Enter` on the signature to insert the same owner-qualified call template as for
+package routines. The parent object's Enter menu still offers Load DDL and Copy
+object name. Signatures load asynchronously and are cached until refresh.
+
+The **Types** group includes object and collection types; **Type bodies** lists
+their implementations separately. Enter offers Load DDL or Copy object name.
+Loading a type fetches its specification only; loading a type body fetches its
+body only, with owner-qualified DDL and a single slash terminator. Type attributes
+and methods do not expand into child rows.
+
 Press `Space` on a table or view to expand or collapse its column subtree,
 including while filtering. Column names appear in database order and are loaded
 in the background on first expansion, then cached. Columns are informational
@@ -1217,8 +1276,12 @@ object branches, retaining the filter and group expansion state.
 | `Esc` | Clear a nonempty filter, or return to the editor when the filter is empty |
 | `Up` / `Down` | Move through browser entries |
 | `PageUp` / `PageDown` | Move through browser entries by page |
-| `Enter` | Expand a group, choose an object action, or insert a package routine call |
-| `Space` | Expand/collapse table/view columns or package routines; on groups, expand/collapse with an empty filter or add a space to an active filter |
+| `Tab` | Focus the SQL buffer, keeping the browser open |
+| `F9` | Close the browser and focus the SQL buffer |
+| `Shift-F9` | Toggle normal/half-screen width and focus the browser |
+| `Shift-Alt-F9` | Toggle full-screen/previous width and focus the browser |
+| `Enter` | Expand a group, choose an object action, or insert a routine call |
+| `Space` | Expand/collapse table/view columns, package routines or standalone signatures; on groups, expand/collapse with an empty filter or add a space to an active filter |
 | `Ctrl-F` | Edit the object-name filter, including spaces |
 | `Ctrl-R` | Refresh database objects/statuses and clear column/routine subtrees and caches |
 
@@ -1232,7 +1295,7 @@ object branches, retaining the filter and group expansion state.
 | `PageUp` / `PageDown` | Scroll cell text by page |
 | `Home` / `End` | Move to the first/last cell-viewer line |
 | `Ctrl-S` (editor) | Save the multiline edit |
-| `Ctrl-P` / `Ctrl-Shift-P` / `Alt-Shift-P` / configured V keys / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
+| `Ctrl-Alt-P` / `Ctrl-Shift-P` / `Alt-Shift-P` / configured V keys / terminal paste (editor) | Paste exact clipboard text as one undoable edit |
 | `Enter` (editor) | Insert a newline |
 | `F10` / `Esc` / `Ctrl-Q` (editor) | Cancel the multiline edit |
 

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/doc/PLUGIN_CATALOG.md

@@ -65,7 +65,7 @@ plsqlwks plugin install plugins/packages/schema-compare-0.1.0.plwgn
 ```
 
 The `xlsx` extra is optional when only CSV/HTML are needed. From a local source
-archive, use `python3 -m pip install './plsqlwks-0.2.4.tar.gz[xlsx]'` in the
+archive, use `python3 -m pip install './plsqlwks-0.2.5.tar.gz[xlsx]'` in the
 application environment; use `--force-reinstall` when replacing a build with
 the same version. Installing the extra does not install the managed plugin.
 No other exporter plugins need to be installed.

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/plsqlwks/__init__.py

@@ -1,3 +1,3 @@
 """ncurses SQL and PL/SQL workspace."""
 
-__version__ = "0.2.4"
+__version__ = "0.2.5"

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/plsqlwks/db/metadata.py

@@ -16,6 +16,8 @@ SCHEMA_OBJECT_TYPES = (
     "FUNCTION",
     "PACKAGE",
     "PACKAGE BODY",
+    "TYPE",
+    "TYPE BODY",
     "TRIGGER",
     "SEQUENCE",
     "INDEX",
@@ -66,7 +68,7 @@ class PackageArgument:
 @dataclass(frozen=True)
 class PackageRoutine:
     owner: str
-    package_name: str
+    package_name: str | None
     name: str
     subprogram_id: int
     overload: str | None
@@ -86,6 +88,8 @@ class MetadataPort(Protocol):
 
     def list_package_routines(self, package_name: str) -> tuple[PackageRoutine, ...]: ...
 
+    def list_standalone_routines(self, object_type: str, object_name: str) -> tuple[PackageRoutine, ...]: ...
+
     def get_table_generation_metadata(self, object_name: str) -> TableGenerationMetadata | None: ...
 
     def get_column_max(self, object_name: str, column_name: str) -> object | None: ...
@@ -108,7 +112,7 @@ class MetadataService:
                 from user_objects
                 where object_type in (
                   'TABLE', 'VIEW', 'PROCEDURE', 'FUNCTION', 'PACKAGE', 'PACKAGE BODY',
-                  'TRIGGER', 'SEQUENCE', 'INDEX', 'SYNONYM'
+                  'TYPE', 'TYPE BODY', 'TRIGGER', 'SEQUENCE', 'INDEX', 'SYNONYM'
                 )
                 order by
                   case object_type
@@ -118,10 +122,12 @@ class MetadataService:
                     when 'FUNCTION' then 4
                     when 'PACKAGE' then 5
                     when 'PACKAGE BODY' then 6
-                    when 'TRIGGER' then 7
-                    when 'SEQUENCE' then 8
-                    when 'INDEX' then 9
-                    when 'SYNONYM' then 10
+                    when 'TYPE' then 7
+                    when 'TYPE BODY' then 8
+                    when 'TRIGGER' then 9
+                    when 'SEQUENCE' then 10
+                    when 'INDEX' then 11
+                    when 'SYNONYM' then 12
                     else 99
                   end,
                   object_name
@@ -150,7 +156,10 @@ class MetadataService:
                 return terminate_plsql_ddl(spec)
             ddl_type = metadata_object_type(normalized_type)
             ddl = fetch_ddl(cursor, ddl_type, normalized_name)
-            if normalized_type in {"PROCEDURE", "FUNCTION", "TRIGGER", "PACKAGE_SPEC", "PACKAGE_BODY", "PACKAGE BODY"}:
+            if normalized_type in {
+                "PROCEDURE", "FUNCTION", "TRIGGER", "PACKAGE_SPEC", "PACKAGE_BODY", "PACKAGE BODY",
+                "TYPE", "TYPE_SPEC", "TYPE_BODY", "TYPE BODY",
+            }:
                 return terminate_plsql_ddl(ddl)
             return ensure_sql_terminator(ddl)
         finally:
@@ -171,23 +180,50 @@ class MetadataService:
         name = normalize_identifier(package_name)
         if name is None:
             raise ValueError("Invalid Oracle package identifier")
+        return self._list_routines('PACKAGE', name)
+
+    def list_standalone_routines(self, object_type: str, object_name: str) -> tuple[PackageRoutine, ...]:
+        if object_type not in {'PROCEDURE', 'FUNCTION'}:
+            raise ValueError("Unsupported standalone routine type")
+        name = normalize_identifier(object_name)
+        if name is None:
+            raise ValueError("Invalid Oracle routine identifier")
+        return self._list_routines(object_type, name)
+
+    def _list_routines(self, object_type: str, name: str) -> tuple[PackageRoutine, ...]:
         cursor = self._ensure_connected().cursor()
         try:
-            cursor.execute("""
+            if object_type == 'PACKAGE':
+                cursor.execute("""
                 select user, procedure_name, subprogram_id, overload, pipelined, aggregate
                 from user_procedures
                 where object_name = :package_name and object_type = 'PACKAGE'
                   and procedure_name is not null
                 order by procedure_name, subprogram_id
-            """, package_name=name)
+                """, package_name=name)
+            else:
+                cursor.execute("""
+                    select user, object_name, subprogram_id, overload, pipelined, aggregate
+                    from user_procedures
+                    where object_name = :object_name and object_type = :object_type
+                      and procedure_name is null
+                    order by subprogram_id
+                """, object_name=name, object_type=object_type)
             procedures = list(cursor)
-            cursor.execute("""
+            argument_filter = 'package_name = :package_name' if object_type == 'PACKAGE' else (
+                'package_name is null and object_name = :object_name'
+            )
+            argument_query = f"""
                 select subprogram_id, overload, argument_name, position, in_out, data_type,
                        type_owner, type_name, type_subname, type_object_type, pls_type, char_length, defaulted
                 from user_arguments
-                where package_name = :package_name and data_level = 0
+                where {argument_filter} and data_level = 0
                 order by subprogram_id, sequence
-            """, package_name=name)
+            """
+            if object_type == 'PACKAGE':
+                cursor.execute(argument_query, package_name=name)
+            else:
+                cursor.execute(argument_query, object_name=name)
             arguments: dict[tuple[int, str | None], list[tuple[int, PackageArgument]]] = {}
             for row in cursor:
                 (subprogram_id, overload, argument_name, position, mode, data_type,
@@ -202,11 +238,14 @@ class MetadataService:
             for owner, routine_name, subprogram_id, overload, pipelined, aggregate in procedures:
                 signature = arguments.get((int(subprogram_id), overload), [])
                 return_argument = next((arg for position, arg in signature if position == 0), None)
+                if object_type == 'FUNCTION' and return_argument is None:
+                    return_argument = PackageArgument(None, 'OUT', 'UNKNOWN', None)
                 parameters = tuple(arg for position, arg in signature if position > 0)
                 reason = "This SQL-only function cannot be called by an ordinary PL/SQL block" if (
                     pipelined == 'YES' or aggregate == 'YES'
                 ) else None
-                routines.append(PackageRoutine(str(owner), name, str(routine_name), int(subprogram_id), overload,
+                routines.append(PackageRoutine(str(owner), name if object_type == 'PACKAGE' else None,
+                                               str(routine_name), int(subprogram_id), overload,
                                                parameters, return_argument, reason))
             return tuple(routines)
         finally:
@@ -375,6 +414,9 @@ class MetadataMixin:
     def list_package_routines(self, package_name: str) -> tuple[PackageRoutine, ...]:
         return self._metadata_service().list_package_routines(package_name)
 
+    def list_standalone_routines(self, object_type: str, object_name: str) -> tuple[PackageRoutine, ...]:
+        return self._metadata_service().list_standalone_routines(object_type, object_name)
+
     def get_table_generation_metadata(self, object_name: str) -> TableGenerationMetadata | None:
         return self._metadata_service().get_table_generation_metadata(object_name)
 
@@ -401,6 +443,10 @@ def configure_metadata_transform(cursor: oracledb.Cursor) -> None:
 
 
 def metadata_object_type(object_type: str) -> str:
+    if object_type in {'TYPE', 'TYPE_SPEC'}:
+        return 'TYPE_SPEC'
+    if object_type in {'TYPE BODY', 'TYPE_BODY'}:
+        return 'TYPE_BODY'
     if object_type in {"PACKAGE_SPEC", "PACKAGE_BODY", "PACKAGE BODY"}:
         return object_type.replace(' ', '_')
     if object_type not in SCHEMA_OBJECT_TYPES:

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/plsqlwks/db/session.py

@@ -173,6 +173,49 @@ class OracleWorkspace(
     def list_package_routines(self, package_name: str) -> tuple[PackageRoutine, ...]:
         return self._metadata.list_package_routines(package_name)
 
+    def list_standalone_routines(self, object_type: str, object_name: str) -> tuple[PackageRoutine, ...]:
+        return self._metadata.list_standalone_routines(object_type, object_name)
+
+    def get_connection_info(self) -> tuple[tuple[str, str], ...]:
+        """Inspect the current connection without connecting or changing session state."""
+        conn = self.connection
+        if conn is None or not self.connection_is_healthy():
+            raise RuntimeError("Not connected; reconnect before requesting connection information")
+        cursor = conn.cursor()
+        try:
+            cursor.execute("""
+                select user,
+                       sys_context('USERENV', 'CURRENT_SCHEMA'),
+                       sys_context('USERENV', 'SERVICE_NAME'),
+                       sys_context('USERENV', 'DB_NAME'),
+                       sys_context('USERENV', 'DB_UNIQUE_NAME'),
+                       sys_context('USERENV', 'CON_NAME'),
+                       sys_context('USERENV', 'INSTANCE_NAME'),
+                       sys_context('USERENV', 'SERVER_HOST'),
+                       sys_context('USERENV', 'SID'),
+                       to_char(systimestamp, 'YYYY-MM-DD"T"HH24:MI:SS.FF9 TZH:TZM'),
+                       dbtimezone, sessiontimezone
+                from dual
+            """)
+            row = cursor.fetchone()
+            if row is None:
+                raise RuntimeError("Connection information query returned no row")
+            labels = (
+                'Connected user', 'Current schema', 'Service', 'Database', 'Unique database name',
+                'Container', 'Instance', 'Server host', 'Session SID', 'Server time',
+                'Database time zone', 'Session time zone',
+            )
+            fields = tuple((label, str(value) if value is not None else 'Not available')
+                           for label, value in zip(labels, row, strict=True))
+            return fields + (
+                ('Oracle version', conn.version), ('Driver version', oracledb.__version__),
+                ('Driver mode', 'Thin' if conn.thin else 'Thick'),
+                ('Autocommit', 'On' if self.autocommit else 'Off'),
+                ('Read-only mode', 'On' if self.read_only else 'Off'),
+            )
+        finally:
+            cursor.close()
+
     def get_table_generation_metadata(self, object_name: str) -> TableGenerationMetadata | None:
         return self._metadata.get_table_generation_metadata(object_name)
 

{plsqlwks-0.2.4 → plsqlwks-0.2.5}/plsqlwks/ui/__init__.py

@@ -42,6 +42,7 @@ from .syntax import *  # type: ignore[assignment]  # reason: compatibility facad
 
 __all__ = (
     "ALT_G_SEQUENCES",
+    "ALT_I_SEQUENCES",
     "ALT_O_SEQUENCES",
     "ALT_PLUS_SEQUENCES",
     "ALT_R_SEQUENCES",
@@ -174,13 +175,16 @@ __all__ = (
     "INSERT_SEQUENCES",
     "KEY_ALT_DIGIT_BASE",
     "KEY_ALT_G",
+    "KEY_ALT_I",
     "KEY_ALT_O",
     "KEY_ALT_PLUS",
     "KEY_ALT_R",
     "KEY_ALT_SHIFT_C",
+    "KEY_ALT_SHIFT_F9",
     "KEY_ALT_SHIFT_P",
     "KEY_ALT_X",
     "KEY_CTRL_ALT_C",
+    "KEY_CTRL_ALT_P",
     "KEY_CTRL_ALT_R",
     "KEY_CTRL_BACKSPACE",
     "KEY_CTRL_DELETE",
@@ -203,6 +207,7 @@ __all__ = (
     "KEY_CTRL_UP",
     "KEY_SHIFT_DOWN",
     "KEY_SHIFT_END",
+    "KEY_SHIFT_F9",
     "KEY_SHIFT_HOME",
     "KEY_SHIFT_LEFT",
     "KEY_SHIFT_PAGEDOWN",