mycli 2.0.0__tar.gz → 2.1.1__tar.gz

{mycli-2.0.0 → mycli-2.1.1}/.github/workflows/ci.yml

@@ -24,7 +24,7 @@ jobs:
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
         with:
           version: "latest"
 
@@ -66,7 +66,7 @@ jobs:
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
         with:
           version: "latest"
 
@@ -116,7 +116,7 @@ jobs:
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
         with:
           version: 'latest'
 
@@ -219,7 +219,7 @@ jobs:
     steps:
       - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
         with:
           version: "latest"
 

{mycli-2.0.0 → mycli-2.1.1}/.github/workflows/lint.yml

@@ -21,9 +21,9 @@ jobs:
         uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
       - name: Run ruff check
-        uses: astral-sh/ruff-action@0ce1b0bf8b818ef400413f810f8a11cdbda0034b # v4.0.0
+        uses: astral-sh/ruff-action@278981a28ce3188b1e39527901f38254bf3aac89 # v4.1.0
 
       - name: Run ruff format
-        uses: astral-sh/ruff-action@0ce1b0bf8b818ef400413f810f8a11cdbda0034b # v4.0.0
+        uses: astral-sh/ruff-action@278981a28ce3188b1e39527901f38254bf3aac89 # v4.1.0
         with:
           args: 'format --check'

{mycli-2.0.0 → mycli-2.1.1}/.github/workflows/publish.yml

@@ -29,7 +29,7 @@ jobs:
 
     steps:
     - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
-    - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+    - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
       with:
         version: "latest"
 
@@ -74,7 +74,7 @@ jobs:
     steps:
     - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-    - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+    - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
       with:
         version: "latest"
 
@@ -124,7 +124,7 @@ jobs:
     steps:
     - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
 
-    - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+    - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
       with:
         version: 'latest'
 
@@ -226,7 +226,7 @@ jobs:
 
     steps:
     - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
-    - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+    - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
       with:
         version: "latest"
 

{mycli-2.0.0 → mycli-2.1.1}/.github/workflows/typecheck.yml

@@ -25,7 +25,7 @@ jobs:
         with:
           python-version: '3.14'
 
-      - uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
+      - uses: astral-sh/setup-uv@f98e06938123ccabd21905ea5d0069192241f9f1 # v8.3.1
         with:
           version: 'latest'
 

