plsqlwks 0.1.0__tar.gz → 0.1.2__tar.gz

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

@@ -1,26 +1,31 @@
 Metadata-Version: 2.4
 Name: plsqlwks
-Version: 0.1.0
+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
-Requires-Dist: platformdirs>=4.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"
+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
 
@@ -58,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:
 
@@ -220,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.0/PKG-INFO → plsqlwks-0.1.2/README.md

@@ -1,26 +1,8 @@
-Metadata-Version: 2.4
-Name: plsqlwks
-Version: 0.1.0
-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
-Requires-Dist: platformdirs>=4.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
 
@@ -58,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:
 
@@ -220,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.0 → plsqlwks-0.1.2}/plsqlwks/__init__.py

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

{plsqlwks-0.1.0 → plsqlwks-0.1.2}/plsqlwks/config/__init__.py

@@ -9,8 +9,6 @@ import stat
 import tempfile
 from typing import Sequence
 
-from platformdirs import user_config_path, user_data_path
-
 from .loader import DEFAULT_DSN, load_config
 from .models import AppConfig, SessionTab
 from .paths import (
@@ -28,6 +26,8 @@ from .paths import (
     resolve_password_file,
     resolve_workspace,
     source_workspace_dir,
+    user_config_path,
+    user_data_path,
 )
 from .session import (
     SESSION_TAB_PATH_PATTERN,

{plsqlwks-0.1.0 → plsqlwks-0.1.2}/plsqlwks/config/paths.py

@@ -3,8 +3,7 @@ from __future__ import annotations
 import os
 from pathlib import Path
 import stat
-
-from platformdirs import user_config_path, user_data_path
+import sys
 
 
 APP_NAME = "plsqlwks"
@@ -47,6 +46,107 @@ def is_legacy_source_workspace(path: Path) -> bool:
     return (path.parent / SOURCE_CHECKOUT_MARKER).is_file() and is_legacy_workspace(path)
 
 
+def user_config_path(
+    appname: str | None = None,
+    appauthor: str | bool | None = None,
+    version: str | None = None,
+    roaming: bool = False,
+    ensure_exists: bool = False,
+) -> Path:
+    return _user_path(
+        appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        kind="config",
+    )
+
+
+def user_data_path(
+    appname: str | None = None,
+    appauthor: str | bool | None = None,
+    version: str | None = None,
+    roaming: bool = False,
+    ensure_exists: bool = False,
+) -> Path:
+    return _user_path(
+        appname,
+        appauthor=appauthor,
+        version=version,
+        roaming=roaming,
+        ensure_exists=ensure_exists,
+        kind="data",
+    )
+
+
+def _user_path(
+    appname: str | None,
+    *,
+    appauthor: str | bool | None,
+    version: str | None,
+    roaming: bool,
+    ensure_exists: bool,
+    kind: str,
+) -> Path:
+    path = _user_path_root(kind, roaming=roaming)
+    if appname:
+        if sys.platform == "win32" and appauthor is not False:
+            author = appauthor if isinstance(appauthor, str) and appauthor else appname
+            path /= author
+        path /= appname
+        if version:
+            path /= version
+    if ensure_exists:
+        path.mkdir(parents=True, exist_ok=True)
+    return path
+
+
+def _user_path_root(kind: str, *, roaming: bool) -> Path:
+    if sys.platform == "win32":
+        known_folder = _windows_known_folder(roaming=roaming)
+        if known_folder is not None:
+            return known_folder
+        environment_name = "APPDATA" if roaming else "LOCALAPPDATA"
+        configured = _environment_path(environment_name)
+        if configured is not None:
+            return configured
+        folder = "Roaming" if roaming else "Local"
+        return _home_path() / "AppData" / folder
+    if sys.platform == "darwin":
+        return _home_path() / "Library" / "Application Support"
+    environment_name = "XDG_CONFIG_HOME" if kind == "config" else "XDG_DATA_HOME"
+    configured = _environment_path(environment_name)
+    if configured is not None:
+        return configured
+    suffix = (".config",) if kind == "config" else (".local", "share")
+    return _home_path().joinpath(*suffix)
+
+
+def _environment_path(name: str) -> Path | None:
+    value = nonblank_environment_value(name)
+    return Path(value) if value is not None else None
+
+
+def _windows_known_folder(*, roaming: bool) -> Path | None:
+    if os.name != "nt":
+        return None
+    try:
+        import ctypes
+
+        buffer = ctypes.create_unicode_buffer(260)
+        shell32 = getattr(getattr(ctypes, "windll"), "shell32")
+        csidl = 26 if roaming else 28
+        result = shell32.SHGetFolderPathW(None, csidl, None, 0, buffer)
+    except (AttributeError, OSError):
+        return None
+    return Path(buffer.value) if result == 0 and buffer.value else None
+
+
+def _home_path() -> Path:
+    return Path.home()
+
+
 def platform_workspace_dir() -> Path:
     return user_data_path(APP_NAME, appauthor=False)
 

{plsqlwks-0.1.0 → 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",