{"id":19068563,"url":"https://github.com/lydanne/generate-test-case","last_synced_at":"2025-04-28T13:24:50.969Z","repository":{"id":57246207,"uuid":"351955300","full_name":"Lydanne/generate-test-case","owner":"Lydanne","description":"一个OJ的测试用例生成器","archived":false,"fork":false,"pushed_at":"2021-04-09T08:42:48.000Z","size":168,"stargazers_count":9,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-11T11:05:47.922Z","etag":null,"topics":["oj","tools"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Lydanne.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-03-27T01:35:13.000Z","updated_at":"2024-03-19T07:27:07.000Z","dependencies_parsed_at":"2022-08-24T16:31:41.123Z","dependency_job_id":null,"html_url":"https://github.com/Lydanne/generate-test-case","commit_stats":null,"previous_names":["lydanne/generate-test-case","wumacoder/generate-test-case"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lydanne%2Fgenerate-test-case","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lydanne%2Fgenerate-test-case/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lydanne%2Fgenerate-test-case/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Lydanne%2Fgenerate-test-case/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Lydanne","download_url":"https://codeload.github.com/Lydanne/generate-test-case/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223772077,"owners_count":17199978,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["oj","tools"],"created_at":"2024-11-09T01:09:58.833Z","updated_at":"2024-11-09T01:09:59.548Z","avatar_url":"https://github.com/Lydanne.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\n Copyright (c) 2021 WumaCoder\n\n This software is released under the MIT License.\n https://opensource.org/licenses/MIT\n--\u003e\n\n# generate-test-case\n\n一个为 OJ 生成测试用例的 CLI 工具\n\n## 环境\n\n```text\nnode: 14.x\n```\n\n## 安装\n\n```bash\nnpm install -g generate-test-case\ngtc -h\n```\n\n## 指南\n\ngtc 通过'输入模版'(`template`)和'代码源文件'(`source.js`)，来生成输入输出的测试用例。\n他内部的实现原理就是通过 `template` 生成输入测试用例，然后使用输入测试用例执行`source.js`文件，最后生成输出测试用例。（如果你是 C 语言这样的编译性质的语言可以配置 `config.js` 文件实现编译运行）\ntemplate 是一个由普通字符串和`模版代码`构成的文本文件。\nsource.js 是标准的 OJ 程序。\n\n接下来试的用一下\n\n我们先创建一个文件夹比如`1000`,然后按照题的描述`describe.md`创建文件`template`与`source.js`,如果你想控制某些参数可以通过`config.js`文件 (如果只是生成 node 程序的测试用例，可以不创建)\n目前我们的目录是这样的 (\u003chttps://github.com/WumaCoder/generate-test-case/tree/master/tests/.example\u003e)：\n\n- 1000/\n  - template\n  - source.js\n  - config.js\n  - lib/\n    - stdin.js\n  - describe.md\n\n**describe.md**\n\n```md\n## 速算机器人\n\n### 题目描述\n\n小扣在秋日市集发现了一款速算机器人。店家对机器人说出两个数字（记作 x 和 y），请小扣说出计算指令：\n\n\"A\" 运算：使 x = 2 _ x + y；\n\"B\" 运算：使 y = 2 _ y + x。\n在本次游戏中，店家说出的数字为 x = 1 和 y = 0，小扣说出的计算指令记作仅由大写字母 A、B 组成的字符串 s，字符串中字符的顺序表示计算顺序，请返回最终 x 与 y 的和为多少。\n\n**示例:**\n\n输入：s = \"AB\"\n\n输出：4\n\n解释：\n经过一次 A 运算后，x = 2, y = 0。\n再经过一次 B 运算，x = 2, y = 2。\n最终 x 与 y 之和为 4。\n\n### 样例输入\n\n\"AB\"\n\n### 样例输出\n\n4\n```\n\n**template**\n\n\u003e 在花阔号内的是一段可执行的 JS 脚本，在这里可以执行 JS 的语句和方法，GTC 提供了一些常用的生成方法可以调用，具体请查看 Generate API\n\n```text\n{ \"AB\".repeat($i+1) }\n```\n\n**source.js**\n\n```js\n/**\n * @param {string} s\n * @return {number}\n */\nvar calculate = function (s) {\n  return 1 \u003c\u003c s.length;\n};\n\nasync function main() {\n  const input = await getLine();\n  const output = calculate(input);\n  console.log(output);\n  close();\n}\n\nmain();\n```\n\n**lib/stdin.js**\n\n```js\nconst readline = require(\"readline\");\n\nconst rl = readline.createInterface({\n  input: process.stdin,\n  output: process.stdout,\n});\n\nconst buffer = [];\nvar getLineCount = 0;\n\nrl.on(\"line\", function lineEvent(v) {\n  buffer.push(v);\n});\n\nrl.on(\"close\", function closeEvent() {\n  setImmediate(function closeProcess() {\n    if (buffer.length === 0 || getLineCount === 0) {\n      process.exit(0);\n    } else {\n      setImmediate(closeProcess);\n    }\n  });\n});\n\nfunction getLine() {\n  getLineCount++;\n  return new Promise((resolve) =\u003e {\n    setImmediate(function run() {\n      if (buffer.length !== 0) {\n        resolve(buffer.shift());\n        getLineCount--;\n      } else {\n        setImmediate(run);\n      }\n    });\n  });\n}\n\nfunction close() {\n  rl.close();\n}\n\nmodule.exports = { getLine, close };\n```\n\n**config.js**\n\n```js\nmodule.exports = {\n  root: \".\", // 当前目录\n  exec: \"node\", // 执行的命令\n\n  execFilePath: \"./source.js\", // 执行的文件\n  injectLibs: [\"./lib/stdin.js\"], // 执行之前要注入的文件\n\n  stdinTemplatePath: \"./template\", // 输入模版位置\n\n  outDir: \"./data\", // 测试实例输出位置\n  count: 10, // 生成数量\n};\n```\n\n然后在当前目录下执行 `gtc`, 后查看 `./data` 下的文件\n到这里你已经会基本操作，更多详细内容请查看 `Config API` 和 `Generate API`\n\n## Cli Options\n\n\u003e Cli 基本与下面的配置文件一致\n\u003e 这里只需要说一下三个特殊的选项\n\n```bash\ngtc -c \"./config.js\" -sdc\n# -c ,--config 表示的是配置文件的位置，默认是 \"./config.json\"\n# -sdc ,--setDefaultConfig 表示是否将当前的配置替换为默认配置\n\ngtc -i\n# -i ,--init 创建默认配置文件\n```\n\n## Config API\n\n```ts\ninterface Config {\n  root: string; // 根目录 default:\".\"\n  compile: string; // 编译命令，不包含文件路径\n  exec: string; // 执行命令，不包含文件路径\n\n  compileFilePath: string; // 要编译的源文件，他会拼接到compile后面\n  execFilePath: string; // 要执行的文件，他会拼接到exec后面 default: \u003ccompileFilePath\u003e\n  source: string; // 源码 他和compileFilePath只能写一个\n  injectLibs: string[]; // 执行之前注入的文件，比如上面的 getLine\n\n  stdinTemplatePath: string; // 输入数据的模版文件的位置 default: template\n  stdinTemplate: string; // 输入文件模版\n\n  outDir: string; // 测试用例输出位置\n  count: number; // 生成数量 default: 10\n}\n```\n\n## Generate API\n\n### independent variable\n\n| 变量名 | 类型   | 功能                         |\n| ------ | ------ | ---------------------------- |\n| $i     | number | 每执行完一个输入用例就会加 1 |\n\n### string\n\n| 方法名                                 | 参数说明                                                                                                                                         | 功能           |\n| -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |\n| _randomChar_(strList = []):string      | @param {_string[]_} _strList_ _待选字符数组，如果不传入表示随机生产一个字母_                                                                     | _随机生成字符_ |\n| _randomStr_(len, strList = []):string  | @param {_number_} _len_ _随机生成长度为 len 的字符串_\u003cbr /\u003e@param {_string[]_} _strList_ _待选字符数组，如果不传入表示随机生产一个字母_          | 随机生成字符串 |\n| _randomWord_(n, strList = []): string | @param {_number_} _n_ _生成由 n 个单词组成的字符串，没有.号。_\u003cbr /\u003e@param {_string[]_} _strList_ _待选字符数组，如果不传入表示随机生产一个字母_ | 随机生成多个字 |\n\n### array\n\n| 方法名                                      | 参数说明                                                     | 功能                                |\n| ------------------------------------------- | ------------------------------------------------------------ | ----------------------------------- |\n| _randomNumArr_(start, end, Len):number[]    | @param {_number_} _start_ _开始数_\u003cbr /\u003e@param {_number_} _end_ _结束的数_\u003cbr /\u003e@param {_number_} _len_ _数组个数_ | _生成 `[start,end)` 个随机数的数组_ |\n| _randomStrArr_(strLen, len):string[]        | @param {_number_} _strLen_ _字符串长度_\u003cbr /\u003e@param {_number_} _len_ _数组个数_\u003cbr /\u003e@param {_string_} _separator_ _分割符_ | _生成长度为 strLen 的字符串数组_    |\n| *incrNumArr*(start, len, step = 1):number[] | @param {*number*} *start* *初始值*\u003cbr /\u003e@param {*number*} *len* *长度*\u003cbr /\u003e@param {*number*} *step* *步长* | *生成一个顺序数列*                  |\n\n### number\n\n| 方法名                      | 参数说明                                               | 功能                                 |\n| --------------------------- | ------------------------------------------------------ | ------------------------------------ |\n| _random_(start, end):number | @param {_number_} _start_\u003cbr /\u003e@param {_number_} _end_ | _生成 `[start, end)` 区间内的随机数_ |\n\n### tree\n\n\u003e 返回的与leetcode的二叉树字符串一样，都是层序遍历的字符串\n\n| 方法名                                                       | 参数说明                                                     | 功能                   |\n| ------------------------------------------------------------ | ------------------------------------------------------------ | ---------------------- |\n| *randomBinaryTree*(start = 0, end = 100, len = 100, vacancy = 5): string | @param {*number*} *start* *开始值*\u003cbr /\u003e@param {*number*} *end* *结束值*\u003cbr /\u003e@param {*number*} *len* *数组长度*\u003cbr /\u003e@param {*number*} *vacancy* *空节点概率 0 是100% 1是50% 2是33%* | *生成一个随机的二叉树* |\n| *symmetryBinaryTree*(base = 0, dep = 10): string             | @param {*number*} *base* *基础值*\u003cbr /\u003e@param {*number*} *dep* *深度* | *成对称二叉树*         |\n| *randomBST*(start, end, len):TreeNode                        | @param {*number*} *start* *开始值*\u003cbr /\u003e@param {*number*} *end* *结束值*\u003cbr /\u003e@param {*number*} *len* *长度* | 生成随机的二叉搜索树   |\n\n### base\n\n| 方法名                | 参数说明                                                     | 功能                                 |\n| --------------------- | ------------------------------------------------------------ | ------------------------------------ |\n| _repeat_(cb, n):array | @param {_(i:number)=\u003eany_} _cb_ _回调_\u003cbr /\u003e@param {_number_} _n_ _执行次数_ | _执行 n 次 cb，并且将结果返回成数组_ |\n\n## About\n\n如果这个工具对你有用，请不要吝啬你的 Star，如果有问题可以提交 Issue，如果你想添加更多的 Generate API 请提交 PR，并且同步 API 文档\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flydanne%2Fgenerate-test-case","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flydanne%2Fgenerate-test-case","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flydanne%2Fgenerate-test-case/lists"}