submit50 开源项目教程

项目介绍

submit50 是一个命令行工具，用于向课程（例如 CS50）提交作业（例如问题集）。它基于 git，一个“分布式版本控制系统”，允许您保存文件的不同版本，而无需为每个版本提供唯一的文件名。通过 submit50，您可以多次提交作业（即多个版本）。当您运行 submit50 时，您的文件会被“推送”（即上传）到 GitHub 上的 CS50 组织（也名为“submit50”），这是一个流行的服务，开发者（如您）可以通过它共享代码。您的文件存储在一个“仓库”（本质上是一个文件夹）中，只有您和 CS50 的一些工作人员可以访问（以及您授予访问权限的任何人）。

项目快速启动

安装 submit50

1. 安装 Python 3.6 或更高版本（如果尚未安装）。
2. 安装 pip（如果尚未安装）。
3. 安装 submit50 本身：

   pip3 install submit50
   

   注意： 如果在 Windows 上，请首先安装 Windows Subsystem for Linux (WSL)。我们建议选择 Ubuntu 发行版。然后在 WSL 中按照上述步骤安装 submit50。

升级 submit50

pip3 install --upgrade submit50

使用 submit50

submit50 [slug]

其中 [slug] 是您要提交的工作的预定义标识符。

应用案例和最佳实践

通过 SSH 提交

默认情况下，submit50 通过 HTTPS 将您的工作推送到 GitHub，这需要您的 GitHub 用户名和密码，这就是为什么 submit50 会提示您输入这两项信息，至少每周一次。如果您不想提供 submit50 您的 GitHub 用户名和密码，可以通过 SSH 推送您的工作。配置您的 CS50 IDE 工作区（或您自己的计算机）如下：

1. 生成 SSH 密钥并将其添加到 ssh-agent。
2. 将 SSH 密钥添加到您的 GitHub 帐户。
3. 执行以下命令以将 ssh.github.com 添加到已知主机列表中：

   ssh -T -p443 [e-mail]
   

   如果提示您是否确定要继续连接，请回答“是”。

最佳实践

• 确保您的工作目录中包含所有必需的文件，否则 submit50 将退出而不提交任何内容。
• 使用 .gitignore 文件来避免提交 submit50 会忽略的文件。

典型生态项目

• check50: 用于自动检查代码的正确性。
• style50: 用于检查代码风格是否符合标准。
• render50: 用于渲染文档。
• cli50: 用于创建和管理 CS50 的命令行工具。

这些工具与 submit50 一起构成了 CS50 生态系统，帮助学生和开发者更高效地完成作业和项目。