NAME

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

VERSION

       version 4.01002

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.