GitPlanet

Cheap and reliable Node.js hosting starts at $3/month, and $1/month static HTML hosting

Created with love in Canada, visit hostnodejs.com today

Feel like to post an Ad? Learn Details
All Projects → nashahzad → jira-sprint-analytics

nashahzad / jira-sprint-analytics

Licence: Apache-2.0 license
No description or website provided.

Programming Languages

python
139335 projects - #7 most used programming language
Makefile
30231 projects
shell
77523 projects

Labels

plotlypoetrypandasflake8blackjira-rest-apipyyaml

Projects that are alternatives of or similar to jira-sprint-analytics

rubric
Linter Config Initializer for Python
Stars: ✭ 21 (+61.54%)
Mutual labels:  poetry, flake8, black
python-lint
GitHub Action for Lint your code
Stars: ✭ 57 (+338.46%)
Mutual labels:  flake8, black
Dash
Analytical Web Apps for Python, R, Julia, and Jupyter. No JavaScript Required.
Stars: ✭ 15,592 (+119838.46%)
Mutual labels:  plotly
gaitutils
Extract and visualize gait data
Stars: ✭ 28 (+115.38%)
Mutual labels:  plotly
Data-Visualizations
Data Visualizations is emerging as one of the most essential skills in almost all of the IT and Non IT Background Sectors and Jobs. Using Data Visualizations to make wiser decisions which could land the Business to make bigger profits and understand the root cause and behavioral analysis of people and customers associated to it. In this Reposito…
Stars: ✭ 55 (+323.08%)
Mutual labels:  plotly
Datavisualization
Tutorials on visualizing data using python packages like bokeh, plotly, seaborn and igraph
Stars: ✭ 234 (+1700%)
Mutual labels:  plotly
agentphantom
Automated GitHub profile content using the USGS API, Plotly and GitHub Actions.
Stars: ✭ 29 (+123.08%)
Mutual labels:  plotly
Edaviz
edaviz - Python library for Exploratory Data Analysis and Visualization in Jupyter Notebook or Jupyter Lab
Stars: ✭ 220 (+1592.31%)
Mutual labels:  plotly
dash-mantine-components
Plotly Dash components based on Mantine React Components
Stars: ✭ 263 (+1923.08%)
Mutual labels:  plotly
Interactive-Dashboards-and-Data-Apps-with-Plotly-and-Dash
Interactive Dashboards and Data Apps with Plotly and Dash, published by Packt
Stars: ✭ 181 (+1292.31%)
Mutual labels:  plotly
2019-nCoV-dash
新型冠状病毒（2019-nCoV）肺炎（COVID-19）疫情展示
Stars: ✭ 13 (+0%)
Mutual labels:  plotly
Dash.jl
Dash for Julia - A Julia interface to the Dash ecosystem for creating analytic web applications in Julia. No JavaScript required.
Stars: ✭ 248 (+1807.69%)
Mutual labels:  plotly
Orca
Command line application for generating static images of interactive plotly charts
Stars: ✭ 234 (+1700%)
Mutual labels:  plotly
blackbricks
Black for Databricks notebooks
Stars: ✭ 40 (+207.69%)
Mutual labels:  black
Tablesaw
Java dataframe and visualization library
Stars: ✭ 2,785 (+21323.08%)
Mutual labels:  plotly
poesy
Poetic processing, for Python.
Stars: ✭ 28 (+115.38%)
Mutual labels:  poetry
Slapdash
Boilerplate for bootstrapping scalable multi-page Dash applications
Stars: ✭ 225 (+1630.77%)
Mutual labels:  plotly
Iheatmapr
Complex, interactive heatmaps in R
Stars: ✭ 242 (+1761.54%)
Mutual labels:  plotly
yiq
Returns white when a color is dark and black when a color is light.
Stars: ✭ 24 (+84.62%)
Mutual labels:  black
blackdoc
run black on documentation code snippets
Stars: ✭ 31 (+138.46%)
Mutual labels:  black
View All Similar Projects ➔

Introduction

This is a command line tool that will fetch various metrics pertaining to a Jira project's current sprint or for the past N sprints. These metrics will be appended into a csv file that can be exported into any other external tools for further analysis or visualizations.

Additionally, one can also choose to run another script here as well to generate a visualization of the report that gets created.

Configuration

Python Dependencies

Python 3.7.1+ is required for running these scripts.

Poetry is the package manager utilized for this project. To install poetry the following can be ran:

make install

This will both install poetry if its not installed already and then use poetry to install all of the dependent packages.

Recommended to set up a virtual environment and activate that first before running poetry to install the dependent packages for these scripts.

Environment Variables

Copy over the TEMPLATE.env file and create a .env file with the templated values filled out.

  • JIRA_TOKEN - API token generated by JIRA
  • JIRA_EMAIL - Email used to generate the API token
  • JIRA_SERVER - Host url for the JIRA server

The following make command can be utlized to create a .env file based upon the TEMPLATE.env file:

make env

Command Line Args and Config File

The following are the command line args that need to be supplied to the scraper:

optional arguments:
  -h, --help            show this help message and exit
  --config-file CONFIG_FILENAME
                        Optional config file containing the configuration by
                        which to generate a report with, if provided then the
                        other args not required.
  --planned-capacities [PLANNED_CAPACITIES [PLANNED_CAPACITIES ...]]
                        The team's planned capacities for previous sprints. In
                        order of most current to the oldest sprint's planned
                        capacities.
  --board-id BOARD_ID   JIRA Board ID
  --project-name PROJECT_NAME
                        JIRA Project Name
  --story-points-field STORY_POINTS_FIELD
                        JIRA Story Points API field name
  --complete-status COMPLETE_STATUS
                        JIRA Issue status to indicate an Issue is done
  --priority-epics [PRIORITY_EPICS [PRIORITY_EPICS ...]]
                        Optional list of keys of the priority epics
  --past-n-sprints PAST_N_SPRINTS
                        Optionally grab metrics for the past N sprints, if
                        left out then only the currently active sprint's
                        metrics will be fetched

A config file can be supplied in the form of the --config-file arg to the jira scraper instead of passing a list of args everytime one wants to run the script. A templated config yaml file can be found in configs/TEMPLATE.yaml. Running the following make command can be used to create a copy of the TEMPLATE.yaml

make config PROJECT_NAME=<PROJECT_NAME>

Then one just needs to fill in the config values.

To Run

To generate the report one needs to run jira_scraper.py script:

➜ python jira_scraper.py --help
usage: jira_scraper.py [-h] [--config-file CONFIG_FILENAME]
                       [--planned-capacities [PLANNED_CAPACITIES [PLANNED_CAPACITIES ...]]]
                       [--board-id BOARD_ID] [--project-name PROJECT_NAME]
                       [--story-points-field STORY_POINTS_FIELD]
                       [--complete-status COMPLETE_STATUS]
                       [--priority-epics [PRIORITY_EPICS [PRIORITY_EPICS ...]]]
                       [--past-n-sprints PAST_N_SPRINTS]

optional arguments:
  -h, --help            show this help message and exit
  --config-file CONFIG_FILENAME
                        Optional config file containing the configuration by
                        which to generate a report with, if provided then the
                        other args not required.
  --planned-capacities [PLANNED_CAPACITIES [PLANNED_CAPACITIES ...]]
                        The team's planned capacities for previous sprints. In
                        order of most current to the oldest sprint's planned
                        capacities.
  --board-id BOARD_ID   JIRA Board ID
  --project-name PROJECT_NAME
                        JIRA Project Name
  --story-points-field STORY_POINTS_FIELD
                        JIRA Story Points API field name
  --complete-status COMPLETE_STATUS
                        JIRA Issue status to indicate an Issue is done
  --priority-epics [PRIORITY_EPICS [PRIORITY_EPICS ...]]
                        Optional list of keys of the priority epics
  --past-n-sprints PAST_N_SPRINTS
                        Optionally grab metrics for the past N sprints, if
                        left out then only the currently active sprint's
                        metrics will be fetched

To generate data visualizations based upon the report created by the scraper then one needs to run the visualization.py script:

➜ python visualization.py --help
usage: visualization.py [-h] [--config-file CONFIG_FILENAME]
                        [--project-name PROJECT_NAME]

optional arguments:
  -h, --help            show this help message and exit
  --config-file CONFIG_FILENAME
                        Optional config file that can be supplied and then the
                        otherargs are not required
  --project-name PROJECT_NAME
                        JIRA Project Name

Makefile Commands

  • make all - Clean out the .pyc files and install dependencies

  • make install - Install poetry and the dependent packages for this repo

  • make env - Create a .env file based on the TEMPLATE.env file

  • make config PROJECT_NAME=<project_name> - Create a new config file based upon the TEMPLATE.yaml file and name the new config file after the given project name

  • make clean - Clean out all .pyc files

  • make format - Uses the black formatter to format

  • make lint - Runs black and flake8 on the project all the python files in this project, these are the same checks ran on pull requests with Github actions

  • make dependency-tree - Outputs a all the dependencies for this project

Credits

Credits to all the packages outputted by make dependency-tree.

Note that the project description data, including the texts, logos, images, and/or trademarks, for each open source project belongs to its rightful owner. If you wish to add or remove any projects, please contact us at [email protected].