软件开发目录规范
Posted sunny666
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了软件开发目录规范相关的知识,希望对你有一定的参考价值。
目录结构的作用:
1.可读性高
2.可维护性高
软件开发最基本目录:
1.log (日子目录)
2.conf(配置目录)
3.core 或者项目名(核心目录)
4.libs/modules(第三方库)
5.docs(文档库)
6.README(对软件的说明)
7.setup.py(一键装机)
目录组织方式
关于如何组织一个较好的Python工程目录结构,已经有一些得到了共识的目录结构。在Stackoverflow的这个问题上,能看到大家对Python目录结构的讨论。
这里面说的已经很好了,我也不打算重新造轮子列举各种不同的方式,这里面我说一下我的理解和体会。
假设你的项目名为foo, 我比较建议的最方便快捷目录结构这样就足够了:
Foo/
|-- bin/
| |-- foo
|
|-- foo/
| |-- tests/
| | |-- __init__.py
| | |-- test_main.py
| |
| |-- __init__.py
| |-- main.py
|
|-- docs/
| |-- conf.py
| |-- abc.rst
|
|-- setup.py
|-- requirements.txt
|-- README
简要解释一下:
- bin/: 存放项目的一些可执行文件,当然你可以起名script/之类的也行。
- foo/: 存放项目的所有源代码。(1) 源代码中的所有模块、包都应该放在此目录。不要置于顶层目录。(2) 其子目录tests/存放单元测试代码; (3) 程序的入口最好命名为main.py。
- docs/: 存放一些文档。
- setup.py: 安装、部署、打包的脚本。
- requirements.txt: 存放软件依赖的外部Python包列表。
- README: 项目说明文件。
以上是关于软件开发目录规范的主要内容,如果未能解决你的问题,请参考以下文章