{mycli-2.0.0/mycli.egg-info → mycli-2.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mycli
-Version: 2.0.0
+Version: 2.1.1
 Summary: CLI for MySQL Database. With auto-completion and syntax highlighting.
 Author: Mycli Core Team
 License-Expression: BSD-3-Clause

{mycli-2.0.0 → mycli-2.1.1}/changelog.md

@@ -1,3 +1,24 @@
+2.1.1 (2026/07/08)
+==============
+
+Breaking Changes
+---------
+* Remove undocumented support for `tcp://` and `socket://` DSNs.
+
+
+Features
+---------
+* Add `--ssh-jump` CLI argument, restoring SSH jump functionality.
+* Add a `/dsn` command to manage persisted DSN aliases.
+* Add `auto` option to ignore keyring when inside an SSH session.
+
+
+Documentation
+---------
+* Fix a typo in myclirc commentary.
+* Advertise forward-slash command forms in more places.
+
+
 2.0.0 (2026/07/03)
 ==============
 

{mycli-2.0.0 → mycli-2.1.1}/mycli/TIPS

@@ -20,7 +20,7 @@ the --character-set option sets the character set for a single session!
 
 the --unbuffered flag can save memory when in batch mode!
 
---use-keyring=true lets you access the system keyring for passwords!
+--use-keyring=auto lets you access the system keyring for passwords!
 
 --use-keyring=reset resets a password saved to the system keyring!
 
@@ -108,6 +108,8 @@ the /watch command executes a query every N seconds!
 
 use /bug to file a bug on GitHub!
 
+use /dsn to manage saved DSNs!
+
 ###
 ### environment variables
 ###

{mycli-2.0.0 → mycli-2.1.1}/mycli/cli_runner.py

@@ -304,52 +304,70 @@ def run_from_cli_args(cli_args: 'CliArgs', client_factory: ClientFactory) -> Non
     if cli_args.use_keyring is not None and cli_args.use_keyring.lower() == 'reset':
         use_keyring = True
         reset_keyring = True
+    elif cli_args.use_keyring is not None and cli_args.use_keyring.lower() == 'auto':
+        if os.environ.get('SSH_CONNECTION'):
+            use_keyring = False
+            reset_keyring = False
+        else:
+            use_keyring = True
+            reset_keyring = False
     elif cli_args.use_keyring is None:
-        use_keyring = str_to_bool(mycli.config['main'].get('use_keyring', 'False'))
-        reset_keyring = False
+        if mycli.config['main'].get('use_keyring', 'False').lower() == 'auto':
+            if os.environ.get('SSH_CONNECTION'):
+                use_keyring = False
+                reset_keyring = False
+            else:
+                use_keyring = True
+                reset_keyring = False
+        else:
+            use_keyring = str_to_bool(mycli.config['main'].get('use_keyring', 'False'))
+            reset_keyring = False
     else:
         use_keyring = str_to_bool(cli_args.use_keyring)
         reset_keyring = False
 
-    mycli.connect(
-        database=database,
-        user=cli_args.user,
-        passwd=cli_args.password,
-        host=cli_args.host,
-        port=cli_args.port,
-        socket=cli_args.socket,
-        local_infile=cli_args.local_infile,
-        ssl=ssl,
-        init_command=combined_init_cmd,
-        unbuffered=cli_args.unbuffered,
-        character_set=cli_args.character_set,
-        use_keyring=use_keyring,
-        reset_keyring=reset_keyring,
-        keepalive_ticks=keepalive_ticks,
-    )
-
-    if combined_init_cmd:
-        click.echo(f"Executing init-command: {combined_init_cmd}", err=True)
-
-    mycli.logger.debug(
-        "Launch Params: \n\tdatabase: %r\tuser: %r\thost: %r\tport: %r",
-        database,
-        cli_args.user,
-        cli_args.host,
-        cli_args.port,
-    )
+    try:
+        mycli.connect(
+            database=database,
+            user=cli_args.user,
+            passwd=cli_args.password,
+            host=cli_args.host,
+            port=cli_args.port,
+            socket=cli_args.socket,
+            local_infile=cli_args.local_infile,
+            ssl=ssl,
+            init_command=combined_init_cmd,
+            unbuffered=cli_args.unbuffered,
+            character_set=cli_args.character_set,
+            use_keyring=use_keyring,
+            reset_keyring=reset_keyring,
+            keepalive_ticks=keepalive_ticks,
+            ssh_jump=cli_args.ssh_jump,
+        )
+
+        if combined_init_cmd:
+            click.echo(f"Executing init-command: {combined_init_cmd}", err=True)
+
+        mycli.logger.debug(
+            "Launch Params: \n\tdatabase: %r\tuser: %r\thost: %r\tport: %r",
+            database,
+            cli_args.user,
+            cli_args.host,
+            cli_args.port,
+        )
 
-    if cli_args.execute is not None:
-        sys.exit(main_execute_from_cli(mycli, cli_args))
+        if cli_args.execute is not None:
+            sys.exit(main_execute_from_cli(mycli, cli_args))
 
-    if cli_args.batch is not None and cli_args.batch != '-' and cli_args.progress and sys.stderr.isatty():
-        sys.exit(main_batch_with_progress_bar(mycli, cli_args))
+        if cli_args.batch is not None and cli_args.batch != '-' and cli_args.progress and sys.stderr.isatty():
+            sys.exit(main_batch_with_progress_bar(mycli, cli_args))
 
-    if cli_args.batch is not None:
-        sys.exit(main_batch_without_progress_bar(mycli, cli_args))
+        if cli_args.batch is not None:
+            sys.exit(main_batch_without_progress_bar(mycli, cli_args))
 
-    if not sys.stdin.isatty():
-        sys.exit(main_batch_from_stdin(mycli, cli_args))
+        if not sys.stdin.isatty():
+            sys.exit(main_batch_from_stdin(mycli, cli_args))
 
-    mycli.run_cli()
-    mycli.close()
+        mycli.run_cli()
+    finally:
+        mycli.close()

{mycli-2.0.0 → mycli-2.1.1}/mycli/client.py

@@ -35,11 +35,13 @@ from mycli.constants import DEFAULT_PROMPT
 from mycli.main_modes import repl as repl_package
 from mycli.output import OutputMixin
 from mycli.packages import special
+from mycli.packages.special.dsn_aliases import DsnAliases
 from mycli.packages.special.favoritequeries import FavoriteQueries
 from mycli.packages.tabular_output import sql_format
 from mycli.schema_prefetcher import SchemaPrefetcher
 from mycli.sqlcompleter import SQLCompleter
 from mycli.sqlexecute import SQLExecute
+from mycli.ssh_tunnel import SshTunnel
 from mycli.types import Query
 
 sqlparse.engine.grouping.MAX_GROUPING_DEPTH = None  # type: ignore[assignment]
@@ -75,6 +77,7 @@ class MyCli(AppStateMixin, OutputMixin, ClientCommandsMixin, ClientConnectionMix
         cli_verbosity: int = 0,
     ) -> None:
         self.sqlexecute = sqlexecute
+        self.ssh_tunnel: SshTunnel | None = None
         self.logfile = logfile
         self.login_path = login_path
         self.toolbar_error_message: str | None = None
@@ -106,6 +109,7 @@ class MyCli(AppStateMixin, OutputMixin, ClientCommandsMixin, ClientConnectionMix
         self.default_keepalive_ticks = c['connection'].as_int('default_keepalive_ticks')
 
         FavoriteQueries.instance = FavoriteQueries.from_config(self.config)
+        DsnAliases.instance = DsnAliases.from_config(self.config)
 
         self.dsn_alias: str | None = None
         self.main_formatter = TabularOutputFormatter(format_name=c["main"]["table_format"])
@@ -198,10 +202,20 @@ class MyCli(AppStateMixin, OutputMixin, ClientCommandsMixin, ClientConnectionMix
         special.set_destructive_keywords(self.destructive_keywords)
 
     def close(self) -> None:
-        if hasattr(self, 'schema_prefetcher'):
+        try:
             self.schema_prefetcher.stop()
+        except Exception:
+            pass
         if self.sqlexecute is not None:
-            self.sqlexecute.close()
+            try:
+                self.sqlexecute.close()
+            except Exception:
+                pass
+        if self.ssh_tunnel is not None:
+            try:
+                self.ssh_tunnel.close()
+            except Exception:
+                pass
 
     def run_cli(self) -> None:
         repl_package.main_repl(self)

{mycli-2.0.0 → mycli-2.1.1}/mycli/client_connection.py

@@ -4,6 +4,7 @@ import os
 import sys
 import traceback
 from typing import TYPE_CHECKING, Any
+from urllib.parse import quote as urlquote
 
 import click
 import keyring
@@ -22,6 +23,7 @@ from mycli.constants import (
 )
 from mycli.packages.filepaths import guess_socket_location
 from mycli.sqlexecute import SQLExecute
+from mycli.ssh_tunnel import SshTunnel, SshTunnelError
 
 try:
     from pwd import getpwuid
@@ -58,6 +60,7 @@ class ClientConnectionMixin:
         use_keyring: bool | None = None,
         reset_keyring: bool | None = None,
         keepalive_ticks: int | None = None,
+        ssh_jump: str | None = None,
     ) -> None:
         mylogin_cnf: dict[str, Any] = self.read_mylogin_cnf(self.mylogin_cnf)
         # Fall back to .mylogin.cnf values only if user did not specify a value.
@@ -67,6 +70,7 @@ class ClientConnectionMixin:
         ssl_config: dict[str, Any] = ssl or {}
         user_connection_config = self.config_without_package_defaults.get('connection', {})
         self.keepalive_ticks = keepalive_ticks
+        self.ssh_tunnel = None
 
         int_port = port and int(port)
         if not int_port:
@@ -74,6 +78,31 @@ class ClientConnectionMixin:
             if not host or host == DEFAULT_HOST:
                 socket = socket or user_connection_config.get("default_socket") or mylogin_cnf["socket"] or guess_socket_location()
 
+        if ssh_jump:
+            remote_host = host or DEFAULT_HOST
+            remote_port = int_port or DEFAULT_PORT
+            remote_socket = socket or None
+            ssh_executable = self.config.get('ssh', {}).get('ssh_executable', 'ssh') or 'ssh'
+            ssh_options = self.config.get('ssh', {}).get('ssh_options')
+            try:
+                self.ssh_tunnel = SshTunnel.from_target(
+                    ssh_jump,
+                    remote_host=remote_host,
+                    remote_port=int(remote_port),
+                    remote_socket=remote_socket,
+                    ssh_executable=ssh_executable,
+                    ssh_options=ssh_options,
+                )
+                self.ssh_tunnel.start()
+            except (OSError, ValueError, SshTunnelError) as exc:
+                click.secho(f'Error: Unable to start SSH tunnel: {exc}', err=True, fg='red')
+                try:
+                    if self.ssh_tunnel:
+                        self.ssh_tunnel.close()
+                except Exception:
+                    pass
+                sys.exit(1)
+
         passwd = passwd if isinstance(passwd, (str, int)) else mylogin_cnf["password"]
 
         if not character_set:
@@ -135,7 +164,10 @@ class ClientConnectionMixin:
         # 5. .mylogin.cnf
         # 6. keyring
 
-        keyring_identifier = f'{user}@{host}:{"" if socket else int_port}:{socket or ""}'
+        ssh_tunnel_field = urlquote(ssh_jump or '')
+        if ssh_tunnel_field:
+            ssh_tunnel_field = ':' + ssh_tunnel_field
+        keyring_identifier = f'{user}@{host}:{"" if socket else int_port}:{socket or ""}{ssh_tunnel_field}'
         keyring_domain = 'mycli.net'
         keyring_retrieved_cleanly = False
 
@@ -152,19 +184,24 @@ class ClientConnectionMixin:
         # should not fail, but will help the typechecker
         assert not isinstance(passwd, int)
 
-        connection_info: dict[Any, Any] = {
-            "database": database,
-            "user": user,
-            "password": passwd,
-            "host": host,
-            "port": int_port,
-            "socket": socket,
-            "character_set": character_set,
-            "local_infile": use_local_infile,
-            "ssl": ssl_config,
-            "init_command": init_command,
-            "unbuffered": unbuffered,
+        connection_info: dict[str, Any] = {
+            'database': database,
+            'user': user,
+            'password': passwd,
+            'character_set': character_set,
+            'local_infile': use_local_infile,
+            'ssl': ssl_config,
+            'init_command': init_command,
+            'unbuffered': unbuffered,
         }
+        if self.ssh_tunnel:
+            connection_info['host'] = self.ssh_tunnel.local_host
+            connection_info['port'] = self.ssh_tunnel.local_port
+            connection_info['socket'] = None
+        else:
+            connection_info['host'] = host
+            connection_info['port'] = int_port
+            connection_info['socket'] = socket
 
         def _update_keyring(password: str | None, keyring_retrieved_cleanly: bool):
             if not password:
@@ -239,6 +276,8 @@ class ClientConnectionMixin:
                     socket_owner = getpwuid(os.stat(socket).st_uid).pw_name
                 except KeyError:
                     socket_owner = '<unknown>'
+                except FileNotFoundError:
+                    socket_owner = '<unknown>'
                 self.echo(f"Connecting to socket {socket}, owned by user {socket_owner}", err=True)
                 try:
                     _connect(keyring_retrieved_cleanly=keyring_retrieved_cleanly)

{mycli-2.0.0 → mycli-2.1.1}/mycli/main.py

@@ -263,14 +263,18 @@ class CliArgs:
         help='Show progress on the standard error with --batch.',
     )
     use_keyring: str | None = clickdc.option(
-        type=click.Choice(['true', 'false', 'reset']),
+        type=click.Choice(['auto', 'true', 'false', 'reset']),
         default=None,
-        help='Store and retrieve passwords from the system keyring: true/false/reset.',
+        help='Store and retrieve passwords from the system keyring. auto means true, unless within an SSH connection.',
     )
     keepalive_ticks: int | None = clickdc.option(
         type=int,
         help='Send regular keepalive pings to the connection, roughly every <int> seconds.',
     )
+    ssh_jump: str | None = clickdc.option(
+        type=str,
+        help='Open an SSH tunnel via [user@]host[:port] and connect to MySQL through it.',
+    )
     checkup: bool = clickdc.option(
         is_flag=True,
         help='Run a checkup on your configuration.',
@@ -287,47 +291,47 @@ class CliArgs:
     ssh_user: str | None = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_host: str | None = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_port: int = clickdc.option(
         type=int,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_password: str | None = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_key_filename: str | None = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_config_path: str = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_config_host: str | None = clickdc.option(
         type=str,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     list_ssh_config: bool = clickdc.option(
         is_flag=True,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
     ssh_warning_off: bool = clickdc.option(
         is_flag=True,
         hidden=True,
-        deprecated='No effect. See https://github.com/dbcli/mycli/issues/1960 .',
+        deprecated='No effect. See --ssh-jump.',
     )
 
 

{mycli-2.0.0 → mycli-2.1.1}/mycli/myclirc

@@ -5,7 +5,7 @@
 # after executing a SQL statement when applicable.
 show_warnings = False
 
-# Enables context sensitive auto-completion. If this is disabled the all
+# Enables context sensitive auto-completion. If this is disabled then all
 # possible completions will be listed.
 smart_completion = True
 
@@ -206,10 +206,14 @@ enable_pager = True
 pager = 'less'
 
 # Whether to store and retrieve passwords from the system keyring.
+# * False - never use keyring
+# * True - always use keyring
+# * auto - use keyring unless currently in an SSH connection
 # See the documentation for https://pypi.org/project/keyring/ for your OS.
 # Note that the hostname is considered to be different if short or qualified.
 # This can be overridden with --use-keyring= at the CLI.
 # A password can be reset with --use-keyring=reset at the CLI.
+# Recommanded: auto
 use_keyring = False
 
 [search]
@@ -385,7 +389,7 @@ matching-bracket.other = '#000000 bg:#aacccc'
 
 # Favorite queries.
 # You can add your favorite queries here. They will be available in the
-# REPL when you type `\f` or `\f <query_name>`.
+# REPL when you type `/f` or `/f <query_name>`.
 [favorite_queries]
 # example = "SELECT * FROM example_table WHERE id = 1"
 
@@ -403,3 +407,10 @@ matching-bracket.other = '#000000 bg:#aacccc'
 [alias_dsn.init-commands]
 # Define one or more SQL statements per alias (semicolon-separated).
 # example_dsn = "SET sql_select_limit=1000; SET time_zone='+00:00'"
+
+[ssh]
+# Path to the ssh executable used by --ssh-jump.
+ssh_executable = ssh
+
+# options to pass to the ssh executable when making a tunnel
+ssh_options = -a -o ServerAliveInterval=60 -o ExitOnForwardFailure=yes -o IPQoS=af13 -o LogLevel=FATAL

{mycli-2.0.0 → mycli-2.1.1}/mycli/packages/cli_utils.py

@@ -23,11 +23,7 @@ def is_valid_connection_scheme(text: str) -> tuple[bool, str | None]:
     # exit early if the text does not resemble a DSN URI
     if "://" not in text:
         return False, None
-    scheme = text.split("://")[0]
-    if scheme.startswith('mysql+'):
-        return True, None
-    if scheme.startswith('mysqlx+'):
-        return True, None
-    if scheme in ("mysql", "mysqlx", "tcp", "socket"):
+    scheme = text.split("://")[0].split("+")[0]
+    if scheme in ("mysql", "mysqlx"):
         return True, None
     return False, scheme

mycli-2.1.1/mycli/packages/special/dsn_aliases.py

@@ -0,0 +1,60 @@
+from __future__ import annotations
+
+
+class DsnAliases:
+    section_name: str = 'alias_dsn'
+
+    usage = """
+DSN aliases are a way to save frequently used connections
+with a short alias.  You can manage them by editing ~/.myclirc
+directly or by using this command.
+
+Examples:
+
+    # List all DSN aliases
+    mysql> /dsn list
+    ┌───────┬───────────────────────────────┐
+    │ Alias │ DSN                           │
+    ├───────┼───────────────────────────────┤
+    │ rocks │ mysql://mycli@localhost/mysql │
+    └───────┴───────────────────────────────┘
+
+    # Save a new DSN alias based on the current connection.
+    # The password will not be included!
+    mysql> /dsn save connection_1
+
+    # Delete a DSN alias.
+    mysql> /dsn delete connection_1
+"""
+
+    # Class-level variable, for convenience to use as a singleton.
+    instance: DsnAliases
+
+    def __init__(self, config) -> None:
+        self.config = config
+
+    @classmethod
+    def from_config(cls, config):
+        return DsnAliases(config)
+
+    def list(self) -> list[str]:
+        return list(self.config.get(self.section_name, {}))
+
+    def get(self, alias: str) -> str | None:
+        return self.config.get(self.section_name, {}).get(alias, None)
+
+    def save(self, alias: str, dsn: str) -> str:
+        self.config.encoding = 'utf-8'
+        if self.section_name not in self.config:
+            self.config[self.section_name] = {}
+        self.config[self.section_name][alias] = dsn
+        self.config.write()
+        return f'Saved: {alias}'
+
+    def delete(self, alias: str) -> str:
+        try:
+            del self.config[self.section_name][alias]
+        except KeyError:
+            return f'Not Found: {alias}'
+        self.config.write()
+        return f'Deleted: {alias}'

{mycli-2.0.0 → mycli-2.1.1}/mycli/packages/special/favoritequeries.py

@@ -10,10 +10,10 @@ with a short name.
 Examples:
 
     # Save a new favorite query.
-    > \\fs simple select * from abc where a is not Null;
+    > /fs simple select * from abc where a is not Null;
 
     # List all favorite queries.
-    > \\f
+    > /f
     ╒════════╤═══════════════════════════════════════╕
     │ Name   │ Query                                 │
     ╞════════╪═══════════════════════════════════════╡
@@ -21,7 +21,7 @@ Examples:
     ╘════════╧═══════════════════════════════════════╛
 
     # Run a favorite query.
-    > \\f simple
+    > /f simple
     ╒════════╤════════╕
     │ a      │ b      │
     ╞════════╪════════╡
@@ -29,7 +29,7 @@ Examples:
     ╘════════╧════════╛
 
     # Delete a favorite query.
-    > \\fd simple
+    > /fd simple
     simple: Deleted.
 """