Marc Mims > Net-Twitter > Net::Twitter::Role::API::Lists

Download:
Net-Twitter-4.01004.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 4.01004   Source  

NAME ^

Net::Twitter::Role::API::Lists - Twitter Lists API support for Net::Twitter

VERSION ^

version 4.01004

SYNOPSIS ^

  use Net::Twitter;

  my $nt = Net::Twitter->new(traits => ['API::Lists'], ...);

  $list = $nt->create_list($owner, { name => $name, description => $desc });
  $list = $nt->update_list($owner, $list_id, { description => $desc });

  $lists = $nt->get_lists($owner);
  $lists = $nt->list_lists($owner);

  $list = $nt->get_list($owner, $list_id);
  $list = $nt->delete_list($owner, $list_id);

  $statuses = $nt->list_statuses($owner, $list_id);

  $lists = $nt->list_memberships($owner);
  $lists = $nt->list_subscriptions($owner);

  $users = $nt->list_members($owner, $list_id);

  $user_or_undef = $nt->list_members($owner, $list_id, { id => $user_id });

  $user = $nt->add_list_member($owner, $list_id, $user_id);
  $users = $nt->add_list_members($owner, $list_id, { screen_name => \@screen_names });

  $user = $nt->delete_list_member($owner, $list_id, $user_id);
  $user = $nt->remove_list_member($owner, $list_id, $user_id);

  $user_or_undef = $nt->is_list_member($owner, $list_id, $user_id);

  $users = $nt->list_subscribers($owner, $list_id);

  $list = $nt->subscribe_list($owner, $list_id);
  $list = $nt->unsubscribe_list($owner, $list_id);

  $user_or_undef = $nt->is_subscribed_list($owner, $list_id, $user_id);
  $user_or_undef = $nt->is_list_subscriber($owner, $list_id, $user_id);

  #############################
  # With the cursor parameter #
  #############################

  $r = $nt->get_list($user, $list_id, { cursor => $cursor });
  $lists = $r->{lists};

  $r = $nt->list_memberships($user, { cursor => $cursor });
  $lists = $r->{lists};

  $r = $nt->list_subscriptions($user, { cursor => $cursor });
  $lists = $r->{lists};

  $r = $nt->list_members($owner, $list_id, { cursor => $cursor });
  $users = $r->{users};

  $r = $nt->list_subscribers($owner, $list_id, { cursor => $cursor });
  $users = $r->{users};

DEPRECATION NOTICE ^

This module implements methods for the original Twitter Lists API. Twitter has deprecated these API methods and reimplemented them with a saner semantics. The new methods are implemented in the API::REST trait, Net::Twitter::Role::API::REST. This module provides backwards compatibility for code written to use the original Lists API. To use the new API methods, simply remove this trait from your code and change the arguments to its methods to match the new semantics.

This module may be dropped from Net::Twitter in a future release. It will remain as long as Twitter still provides the underlying API end-points.

DESCRIPTION ^

This module adds support to Net::Twitter for the Twitter Lists API.

DESCRIPTION ^

Net::Twitter::Role::API::Lists provides a trait for the Twitter Lists API methods. See Net::Twitter for full documentation.

SEE ALSO ^

Net::Twitter

AUTHOR ^

Marc Mims <marc@questright.com>

COPYRIGHT ^

Copyright (c) 2009-2010 Marc Mims

LICENSE ^

This library is free software. You may redistribute and modify it under the same terms as Perl itself.

syntax highlighting: