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

💖 Net::Twitter::Search — a perl interface to the Twitter Search API 💖

okay bestie, so this is Net::Twitter::Search(3pm), a User Contributed Perl Documentation page. yes the name got squished in the header as Net::T...Search bc perl is dramatic, but we're calling her by her full name: Net::Twitter::Search 🎀

---

✨ VERSION ✨

she's version 4.01043 💅

---

🌸 SYNOPSIS 🌸

the whole vibe in four lines:

  use Net::Twitter;

  $nt = Net::Twitter::Search->new;

  $tweets = $nt->search('perl_api');

like. look at her. iconic.

---

🦋 DESCRIPTION 🦋

so what does this module even do?? it literally just creates an instance of Net::Twitter with the Legacy trait — and it does that for backwards compatibility with prior versions. that's the whole personality. it's a lil compatibility bestie 🫶

if you want something lighter, and you specifically do not want the Moose situation, consider Net::Twitter::Lite instead. noted. ✨

and for the full documentation, go see Net::Twitter. she has the whole story.

---

🚨 DEPRECATION NOTICE 🚨

💀 This module is deprecated. Use Net::Twitter instead. i'm not being mean, that's just literally what the page says, bestie, and you need to know it.

here's the glow-up, all the ways you can do it with Net::Twitter:

  use Net::Twitter;

  # Just the Search API; exceptions thrown on error
  $nt = Net::Twitter->new(traits => [qw/API::Search/]);

  # Just the Search API; errors wrapped - use $nt->get_error
  $nt = Net::Twitter->new(traits => [qw/API::Search WrapError/]);

  # Or, for code that uses legacy Net::Twitter idioms
  $nt = Net::Twitter->new(traits => [qw/Legacy/]);

  $tweets = $nt->search('pot of gold');

not the 'pot of gold' search query 😭🌈 she's whimsical. we love her.

---

👑 METHODS 👑

• new — creates a Net::Twitter object with the Legacy trait. and for all the new options? go read "new" in Net::Twitter, she's got you covered. no cap.

---

🧚 SEE ALSO 🧚

• Net::Twitter — Full documentation. periodt. 💅

---

🍓 AUTHORS 🍓

the legends who built this, give them their flowers 💐:

• Marc Mims <marc@questright.com>
• Chris Thompson <cpan@cthompson.com>
• Brenda Wallace <brenda@wallace.net.nz>

---

💜 LICENSE 💜

Copyright (c) 2016 Marc Mims

the Twitter API itself, and the description text used in this module, is:

Copyright (c) 2009 Twitter

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

---

🌈 DISCLAIMER OF WARRANTY 🌈

okay so this part is ALL CAPS and it's giving legal main character energy, but every word of it matters, so here it is exactly as written — read it, fr fr:

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.

so yeah. no warranty, bestie. that's the tea. 🫖

---

and that's the whole page!! 💖 this one was rendered by perl v5.34.0, dated 2022-06-16, and it lives in the User Contributed Perl Documentation corner of the world. mwah. bye bestie, go use Net::Twitter 💅✨🦋