redis 0.4.0

  • README.md
  • Installing
  • Versions
  • --

Redis client for dart #

Redis protocol parser and client writent in dart language
It is designed to be both fast and simple to use.

Currently supported features: #

  • transactions wrapper for executing multiple commands in atomic way
  • pubsub helper with aditional internal dispatching
  • unicode - strings are UTF8 encoded when sending and decoded when received
  • performance - this counts as future too
  • raw commands - this enables sending any command as raw data :)

Simple #

Redis protocol is composition of array, strings(and bulk) and integers. For example executing command SET key value is no more that serializing array of strings ["SET","key","value"]. Commands can be executed by

Future f = command.send_object(["SET","key","value"]);

This enables sending any command.

Fast #

It can execute and process more than 100K SET or GET operations per second - tested on my laptop. This is code that yields such result and can give you first impression

import 'package:redis/redis.dart';
main(){
  const int N = 200000;
  int start;
  RedisConnection conn = new RedisConnection();
  conn.connect('localhost',6379).then((Command command){
    print("test started, please wait ...");
    start =  new DateTime.now().millisecondsSinceEpoch;
    command.pipe_start();
    for(int i=1;i<N;i++){ 
      command.set("test $i","$i")
      .then((v){
        assert(v=="OK");
      });
    }
    //last command will be executed and then processed last
    command.set("test $N","$N").then((v){
      assert(v=="OK"); 
      double diff = (new DateTime.now().millisecondsSinceEpoch - start)/1000.0;
      double perf = N/diff;
      print("$N operations done in $diff s\nperformance $perf/s");
    });
    command.pipe_end();
  });
}

Transactions #

Transactions by redis protocol are started by command MULTI and then completed with command EXEC. .multi() and .exec() and class Transaction are implemented as additional helpers for checking result of each command executed during transaction.

import 'package:redis/redis.dart';
...

RedisConnection conn = new RedisConnection();
conn.connect('localhost',6379).then((Command command){    
  command.multi().then((Transaction trans){
      trans.send_object(["SET","val","0"]);
      for(int i=0;i<200000;++i){
        trans.send_object(["INCR","val"]).then((v){
          assert(i==v);
        });
      }
      trans.send_object(["GET","val"]).then((v){
        print("number is now $v");
      });
      trans.exec();
  });
});

Take note here, that Future returned by trans.send_object() is executed after .exec() so make sure you dont try to call .exec() inside of such Future, because command will never complete.

Unicode #

By default UTF8 encoding/decoding for string is used. Each string is converted in binary array using UTF8 encoding. This makes ascii string compatible in both direction.

PubSub #

PubSub is helper for dispatching received messages. First, create new PubSubCommand from existing Command

PubSubCommand pubsub=new PubSubCommand(command);

Once PubSubCommand is created, old Command is invalidated and should not be used on same connection. PubSubCommand allows commands

void subscribe(List<String> channels) 
void psubscribe(List<String> channels)
void unsubscribe(List<String> channels)
void punsubscribe(List<String> channels)

and additional Subscription getter

Subscription getSubscription();
  

Subscription enables local message dispatching. It enables registering callbacks trough .add(String pattern,Function callback) Unlike Redis rich pattern matching, this pattern allows only for optional * wildchar at the end of string. Message consumers can be added only trough Subscription.

In this example, from all messages from redis that Subscription will receive, only those that begins with abra and have at least 5 letters will be dispatched.

subscription.add("abra*",(String chan,String message){
  print("on channel: $chan message: $message");
});

Here is complete example from test code.

import 'package:redis/redis.dart';

main(){
  RedisConnection conn1 = new RedisConnection();
  RedisConnection conn2 = new RedisConnection();
  Command command; //on conn1
  PubSubCommand pubsub; //on conn2
  
  conn1.connect('localhost',6379)
  .then((Command cmd){
    command = cmd;
    return conn2.connect('localhost',6379);
  })
  .then((Command cmd){ 
    pubsub=new PubSubCommand(cmd);
    pubsub.psubscribe(["a*","b*","a*"]);
    Subscription sub = pubsub.getSubscription();
    sub.add("*",(k,v){
      print("$k $v");
     });
  })
  .then((_){ 
    command.send_object(["PUBLISH","aaa","aa"]);
    command.send_object(["PUBLISH","bbb","bb"]);
    command.send_object(["PUBLISH","ccc","cc"]); 
  });
}

Todo #

In near future:

  • Better documentation
  • Implement all "generic commands" with named commands
  • Better error handling - that is ability to recover from error
  • Spell check code

Changes #

0.4.0 #

  • PubSub interface is made simpler but backward incompatible :(
  • README is updated

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  redis: ^0.4.0

2. Install it

You can install packages from the command line:

with pub:


$ pub get

Alternatively, your editor might support pub get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


import 'package:redis/redis.dart';
  
Version Uploaded Documentation Archive
0.4.5 Nov 1, 2016 Go to the documentation of redis 0.4.5 Download redis 0.4.5 archive
0.4.4 May 20, 2015 Go to the documentation of redis 0.4.4 Download redis 0.4.4 archive
0.4.3 Jan 26, 2015 Go to the documentation of redis 0.4.3 Download redis 0.4.3 archive
0.4.2 Dec 30, 2014 Go to the documentation of redis 0.4.2 Download redis 0.4.2 archive
0.4.1 Dec 11, 2014 Go to the documentation of redis 0.4.1 Download redis 0.4.1 archive
0.4.0 Dec 1, 2014 Go to the documentation of redis 0.4.0 Download redis 0.4.0 archive
0.3.3 Nov 29, 2014 Go to the documentation of redis 0.3.3 Download redis 0.3.3 archive
0.3.2 Nov 29, 2014 Go to the documentation of redis 0.3.2 Download redis 0.3.2 archive
0.3.0 Nov 26, 2014 Go to the documentation of redis 0.3.0 Download redis 0.3.0 archive
Awaiting analysis to complete.