bobtemplates.gillux 1.3.0

用法

mrbob [options] bobtemplates.gillux:nspackage

带有以下功能的常规Python包引导

• 您想要的任何命名空间级别，甚至没有也可以。这通过您在向导中提供的名称来检测。

• 针对Python 2.4到2.7和3.x的代码

两个可选功能

• 带有 nose 和 coverage 的测试。使用 nosetests 运行它们。在生成的 setup.cfg 中调整您的选项。默认情况下，测试将自动“发现”（Python 2.7或3.3 unittest），或对于其他Python版本使用 unittest2。

• 这是一个Sphinx文档框架。使用python setup.py build_sphinx构建HTML文档。可选地，doctest文件可以自动包含在文档中。

包文件概要（可能根据选项而变化）

src/<your>/<package>/  # Your package source skeleton
doc/                  # Sphinx source tree skeleton
tests/                 # Test module skeleton with nose goodies
setup.py               # Usual setup script
setup.cfg
README.rst
MANIFEST.in

然后使用grep - 和可选地修复结果文件树中出现的FIXME：，这些是使用mr.bob常规功能难以轻松修复的额外内容。

阅读您新创建的包中的生成README.rst以获取更多有关您获得的内容的信息。

nspackage向导问题

您的全名？

您的全名（例如“John Doe”）

您的简称？

您的简称（例如“jdoe”）。通常您的PyPI或Github登录名是个好主意。

您的电子邮件地址？

此电子邮件地址将不会出现在此发行版的PyPI页面上。

发行版名称？

将要用于pip安装的发行版名称。例如pip install (此名称)。请确保它尚未被PyPI已知的50000多个包中的任何一个使用。

包名 - 是否带有命名空间（“foo.bar.baz”）或不带有（“foo”）？

Python中您的包的名称，例如在“导入foo.bar.baz”中。命名空间包将自动检测包目录树的结构和在setup.py中的注册。

包描述？

这将作为此发行版PyPI页面的副标题和在包列表中的内容。

组织？

拥有包版权的团队或公司。

Shell命令（如果不需要，请留空）？

安装此包将添加此命令到您的系统或激活的虚拟环境中。

此命令将在您使用python setup.py develop安装新包或使用pip install ...安装已发布的包后可用。该命令将执行yourpackage.__main__.main函数，带有预配置的argparse和logging设置。

使用nose测试[true|false]？

如果您是nosetests爱好者，否则测试布局将使用Python现在经典的自发现功能unittest或unittest2（适用于较旧版本的Python）。

在Sphinx文档中包含doctest文件[true|false]？

大型Python项目应具有Sphinx文档。此选项提供在docs目录中的Sphinx布局，适用于您的项目。您只需输入python setup.py build_sphinx来构建HTML文档。

在Sphinx文档中包含doctest文件[true|false]？

所有您的doctest文件（tests/test_*.txt）的副本将包含在Sphinx文档中。当然，如果之前的答案为false，则不会出现此问题。

您计划使用哪种SCM[git|hg|bzr|none]？

我们提供了一些Git、Mercurial和Bazaar的cookie，形式为.gitignore或适合SCM的排除文件。

TODO

• 提供six支持选项

• 源树内的测试（在src/<your>/<package>/tests）或在包根目录。有时我们更喜欢将测试包含在源发行版中，有时（例如大量测试数据）我们更喜欢保持源发行版小巧。