API Testing

本地安装

Mon, 01 Jan 0001 00:00:00 +0000

手动下载

您可以通过下面的链接下载最新版本的安装包：

Package	GitHub	Mirror from DaoCloud
`atest-desktop.msi`	link	link
`atest-linux-amd64.tar.gz`	link	link
`atest-darwin-amd64.tar.gz`	link	link

通过工具下载

hd 是一个支持多线程下载的工具：

hd i atest

很荣幸与屈晗煜在 GitLink 编程夏令营（GLCC）活动中协作

Mon, 01 Jan 0001 00:00:00 +0000

很荣幸与屈晗煜在 GitLink 编程夏令营（GLCC）活动中协作

作为一名软件工程师，天然有着追求代码质量的执念。相信很多人对代码的优雅、质量有着自己的认识，业界也有不少的共识，其中有一条我认为是非常重要的——代码可测试。

作为一名研发，只关注功能可测（容易测）是远远不够的。从严谨的角度来看，我们每提交一个 PR（泛指有新的代码准备如何主分支）时，需要提供你已经测试通过的“证据”。仅仅基于对团队成员的信任（或 QA 人员的回归测试）是很难从软件工程角度来保障代码质量的。研发 leader（或 QA）在面对 PR 时，可能会问到：你的代码自测过了吗？这也许是一个毫无意义的提问——可能很大一部分人会出于面子考虑直接回答”测过了“，另外一些诚实的人会说”忘记了“。在我看来，我们需要避免类似的无效、低效沟通；既然都是研发，那为什么不用测试代码来证明你的逻辑（或业务）代码的正确性呢？

单元测试、接口测试，是两种非常有效的、相对低成本的方法，前者可以确保函数的逻辑正确，后者可以确保 API 总是按照既定的输入和输出格式来处理。对于后端研发来说，能把这两种方法用起来的话，低级的、关联性的 bug 已经很难再流入到代码仓库的主干分支中了。API Testing 项目的发起，主要是为了持续提高我自己的代码质量，并且希望能帮助到有需要的其他人（研发或测试）。这个项目提供了诸如：命令行、CICD、VS-Code、浏览器等场景对接口测试的需求，目标是在尽量不改变已有研发习惯的前提下，使得大家可以便捷、简单地借助接口测试提高自己的代码质量。文中多次提到代码质量，本项目的后端 Golang 部分的单元测试覆盖率目前为 94%，之后也会持续提高测试覆盖率（包括前端等代码的）。

几周前，了解到 GLCC 这个活动还在招募开源项目。于是尝试联系官方负责人，咨询是否接受个人发起的开源项目（而且还是一个处在早期阶段的项目，截止本文只有 77 次 commit）。另外我感到惊喜和意外的是，这个项目不仅受到官方的认可与资助（完成项目议题的同学可以得到 6000 元奖励），而且还有 5 位同学对这个项目表示感兴趣，收到 4 份申请书。之后，我分别从多个维度尝试选择与项目匹配的申请人：是否在本项目中提交过 PR 或 issue、是否有邮件等沟通、议题设计、示例代码或 POC、GitHub 是否活跃、时间安排是否充足等（前面每一项的权重略有不同）。要知道，大部分同学都已经通过邮件和我进行了多次沟通，而且有两位同学也分别提交过 PR、issue，放弃任何一位申请人都是于心不忍的，因而我也尽量以相对客观的方式来做出选择。

让我印象比较深刻的是，屈晗煜 (Ink-33) 同学在申请书中给出了他对 gPRC 的一些调研结果，以及如何实现 gRPC 接口测试的大致思路，甚至还有一些实验性的代码。另外，他虽然只是大一新生，但编码经验却不少；能看得出来他确实是对编程很感兴趣。

最后，希望其他几位同学能匹配到其他项目，并能在参与开源的过程中有所收获。

本文相关链接：

Helm

Mon, 01 Jan 0001 00:00:00 +0000

You could install api-testing via Helm chart:

helm install atest oci://docker.io/linuxsuren/api-testing \
 --version v0.0.2-helm \
 --set service.type=NodePort

or upgrade it:

helm upgrade atest oci://docker.io/surenpi/api-testing \
 --version v0.0.2-helm \
 --set image.tag=master \
 --set replicaCount=3

SkyWalking

