plsqlwks 0.1.1__tar.gz → 0.1.2__tar.gz

{plsqlwks-0.1.1/plsqlwks.egg-info → plsqlwks-0.1.2}/PKG-INFO

@@ -1,12 +1,17 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.1.1
+Version: 0.1.2
 Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
+License-Expression: LicenseRef-plsqlwks-Donationware
+Project-URL: Repository, https://gitlab.com/unununu/plsqlwks
+Project-URL: Issues, https://gitlab.com/unununu/plsqlwks/-/issues
+Project-URL: Changelog, https://gitlab.com/unununu/plsqlwks/-/blob/main/CHANGELOG.md
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
 Classifier: Topic :: Database
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
+License-File: license.txt
 Requires-Dist: oracledb>=2.0
 Provides-Extra: dev
 Requires-Dist: build>=1.2; extra == "dev"
@@ -14,12 +19,13 @@ Requires-Dist: mypy>=1.10; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: ruff>=0.8; extra == "dev"
 Requires-Dist: wheel>=0.43; extra == "dev"
+Dynamic: license-file
 
 # plsqlwks
 
 An ncurses SQL and PL/SQL workspace for the local Oracle database.
 
-![PLSQLWKS PREVIEW](https://raw.githubusercontent.com/mtatton/plsqlwks/master/img/preview.gif)
+![PLSQLWKS PREVIEW](https://gitlab.com/unununu/plsqlwks/-/raw/main/img/preview.png)
 
 ## Connection
 
@@ -57,8 +63,10 @@ For development, install the package in editable mode:
 python3 -m pip install -e '.[dev]'
 ```
 
-See [RELEASING.md](RELEASING.md) for the quality, build, wheel-smoke, Oracle,
-and tagging checklist used for releases.
+`oracledb` is the only runtime dependency. Supporting functionality uses the Python standard library.
+
+See the [release checklist](https://gitlab.com/unununu/plsqlwks/-/blob/main/RELEASING.md)
+for the quality, packaging, and GitLab release process.
 
 For a regular local install, use:
 
@@ -219,6 +227,8 @@ Read-only mode is a client-side guardrail that rejects statements which the SQL
 
 When more result rows are available, `PageDown` at the loaded end fetches and appends the next result page. For simple single-table queries that select `ROWID`, press `Enter` on a non-`ROWID` cell to update that table column by rowid. Press `INS` in the grid to prepare a draft row at the top of the grid, edit its cells with `Enter`, use `Ctrl-Alt-C` to insert it, or use `Esc` to cancel it.
 Database null values are displayed and entered as `<NULL>` in editable results. Plain `NULL` is stored as literal text.
+Grid edits compare the typed value that was originally loaded as well as the `ROWID`. If another session changes or deletes the row first, the edit is rejected and the query must be refreshed. NUMBER input uses decimal notation with a period; DATE and TIMESTAMP input uses ISO `YYYY-MM-DD[ HH:MM:SS[.ffffff]]`; RAW and BLOB input uses hexadecimal bytes. 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.
+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. CSV export uses the displayed result values and therefore retains the same explicit LOB limit; schema-browser DDL is always read in full.
 `F7` cycles a grid fullscreen view that starts with the table header on the first terminal line and uses the last line for data, an editor-only fullscreen view, and a split layout with 2/3 editor and 1/3 data grid.
 
 ### Schema Browser

plsqlwks-0.1.1/PKG-INFO → plsqlwks-0.1.2/README.md

@@ -1,25 +1,8 @@
-Metadata-Version: 2.4
-Name: plsqlwks
-Version: 0.1.1
-Summary: An ncurses SQL and PL/SQL workspace for Oracle databases.
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Topic :: Database
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: oracledb>=2.0
-Provides-Extra: dev
-Requires-Dist: build>=1.2; extra == "dev"
-Requires-Dist: mypy>=1.10; extra == "dev"
-Requires-Dist: pytest>=8.0; extra == "dev"
-Requires-Dist: ruff>=0.8; extra == "dev"
-Requires-Dist: wheel>=0.43; extra == "dev"
-
 # plsqlwks
 
 An ncurses SQL and PL/SQL workspace for the local Oracle database.
 
-![PLSQLWKS PREVIEW](https://raw.githubusercontent.com/mtatton/plsqlwks/master/img/preview.gif)
+![PLSQLWKS PREVIEW](https://gitlab.com/unununu/plsqlwks/-/raw/main/img/preview.png)
 
 ## Connection
 
@@ -57,8 +40,10 @@ For development, install the package in editable mode:
 python3 -m pip install -e '.[dev]'
 ```
 
-See [RELEASING.md](RELEASING.md) for the quality, build, wheel-smoke, Oracle,
-and tagging checklist used for releases.
+`oracledb` is the only runtime dependency. Supporting functionality uses the Python standard library.
+
+See the [release checklist](https://gitlab.com/unununu/plsqlwks/-/blob/main/RELEASING.md)
+for the quality, packaging, and GitLab release process.
 
 For a regular local install, use:
 
@@ -219,6 +204,8 @@ Read-only mode is a client-side guardrail that rejects statements which the SQL
 
 When more result rows are available, `PageDown` at the loaded end fetches and appends the next result page. For simple single-table queries that select `ROWID`, press `Enter` on a non-`ROWID` cell to update that table column by rowid. Press `INS` in the grid to prepare a draft row at the top of the grid, edit its cells with `Enter`, use `Ctrl-Alt-C` to insert it, or use `Esc` to cancel it.
 Database null values are displayed and entered as `<NULL>` in editable results. Plain `NULL` is stored as literal text.
+Grid edits compare the typed value that was originally loaded as well as the `ROWID`. If another session changes or deletes the row first, the edit is rejected and the query must be refreshed. NUMBER input uses decimal notation with a period; DATE and TIMESTAMP input uses ISO `YYYY-MM-DD[ HH:MM:SS[.ffffff]]`; RAW and BLOB input uses hexadecimal bytes. 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.
+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. CSV export uses the displayed result values and therefore retains the same explicit LOB limit; schema-browser DDL is always read in full.
 `F7` cycles a grid fullscreen view that starts with the table header on the first terminal line and uses the last line for data, an editor-only fullscreen view, and a split layout with 2/3 editor and 1/3 data grid.
 
 ### Schema Browser

plsqlwks-0.1.2/license.txt

@@ -0,0 +1,64 @@
+plsqlwks Donationware License v1.0
+
+Copyright (c) 2026 unununu
+
+This license applies to the plsqlwks application source code and to original
+materials created by the copyright holder, except where a file, directory, or
+notice states otherwise.
+
+1. Permission
+
+Permission is hereby granted to any person obtaining a copy of this software and
+associated documentation files (the "Software") to use, copy, modify, merge,
+publish, distribute, and sublicense the Software, for personal, educational,
+internal business, and commercial purposes, subject to the conditions below.
+
+2. Donation Request
+
+The Software is provided as donationware. You are encouraged, but not required,
+to make a voluntary donation to support continued development, maintenance, and
+support of plsqlwks.
+
+A donation is a request for support and is not a condition of the rights granted
+under this license.
+
+3. Conditions
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+If you distribute modified versions of the Software, you must clearly indicate
+that changes were made and must not misrepresent the modified version as the
+original plsqlwks release.
+
+4. Third-party Content and Data
+
+This license does not grant rights to any third-party code, trademarks,
+databases, images, brand assets, or other content that may be bundled with or
+referenced by the Software, except as explicitly stated by their respective
+owners.
+
+If plsqlwks includes or uses third-party data, that data remains subject to its
+own license and attribution requirements. You are responsible for complying with
+those separate terms.
+
+5. Trademarks
+
+This license does not grant permission to use the names "plsqlwks" or the names,
+logos, or trademarks of the copyright holder, except as reasonably necessary to
+identify the Software.
+
+6. No Warranty
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM,
+OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+7. Acceptance
+
+By using, copying, modifying, or distributing the Software, you agree to the
+terms of this license.

{plsqlwks-0.1.1 → plsqlwks-0.1.2}/plsqlwks/__init__.py

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

{plsqlwks-0.1.1 → plsqlwks-0.1.2}/plsqlwks/db/__init__.py

@@ -12,6 +12,8 @@ from .editing import (
     TAIL_SINGLE_WORD_REJECTIONS,
     EditingMixin,
     build_editable_result_context,
+    convert_edit_value,
+    edit_metadata_rejection_reason,
     normalize_edit_value,
     normalize_identifier,
     parse_select_item,
@@ -26,15 +28,20 @@ from .execution import (
     ORACLE_IDENTIFIER_TOKEN_RE,
     ORACLE_QUALIFIED_IDENTIFIER_RE,
     ExecutionMixin,
+    LOB_DISPLAY_LIMIT,
+    column_metadata_from_description,
     csv_cell,
     execute_user_statement,
     fetch_plsql_compile_diagnostics,
     format_result_rows,
     format_value,
+    materialize_result_rows,
+    materialize_result_value,
     normalize_oracle_identifier,
     oracle_identifier_parts,
     plsql_compilation_error,
     plsql_object_from_create_statement,
+    read_lob_value,
 )
 from .explain import (
     ExplainMixin,
@@ -61,6 +68,8 @@ from .models import (
     DBMS_OUTPUT_FETCH_LINES,
     DBMS_OUTPUT_LINE_SIZE,
     NULL_DISPLAY_TOKEN,
+    CellUpdateResult,
+    ConcurrentEditError,
     EditOperationRollbackError,
     EditableResultContext,
     ExplainPlanCleanupError,
@@ -74,9 +83,12 @@ from .models import (
     QueryResultContinuation,
     QueryResultPage,
     ReadOnlyModeError,
+    ResultColumnMetadata,
+    RowInsertResult,
     SelectItem,
     SimpleSelect,
     TransactionReport,
+    TruncatedLobValue,
     format_compilation_error,
     format_compile_diagnostic,
 )
@@ -115,9 +127,12 @@ __all__ = [
     "DDL_KEYWORDS",
     "DIRECT_DML_KEYWORDS",
     "EditOperationRollbackError",
+    "CellUpdateResult",
+    "ConcurrentEditError",
     "EditableResultContext",
     "EditingMixin",
     "ExecutionMixin",
+    "LOB_DISPLAY_LIMIT",
     "ExplainMixin",
     "ExplainPlanCleanupError",
     "ExplainPlanResult",
@@ -140,6 +155,8 @@ __all__ = [
     "QueryResultContinuation",
     "QueryResultPage",
     "ReadOnlyModeError",
+    "ResultColumnMetadata",
+    "RowInsertResult",
     "SCHEMA_OBJECT_TYPES",
     "SelectItem",
     "SimpleSelect",
@@ -148,14 +165,18 @@ __all__ = [
     "TAIL_SINGLE_WORD_REJECTIONS",
     "TransactionMixin",
     "TransactionReport",
+    "TruncatedLobValue",
     "assemble_package_definition",
     "build_editable_result_context",
+    "column_metadata_from_description",
     "clean_ddl",
     "configure_metadata_transform",
     "connection_transaction_in_progress",
+    "convert_edit_value",
     "csv_cell",
     "edit_operation_savepoint",
     "empty_schema_object_groups",
+    "edit_metadata_rejection_reason",
     "ensure_sql_terminator",
     "execute_user_statement",
     "explain_plan_savepoint",
@@ -171,6 +192,8 @@ __all__ = [
     "is_oracle_identifier_char",
     "leading_sql_keyword",
     "metadata_object_type",
+    "materialize_result_rows",
+    "materialize_result_value",
     "normalize_edit_value",
     "normalize_identifier",
     "normalize_oracle_identifier",
@@ -185,6 +208,7 @@ __all__ = [
     "plsql_compilation_error",
     "plsql_object_from_create_statement",
     "read_only_rejection_reason",
+    "read_lob_value",
     "read_password",
     "rollback_explain_plan_savepoint",
     "scalar_var_value",