Skip to main content

Terminal client for Redis with auto-completion and syntax highlighting.

Project description

Interactive Redis: A Cli for Redis with AutoCompletion and Syntax Highlighting.

Github Action PyPI version Python version Chat on telegram Open in Cloud Shell

demo

IRedis is a terminal client for redis with auto-completion and syntax highlighting. IRedis lets you type Redis commands smoothly, and displays results in a user-friendly format.

IRedis is an alternative for redis-cli. In most cases, IRedis behaves exactly the same as redis-cli. Besides, it is safer to use IRedis on production servers than redis-cli: IRedis will prevent accidentally running dangerous commands, like KEYS * (see Redis docs / Latency generated by slow commands).

Features

  • Advanced code completion. If you run command KEYS then run DEL, IRedis will auto-complete your command based on KEYS result.
  • Command validation. E.g. try CLUSTER MEET IP PORT, iredis will validate IP and PORT for you.
  • Command highlighting, fully based on redis grammar. Any valid command in IRedis shell is a valid redis command.
  • Human-friendly result display.
  • peek command to check the key's type then automatically call get/lrange/sscan, etc, depending on types. You don't need to call the type command then type another command to get the value. peek will also display the key's length and memory usage.
  • Ctrl + C to cancel the current typed command, this won't exit iredis, exactly like bash behaviour. Use Ctrl + D to send a EOF to exit iredis.
  • Says "Goodbye!" to you when you exit!
  • Ctrl + R to open reverse-i-search to search through your command history.
  • Auto suggestions. (Like fish shell.)
  • Support --encode=utf-8, to decode Redis' bytes responses.
  • Command hint on bottom, include command syntax, supported redis version, and time complexity.
  • Offcial docs with built-in HELP command, try HELP SET!
  • For full features, please see: iredis.io/show

Install

Install via pip:

pip install iredis

pipx is recommended:

pipx install iredis

Usage

Once you install IRedis, you will know how to use it. Just remember, IRedis supports similar options like redis-cli, like -h for redis-server's host and -p for port.

$ iredis --help

IRedis supports config files. Command-line options will always take precedence over config. Configuration resolution from highest to lowest precedence is:

  • Options from command line
  • $PWD/.iredisrc
  • ~/.iredisrc (this path can be changed with iredis --iredisrc $YOUR_PATH)
  • /etc/iredisrc
  • default config in IRedis package.

You can copy the self-explained default config here:

https://raw.githubusercontent.com/laixintao/iredis/master/iredis/data/iredisrc

And then make your own changes.

Keys

IRedis support unix/readline-style REPL keyboard shortcuts, which means keys like Ctrl + F to forward work.

Also:

  • Ctrl + F (i.e. EOF) to exit; you can also use the exit command.
  • Ctrl + L to clear screen; you can also use the clear command.

Development

Release Strategy

IRedis is built and released by CircleCI. Whenever a tag is pushed to the master branch, a new release is built and uploaded to pypi.org, it's very convenient.

Thus, we release as often as possible, so that users can always enjoy the new features and bugfixes quickly. Any bugfix or new feature will get at least a patch release, whereas big features will get a minor release.

Setup Environment

IRedis favors poetry as package management tool. To setup a develop enviroment on your computer:

First, install poetry (you can do it in a python's virtualenv):

pip install poetry

Then run (which is similar to pip install -e .):

poetry install

Be careful running testcases, it may flush you db!!!

Development Logs

This is a command-line tool, so we don't write logs to stdout.

You can tail -f ~/.iredis.log to see logs, the log is pretty clear, you can see what actually happens from log files.

CI

We use pexpect to test command-line behavior. And since there are problems with CircleCI's tty, we run pexpect-related tests on travis, and run unittest/black style check/flake8 check on CircleCI.

For local development, just run pytest. If all tests pass locally, CI shall pass.

Command Reference

There is a full Redis command list in commands.csv file, downloaded by:

python scripts/download_redis_commands.py > data/commands.csv

commands.csv is here only for test if redis.io was updated, do not package it into release.

Current implemented commands: command_syntax.csv.

Planned Features

Please see the repository issues. You are welcome to submit new issues.

Related Projects

If you like iredis, you may also like other cli tools by dbcli:

  • pgcli - Postgres Client with Auto-completion and Syntax Highlighting
  • mycli - MySQL/MariaDB/Percona Client with Auto-completion and Syntax Highlighting
  • litecli - SQLite Client with Auto-completion and Syntax Highlighting
  • mssql-cli - Microsoft SQL Server Client with Auto-completion and Syntax Highlighting
  • athenacli - AWS Athena Client with Auto-completion and Syntax Highlighting
  • vcli - VerticaDB client
  • iredis - Client for Redis with AutoCompletion and Syntax Highlighting

IRedis is build on the top of prompt_toolkit, a Python library (by Jonathan Slenders) for building rich commandline applications.

Project details


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

iredis-1.0.2.tar.gz (177.1 kB view details)

Uploaded Source

Built Distribution

iredis-1.0.2-py3-none-any.whl (257.2 kB view details)

Uploaded Python 3

File details

Details for the file iredis-1.0.2.tar.gz.

File metadata

  • Download URL: iredis-1.0.2.tar.gz
  • Upload date:
  • Size: 177.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.0.3 CPython/3.7.6 Linux/4.15.0-1069-azure

File hashes

Hashes for iredis-1.0.2.tar.gz
Algorithm Hash digest
SHA256 7a0bf48be6e3982dd61da331e8c4f1cf55ff49b23d63a64976ae278da6c4f901
MD5 f3b81096078a71266065b731bc0d64e6
BLAKE2b-256 7208f8f5824466d5805275b78608bf577b64d68ba4018903d8b8083ea912c726

See more details on using hashes here.

File details

Details for the file iredis-1.0.2-py3-none-any.whl.

File metadata

  • Download URL: iredis-1.0.2-py3-none-any.whl
  • Upload date:
  • Size: 257.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.0.3 CPython/3.7.6 Linux/4.15.0-1069-azure

File hashes

Hashes for iredis-1.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 d92a819c55922efbaeff5793758db985dd0b68b1c468f2cd3b85f66e802434e1
MD5 d8e2d380b61445be3d7618a33857beb9
BLAKE2b-256 102916e898f229a0c235fbb6169e4007327b720a50edea1266e987f4947cdbc6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page