A command line client for MySQL that can do auto-completion and syntax highlighting.
HomePage: http://mycli.net
Postgres Equivalent: http://pgcli.com
If you already know how to install python packages, then you can install it via pip:
You might need sudo on linux.
$ pip install mycli
or
$ brew update && brew install mycli # Only on OS X
Check the detailed install instructions for debian packages or getting started with pip.
$ mycli --help
Usage: mycli [OPTIONS] [DATABASE]
Options:
-h, --host TEXT Host address of the database.
-P, --port TEXT Port number to use for connection. Honors
$MYSQL_TCP_PORT
-u, --user TEXT User name to connect to the database.
-S, --socket TEXT The socket file to use for connection.
-p, --password Force password prompt.
--pass TEXT Password to connect to the database
-v, --version Version of mycli.
-D, --database TEXT Database to use.
-R, --prompt TEXT Prompt format (Default: "\t \u@\h:\d> ")
-l, --logfile FILENAME Log every query and its results to a file.
--help Show this message and exit.
$ mycli local_database
$ mycli -h localhost -u root app_db
$ mycli mysql://amjith@localhost:3306/django_poll
mycli
is written using prompt_toolkit.
-
Auto-completion as you type for SQL keywords as well as tables 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.
-
Config file is automatically created at
~/.myclirc
at first launch. -
Pretty prints tabular data.
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/master/DEVELOP.rst
Please feel free to reach out to me if you need help.
My email: [email protected]
Twitter: @amjithr
The debian package for mycli
is hosted on packagecloud.io.
Add the gpg key for packagecloud for package verification.
curl https://packagecloud.io/gpg.key | apt-key add -
Install a package called apt-transport-https to make it possible for apt to fetch packages over https.
apt-get install -y apt-transport-https
Add the mycli package repo to the apt source.
echo "deb https://packagecloud.io/amjith/mycli/ubuntu/ trusty main" | sudo tee -a /etc/apt/sources.list
Update and apt sources and install mycli.
$ sudo apt-get update
$ sudo apt-get install mycli
Now mycli
can be upgraded easily by using sudo apt-get upgrade mycli
.
I haven't built an RPM package for mycli yet. So please use pip
to install mycli
. You can install pip on your system using:
$ sudo yum install python-pip
Once that is installed, you can install mycli as follows:
$ sudo pip install mycli
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.
Tabulate library is used for pretty printing the output of tables.
Tests have been run on OS X and Linux.
NOT TESTED THIS IN WINDOWS. But all the libraries used in this app are Windows compatible. So it should work without any modifications. If you're unable to run it on Windows, please file a bug. I will try my best to fix it.