CLI for MySQL Database. With auto-completion and syntax highlighting.
Project description
mycli
A command line client for MySQL that can do auto-completion and syntax highlighting.
Homepage: http://mycli.net Documentation: http://mycli.net/docs
Postgres Equivalent: http://pgcli.com
Quick Start
If you already know how to install Python packages, then you can install it via pip:
You might need sudo on Linux.
$ pip install -U mycli
or
$ brew update && brew install mycli # Only on macOS
or
$ sudo apt-get install mycli # Only on Debian or Ubuntu
Usage
See
$ mycli --help
Features
mycli is written using prompt_toolkit.
- Auto-completion as you type for SQL keywords as well as tables, views and columns in the database.
- Syntax highlighting using Pygments.
- Smart-completion (enabled by default) will suggest context-sensitive completion.
SELECT * FROM <tab>will only show table names.SELECT * FROM users WHERE <tab>will only show column names.
- Support for multiline queries.
- Favorite queries with optional positional parameters. Save a query using
\fs alias queryand execute it with\f aliaswhenever you need. - Timing of sql statements and table rendering.
- Config file is automatically created at
~/.myclircat first launch. - Log every query and its results to a file (disabled by default).
- Pretty prints tabular data (with colors!)
- Support for SSL connections
- Shell-style trailing redirects with
$>,$>>and$|operators. - Some features are only exposed as key bindings
Contributions:
If you're interested in contributing to this project, first of all I would like to extend my heartfelt gratitude. I've written a small doc to describe how to get this running in a development setup.
https://github.com/dbcli/mycli/blob/main/CONTRIBUTING.md
Additional Install Instructions:
These are some alternative ways to install mycli that are not managed by our team but provided by OS package maintainers. These packages could be slightly out of date and take time to release the latest version.
Arch, Manjaro
You can install the mycli package available in the AUR:
$ yay -S mycli
Debian, Ubuntu
On Debian, Ubuntu distributions, you can easily install the mycli package using apt:
$ sudo apt-get install mycli
Fedora
Fedora has a package available for mycli, install it using dnf:
$ sudo dnf install mycli
Windows
Follow the instructions on this blogpost: http://web.archive.org/web/20221006045208/https://www.codewall.co.uk/installing-using-mycli-on-windows/
Thanks:
This project was funded through kickstarter. My thanks to the backers who supported the project.
A special thanks to Jonathan Slenders for creating Python Prompt Toolkit, which is quite literally the backbone library, that made this app possible. Jonathan has also provided valuable feedback and support during the development of this app.
Click is used for command line option parsing and printing error messages.
Thanks to PyMysql for a pure python adapter to MySQL database.
Compatibility
Mycli is tested on macOS and Linux, and requires Python 3.9 or better.
Mycli is not tested on Windows, but the libraries used in this app are Windows-compatible. This means it should work without any modifications. If you're unable to run it on Windows, please file a bug.
Configuration and Usage
For more information on using and configuring mycli, check out our documentation.
Common topics include:
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file mycli-1.37.1.tar.gz.
File metadata
- Download URL: mycli-1.37.1.tar.gz
- Upload date:
- Size: 300.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3fe3b0572c75b6148fd83f760a55358666152e7732df932137c00d6d2ce07b0e
|
|
| MD5 |
d890d2970928ec5a3dd65e163d82f714
|
|
| BLAKE2b-256 |
e11f1e9206078bbbe0140979a7404776f75ed3cd0802e4ad9b983ff145fa8857
|
Provenance
The following attestation bundles were made for mycli-1.37.1.tar.gz:
Publisher:
publish.yml on dbcli/mycli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mycli-1.37.1.tar.gz -
Subject digest:
3fe3b0572c75b6148fd83f760a55358666152e7732df932137c00d6d2ce07b0e - Sigstore transparency entry: 321156018
- Sigstore integration time:
-
Permalink:
dbcli/mycli@b3385a16a592a815a4acd8b57645452fdd63852c -
Branch / Tag:
refs/tags/v1.37.1 - Owner: https://github.com/dbcli
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b3385a16a592a815a4acd8b57645452fdd63852c -
Trigger Event:
release
-
Statement type:
File details
Details for the file mycli-1.37.1-py3-none-any.whl.
File metadata
- Download URL: mycli-1.37.1-py3-none-any.whl
- Upload date:
- Size: 79.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.12.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
aa24a9beb71c6d796535a799c2637f12ef4c8655371c58520c75e830671b6fcf
|
|
| MD5 |
ccad05a27428d6bb8a50ee60ffda75d4
|
|
| BLAKE2b-256 |
f5e1bc5668e1b0ac086930681f983cc0d8ed80d1769bf365c0e748982f0e799b
|
Provenance
The following attestation bundles were made for mycli-1.37.1-py3-none-any.whl:
Publisher:
publish.yml on dbcli/mycli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
mycli-1.37.1-py3-none-any.whl -
Subject digest:
aa24a9beb71c6d796535a799c2637f12ef4c8655371c58520c75e830671b6fcf - Sigstore transparency entry: 321156032
- Sigstore integration time:
-
Permalink:
dbcli/mycli@b3385a16a592a815a4acd8b57645452fdd63852c -
Branch / Tag:
refs/tags/v1.37.1 - Owner: https://github.com/dbcli
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@b3385a16a592a815a4acd8b57645452fdd63852c -
Trigger Event:
release
-
Statement type:
