mycli 2.27.0__tar.gz → 2.28.1__tar.gz

mycli-2.28.1/.git-blame-ignore-revs

@@ -0,0 +1,43 @@
+# rename "toolkit" to "ptoolkit"
+d891e5ae670c44b96ecd79fca36da91748d8c44a
+4c8b5bfb314ed8998b8652613f0669fe58537a62
+# gather pytest files in a subdirectory
+9dbad2c5be3786eacbb127362b9b37f41b4d4785
+eb4526c66f141734b806d4782968135772f39557
+# refactor moves 2026-10-03
+07df6f36996c7c7c8665ef58dbabf735eff12557
+95e378d136a5fd115469aa3931b551c50f8f93e1
+25951150261aa6d64d4ea2efc4aad77a25b39e83
+b7dc69e6aa254b89c3b9ad4284b01e8d00202d42
+9b287611156b7529769e739ce0aed455b216a5e3
+69c403e947feef0a9f974fe42fc79de5f7794eec
+e071c7d4384e3ef1c95c624de710fc3ebfdc5ef6
+6f4308c986319efaf29a4284746b0152dc1265bd
+e2b09f4084cb7a0c3558928ce97ef0a89748e577
+d0f950a112e2f151581fa8037d37ecf69e292530
+f551bc5f4a8bbf27464bb3136d32ae869de2ac0a
+4eae45347e6a118520be85892984afff2bda36aa
+b61da9f98ccfef415d3773ff7bfc20c2ab695d53
+88929f0f1dec04544328e468d0b7b95f646d2ee2
+b6e3034b5b72ef3db975bf3a039f1c8c1d023789
+a710112ae1670e76681200ad6475c56ee91e1725
+59be294e6a87378618064ef055520cbab7648c94
+ef787f1134d77b01a334d059d578ce2f56e34e5a
+861931b0e75cd1d54270b535f1773d80923a904f
+a5cf52b5610589ce56399da9d2c5886bd3a669c5
+abb4b583d8c81eb8d2f3d3123cfda23cb9e47953
+e7ead2dcd8fb1c6df089eb1b42a05fd50db69466
+37a2bb563edcb68b5a2e7e7ec6331bec7e9d8a76
+5ad8d7b7b5acc4abdc4050cae38a58782c48e56f
+9b311151154a36322369a321f3c11512f50539b5
+c093369d557e59fd212e99e01150ebbb3a2fc6ea
+5cbc7919445d6d7121cc231ea37c8ed1ca21365e
+de595f2618657b0decbcf9fe827168d0e1e8e38b
+cfc1080e75baf2a8086322420666be685d6886a8
+2c364de0bfd397132f7a2c5c751b8e8df829cfe1
+5ebb1cb7f2613c820b83dfae3f90591a17fcc930
+0b8d7677d3fd396f515dd5f46cdb47c3da3885bd
+bb6ba73a39bc166c6a9968476999a9c08b63ccc8
+5c6dfea7b2dd5219901141935f29577bbf1fef55
+9b3e5921d0b9d05fcd422202c5e3aef6db01e205
+4caa83e882a1bf32c2e8da89608ad57b4a5dc136

{mycli-2.27.0 → mycli-2.28.1}/.github/PULL_REQUEST_TEMPLATE.md

@@ -6,7 +6,7 @@
 ## Checklist
 <!--- We appreciate your help and want to give you credit. Place an `x` in the boxes below as you complete them. -->
 - [ ] I added this contribution to the `changelog.md` file.