helm install atest oci://docker.io/linuxsuren/api-testing \
 --version v0.0.2-helm \
 --set image.tag=master \
 --set service.type=NodePort \
 --set service.nodePort=30154 \
 --set skywalking.endpoint.http=http://skywalking-skywalking-helm-oap.skywalking.svc:12800 \
 --set skywalking.endpoint.grpc=skywalking-skywalking-helm-oap.skywalking.svc:11800

安全策略

Mon, 01 Jan 0001 00:00:00 +0000

// TBD

发展规划

Mon, 01 Jan 0001 00:00:00 +0000

// TBD

贡献指南

Mon, 01 Jan 0001 00:00:00 +0000

请加入我们，共同完善这个项目。

后端由 Golang 编写，前端由 Vue 编写。

对于初学者

在开始之前，您可能需要了解以下技术:

Name	Domain
HTTP Protocol	Core
RESTful	Core
gRPC	`gRPC` runner extension
Prometheus	Application monitor
Cobra	The Go CLI framework
Element Plus	The front-end framework
Docker	The container image build
Helm chart	The Kubernetes application package
GitHub Actions	The continuous integration
make	The automated Build Tools
Docs Guide	文档编写指南

设置开发环境

本项目使用 make 作为构建工具，并设计了非常强大的 make 指令系统。您可以通过运行 make help 查看所有可用的命令。

强烈建议您配置 git pre-commit 钩子。它会强制在提交前运行单元测试。运行以下命令：

make install-precheck

打印各行代码：

git ls-files | xargs cloc

pprof

go tool pprof -http=:9999 http://localhost:8080/debug/pprof/heap

其他用法：

目标

Mon, 01 Jan 0001 00:00:00 +0000

// TBD

快速入门

Mon, 01 Jan 0001 00:00:00 +0000

本指南将帮助您通过几个简单的步骤开始使用 API Testing。

执行部分测试用例

下面的命令会执行名称中包含 sbom 的所有测试用例：

atest run -p test-suite.yaml --case-filter sbom

JSON Schema

您可以访问下面 atest 的 JSON Schema 来了解测试用例的编写规范：

https://linuxsuren.github.io/api-testing/api-testing-schema.json

关于安全

Mon, 01 Jan 0001 00:00:00 +0000

通常在不使用 TLS 证书认证时，gRPC 客户端与服务端之间进行的是明文通信，信息易被第三方监听或篡改。所以大多数情况下均推荐使用 SSL/TLS 保护 gRPC 服务。目前atest已实现服务端 TLS，双向 TLS(mTLS) 需等待后续实现。

默认情况下atest不使用任何安全策略，等价于spec.secure.insecure = true。启用 TLS 仅需 yaml 中添加以下内容：

spec:
 secure:
 cert: server.pem
 serverName: atest

字段说明

secure共有以下五个字段：

字段名	类型	是否可选
cert	string	x
ca	string	√
key	string	√
serverName	string	x
insecure	bool	√

cert为客户端需要配置的证书的文件路径，格式为PEM。

serverName为 TLS 所需的服务名，通常为签发证书时使用的 x509 SAN。

ca为 CA 证书的路径，key为与cert对应的私钥，这两项填写后代表启用 mTLS。(mTLS 尚未实现)

当insecure为false时，cert和serverName为必填项。

用例模板

Mon, 01 Jan 0001 00:00:00 +0000

atest 采用 sprig 作为测试用例的模板引擎。通过模板函数可以生成很多随机数据：

手机号

下面的代码可以生成 182 开头的手机号：

182{{shuffle "09876543"}}

带权重的随机枚举

下面的代码以 80% 的概率返回 open，以 20% 的概率返回 closed：

{{randWeightEnum (weightObject 4 "open") (weightObject 1 "closed")}}

时间

下面的代码可以生成当前时间，并制定时间格式：

{{ now.Format "2006-01-02T15:04:05Z07:00" }}

如果想要获取其他时间，则可以参考如下写法：

{{(now | date_modify "2h") | date "2006-01-02T15:04:05"}}

环境变量

下面的代码可以获取环境变量 SHELL 的值，在需要使用一个全局变量的时候，可以使用这个模板函数：

{{ env "SHELL" }}

任务

Mon, 01 Jan 0001 00:00:00 +0000

在特定情况下，执行接口测试用例前需要执行相应的任务，例如：数据初始化、等待服务就绪等等。 atest 的任务功能，就是为了满足这类场景而设计的。

任务的执行引擎为 expr，如果当前页面给出的示例无法满足你的需求，可以查阅相关的官方文档。

