NAME

Slash::Client - Write clients for Slash

SYNOPSIS

        my $client = Slash::Client::Journal->new({
                host => 'use.perl.org',
        });
        my $entry = $client->get_entry(10_000);

DESCRIPTION

Slash::Client allows writing clients to access Slash. So far, only one client is implemented: accessing journals, which is done via SOAP. See Slash::Client::Journal for more information.

Constructor

You create an object with the new constructor, which takes a hashref of options.

host

The Slash site's host name.

ssl

Boolean, true if the Slash site can be accessed via SSL.

uid

pass

If uid and pass have true values, they are used to construct the cookie for authentication purposes. See Authentication.

logtoken

Logtoken is used for the cookie if it is passed.

cookie_file

Path to the file in Netscape format containing a cookie.

Authentication

Some methods require authentication; others may require authentication, depending on the site.

There are three ways to authenticate. The first that's tried is uid/pass. If those are not supplied, logtoken is used: this is the value actually stored in the browser cookie (and used in the query string for some user-authenticated feed URLS). The third is to just try to load the cookie from a cookie file, either passing in a path in cookie_file, or trying to find the file automatically.

I've only tested the cookie authentication recently with Firefox on Mac OS X. Feel free to submit patches for other browsers and platforms.

If the given authentication method fails, others are not attempted, and the method will attempt to execute anyway.

TODO

Work on error handling.

Other platforms for finding/reading cookies.

SEE ALSO

Slash::Client::Journal(3).

VERSION

$Id: Client.pm,v 1.1 2005/11/21 17:31:46 pudge Exp $