Chris Nandor > Slash-Client-0.01 > Slash::Client

Download:
Slash-Client-0.01.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.01   Source  

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 $

syntax highlighting: