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.
-
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 $