flushdb, flushall
[perl-Redis.git] / lib / Redis.pm
index b3edb6c..6b0916d 100644 (file)
@@ -9,7 +9,7 @@ use Carp qw/confess/;
 
 =head1 NAME
 
-Redis - The great new Redis!
+Redis - perl binding for Redis database
 
 =cut
 
@@ -20,19 +20,21 @@ our $VERSION = '0.01';
 
 Pure perl bindings for L<http://code.google.com/p/redis/>
 
+This version support git version of Redis available at
+L<git://github.com/antirez/redis>
+
     use Redis;
 
     my $r = Redis->new();
 
-
-
-
 =head1 FUNCTIONS
 
 =head2 new
 
 =cut
 
+our $debug = $ENV{REDIS} || 0;
+
 our $sock;
 my $server = '127.0.0.1:6379';
 
@@ -51,21 +53,21 @@ sub new {
        $self;
 }
 
-sub _sock_result {
+sub __sock_result {
        my $result = <$sock>;
-       warn "# result: ",dump( $result );
+       warn "## result: ",dump( $result ) if $debug;
        $result =~ s{\r\n$}{} || warn "can't find cr/lf";
        return $result;
 }
 
-sub _sock_read_bulk {
+sub __sock_read_bulk {
        my $len = <$sock>;
-       warn "## bulk len: ",dump($len);
+       warn "## bulk len: ",dump($len) if $debug;
        return undef if $len eq "nil\r\n";
        my $v;
        if ( $len > 0 ) {
                read($sock, $v, $len) || die $!;
-               warn "## bulk v: ",dump($v);
+               warn "## bulk v: ",dump($v) if $debug;
        }
        my $crlf;
        read($sock, $crlf, 2); # skip cr/lf
@@ -74,9 +76,26 @@ sub _sock_read_bulk {
 
 sub _sock_result_bulk {
        my $self = shift;
-       warn "## _sock_result_bulk ",dump( @_ );
+       warn "## _sock_result_bulk ",dump( @_ ) if $debug;
        print $sock join(' ',@_) . "\r\n";
-       _sock_read_bulk();
+       __sock_read_bulk();
+}
+
+sub _sock_result_bulk_list {
+       my $self = shift;
+       warn "## _sock_result_bulk_list ",dump( @_ ) if $debug;
+
+       my $size = $self->_sock_send( @_ );
+       confess $size unless $size > 0;
+       $size--;
+
+       my @list = ( 0 .. $size );
+       foreach ( 0 .. $size ) {
+               $list[ $_ ] = __sock_read_bulk();
+       }
+
+       warn "## list = ", dump( @list ) if $debug;
+       return @list;
 }
 
 sub __sock_ok {
@@ -87,34 +106,35 @@ sub __sock_ok {
 
 sub _sock_send {
        my $self = shift;
-       warn "## _sock_send ",dump( @_ );
+       warn "## _sock_send ",dump( @_ ) if $debug;
        print $sock join(' ',@_) . "\r\n";
-       _sock_result();
+       __sock_result();
 }
 
 sub _sock_send_ok {
        my $self = shift;
-       warn "## _sock_send_ok ",dump( @_ );
+       warn "## _sock_send_ok ",dump( @_ ) if $debug;
        print $sock join(' ',@_) . "\r\n";
        __sock_ok();
 }
 
 sub __sock_send_bulk_raw {
-       my $self = shift;
-       warn "## _sock_send_bulk ",dump( @_ );
+       warn "## _sock_send_bulk ",dump( @_ ) if $debug;
        my $value = pop;
        $value = '' unless defined $value; # FIXME errr? nil?
        print $sock join(' ',@_) . ' ' . length($value) . "\r\n$value\r\n"
 }
 
 sub _sock_send_bulk {
+       my $self = shift;
        __sock_send_bulk_raw( @_ );
        __sock_ok();
 }
 
 sub _sock_send_bulk_number {
+       my $self = shift;
        __sock_send_bulk_raw( @_ );
-       my $v = _sock_result();
+       my $v = __sock_result();
        confess $v unless $v =~ m{^\-?\d+$};
        return $v;
 }
@@ -276,6 +296,8 @@ sub dbsize {
 
 =head1 Commands operating on lists
 
+See also L<Redis::List> for tie interface.
+
 =head2 rpush
 
   $r->rpush( $key, $value );
@@ -317,18 +339,7 @@ sub llen {
 
 sub lrange {
        my ( $self, $key, $start, $end ) = @_;
-       my $size = $self->_sock_send('LRANGE', $key, $start, $end);
-
-       confess $size unless $size > 0;
-       $size--;
-
-       my @list = ( 0 .. $size );
-       foreach ( 0 .. $size ) {
-               $list[ $_ ] = _sock_read_bulk();
-       }
-
-       warn "## lrange $key $start $end = [$size] ", dump( @list );
-       return @list;
+       $self->_sock_result_bulk_list('LRANGE', $key, $start, $end);
 }
 
 =head2 ltrim
@@ -421,6 +432,97 @@ sub srem {
        $self->_sock_send_bulk_number( 'SREM', $key, $member );
 }
 
+=head2 scard
+
+  my $elements = $r->scard( $key );
+
+=cut
+
+sub scard {
+       my ( $self, $key ) = @_;
+       $self->_sock_send( 'SCARD', $key );
+}
+
+=head2 sismember
+
+  $r->sismember( $key, $member );
+
+=cut
+
+sub sismember {
+       my ( $self, $key, $member ) = @_;
+       $self->_sock_send_bulk_number( 'SISMEMBER', $key, $member );
+}
+
+=head2 sinter
+
+  $r->sinter( $key1, $key2, ... );
+
+=cut
+
+sub sinter {
+       my $self = shift;
+       $self->_sock_result_bulk_list( 'SINTER', @_ );
+}
+
+=head2 sinterstore
+
+  my $ok = $r->sinterstore( $dstkey, $key1, $key2, ... );
+
+=cut
+
+sub sinterstore {
+       my $self = shift;
+       $self->_sock_send_ok( 'SINTERSTORE', @_ );
+}
+
+=head1 Multiple databases handling commands
+
+=head2 select
+
+  $r->select( $dbindex ); # 0 for new clients
+
+=cut
+
+sub select {
+       my ($self,$dbindex) = @_;
+       confess dump($dbindex) . 'not number' unless $dbindex =~ m{^\d+$};
+       $self->_sock_send_ok( 'SELECT', $dbindex );
+}
+
+=head2 move
+
+  $r->move( $key, $dbindex );
+
+=cut
+
+sub move {
+       my ( $self, $key, $dbindex ) = @_;
+       $self->_sock_send( 'MOVE', $key, $dbindex );
+}
+
+=head2 flushdb
+
+  $r->flushdb;
+
+=cut
+
+sub flushdb {
+       my $self = shift;
+       $self->_sock_send_ok('FLUSHDB');
+}
+
+=head2 flushall
+
+  $r->flushall;
+
+=cut
+
+sub flushall {
+       my $self = shift;
+       $self->_sock_send_ok('flushall');
+}
+
 =head1 AUTHOR
 
 Dobrica Pavlinusic, C<< <dpavlin at rot13.org> >>