dummypackage-dummyname 1.3.0

生成和本地安装：

setup.py脚本将在source dist（sdist）和wheel表单中构建包。包将位于dist目录中，一些文件也将生成到build目录中。重要信息：请记住根据回购协议的需要调整设置函数调用中的变量（除了版本，正如我们所看到的，由bump2version处理）。

exportPATH=${PATH}:$HOME/.local/bin

请注意，原则上，如果已通过Travis自动部署，则无需手动构建包。

Github版本：

我们看到github会自动跟踪标签。但对于每个版本，我们希望在默认行为中添加两项内容：

1. 指定更改日志
2. PIP可安装包，格式为车轮。

这可以通过github网页中的浏览器手动执行，也可以通过cli执行，如github api中所述。

请注意，原则上，如果已通过Travis自动展开，则无需手动展开。

PYPI版本：

构建的包也可以发布到pypi，一个流行的python包的全局存储库。下面的命令上载dist目录中的所有内容。您需要提供pypi凭据（如果您没有凭据，请创建一个用户）：

exportPATH=${PATH}:$HOME/.local/bin

请注意，原则上，如果已通过Travis自动展开，则无需手动展开。

特拉维斯ci:

简介：

在cd/ci的上下文中，git存储库（或任何其他类似的对象，用于自动执行任务）被视为一个材料，其特定的触发操作集（例如git repo中的提交或拉取请求，或自定义rest系统中的某些api请求）。把材料看作类，把动作看作它们的方法，可能会有帮助。

对于这些操作中的每一个，都可以定义一个cd/ci管道，cd/ci系统将在某个事件触发时执行该管道。根据ci系统的不同，管道允许一些类似分支的复杂性，但最好保持尽可能简单。

虽然不同的材料有不同的作用，但其精神大体上是相似的，即所谓的词。引用：

"持续集成是每一个自尊的软件项目应该采用的各种技术和实践的保护伞：

• 构建自动化-对scm repo的每次提交/推送都会自动触发一个新的构建（主分支中的任何内容都是可部署的）
• 测试自动化-测试被评估为构建过程的一个组成部分（这是老新闻，对吧？）
• 供应链集成-主要是为了促进构建自动化，但也能够报告问题、版本、里程碑，…
• 项目管理集成-Basecamp、CampFire、AcuNote和其他PM工具（人员、任务、日程安排等）
• 项目仪表板-所有内容都是公开的（通常没有任何读取访问限制，使所有相关方都可以使用）

特拉维斯和这份回购协议：

• https://docs.travis ci.com
• https://docs.travis ci.com/user/languages/python/

travis是一个ci/cd工具，可以免费轻松地链接到github帐户，并通过repo根目录下的travis.yaml文件进行管理（更多信息请访问https://docs.travis-ci.com/user/languages/python/" rel="nofollow">https://docs.travis ci.com/user/languages/python/此存储库的目标是在每次提交给master之后触发travis，以执行以下任务：

1. 并行运行：

   1. 使用flake检查编码样式
   2. 检查同义反复是否为真
   3. 检查所有单元测试是否通过
   4. 检查代码覆盖率是否高于数字
   5. 检查运行给定的例程是否永远不会超过特定的内存使用量
   6. 检查运行给定的例程是否不超过一定的持续时间

2. 如果所有检查都成功，请将文档和dummypackage构建到我们所需的体系结构中。

3. 以可以通过pip+repo link安装的方式部署包

为此，travis实现了两个基本概念，stages和jobs：stage是允许并行运行的一组作业。但是，每个阶段都会一个接一个地运行，并且只有在前一阶段中的所有作业都已成功通过时才会继续。如果一个作业在一个阶段中失败，则同一阶段中的所有其他作业仍将完成，但随后阶段中的所有作业将被取消，并且生成将失败。

每个作业都可以映射到"脚本"，即对程序的调用。如果脚本返回非零状态，则部署将被视为失败，并且生成将被标记为"错误"。

默认情况下，travis会为每个作业从头开始一个新的虚拟机。在运行作业之前，必须安装所有必需的依赖项。这可能需要一段时间，因此以最小化开销的方式设计ci管道很有帮助。可以使用cache关键字在作业之间共享某些依赖项。此外，在执行某些任务之前进行的文件清理也可以跳过。

步骤：

1. 将github帐户与travis同步，并允许访问存储库等。最后，"激活"Travis中所需的回购协议。您应该会看到典型的[build failing]徽章。单击它并将降价链接复制到repo的mainreadme中，如此文件顶部所示。

2. 在GitHub的"激活的回购设置"中，选择要通知Travis的事件。在本例中，我们将激活提交和拉取请求。任何时候，Github都会向Travis发送一个包含所有相关信息的请求。

3. 现在双方都了解对方，请确保您理解.travis.yml文件并根据需要进行自定义。

4. 对于部署，travis需要您的用户凭据。因为用纯文本分发密码是不安全的，travis为您提供了加密密码的可能性。在这个项目中，我们需要pypi和github：

github发布配置：

travis可以配置为通过运行travis setup releases上传到github版本。如果您自己这样做，请小心，因为这将重新格式化travis.yml文件，删除所有注释和空行（尽管功能不会受到影响）。临时备份将有助于解决此问题。

在repo根目录中，运行travis setup releases并执行以下步骤：

1. 确认回购名称
2. 提供github凭据
3. 仅从部署…->；是
4. 加密API密钥->；是

方便的是，这个回购协议的travis.yml已经提供了释放到github的结构。无论如何，你必须用你自己的证件来代替这些证件。您可以在这里看到如何做到这一点：https://docs.travis ci.com/user/deployment/releases使用OAuth令牌进行身份验证

还请注意，可以使用关键字自定义版本，如名称、正文、草稿、预发布

https://docs staging.travis ci.com/user/deployment/releases/

PYPI发布配置：

与github版本一样，.travis.yml文件已经提供了部署到pypi的结构。你只需要用你自己的证件来代替。要加密密码，请使用以下命令（此处提供更多信息：https://docs.travis ci.com/user/encryption keys/）。同样，要小心，因为这样会重新格式化travis.yml文件，删除所有注释和空行（尽管功能不会受到影响）。临时备份将对此有所帮助：

# run all existing tests
python -m unittest discover -s utest -t . -p "*_test.py" -v
# Run individual test modules (from the repo root dir)
python -m unittest utest/foo_test.py -v
python -m unittest utest/bar_test.py -v
python -m unittest utest/nestedtests/nested_test.py -v
# Run individual classes
python -m unittest utest.foo_test.FooTestCaseCpu -v
python -m unittest utest.nestedtests.nested_test.QuackTestCaseCpu -v
# Run individual methods
python -m unittest utest.bar_test.BarTestCaseCpu.test_inheritance -v

# run all existing tests
python -m unittest discover -s utest -t . -p "*_test.py" -v
# Run individual test modules (from the repo root dir)
python -m unittest utest/foo_test.py -v
python -m unittest utest/bar_test.py -v
python -m unittest utest/nestedtests/nested_test.py -v
# Run individual classes
python -m unittest utest.foo_test.FooTestCaseCpu -v
python -m unittest utest.nestedtests.nested_test.QuackTestCaseCpu -v
# Run individual methods
python -m unittest utest.bar_test.BarTestCaseCpu.test_inheritance -v