WWW::O...:Agent(3pm)

💖 WWW::OpenSearch::Agent 💖

okay so bestie, welcome to the manual page for WWW::OpenSearch::Agent — it lives in the WWW::OpenSearch::Agent namespace and it's filed under the 3pm manual section (that's the Perl module docs shelf, iykyk). Think of it as an agent for doing OpenSearch requests. That's the whole NAME energy, and honestly? iconic. 🎀

---

✨ SYNOPSIS ✨

so… the synopsis section of this page is literally empty. no example code, no usage snippet, nothing. not a single line. it's giving minimalism, it's giving mystery, it's giving "figure it out bestie" 💀

🌸 DESCRIPTION 🌸

and the DESCRIPTION? also blank. there is no prose description on this page at all. the module just shows up, drops its constructor and methods, and leaves. main character energy fr fr 🦋

---

🫶 CONSTRUCTOR 🫶

💅 new( [%options] )

this is the constructor, and yes, it takes an optional hash of options — that's what the square brackets around %options are telling you. the brackets mean optional, so you can call it with nothing at all or hand it a list of key/value pairs. no extra option names are documented on this page, so whatever you pass, the page doesn't spill the tea on it 🙈

---

⭐ METHODS ⭐

🌈 request( $request | $url, %params )

the main character method right here. you call request and you give it either:

• a $request</> — like, a request object situation, or
• a $url</> — just a plain URL string

…and then optionally a \%params</> — that's a reference to a hash of parameters (the backslash is doing the "here's a ref, not the actual hash" thing, classic Perl move 💜). the | in the signature means "either one, pick your fighter" and the square brackets... okay technically there aren't brackets here, but the convention of \%params alongside the alternatives means the params ref tags along with whichever first argument you chose. slay.

🧚 search( )

and this one? it's an alias for request(). that's it. that's the whole method. same vibes, different name — call it search if that feels more on-brand for you, it's literally request underneath. obsessed. 💖

---

👑 AUTHOR 👑

one name, one legend:

• Brian Cassidy <bricas@cpan.org> 💌

📜 COPYRIGHT AND LICENSE 📜

• Copyright 2005-2013 by Tatsuhiko Miyagawa and Brian Cassidy 🌸
• This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself. periodt. 💅

bestie please note: "the same terms as Perl itself" is the actual license wording — don't go inventing a different license for this, okay? keep it as-is. 🫶

---

and that's the whole page!! 🦋 no SEE ALSO section, no environment variables, no exit statuses, no bugs section — this manual page keeps it short and sweet. and for the sign-off: this was pulled from the Perl documentation, generated by perl v5.34.0, dated 2022-07-02, and the page is titled WWW::O...:Agent(3pm) (yes the title is truncated like that, it's giving mysterious, don't @ me). mwah, go do your OpenSearch requests bestie 💋✨