Net::Twitter::Role::InflateObjects - Inflate Twitter API return values to Moose objects
use Net::Twitter; my $nt = Net::Twitter->new(traits => [qw/InflateObjects API::Rest/]); $nt->credentials($username, $password); $r = $nt->friends_timeline; $r->[0]->user->name; # return values are objects with read accessors $r->[0]->created_at; # dates are inflated to DateTime objects $r->[0]->relative_created_at; # "6 minutes ago"
This role provides inflation of HASH refs, returned by the Twitter API, into Moose objects. URLs are inflated to URI objects. Dates are inflated to DateTime objects. Objects that have a created_at attribute also have a relative_created_at method that prints times in the same style as the Twitter web interface.
created_at
relative_created_at
All HASH members have read accessors, so
$r->[0]->{user}{screen_name}
Can be accessed as
$r->[0]->user->screen_name
An accessor is created for each HASH key returned by Twitter. As Twitter adds new attributes, InflateObjects will create accessors for them. However, InflateObjects will also drop accessors if Twitter drops the corresponding HASH element. So, code that relies on HASH element will fail loudly if Twitter drops support for it. (This may be a feature!)
Marc Mims <marc@questright.com>
Copyright (c) 2009 Marc Mims
The Twitter API itself, and the description text used in this module is:
Copyright (c) 2009 Twitter
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
To install Net::Twitter, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Net::Twitter
CPAN shell
perl -MCPAN -e shell install Net::Twitter
For more information on module installation, please visit the detailed CPAN module installation guide.