NAME

Net::Identica - Perl extension for fetching from, and posting notices/messages to Identi.ca

VERSION

Version 0.01

SYNOPSIS

use Net::Identica;

# If you just want to get() the notices, then there is no need to provide a password.
# my $identi = Net::Identica->new('username');

my $identi = Net::Identica->new('username', 'password');
my @messages = $identi->get;

print map { $_, "\n" } @messages;
$identi->post('Hello world');

DESCRIPTION

The module logs in to http://identi.ca and allows to fetch latest notices as well as allows to post notices.

METHODS

The implemented methods are :

new

Creates the object.

It accepts username and password of which password is required only if post() method is to be used.

USERNAME

Your (or another person's) Identi.ca username.

PASSWORD

Your Identi.ca password. Password is required only if you need to post messages using the module's post() method.

Example:

my $identi = Net::Identica->new('alanhaggai', 'topsecret');
# or
my $identi = Net::Identica->new('alanhaggai');

get

Returns an array of messages.

Example:

my @messages = $identi->get;
print map { $_, "\n" } @messages;

post

Posts a notice in a string to your Identi.ca account.

Example:

$identi->post('Hello world');

AUTHOR

Alan Haggai Alavi, <alanhaggai at gmail.com>

BUGS

Please report any bugs or feature requests to bug-net-identica at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Net-Identica. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT AND LICENSE

Copyright (C) 2008 Alan Haggai Alavi, all rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.8 or, at your option, any later version of Perl 5 you may have available.