Struct BzInstance

pub struct BzInstance {
    pub host: String,
    pub auth: Auth,
    pub pagination: Pagination,
    pub included_fields: Vec<String>,
    /* private fields */
}

Configuration and credentials to access a Bugzilla instance.

Fields

host: String

auth: Auth

pagination: Pagination

included_fields: Vec<String>

Implementations

impl BzInstance

pub fn at(host: String) -> Result<Self, BugzillaQueryError>

Create a new BzInstance struct using a host URL, with default values for all options.

pub fn authenticate(self, auth: Auth) -> Self

Set the authentication method of this BzInstance.

pub fn paginate(self, pagination: Pagination) -> Self

Set the pagination method of this BzInstance.

pub fn include_fields(self, fields: Vec<String>) -> Self

Set Bugzilla fields that this BzInstance will request, such as flags.

By default, BzInstance requests the _default fields, and using this method overwrites the default value. If you want to set fields in addition to _default, specify _default in your list.

pub async fn bugs(&self, ids: &[&str]) -> Result<Vec<Bug>, BugzillaQueryError>

Access several bugs by their IDs.

pub async fn bug(&self, id: &str) -> Result<Bug, BugzillaQueryError>

Access a single bug by its ID.

pub async fn search(&self, query: &str) -> Result<Vec<Bug>, BugzillaQueryError>

Access bugs using a free-form Bugzilla search query.

An example of a query: component=rust&product=Fedora&version=36.