Python入门之软件开发目录规范（python教程目录）

Python入门之软件开发目录规范（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包依赖都装好了。

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。