我已经用 Python 编程语言制作了一个简单的软件。它有一些我编写的库和一些与程序一起使用的可执行文件。我想知道如何制作一个标准源包,包括该软件的文档和安装方法。
我知道一点,MakeFiles
但我不知道我必须使用哪些标准来处理文件结构和其他事情。
这是规范文档:
http://packages.python.org/distribute/setuptools.html
用于使用可以上传到 PyPI 或其他 Python 索引服务器的 setuptools 构建适当的包。
我认为目录结构没有真正的标准。
我通常做的事情如下:
MyProject/
|
|
|\ src/
| |
| |\ mypackage_1/
| |\ mypackage_2/
| |\ mymodule_1.py
| \ mymodule_2.py
|
|\ bin/
| |
| |\ my_script_1.py
| \ my_script_2.py
|
|\ doc/
| |
| |\ documentation_for_package_1/
| |\ documentation_for_package_2/
| |\ documentation_for_modules/
| \ documentation_for_scripts
|
|
\ tests/
|
|\ tests_for_mypackage_1/
|\ tests_for_mypackage_2/
|\ tests_for_mymodule_1
|\ tests_for_mymodule_2
\ tests_for_scripts/
使用此目录树,使用 setuptools 或分发安装所有模块、包等应该不难。如果您只想使用 distutils,那么我认为这可能很重要。