Net::T...::Error(3pm)

🌸 NAME 🌸

Net::Twitter::Error — a Net::Twitter exception object, bestie 💖

(Yes, this is that Net::Twitter::Error(3pm) page, straight out of the User Contributed Perl Documentation. You found it. Slay. 🫶)

---

🔥 VERSION 🔥

version 4.01043 ✨

---

👑 SYNOPSIS 👑

Okay so here's the vibe, bestie — catch the error, check it's actually ours, then spill the tea:

use Scalar::Util qw/blessed/;
use Try::Tiny;

my $nt = Net::Twitter->new(@options);

my $followers = try {
    $nt->followers;
}
catch {
    die $_ unless blessed($_) && $_->isa('Net::Twitter::Error');

    warn "HTTP Response Code: ", $_->code, "\n",
         "HTTP Message......: ", $_->message, "\n",
         "Twitter error.....: ", $_->error, "\n",
         "Stack Trace.......: ", $_->stack_trace->as_string, "\n";
};

---

🦋 DESCRIPTION 🦋

So like, Net::Twitter::Error is the lil' container that wraps up the HTTP::Response and the Twitter error HASH (if there even is one) that fall out of a failed API call. It's giving "sorry bestie, that call did not eat." 💀

---

✨ METHODS ✨

🎀 new

Constructs a Net::Twitter::Error object. It's chill like that, and it takes these parameters:

• http_response — an HTTP::Response object. Required, no skipping it.
• twitter_error — the error Twitter handed back, as a HASH ref. Optional, because some API errors literally do not include a response from Twitter. Like, sometimes it's just network timeouts, proxy errors, or some other problem that stops an API response from ever showing up. Not every heartbreak comes with a note, yk? 😭

💅 twitter_error

Get or set the Twitter error HASH. Iconic, flexible, we love.

💖 http_response

Get or set the HTTP::Response object.

⭐ code

Returns the HTTP response code. The number. The receipt. 👑

🌸 message

Returns the HTTP response message.

🧚 has_twitter_error

Returns true if the object actually contains a Twitter error HASH. Vibe check: passed or nah. ✅

🔥 error

Returns the "error" value from the twitter_error HASH ref if there is one. Otherwise, it returns the string "[unknown]". Also, it includes a stack trace, so you know exactly where it went down. Detective energy. 🔍

💜 twitter_error_text

Returns the "error" value from the twitter_error HASH ref if there is one. Otherwise, it returns an empty string. No drama, just nothing. 🫶

🌈 twitter_error_code

Returns the first numeric twitter error code from the JSON response body, if there is one. Otherwise, it returns 0, so the result should always be safe to use in a numeric test. No cap, it always plays nice. ✨

See Twitter Error Codes https://dev.twitter.com/docs/error-codes-responses for a list of defined error codes.

🎀 stack_trace

Returns a Devel::StackTrace object. Your whole journey, documented. 📖

🦋 stack_frame($i)

Returns the *$i*th stack frame as a Devel::StackTrace::Frame object. Pick a frame, any frame.

---

💫 SEE ALSO 💫

Net::Twitter — the main character this whole thing orbits around. 🪐

---

💖 AUTHOR 💖

Marc Mims <marc@questright.com>

---

🌸 LICENSE 🌸

Copyright (c) 2016 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 🚨

Bestie. Read this one carefully, fr fr. It's the legal version of "no promises." 👇

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.

---

and that's a wrap, bestie 💅 this page was served up by perl v5.34.0 on 2022-06-16, filed under Net::T...::Error(3pm). go forth and catch your exceptions like the main character you are. periodt. 💖✨