等待接口响应码为 200

以下的例子会每隔一秒请求一次指定的接口，并检查响应码（Status Code）是否为 200，如果不是的话，则最多会重试 3 次：

name: demo
api: http://localhost
items:
 - name: login
 before:
 items:
 - httpReady("http://localhost/health", 3)
 request:
 api: /demo

如果希望检查响应体的话，则可以用下面的表达式：

httpReady("http://localhost:17001/actuator/health", 3, 'components.discoveryComposite.components.eureka.details.applications["AUTH"] == 1')

测试用例验证

Mon, 01 Jan 0001 00:00:00 +0000

atest 采用 https://expr.medv.io 对 HTTP 请求响应的验证，比如：返回的数据列表长度验证、具体值的验证等等。下面给出一些例子：

需要注意的是，data 指的是 HTTP Response Body（响应体）的 JSON 对象。

数组长度判断

 - name: projectKinds
 request:
 api: /api/resources/projectKinds
 expect:
 verify:
 - len(data.data) == 6

数组值检查

检查数组中是否有元素的字段包含特定值

示例数据：

{
 "data": [{
 "key": "Content-Type"
 }]
}

校验配置：

- name: popularHeaders
 request:
 api: /popularHeaders
 expect:
 verify:
 - any(data.data, {.key == "Content-Type"})

检查数组中是否有元素的字段只包含特定值

校验配置：

- name: popularHeaders
 request:
 api: /popularHeaders
 expect:
 verify:
 - all(data.data, {.key == "Content-Type" or .key == "Target"})

更多用法.

End-to-End

Mon, 01 Jan 0001 00:00:00 +0000

atest 非常适合针对（HTTP）接口做 E2E（端到端）测试，E2E 测试可以确保后端接口在完整的环境中持续地保持正确运行。下面采用 Docker compose 给出一个使用事例：

version: '3.1'
services:
 testing:
 image: ghcr.io/linuxsuren/api-testing:latest
 environment:
 SERVER: http://server:8080
 volumes:
 - ./testsuite.yaml:/work/testsuite.yaml
 command: atest run -p /work/testsuite.yaml
 depends_on:
 server:
 condition: service_healthy
 links:
 - server
 server:
 image: ghcr.io/devops-ws/learn-springboot:master
 healthcheck:
 test: ["CMD", "bash", "-c", "cat < /dev/null > /dev/tcp/127.0.0.1/8080"]
 interval: 3s
 timeout: 60s
 retries: 10
 start_period: 3s

从 Docker compose v2.36.0 开始，可以采用如下简化的写法：

Mock 服务

Mon, 01 Jan 0001 00:00:00 +0000

Mock 服务在前后端并行开发、系统对接、设备对接场景下能起到非常好的作用，可以极大地降低团队之间、系统之间的耦合度。

用户可以通过命令行终端（CLI）、Web UI 的方式来使用 Mock 服务。

命令行

atest mock --prefix / --port 9090 mock.yaml

Web

在 UI 上可以实现和命令行相同的功能，并可以通过页面编辑的方式修改、加载 Mock 服务配置。

Mock Docker Registry

您可以通过执行下面的命令 mock 一个容器仓库服务container registry:

atest mock --prefix / mock/image-registry.yaml

之后，您可以通过使用如下的命令使用 mock 功能。

docker pull localhost:6060/repo/name:tag

语法

从整体上来看，我们的写法和 HTTP 的名称基本保持一致，用户无需再了解额外的名词。此外，提供两种描述 Mock 服务的方式：

面向对象的 CRUD
自定义 HTTP 服务

面向对象

#!api-testing-mock
# yaml-language-server: $schema=https://linuxsuren.github.io/api-testing/api-testing-mock-schema.json
objects:
 - name: projects
 initCount: 3
 sample: |
 {
 "name": "atest",
 "color": "{{ randEnum "blue" "read" "pink" }}"
 }

上面 projects 的配置，会自动提供该对象的 CRUD（创建、查找、更新、删除）的 API，你可以通过 atest 或类似工具发出 HTTP 请求。例如：

代码生成

Mon, 01 Jan 0001 00:00:00 +0000

atest 支持把测试用例生成多种开发语言的代码：

curl
Java
Golang
Python
JavaScript
Robot Framework

该功能需要在 Web UI 上使用。

gRPC测试用例编写指南

Mon, 01 Jan 0001 00:00:00 +0000

