NAME

WWW::UsePerl::Journal - use.perl.org journal tool

SYNOPSIS

  use WWW::UsePerl::Journal;
  my $journal = WWW::UsePerl::Journal->new('russell')
  print $journal->entrytitled("Text::Echelon");
  my @entries = $journal->entrytitles();

DESCRIPTION

Can list journal entries for a user. Can display a specific journal entry. Can post into a journal.

new

use WWW::UsePerl::Journal; my $j = WWW::UsePerl::Journal->new('russell');

Creates an instance for the specified user.

user

Returns the username

uid

Returns the user ID

recentarray

Returns an array of the 30 most recently posted WWW::UsePerl::Journal::Entry objects

entryhash

Returns a hash of WWW::UsePerl::Journal::Entry objects

entryids

Returns an array of the entry IDs

entrytitles

Returns an array of the entry titles

entry

Returns the text of an entry, given an entry ID

entrytitled

Returns the text of an entry, given an entry title

login

Required before posting can occur, takes the password

postentry

Posts an entry into a journal, given a title and the text of the entry

$j->postentry({title => "My journal is great", text => "It really is"});

AVAILABILITY

It should be available for download from http://russell.matbouli.org/code/www-useperl-journal/ or from CPAN

AUTHOR

Russell Matbouli <www-useperl-journal-spam@russell.matbouli.org>

http://russell.matbouli.org/

CONTRIBUTORS

Thanks to Iain Truskett, Richard Clamp, Simon Wilcox, Simon Wistow and Kate L Pugh for sending patches. 'jdavidb' also contributed two stats scripts.

TODO

Better error checking and test suite.

Comment retrieval.

Writing activities (modify, delete ...)

CAVEATS

Beware the stringification of WWW::UsePerl::Journal::Entry objects. They're still objects, they just happen to look the same as before when you're printing them. Use ->content instead.

The time on a journal entry is the localtime of the user that created the journal entry. If you aren't in the same timezone, that time will be wrong.

LICENSE

Distributed under GPL v2. See COPYING included with this distibution.

SEE ALSO

http://use.perl.org/

LWP

cpanm WWW::UsePerl::Journal

perl -MCPAN -e shell
install WWW::UsePerl::Journal