mycli 2.18.4__tar.gz → 2.19.0__tar.gz

{mycli-2.18.4 → mycli-2.19.0}/.github/workflows/ci.yml

@@ -151,7 +151,8 @@ jobs:
       - uses: vampire/setup-wsl@d1da7f2c0322a5ee4f24975344f67fc0f5baf364 # v7.0.0
         with:
           distribution: Ubuntu-24.04
-          update: 'true'
+          use-cache: 'true'
+          update: 'false'
           additional-packages: |
             curl
             git
@@ -165,7 +166,7 @@ jobs:
         run: |
           mkdir -p /root/mycli
 
-      - uses: ubuntu/wsl/.github/actions/wsl-checkout@e2114d0a5ebea62e6b2e1565f175871ed7558d20
+      - uses: ubuntu/wsl/.github/actions/wsl-checkout@3b7a6b2a43af18aa541eeee1669ac27656630097
         with:
           distro: Ubuntu-24.04
           working-dir: /root/mycli

{mycli-2.18.4 → mycli-2.19.0}/.github/workflows/publish.yml

@@ -159,7 +159,8 @@ jobs:
     - uses: vampire/setup-wsl@d1da7f2c0322a5ee4f24975344f67fc0f5baf364 # v7.0.0
       with:
         distribution: Ubuntu-24.04
-        update: 'true'
+        use-cache: 'true'
+        update: 'false'
         additional-packages: |
           curl
           git
@@ -173,7 +174,7 @@ jobs:
       run: |
         mkdir -p /root/mycli
 
-    - uses: ubuntu/wsl/.github/actions/wsl-checkout@e2114d0a5ebea62e6b2e1565f175871ed7558d20
+    - uses: ubuntu/wsl/.github/actions/wsl-checkout@3b7a6b2a43af18aa541eeee1669ac27656630097
       with:
         distro: Ubuntu-24.04
         working-dir: /root/mycli

