Russell Matbouli > WWW-UsePerl-Journal-0.11 > WWW::UsePerl::Journal

Download:
WWW-UsePerl-Journal-0.11.tar.gz

Dependencies

Annotate this POD

CPAN RT

Open  0
View/Report Bugs
Module Version: 0.11   Source   Latest Release: WWW-UsePerl-Journal-0.25

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

syntax highlighting: