Registry / crm-productivity / sprint-velocity

sprint-velocity

JSON →
library1.0.5pypypi✓ verified 83d ago

Generates a Matplotlib plot showing scrum velocity for a sprint using data from Jira. Current version 1.0.5, released occasionally.

crm-productivitydataserializationtesting
pip install sprint-velocity
github ↗package ↗
INSTALL
IMPORT
SIG · SPRINT-VELOCITY
S
sprint-velocity
crm-productivitypythonv1.0.5
harness data pending
Install & Compatibility
Where this runs

No compatibility data collected yet for this library.

Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

main
✓ from sprint_velocity import main
✗ from sprint_velocity import SprintVelocity
Module exposes a main() function, not a class.

Run main() after setting environment variables or config file.

from sprint_velocity import main import os # Ensure JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN are set main()
sprint-velocity --version
Debug
Known issues
gotchaJira API token required; environment variables JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN must be set, or a .env file present.
fix
Set environment variables or create a .env file with the required fields.
affects: >=1.0.0
gotchaThe plot is generated using Matplotlib, which requires a display backend (e.g., TkAgg) on headless systems.
fix
Set Matplotlib backend before import (e.g., import matplotlib; matplotlib.use('Agg')) or use a virtual display.
affects: >=1.0.0
deprecatedConfig file path argument in older versions was positional; now it's a flag.
fix
Use --config flag to specify config file path.
affects: <1.0.3
Errors
Common errors & fixes
ModuleNotFoundError: No module named 'sprint_velocity'
Package not installed or installed with a different name.
fix
Run 'pip install sprint-velocity' and ensure the package is installed.
ValueError: Invalid Jira URL
JIRA_URL environment variable not set or improperly formatted.
fix
Set JIRA_URL to a valid Jira instance URL, e.g., https://your-domain.atlassian.net.
jira.exceptions.JIRAError: HTTP 401 Unauthorized
Invalid or missing Jira API token or email.
fix
Ensure JIRA_EMAIL and JIRA_API_TOKEN are correct and the token has been generated in Jira.
Upgrade
Version history
1.0.5latest on PyPI · released Jul 19, 2022
Audit
Dependencies
jirarequiredrequired to fetch data from Jira
Agent activity
38 hits · last 30 days
node
34
OpenAI (training)
1
Resources
githubhttps://github.com/FelixTheC/jira_srcum_velocity ↗
packagehttps://pypi.org/project/sprint-velocity/ ↗
sprint-velocity — pip install sprint-velocity · libregistry