Pytest 测试框架与Allure 测试报告——Allure2测试报告-L1

目录：

1. allure2安装
   1. Allure2介绍
   2. Allure2报告展示
   3. Allure2报告展示-首页概览
   4. Allure2报告展示-用例详情页
   5. Allure2安装
   6. Allure2下载与安装
   7. Allure环境验证
   8. 插件安装-Python
   9. 插件安装-Java
   10. 验证插件安装-Java
2. allure2运行方式
   1. 生成测试报告流程
   2. 使用Allure2运行方式-Python
   3. 使用Allure2运行方式-Java
   4. 问题
   5. 代码示例：

1.allure2安装

Allure2 介绍

• Allure 是由 Java 语?开发的?个轻量级，灵活的测试报告?具。
• Allure 多平台的 Report 框架。
• Allure ?持多语?，包括 python、JaveScript、PHP、Ruby 等。
• 可以为开发/测试/管理等人员提供详尽的的测试报告，包括测试类别、测试步骤、日志、图片、视频等。
• 可以为管理层提供高水准的统计报告。
• 可以集成到 Jenkins 生成在线的趋势汇总报告。

Allure2 报告展示

github 地址：https://github.com/allure-framework/allure2

Allure2 报告展示 - 首页概览

Allure2 报告展示 - 用例详情页?

Allure2 安装

1. 安装 Java，需要配置环境变量。
2. 安装 Allure ，需要配置环境变量。
3. 安装插件
   • Python：pip install allure-pytest。
   • Java：Maven插件安装。

Allure2 下载与安装

1. 先下载 Allure 源码包到本地。
   • 下载地址 1
   • 下载地址 2
     • mac/linux: 下载 tar
     • windows: 下载 zip
2. 配置环境变量：解压后将 bin 目录加入 PATH 环境变量。

Allure 环境验证

• 执行命令验证环境

# 环境验证
allure --version

插件安装-Python

• 安装 Python 插件?allure-pytest
  • 执行命令：pip install allure

# linux/mac
> pip list |grep allure
allure-pytest         x.xx.x

# windows
> pip list |findstr allure
allure-pytest         x.xx.x

?插件安装-Java

