10分钟读懂RealWorld一套API测试集验收你的Medium克隆版【免费下载链接】realworldThe mother of all demo apps — Exemplary fullstack Medium.com clone powered by React, Angular, Node, Django, and many more项目地址: https://gitcode.com/GitHub_Trending/re/realworldRealWorld是Medium.com克隆版背后的规格与验收测试中心负责统一所有实现共用的API契约。读完后你能做到对自己的后端跑一遍官方API测试套件、在本地启动文档站点、用共享E2E套件验收前端实现。项目定位它是什么能干什么这个仓库不是一个可运行的应用而是RealWorld家族的评分规则主要帮你干三件事验收你的后端基于OpenAPI契约specs/api/openapi.yml配套Hurl测试集覆盖文章、评论、收藏、信息流、分页和错误码全部通过即代表你的API合规。验收你的前端specs/e2e/下的共享Playwright测试套件加选择器约定SELECTORS.md直接拷进你的工程就能用。本地化官方文档docs/目录是Astro/Starlight搭建的文档站源码所有规范文档都能本地预览和修改。技术栈一句话后端用Hurl和Bruno做接口验证前端用Playwright做端到端验证文档用Astro。核心目录specs/ ├── api/ # API契约与测试集 │ ├── openapi.yml # OpenAPI契约唯一事实来源 │ ├── hurl/ # Hurl用例验收基准 │ └── bruno/ # 由Hurl生成的Bruno集合 └── e2e/ # Playwright E2E测试与选择器约定 docs/ # Astro文档站源码 Makefile # 统一命令入口跑make help查看快速上手三步跑通全流程前置条件本仓库统一用bun做包管理先装好再动手。第1步克隆仓库git clone https://gitcode.com/GitHub_Trending/re/realworld cd realworld完成后在目录里执行ls应能看到specs、docs、Makefile、CONTRIBUTING.md这几项。第2步启动文档站make documentation-setup make documentation-dev完成后浏览器里会打开一个本地Starlight站点能浏览后端与前端的全部规范文档。第3步对着自己的后端跑API测试cd specs/api HOSThttp://localhost:3000/api ./run-api-tests-hurl.sh完成后articles、auth、comments等用例应批量通过说明你的API通过了RealWorld验收。跑起来之后先玩什么先试API测试用Bruno应用打开Bruno集合按articles、auth、favorites分组逐个查看请求与断言比看YAML直观得多。再读契约翻一遍specs/api/openapi.yml确认响应格式与错误码文本文档与测试集并存时以测试集为准。️然后接入你的工程把specs/e2e/下的Playwright套件拷走继承specs/e2e/playwright.base.ts重写baseURL与webServer就拿到一套现成的前端回归测试。常见卡点速查Bruno集合与Hurl用例不一致—— 不要手改specs/api/bruno/目录用make bruno-check诊断、make bruno-generate重新生成。API测试脚本整体报错—— HOST必须指向带/api后缀的已启动服务例如HOSThttp://localhost:3000/api说明见specs/api/README.md。文档站安装失败—— Makefile内部用的是bun而非npm先装bun再执行make documentation-setup。接下来看什么OpenAPI API契约specs/api/openapi.ymlHurl API测试集事实来源specs/api/hurl/Bruno交互式测试集合specs/api/bruno/Playwright E2E前端测试集specs/e2e/贡献指南CONTRIBUTING.md契约和测试集都拿在手里了去写你自己的RealWorld实现吧。【免费下载链接】realworldThe mother of all demo apps — Exemplary fullstack Medium.com clone powered by React, Angular, Node, Django, and many more项目地址: https://gitcode.com/GitHub_Trending/re/realworld创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 10分钟读懂RealWorld：一套API测试集验收你的Medium克隆版
10分钟读懂RealWorld一套API测试集验收你的Medium克隆版【免费下载链接】realworldThe mother of all demo apps — Exemplary fullstack Medium.com clone powered by React, Angular, Node, Django, and many more项目地址: https://gitcode.com/GitHub_Trending/re/realworldRealWorld是Medium.com克隆版背后的规格与验收测试中心负责统一所有实现共用的API契约。读完后你能做到对自己的后端跑一遍官方API测试套件、在本地启动文档站点、用共享E2E套件验收前端实现。项目定位它是什么能干什么这个仓库不是一个可运行的应用而是RealWorld家族的评分规则主要帮你干三件事验收你的后端基于OpenAPI契约specs/api/openapi.yml配套Hurl测试集覆盖文章、评论、收藏、信息流、分页和错误码全部通过即代表你的API合规。验收你的前端specs/e2e/下的共享Playwright测试套件加选择器约定SELECTORS.md直接拷进你的工程就能用。本地化官方文档docs/目录是Astro/Starlight搭建的文档站源码所有规范文档都能本地预览和修改。技术栈一句话后端用Hurl和Bruno做接口验证前端用Playwright做端到端验证文档用Astro。核心目录specs/ ├── api/ # API契约与测试集 │ ├── openapi.yml # OpenAPI契约唯一事实来源 │ ├── hurl/ # Hurl用例验收基准 │ └── bruno/ # 由Hurl生成的Bruno集合 └── e2e/ # Playwright E2E测试与选择器约定 docs/ # Astro文档站源码 Makefile # 统一命令入口跑make help查看快速上手三步跑通全流程前置条件本仓库统一用bun做包管理先装好再动手。第1步克隆仓库git clone https://gitcode.com/GitHub_Trending/re/realworld cd realworld完成后在目录里执行ls应能看到specs、docs、Makefile、CONTRIBUTING.md这几项。第2步启动文档站make documentation-setup make documentation-dev完成后浏览器里会打开一个本地Starlight站点能浏览后端与前端的全部规范文档。第3步对着自己的后端跑API测试cd specs/api HOSThttp://localhost:3000/api ./run-api-tests-hurl.sh完成后articles、auth、comments等用例应批量通过说明你的API通过了RealWorld验收。跑起来之后先玩什么先试API测试用Bruno应用打开Bruno集合按articles、auth、favorites分组逐个查看请求与断言比看YAML直观得多。再读契约翻一遍specs/api/openapi.yml确认响应格式与错误码文本文档与测试集并存时以测试集为准。️然后接入你的工程把specs/e2e/下的Playwright套件拷走继承specs/e2e/playwright.base.ts重写baseURL与webServer就拿到一套现成的前端回归测试。常见卡点速查Bruno集合与Hurl用例不一致—— 不要手改specs/api/bruno/目录用make bruno-check诊断、make bruno-generate重新生成。API测试脚本整体报错—— HOST必须指向带/api后缀的已启动服务例如HOSThttp://localhost:3000/api说明见specs/api/README.md。文档站安装失败—— Makefile内部用的是bun而非npm先装bun再执行make documentation-setup。接下来看什么OpenAPI API契约specs/api/openapi.ymlHurl API测试集事实来源specs/api/hurl/Bruno交互式测试集合specs/api/bruno/Playwright E2E前端测试集specs/e2e/贡献指南CONTRIBUTING.md契约和测试集都拿在手里了去写你自己的RealWorld实现吧。【免费下载链接】realworldThe mother of all demo apps — Exemplary fullstack Medium.com clone powered by React, Angular, Node, Django, and many more项目地址: https://gitcode.com/GitHub_Trending/re/realworld创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考