# DRI

So, are you the **D**irectly **R**esponsible **I**ndividual for GitLab's QA pipelines this week? Looking for a gem to help triage and report failing tests? Look no further.

Welcome to your new gem! DRI is a CLI ready to help:

- Fetching failing test cases by pipeline
- Reporting at the end of the timezone shift
- View today's newest and untriaged failures
- Take actions on failures

... and more.

## Installation

To install the `dri` gem:

```shell
$ gem install dri
```

And then execute `dri` to see all available options:

```shell
$ dri
```

## Usage

### Configuration

To use `dri` fully it is necessary to have:

- a Personal Access Token
- a triage emoji

The emoji is the [Award/My Reaction](https://docs.gitlab.com/ee/user/award_emojis.html) emoji associated with the failure issues to group all failures triaged on a given day. This emoji is a personal choice. Note that the same emoji should be used only while triaging failures and not associated with other issues out of the scope of triage.

To set up your personal profile:

```shell
$ dri init
```

To verify the profile is correctly set:

```shell
$ dri profile
```

### Commands

- [1. init](#1-init)
- [2. profile](#2-profile)
- [3. fetch](#3-fetch)
  - failures
  - testcases
- [4. publish](#4-publish)
  - report
- [5. rm](#5-rm)
  - emoji
- [6. version](#6-version)

#### 1. init

```shell
$ dri init
```

Initializes the `dri` CLI with necessary configurations to run smoothly.

#### 2. profile

```shell
$ dri profile
```

Shows the current profile associated after initial configuration.
Pass the option `--edit` to edit the current profile.

#### 3. fetch

```shell
$ dri fetch failures
```

Fetches today's opened failures and lists them according to their triage status.
Helpful to understand if there are missing recent failures to be reviewed.

```shell
$ dri fetch testcases
```

Fetches test cases that failing currently and groups them by pipeline.
To filter the pipelines, pass the `--filter-pipelines` options to multi-select the pipelines you wish to consult.
(Use `Space` to select an option)

#### 4. publish

```shell
$ dri publish report
```

Publishes a handover report on the latest triage issue, in the [pipeline-triage](https://gitlab.com/gitlab-org/quality/pipeline-triage) project.

**Options**

```shell
$ dri publish report --format=list # formats the report in a list
$ dri publish report --format=table # formats the report in a table (default)
$ dri publish report --dry-run # the report is only generated locally
```

#### 5. rm

```shell
$ dri rm emoji
```

Removes the triage emoji from all triaged issues.

#### 6. version

```shell
$ dri version
```

`dri` gem version.

## Copyright

Copyright (c) 2022 GitLab, Inc. See [MIT License](LICENSE.txt) for further details.