本文档将介绍如何编写api-testing的 gRPC API 的测试用例。

阅读本文档之前，您需要先安装并配置好api-testing，具体操作可以参考安装章节。如果您已经完成了这些步骤，可以继续阅读本文档的后续部分。

创建测试项目

创建一个基于服务反射的 gRPC 测试用例仅需在 yaml 文件的spec路径下加入以下内容：

spec:
 rpc:
 serverReflection: true

rpc字段一共有五个子字段

字段名	类型	是否可选
import	[]string	√
protofile	string	√
protoset	string	√
serverReflection	bool	√

字段`import`和`protofile`

protofile是一个文件路径，指向api-testing查找描述符的.proto文件的位置。

import字段与protc编译器中的--import_path参数类似，用于确定查找proto文件的位置与解析依赖的目录。与protoc一样，您不需要在此处指定某些proto文件的位置（以google.protobuf开头的Protocol Buffers Well-Known Types），它们已经内置在了api-testing中。

字段`protoset`

protoset字段既可以是一个文件路径，也可以是http(s)://开头的网络地址。

当您的proto数量繁多或引用关系复杂，可以尝试使用protoc --descriptor_set_out=set.pb生成proto描述符集合。本质上它是一个使用了wire编码的二进制文件，其中包括了所有需要的描述符。

字段`serverReflection`

若目标服务器支持服务反射，将此项设为true则不再需要提供上述三个字段。

注：api-testing对三种描述符来源的优先级顺序为

serverReflection > protoset > protofile

编写gRPC API测试

与编写HTTP测试用例类型，您需要在根节点的api字段定义服务器的地址。

api: 127.0.0.1:7070

默认情况下api-testing使用不安全的方式连接到目标服务器。若您想配置TLS证书，请参考文档关于安全

编写gRPC API测试的方式与编写HTTP API测试的方式基本相同。

- name: FunctionsQuery
 request:
 api: /server.Runner/FunctionsQuery
 body: |
 {
 "name": "hello"
 }
 expect:
 body: |
 {
 "data": [
 {
 "key": "hello",
 "value": "func() string"
 }
 ]
 }

api字段的格式为/package.service/method，支持 gRPC 一元调用、客户端流、服务端流和双向流调用。

gRPC TLS verification

Mon, 01 Jan 0001 00:00:00 +0000

If you want to enable gRPC TLS, you need to generate your certificates in the workspace, or you can use an absolute path

1. 生成私钥

openssl genrsa -out server.key 2048

2. 生成证书（会提示即可，不必填写）

openssl req -new -x509 -key server.key -out server.crt -days 36500
国家名字
Country Name (2 letter code) [AU]:CN
省份全名
State or Province Name (full name) [Some-State]:GuangDong
城市名
Locality Name (eg, city) []:Meizhou
组织名
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Xuexiangban
组织单位名
Organizational Unit Name (eg, section) []:go
服务器or用户的名字
Common Name (e.g. server FQDN or YOUR name) []:kuangstudy
邮箱地址
Email Address []:24736743@qq.com

3.生成csr

插件

Mon, 01 Jan 0001 00:00:00 +0000

atest 会把非核心、可扩展的功能以插件（extension）的形式实现。下面介绍有哪些插件，以及如何使用：

在不同的系统中，插件有着不同的表述，例如：extension、plugin 等。

类型	名称	描述
存储	orm	保存数据到关系型数据库中，例如：MySQL、Postgres 等
存储	mongodb	保存数据到 MongDB 中
存储	etcd	保存数据到 Etcd 数据库中
存储	iotdb	支持通过 Web UI 查询 IoTDB 数据
存储	Cassandra	支持通过 Web UI 查询 Cassandra 数据
存储	Elasticsearch	支持通过 Web UI 查询 Elasticsearch 数据
存储	redis
存储	s3	保存数据到对象存储中
存储	git	保存数据到 Git 仓库中
数据	Swagger

atest 也是唯一支持如此丰富的存储的接口开发、测试的开源工具。

下载插件

我们建议通过如下的命令来下载插件：

atest extension orm

上面的命令，会识别当前的操作系统，自动下载最新版本的插件。当然，用户可以通过自行编译、手动下载的方式获取插件二进制文件。

atest 可以从任意支持 OCI 的镜像仓库中（命令参数说明中给出了支持的镜像服务地址）下载插件，也可以指定下载超时时间：

API 引用

Mon, 01 Jan 0001 00:00:00 +0000

