{"id":28295,"library":"sprint-velocity","title":"Sprint Velocity","description":"Generates a Matplotlib plot showing scrum velocity for a sprint using data from Jira. Current version 1.0.5, released occasionally.","status":"active","version":"1.0.5","language":"python","source_language":"en","source_url":"https://github.com/FelixTheC/jira_srcum_velocity","tags":["jira","scrum","velocity","matplotlib"],"install":[{"cmd":"pip install sprint-velocity","lang":"bash","label":"pip"}],"dependencies":[{"reason":"required to fetch data from Jira","package":"jira","optional":false}],"imports":[{"note":"Module exposes a main() function, not a class.","wrong":"from sprint_velocity import SprintVelocity","symbol":"main","correct":"from sprint_velocity import main"}],"quickstart":{"code":"from sprint_velocity import main\nimport os\n# Ensure JIRA_URL, JIRA_EMAIL, and JIRA_API_TOKEN are set\nmain()","lang":"python","description":"Run main() after setting environment variables or config file."},"warnings":[{"fix":"Set environment variables or create a .env file with the required fields.","message":"Jira API token required; environment variables JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN must be set, or a .env file present.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Set Matplotlib backend before import (e.g., import matplotlib; matplotlib.use('Agg')) or use a virtual display.","message":"The plot is generated using Matplotlib, which requires a display backend (e.g., TkAgg) on headless systems.","severity":"gotcha","affected_versions":">=1.0.0"},{"fix":"Use --config flag to specify config file path.","message":"Config file path argument in older versions was positional; now it's a flag.","severity":"deprecated","affected_versions":"<1.0.3"}],"env_vars":null,"last_verified":"2026-05-09T00:00:00.000Z","next_check":"2026-08-07T00:00:00.000Z","problems":[{"fix":"Run 'pip install sprint-velocity' and ensure the package is installed.","cause":"Package not installed or installed with a different name.","error":"ModuleNotFoundError: No module named 'sprint_velocity'"},{"fix":"Set JIRA_URL to a valid Jira instance URL, e.g., https://your-domain.atlassian.net.","cause":"JIRA_URL environment variable not set or improperly formatted.","error":"ValueError: Invalid Jira URL"},{"fix":"Ensure JIRA_EMAIL and JIRA_API_TOKEN are correct and the token has been generated in Jira.","cause":"Invalid or missing Jira API token or email.","error":"jira.exceptions.JIRAError: HTTP 401 Unauthorized"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}