Python 官方文档:入门教程 => 点击学习
1. 了解python项目文件组织结构非常重要 为什么要掌握pythob项目结构? 优秀的程序员都使用规范的项目代码结构,了解这些好的习惯方式,能帮助你快速读懂代码如果项目是几个人合作开发,好的代码结
本文将为您介绍: 项目结构预备知识,基本项目结构 ,带多个子包的项目结构,flask项目结构,机器学习项目结构等常见类型的项目结构,有疑问,欢迎留言
Package(包), Module(模块), file(文件) 三者关系,
Package由模块组成
包含功能代码的.py 代码文件也称为 module 模块, 但不能把 config.py , __init__.py
称为模块。
虽然在形式上,可以把1个包理解为1个目录,但并非是包含代码的目录都是包,
二者区分的关键是, 包目录包含 __init__.py
文件,不包含此文件的不能称之为包目录。
本文介绍的python项目结构适合于中小型项目, 应用非常广泛,初学者应该养成好习惯,一开始就用这种方式来组织自己的代码。
假设新建项目的名称为 myproject, 可以在windows或 linux终端, 创建如下项目结构
└─myproject │ .gitignore │ LICENSE │ readme.md │ requirements.txt │ setup.py │ ├─myproject │ main.py │ util.py │ __init__.py │ └─test test_main.py
说明如下:
第1层 myproject 是项目根目录,第2级 myproject是包目录,为什么这样组织,主要是基于好的实践经验,项目根目录主要用于存放配置,手册,启动文件等。 而主要功能都放在package包中,Pythton包的具体组织形式就是1个子目录,由于是基本项目,功能不多,只有1个包,因此用项目同名做为包名,所有实现代码放在 ·myproject/myproject· 目录下。
主要有几类文件:
包目录下主要有:
__init__.py
文件,(参考 Python项目中的 init.py的作用及内容 )n主要保存测试文件,都是test开头文件。
对于1个非常简单的程序 ,还可以简化为如下形式
sample/├── .gitignore├── LICENSE├── README.rst├── requirements.txt├── sample.py├── setup.py└── test_sample.py
如果项目功能较多,有几个开发者,可以把项目拆分,分成几个子包来开发。在 myproject的主包目录下创建子包目录
└─myproject │ .gitignore │ LICENSE │ readme.md │ requirements.txt │ setup.py │ ├─myproject │ │ main.py │ │ util.py │ │ __init__.py │ │ │ ├─app_sample │ │ │ sample.py │ │ │ __init__.py │ │ │ │ │ └─__pycache__ │ │ sample.cpython-39.pyc │ │ __init__.cpython-39.pyc │ │ │ └─__pycache__ │ main.cpython-39.pyc │ __init__.cpython-39.pyc │ └─test test_main.py
说明:
sample.py
, __init__.py
文件内容分别如下: # sample.py文件 def demo(): return "this is a demo function"# __init__.py 文件from .sample import demo # 或者 from sample import *
from app_sample import *def main(): return "main test"print(main())print(demo())
输出为:
main test
this is a demo function
也可以这样导入 sameple.py 中demo函数
from app_sample.sample import demo
与Django有项目结构生成工具不同,Flask 项目结构需要自己来构建, 1个结构良好的项目结构形式,要考虑子应用隔离,模型,模板文件、静态文件等路径,
下面是推荐的 Flask项目结构:
flaskr-tutorial/├── flaskr/│ ├── ___init__.py│ ├── db.py│ ├── schema.sql│ ├── auth.py│ ├── blog.py│ ├── templates/│ │ ├── base.html│ │ ├── auth/│ │ │ ├── login.html│ │ │ └── reGISter.html│ │ └── blog/│ │ ├── create.html│ │ ├── index.html│ │ └── update.html│ └── static/│ └── style.CSS├── tests/│ ├── data.sql│ ├── test_auth.py│ ├── test_blog.py│ ├── test_conf.py│ ├── test_db.py│ └── test_factory.py├── venv/├── .gitignore├── setup.py└── MANIFEST.in
机器学习项目是python应用的重要方向,此类项目的特点是,需要有源数据、算法模型目录(注意不是djanGo, flask 的模型),生产环境通常还需要集成 Flask 提供WEB服务,典型的项目结构如下:
sample/├── data/│ ├── external/│ ├── interim/│ ├── processed/│ └── raw/├── models/├── notebooks/├── sample/│ ├── data/│ ├── features/│ └── model/├── tests/├── .gitignore├── LICENSE├── README.rst├── requirements.txt└── setup.py
本文描述的python最流行的基本项目结构形式,后续继续给大家介绍,多应用项目,web项目,AI类应用项目结构的建议。
来源地址:https://blog.csdn.net/captain5339/article/details/128017400
--结束END--
本文标题: 各类Python项目的项目结构及代码组织最佳实践
本文链接: https://www.lsjlt.com/news/391330.html(转载时请注明来源链接)
有问题或投稿请发送至: 邮箱/279061341@qq.com QQ/279061341
下载Word文档到电脑,方便收藏和打印~
2024-03-01
2024-03-01
2024-03-01
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
2024-02-29
回答
回答
回答
回答
回答
回答
回答
回答
回答
回答
0