NAME

Date::Remind::Event - Manipulate 'remind' output with Perl

SYNOPSIS

  use Date::Remind::Event;
  $Date::Remind::Event::BFLAG = 1;

  my $e = Date::Remind::Event->new(
    '2010/07/06 * * 60 1080 18:00-19:00 My Event'
  );

  print 'Start:       '. $e->date->hms         ."\n";
  print 'Duration:    '. $e->duration->hours   ." hour\n";
  print 'Description: '. $e->body              ."\n";

DESCRIPTION

Date::Remind::Event provides a Perl object interface to textual events emitted by the remind(1) calendar program. The expected format of the input is the same as what is produced by "remind -s" (as defined in the rem2ps(1) manpage under "REM2PS INPUT FORMAT").

remind(1) produces slightly different output depending on the value of the -b flag. To make sure that Date::Remind::Event handles this correctly you should set $Date::Remind::Event::BFLAG to the same value (default is 0).

See the "example/remind-simple" file in the distribution for one possible way of calling remind(1) from within Perl and parsing its output.

CONSTRUCTOR

new($text) => Date::Remind::Event

Converts $text into a single Date::Remind::Event object.

ATTRIBUTES

date -> DateTime

The start of the event.

duration -> DateTime::Duration

The length of the event.

end -> DateTime

The end of the remind event.

tag -> string

The TAG value of the event.

body -> string

The body of the remind event.

SEE ALSO

DateTime, DateTime::Duration, remind(1), rem2ps(1), http://www.roaringpenguin.com/products/remind

AUTHOR

Mark Lawrence <nomad@null.net>

COPYRIGHT AND LICENSE

Copyright 2010-2011 Mark Lawrence

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3 of the License, or (at your option) any later version.