/[Redis.pre-github]/lib/Redis.pm
This is repository of my old source code which isn't updated any more. Go to git.rot13.org for current projects!
ViewVC logotype

Diff of /lib/Redis.pm

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 12 by dpavlin, Sat Mar 21 23:23:37 2009 UTC revision 47 by dpavlin, Mon Mar 23 11:30:40 2009 UTC
# Line 9  use Carp qw/confess/; Line 9  use Carp qw/confess/;
9    
10  =head1 NAME  =head1 NAME
11    
12  Redis - The great new Redis!  Redis - perl binding for Redis database
13    
14  =cut  =cut
15    
# Line 20  our $VERSION = '0.01'; Line 20  our $VERSION = '0.01';
20    
21  Pure perl bindings for L<http://code.google.com/p/redis/>  Pure perl bindings for L<http://code.google.com/p/redis/>
22    
23    This version support git version of Redis available at
24    L<git://github.com/antirez/redis>
25    
26      use Redis;      use Redis;
27    
28      my $r = Redis->new();      my $r = Redis->new();
29    
   
   
   
30  =head1 FUNCTIONS  =head1 FUNCTIONS
31    
32  =head2 new  =head2 new
33    
34  =cut  =cut
35    
36    our $debug = $ENV{REDIS} || 0;
37    
38  our $sock;  our $sock;
39  my $server = '127.0.0.1:6379';  my $server = '127.0.0.1:6379';
40    
# Line 51  sub new { Line 53  sub new {
53          $self;          $self;
54  }  }
55    
56  sub _sock_result {  sub __sock_result {
57          my $result = <$sock>;          my $result = <$sock>;
58          warn "# result: ",dump( $result );          warn "## result: ",dump( $result ) if $debug;
59          $result =~ s{\r\n$}{} || warn "can't find cr/lf";          $result =~ s{\r\n$}{} || warn "can't find cr/lf";
60          return $result;          return $result;
61  }  }
62    
63  sub _sock_result_bulk {  sub __sock_read_bulk {
64          my $len = <$sock>;          my $len = <$sock>;
65          warn "# len: ",dump($len);          warn "## bulk len: ",dump($len) if $debug;
66          return undef if $len eq "nil\r\n";          return undef if $len eq "nil\r\n";
67          my $v;          my $v;
68          read($sock, $v, $len) || die $!;          if ( $len > 0 ) {
69          warn "# v: ",dump($v);                  read($sock, $v, $len) || die $!;
70                    warn "## bulk v: ",dump($v) if $debug;
71            }
72          my $crlf;          my $crlf;
73          read($sock, $crlf, 2); # skip cr/lf          read($sock, $crlf, 2); # skip cr/lf
74          return $v;          return $v;
75  }  }
76    
77    sub _sock_result_bulk {
78            my $self = shift;
79            warn "## _sock_result_bulk ",dump( @_ ) if $debug;
80            print $sock join(' ',@_) . "\r\n";
81            __sock_read_bulk();
82    }
83    
84    sub _sock_result_bulk_list {
85            my $self = shift;
86            warn "## _sock_result_bulk_list ",dump( @_ ) if $debug;
87    
88            my $size = $self->_sock_send( @_ );
89            confess $size unless $size > 0;
90            $size--;
91    
92            my @list = ( 0 .. $size );
93            foreach ( 0 .. $size ) {
94                    $list[ $_ ] = __sock_read_bulk();
95            }
96    
97            warn "## list = ", dump( @list ) if $debug;
98            return @list;
99    }
100    
101    sub __sock_ok {
102            my $ok = <$sock>;
103            return undef if $ok eq "nil\r\n";
104            confess dump($ok) unless $ok eq "+OK\r\n";
105    }
106    
107    sub _sock_send {
108            my $self = shift;
109            warn "## _sock_send ",dump( @_ ) if $debug;
110            print $sock join(' ',@_) . "\r\n";
111            __sock_result();
112    }
113    
114    sub _sock_send_ok {
115            my $self = shift;
116            warn "## _sock_send_ok ",dump( @_ ) if $debug;
117            print $sock join(' ',@_) . "\r\n";
118            __sock_ok();
119    }
120    
121    sub __sock_send_bulk_raw {
122            warn "## _sock_send_bulk ",dump( @_ ) if $debug;
123            my $value = pop;
124            $value = '' unless defined $value; # FIXME errr? nil?
125            print $sock join(' ',@_) . ' ' . length($value) . "\r\n$value\r\n"
126    }
127    
128    sub _sock_send_bulk {
129            my $self = shift;
130            __sock_send_bulk_raw( @_ );
131            __sock_ok();
132    }
133    
134    sub _sock_send_bulk_number {
135            my $self = shift;
136            __sock_send_bulk_raw( @_ );
137            my $v = __sock_result();
138            confess $v unless $v =~ m{^\-?\d+$};
139            return $v;
140    }
141    
142  =head1 Connection Handling  =head1 Connection Handling
143    
144  =head2 quit  =head2 quit
# Line 105  sub ping { Line 174  sub ping {
174  =cut  =cut
175    
176  sub set {  sub set {
177          my ( $self, $k, $v, $new ) = @_;          my ( $self, $key, $value, $new ) = @_;
178          print $sock ( $new ? "SETNX" : "SET" ) . " $k " . length($v) . "\r\n$v\r\n";          $self->_sock_send_bulk( "SET" . ( $new ? 'NX' : '' ), $key, $value );
         my $ok = <$sock>;  
         confess dump($ok) unless $ok eq "+OK\r\n";  
179  }  }
180    
181  =head2 get  =head2 get
# Line 118  sub set { Line 185  sub set {
185  =cut  =cut
186    
187  sub get {  sub get {
188          my ( $self, $k ) = @_;          my $self = shift;
189          print $sock "GET $k\r\n";          $self->_sock_result_bulk('GET',@_);
190          _sock_result_bulk();  }
191    
192    =head2 mget
193    
194      my @values = $r->get( 'foo', 'bar', 'baz' );
195    
196    =cut
197    
198    sub mget {
199            my $self = shift;
200            $self->_sock_result_bulk_list('MGET',@_);
201  }  }
202    
203  =head2 incr  =head2 incr
# Line 133  sub get { Line 210  sub get {
210                    
211    
212  sub incr {  sub incr {
213          my ( $self, $key, $value ) = @_;          my $self = shift;
214          if ( defined $value ) {          $self->_sock_send( 'INCR' . ( $#_ ? 'BY' : '' ), @_ );
                 print $sock "INCRBY $key $value\r\n";  
         } else {  
                 print $sock "INCR $key\r\n";  
         }  
         _sock_result();  
215  }  }
216    
217  =head2 decr  =head2 decr
# Line 150  sub incr { Line 222  sub incr {
222  =cut  =cut
223    
224  sub decr {  sub decr {
225          my ( $self, $key, $value ) = @_;          my $self = shift;
226          if ( defined $value ) {          $self->_sock_send( 'DECR' . ( $#_ ? 'BY' : '' ), @_ );
                 print $sock "DECRBY $key $value\r\n";  
         } else {  
                 print $sock "DECR $key\r\n";  
         }  
         _sock_result();  
227  }  }
228    
229  =head2 exists  =head2 exists
# Line 167  sub decr { Line 234  sub decr {
234    
235  sub exists {  sub exists {
236          my ( $self, $key ) = @_;          my ( $self, $key ) = @_;
237          print $sock "EXISTS $key\r\n";          $self->_sock_send( 'EXISTS', $key );
         _sock_result();  
238  }  }
239    
240  =head2 del  =head2 del
# Line 179  sub exists { Line 245  sub exists {
245    
246  sub del {  sub del {
247          my ( $self, $key ) = @_;          my ( $self, $key ) = @_;
248          print $sock "DEL $key\r\n";          $self->_sock_send( 'DEL', $key );
         _sock_result();  
249  }  }
250    
251  =head2 type  =head2 type
# Line 191  sub del { Line 256  sub del {
256    
257  sub type {  sub type {
258          my ( $self, $key ) = @_;          my ( $self, $key ) = @_;
259          print $sock "TYPE $key\r\n";          $self->_sock_send( 'TYPE', $key );
         _sock_result();  
260  }  }
261    
262  =head1 Commands operating on the key space  =head1 Commands operating on the key space
# Line 205  sub type { Line 269  sub type {
269    
270  sub keys {  sub keys {
271          my ( $self, $glob ) = @_;          my ( $self, $glob ) = @_;
272          print $sock "KEYS $glob\r\n";          my $keys = $self->_sock_result_bulk( 'KEYS', $glob );
273          return split(/\s/, _sock_result_bulk());          return split(/\s/, $keys) if $keys;
274            return () if wantarray;
275    }
276    
277    =head2 randomkey
278    
279      my $key = $r->randomkey;
280    
281    =cut
282    
283    sub randomkey {
284            my ( $self ) = @_;
285            $self->_sock_send( 'RANDOMKEY' );
286    }
287    
288    =head2 rename
289    
290      my $ok = $r->rename( 'old-key', 'new-key', $new );
291    
292    =cut
293    
294    sub rename {
295            my ( $self, $old, $new, $nx ) = @_;
296            $self->_sock_send_ok( 'RENAME' . ( $nx ? 'NX' : '' ), $old, $new );
297    }
298    
299    =head2 dbsize
300    
301      my $nr_keys = $r->dbsize;
302    
303    =cut
304    
305    sub dbsize {
306            my ( $self ) = @_;
307            $self->_sock_send('DBSIZE');
308    }
309    
310    =head1 Commands operating on lists
311    
312    See also L<Redis::List> for tie interface.
313    
314    =head2 rpush
315    
316      $r->rpush( $key, $value );
317    
318    =cut
319    
320    sub rpush {
321            my ( $self, $key, $value ) = @_;
322            $self->_sock_send_bulk('RPUSH', $key, $value);
323    }
324    
325    =head2 lpush
326    
327      $r->lpush( $key, $value );
328    
329    =cut
330    
331    sub lpush {
332            my ( $self, $key, $value ) = @_;
333            $self->_sock_send_bulk('LPUSH', $key, $value);
334    }
335    
336    =head2 llen
337    
338      $r->llen( $key );
339    
340    =cut
341    
342    sub llen {
343            my ( $self, $key ) = @_;
344            $self->_sock_send( 'LLEN', $key );
345    }
346    
347    =head2 lrange
348    
349      my @list = $r->lrange( $key, $start, $end );
350    
351    =cut
352    
353    sub lrange {
354            my ( $self, $key, $start, $end ) = @_;
355            $self->_sock_result_bulk_list('LRANGE', $key, $start, $end);
356    }
357    
358    =head2 ltrim
359    
360      my $ok = $r->ltrim( $key, $start, $end );
361    
362    =cut
363    
364    sub ltrim {
365            my ( $self, $key, $start, $end ) = @_;
366            $self->_sock_send_ok( 'LTRIM', $key, $start, $end );
367    }
368    
369    =head2 lindex
370    
371      $r->lindex( $key, $index );
372    
373    =cut
374    
375    sub lindex {
376            my ( $self, $key, $index ) = @_;
377            $self->_sock_result_bulk( 'LINDEX', $key, $index );
378    }
379    
380    =head2 lset
381    
382      $r->lset( $key, $index, $value );
383    
384    =cut
385    
386    sub lset {
387            my ( $self, $key, $index, $value ) = @_;
388            $self->_sock_send_bulk( 'LSET', $key, $index, $value );
389    }
390    
391    =head2 lrem
392    
393      my $modified_count = $r->lrem( $key, $count, $value );
394    
395    =cut
396    
397    sub lrem {
398            my ( $self, $key, $count, $value ) = @_;
399            $self->_sock_send_bulk_number( 'LREM', $key, $count, $value );
400    }
401    
402    =head2 lpop
403    
404      my $value = $r->lpop( $key );
405    
406    =cut
407    
408    sub lpop {
409            my ( $self, $key ) = @_;
410            $self->_sock_result_bulk( 'LPOP', $key );
411    }
412    
413    =head2 rpop
414    
415      my $value = $r->rpop( $key );
416    
417    =cut
418    
419    sub rpop {
420            my ( $self, $key ) = @_;
421            $self->_sock_result_bulk( 'RPOP', $key );
422    }
423    
424    =head1 Commands operating on sets
425    
426    =head2 sadd
427    
428      $r->sadd( $key, $member );
429    
430    =cut
431    
432    sub sadd {
433            my ( $self, $key, $member ) = @_;
434            $self->_sock_send_bulk_number( 'SADD', $key, $member );
435    }
436    
437    =head2 srem
438    
439      $r->srem( $key, $member );
440    
441    =cut
442    
443    sub srem {
444            my ( $self, $key, $member ) = @_;
445            $self->_sock_send_bulk_number( 'SREM', $key, $member );
446    }
447    
448    =head2 scard
449    
450      my $elements = $r->scard( $key );
451    
452    =cut
453    
454    sub scard {
455            my ( $self, $key ) = @_;
456            $self->_sock_send( 'SCARD', $key );
457    }
458    
459    =head2 sismember
460    
461      $r->sismember( $key, $member );
462    
463    =cut
464    
465    sub sismember {
466            my ( $self, $key, $member ) = @_;
467            $self->_sock_send_bulk_number( 'SISMEMBER', $key, $member );
468    }
469    
470    =head2 sinter
471    
472      $r->sinter( $key1, $key2, ... );
473    
474    =cut
475    
476    sub sinter {
477            my $self = shift;
478            $self->_sock_result_bulk_list( 'SINTER', @_ );
479    }
480    
481    =head2 sinterstore
482    
483      my $ok = $r->sinterstore( $dstkey, $key1, $key2, ... );
484    
485    =cut
486    
487    sub sinterstore {
488            my $self = shift;
489            $self->_sock_send_ok( 'SINTERSTORE', @_ );
490    }
491    
492    =head1 Multiple databases handling commands
493    
494    =head2 select
495    
496      $r->select( $dbindex ); # 0 for new clients
497    
498    =cut
499    
500    sub select {
501            my ($self,$dbindex) = @_;
502            confess dump($dbindex) . 'not number' unless $dbindex =~ m{^\d+$};
503            $self->_sock_send_ok( 'SELECT', $dbindex );
504    }
505    
506    =head2 move
507    
508      $r->move( $key, $dbindex );
509    
510    =cut
511    
512    sub move {
513            my ( $self, $key, $dbindex ) = @_;
514            $self->_sock_send( 'MOVE', $key, $dbindex );
515    }
516    
517    =head2 flushdb
518    
519      $r->flushdb;
520    
521    =cut
522    
523    sub flushdb {
524            my $self = shift;
525            $self->_sock_send_ok('FLUSHDB');
526    }
527    
528    =head2 flushall
529    
530      $r->flushall;
531    
532    =cut
533    
534    sub flushall {
535            my $self = shift;
536            $self->_sock_send_ok('flushall');
537    }
538    
539    =head1 Sorting
540    
541      $r->sort("key BY pattern LIMIT start end GET pattern ASC|DESC ALPHA');
542    
543    =cut
544    
545    sub sort {
546            my ( $self, $sort ) = @_;
547            $self->_sock_result_bulk_list( "SORT $sort" );
548  }  }
549    
550  =head1 AUTHOR  =head1 AUTHOR

Legend:
Removed from v.12  
changed lines
  Added in v.47

  ViewVC Help
Powered by ViewVC 1.1.26