NAME

Log::Dispatch::MacGrowl - Log messages via Growl

SYNOPSIS

use Log::Dispatch::MacGrowl;

my $growl = Log::Dispatch::MacGrowl->new(
   name => 'growl',
   min_level => 'debug',
   app_name => 'MyApp',
   title => 'essential info !',
   priority => 0,
   sticky => 1,
   icon_file => '/System/Library/CoreServices/CoreTypes.bundle/Contents/Resources/AlertCautionIcon.icns',
);

$growl->log( level => 'alert', message => "Hello, Again." );

DESCRIPTION

This module allows you to pass messages to Growl using Mac::Growl.

METHODS

  • new(%p)

    This method takes a hash of parameters. The following options are acceptable.

  • name ($)

    The name of the object. Required.

  • min_level ($)

    The minimum logging level this object will accept. See the Log::Dispatch documentation for more information. Required.

  • max_level ($)

    The maximum logging level this object will accept. See the Log::Dispatch documentation for more information. This is not required. By default the maximum is the highest possible level (which means functionally that the object has no maximum).

  • app_name ($)

    The application name registered to Growl. By default, the package name (= Log::Dispatch::MacGrowl) will be registered.

  • title ($)

    The title shown on the notification window. By default, the script name will be displayed.

  • priority ($)

    The priority number (range from -2 for low to 2 for high) passed to Growl. By default, 0 (normal) will be passed.

  • sticky ($)

    The stickiness (boolean value) passed to Growl. By default, 1 (sticky) will be passed.

  • icon_file ($)

    The icon file (.icns) path shown on each notification window. By default, nothing will be passed.

  • log_message( message => $ )

    Sends a message to the appropriate output. Generally this shouldn't be called directly but should be called through the log() method (in Log::Dispatch::Output).

SEE ALSO

Log::Dispatch::DesktopNotification

DEPENDENCY

Log::Dispatch, ( Cocoa::Growl | Growl::Tiny | Mac::Growl )

AUTHOR

Ryo Okamoto <ryo at aquahill dot net>

COPYRIGHT & LICENSE

Copyright 2007-2010 Ryo Okamoto, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.