Go to file
2021-04-02 13:52:19 -05:00
src Add README, rename tool to match repo, add .gitignore. 2021-04-02 13:48:27 -05:00
.gitignore Add README, rename tool to match repo, add .gitignore. 2021-04-02 13:48:27 -05:00
jira_analysis.nimble Add README, rename tool to match repo, add .gitignore. 2021-04-02 13:48:27 -05:00
Makefile Initial commit: tool to help analyze data from JIRA. 2021-04-02 13:31:35 -05:00
README.md Add steps to the README for installing Nim. 2021-04-02 13:52:19 -05:00

Script to extract data from JIRA and pull it into a postgres DB for analysis.

Setup

  1. Install docker

  2. Install nim (via choosenim).

  3. Generate an API token for your JIRA user.

  4. Pull the database container:

    make createdb
    

    Feel free to edit the Makefile to view or change the default username/password combination.

  5. Build the tool:

    nimble build
    

Usage

  • Start the database container:

    make startdb
    
  • Pull issues from your JIRA instance into the DB:

    ./jira_analysis api-sync <jira-base-url> <username> <api-token>
    
  • Connect to the database for analysis:

    make connect
    

Convenient PostgreSQL commands

From within a psql session:

  • Export tables to CSV:

    \copy features TO features-export.csv DELIMITER ',' CSV HEADER;
    \copy issues TO issues-export.csv DELIMITER ',' CSV HEADER;
    \copy change_logs TO changelog-export.csv DELIMITER ',' CSV HEADER;