squad-client

镜像概述和主要用途

squad-client是一个用于通过API访问SQUAD实例数据的工具。其设计目标是尽可能接近SQUAD的数据模型，通过使用直观的类和方法，使熟悉SQUAD术语的用户能够轻松上手。该工具目前处于早期开发阶段，如有发现bug请反馈。

核心功能和特性

• 贴近SQUAD数据模型：采用与SQUAD核心数据模型一致的类和方法设计，降低使用门槛
• 简化报告定制：支持基于特定需求快速生成自定义报告
• 多方式数据查询：提供YAML配置文件简化查询和Python代码实现复杂查询两种方式
• 直观的链式调用：支持通过类实例链式调用获取SQUAD中的组、项目、构建等数据

使用场景和适用范围

适用于需要从SQUAD实例获取数据并生成定制化报告的用户，尤其是熟悉SQUAD术语的开发、测试或数据分析人员。可广泛应用于自动化报告生成、测试结果分析、项目数据统计等场景。

使用方法和配置说明

报告生成（基础YAML配置方式）

1. 创建报告配置文件

创建YAML格式的报告配置文件（例如my-report.yml）：

squad_url: http://localhost:8000
reports:
    - name: 报告名称
      template: my_template.html.jinja2
      # output: generated_report.html  # 可选，省略则输出到stdout
      context:
          # 此处定义的键将在模板中可用
          projects: # 等同于代码中的 projects = Squad().projects(group__slug='lkft')
              type: Project
              filters:
                  group__slug: lkft  

2. 创建Jinja2模板文件

创建Jinja2模板文件（例如my_template.html.jinja2）：

{% for project_id, project in projects.items() %}
  {{ project.slug }}
{% endfor %}

3. 生成报告

执行以下命令生成报告：

./manage.py report --report-config my-report.yaml

输出示例：

    project: linaro-hikey-stable-rc-4.4-oe

    project: linux-developer-oe

    project: linux-mainline-oe

    project: linux-mainline-oe-sanity

    project: linux-next-oe

    project: linux-next-oe-new
    
    ...

复杂报告（Python代码方式）

对于更复杂的数据筛选和检索需求，可通过Python代码实现：

基础示例：获取特定构建

from squad_client.core.api import SquadApi
from squad_client.core.models import Squad

# 配置SQUAD API地址
SquadApi.configure(url='[***]

# 分步获取构建
group = Squad().group('lkft')
project = group.project('linux-stable-rc-4.14-oe-sanity')
build = project.build('v4.14.74')

# 或使用链式调用
build = Squad().group('lkft').project('linux-stable-rc-4.14-oe-sanity').build('v4.14.74')

# 带筛选条件的查询
finished_builds = Squad().group('lkft').project('linux-stable-rc-4.14-oe-sanity').builds(status__finished=True)

更多示例

可参考项目中的examples文件夹获取更多复杂查询和报告生成示例。