# ScriptMark: 自动评分工具
[](https://pypi.org/project/您的包名/)
[](https://pypi.org/project/您的包名/)
[](./LICENSE)
[](https://github.com/您的GitHub用户名/您的仓库名/actions)
一个可扩展的、用于自动评分学生编程作业的 CLI 工具。
此工具的最初实现是作为 `pytest` 的执行框架，用于自动运行和评估学生提交的 Python 作业。
---
## 核心功能
* **CLI 驱动**: 通过 `typer` 提供清晰、易用的命令行界面。
* **基于 Pytest**: 利用 `pytest` 强大的断言、插件和报告生态系统进行评分。
* **超时控制**: 使用 `pytest-timeout` 严格限制学生代码的执行时间，防止无限循环。
* **精美输出**: 使用 `rich` 在终端中提供格式精美的评分报告。
* **可扩展性**: 旨在未来支持 C++/Java 等其他语言的评分后端（*此功能仍在规划中*）。
* **严格开源**: 采用 **GPLv3** 许可证，确保项目及其衍生品保持开源。
## 安装
您可以通过 `pip` 或 `uv` 从 PyPI 安装 `grader`：
```bash
# 使用 uv (推荐)
uv pip install [您在PyPI上的包名]
# 或使用 pip
pip install [您在PyPI上的包名]
grader --help
```
Raw data
{
"_id": null,
"home_page": null,
"name": "scriptmark",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "grader, pytest, education, autograding",
"author": "Acture",
"author_email": "Acture <acturea@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/dc/e3/858adf654dd58361e36533da659cc1a9682dce7370a40829cd4f37cfb384/scriptmark-0.1.0.tar.gz",
"platform": null,
"description": "# ScriptMark: \u81ea\u52a8\u8bc4\u5206\u5de5\u5177\n\n[](https://pypi.org/project/\u60a8\u7684\u5305\u540d/)\n[](https://pypi.org/project/\u60a8\u7684\u5305\u540d/)\n[](./LICENSE)\n[](https://github.com/\u60a8\u7684GitHub\u7528\u6237\u540d/\u60a8\u7684\u4ed3\u5e93\u540d/actions)\n\n\u4e00\u4e2a\u53ef\u6269\u5c55\u7684\u3001\u7528\u4e8e\u81ea\u52a8\u8bc4\u5206\u5b66\u751f\u7f16\u7a0b\u4f5c\u4e1a\u7684 CLI \u5de5\u5177\u3002\n\n\u6b64\u5de5\u5177\u7684\u6700\u521d\u5b9e\u73b0\u662f\u4f5c\u4e3a `pytest` \u7684\u6267\u884c\u6846\u67b6\uff0c\u7528\u4e8e\u81ea\u52a8\u8fd0\u884c\u548c\u8bc4\u4f30\u5b66\u751f\u63d0\u4ea4\u7684 Python \u4f5c\u4e1a\u3002\n\n---\n\n## \u6838\u5fc3\u529f\u80fd\n\n* **CLI \u9a71\u52a8**: \u901a\u8fc7 `typer` \u63d0\u4f9b\u6e05\u6670\u3001\u6613\u7528\u7684\u547d\u4ee4\u884c\u754c\u9762\u3002\n* **\u57fa\u4e8e Pytest**: \u5229\u7528 `pytest` \u5f3a\u5927\u7684\u65ad\u8a00\u3001\u63d2\u4ef6\u548c\u62a5\u544a\u751f\u6001\u7cfb\u7edf\u8fdb\u884c\u8bc4\u5206\u3002\n* **\u8d85\u65f6\u63a7\u5236**: \u4f7f\u7528 `pytest-timeout` \u4e25\u683c\u9650\u5236\u5b66\u751f\u4ee3\u7801\u7684\u6267\u884c\u65f6\u95f4\uff0c\u9632\u6b62\u65e0\u9650\u5faa\u73af\u3002\n* **\u7cbe\u7f8e\u8f93\u51fa**: \u4f7f\u7528 `rich` \u5728\u7ec8\u7aef\u4e2d\u63d0\u4f9b\u683c\u5f0f\u7cbe\u7f8e\u7684\u8bc4\u5206\u62a5\u544a\u3002\n* **\u53ef\u6269\u5c55\u6027**: \u65e8\u5728\u672a\u6765\u652f\u6301 C++/Java \u7b49\u5176\u4ed6\u8bed\u8a00\u7684\u8bc4\u5206\u540e\u7aef\uff08*\u6b64\u529f\u80fd\u4ecd\u5728\u89c4\u5212\u4e2d*\uff09\u3002\n* **\u4e25\u683c\u5f00\u6e90**: \u91c7\u7528 **GPLv3** \u8bb8\u53ef\u8bc1\uff0c\u786e\u4fdd\u9879\u76ee\u53ca\u5176\u884d\u751f\u54c1\u4fdd\u6301\u5f00\u6e90\u3002\n\n## \u5b89\u88c5\n\n\u60a8\u53ef\u4ee5\u901a\u8fc7 `pip` \u6216 `uv` \u4ece PyPI \u5b89\u88c5 `grader`\uff1a\n\n```bash\n# \u4f7f\u7528 uv (\u63a8\u8350)\nuv pip install [\u60a8\u5728PyPI\u4e0a\u7684\u5305\u540d]\n\n# \u6216\u4f7f\u7528 pip\npip install [\u60a8\u5728PyPI\u4e0a\u7684\u5305\u540d]\n\ngrader --help\n\n```\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later",
"summary": "\u4e00\u4e2a\u53ef\u6269\u5c55\u7684\u3001\u7528\u4e8e\u81ea\u52a8\u8bc4\u5206\u5b66\u751f\u7f16\u7a0b\u4f5c\u4e1a\u7684CLI\u5de5\u5177\u3002\u76ee\u524d\u4ec5\u5b9e\u73b0\u4e86\u57fa\u4e8epytest\u7684",
"version": "0.1.0",
"project_urls": null,
"split_keywords": [
"grader",
" pytest",
" education",
" autograding"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "123830ee829d766acb282e6d5a043a37ccdf9b4ded6fda2b0408b96dd9de03eb",
"md5": "cb03269abc92eda7ddbfb7fb049a1485",
"sha256": "1547e8bd116d0aae41cef28289cfc5c7a2298b8c429f3a65b07c3b768417203c"
},
"downloads": -1,
"filename": "scriptmark-0.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cb03269abc92eda7ddbfb7fb049a1485",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 10398,
"upload_time": "2025-10-23T03:26:21",
"upload_time_iso_8601": "2025-10-23T03:26:21.650039Z",
"url": "https://files.pythonhosted.org/packages/12/38/30ee829d766acb282e6d5a043a37ccdf9b4ded6fda2b0408b96dd9de03eb/scriptmark-0.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "dce3858adf654dd58361e36533da659cc1a9682dce7370a40829cd4f37cfb384",
"md5": "65612c0be0640bbb4149339308b0591f",
"sha256": "0c498cd2645acbfde4cf37e9726a7321addf89015d7bfd6ac2e0e0f7a4f6e091"
},
"downloads": -1,
"filename": "scriptmark-0.1.0.tar.gz",
"has_sig": false,
"md5_digest": "65612c0be0640bbb4149339308b0591f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 8674,
"upload_time": "2025-10-23T03:26:23",
"upload_time_iso_8601": "2025-10-23T03:26:23.287665Z",
"url": "https://files.pythonhosted.org/packages/dc/e3/858adf654dd58361e36533da659cc1a9682dce7370a40829cd4f37cfb384/scriptmark-0.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-23 03:26:23",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "scriptmark"
}
JSON