软件开发目录规范

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: 项目说明文件。

以上是关于软件开发目录规范的主要内容,如果未能解决你的问题,请参考以下文章

软件开发目录规范

软件开发目录规范

软件开发的目录规范

python软件目录规范

团队开发前端VUE项目代码规范

python 软件目录规范