NAME

AnyEvent::WebService::Notifo - AnyEvent-powered client for the notifo.com API

VERSION

version 0.001

SYNOPSIS

    use AnyEvent;
    use AnyEvent::WebService::Notifo;
    
    # Uses the default values obtained from configuration file
    my $awn = AnyEvent::WebService::Notifo->new;
    
    # ... or just pass them in
    my $awn = AnyEvent::WebService::Notifo->new(
        api_key => 'api_key_value',
        user    => 'api_user',
    );
    
    # a coderef as a callback is one possibility...
    $awn->send_notification(msg => 'my nottification text', cb => sub {
      my ($res) = @_;
      # $res is our response 
    });
    
    # ... or a condvar
    my $cv = AE::cv;
    $awn->send_notification(msg => 'my nottification text', cb => $cv);
    $res = $cv->recv;  # $res is our response

DESCRIPTION

A client for the http://notifo.com/ API using the AnyEvent framework.

CONSTRUCTORS

new

Creates a new AnyEvent::WebService::Notifo object. See Protocol::Notifo->new() for a explanation of the parameters and the configuration file used for default values.

METHODS

send_notification

Sends a notification.

It accepts a hash with parameters. We require a cb parameter. This must be a coderef or a condvar, that will be called with the response.

In void context, this method returns nothing. In scalar context, it returns a guard object. If this object goes out of scope, the request is canceled. So you need to keep this guard object alive until your callback is called.

See Protocol::Notifo->send_notification() for list of parameters that this method accepts, and an explanation of the response that the callback receives.

SEE ALSO

Protocol::Notifo, AnyEvent

AUTHOR

Pedro Melo <melo@simplicidade.org>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2010 by Pedro Melo.

This is free software, licensed under:

  The Artistic License 2.0