bug_history: Get Change History of Bug

In mvkorpel/bugtractr: Extract Data from Bugzilla Bug Tracker

Get Change History of Bug

Description

Returns the change history of a single bug. Throughout the life of a bug report, its status may get changed from UNCONFIRMED to NEW or ASSIGNED, and finally to CLOSED. New people may be added to the CC list of people subscribed to notifications about the bug. These and other changes are recorded, and the changes can be inspected with this function. By default, the R bug tracker is queried.

Usage

bug_history(
  bug_id,
  new_since = NULL,
  base_url = "https://bugs.r-project.org/bugzilla3/rest/bug/"
)

Arguments

bug_id	ID or alias of one bug (numeric or character).
new_since	Discard changes older than this. A character string with date in format YYYY-MM-DD or date and time as YYYY-MM-DDTHH24:MI:SSZ. The latter is year-month-date, letter "T", elements of time (hours, minutes and seconds) separated by :, and a final letter "Z" to mark that UTC time is being used. The standard date-time classes are also supported. Numeric values are accepted and interpreted as number of days relative to the current date. The default NULL means no limit.
base_url	URL to Bugzilla REST API (bug history). Defaults to R Bugzilla.

Details

If several properties (fields) of the bug were changed at once, the result will show duplicated values in the "when" and "who" columns.

Value

a tibble, with rows representing historical changes to the bug (in chronological order) and the following columns describing the details of the change:

when	Date and time of change (POSIXct).
who	Email address of person who made the change (character).
field_name	Field that was changed (character).
removed	Previous value of the field (character).
added	New value of the field (character).
attachment_id	ID of attachment that was changed (integer, NA_integer_ if the change was not about an attachment).

Examples

## Not run: 
hist1 <- bug_history(1)

## End(Not run)

mvkorpel/bugtractr documentation built on Aug. 31, 2022, 1:16 p.m.