// TBD.

v0.0.12

Mon, 01 Jan 0001 00:00:00 +0000

atest 版本发布 v0.0.12

atest 是一款用 Golang 编写的、基于 YAML 格式的开源接口测试工具，可以方便地在本地、服务端、持续集成等场景中使用。我们希望提供一个简单、强大、高质量的测试工具，方便测试、研发人员快速、低成本地借助接口测试为产品研发质量保驾护航。

通过以下命令启动 HTTP 代理服务器后，给您的浏览器配置该代理，打开业务系统就会自动录制：

docker run -p 1234:8080 -v /var/tmp:/var/tmp \
 ghcr.io/linuxsuren/api-testing atest-collector \
 --filter-path /api \
 -o /var/tmp/sample.yaml
# --filter-path /api 会过滤所有以 /api 为前缀的 HTTP 请求
# 关闭服务后，您可以在 /var/tmp/sample 这个目录中找到生成的测试用文件

更新重点

支持通过基于 HTTP 代理服务生成测试用例
支持根据 Swagger 数据生成接口测试覆盖率
增加 HTML、Markdown 等格式的测试报告
代码重构，包括：包结构、原文件名整理，逻辑抽象为接口以及不同实现
支持打印所有支持的模板函数
优化 Kubernetes 的部署清单文件
修复已知缺陷

本次版本发布，包含了以下三位 contributor 的努力：

v0.0.13

Mon, 01 Jan 0001 00:00:00 +0000

atest 版本发布 v0.0.13

atest 是一款用 Golang 编写的、开源的接口测试工具。

你可以在容器中启动：

docker run -v /var/www/sample:/var/www/sample \
 --network host \
 linuxsuren/api-testing:master

或者，直接下载二进制文件后启动：

atest server --local-storage /var/www/sample

对于持续集成（CI）场景，可以通过在流水线中执行命令的方式：

# 执行本地文件
atest run -p your-test-suite.yaml
# 执行远程文件
atest run -p https://gitee.com/linuxsuren/api-testing/raw/master/sample/testsuite-gitee.yaml
# 容器中执行
docker run linuxsuren/api-testing:master atest run -p https://gitee.com/linuxsuren/api-testing/raw/master/sample/testsuite-gitee.yaml

你也可以把测试用例转为 JMeter 文件并执行：

# 格式转换
atest convert --converter jmeter -p https://gitee.com/linuxsuren/api-testing/raw/master/sample/testsuite-gitee.yaml --target gitee.jmx
# 执行
jmeter -n -t gitee.jmx

主要的新功能

增加了插件扩展机制，支持以 Git、S3、关系型数据为后端存储，支持从 Vault 获取密码等敏感信息
新增对 gRPC 接口的用例支持 @Ink-33
支持导出 JMeter 文件
支持通过 Operator 的方式安装，并上架 OperatorHub.io
提供了基本的 Web UI
支持导出 PDF 格式的测试报告 @wjsvec

本次版本发布，包含了以下 5 位 contributor 的努力：

v0.0.14

Mon, 01 Jan 0001 00:00:00 +0000

atest 版本发布 v0.0.14

atest 是一款用 Golang 编写的、开源的接口测试工具。

你可以在容器中启动：

docker run --network host \
 linuxsuren/api-testing:v0.0.14

或者，直接下载二进制文件后启动：

atest server --local-storage /var/www/sample

主要的新功能

增加了对 tRPC 和 gRPC 协议的（命令行与 Web 界面）支持
新增了 Helm Chart 的安装方式
支持通过按钮切换暗模式
支持启动启动插件
支持在 Web 界面中参数化执行
支持生成 curl 与 Golang 代码
支持从 Postman 中导入测试用例
可观测方便，增加了对 Apache SkyWalking 和 Prometheus 的支持
一些 Web 界面操作的优化（例如：多语言、测试结果缓存、自动保存）

本次版本发布，包含了以下 5 位 contributor 的努力：

v0.0.15

Mon, 01 Jan 0001 00:00:00 +0000

atest 发布 v0.0.15

atest 是致力于帮助开发者持续保持高质量 API 的开源接口工具。

你可以在命令行终端或者容器中启动：

docker run -p 8080:8080 linuxsuren/api-testing:v0.0.15

亮点

在本次版本发布之前，成功地为以下开源项目实现了 API 的 E2E 测试：

halo-dev/halo，一款 Java 实现的开源建站工具
dromara/hertzbeat，一款监控系统

