使用jira-agile-metrics包报错‘name 'jira' is not defined’求助

一、排查name 'jira' is not defined错误的可能原因 #

1. 依赖缺失或版本不兼容
   jira-agile-metrics依赖jira包，但安装过程可能未自动拉取该依赖，或环境中jira包损坏/未安装。手动安装依赖：

pip install jira

若仍报错，可参考官方文档指定的兼容版本安装：

pip install jira==[兼容版本号]

2. Python环境冲突
   多个Python环境（如系统环境、虚拟环境）可能导致包安装与执行环境不一致。执行以下命令确认当前环境的已安装包：

pip list | grep -E "jira|jira-agile-metrics"

若未输出这两个包，说明当前环境未安装，需切换到正确环境重新安装。

3. 包安装不完整
   卸载重装包，确保安装过程无报错：

pip uninstall -y jira-agile-metrics jira
pip install jira-agile-metrics

二、在IDE中使用该包的方法 #

完全可以在IDE中使用，无需局限于命令行：

1. 确保IDE的Python环境已安装jira-agile-metrics及其依赖；
2. 编写脚本调用包的核心API，示例如下：

from jira_agile_metrics import JiraAgileMetrics

# 加载你的YAML配置文件
metrics = JiraAgileMetrics.from_config("你的配置文件路径.yaml")
# 调用指标计算方法，例如获取周期时间数据
cycle_time_results = metrics.cycle_time()
print(cycle_time_results)

具体API可参考包的官方文档或源码注释。

内容的提问来源于stack exchange，提问作者Betabr