Name

jira time-in-status-wip - Prints out a report that shows the time spent in status for each issue found in the Jira Qquery Language query.

Synopsis

jira time-in-status-wip [flags] [options] --jql-query

Description

This command introspects jira to find the time in status for the set of issues defined in the Jira Query Language query. It prints an array of entries. The schema for the output appears below.

    {
      "$schema": "http://json-schema.org/draft-07/schema#",
      "title": "Array_of_Entry",
      "type": "array",
      "items": {
        "$ref": "#/definitions/Entry"
      },
      "definitions": {
        "Entry": {
          "type": "object",
          "required": [
            "completed",
            "description",
            "in_dev",
            "in_test",
            "name",
            "ready",
            "resolution",
            "status",
            "todo",
            "url",
            "waiting"
          ],
          "properties": {
            "completed": {
              "description": "How many days the issue was in the 'completed' status",
              "type": "number",
              "format": "double"
            },
            "description": {
              "description": "The issue summary",
              "type": "string"
            },
            "first_estimate": {
              "description": "The first estimate on the issue",
              "type": [
                "number",
                "null"
              ],
              "format": "double"
            },
            "in_dev": {
              "description": "How many days the issue was in the 'in_dev' status",
              "type": "number",
              "format": "double"
            },
            "in_test": {
              "description": "How many days the issue was in the 'in_test' status",
              "type": "number",
              "format": "double"
            },
            "name": {
              "description": "The key for the issue",
              "type": "string"
            },
            "ready": {
              "description": "How many days the issue was in the 'ready status",
              "type": "number",
              "format": "double"
            },
            "resolution": {
              "description": "The current resolution of the issue",
              "allOf": [
                {
                  "$ref": "#/definitions/Resolution"
                }
              ]
            },
            "status": {
              "description": "The current status of the issue",
              "allOf": [
                {
                  "$ref": "#/definitions/ItemStatus"
                }
              ]
            },
            "todo": {
              "description": "How many days the issue was in the 'todo' status",
              "type": "number",
              "format": "double"
            },
            "url": {
              "description": "The url of the JIRA issue",
              "type": "string"
            },
            "waiting": {
              "description": "How many days the issue was in the 'waiting' status",
              "type": "number",
              "format": "double"
            }
          }
        },
        "ItemStatus": {
          "description": "Provides the internal representation of status' for an item",
          "type": "string",
          "enum": [
            "ToDo",
            "Ready",
            "InDev",
            "InTest",
            "Waiting",
            "Completed"
          ]
        },
        "Resolution": {
          "description": "Provides the potential resolutions for an issue",
          "type": "string",
          "enum": [
            "UnResolved",
            "Rejected",
            "Delivered"
          ]
        }
      }
    } 

Flags

-h, --help

: prints help information

--load-from-jira-file

: if specified, the command loads from the jira data file specified in the 'debug-jira-file' argument, and doesn't pull from jira

--print-schema
: if provided the command prints the schema for the output to stdout

-V, --version

: prints version information

Options

--debug-jira-file
: raw api dump file. This dumps the response from jira

-j, --jql-query
: this option provides the Jira Query Language query that the command uses to gather the Issues which it analyzes for the Time in Status report

FAQ

Why would you need a command like this

It gives you insight into how long an issue spent in each status. It is useful for checking into whats going on with a particular set of issue.