You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3f77b8902c | 14 years ago | |
---|---|---|
formats | 14 years ago | |
hiredis | 14 years ago | |
jansson | 14 years ago | |
Makefile | 14 years ago | |
README.markdown | 14 years ago | |
cmd.c | 14 years ago | |
cmd.h | 14 years ago | |
conf.c | 14 years ago | |
conf.h | 14 years ago | |
server.c | 14 years ago | |
server.h | 14 years ago | |
turnip.c | 14 years ago | |
turnip.conf | 14 years ago |
README.markdown
About
A very simple prototype providing an HTTP interface to Redis. It uses hiredis and jansson.
make clean all ./turnip & curl http://127.0.0.1:7379/SET/hello/world → {"SET":[true,"OK"]} curl http://127.0.0.1:7379/GET/hello → {"GET":"world"} curl -d "GET/hello" http://127.0.0.1:7379/ → {"GET":"world"}
Features
- GET and POST are supported.
- JSON output, optional JSONP parameter.
- Raw Redis 2.0 protocol output with
?format=raw
- HTTP 1.1 pipelining (45 kqps on a desktop Linux machine.)
- Connects to Redis using a TCP or UNIX socket.
Ideas
- Add meta-data info per key (MIME type in a second key, for instance).
- Support PUT, DELETE, HEAD?
- Support pub/sub.
- Disable MULTI/EXEC/DISCARD/WATCH.
- Add logging.
- Enrich config file:
- Provide timeout (this needs to be added to hiredis first.)
- Restrict commands by IP range
- Send your ideas using the github tracker or on twitter @yowgi.
HTTP error codes
- Unknown HTTP verb: 405 Method Not Allowed
- Disconnected from redis: 503 Service Unavailable
- Could also be used:
- Timeout on the redis side: 503 Service Unavailable
- Missing key: 404 Not Found
JSON output
The URI /COMMAND/arg0/arg1/.../argN
returns a JSON object with the command as a key and the result as a value.
JSON is the default output format.
Examples:
// string $ curl http://127.0.0.1:7379/GET/y {"GET":"41"} // number $ curl http://127.0.0.1:7379/INCR/y {"INCR":42} // list $ curl http://127.0.0.1:7379/LRANGE/x/0/1 {"LRANGE":["abc","def"]} // status $ curl http://127.0.0.1:7379/TYPE/y {"TYPE":[true,"string"]} // error, which is basically a status $ curl http://127.0.0.1:7379/MAKE-ME-COFFEE {"MAKE-ME-COFFEE":[false,"ERR unknown command 'MAKE-ME-COFFEE'"]} // JSONP callback: $ curl "http://127.0.0.1:7379/TYPE/y?jsonp=myCustomFunction" myCustomFunction({"TYPE":[true,"string"]})
RAW output
This is the raw Redis output.
// string $ curl http://127.0.0.1:7379/GET/z?format=raw hello // number curl http://127.0.0.1:7379/INCR/a?format=raw :2 // list $ curl http://127.0.0.1:7379/LRANGE/x/0/-1?format=raw *2 $3 abc $3 def // status $ curl http://127.0.0.1:7379/TYPE/y?format=raw +zset // error, which is basically a status $ curl http://127.0.0.1:7379/MAKE-ME-COFFEE?format=raw -ERR unknown command 'ABC'