Python入门之软件开发目录规范
本章重点：
理解在开发人标准软件时，如何布局项目目录结构，以及注意开发规范的重要性。
一、为什么要有好的目录结构
二、目录组织的方式
三、关于README的内容
四、关于requirements.txt和setup.py
==================================================================================
一、为什么要有好的目录结构
好的设计项目目录结构，就和编码风格一样，是每个程序员都有的风格，但是在流水化标准化作业过程中，个性和风格是不被鼓励的。
如果你去维护一个非常不好读的项目，虽然实现逻辑并不复杂，但是对后续的维护者来说就是灾难。
一个层次清晰的目录结构，可以提高程序的可维护性：
1. 可读性高：
后续维护人员可以一眼看懂目录结构，不必为复杂混乱的层次耗费大量精力。测试文件在哪，配置文件在哪会被放置在规范操作的地方，可以让后续人员快速的了解这个项目。
2. 可维护性高：
看清目录架构之后，维护者可以将后续新增的文件和代码按照规范放置在规定的地方，虽然后续代码和文件增多，但是项目目录并不会混乱，仍然能够快速组织良好
所以说，保持一个层次清洗的目录结构是非常必要的，也是体现一个程序员思路和视野格局的一个标准
二、目录组织的方式
目前各个开发语言在工程目录结构方面，已经取得了一些共识的目录结构.
例如，如下的一个简单的ATM目录结构，开发人员可以快速的了解项目的启动入口，用户层模块，逻辑接口层模块，数据处理模块，日志模块等等。
如下的foo项目，就是一个清晰合理的目录结构。
bin:/ 存放项目的一些可执行文件，类似的有script/文件
foo:/ 存放项目的所有源代码
1. 源代码中的所有模块、包都改放在这个目录，不能放在顶层目录
2. 子目录tests/用来存放单元测试代码
3. 程序的入口一般命名为main.py
docs:/ 存放一些文档
setup.py:/ 安装，部署，打包脚本
requirements.txt: 存放软件依赖的外部Python包列表
README: 项目说明文件
除此之外，一些开源软件还会有LECENSE.txt, ChangeLog.txt等文件，目录组织和这个类似。
三、关于README的内容
README在GITHUB中很常见，一般来说都是必备的。该文件就要简要的介绍该项目的信息，让读者可以快速了解这个项目。
README一般说明以下几个事项：
1. 软件的定位，软件的基本功能
2. 运行代码的方法，安装的环境，启动命令
3. 简要的使用说明
4. 代码的目录结构说明，可以详细的说明软件的基本原理
5. 常见问题说明
四、关于requirements.txt和setup.py
setup.py
一般来说，用setup.py来管理代码的打包、安装、部署问题。业界标准的写法是用Python流行的打包工具setuptools来管理这些事情，这种方式普遍应用于开源项目中。
不过这里的核心思想不是用标准化的工具来解决这些问题，而是说，一个项目一定要有一个安装部署工具，能快速便捷的在一台新机器上将环境装好、代码部署好和将程序运行起来。
requirements.txt
这个文件存在的目的是:
1、方便开发者维护软件的包依赖。将开发过程中新增的包添加进这个列表中，避免在setup.py安装依赖时漏掉软件包。
2、方便读者明确项目使用了哪些Python包。
这个文件的格式是每一行包含一个包依赖的说明，通常是flask>=0.10这种格式，要求是这个格式能被pip识别，这样就可以简单的通过 pip install -r requirements.txt来把所有Python包依赖都装好了。
