NAME

       Net::Twitter::Role::WrapError - Wraps Net::Twitter exceptions

VERSION

       version 4.01010

SYNOPSIS

           use Net::Twitter;

           my $nt = Net::Twitter->new(username => $username, password => $password);

           my $followers = $nt->followers;
           if ( !followers ) {
               warn $nt->http_message;
           }

DESCRIPTION

       This module provides an alternate error handling strategy for "Net::Twitter".  Rather than
       throwing exceptions, API methods return "undef" and error information is available through
       method calls on the "Net::Twitter" object.

       This is the error handling strategy used when "trait" "Legacy" is used.  It was the error
       handling strategy employed by "Net::Twitter" prior to version 3.00.

METHODS

       new This method takes the same parameters as "new" in Net::Twitter.

       get_error
           Returns undef if there was no error or a HASH ref containing the Twitter error
           response.  Occasionally, a Twitter API call results in an error with no error content
           returned from Twitter.  When that occurs, get_error returns a simulated error HASH
           ref.

           NOTE: Versions of "Net::Twitter" prior to 3.0 sometimes returned a string rather than
           a HASH ref, on error.  This was a bug.  Always expect undef on success and a HASH ref
           on error.

       http_code
           Returns the HTTP response code the most recent API method call if it ended in error.

       http_message
           Returns the HTTP message for the most recent API method call if it ended in error.

SEE ALSO

       Net::Twitter

AUTHOR

       Marc Mims <marc@questright.com>

LICENSE

       Copyright (c) 2009 Marc Mims

       This library is free software; you can redistribute it and/or modify it under the same
       terms as Perl itself.

DISCLAIMER OF WARRANTY

       BECAUSE THIS SOFTWARE IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY FOR THE SOFTWARE,
       TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE
       COPYRIGHT HOLDERS AND/OR OTHER PARTIES PROVIDE THE SOFTWARE "AS IS" WITHOUT WARRANTY OF
       ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
       WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO
       THE QUALITY AND PERFORMANCE OF THE SOFTWARE IS WITH YOU. SHOULD THE SOFTWARE PROVE
       DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR, OR CORRECTION.

       IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY COPYRIGHT
       HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR REDISTRIBUTE THE SOFTWARE AS PERMITTED BY
       THE ABOVE LICENSE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
       INCIDENTAL, OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
       SOFTWARE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR
       LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE SOFTWARE TO OPERATE WITH ANY
       OTHER SOFTWARE), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
       SUCH DAMAGES.