WWW::B...:Search(3pm)

💖 WWW::Bugzilla::Search — the vibe ✨

okay bestie, gather round, because we're talking about WWW::Bugzilla::Search (yes, the man page header truncates it to WWW::B...:Search but we know her full name 💅) — the Perl module that goes and hunts down Bugzilla bugs for you through WWW::Mechanize. she's a little search goblin and she's serving. 🦋

---

🌸 NAME 🌸

WWW::Bugzilla::Search — she handles searching bugzilla bugs via WWW::Mechanize. that's the whole job. that's her whole personality. iconic. 👑

---

✨ SYNOPSIS ✨

use WWW::Bugzilla::Search;

# Login
my $search = WWW::Bugzilla::Search->new(
    server => 'bugs.example.com',
    email => 'user@example.com',
    password => 'my_passwd',
);

$search->summary('This is my summary');
my @bugs = $search->search();

like, you log in, you tell her what you're looking for, she goes and gets it. main character behavior fr fr. 🫶

---

💜 DESCRIPTION 💜

WWW::Bugzilla::Search hands you an API so you can search for bugs inside a Bugzilla database. and the best part? every bug that comes back is an instance of WWW::Bugzilla bugs. so you get real, whole objects, not just some sad little strings. we love that for us. 🌈

---

🎀 INTERFACE 🎀

🍓 Multiple choice search criteria

these are the fields where you pick from a menu of options, bestie:

classification, component, op_sys, priority, product, resolution, bug_severity, bug_status, target_milestone, version, hardware, rep_platform

wanna know what options actually exist for a field? ask her, she'll tell you:

$search->field();

and when you've decided on your fave, you just go:

$search->field('value');

periodt. 💅

🌸 Text search criteria

these ones you can search with actual text:

assigned_to, reporter, summary

same energy, same call:

$search->field('value');

🦋 Methods

• search() — searches Bugzilla with all the criteria you set up. returns a list of bugs that match. and every single bug is its own separate instance of WWW::Bugzilla. one bug, one instance, no sharing, we're all individuals here. 😌
• reset() — wipes all your search criteria clean. fresh start, clean slate, new era. ✨

---

💀 BUGS, IMPROVEMENTS 💀

ngl, there may well be bugs in this module. the author says that using it the way they did, they just never ran into any. also important: this module does not support ALL of Bugzilla's features. if you've got patches or improvements, they're open to it — just send an email to the address listed below. 🫶

---

👑 AUTHOR 👑

written by:

Brian Caswell (bmc@shmoo.com)

portions taken from WWW::Bugzilla, originally written by:

Matthew C. Vella (the_mcv@yahoo.com)

---

📜 LICENSE 📜

 WWW::Bugzilla::Search - Module providing API to search Bugzilla bugs.
 Copyright (C) 2006 Brian Caswell (bmc@shmoo.com)

 Portions Copyright (C) 2003 Matthew C. Vella (the_mcv@yahoo.com)

 This module is free software; you can redistribute it and/or modify it
 under the terms of either:

 a) the GNU General Public License as published by the Free Software
 Foundation; either version 1, or (at your option) any later version,
 or

 b) the "Artistic License" which comes with this module.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See either
 the GNU General Public License or the Artistic License for more details.

 You should have received a copy of the Artistic License with this
 module, in the file ARTISTIC.  If not, I'll be glad to provide one.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
 USA

bestie this is the boring-but-important part so listen up: it's free software, you can redistribute and/or modify it under either the GNU General Public License (version 1, or at your option any later version) or the Artistic License that ships with the module. and it comes with NO WARRANTY — not even the implied warranty of merchantability or fitness for a particular purpose. so like, use her responsibly. 💀

---

and that's the whole page, bestie!! 🎀 this one's from perl v5.32.0, dated 2021-01-07, and it lives in the User Contributed Perl Documentation. go search some bugs, you absolute icon. 🦋✨💖