• <groupId>指定了插件的groupId。
• <artifactId>指定了插件的artifactId。
• <version>指定了插件的版本号。

    <properties>
        <maven.compiler.encoding>UTF-8</maven.compiler.encoding>
        <maven.compiler.version>3.10.1</maven.compiler.version>
        <maven-surefire-plugin.version>3.0.0-M9</maven-surefire-plugin.version>
        <!-- 使用 Java 17 语言特性 ( -source 11 )  -->
        <java.version>17</java.version>
        <!-- 对应junit Jupiter的版本号;放在这里就不需要在每个依赖里面写版本号，导致对应版本号会冲突 -->
        <junit.jupiter.version>5.9.2</junit.jupiter.version>
        <!-- log日志 -->
        <slf4j.version>2.0.6</slf4j.version>
        <logback.version>1.4.5</logback.version>
        <!-- yaml对应解析 -->
        <jackson.version>2.14.2</jackson.version>
        <!-- hamcrest断言 -->
        <hamcrest.version>2.2</hamcrest.version>
        <!-- allure报告 -->
        <allure.version>2.21.0</allure.version>
        <allure.maven.version>2.12.0</allure.maven.version>
        <aspectj.version>1.9.19</aspectj.version>
        <allure.cmd.download.url>
            https://repo.maven.apache.org/maven2/io/qameta/allure/allure-commandline
        </allure.cmd.download.url>
    </properties>
    <!--    物料清单 (BOM)-->
    <dependencyManagement>
        <dependencies>
            <!--当使用 Gradle 或 Maven 引用多个 JUnit 工件时，此物料清单 POM 可用于简化依赖项管理。不再需要在添加依赖时设置版本-->
            <dependency>
                <groupId>org.junit</groupId>
                <artifactId>junit-bom</artifactId>
                <version>${junit.jupiter.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>
    <dependencies>
        <!-- junit5 -->
        <!-- 创建 Junit5 测试用例的 API-->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter</artifactId>
            <!--对应添加的依赖的作用范围-->
            <scope>test</scope>
        </dependency>
        <!-- 兼容 JUnit4 版本的测试用例-->
        <dependency>
            <groupId>org.junit.vintage</groupId>
            <artifactId>junit-vintage-engine</artifactId>
            <scope>test</scope>
        </dependency>
        <!--suite套件依赖 -->
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-suite</artifactId>
            <scope>test</scope>
        </dependency>

        <!-- log日志 -->
        <dependency>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-api</artifactId>
            <version>${slf4j.version}</version>
            <scope>compile</scope>
        </dependency>
        <dependency>
            <groupId>ch.qos.logback</groupId>
            <artifactId>logback-classic</artifactId>
            <version>${logback.version}</version>
            <scope>compile</scope>
        </dependency>

        <!--        allure报告-->
        <dependency>
            <groupId>io.qameta.allure</groupId>
            <artifactId>allure-junit5</artifactId>
            <version>${allure.version}</version>
        </dependency>

        <!-- https://mvnrepository.com/artifact/org.aspectj/aspectjweaver -->
        <dependency>
            <groupId>org.aspectj</groupId>
            <artifactId>aspectjweaver</artifactId>
            <version>${aspectj.version}</version>
        </dependency>

        <!--        yaml文件解析-->
        <dependency>
            <groupId>com.fasterxml.jackson.core</groupId>
            <artifactId>jackson-databind</artifactId>
            <version>${jackson.version}</version>
        </dependency>
        <dependency>
            <groupId>com.fasterxml.jackson.dataformat</groupId>
            <artifactId>jackson-dataformat-yaml</artifactId>
            <version>${jackson.version}</version>
        </dependency>

    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>${maven.compiler.version}</version>
                <configuration>
                    <source>${java.version}</source>
                    <target>${java.version}</target>
                    <!-- 设置编码为 UTF-8 -->
                    <encoding>${maven.compiler.encoding}</encoding>
                </configuration>
            </plugin>

            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-surefire-plugin</artifactId>
                <version>${maven-surefire-plugin.version}</version>
                <configuration>
                     <argLine>
                       -javaagent:"${settings.localRepository}/org/aspectj/aspectjweaver/${aspectj.version}/aspectjweaver-${aspectj.version}.jar"
                     </argLine>
                    <includes>
                        <!--  <include>**/*Test</include>-->
                        <!--  <include>**/Test*</include>-->
                    </includes>
                    <systemProperties>
                        <property>
                            <name>allure.results.directory</name>
                            <value>${project.build.directory}/allure-results</value>
                        </property>
                    </systemProperties>
                </configuration>
                <dependencies>
                    <dependency>
                        <groupId>org.junit.jupiter</groupId>
                        <artifactId>junit-jupiter-engine</artifactId>
                        <version>${junit.jupiter.version}</version>
                    </dependency>
                    <dependency>
                        <groupId>org.junit.vintage</groupId>
                        <artifactId>junit-vintage-engine</artifactId>
                        <version>${junit.jupiter.version}</version>
                    </dependency>
                </dependencies>
            </plugin>
            <plugin>
                <groupId>io.qameta.allure</groupId>
                <artifactId>allure-maven</artifactId>
                <version>${allure.maven.version}</version>
                <configuration>
                    <reportVersion>${allure.version}</reportVersion>
                    <allureDownloadUrl>${allure.cmd.download.url}/${allure.version}/allure-commandline-${allure.version}.zip</allureDownloadUrl>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

验证插件安装-Java

mvn clean test
mvn allure:report

# allure报告打开网站
mvn allure:serve

2.allure2运行方式

生成测试报告流程

使用 Allure2 运行方式-Python?

• 使用?--alluredir?参数生成测试报告。

# 在测试执行期间收集结果
pytest [测试用例/模块/包] --alluredir=./result/  (—alluredir这个选项 用于指定存储测试结果的路径)

# 生成在线的测试报告
allure serve ./result

使用 Allure2 运行方式-Java

• 使用?allure:report?参数生成测试报告。

# 在测试执行期间收集结果
# mvn命令行使用 maven插件安装
mvn clean test allure:report

# 生成在线的测试报告
# mvn 直接找target/allure-results目录
mvn allure:serve 

问题

• 运行mvn命令对应没有在target下面生成allure-results目录，怎么解决？

• 解决方案：

  • 在src/test/resources路径下配置allure配置文件allure.properties，指名allure报告生成路径。

  allure.results.directory=target/allure-resultsa

• ?运行mvn命令一直卡在下载中，如下图：

?

• 解决方案：
  • 在项目下创建.allure文件夹。
  • 下载allure解压到.allure文件夹下。

?

代码示例：

test_order.py

def test_one():
    assert True
 
 
def test_two():
    assert True
 
 
def test_three():
    assert True
 
 
def test_one1():
    assert True
 
 
def test_two2():
    assert True
 
 
def test_three3():
    assert True

?在终端运行：

pytest .\test_order.py --alluredir=./results

allure serve .\results 

运行结果：

?

?