/[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 1 by dpavlin, Sat Mar 21 20:20:45 2009 UTC revision 19 by dpavlin, Sun Mar 22 09:46:14 2009 UTC
# Line 3  package Redis; Line 3  package Redis;
3  use warnings;  use warnings;
4  use strict;  use strict;
5    
6    use IO::Socket::INET;
7    use Data::Dump qw/dump/;
8    use Carp qw/confess/;
9    
10  =head1 NAME  =head1 NAME
11    
12  Redis - The great new Redis!  Redis - The great new Redis!
13    
 =head1 VERSION  
   
 Version 0.01  
   
14  =cut  =cut
15    
16  our $VERSION = '0.01';  our $VERSION = '0.01';
# Line 18  our $VERSION = '0.01'; Line 18  our $VERSION = '0.01';
18    
19  =head1 SYNOPSIS  =head1 SYNOPSIS
20    
21  Quick summary of what the module does.  Pure perl bindings for L<http://code.google.com/p/redis/>
   
 Perhaps a little code snippet.  
22    
23      use Redis;      use Redis;
24    
25      my $foo = Redis->new();      my $r = Redis->new();
26      ...  
27    
 =head1 EXPORT  
28    
 A list of functions that can be exported.  You can delete this section  
 if you don't export anything, such as for a purely object-oriented module.  
29    
30  =head1 FUNCTIONS  =head1 FUNCTIONS
31    
32  =head2 function1  =head2 new
33    
34    =cut
35    
36    our $sock;
37    my $server = '127.0.0.1:6379';
38    
39    sub new {
40            my $class = shift;
41            my $self = {};
42            bless($self, $class);
43    
44            warn "# opening socket to $server";
45    
46            $sock ||= IO::Socket::INET->new(
47                    PeerAddr => $server,
48                    Proto => 'tcp',
49            ) || die $!;
50    
51            $self;
52    }
53    
54    sub _sock_result {
55            my $result = <$sock>;
56            warn "# result: ",dump( $result );
57            $result =~ s{\r\n$}{} || warn "can't find cr/lf";
58            return $result;
59    }
60    
61    sub _sock_result_bulk {
62            my $len = <$sock>;
63            warn "# len: ",dump($len);
64            return undef if $len eq "nil\r\n";
65            my $v;
66            read($sock, $v, $len) || die $!;
67            warn "# v: ",dump($v);
68            my $crlf;
69            read($sock, $crlf, 2); # skip cr/lf
70            return $v;
71    }
72    
73    sub _sock_ok {
74            my $ok = <$sock>;
75            confess dump($ok) unless $ok eq "+OK\r\n";
76    }
77    
78    sub _sock_send_bulk {
79            my ( $self, $command, $key, $value ) = @_;
80            print $sock "$command $key " . length($value) . "\r\n$value\r\n";
81            _sock_ok();
82    }
83    
84    
85    =head1 Connection Handling
86    
87    =head2 quit
88    
89      $r->quit;
90    
91    =cut
92    
93    sub quit {
94            my $self = shift;
95    
96            close( $sock ) || warn $!;
97    }
98    
99    =head2 ping
100    
101      $r->ping || die "no server?";
102    
103    =cut
104    
105    sub ping {
106            print $sock "PING\r\n";
107            my $pong = <$sock>;
108            die "ping failed, got ", dump($pong) unless $pong eq "+PONG\r\n";
109    }
110    
111    =head1 Commands operating on string values
112    
113    =head2 set
114    
115      $r->set( foo => 'bar', $new );
116    
117  =cut  =cut
118    
119  sub function1 {  sub set {
120            my ( $self, $key, $value, $new ) = @_;
121            $self->_sock_send_bulk( "SET" . ( $new ? 'NX' : '' ), $key, $value );
122  }  }
123    
124  =head2 function2  =head2 get
125    
126      my $value = $r->get( 'foo' );
127    
128    =cut
129    
130    sub get {
131            my ( $self, $k ) = @_;
132            print $sock "GET $k\r\n";
133            _sock_result_bulk();
134    }
135    
136    =head2 incr
137    
138      $r->incr('counter');
139      $r->incr('tripplets', 3);
140    
141    =cut
142    
143            
144    
145    sub incr {
146            my ( $self, $key, $value ) = @_;
147            if ( defined $value ) {
148                    print $sock "INCRBY $key $value\r\n";
149            } else {
150                    print $sock "INCR $key\r\n";
151            }
152            _sock_result();
153    }
154    
155    =head2 decr
156    
157      $r->decr('counter');
158      $r->decr('tripplets', 3);
159    
160    =cut
161    
162    sub decr {
163            my ( $self, $key, $value ) = @_;
164            if ( defined $value ) {
165                    print $sock "DECRBY $key $value\r\n";
166            } else {
167                    print $sock "DECR $key\r\n";
168            }
169            _sock_result();
170    }
171    
172    =head2 exists
173    
174      $r->exists( 'key' ) && print "got key!";
175    
176    =cut
177    
178    sub exists {
179            my ( $self, $key ) = @_;
180            print $sock "EXISTS $key\r\n";
181            _sock_result();
182    }
183    
184    =head2 del
185    
186      $r->del( 'key' ) || warn "key doesn't exist";
187    
188    =cut
189    
190    sub del {
191            my ( $self, $key ) = @_;
192            print $sock "DEL $key\r\n";
193            _sock_result();
194    }
195    
196    =head2 type
197    
198      $r->type( 'key' ); # = string
199    
200    =cut
201    
202    sub type {
203            my ( $self, $key ) = @_;
204            print $sock "TYPE $key\r\n";
205            _sock_result();
206    }
207    
208    =head1 Commands operating on the key space
209    
210    =head2 keys
211    
212      my @keys = $r->keys( '*glob_pattern*' );
213    
214    =cut
215    
216    sub keys {
217            my ( $self, $glob ) = @_;
218            print $sock "KEYS $glob\r\n";
219            return split(/\s/, _sock_result_bulk());
220    }
221    
222    =head2 randomkey
223    
224      my $key = $r->randomkey;
225    
226    =cut
227    
228    sub randomkey {
229            my ( $self ) = @_;
230            print $sock "RANDOMKEY\r\n";
231            _sock_result();
232    }
233    
234    =head2 rename
235    
236      my $ok = $r->rename( 'old-key', 'new-key', $new );
237    
238    =cut
239    
240    sub rename {
241            my ( $self, $old, $new, $nx ) = @_;
242            print $sock "RENAME" . ( $nx ? 'NX' : '' ) . " $old $new\r\n";
243            _sock_ok();
244    }
245    
246    =head2 dbsize
247    
248      my $nr_keys = $r->dbsize;
249    
250    =cut
251    
252    sub dbsize {
253            my ( $self ) = @_;
254            print $sock "DBSIZE\r\n";
255            _sock_result();
256    }
257    
258    =head1 Commands operating on lists
259    
260    =head2 rpush
261    
262      $r->rpush( $key, $value );
263    
264    =cut
265    
266    sub rpush {
267            my ( $self, $key, $value ) = @_;
268            $self->_sock_send_bulk('RPUSH', $key, $value);
269    }
270    
271    =head2 lpush
272    
273      $r->lpush( $key, $value );
274    
275  =cut  =cut
276    
277  sub function2 {  sub lpush {
278            my ( $self, $key, $value ) = @_;
279            $self->_sock_send_bulk('LPUSH', $key, $value);
280  }  }
281    
282  =head1 AUTHOR  =head1 AUTHOR
Legend:
Removed from v.1  
changed lines
  Added in v.19
  ViewVC Help
Powered by ViewVC 1.1.26