-- [ ] I added my name to the `AUTHORS` file (or it's already there).
+- [ ] I added my name to the `mycli/AUTHORS.txt` file (or it's already there).
 - [ ] To lint and format the code, I ran
     ```bash
     uv run ruff check && uv run ruff format && uv run mypy --install-types .

{mycli-2.27.0 → mycli-2.28.1}/.github/workflows/ci.yml

@@ -7,9 +7,9 @@ on:
       - '**.rst'
       - 'LICENSE.txt'
       - 'doc/**/*.txt'
-      - '**/AUTHORS'
-      - '**/SPONSORS'
-      - '**/TIPS'
+      - '**/AUTHORS.txt'
+      - '**/SPONSORS.txt'
+      - '**/TIPS.txt'
 
 jobs:
   tests:
@@ -38,7 +38,7 @@ jobs:
           sudo /etc/init.d/mysql start
 
       - name: Install dependencies
-        run: uv sync --all-extras -p ${{ matrix.python-version }}
+        run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
       - name: Wait for MySQL connection
         run: |
@@ -52,7 +52,7 @@ jobs:
           PYTEST_HOST: 127.0.0.1
           TERM: xterm
         run: |
-          uv run tox -e py${{ matrix.python-version }}
+          ./.venv/bin/tox -e py${{ matrix.python-version }}
 
   tests-macos:
     name: Tests macOS
@@ -84,7 +84,7 @@ jobs:
           brew services start mysql
 
       - name: Install dependencies
-        run: uv sync --all-extras -p ${{ matrix.python-version }}
+        run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
       - name: Wait for MySQL connection
         run: |
@@ -102,7 +102,7 @@ jobs:
           PYTEST_HOST: 127.0.0.1
           TERM: xterm
         run: |
-          uv run tox -e py${{ matrix.python-version }}
+          ./.venv/bin/tox -e py${{ matrix.python-version }}
 
   tests-windows:
     name: Tests Windows
@@ -127,7 +127,7 @@ jobs:
 
       - name: Install dependencies
         shell: cmd
-        run: uv sync --all-extras -p ${{ matrix.python-version }}
+        run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
       - name: Set up MySQL
         uses: shogo82148/actions-setup-mysql@083ec148d28e62f2b24b8f4541693dfe1d50488d # v1.54.0
@@ -182,7 +182,7 @@ jobs:
         run: |
           export PATH="$HOME/.local/bin:$PATH"
           cd /root/mycli
-          uv sync --all-extras --python 3.14
+          uv sync --extra dev,llm,dataframe --python 3.14
 
       - name: Start MySQL in WSL
         shell: wsl-bash {0}
@@ -248,7 +248,7 @@ jobs:
           PYTEST_HOST: 127.0.0.1
           TERM: xterm
         run: |
-          uv run tox -e py3.14
+          ./.venv/bin/tox -e py3.14
 
   docker-x86-build:
     name: Build x86 Docker Image

{mycli-2.27.0 → mycli-2.28.1}/.github/workflows/lint.yml

@@ -7,9 +7,9 @@ on:
       - '**.rst'
       - 'LICENSE.txt'
       - 'doc/**/*.txt'
-      - '**/AUTHORS'
-      - '**/SPONSORS'
-      - '**/TIPS'
+      - '**/AUTHORS.txt'
+      - '**/SPONSORS.txt'
+      - '**/TIPS.txt'
 
 jobs:
   linters:

{mycli-2.27.0 → mycli-2.28.1}/.github/workflows/publish.yml

@@ -46,7 +46,7 @@ jobs:
         sudo /etc/init.d/mysql start
 
     - name: Install dependencies
-      run: uv sync --all-extras -p ${{ matrix.python-version }}
+      run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
     - name: Wait for MySQL connection
       run: |
@@ -54,16 +54,22 @@ jobs:
           sleep 5
         done
 
+      # arguably this should be made identical to CI for PRs
+      # better would be a composite GH action
+    - name: Run Style Checks
+      run: ./.venv/bin/tox -e style
+
+      # arguably this should be made identical to CI for PRs
+      # better would be a composite GH action
+    - name: Run Typechecker
+      run: ./.venv/bin/tox -e typecheck
+
     - name: Pytest / behave
       env:
         PYTEST_PASSWORD: root
         PYTEST_HOST: 127.0.0.1
       run: |
-        uv run tox -e py${{ matrix.python-version }}
-
-      # arguably this should be made identical to CI for PRs
-    - name: Run Style Checks
-      run: uv run tox -e style
+        ./.venv/bin/tox -e py${{ matrix.python-version }}
 
   tests-macos:
     name: Tests macOS
@@ -95,7 +101,7 @@ jobs:
         brew services start mysql
 
     - name: Install dependencies
-      run: uv sync --all-extras -p ${{ matrix.python-version }}
+      run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
     - name: Wait for MySQL connection
       run: |
@@ -113,7 +119,7 @@ jobs:
         PYTEST_HOST: 127.0.0.1
         TERM: xterm
       run: |
-        uv run tox -e py${{ matrix.python-version }}
+        ./.venv/bin/tox -e py${{ matrix.python-version }}
 
   tests-windows:
     name: Tests Windows
@@ -138,7 +144,7 @@ jobs:
 
     - name: Install dependencies
       shell: cmd
-      run: uv sync --all-extras -p ${{ matrix.python-version }}
+      run: uv sync --extra dev,llm,dataframe -p ${{ matrix.python-version }}
 
     - name: Set up MySQL
       uses: shogo82148/actions-setup-mysql@083ec148d28e62f2b24b8f4541693dfe1d50488d # v1.54.0
@@ -193,7 +199,7 @@ jobs:
       run: |
         export PATH="$HOME/.local/bin:$PATH"
         cd /root/mycli
-        uv sync --all-extras --python 3.14
+        uv sync --extra dev,llm,dataframe --python 3.14
 
     - name: Start MySQL in WSL
       shell: wsl-bash {0}
@@ -240,7 +246,7 @@ jobs:
         python-version: '3.14'
 
     - name: Install dependencies
-      run: uv sync --all-extras -p 3.14
+      run: uv sync --extra llm,dataframe -p 3.14
 
     - name: Build
       run: uv build

{mycli-2.27.0 → mycli-2.28.1}/.github/workflows/typecheck.yml

@@ -7,9 +7,9 @@ on:
       - '**.rst'
       - 'LICENSE.txt'
       - 'doc/**/*.txt'
-      - '**/AUTHORS'
-      - '**/SPONSORS'
-      - '**/TIPS'
+      - '**/AUTHORS.txt'
+      - '**/SPONSORS.txt'
+      - '**/TIPS.txt'
 
 jobs:
   typecheck:
@@ -30,7 +30,7 @@ jobs:
           version: 'latest'
 
       - name: Install dependencies
-        run: uv sync --all-extras
+        run: uv sync --extra dev,llm,dataframe
 
       - name: Run mypy
         run: |

mycli-2.28.1/AGENTS.md

@@ -0,0 +1,149 @@
+# Mycli
+
+Rich MySQL terminal client with auto-completion, syntax highlighting, and dataframes.
+
+## Project Structure
+
+    /                                                     # repository root
+    ├── .github/                                          # GitHub Actions and configuration
+    ├── pyproject.toml                                    # project configuration
+    ├── doc/                                              # documentation
+    ├── doc/cookbook.md                                   # recipes for how to configure and use mycli
+    ├── doc/key_bindings.md                               # documentation of key binding behaviors
+    ├── doc/known_bugs.md                                 # documentation of known bugs and limitations
+    ├── doc/llm.md                                        # documentation on how to use LLM features
+    ├── doc/transforms.md                                 # documentation on how to use dataframe transform/plot features
+    ├── doc/screenshots/                                  # screenshots for documentation
+    ├── mycli/                                            # application source
+    ├── mycli/__init__.py                                 # provides version number
+    ├── mycli/app_state.py                                # `AppStateMixin` application state mixin and related functions
+    ├── mycli/cli_runner.py                               # connects and dispatches main modes based on CLI arguments
+    ├── mycli/client_commands.py                          # special commands which must be registered separately
+    ├── mycli/client_connection.py                        # `ClientConnectionMixin` mixin for establishing the database connection
+    ├── mycli/client_query.py                             # `ClientQueryMixin` mixin for running queries and refreshing completions
+    ├── mycli/client.py                                   # the `MyCli` "god class"
+    ├── mycli/compat.py                                   # OS compatibility helpers
+    ├── mycli/config.py                                   # configuration file readers and utilities
+    ├── mycli/constants.py                                # shared constants
+    ├── mycli/main.py                                     # processes CLI arguments
+    ├── mycli/main_modes/                                 # main execution paths
+    ├── mycli/main_modes/batch.py                         # `--batch` mode
+    ├── mycli/main_modes/checkup.py                       # `--checkup` mode
+    ├── mycli/main_modes/completions.py                   # `--completions` mode
+    ├── mycli/main_modes/execute.py                       # `--execute` mode
+    ├── mycli/main_modes/list_dsn.py                      # `--list-dsn` mode
+    ├── mycli/main_modes/repl.py                          # interactive REPL mode
+    ├── mycli/myclirc                                     # project-level configuration file
+    ├── mycli/output.py                                   # `OutputMixin` mixin for feedback and output of query results
+    ├── mycli/packages/                                   # application packages
+    ├── mycli/packages/completion/completion_engine.py    # implementation of completion suggestions
+    ├── mycli/packages/completion/completion_refresher.py # populates a `SQLCompleter` object in a background thread
+    ├── mycli/packages/completion/schema_prefetcher.py    # background prefetcher for multi-schema auto-completion
+    ├── mycli/packages/completion/sql_completer.py        # finds SQL completion candidates
+    ├── mycli/packages/credentials/password_sources.py    # password sources and precedence
+    ├── mycli/packages/dataframes/completion.py           # completions for `.|` transforms
+    ├── mycli/packages/dataframes/transform.py            # implements `.|` transforms
+    ├── mycli/packages/execution/background_runner.py     # run queries in the background, with query state and timing updates
+    ├── mycli/packages/execution/sql_execute.py           # `SQLExecute` class and friends
+    ├── mycli/packages/integrations/                      # integrations with fzf, Boundary, Kubernetes, macOS, OpenSSH, and Vault
+    ├── mycli/packages/prompt_toolkit/fzf_history.py      # uses fzf integration to serach the prompt_toolkit history
+    ├── mycli/packages/prompt_toolkit/history.py          # extends the prompt_toolkit history class
+    ├── mycli/packages/prompt_toolkit/key_bindings.py     # prompt_toolkit key bindings
+    ├── mycli/packages/prompt_toolkit/multiline.py        # prompt_toolkit multiline input
+    ├── mycli/packages/prompt_toolkit/style.py            # prompt_toolkit (and Pygments) styles
+    ├── mycli/packages/prompt_toolkit/toolbar.py          # prompt_toolkit bottom toolbar
+    ├── mycli/packages/prompt_toolkit/utils.py            # general utility functions for prompt_toolkit
+    ├── mycli/packages/pygments/mycli_lexer.py            # extends `MySqlLexer` from Pygments
+    ├── mycli/packages/redirection/                       # implementation of shell-style redirects
+    ├── mycli/packages/special_commands/                  # implementation of mycli special commands
+    ├── mycli/packages/sql_result/sql_result.py           # the `SQLResult` dataclass for holding responses
+    ├── mycli/packages/tabular_output/                    # extends cli_helper with additional output formats
+    ├── mycli/packages/utils/batch_utils.py               # utilities for `--batch` mode
+    ├── mycli/packages/utils/cli_utils.py                 # utilities for parsing CLI arguments
+    ├── mycli/packages/utils/interactive_utils.py         # utilities for confirming on destructive statements
+    ├── mycli/packages/utils/key_binding_utils.py         # handlers for key bindings and related special commands
+    ├── mycli/packages/utils/keyring_utils.py             # saved credential utilities
+    ├── mycli/packages/utils/path_utils.py                # utilities for files, including completion suggestions
+    ├── mycli/packages/utils/sql_utils.py                 # utilities for parsing SQL statements
+    ├── mycli/packages/utils/string_utils.py              # generic string utilities
+    ├── mycli/resources/completions/                      # shell completions for CLI interface
+    ├── mycli/types.py                                    # shared types
+    ├── mycli_test/features/                              # behave tests
+    ├── mycli_test/myclirc                                # mycli configuration used for tests
+    ├── mycli_test/mylogin.cnf                            # `mylogin.cnf` example used for tests
+    ├── mycli_test/pytests/                               # pytest tests
+    ├── mycli_test/pytests/conftest.py                    # pytest configuration
+    └── mycli_test/utils.py                               # shared utilities for tests
+
+## Development
+
+### Python
+
+#### Python Dependency Management
+
+This repo uses `uv` for dependency management. **Always** prefix Python
+commands with `uv run`.  Example:
+
+```bash
+env -u PYTHONPATH uv run -- python script.py
+```
+
+#### Python Typing
+
+This repo uses type annotations which are checked by `mypy`.  **Always** add
+type annotations, and always check new code with `env -u PYTHONPATH uv run -- mypy --install-types --non-interactive script.py`.
+
+Use lower-case type annotations such as `tuple`, not upper-case type
+annotations such as `Tuple`.
+
+Use `Type | None` instead of `Optional[Type]`.
+
+#### Python Testing
+
+Tests are coordinated by `tox`, and include both `pytest` and `behave` tests.
+To run the full test suite, execute `env -u PYTHONPATH uv run -- tox`.
+
+#### Python Compatibility
+
+Use Python features available from Python 3.11 through Python 3.14.
+Compatibility with Python 3.9 is not needed.  Compatibility with Python
+3.10 is not needed.
+
+#### Python Style
+
+Import style: prefer `from package import name` over `import package.name as name`.
+
+Quoting style: prefer single quotes for new code, but do not remove double quotes
+from existing code.
+
+#### Python Environment
+
+ * Package manager: `uv` (not pip)
+ * Formatter: `env -u PYTHONPATH uv run -- ruff format`
+ * Linter: `env -u PYTHONPATH uv run -- ruff check`
+ * Type checker: `env -u PYTHONPATH uv run -- mypy --install-types --non-interactive`
+
+### Git Workflows
+
+#### Git Commit Messages
+
+ * Use the present tense.
+ * Keep the first line under 50 characters in length.
+ * Keep the second line blank.
+ * Keep all other lines under 72 characters in length.
+ * Reference issue numbers when available.
+
+#### Generating PRs
+
+When generating a PR, follow the instructions in `.github/PULL_REQUEST_TEMPLATE.md`:
+
+ * Add new author names to `mycli/AUTHORS.txt`.
+ * Add a new entry to `changelog.md`.
+
+### Code Comments
+
+Keep comments concise and direct.  Use full sentences, ending with a period.
+
+### See Also
+
+See also the file `CONTRIBUTING.md`.

mycli-2.28.1/AUTHORS.md

@@ -0,0 +1 @@
+See [AUTHORS.txt](mycli/AUTHORS.txt)

{mycli-2.27.0 → mycli-2.28.1}/CONTRIBUTING.md

@@ -126,7 +126,7 @@ readlink -f $(which ex)
 # GitHub PR checklist
 
  * add the contribution to `changelog.md`
- * add your name to the `AUTHORS` file (or make sure it is already there)
+ * add your name to the `mycli/AUTHORS.txt` file (or make sure it is already there)
  * run
 
     ```bash

mycli-2.28.1/MANIFEST.in

@@ -0,0 +1,6 @@
+include LICENSE.txt *.md *.rst doc/screenshots/*
+recursive-include mycli/resources/completions *
+recursive-include mycli_test *.cnf
+recursive-include mycli_test *.feature
+recursive-include mycli_test *.py
+recursive-include mycli_test *.txt

{mycli-2.27.0/mycli.egg-info → mycli-2.28.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mycli
-Version: 2.27.0
+Version: 2.28.1
 Summary: Rich MySQL terminal client with autocompletion, syntax highlighting, and dataframes
 Author: Mycli Core Team
 License-Expression: BSD-3-Clause
@@ -19,6 +19,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
 Classifier: Programming Language :: SQL
 Classifier: Topic :: Database
 Classifier: Topic :: Database :: Front-Ends
@@ -41,7 +42,6 @@ Requires-Dist: cli_helpers[styles]~=2.15.1
 Requires-Dist: wcwidth~=0.8.3
 Requires-Dist: pyperclip~=1.11.0
 Requires-Dist: pycryptodomex~=3.23.0
-Requires-Dist: pyfzf~=0.3.1
 Requires-Dist: rapidfuzz~=3.14.5
 Requires-Dist: keyring~=25.7.0
 Requires-Dist: jinja2~=3.1.6

mycli-2.28.1/SPONSORS.md

@@ -0,0 +1 @@
+See [SPONSORS.txt](mycli/SPONSORS.txt)

{mycli-2.27.0 → mycli-2.28.1}/changelog.md

@@ -1,3 +1,67 @@
+v2.28.1 (2026/10/03)
+==============
+
+Documentation
+--------
+* Align all uses of one-line app description with `README.md`.
+
+
+Internal
+--------
+* Add Python 3.15 trove classifier.
+* Move Polars files to `dataframes` package directory.
+* Move various utility files to a `utils` directory.
+* Move various completion files to a `completion` directory.
+* Move `fzf.py` inside a package directory.
+* Move `hybrid_redirection.py` inside a package directory.
+* Move `sql_result.py` inside a package directory.
+* Rename `special` package to `special_commands`.
+* Move various integrations to an `integrations` directory.
+* Move various `prompt_toolkit` extensions to the `ptoolkit` directory.
+* Rename the `ptoolkit` package to `prompt_toolkit`.
+* Move `mycli_lexer.py` to a `pygments` package directory.
+* Move `password_sources.py` to a `credentials` package directory.
+* Create an `execution` package directory for `sql_execute.py` and `background_runner.py`.
+* Add `.txt` to text files without file extensions.
+* Move `test` directory to `mycli_test`.
+* Ignore recent refactoring move commits in `git-blame`.
+* Recast `cli_is_multiline()` as `repl_is_multiline()`.
+* Align some imports and variable names to match filename moves.
+
+
+v2.28.0 (2026/10/02)
+==============
+
+Features
+--------
+* Add "streaming" query state when `--unbuffered` is in effect.
+
+
+Bug Fixes
+--------
+* Correct row counts when `--unbuffered` is in effect.
+* Don't let `--unbuffered` override the state-update interval.
+* Fix a brief blankout of query state feedback on large results.
+* Note that `sqlglotc` is optional for performance in `--checkup`.
+* Make imports less lazy, to load special commands under Python 3.15.
+
+
+Documentation
+--------
+* Add `doc/known_bugs.md` for known bugs and limitations.
+* Add `doc/cookbook.md` for recipes on how to use mycli.
+
+
+Internal
+--------
+* Replace `pyfzf` dependency with internal implementation.
+* Use the `uv` outside of the `tox` environment when testing.
+* Use forward-slash forms of special commands in the behave test suite.
+* Use forward-slash forms of special commands in the pytest test suite.
+* Add a `tox` typecheck command.
+* Add a typecheck step to the `publish.yml` workflow.
+
+
 v2.27.0 (2026/09/29)
 ==============
 

mycli-2.28.1/doc/cookbook.md

@@ -0,0 +1,71 @@
+# Cookbook
+
+Recipes for configuring and using mycli.
+
+## faster table rendering
+
+A substantial amount of time is spent rendering tables in `tabulate` when
+the number of rows returned is say 100K or more.  The reason is that
+`tabulate` scans every row in pure Python to determine cell width.
+
+One workaround for faster viewing of large results is to configure the output
+format to CSV in `~/.myclirc`:
+
+```ini
+[main]
+table_format = csv
+```
+
+and to configure the pager to a fast CSV viewer such as [csvlens](https://github.com/ys-l/csvlens):
+
+```ini
+[main]
+pager = csvlens
+```
+
+which has the effect of moving cell-width calculations from Python to Rust.
+
+## keyring
+
+Use of the system keyring was left disabled in the default `~/.myclirc` to avoid
+silently changing default behaviors.  But it is recommended to enable it!
+
+```ini
+[main]
+use_keyring = auto
+```
+
+Sources eligible for the keyring can also be configured with
+
+```ini
+[main]
+keyring_sources = prompt, literal, file, environment, dsn, login_path, fallback
+```
+
+## completions trigger
+
+Mycli's default completions trigger the display of candidates at the first
+character, which might be distracting for some.
+
+For more of an industry-standard experience, in which completions are deferred
+until more information is typed, set `min_completion_trigger` to a small value
+in `~/.myclirc`:
+
+```ini
+[main]
+min_completion_trigger = 3
+```
+
+## DSN environment variables
+
+If using a tool such as [mise](https://github.com/jdx/mise) or [direnv](https://github.com/direnv/direnv) to manage
+environment variables, it may be convenient to enable this setting in
+`~/.myclirc`:
+
+```ini
+[main]
+expand_dsn_alias_env_vars = True
+```
+
+which allows environment variables in the form `${VAR}` to be substituted
+in DSNs.

mycli-2.28.1/doc/known_bugs.md

@@ -0,0 +1,61 @@
+# Known Bugs
+
+These are known bugs or limitations in mycli which it would be welcome to
+fix.
+
+## custom delimiters
+
+A custom delimiter (query terminator) string may be set with the `/delimiter`
+special command, but the custom delimiter is not respected in all parts of
+mycli's code.
+
+## completions after backtick
+
+Completions after a backtick character are too exuberant.  Example:
+
+```sql
+SELECT `<tab>
+```
+
+will offer more completions than
+
+```sql
+SELECT <tab>
+```
+
+## Windows limitations
+
+Mycli is only partially tested on Windows, and several features such as
+filename completion after `/source` may not work as expected.
+
+## double-dash with shell redirections
+
+The interpretation of `--` may not be consistent with `$|`.  The double-dahs
+is inherently ambiguous, being either a SQL comment initiator, or a common
+part of a shell command.  The rules for resolving the ambiguity should be
+simple, and better documented.
+
+## enum completions
+
+Completions on enum values may fail if the values contain spaces.
+
+## keyring support
+
+If "Always Allow" is chosen on Mac, then all Python applications will have
+access to the credential.
+
+When making connections via a kubectl tunnel, the keyring is disabled, because
+the Kubernetes context is not known.
+
+## explorer
+
+There is a trailing blank line in the explorer choices.
+
+## prompt efficiency
+
+The prompt and toolbar are updated more often than needed, even with caching.
+
+## history search preview highlighting
+
+When syntax highlighting with `pygmentize` is enabled for history search previews,
+the colors do not match the user's preferences in `~/.myclirc`.

{mycli-2.27.0 → mycli-2.28.1}/docker/resources/test_db-1.0.7.tar.gz

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
-name: mycli-2.27.0/docker/resources/test_db-1.0.7.tar.gz
+name: mycli-2.28.1/docker/resources/test_db-1.0.7.tar.gz
 size: 35607473 bytes
 sha256: c44c140f352f35d47fdb65df60f52b779ef552822fad6c4efcfa7b134c3faf84