🌻 📖 WWW::Bugzilla::BugTree

NAME

WWW::Bugzilla::BugTree - Fetch a tree of bugzilla bugs blocking a bug

VERSION

version 0.08

SYNOPSIS

 use WWW::Bugzilla::BugTree;
 
 my $tree = WWW::Bugzilla::BugTree->new(
   url => 'http://bugzilla',
 );
 
 # $bug isa WWW::Bugzilla::BugTree::Bug
 my $bug = $tree->fetch(749922);
 print $bug;
 foreach my $subbug (@{ $bug->children })
 {
   print $bug;
 }

DESCRIPTION

This module provides a way to fetch a tree of dependent bugs from Bugzilla. You give it a bug id and it returns a tree of all the bugs that bug depends on (or all the bugs that are blocking your bug). I wrote this to use the XML output of Bugzilla's show_bug.cgi page because we are still using Bugzilla 3.6, which doesn't provide dependency information via its API, which would probably be faster.

There is also a companion script bug_tree which will print out the tree for you with pretty colors indicating each bug's status.

ATTRIBUTES

ua

 my $lwp = $tree->ua;

Instance of LWP::UserAgent used to fetch information from the bugzilla server.

url

 my$url = $tree->url

The URI of the bugzilla server. You may pass in to the constructor either a string or a URI object. If you use a string it will be converted into a URI.

If not provided it falls back to using the BUG_TREE_URL environment variable, and if that isn't set it uses this bugzilla provided for testing:

Bugzilla v4.2

METHODS

fetch

 my $bug = $tree->fetch($id);

Fetch the bug tree for the bug specified by the given id. Returns an instance of WWW::Bugzilla::BugTree::Bug.

clear_cache

 $tree->clear_cache;

Clears out the cache.

SEE ALSO

bug_tree, WWW::Bugzilla::BugTree::Bug

AUTHOR

Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Graham Ollis.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.