开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载本文以eden/integration/README.md为骨架系统讲解 Sapling 项目中 EdenFS 集成测试框架的使用方法如何编写与 Saplingsl/hg命令对应的集成测试、如何控制初始仓库与挂载环境、如何调试、如何处理 FUSE io_uring 内核变体以及两类测试基类的对象命名差异与常见陷阱。读完本文你将能够独立在仓库中新增一个针对 Sapling 命令的 EdenFS 集成测试并理解其背后的测试复制replication机制与 FUSE 传输层验证原理。背景什么是 EdenFS 集成测试EdenFS 是 Sapling 仓库中负责提供虚拟文件系统挂载的核心组件见 eden/fs/docs/Overview.md它把底层源控制系统Sapling/Mercurial、Git 等的对象库映射为本地挂载点上的目录树让sl status、sl update等命令可以像操作普通目录一样工作。集成测试位于eden/integration/目录是 Python 编写的、真实拉起 EdenFS 守护进程并执行命令的端到端测试。其中通用 EdenFS 集成测试直接位于 eden/integration/ 下例如basic_test.py、clone_test.py、mount_test.py、rename_test.py等覆盖挂载、取消、重命名等底层行为Saplingsl与 EdenFS 的集成测试位于 eden/integration/hg/ 下例如status_test.py专门测试sl status在 EdenFS 挂载上的行为是否正确。注意sl是取代hg的新命令名README 开篇即注明 Note:slis the new command name to replacehg仓库中的测试类名、基类与辅助函数仍然大量沿用hg/EdenHgTestCase等历史命名阅读时不要被名称误导。编写一个新的集成测试第一步选择测试入口如果你要测试的是一个全新的 Sapling 命令组此前没有对应的测试文件需要新建一个基于EdenHgTestCase的测试类如果只是给已有命令补充用例则找到对应的测试文件与测试类直接在其中新增test_xxx方法即可。以status_test.py为例其类定义与装饰器如下见 eden/integration/hg/status_test.py#L48-L56hg_cached_status_test class StatusTest(EdenHgTestCase): enable_fault_injection: bool True def populate_backing_repo(self, repo: HgRepository) - None: repo.write_file(hello.txt, hola) repo.write_file(subdir/file.txt, contents) repo.commit(Initial commit.)hg_cached_status_test是一个测试复制replication装饰器同一个测试类会被框架复制出多个变体在不同挂载配置默认 FUSE、NFS、io_uring、filtered-hg 等下分别执行从而用一份测试代码覆盖多种运行环境。第二步初始化仓库populate_backing_repo测试框架会先创建真实的源控制仓库再通过eden clone把它挂载为 EdenFS 工作区。初始的目录/文件结构由populate_backing_repo()定义所有测试基类都要求子类实现它def populate_backing_repo(self, repo: hgrepo.HgRepository) - None: raise NotImplementedError( individual test classes must implement populate_backing_repo() )其中repo参数是对底层 Sapling/Hg 仓库HgRepository见 eden/integration/lib/hgrepo.py的封装常用的构建提交的方法包括repo.write_file(path, contents)写入文件repo.add_files(paths)/repo.add_staged_files()加入暂存区repo.commit(message)创建提交并返回节点哈希repo.update(rev, cleanFalse, mergeFalse)检出目标提交。说明README 中提到测试类需要实现populate_backing_repo()而EdenRepoTest基类对应的是populate_repo()——两者语义相同只是命名不同详见下文“测试框架的仓库对象”。第三步触发 Sapling 命令在测试中调用sl命令统一通过self.hg()辅助函数完成历史命名实际执行的是 Sapling 命令def hg( self, *args: str, encoding: str utf-8, input: Optional[str] None, hgeditor: Optional[str] None, cwd: Optional[str] None, check: bool True, ) - str:参数说明参数默认值作用*args必填sl命令及其子命令参数如status、add、updateencodingutf-8输出解码使用的字符集inputNone通过临时文件传给命令的标准输入内容hgeditorNone覆盖HGEDITOR环境变量用于需要编辑器的命令如提交信息cwdNone命令执行的工作目录缺省为仓库根目录checkTrue为真时命令非零退出会抛异常HgError从实现上看self.hg()内部走 eden/integration/lib/hgrepo.py#L187-L257 的run_hg()它剥离宿主机上所有HG*环境变量并设置HGPLAIN1用临时文件替代管道读写输入输出从而保证测试结果不受开发者本机 Mercurial 配置干扰命令失败时还会打印完整的崩溃报告cmd/stdout/stderr。第四步运行集成测试README 指引参见.claude/CLAUDE.md中 Verification 一节仓库内的构建与测试基于 Buck2运行全部集成测试的命令形如buck2 test fbcode//mode/opt fbcode//eden/integration/...针对单个测试可配合--regex过滤例如只跑 io_uring 相关变体buck2 test fbcode//mode/opt fbcode//eden/integration/... -- --regex IoUring注意该命令面向仓库内部 fbcode 构建布局在本仓库以开源形态CMake/make-client.py使用时的路径前缀会不同请以实际构建环境为准。FUSE io_uring 变体机制变体如何产生EdenRepoTest的复制逻辑定义在 eden/integration/lib/testcase.py#L959-L1047 的_replicate_eden_repo_test()中框架会按NFS开/关× SCM 类型Hg/Git/FilteredHg× 大小写敏感可选交叉组合生成变体并在 Linux 上为每个非 NFS 变体追加一个IoUring兄弟变体由IoUringTestMixin提供use_io_uring() True见 eden/integration/lib/testcase.py#L1110-L1112。具体规则与 README 一一对应仓库、Hg、filtered-Hg、cached-status 装饰器在 Linux 上自动添加 io_uring 兄弟变体NFS 变体不变纯eden_test类默认不生成 io_uring 变体需显式传run_io_uringTrue加入装饰器也接受run_io_uringFalse显式退出迁移migration测试只生成 transport-only 兄弟变体以保留其仓库设置保存快照校验与基于挂载的 fsck 用例同样同时覆盖两种传输而离线 fsck 与快照生成类命令不变化挂载型 io_uring 变体仅限 Linux平台无关的 harness 单元测试如testcase_test.py仍可在 macOS 与 Windows 上运行。内核要求与回退语义io_uring 变体要求fbk 6.13 或 6.16 内核其他内核直接跳过这些变体。内核门控实现在 eden/integration/lib/edenclient.py#L52-L57def require_io_uring_kernel() - None: release os.uname().release if sys.platform linux else # The FUSE io_uring ABI is kernel-specific; extend this allowlist # when another fbk release is validated. if fbk not in release or not release.startswith((6.13., 6.16.)): raise unittest.SkipTest(requires an fbk 6.13 or 6.16 FUSE io_uring kernel)io_uring 变体还会通过fuse_transport_config()eden/integration/lib/edenclient.py#L60-L66在edenfs.rc中写入fuse:use-io-uring true与fuse:io-uring-pre-create-queues true使队列分配失败时可以在 INIT 之前回退到 devfuse成功的 devfuse 回退该 io_uring 测试以SkipTest附回退原因跳过不计入 io_uring 覆盖启动错误、超时、意外的传输值仍然判定失败AssertionError基线 FUSE 变体会显式选择 devfuseuse-io-uring false一个挂载上的回退不能掩盖另一个挂载上的非法传输——传输校验按挂载逐个进行见 eden/integration/lib/edenclient.py#L69-L95 的assert_fuse_transport/assert_fuse_transports。断言运行中的 FUSE 传输clone、remount、restart、takeover 的成功路径都会验证正在运行的 FUSE 挂载自定义的异步生命周期路径应在挂载就绪后调用self.eden.assert_running_fuse_transports()其实现eden/integration/lib/edenclient.py#L843-L855通过 Thrift 调用listMounts()对每个状态为 RUNNING 且fsChannelType fuse的挂载比对实际fuseTransport与期望值io_uring或devfuse。已知限制与新增内核流程Takeover 套件与执行 takeover 的 GC 用例当前跳过 io_uringin-flight 请求交接可能停滞在两种受支持内核上验证通过前不要移除这些 skip。绑定重定向bind-redirection的 GC 仍在不带 takeover 的情况下运行。同一套测试需要在每个受支持内核上各跑一遍——在一个内核上的通过并不能验证另一个内核。为新内核添加 io_uring 支持时需要同步更新三处eden/integration/lib/edenclient.py 中的require_io_uring_kernel()内核白名单eden/integration/testcase_test.py 中的内核门控测试本文档中记录的支持版本列表。然后在该内核上执行上述--regex IoUring全量扫描确认合格的 io_uring 变体真正执行而不是被跳过。调试集成测试DBG 日志级别EdenFS 的 C 日志分类支持按模块设置 verbose 级别。要调高某个模块的日志在测试类中重写edenfs_logging_settings()def edenfs_logging_settings(self) - Dict[str, str]: return { eden.fs.inodes.TreeInode: DBG5, eden.fs.inodes.CheckoutAction: DBG5, eden.fs.inodes.CheckoutContext: DBG5, }这些设置会经--logging参数传给 edenfs 守护进程见 eden/integration/lib/testcase.py#L288-L300 的基类实现返回None表示不启用额外 verbose 日志。典型的可调分类包括eden.fs.inodes.TreeInode树节点、eden.fs.store对象存储等。测试环境还默认注入了EDENFS_INTEGRATION_TEST1与EDENFS_NO_TELEMETRY1环境变量以关闭遥测需要追踪sl自身时可取消注释SL_LOGtrace见 eden/integration/lib/testcase.py#L113-L117。测试框架的仓库对象模型核心概念backing repo 与 EdenFS mountbacking repo备份/底层仓库EdenFS 从中读取数据的、磁盘上的 Sapling/Hg或 Git仓库。EdenFS只读取它的对象存储完全忽略 backing repo 的工作副本工作区改动请通过挂载点读写。该概念在 eden/fs/docs/Glossary.md 中有正式定义backing repository 是本地、磁盘上的源控制仓库多个 checkout 可以共享同一个 backing repo。EdenFS mount挂载点eden clone创建的真实虚拟文件系统挂载是sl status、sl update等命令真正作用的对象。两类基类的命名对照两个测试基类对同一组概念采用了不同的命名务必对照使用概念EdenRepoTestEdenHgTestCase用途Backing repoself.repoself.backing_repo添加挂载将服务的提交EdenFS mountself.eden_repoself.repo执行sl update、sl status等命令挂载路径strself.mountself.mountos.listdir、open()、os.statEdenRepoTesteden/integration/lib/testcase.py#L639-L756覆盖 Hg 与 Git 两类仓库由eden_repo_test自动复制出MyTestHg、MyTestGit变体重写populate_repo()初始化 backing repo其self.repo是 backing repoself.eden_repo才是挂载对象。EdenHgTestCase面向纯 Sapling/Hg重写populate_backing_repo()其self.backing_repo是 backing repoself.repo是挂载对象。⚠️ 常见陷阱在错误的仓库上执行 update在EdenRepoTest子类中调用self.repo.hg(update, commit)会更新backing repo 的工作副本——而这正是 EdenFS 所忽略的。必须改用self.eden_repo.hg(update, commit)。Bookmark 行为eden clone检出的是 backing repo 的活跃 bookmark而不是工作副本的父提交。如果populate_repo设置了 bookmark挂载会从该 bookmark 开始为稳妥起见应显式调用self.eden_repo.hg(update, target_commit)。扩展阅读eden/integration/hg/status_test.pysl status在 EdenFS 挂载上的完整测试样例含populate_backing_repo初始化与各种状态断言eden/integration/lib/testcase.py基类、Mixin 与全部复制装饰器的实现eden/integration/lib/edenclient.pyEdenFS 客户端封装、内核门控与 FUSE 传输断言eden/integration/lib/hgrepo.pyHgRepository与sl/hg命令封装eden/fs/docs/Glossary.mdbacking repository、backing store、checkout 等术语的正式定义。赞分享开发工具CLI后端【免费下载链接】saplingA Scalable, User-Friendly Source Control System.项目地址https://gitcode.com/gh_mirrors/sa/sapling点击查看免费下载相关推荐Logstash 集成测试框架RATS完全指南从本地运行到编写新测试Logstash 集成测试框架RATS完全指南从本地运行到编写新测试 导读 Logstash 仓库中的 qa/integration 目录承载着一套名为数据工程后端Cargo 集成测试编写完全指南从 Functional Tests 到 UI Snapshot 测试Cargo 集成测试编写完全指南从 Functional Tests 到 UI Snapshot 测试 CargoThe Rust package mana开发工具包管理器CLI构建工具WordPress主题开发者必看Merlin WP集成教程与最佳实践WordPress主题开发者必看Merlin WP集成教程与最佳实践 Merlin WP是一款专为WordPress主题开发者打造的终极工具旨在解决繁琐的主上一篇OpenTX开源遥控器固件终极自定义遥控器系统完整指南下一篇Docker-Selenium CDP代理WebSocket通信启用与禁用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考