XML::Atom::Client (3pm)

    use XML::Atom::Client;
    use XML::Atom::Entry;
    my $api = XML::Atom::Client->new;
    $api->username('Melody');
    $api->password('Nelson');

    my $entry = XML::Atom::Entry->new;
    $entry->title('New Post');
    $entry->content('Content of my post.');
    my $EditURI = $api->createEntry($PostURI, $entry);

    my $feed = $api->getFeed($FeedURI);
    my @entries = $feed->entries;

    my $entry = $api->getEntry($EditURI);

XML::Atom::Client implements a client for the Atom \s-1API\s0 described at http://bitworking.org/projects/atom/draft-gregorio-09.html, with the authentication scheme described at http://www.intertwingly.net/wiki/pie/DifferentlyAbledClients.

\s-1NOTE:\s0 the \s-1API\s0, and particularly the authentication scheme, are still in flux.

XML::Atom::Client->new(%param)

XML::Atom::Client supports both the \s-1REST\s0 and SOAP-wrapper versions of the Atom \s-1API\s0. By default, the \s-1REST\s0 version of the \s-1API\s0 will be used, but you can turn on the \s-1SOAP\s0 wrapper\*(--for example, if you need to connect to a server that supports only the \s-1SOAP\s0 wrapper\*(--by calling use_soap with a value of 1:

$api->use_soap(1);

If called without arguments, returns the current value of the flag. If called with an argument, sets the username for login to $username.

Returns the current username that will be used when logging in to the Atom server. If called with an argument, sets the password for login to $password.

Returns the current password that will be used when logging in to the Atom server. Creates a new entry.

$entry must be an XML::Atom::Entry object. Retrieves the entry with the given \s-1URL\s0 $EditURI.

Returns an XML::Atom::Entry object. Updates the entry at \s-1URL\s0 $EditURI with the entry $entry, which must be an XML::Atom::Entry object.

Returns true on success, false otherwise. Deletes the entry at \s-1URL\s0 $EditURI. Retrieves the feed at $FeedURI.

Returns an XML::Atom::Feed object representing the feed returned from the server.

\s-1ERROR\s0 \s-1HANDLING\s0

Methods return \*(C`undef\*(C' on error, and the error message can be retrieved using the errstr method.

Please see the XML::Atom manpage for author, copyright, and license information.