/ 
WWW-Bugzilla3-0.71
River stage zero No dependents
/ WWW::Bugzilla3

NAME

WWW::Bugzilla3 - perl bindings for Bugzilla 3.0 api

VERSION

v0.71

SYNOPSIS

use WWW::Bugzilla3;

my $bz = new WWW::Bugzilla3(site => 'bugz.somesite.org');
$bz->login('user@host.org', 'PaSsWoRd');
...

FUNCTIONS

new()

Creates new Bugzilla3 object.

login

in: login, password
out: user_id

Logs into bugzilla.

logout

Logs out. Does nothing if you are not logged in.

offer_account_by_email

in: email

Sends an email to the user, offering to create an account. The user will have to click on a URL in the email, and choose their password and real name.

create_user

in: email, full_name, password
out: user_id

Creates a user account directly in Bugzilla. Returns id of newly created user.

get_selectable_products

out: ids

Returns an array of the ids of the products the user can search on.

get_enterable_products

out: ids

Returns an array of the ids of the products the user can enter bugs against.

get_accessible_products

out: ids

Returns an array of the ids of the products the user can search or enter bugs against.

get_products

in: ids
out: products

Returns an array of hashes. Each hash describes a product, and has the following items: id, name, description, and internals. Internals is an internal representation of the product and can be changed by bugzilla at any time.

version

out: version

Returns bugzilla version.

timezone

out: timezone

Returns the timezone of the server Bugzilla is running on.

in: field, product_id
out: values

Returns an array of values that are allowed for a particular field.

get_bugs

in: ids
out: bugs

Gets information about particular bugs in the database. ids is an array of numbers and strings. Returns an array of hashes. Each hash contains the following items: id - The numeric bug_id of this bug. alias - The alias of this bug. If there is no alias or aliases are disabled in this Bugzilla, this will be an empty string. summary - The summary of this bug. creation_time - When the bug was created. last_change_time - When the bug was last changed.

create_bug

This allows you to create a new bug in Bugzilla. If you specify any invalid fields, they will be ignored. If you specify any fields you are not allowed to set, they will just be set to their defaults or ignored. Some params must be set, or an error will be thrown. These params are marked Required. Some parameters can have defaults set in Bugzilla, by the administrator. If these parameters have defaults set, you can omit them. These parameters are marked Defaulted. Clients that want to be able to interact uniformly with multiple Bugzillas should always set both the params marked Required and those marked Defaulted, because some Bugzillas may not have defaults set for Defaulted parameters, and then this method will throw an error if you don't specify them. The descriptions of the parameters below are what they mean when Bugzilla is being used to track software bugs. They may have other meanings in some installations.

product (string) Required - The name of the product the bug is being filed against. 
component (string) Required - The name of a component in the product above. 
summary (string) Required - A brief description of the bug being filed. 
version (string) Required - A version of the product above; the version the bug was found in. 
description (string) Defaulted - The initial description for this bug. Some Bugzilla installations require this to not be blank. 
op_sys (string) Defaulted - The operating system the bug was discovered on. 
platform (string) Defaulted - What type of hardware the bug was experienced on. 
priority (string) Defaulted - What order the bug will be fixed in by the developer, compared to the developer's other bugs. 
severity (string) Defaulted - How severe the bug is. 
alias (string) - A brief alias for the bug that can be used instead of a bug number when accessing this bug. Must be unique in all of this Bugzilla. 
assigned_to (username) - A user to assign this bug to, if you don't want it to be assigned to the component owner. 
cc (array) - An array of usernames to CC on this bug. 
qa_contact (username) - If this installation has QA Contacts enabled, you can set the QA Contact here if you don't want to use the component's default QA Contact. 
status (string) - The status that this bug should start out as. Note that only certain statuses can be set on bug creation. 
target_milestone (string) - A valid target milestone for this product.

In addition to the above parameters, if your installation has any custom fields, you can set them just by passing in the name of the field and its value as a string. Returns one element, id. This is the id of the newly-filed bug.

in: name
out: ids

Execute saved search. Returns list of bugs.

Execute search. Returns list of bugs.

ua

out: useragent

Returns LWP::UserAgent object user for communications with bugzilla.

AUTHOR

Alexey Alexandrov, <swined at cpan.org>

BUGS

Please report any bugs or feature requests to bug-www-bugzilla3 at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WWW-Bugzilla3. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc WWW::Bugzilla3

You can also look for information at:

COPYRIGHT & LICENSE

Copyright 2007 Alexey Alexandrov, all rights reserved.

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