dohq-tfs 库主要用于与 Microsoft Team Foundation Server (TFS) 或 Azure DevOps Services 进行交互,比如创建、查询、更新工作项等。以下是一个简单的示例,演示如何使用 dohq-tfs
库来创建一个新的工作项:
from dohq_tfs import TFSClient
# 初始化TFS客户端
tfs_client = TFSClient(url="https://your-instance.visualstudio.com/", token="your_personal_access_token")
# 连接到特定的团队项目
project = tfs_client.get_project(name="YourProjectName")
# 定义新的工作项属性
work_item_data = {
"System.Title": "新工作项标题",
"System.WorkItemType": "Bug", # 类型可以替换为Task, User Story等
"System.Description": "工作项描述内容",
# 其他字段可以根据需求添加
}
# 创建新的工作项
new_work_item = project.create_work_item(work_item_data)
# 打印新创建的工作项ID
print(f"新建的工作项ID: {new_work_item.id}")
# 如果你需要更新已存在的工作项,可以这样操作:
existing_work_item_id = 123 # 假设这是你要更新的工作项ID
update_fields = {"System.State": "Resolved"} # 更新状态字段
project.update_work_item(existing_work_item_id, update_fields)
# 查询工作项
query_string = "SELECT * FROM WorkItems WHERE [System.WorkItemType] = 'Bug'"
work_items = project.query_work_items(query=query_string)
for work_item in work_items:
print(f"工作项ID: {work_item.id}, 标题: {work_item.fields['System.Title']}")
请根据实际情况替换 url
、token
、YourProjectName
和其他字段值。注意,上述代码片段假定你已经在TFS或Azure DevOps中配置了个人访问令牌(PAT),并且该令牌具有足够的权限来创建和修改工作项。
另外,由于API的复杂性,具体的功能和方法可能会随着时间和版本的不同而有所变化,因此在使用时务必查看dohq-tfs库的最新文档。