Name

jira time-in-progress-wip - Prints a report of the number of working days that each person spent on the tickets that someone assign the specified label or a specific epic.

Synopsis

Description

Prints JSON formatted list of how many working days (as defined by the provided calendar) each person spent on the ticket. For example, if there were two tickets and that each had two engineers working on them. It would provide output that looked like:

{ "year": 2022,
  "percentages-of-year": {
   "Lamar E Sullivan": 0.01204819277,
   "Ernest Gibson": 0.00803212851,
   "Melissa Baldwin": 0.02008032128
  },
  "working-days-per-issue": [
     {"key": "CPT-33", "name": "Lamar E Sullivan", "working-days": 3},
     {"key": "CPT-33", "name": "Ernest Gibson", "working-days": 2},
     {"key": "CPT-29", "name": "Melissa Baldwin", "working-days": 5}
  ]
}

The printed JSON matches the following schema:

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "year": {
      "type": "integer"
    },
    "percentages-of-year": {
      "type": "object",
      "additionalProperties": {
        "type": "number"
      }
    },
    "working-days-per-issue": {
      "type": "array",
      "items": [
        {
          "type": "object",
          "properties": {
            "key": {
              "description": "The idetifying KEY if the issue",
              "type": "string"
            },
            "name": {
              "description": "The name of the person who worked on the issue",
              "type": "string"
            },
            "working-days": {
              "description": "The number of days that person spent working on the issue",
              "type": "integer"
           }
          },
          "required": [
            "key",
            "name",
            "working-days"
         ],
          "additionalProperties": false
       }
     ]
   }
  },
  "required": [
    "year",
    "percentages-of-year",
    "working-days-per-issue"
  ],
  additionalProperties: false
}

Options

-h, --help

: Prints brief usage information.

-v, --version

: Prints the current version number.

-c, --holiday-calendar

: The holiday calendar to use to figure out working days. This is the country code for the national holidays.

FAQ

Why would you need a command like this

Its useful when you need to attribute time to a particular project. For example, in the use you can take advantage of a Research & Development tax credit. To do that, it helps to be able to attribute an engineers time to particular projects. If you are already working in jira, this command makes it easy.