submit50 开源项目教程
项目地址:https://gitcode.com/gh_mirrors/su/submit50
项目介绍
submit50 是一个命令行工具,用于向课程(例如 CS50)提交作业(例如问题集)。它基于 git,一个“分布式版本控制系统”,允许您保存文件的不同版本,而无需为每个版本提供唯一的文件名。通过 submit50,您可以多次提交作业(即多个版本)。当您运行 submit50 时,您的文件会被“推送”(即上传)到 GitHub 上的 CS50 组织(也名为“submit50”),这是一个流行的服务,开发者(如您)可以通过它共享代码。您的文件存储在一个“仓库”(本质上是一个文件夹)中,只有您和 CS50 的一些工作人员可以访问(以及您授予访问权限的任何人)。
项目快速启动
安装 submit50
- 安装 Python 3.6 或更高版本(如果尚未安装)。
- 安装 pip(如果尚未安装)。
- 安装 submit50 本身:
注意: 如果在 Windows 上,请首先安装 Windows Subsystem for Linux (WSL)。我们建议选择 Ubuntu 发行版。然后在 WSL 中按照上述步骤安装 submit50。pip3 install submit50
升级 submit50
pip3 install --upgrade submit50
使用 submit50
submit50 [slug]
其中 [slug]
是您要提交的工作的预定义标识符。
应用案例和最佳实践
通过 SSH 提交
默认情况下,submit50 通过 HTTPS 将您的工作推送到 GitHub,这需要您的 GitHub 用户名和密码,这就是为什么 submit50 会提示您输入这两项信息,至少每周一次。如果您不想提供 submit50 您的 GitHub 用户名和密码,可以通过 SSH 推送您的工作。配置您的 CS50 IDE 工作区(或您自己的计算机)如下:
- 生成 SSH 密钥并将其添加到 ssh-agent。
- 将 SSH 密钥添加到您的 GitHub 帐户。
- 执行以下命令以将 ssh.github.com 添加到已知主机列表中:
如果提示您是否确定要继续连接,请回答“是”。ssh -T -p443 git@ssh.github.com
最佳实践
- 确保您的工作目录中包含所有必需的文件,否则 submit50 将退出而不提交任何内容。
- 使用
.gitignore
文件来避免提交 submit50 会忽略的文件。
典型生态项目
- check50: 用于自动检查代码的正确性。
- style50: 用于检查代码风格是否符合标准。
- render50: 用于渲染文档。
- cli50: 用于创建和管理 CS50 的命令行工具。
这些工具与 submit50 一起构成了 CS50 生态系统,帮助学生和开发者更高效地完成作业和项目。