NAME¶
LiveJournal - A Perl implementation of the LiveJournal protocol
SYNOPSIS¶
use LiveJournal;
my %info = (
user => 'foo',
password => 'bar',
);
my $lj = LiveJournal->new(\%info);
my $response = $lj->login();
print "Logged in successfully\n" if ($response->{success} eq "OK");
...
my $friend = LiveJournal::Friend->new();
my $response = $friend->check();
...
my $journal = LiveJournal::Journal->new();
my $response = $journal->syncitems();
DESCRIPTION¶
This module is implements the LiveJournal protocol. See
http://www.livejournal.com/developer/protocol.bml for details. Data is
requested from the server through
mode lines. Many methods return a
hash reference containing key/value pairs returned by the server. Descriptions
of possible responses can be found at
http://www.livejournal.com/developer/modelist.bml
CONSTRUCTOR¶
- new (INFO)
- This is the constructor for a new LiveJournal object. "INFO" is
a hash containing at least username and password (plaintext)
or hpassword (MD5 hash) key/value pairs. You may also include a
URL, for which the default is
http://www.livejournal.com/cgi-bin/log.cgi. To use a proxy, add a
proxy key and value.
- LiveJournal::livejournal->new([ FILES ])
- If you want to use a file in the livejournalrc format to store your data,
you can use this method instead. "FILES" is an array reference
to the file(s) you want to load. If you don't specify any, it will use the
first one found of ~/.livejournalrc, ~/.livejournal.rc, or
/etc/livejournalrc. This will return an object in the LiveJournal
class.
BASE CLASS METHODS¶
- login ([ INFO ])
- Log in to the LiveJournal server. Returns a hash reference. The server
returns whether the password is good or not, the user's name, an optional
message to be displayed to the user, and the list of the user's friend
groups. "INFO" is an optional hash reference containing the
optional keys getmoods, getmenus, and getpickws.
getmoods should exist and be the number of the highest mood ID you
have cached/stored on the user's computer. For example, if you logged in
last time with and got mood IDs 1, 2, 4, and 5, then send "5" as
the value of "getmoods". The server will return every new mood
that has an internal MoodID greater than 5. If you've never downloaded
moods before, send "0".
getmenus should exist if you want to get a list/tree of web jump
menus to show in your client.
getpickws should exist if you want to receive that list of picture
keywords.
- user ()
- Returns the username
- password ()
- Returns the password or hpassword, whichever is set.
- version ([VERSION])
- Returns the version string. You may alter the version string by passing a
"VERSION".
- access ([ INFO ])
- Sets/returns the journals that the user has the ability to post to. This
method is called automatically by "parse_login()". It returns a
list reference containing each journal.
- friend_group ([ INFO ])
- Sets/returns the friend group information. This method is called
automatically by "parse_login()". It returns a hash of hashes
containing name and sortorder key/value pairs. We use a hash
instead of an array here because the group numbers start from 1 and it
seemed more appropriate than having an undef 0 element or requiring adding
1 all the time.
- friend_group_max ([ MAX ])
- Sets/returns the maximum friend_group number. This method is called
automatically by "parse_login()".
- menu ([ INFO ])
- Sets/returns the menu text and URL information. This method is called
automatically by "parse_login()". You can use the list of lists
of hashes it returns as data for menus.
- mood ([ INFO ])
- Sets/returns the mood information. This method is called automatically by
"parse_login()". Returns a list of hashes containing the keys
id and name for each mood.
- mood_count ([ COUNT ])
- Sets/returns the number of moods. This method is called automatically by
"parse_login()".
- name ([ NAME ])
- Sets/returns the name of the the logged in user. This method is called
automatically by "parse_login()".
- pic_keyword ([ KEYWORDS ])
- Sets/returns the picture keywords. This method is called automatically by
"parse_login()". Returns a reference to a list of the
keywords.
- escape (STRING)
- Use this method to escape strings. "STRING" is any string. All
non-alphanumeric characters and non-whitespace are converted to their %hex
values. Spaces are converted to +s.
FRIEND METHODS¶
- check ()
- Poll the server to see if the friends list has been updated. This request
is extremely quick, and is the preferred way for users to see when their
friends list is updated. Returns a hash reference.
- get ([ [ FRIENDOF ] [, GROUPS ] ])
- Takes two optional arguments. If "FRIENDOF" is set to 1, you
will also get back the info from the "friendof" mode. If
"GROUPS" is set to 1, you will get the info from the
"getfriendgroups" mode. This method returns a hash reference
which should be passed to parse() to be more
useful. YOU SHOULD ALWAYS USE THIS METHOD BEFORE VIEWING AND AFTER
MODIFYING YOUR FRIENDS LIST TO AVOID INCONSISTENCIES.
- parse (FRIENDS)
- Takes one argument: the hash reference returned from
get() . Returns a hash of lists of hashes
containing the info (user, name, fg, bg, etc) for each friend such as:
'friend' =>
[
{
'fg' => '#000000',
'bg' => '#FFFFFF',
'groupmask' => '3',
'user' => 'SomeUser',
'name' => 'Some X. Name'
}
]
You should call parse() anytime you call
get() to keep your friend count up to
date.
- edit (FRIENDS)
- This method is used to add and edit friends to your friends list. It takes
a hash of hash references structure which has the username as the
first level of keys. The second level contains optional fg and
bg colors in #RRGGBB format.
'newfriend' =>
{
'fg' => '#000000',
'bg' => '#FFFFFF',
}
newfriend is the name of the new user. number should be the
sum of "numfriends() + n" where n is incremented for each friend
you are adding.
- add (FRIEND, [ FG [, BG ] ])
- Use this method to add a user from your friends list. "FRIEND"
is a username. "FG" and "BG" are foreground and
background values in #RRGGBB format.
- remove (USERS)
- Use this method to remove users from your friends list. Pass it an array
reference containing usernames. Returns a hash reference.
- friendof ()
- This method returns a hash reference of the users that list you as a
friend. This hash reference can be passed to
parse().
- lastupdate ([ LAST ])
- Returns or sets the last time check was used.
check() sets this value so you don't have
to.
- numfriends ([ NUMBER ])
- This method sets and returns the number of friends you have. It is
automatically called from parse() so you
shouldn't have to worry about setting it manually.
- friends ()
- Sets and returns your friends list. This method is called by
"parse()" automatically to propagate the hash.
- getgroups ()
- This method returns a hash reference containing information about your
friend groups
- editgroups (INFO)
- Use this method to create or edit a friend group. You can modify the name,
sort order, and public attributes of the group by passing a hashref
containing the keys called name, sort, or public and
respective new values. You can also add a friend to a group or groups by
passing their username as a key and the new groupmask as a value.
- deletegroups (NUMBERS)
- This method deletes a friend group. Pass it an array reference containing
the numbers of the groups to delete.
- friends_by_group ()
- Returns a hash of list references containing users and the groups they are
members of.
- add_friend_to_group (USER, GROUP)
- Use this method to add a friend to a user group. "USER" is the
username of the person and "GROUP" is the group number.
- remove_friend_from_group (USER, GROUP)
- Use this method to remove a friend from a user group. "USER" is
the username of the person and "GROUP" is the group number.
JOURNAL METHODS¶
- get (INFO)
- Use this method to download parts of a user's journal. "INFO" is
a hash reference containing at least a key called selecttype and a
value of either syncitems, day, lastn, or one.
syncitems will use the "lastcync()" method by default,
otherwise pass it a date in the yyyy-mm-dd hh::mm::ss format.
If you use day, you may provide year, month, and
day keys to specify which day. Default is today.
The lastn value requires a howmany key which says how many of
the most recent items to download. Maximum is 50. Default is 20.
If you want a particular entry, you should use the one value and a
complimentary itemid key containing the id of the item you want to
grab.
For further detail, see
http://www.livejournal.com/developer/modeinfo.bml?getevents
- post (INFO)
- This method is used to post a journal entry. "INFO" is a hash
reference containing at least an event key with a value of the post
content. The date keys are created for you.
For further detail, see
http://www.livejournal.com/developer/modeinfo.bml?postevent
- edit (INFO)
- Used to edit user's past journal entry. "INFO" is a a hash
reference containing at least the itemid and event being
submitted. Other optional values are documented at
http://www.livejournal.com/developer/modeinfo.bml?editevent
- remove (ITEMID)
- Used to delete a past journal entry. "ITEMID" is a scalar
containing the unique item id to delete.
- syncitems ()
- Returns a hash reference containing items (journal entries, to-do items,
comments) that have been created or updated on LiveJournal since you last
downloaded them.
- lastsync ([ LAST ])
- Returns or sets the last time syncitems() was
used. syncitems() sets this value so you don't
have to.
- getdaycounts ()
- This mode retrieves the number of journal entries per day. Useful for
populating calendar widgets in GUI clients.
AUTHOR¶
Frank Sheiness <archon@forbidden.dough.net>
http://feeding.frenzy.com/~rainking/
CREDITS¶
- •
- Brad 'bradfitz' Fitz <bradfitz@livejournal.com> for unconfusing
me
- •
- Joe 'pinman' Wreschnig <piman@sacredchao.net> for his idea providing
ventures into Perl-LiveJournal land
URL¶
- •
- http://forbidden.dough.net/~archon/lj/
SEE ALSO¶
- •
- perl(1).
- •
- http://www.livejournal.com/developer/