Generate a monthly .xls
report of Jira tasks assigned to me.
Install poetry:
$ curl -sSL https://raw.githubusercontent.com/python-poetry/poetry/master/get-poetry.py | python
Install the module after download:
$ poetry install
Create a Jira API Token:
- Go to your Jira account settings.
- Open Security.
- Click Create and manage API tokens.
- Create a new API token.
- Copy the token to clipboard.
Create a local .env
file with the following environment variables:
$ echo 'JIRA_SERVER_URL="https://mycompany.atlassian.net"' >> .env
$ echo 'JIRA_USERNAME="[email protected]"' >> .env
$ echo 'JIRA_API_TOKEN="qeYEtFiNUJ8FCSEbBp25jNKc"' >> .env
Alternatively, the script will show an interactive prompt to generate this file for you.
The command:
$ poetry run jira-report [--month YYYY/MM] [--days N] [--force-overwrite] [--blacklist <path>]
Generate a report for the current month:
$ poetry run jira-report
Generate a report for a different month:
$ poetry run jira-report --month 2019/10
Generate a report for a different month and a custom number of business days:
$ poetry run jira-report --month 2019/10 --days 9