NAME

WWW::WCAP - Access to a WCAP-enabled calendar server

SYNOPSIS

        # Should be OOP-based, not procedural...
        use WWW::WCAP qw(login do_request parse_ical logout);
        my $session_id = login($username,$password);
        my $ret = do_request($session_id, $wcap_command, @wcap_parameters);
        my $html = parse_ical($ret->content);
        my $ret = logout($session_id);

DESCRIPTION

Based on documentation provided in Sun ONE Calendar Server Programmer's Manual, August 2002 (iCS 5.1.1 Programmer's Manual.pdf), see http://docs.sun.com/prod/s1.s1cals for more details.

login($username,$password)

Log in to the calendar server. Returns a session ID.

do_request($session_id, $wcap_command, @wcap_parameters)

Send a WCAP request. Returns a hashref of error status and contents.

NOTE: There is a limit to the number of characters that may be passed in for each parameter. The limit per parameter is 1000 characters. (p80 Sun ONE Calendar Server Programmer's Manual, August 2002)

parse_ical

Parse the iCal data returned (currently dumps it out as HTML).

logout($session_id)

Log in to the calendar server. Returns a session ID.

BUGS

None known at this point.

SEE ALSO

...

AUTHOR

Nathan Bailey, <nate@cpan.org>

COPYRIGHT

Copyright 2003 Nathan Bailey. All rights reserved. This module 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 1, or (at your option) any later version.