NAME

WebService::Bugzilla::Product - Bugzilla Product object and service

VERSION

version 0.001

SYNOPSIS

my $product = $bz->product->get('Firefox');
say $product->name, ': ', $product->description;

my $products = $bz->product->search(is_active => 1);

DESCRIPTION

Provides access to the Bugzilla Product API. Product objects represent Bugzilla products and expose attributes about the product plus helpers to create, fetch, search, and update products.

ATTRIBUTES

All attributes are read-only and lazy.

classification

Classification name or object the product belongs to.

components

Arrayref of component data hashes.

default_milestone

Default milestone string for new bugs.

description

Human-readable product description.

has_unconfirmed

Boolean. Whether the product accepts the UNCONFIRMED status.

is_active

Boolean. Whether the product is active.

milestones

Arrayref of milestone data hashes.

name

Product name.

requires_component

Boolean. Whether a component is required when filing bugs.

versions

Arrayref of version data hashes.

METHODS

create

my $product = $bz->product->create(%params);

Create a new product. See POST /rest/product.

get

my $product = $bz->product->get($id_or_name);

Fetch a product by numeric ID or name. See GET /rest/product/{id}.

Returns a WebService::Bugzilla::Product, or undef if not found.

my $products = $bz->product->search(%params);

Search for products. See GET /rest/product.

Returns an arrayref of WebService::Bugzilla::Product objects.

update

my $updated = $product->update(%params);
my $updated = $bz->product->update($id, %params);

Update an existing product. See PUT /rest/product/{id}.

SEE ALSO

WebService::Bugzilla - main client

WebService::Bugzilla::Component - component objects

WebService::Bugzilla::Classification - classification objects

https://bmo.readthedocs.io/en/latest/api/core/v1/product.html - Bugzilla Product REST API

AUTHOR

Dean Hamstead <dean@fragfest.com.au>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2026 by Dean Hamstead.

This is free software, licensed under:

The MIT (X11) License