Moon Downloader测试与工程实践50个无需浏览器和网络的测试如何守住提取边界【免费下载链接】moondownloaderBulk file downloader for datanodes.to and fuckingfast.co — real-Chrome extraction over CDP, pure-HTTP extraction with a Chrome TLS fingerprint, aiohttp streaming, WebView2 GUI and a headless CLI. Windows, Python 3.10, MIT.项目地址: https://gitcode.com/gh_mirrors/mo/moondownloaderMoon Downloader 是一款面向 datanodes.to 与 fuckingfast.co 的批量文件下载器真实 Chrome 走 CDP 提取链接、纯 HTTP 提取带 Chrome TLS 指纹、aiohttp 流式下载提供 WebView2 图形界面与无头 CLI。它的 tests/ 目录下有 54 个测试函数全部不启动浏览器、不访问网络就能守住什么情况下允许打开浏览器这条最关键的提取边界。本文带你读懂这套离线测试的工程思路普通用户也能照着在自己电脑上运行。为什么批量下载器需要无浏览器、无网络测试先理解项目结构再看测试为什么这样写。Moon Downloader 的核心模块moon_extract.py两个站点的链接提取逻辑datanodes.to 需要真实 Chrome 过 Turnstile 人机验证fuckingfast.co 走纯 HTTPmoon_download.py共享的 aiohttp 流式下载引擎moon_engine.pyGUI 背后的任务引擎moon_cli.py无头命令行入口。问题在于datanodes.to 的提取依赖活着的 Chrome 真实网络一旦测试真的启动浏览器测试就慢、就脆弱、还会被反爬系统针对。所以整套测试的策略是——在 moon_extract 这一层打桩stub把网络、提取、Chrome 全部换成假函数真正被测的只剩一件事调度器dispatcher要不要启动浏览器这个决策本身。测试清单54 个离线测试各守哪条边界tests/conftest.py 中的browser_calls夹具是全套测试的地基它用 monkeypatch 把_start_playwright、open_browser、close_browser、shutdown_chrome全部替换成计数器并替换moon_engine与moon_cli两个前端的extract_fuckingfast、extract_datanodes、download_file。注意这个细节——夹具必须在两个前端各打一份桩漏掉任何一个引擎就会拿着真函数去发真实网络请求这正是历史问题 #160 的教训代码注释里写得很直白。测试文件测试数守护的边界tests/test_no_chrome.py9只有 datanodes.to 链接才允许启动浏览器tests/test_disk_full.py13磁盘写满ENOSPC时的整轮中止与恢复tests/test_cli_exit_codes.py8CLI 退出码 0/1/2/3 的完整契约tests/test_proxy_pool.py5代理池加载、缺失文件、零可用代理的提示tests/test_cli_extractors_flag.py4--extractors主参数与旧--browsers别名迁移tests/test_elapsed_clock.py3耗时时钟完成后冻结、新任务重置tests/test_exit_cleanup.py2停止任务时先关浏览器、再中止下载tests/test_filename_collisions.py2不同链接同名文件落盘不互相覆盖tests/test_gui_extractor_scope.py3GUI 中 Extractors 与 Pages 的生效上限提示tests/test_on_event.py2续传返回 200、连接失败等事件的回调tests/test_resume_200.py1服务器把续传请求按 200 响应时的日志说明tests/test_docs_cli_flags.py1文档里写的 CLI 参数必须在代码中真实存在tests/test_snapshot_speed.py1快照里的速度是平均值而非瞬时峰值一个值得新手学习的点test_docs_cli_flags.py是文档与代码的一致性测试——它解析 docs/CLI.md 中列出的所有 CLI 参数逐个验证代码能识别。文档写错参数测试会直接红掉比人工校对可靠得多。提取边界只有 datanodes.to 能打开浏览器tests/test_no_chrome.py 是全套测试的心脏它的文件头注释就说明了测试对象被测的是调度器启动浏览器的决策不是提取器本身。几个关键场景纯 fuckingfast.co 批次跑完断言open_browser 0。桩函数fake_ff还会反向校验——调度器只能把浏览器获取函数getter交给它而不能提前塞一个活浏览器提前打开窗口意味着回退到了旧设计测试直接失败混合批次fuckingfast 与 datanodes 链接混在一起时断言恰好启动 1 个共享浏览器而不是每链接一个不支持的主机塞一条 youtube.com 链接断言它只失败一次、日志提示supported: datanodes.to, fuckingfast.co且不重试、不开浏览器源码级门控测试甚至直接读取 moon_engine.py 与 moon_cli.py 的源码文本断言所有浏览器启动都必须经过BrowserGate统一门控且共享下载引擎download_file、Telemetry、ProxyPool只定义在 moon_download.py 一处前端只能 import、不能各自实现。这种读源码文本断言结构的测试看似不优雅但它守护的是架构约束防止未来有人在某个前端里偷偷绕过门控、复制一份下载逻辑。用模拟故障测试真实故障磁盘满与退出清理test_disk_full.py 是全套中体量最大的文件659 行、13 个测试它模拟了磁盘写满这种最难复现的事故桩文件对象的write抛出OSError(errno.ENOSPC)验证下载函数返回disk_full、保留已写出的.tmp分片、并通过共享的RunFatalControl把需要的字节数广播给所有同目录任务验证其他并发任务收到共享信号后协作中止aborted_disk_full而不是继续白写验证引擎停止入队新任务、等待在途下载收尾且致命回退后不再入队重试一个精妙的区分TimeoutError虽然也继承自OSError但必须走普通重试路径而不是磁盘满分支——专门有测试守护这条边界。test_exit_cleanup.py 守护点 STOP 按钮的瞬间engine.stop(timeout1.5)返回前浏览器必须已经关闭、工作线程必须已经退出、耗时必须小于超时上限同时中止在途下载不计入失败数部分文件.tmp保留续传可用failed_links.txt不为被中止的链接创建记录。GUI 右上角那个 STOP 按钮docs/gui_speed.png 中的红色区域背后就是这两组测试在托底。如何一键运行这些测试环境要求与主程序一致Windows或任意平台跑测试、Python 3.10。获取代码git clone https://gitcode.com/gh_mirrors/mo/moondownloader安装依赖pip install -r requirements.txt直接运行pytest配置见 pytest.ini其中还专门压制了 aiohttp BasicAuth 的弃用告警并留了出处注释整套测试不启动 Chrome、不产生网络请求、不落真实下载文件输出全部进tmp_path临时目录本地跑一遍只要十几秒。项目用 ruff.toml 统一 lint提交前建议ruff check .过一遍。给新手的三条工程启示把桩打在系统边界上网络、浏览器、磁盘都是外部世界全部可替换。测试不关心提取算法对不对那由真实站点验收只关心调度决策对不对测试数要敢用源码结构约束门控唯一、共享引擎唯一用源码文本断言比人工 review 更持久事故编号写进 docstring如Regression coverage for run-level ENOSPC handling (#116)每个回归测试都能回溯到它当初守护的那次真实故障docs/ENGINEERING_NOTES.md 则记录了这些故障在生产环境的完整经过——从16 个标签页压垮共享 Chrome到四窗口并行反而被 Cloudflare 判为机房。更多上下文可延伸阅读docs/CLI.md退出码契约、docs/PROVIDERS.md两站点提取原理、docs/CONFIGURATION.md代理池与 Chrome profile 配置。测试是下载器的隐形保险——下次当你看到传输列表里Saved ✓的那一刻背后正是这 50 个离线测试在默默站岗 【免费下载链接】moondownloaderBulk file downloader for datanodes.to and fuckingfast.co — real-Chrome extraction over CDP, pure-HTTP extraction with a Chrome TLS fingerprint, aiohttp streaming, WebView2 GUI and a headless CLI. Windows, Python 3.10, MIT.项目地址: https://gitcode.com/gh_mirrors/mo/moondownloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考