NAME

Net::Snarl - Snarl network protocol

VERSION

Version 0.05

SYNOPSIS

  use Net::Snarl;
  
  # connect to localhost and register Net::Snarl application
  my $snarl = Net::Snarl->new('Net::Snarl');
  $snarl->add_class('Test'); # add Test notification class
  $snarl->notify('Test', 'Hello', 'World', 5); # show hello world for 5 seconds

DESCRIPTION

A simple interface to send Snarl notifications across the network. Snarl must be running on the target machine.

INTERFACE

register($application, $host, $port)

Connects to Snarl and register an application. Host defaults to localhost and port defaults to Net::Snarl::SNARL_PORT.

add_class($class, $title)

Registers a notification class with your application. Title is the optional friendly name for the class.

notify($class, $title, $text, $timeout, $icon)

Displays a notification of the specified class. Timeout defaults to 0 (sticky) and icon defaults to nothing.

BUGS

Please report any bugs or feature requests to bug-net-snarl at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Snarl. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

TODO

Later versions of Snarl report interactions with the notifications back to the socket. Currently these are stored in a private queue. Eventually, I will expose an interface for triggering callbacks on these events but that will most likely require threading so I'm a little reluctant to implement it.

AUTHOR

Alan Berndt, <alan@eatabrick.org>

LICENSE AND COPYRIGHT

Copyright 2010 Alan Berndt.

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.