• NAME
• VERSION
• SYNOPSIS
• DEPRECATION NOTICE
• DESCRIPTION
• DESCRIPTION
• SEE ALSO
• AUTHOR
• COPYRIGHT
• LICENSE

NAME

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

VERSION

version 4.01043

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, the Net::Twitter::Role::API::REST manpage. 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 the Net::Twitter manpage in a future release. It will remain as long as Twitter still provides the underlying API end-points.

DESCRIPTION

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

DESCRIPTION

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

SEE ALSO

the Net::Twitter manpage

AUTHOR

Marc Mims <marc@questright.com>

COPYRIGHT

Copyright (c) 2009-2016 Marc Mims

LICENSE

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