非常期待 atest 可以帮助更多的项目持续提升、保持 API 稳定性。

主要的新功能

支持复用 Cookies（简化了基于 Cookie 做会话认证） (#301) @LinuxSuRen
增加了基于 Docker 的应用性能监控 (#300) @LinuxSuRen
支持以 Comment 的方式发送测试报告到 GitHub PR (#298) @LinuxSuRen
UI 布局重构 (#297) @LinuxSuRen
增加对 OAuth 认证的支持（包括 Device 模式） (#290) @LinuxSuRen
支持设置 gRPC 的元数据 (#282) @LinuxSuRen
增加了新的后端存储： Mongodb (#278) @LinuxSuRen

致谢

本次版本发布，包含了以下 2 位 contributor 的努力：

v0.0.17

Mon, 01 Jan 0001 00:00:00 +0000

atest 发布 v0.0.17

atest 是致力于帮助开发者持续保持高质量 API 的开源接口工具。

你可以在命令行终端或者容器中启动：

docker run -p 8080:8080 ghcr.io/linuxsuren/api-testing:v0.0.17

亮点

我们提供了基于 Electron 的桌面应用，会极大地方便开发者在桌面环境中测试 API。
为缩减镜像的体积（40M），我们把插件全部以 OCI 的格式单独存储，并在启用时自动下载。
诞生了第二位项目 Committer @yuluo-yx

非常期待 atest 可以帮助更多的项目持续提升、保持 API 稳定性。

🚀 主要的新功能

支持通过 HTTP 请求执行测试套件 (#478) @LinuxSuRen
增加 gRPC 接口对 TLS 的支持 (#477) @DWJ-Squirtle
支持自动下载插件 (#471) @LinuxSuRen
补充代码生成器的 e2e 测试 (#458) @LinuxSuRen
支持复制测试用例和测试套件 (#455) @LinuxSuRen
Web 界面上添加切换语言的按钮 (#447) @SamYSF
支持通过 Web 界面查看 YAML 格式的测试套件 (#438) @SamYSF
支持发送测试报告到 gRPC 服务 (#431) @lizzy-0323
支持发送测试报告到 HTTP 服务 (#367) @hahahashen
增加基于 Electron 的桌面应用 (#428) @LinuxSuRen
实现了镜像 Registry 的 Mock 服务 (#425) @LinuxSuRen
支持在 Web 界面启动、刷新 Mock 服务 (#410) @LinuxSuRen
支持根据测试用例生成 JavaScript 代码 (#400) @YukiCoco
支持根据测试用例生成 Python 代码 (#398) @zhouzhou1017
支持根据测试用例生成 Java 代码 (#369) @Agility6
增加日志框架的支持 (#389) @yuluo-yx
生成 Golang 代码时支持 Cookie 的设置 (#363) @SLOWDOWNO
测试用例支持 Cookie 设置 (#355) @LinuxSuRen

🐛 缺陷修复

解决测试用例页面徽章显示的问题 (#462) @SamYSF
解决无法导入 Postman 子集的问题 (#426) @SamYSF
优化 gRPC 消息超过默认值的处理 (#399) @acceleratorssr
解决 golang.org/x/net 的安全漏洞 CVE-2023-45288 (#401) @yuluo-yx
修复生成 Golang 代码时对 HTTP 请求体的设置 (#383) @Agility6

📝 文档

增加行为准则说明 (#379) @yuluo-yx
增加安全漏洞相关的说明 (#391) @yuluo-yx
更新贡献文档说明 (#380) @yuluo-yx

👻 维护

用 openapi 官方的依赖库替换当前实现 (#439) @dshyjtdes8888
增加 issue comment github actions (#382) @yuluo-yx

致谢

本次版本发布，包含了以下 13 位 contributor 的努力：

v0.0.18

Mon, 01 Jan 0001 00:00:00 +0000

atest 发布 v0.0.18

atest 是致力于帮助开发者持续保持高质量 API 的开源接口工具。

你可以在命令行终端或者容器中启动：

docker run -p 8080:8080 ghcr.io/linuxsuren/api-testing:v0.0.18

亮点

在开源之夏 2024 中 atest 增加了基于 MySQL 的测试用例历史的支持
HTTP API Mock 功能的支持

在系统和平台的开发过程中，我们通常会采用前后端分离的开发模式。在后端API尚未开发完成、稳定化，并且未部署到公共集成测试环境之前，前端开发者往往需要通过硬编码数据来推进页面开发。待后端开发完成后，会进入所谓的“联调”阶段，这时可能会遇到以下问题：

前端可能需要调整数据结构、页面布局和逻辑，并重新进行测试
在实际查看页面后，可能会发现后端的数据结构和API的请求与响应需要调整

在最坏的情况下，前后端的联调可能会耗费远超预期的时间。为了更有效地解决这一问题，atest 提供了HTTP API Mock功能。

在设计评审阶段，我们可以根据API设计提供相应的Mock服务配置，从而快速模拟后端API的响应数据。例如：

objects:
 - name: users
 sample: |
 {
 "name": "LinuxSuRen",
 "age": 18
 "gender": "male"
 }
proxies:
 - path: /api/v1/projects/{projectID}
 target: http://localhost:8080

把上面的内容放到 mock.yaml 文件中，然后使用 atest mock --prefix /api/v1 --port 6060 mock.yaml 命令即可启动一个 HTTP Mock 服务。

v0.0.20

Mon, 01 Jan 0001 00:00:00 +0000

atest 发布 v0.0.20

atest 是致力于为开发者提供一站式接口开发、测试的开源工具，无需注册账号、完全私有化部署、可扩展、可定制。

亮点

增加对正态分布随机函数的支持 (#761) @LinuxSuRen
Web 页面支持快捷键绑定的特性，而且，用户可以通过配置文件修改 (#728) @LinuxSuRen
Web 页面支持主题切换 (#715) @LinuxSuRen
优化欢迎页面布局 (#708) @Aditya-132
Mock 服务中增加 TCP 类型的代理 (#692) @LinuxSuRen
支持多线程下载插件 (#669) @LinuxSuRen
支持通过 HTTP 协议启动插件 (#664) @LinuxSuRen
支持 SQL 语言编辑器的自动补全 (#722) @LinuxSuRen
数据库 Web 客户端新增对 openGemini 的支持 (#665) @LinuxSuRen
数据库 Web 客户端新增对 Cassandra 的支持 (#656) @LinuxSuRen
数据库 Web 客户端新增对 IotDB 的支持 (#653) @LinuxSuRen
Elasticsearch Web 客户端支持翻页功能 (#663) @LinuxSuRen

🐛 缺陷修复

修复中英文语言切换失效的问题 (#720) @user-xixiboliya
修复暗黑主题不生效的问题 (#714) @LinuxSuRen
修复了非 JSON 响应的内容无法显示的问题 (#677) @KariHall619

致谢

本次版本发布，包含了以下 5 位 contributor 的努力：

关于 API Testing.

Mon, 01 Jan 0001 00:00:00 +0000

About API Testing

API Testing （atest）是一个接口调试和测试工具的开源项目。

请继续阅读以了解更多信息，或访问我们的文档开始使用！

Objectives

// TBD.

搜索结果

Mon, 01 Jan 0001 00:00:00 +0000

API Testing

本地安装

手动下载

通过工具下载

很荣幸与屈晗煜在 GitLink 编程夏令营（GLCC）活动中协作

Helm

SkyWalking

安全策略

发展规划

贡献指南

对于初学者

设置开发环境

打印各行代码：

pprof

目标

快速入门

执行部分测试用例

JSON Schema

关于安全

字段说明

用例模板

手机号

带权重的随机枚举

时间

环境变量

任务

等待接口响应码为 200

测试用例验证

数组长度判断

数组值检查

检查数组中是否有元素的字段包含特定值

检查数组中是否有元素的字段只包含特定值

End-to-End

Mock 服务

命令行

Web

Mock Docker Registry

语法

面向对象

代码生成

gRPC测试用例编写指南

创建测试项目

字段import和protofile

字段protoset

字段serverReflection

编写gRPC API测试

gRPC TLS verification

插件

下载插件

API 引用

v0.0.12

更新重点

相关数据

v0.0.13

主要的新功能

v0.0.14

主要的新功能

相关数据

v0.0.15

亮点

主要的新功能

致谢

v0.0.17

亮点

🚀 主要的新功能

🐛 缺陷修复

📝 文档

👻 维护

致谢

v0.0.18

亮点

v0.0.20

亮点

🐛 缺陷修复

致谢

关于 API Testing.

About API Testing

Objectives

搜索结果

字段`import`和`protofile`

字段`protoset`

字段`serverReflection`