www::bugzilla::search(3pm) [debian man page]
WWW::Bugzilla::Search(3pm) User Contributed Perl Documentation WWW::Bugzilla::Search(3pm) NAME
WWW::Bugzilla::Search - Handles searching bugzilla bugs via WWW::Mechanize. 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(); DESCRIPTION
WWW::Bugzilla::Search provides an API to search for bugs in a Bugzilla database. Any resulting bugs will be returned as instances of WWW::Bugzilla bugs. INTERFACE
Multiple choice search criteria The following fields are multiple choice fields: classification, component, op_sys, priority, product, resolution, bug_severity, bug_status, target_milestone, version, hardware, rep_platform Available options can be retrieved via: $search->field(); To choose a given value, use: $search->field('value'); Text search criteria The following fields are avaiilable for text searching: assigned_to, reporter, summary To searc using a given field, use: $search->field('value'); Methods search() Searches Bugzilla with the defined criteria. Returns a list of bugs that match the criteria. Each bug is a seperate instance of WWW::Bugzilla reset() Resets all search criteria. BUGS, IMPROVEMENTS There may well be bugs in this module. Using it as I have, I just have not run into any. In addition, this module does not support ALL of Bugzilla's features. I will consider any patches or improvements, just send me an email at 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 perl v5.10.1 2009-10-15 WWW::Bugzilla::Search(3pm)
Check Out this Related Man Page
WWW::Search::Yahoo(3pm) User Contributed Perl Documentation WWW::Search::Yahoo(3pm) NAME
WWW::Search::Yahoo - backend for searching www.yahoo.com SYNOPSIS
use WWW::Search; my $oSearch = new WWW::Search('Yahoo'); my $sQuery = WWW::Search::escape_query("sushi restaurant Columbus Ohio"); $oSearch->native_query($sQuery); while (my $oResult = $oSearch->next_result()) print $oResult->url, " "; DESCRIPTION
This class is a Yahoo specialization of WWW::Search. It handles making and interpreting Yahoo searches http://www.yahoo.com. This class exports no public interface; all interaction should be done through WWW::Search objects. NOTES
The default search is: Yahoo's web-based index (not Directory). PRIVATE METHODS
If you just want to write Perl code to search Yahoo, you do NOT need to read any further here. Instead, just read the WWW::Search documentation. If you want to write a subclass of this module (e.g. create a backend for another branch of Yahoo) then please read about the private methods here: gui_query Yes, Virginia, we do try to emulate stupid-human queries. need_to_delay This method tells the WWW::Search controller code whether we need to pause and give the yahoo.com servers a breather. user_agent_delay This method tells the WWW::Search controller code how many seconds we should pause. preprocess_results_page Clean up the Yahoo HTML before we attempt to parse it. _result_list_tags Returns a list, which will be passed as arguments to HTML::Element::look_down() in order to return a list of HTML::Element which contain the query results. _result_list_items Given an HTML::TreeBuilder tree, returns a list of HTML::Element, which contain the query results. parse_details Given a (portion of an) HTML::TreeBuilder tree and a WWW::SearchResult object, parses one result out of the tree and populates the SearchResult. _where_to_find_count Returns a list, which will be passed as arguments to HTML::Element::look_down() in order to return an HTML::Element which contains the approximate result count. _string_has_count Given a string, returns the approximate result count if that string contains the approximate result count. _a_is_next_link Given an HTML::Element, returns true if it seems to contain the clickable "next page" widget. strip Given a string, strips leading and trailing whitespace off of it. SEE ALSO
To make new back-ends, see WWW::Search. BUGS
Please tell the maintainer if you find any! AUTHOR
As of 1998-02-02, "WWW::Search::Yahoo" is maintained by Martin Thurn (mthurn@cpan.org). "WWW::Search::Yahoo" was originally written by Wm. L. Scheding, based on "WWW::Search::AltaVista". LEGALESE
THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. LICENSE
Copyright (C) 1998-2009 Martin 'Kingpin' Thurn This software is released under the same license as Perl itself. perl v5.12.4 2011-11-02 WWW::Search::Yahoo(3pm)