![]() |
![]()
| ![]() |
![]()
NAMEWWW::HatenaDiary - CRUD interface to Hatena::DiarySYNOPSISuse WWW::HatenaDiary; my $diary = WWW::HatenaDiary->new({ username => $username, password => $password, group => $group, mech_opt => { timeout => $timeout, cookie_jar => HTTP::Cookies->new(...), }, }); # Or just pass a WWW::HatenaLogin object like below if you already have it. # See the POD of it for details my $diary = WWW::HatenaDiary->new({ login => $login # it's a WWW::HatenaLogin object }); # Check if already logged in to Hatena::Diary # If you have a valid cookie, you can omit this process if (!$diary->is_loggedin) { $diary->login({ username => $username, password => $password, }); } # Create my $edit_uri = $diary->create({ title => $title, body => $body, }); $diary->create_day({ date => $date, # $date must be YYYY-MM-DD formatted string title => $title, body => $body, }); # Retrieve my $post = $diary->retrieve({ uri => $edit_uri, }) my $day = $diary->retrieve_day({ date => $date, # $date must be YYYY-MM-DD formatted string }); # Update $edit_uri = $diary->update({ uri => $edit_uri, title => $new_title, body => $new_body, }); $diary->update_day({ date => $date, # $date must be YYYY-MM-DD formatted string title => $new_title, body => $new_body, }); # Delete $diary->delete({ uri => $edit_uri, }); $diary->delete_day({, date => $date, # $date must be YYYY-MM-DD formatted string }); DESCRIPTIONWWW::HatenaDiary provides a CRUD interface to Hatena::Diary, aiming to help you efficiently communicate with the service with programmatic ways.This module is, so far, for those who want to write some tools not only to retrieve data from diaries, but also to create/update/delete the posts at the same time. Which is why I adopted the way as if this module treats such API like AtomPub, and this module retrieves and returns a raw formatted post content not a data already converted to HTML. METHODSnew ( \%args )my $diary = WWW::HatenaDiary->new({ username => $username, password => $password, group => $group, mech_opt => { timeout => $timeout, cookie_jar => HTTP::Cookies->new(...), }, }); # or... my $diary = WWW::HatenaDiary->new({ login => $login # it's a WWW::HatenaLogin object }); Creates and returns a new WWW::HatenaDiary object. If you
have a valid cookie and pass it into this method as one of
"mech_opt", you can omit
"username" and
"password". Even in that case, you might
want to check if the user agent already logs in to Hatena::Diary using
"is_loggedin" method below.
"group" field is optional, which will be required if you want to work with your diary on Hatena::Group. "mech_opt" field is optional. You can use it to customize the behavior of this module in the way you like. See the POD of WWW::Mechanize for more details. "login" field is also optional. If you already have a WWW::HatenaLogin object, you can use it to communicate with Hatena::Diary after just passing it as the value of the field. See the POD of WWW::HatenaLogin for more details. is_loggedin ()if(!$diary->is_loggedin) { ... } Checks if $diary object already
logs in to Hatena::Diary.
login ( [\%args] )$diary->login({ username => $username, password => $password, }); Logs in to Hatena::Diary using
"username" and
"password". If either
"username" or
"password" isn't passed into this method,
the values which are passed into "new"
method above will be used.
create ( \%args )my $edit_uri = $diary->create({ title => $title, body => $body, }); Creates a new post and returns a URI as a URI object for
you to retrieve/update/delete the post later on.
create_day ( \%args )$diary->create_day({ date => $date, # $date must be YYYY-MM-DD formatted string title => $title, body => $body, }); Creates a new date-based container of the
"date".
"body" must be a Hatena::Diary style formatted data, that is, this method emulates the way when you write a post on your browser and send it via the form. This method is actually only an alias of "update_day" method described below, so that you should be sure this method erases and updates your existing entries against your expectation if the container of "date" already exists. retrieve ( \%args )my $post = $diary->retrieve({ uri => $edit_uri, }) Retrieves the post for
"uri".
retrieve_day ( \%args )my $day = $diary->retrieve_day({ date => $date, # $date must be YYYY-MM-DD formatted string }); Retrieves the title and body for
"date" as a reference to a hash that
contains "title" and
"body" field. So far, this method gets only
the raw formatted content of the post.
update ( \%args )$edit_uri = $diary->update({ uri => $edit_uri, title => $new_title, body => $new_body, }); Updates the post for
"uri" and returns the URI as a URI object
for you to do with the post still more.
update_day ( \%args )$diary->update_day({ date => $date, # $date must be YYYY-MM-DD formatted string title => $new_title, body => $new_body, }); Updates whole the posts of the
"date".
"body" must be a Hatena::Diary style formatted data, that is, this method emulates the way when you write a post on your browser and send it via the form. delete ( \%args )$diary->delete({ uri => $edit_uri, }); Deletes the post for
"uri".
delete_day ( \%args )$diary->delete_day({ date => $date, # $date must be YYYY-MM-DD formatted string }); Deletes whole the posts of the
"date".
SEE ALSO
ACKNOWLEDGMENTtypester++ for some codes copied from Fuse::Hatena.Yappo++ for improving this module using WWW::HatenaLogin AUTHORTokuhiro Matsuno <tokuhirom gmail com>Kentaro Kuribayashi <kentaro cpan org> LICENSEThis library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
|