IRedis (Interactive Redis)
A Terminal Client for Redis with AutoCompletion and Syntax Highlighting. It is an alternative for redis-cli. IRedis is supposed to friendly for both user and redis-server, which means it is safe to use IRedis on production server. IRedis provide a --strict mode to prevent accidently running dangerous command, like KEYS *(See here, the Latency generated by slow commands section.
This project is under development, any comments are welcome.
Features
- Advanced code completion. If you run command
KEYSthen runDEL, iredis will auto complete your command based onKEYSresult. - Command validation,(eg. try
CLUSTER MEET IP PORT, iredis will validate IP and PORT for you) - Command highlighting, fully based on redis grammar. Any valide command in iredis shell is a valide redis command.
- Ctrl + C to clear cureent line, won't exit redis-cli. Use Ctrl + D
- Say "Goodbye!" to you when you exit!
- Ctrl + R to open reverse-i-search to search through 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 build in
HELPcommand, tryHELP SET!
Install
pip install iredis
Usage
Once you install IRedis, you will know how to use it. Just remember, IRedis
support similar options like redis-cli, like -h for redis-server's host
and -p for port.
$ iredis --help
IRedis support config files. The options from command line will always be the highest priority. The config files from high priority to low is:
- Options from command line
$PWD/.iredisrc~/.iredisrc(this path can be changed withiredis --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.
Development
Release Strategy
The IRedis project was build and released by CircleCI, whenever a tag was pushed to master branch, a new release will be built and uploaded to pypi.org, it's very convenient.
Thus, we release as often as possible, so users can always enjoy the new features and bugfixes very quickly. Any bugfix or new feature will get at least a patch release, the big feature will get a minor release.
Setup Environment
iredis favors poetry as a packagement tool. You can setup a develop envioment on your computer easily.
First, install poetry(You can do it in a python's virtualenv):
pip install poetry
Then run(which euqals pip install -e .):
poetry install
Be careful running testcases, it may flush you db!!!
Development Logs
Since this is a commandline tool, so we didn't write logs to stdout.
You can tail -f ~/.iredis.log to see logs, the log is pretty clear,
you can see what actually happend from log files.
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 issue. And you are welcome to submit one.
Related Projects
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file iredis-0.8.11.tar.gz.
File metadata
- Download URL: iredis-0.8.11.tar.gz
- Upload date:
- Size: 170.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.7.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a52aa80a0ef2f1b183e0e07a712090bf34bdb8c38d823b13570714d174583699
|
|
| MD5 |
e8451895da6e607a10183aa754878a4b
|
|
| BLAKE2b-256 |
b5ef32a249389c909237552860d4c1d73cdb1721ce746e937d3d13d08d73f129
|
File details
Details for the file iredis-0.8.11-py3-none-any.whl.
File metadata
- Download URL: iredis-0.8.11-py3-none-any.whl
- Upload date:
- Size: 250.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.41.1 CPython/3.7.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
92c419a61992cd6e6614e09c9a96c034033c9c6020aa7a6cb2054af8d48fe631
|
|
| MD5 |
b0837b60bc7332c5c50a25981503b0ee
|
|
| BLAKE2b-256 |
7f975b4eb1ea6a267245a6fab76658774c1b3a0d6d16135c98c8df2661e83d06
|
