select
[perl-Redis.git] / lib / Redis.pm
index 10594cd..14e8b8d 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';
 
@@ -53,19 +55,19 @@ sub new {
 
 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 {
        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,14 +76,14 @@ 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();
 }
 
 sub _sock_result_bulk_list {
        my $self = shift;
-       warn "## _sock_result_bulk_list ",dump( @_ );
+       warn "## _sock_result_bulk_list ",dump( @_ ) if $debug;
 
        my $size = $self->_sock_send( @_ );
        confess $size unless $size > 0;
@@ -92,7 +94,7 @@ sub _sock_result_bulk_list {
                $list[ $_ ] = _sock_read_bulk();
        }
 
-       warn "## list = ", dump( @list );
+       warn "## list = ", dump( @list ) if $debug;
        return @list;
 }
 
@@ -104,21 +106,21 @@ 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();
 }
 
 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"
@@ -293,6 +295,8 @@ sub dbsize {
 
 =head1 Commands operating on lists
 
+See also L<Redis::List> for tie interface.
+
 =head2 rpush
 
   $r->rpush( $key, $value );
@@ -460,6 +464,30 @@ sub sinter {
        $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( 1 );
+
+=cut
+
+sub select {
+       my ($self,$index) = @_;
+       $self->_sock_send_ok( 'SELECT', $index );
+}
+
 =head1 AUTHOR
 
 Dobrica Pavlinusic, C<< <dpavlin at rot13.org> >>