{mycli-2.18.4/mycli.egg-info → mycli-2.19.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mycli
-Version: 2.18.4
+Version: 2.19.0
 Summary: Rich MySQL terminal client with autocompletion, syntax highlighting, and dataframes
 Author: Mycli Core Team
 License-Expression: BSD-3-Clause
@@ -28,15 +28,15 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE.txt
 License-File: AUTHORS.rst
-Requires-Dist: click~=8.3.3
+Requires-Dist: click~=8.5.0
 Requires-Dist: clickdc~=0.1.1
 Requires-Dist: cryptography~=50.0.0
 Requires-Dist: Pygments~=2.21.0
 Requires-Dist: prompt_toolkit<4.0.0,>=3.0.41
 Requires-Dist: PyMySQL~=1.1.2
-Requires-Dist: sqlparse<0.6.0,>=0.3.0
-Requires-Dist: sqlglot~=30.12.0
-Requires-Dist: sqlglotc~=30.12.0
+Requires-Dist: sqlparse~=0.6.0
+Requires-Dist: sqlglot~=30.17.0
+Requires-Dist: sqlglotc~=30.17.0
 Requires-Dist: configobj~=5.0.9
 Requires-Dist: cli_helpers[styles]~=2.15.1
 Requires-Dist: wcwidth~=0.8.2
@@ -50,9 +50,9 @@ Requires-Dist: yaspin~=3.4.0
 Provides-Extra: llm
 Requires-Dist: llm~=0.33; extra == "llm"
 Requires-Dist: setuptools==83.*; extra == "llm"
-Requires-Dist: pip~=26.1.2; extra == "llm"
+Requires-Dist: pip~=26.2.1; extra == "llm"
 Provides-Extra: dataframe
-Requires-Dist: polars~=1.42.1; extra == "dataframe"
+Requires-Dist: polars~=1.44.1; extra == "dataframe"
 Requires-Dist: altair~=6.2.2; extra == "dataframe"
 Requires-Dist: vl-convert-python~=1.9.0; extra == "dataframe"
 Provides-Extra: all
@@ -75,7 +75,7 @@ Dynamic: license-file
 [![Build Status](https://github.com/dbcli/mycli/workflows/mycli/badge.svg)](https://github.com/dbcli/mycli/actions?query=workflow%3Amycli)
 [![License](https://img.shields.io/github/license/dbcli/mycli.svg)](https://github.com/dbcli/mycli/blob/main/LICENSE.txt)
 
-A command line client for MySQL with auto-completion and syntax highlighting.
+Rich MySQL terminal client with auto-completion, syntax highlighting, and dataframes.
 
 Homepage: [https://mycli.net](https://mycli.net)
 
@@ -93,14 +93,12 @@ Mycli is compatible with MySQL, MariaDB, Percona, TiDB, and Apache Doris.
 
 Postgres Equivalent: [https://pgcli.com](https://pgcli.com)
 
-Release 2.x
------------
+# Release 2.x
 
 Release 2.0.0 has [breaking changes](https://github.com/dbcli/mycli/blob/v2.0.0/changelog.md#breaking-changes)!
 
 
-Quick Start
------------
+# Quick Start
 
 If you already know how to install Python packages, then you can install mycli
 via `pip`.  This package is always up to date.
@@ -111,19 +109,19 @@ You might need `sudo` on Linux.
 pip install --upgrade 'mycli[all]'
 ```
 
-or, only on macOS (`pygments` is optional but recommended):
+or, on macOS (`pygments` is optional but recommended):
 
 ```bash
 brew update && brew install mycli pygments
 ```
 
-or, only on Debian or Ubuntu (`fzf` and `pygments` are optional but recommended):
+or, on Debian or Ubuntu (`fzf` and `pygments` are optional but recommended):
 
 ```bash
 sudo apt-get install mycli fzf python3-pygments
 ```
 
-### Usage
+# Usage
 
 See
 
@@ -131,11 +129,9 @@ See
 mycli --help
 ```
 
-Features
---------
+# Features
 
-* Auto-completion as you type for SQL keywords as well as tables, views,
-  columns, enums, and more!
+* Auto-completion as you type for SQL keywords as well as tables, views, columns, enums, and more!
 * Fuzzy history search using [fzf](https://github.com/junegunn/fzf).
 * Output explorer using [fzf](https://github.com/junegunn/fzf) or other tools.
 * Syntax highlighting using [Pygments](https://pygments.org/).
@@ -147,8 +143,8 @@ Features
   `/fs <alias> <query>` and execute it with `/f <alias>` or `/f <alias> --key=value`.
 * Timing of sql statements and table rendering.
 * Log every query and its results to a file (disabled by default).
-* Pretty print tabular data (with colors!).
-* Support for SSL connections
+* Pretty print tabular data with colors.
+* Support for SSL connections.
 * Shell-style trailing redirects with `$>`, `$>>` and `$|` operators.
 * [Polars](https://pola.rs) dataframe [transforms and plots](https://github.com/dbcli/mycli/blob/main/doc/transforms.md) with `.|`, and Parquet saves with `.>`.
 * Support for [querying LLMs](https://www.mycli.net/llm) with context derived from your schema using `/llm`.
@@ -160,14 +156,7 @@ options in that file to configure the above features, and more.
 Some features are only exposed as [key bindings](https://github.com/dbcli/mycli/blob/main/doc/key_bindings.rst).
 
 
-Implementation
---------------
-
-`mycli` is written using [prompt_toolkit](https://github.com/jonathanslenders/python-prompt-toolkit/) and other Python libraries.
-
-
-Contributions
--------------
+# Contributions
 
 If you're interested in contributing to this project, first of all we would like
 to extend our heartfelt gratitude. We've written a small doc to describe how to
@@ -175,9 +164,9 @@ get mycli running in a development setup.
 
 https://github.com/dbcli/mycli/blob/main/CONTRIBUTING.md
 
-## Additional Install Instructions
+# Additional Install Instructions
 
-### Shell Completions
+## Shell Completions
 
 If installed via Homebrew, shell completions [may already be configured](https://docs.brew.sh/Shell-Completion).
 
@@ -203,7 +192,7 @@ team but provided by OS package maintainers.  OS packages could be considerably
 out of date.
 
 If present, the `fzf` package can be used for fuzzy history search, and as an
-output "explorer" with the `\x` special command. `pygemtize` can be used for
+output "explorer" with the `\x` special command. `pygmentize` can be used for
 syntax highlighting within the fuzzy history search.  The `less` package is
 also expected, but almost always already installed.
 
@@ -271,7 +260,7 @@ pip install --upgrade 'mycli[all]'
 
 PRs to complete WSL support would be welcome!
 
-### Thanks
+# Thanks
 
 This project was funded through Kickstarter. Our thanks to the [backers](https://mycli.net/sponsors) who supported the project.
 
@@ -287,7 +276,7 @@ and printing error messages.
 Thanks to [PyMysql](https://github.com/PyMySQL/PyMySQL) for a pure Python adapter to MySQL databases.
 
 
-### Compatibility
+# Compatibility
 
 Mycli is tested on macOS (full), Linux (full), Windows (partial), and WSL
 (partial), and requires Python 3.10 or better.
@@ -301,9 +290,9 @@ following in `~/.myclirc`:
 default_character_set = utf8
 ```
 
-or set `--charset=utf8` when invoking mycli
+or use `--charset=utf8` when invoking mycli.
 
-### Configuration and Usage
+# Configuration and Usage
 
 For more information on using and configuring mycli, [check out our documentation](https://mycli.net/docs).
 

{mycli-2.18.4 → mycli-2.19.0}/README.md

@@ -3,7 +3,7 @@
 [![Build Status](https://github.com/dbcli/mycli/workflows/mycli/badge.svg)](https://github.com/dbcli/mycli/actions?query=workflow%3Amycli)
 [![License](https://img.shields.io/github/license/dbcli/mycli.svg)](https://github.com/dbcli/mycli/blob/main/LICENSE.txt)
 
-A command line client for MySQL with auto-completion and syntax highlighting.
+Rich MySQL terminal client with auto-completion, syntax highlighting, and dataframes.
 
 Homepage: [https://mycli.net](https://mycli.net)
 
@@ -21,14 +21,12 @@ Mycli is compatible with MySQL, MariaDB, Percona, TiDB, and Apache Doris.
 
 Postgres Equivalent: [https://pgcli.com](https://pgcli.com)
 
-Release 2.x
------------
+# Release 2.x
 
 Release 2.0.0 has [breaking changes](https://github.com/dbcli/mycli/blob/v2.0.0/changelog.md#breaking-changes)!
 
 
-Quick Start
------------
+# Quick Start
 
 If you already know how to install Python packages, then you can install mycli
 via `pip`.  This package is always up to date.
@@ -39,19 +37,19 @@ You might need `sudo` on Linux.
 pip install --upgrade 'mycli[all]'
 ```
 
-or, only on macOS (`pygments` is optional but recommended):
+or, on macOS (`pygments` is optional but recommended):
 
 ```bash
 brew update && brew install mycli pygments
 ```
 
-or, only on Debian or Ubuntu (`fzf` and `pygments` are optional but recommended):
+or, on Debian or Ubuntu (`fzf` and `pygments` are optional but recommended):
 
 ```bash
 sudo apt-get install mycli fzf python3-pygments
 ```
 
-### Usage
+# Usage
 
 See
 
@@ -59,11 +57,9 @@ See
 mycli --help
 ```
 
-Features
---------
+# Features
 
-* Auto-completion as you type for SQL keywords as well as tables, views,
-  columns, enums, and more!
+* Auto-completion as you type for SQL keywords as well as tables, views, columns, enums, and more!
 * Fuzzy history search using [fzf](https://github.com/junegunn/fzf).
 * Output explorer using [fzf](https://github.com/junegunn/fzf) or other tools.
 * Syntax highlighting using [Pygments](https://pygments.org/).
@@ -75,8 +71,8 @@ Features
   `/fs <alias> <query>` and execute it with `/f <alias>` or `/f <alias> --key=value`.
 * Timing of sql statements and table rendering.
 * Log every query and its results to a file (disabled by default).
-* Pretty print tabular data (with colors!).
-* Support for SSL connections
+* Pretty print tabular data with colors.
+* Support for SSL connections.
 * Shell-style trailing redirects with `$>`, `$>>` and `$|` operators.
 * [Polars](https://pola.rs) dataframe [transforms and plots](https://github.com/dbcli/mycli/blob/main/doc/transforms.md) with `.|`, and Parquet saves with `.>`.
 * Support for [querying LLMs](https://www.mycli.net/llm) with context derived from your schema using `/llm`.
@@ -88,14 +84,7 @@ options in that file to configure the above features, and more.
 Some features are only exposed as [key bindings](https://github.com/dbcli/mycli/blob/main/doc/key_bindings.rst).
 
 
-Implementation
---------------
-
-`mycli` is written using [prompt_toolkit](https://github.com/jonathanslenders/python-prompt-toolkit/) and other Python libraries.
-
-
-Contributions
--------------
+# Contributions
 
 If you're interested in contributing to this project, first of all we would like
 to extend our heartfelt gratitude. We've written a small doc to describe how to
@@ -103,9 +92,9 @@ get mycli running in a development setup.
 
 https://github.com/dbcli/mycli/blob/main/CONTRIBUTING.md
 
-## Additional Install Instructions
+# Additional Install Instructions
 
-### Shell Completions
+## Shell Completions
 
 If installed via Homebrew, shell completions [may already be configured](https://docs.brew.sh/Shell-Completion).
 
@@ -131,7 +120,7 @@ team but provided by OS package maintainers.  OS packages could be considerably
 out of date.
 
 If present, the `fzf` package can be used for fuzzy history search, and as an
-output "explorer" with the `\x` special command. `pygemtize` can be used for
+output "explorer" with the `\x` special command. `pygmentize` can be used for
 syntax highlighting within the fuzzy history search.  The `less` package is
 also expected, but almost always already installed.
 
@@ -199,7 +188,7 @@ pip install --upgrade 'mycli[all]'
 
 PRs to complete WSL support would be welcome!
 
-### Thanks
+# Thanks
 
 This project was funded through Kickstarter. Our thanks to the [backers](https://mycli.net/sponsors) who supported the project.
 
@@ -215,7 +204,7 @@ and printing error messages.
 Thanks to [PyMysql](https://github.com/PyMySQL/PyMySQL) for a pure Python adapter to MySQL databases.
 
 
-### Compatibility
+# Compatibility
 
 Mycli is tested on macOS (full), Linux (full), Windows (partial), and WSL
 (partial), and requires Python 3.10 or better.
@@ -229,9 +218,9 @@ following in `~/.myclirc`:
 default_character_set = utf8
 ```
 
-or set `--charset=utf8` when invoking mycli
+or use `--charset=utf8` when invoking mycli.
 
-### Configuration and Usage
+# Configuration and Usage
 
 For more information on using and configuring mycli, [check out our documentation](https://mycli.net/docs).
 

{mycli-2.18.4 → mycli-2.19.0}/changelog.md

@@ -1,3 +1,42 @@
+2.19.0 (2026/09/02)
+==============
+
+Features
+--------
+* Add `/ping` special command.
+* Hide timings after `/system clear`.
+
+
+Documentation
+--------
+* Minor edits to `README.md`.
+* Add `/system` special cases to TIPS.
+
+
+Internal
+---------
+* Upgrade `polars` dependency to v1.44.1.
+* Upgrade `sqlparse` dependency to v0.6.0.
+* Upgrade optional `pip` dependency to v26.2.1.
+* Use cache and turn off distro update for WSL tests in CI.
+* Upgrade `click` dependency to v8.5.0.
+
+
+2.18.5 (2026/08/31)
+==============
+
+Bug Fixes
+--------
+* Fix incomplete release of Boundary tunnels from beta.
+
+
+Internal
+---------
+* Upgrade `sqlglot` to v30.17.0.
+* Remove `pyproject.toml` llm library cooldown policy exceptions.
+* Upgrade `polars` to v1.43.2.
+
+
 2.18.4 (2026/08/29)
 ==============
 

{mycli-2.18.4 → mycli-2.19.0}/mycli/TIPS

@@ -106,6 +106,10 @@ use /tee or /notee to write/stop-writing results to a output file!
 
 use "/system <command>" to execute a shell command!
 
+use "/system cd" to change the working directory!
+
+use "/system clear" to clear the screen!
+
 /T or /tableformat changes the interactive table format!
 
 /u or /use changes to a new database!
@@ -118,6 +122,8 @@ use /dsn to manage saved DSNs!
 
 use /config to inspect persistent configuration from the REPL!
 
+/ping checks the health of the connection!
+
 ###
 ### environment variables
 ###

{mycli-2.18.4 → mycli-2.19.0}/mycli/client_commands.py

@@ -44,6 +44,7 @@ SOURCE_SAFE_SPECIAL_COMMANDS = frozenset({
     'help',
     'l',
     'nowarnings',
+    'ping',
     'prompt',
     'redirectformat',
     'rehash',

{mycli-2.18.4 → mycli-2.19.0}/mycli/client_connection.py

@@ -132,12 +132,12 @@ class ClientConnectionMixin:
                 sys.exit(1)
         elif boundary_target_id:
             use_keyring = False
-            boundary_executable = self.config.get('boundary_beta', {}).get('boundary_executable', 'boundary') or 'boundary'
-            boundary_address = self.config.get('boundary_beta', {}).get('address') or None
-            boundary_auth_method_id = self.config.get('boundary_beta', {}).get('auth_method_id') or None
-            boundary_options = self.config.get('boundary_beta', {}).get('boundary_options') or None
-            boundary_test_command = self.config.get('boundary_beta', {}).get('boundary_test_command') or None
-            boundary_auth_command = self.config.get('boundary_beta', {}).get('boundary_auth_command') or None
+            boundary_executable = self.config.get('boundary', {}).get('boundary_executable', 'boundary') or 'boundary'
+            boundary_address = self.config.get('boundary', {}).get('address') or None
+            boundary_auth_method_id = self.config.get('boundary', {}).get('auth_method_id') or None
+            boundary_options = self.config.get('boundary', {}).get('boundary_options') or None
+            boundary_test_command = self.config.get('boundary', {}).get('boundary_test_command') or None
+            boundary_auth_command = self.config.get('boundary', {}).get('boundary_auth_command') or None
             try:
                 self.boundary_tunnel = BoundaryTunnel(
                     target_id=boundary_target_id,

{mycli-2.18.4 → mycli-2.19.0}/mycli/main_modes/batch.py

@@ -214,9 +214,8 @@ def main_batch_without_progress_bar(mycli: 'MyCli', cli_args: 'CliArgs') -> int:
 
 
 def main_batch_from_stdin(mycli: 'MyCli', cli_args: 'CliArgs') -> int:
-    batch_h = click.get_text_stream('stdin')
     try:
-        for statement, counter in statements_from_filehandle(batch_h):
+        for statement, counter in statements_from_filehandle(sys.stdin):
             dispatch_batch_statements(mycli, cli_args, statement, counter)
     except (ValueError, StopIteration, IOError, OSError, pymysql.err.Error) as e:
         click.secho(str(e), err=True, fg='red')

{mycli-2.18.4 → mycli-2.19.0}/mycli/packages/special/__init__.py

@@ -10,6 +10,7 @@ import os
 from mycli.packages.special.dbcommands import (
     list_databases,
     list_tables,
+    ping,
     status,
 )
 from mycli.packages.special.iocommands import (
@@ -118,6 +119,7 @@ __all__: list[str] = [
     'list_tables',
     'open_external_editor',
     'parse_special_command',
+    'ping',
     'register_special_command',
     'run_post_redirect_hook',
     'set_delimiter',

{mycli-2.18.4 → mycli-2.19.0}/mycli/packages/special/dbcommands.py

@@ -2,7 +2,7 @@ import logging
 import os
 import platform
 
-from pymysql import ProgrammingError
+from pymysql import Error, ProgrammingError
 from pymysql.cursors import Cursor
 
 from mycli import __version__
@@ -80,6 +80,24 @@ def list_databases(cur: Cursor, **_) -> list[SQLResult]:
         return [SQLResult()]
 
 
+@special_command(
+    r'\ping',
+    '/ping',
+    'Check the connection.',
+    arg_type=ArgType.PARSED_QUERY,
+    completion_snippet='check connection',
+)
+def ping(cur: Cursor, arg: str | None = None, **_) -> list[SQLResult]:
+    if arg:
+        return [SQLResult(status='Syntax: /ping.')]
+
+    try:
+        cur.connection.ping(reconnect=False)
+    except Error:
+        return [SQLResult(status='Not connected')]
+    return [SQLResult(status='Connected')]
+
+
 @special_command(
     "status",
     "/status",

{mycli-2.18.4 → mycli-2.19.0}/mycli/packages/special/iocommands.py

@@ -787,8 +787,9 @@ def execute_system_command(arg: str, **_) -> list[SQLResult]:
             completed_process = subprocess.run(command, check=False)
             if completed_process.returncode:
                 return [SQLResult(status=f'Command exited with return code {completed_process.returncode}')]
-            else:
-                return [SQLResult()]
+            if command[0].lower() == 'clear':
+                return []
+            return [SQLResult()]
         else:
             process = subprocess.Popen(command, stdout=subprocess.PIPE, stderr=subprocess.PIPE)
             try: