lbutils – 天地一沙鸥 https://haoluobo.com to be continue.... Thu, 10 Mar 2016 15:46:37 +0000 zh-Hans hourly 1 https://wordpress.org/?v=6.8.2 django-lbutils https://haoluobo.com/2016/03/django-lbutils/ Thu, 10 Mar 2016 15:46:37 +0000 /?p=11263 在Github上公开了不少项目，不过其中大多都算不上“开源”。在我看来开源也应当是一件认真的事情，需要对项目持续的维护，同时也需要提供必要测试用例及文档以保证项目的质量。
最近打算将自用的Django工具组件做个简单的整理然后发布了。为了让项目不要太“随意”，开始补测试用例及文档。因为是自用，测试用例和文档几乎为零。最初只是想简单的修葺，不想真正做起来工作比预期的要高出很多。整了许久代码中的注释依旧很不全，测试的覆盖率都还未达到80%，文档更是没开始动。因为文档还没弄完，所以项目也不算正式发布，如果你感兴趣可以先去看看django-lbutils。
为了这个项目，尝试了一些之前经常看到却一直没怎么使用过的工具。

Tox

Tox是一个Python的自动打包测试用具，用来测试Python库在不同环境下的兼容性。因为是自用，本机环境跑起来是没啥问题。不过在兼容性测试时部分测试用例在Python3以及Django的某些版本下跑起来会有问题。为了搞定兼容性花费了不少时间。

Travis CI

Travis CI是一个在线的持续构建平台。Travis CI会检查你在Github上项目的变化，每当有新push的时候进行自动编译。我现在是每次改动后，直接在Travis CI看测试用例的执行情况。

Coveralls

Coveralls测试覆盖率查看工具。结合Travis CI，可在每次测试完成后将测试覆盖率信息推送到Coveralls。在Coveralls可方便查看当前的测试覆盖率。

Read the Docs

Read the Docs文档托管服务。可从Github抓取文档并自动编译好生成在线文档，目前几乎所有的Python库都将文档托管在上面。

]]>