[toc]
## 目录组织方式2
假设项目名为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: 项目说明文件。
>开源软件的目录该如何组织,可以参考[这篇文章](http://www.jeffknupp.com/blog/2013/08/16/open-sourcing-a-python-project-t