https://github.com/wjackson/AnyEvent-Hiredis

hiredis AnyEvent client
https://github.com/wjackson/AnyEvent-Hiredis

Last synced: 4 months ago
JSON representation

hiredis AnyEvent client

• Host: GitHub
• URL: https://github.com/wjackson/AnyEvent-Hiredis
• Owner: wjackson
• Created: 2011-05-15T00:39:27.000Z (almost 15 years ago)
• Default Branch: master
• Last Pushed: 2015-05-14T00:08:50.000Z (almost 11 years ago)
• Last Synced: 2024-07-02T16:42:40.141Z (over 1 year ago)
• Language: Perl
• Homepage:
• Size: 136 KB
• Stars: 3
• Watchers: 3
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.pod

Awesome Lists containing this project

• awesome-redis - AnyEvent::Hiredis - Non-blocking client using the hiredis C library (Haskell / Perl)

README

          
=pod

=head1 NAME

AnyEvent::Hiredis - AnyEvent hiredis API

=head1 SYNOPSIS

  use AnyEvent::Hiredis;

  my $redis = AnyEvent::Hiredis->new(

      host => '127.0.0.1',

      port => 6379,

  );

  $redis->command( [qw/SET foo bar/], sub { warn "SET!" } );

  $redis->command( [qw/GET foo/], sub { my $value = shift } );

  $redis->command( [qw/LPUSH listkey value/] );

  $redis->command( [qw/LPOP listkey/], sub { my $value = shift } );

  # errors

  $redis->command( [qw/SOMETHING WRONG/, sub { my $error = $_[1] } );

=head1 DESCRIPTION

C is an AnyEvent Redis API that uses the hiredis C client

library (L).

=head1 PERFORMANCE

One reason to consider C over its pure Perl counterpart

C is performance.  Here's a head to head comparison of the two

modules running on general purpose hardware:

                       Rate     ae_redis  ae_hiredis

    AnyEvent::Redis    7590/s   --        -89%

    AnyEvent::Hiredis 69400/s   814%      --

Rate here is the number of set operations per second achieved by each module.

See C for details.

=head1 METHODS

=head2 new

  my $redis = AnyEvent::Hiredis->new; # 127.0.0.1:6379

  my $redis = AnyEvent::Hiredis->new(server => '192.168.0.1', port => '6379');

=head2 command

C takes an array ref representing a Redis command and a callback.

When the command has completed the callback is executed and passed the result

or error.

  $redis->command( ['SET', $key, 'foo'], sub {

      my ($result, $error) = @_;

      $result; # 'OK'

  });

  $redis->command( ['GET', $key], sub {

      my ($result, $error) = @_;

      $result; # 'foo'

  });

If the Redis server replies with an error then C<$result> will be C and

C<$error> will contain the Redis error string.  Otherwise C<$error> will be

C.

=head1 REPOSITORY

L

=head1 AUTHORS

Whitney Jackson

Jonathan Rockway

=head1 SEE ALSO

L, L, L