1.目录规范 *****
(1)文件夹的规范写法
bin 可执行文件
conf 配置文件
core 主要业务逻辑
db 数据文件
lib 库 (公共代码 第三方模块)
log 日志文件
readme 说明文档(是一个文件)
再以上文件夹中 没有需要作为包的 你的包通常放到lib中 但是注意lib不应该作为包
疑惑?
# 这个文件夹到底应该是包还是文件夹 其实问题就是需不需要用到init
# init的作用就是导入包内模块中的全部功能
# 通过判断是不是需要这个功能来判断是包还是文件夹
(2)定制程序的入口
# 总结 程序的入口 主要是将项目的根目录添加到环境变量中
(3)分文件夹之后的模块使用
2.time *****
一 标准目录规范
我们学习了模块和包以后,在开发项目就不应该再是面条版,应该分文件,文件夹,那么有没有什么固定的文件
结构呢?有!这就是我们要说的开发目录规范
我们通过一个例子来说明这些文件夹的作用
案例:编写ATM
#file:"start.py" def login(): #加载文件 with open("/Users/jerry/PycharmProjects/项目结构/db/db.txt")as f: print(f.read()) def register(): print('注册'): def run(): while True: print( '''请选择 1.登录 2.注册 '''') s = input("请选择:") if s=="1": login() elif:s =="2": register() else: print("error")
1.在atm中我们市要使用到文件的路径,例如日志文件,数据文件等,并且不止一个地方用很多地方都要用,直接将路径写在代码中,是不不可取的,因为你无可避免的会需要修改这些路径;
所以不要直接写在代码中,那应该怎么做?定义为变量可行吗?当然 如此一来,修改的时候只需要修改一次即可!
#file:"start.py" #数据路径 DB_PATH="/users/jerry/PyvharmPro jects/项目结构/db/db.txt" #日志路径 LOG_PATH = "/users/jerry/PycharmProjects/项目结构/db/log.txt def login(): #加载文件 with open("/Users/jerry/PycharmProjects/项目结构/db/db.txt" as f: print(f.read()) def register(): print("注册") def run(): while True: print( """请选择 1.登录 2.注册 """) s = input("请选择:") if s== "1": login() elif:s =="2": register() else: print("error")
但是当你想一想,此类用于配置程序的变量,应该和你的业务逻辑放在一起吗?显然不应该,所以我们将要
用于配置的信息单独放在一个文件中
#file:"setting.py" #数据路径 DB_PATH = "/Users/jerry/PycharnProjiects/项目结构/db/db.txt" #日志路径 LOG_PATH = "/User/jerry/PycharmProjects/项目结构/log/log.txt"
2.在接下来我们需要实现一个道理验证的功能,name这个功能,需要在所有关键操作之前进行验证,也就是
说很多功能中都要调用这个功能.由于start中代码太多我们呢要进行拆分,这样一来.这个登录验证的代码
可以将其放置与一个公共的common中
common.py #登录验证装饰器 def login_auth() pass
3.除此之外,还有日志文件log,数据文件db;
4.另外我们可以将程序的业务逻辑和启动代码,进行分离,变成start文件和src文件
start.py专门用于执行启动
src中的业务逻辑,被star调用
这样用户使用时就能很快定位到启动文件
5.在一个启动项目中,可能有多个执行文件那我们可以将其统一到bin文件夹中
最后一个规范的项目目录应包括一下结构
bin
core
conf
lib
db
log
readme(介绍文件)
疑惑:这里的文件夹 是普通文件还是包?
包的本质就是你文件夹,所以在python项目中,文件夹也就是包,name这里的核心问题是应不应该有init文
件?
先明确iinit的作用主要是为了集中所有的功能,让外界方便调用,那我们一个一个来看看是否需要这两个功
能
bin排除他是执行文件不需要被导入
conf配置文件,在你的项目中不可能只有给一个配置文件,比如mysql,oracle,他们明显不是一家,你把他们
的配置全集中到init文件中,只会给自己带来困扰t
core业务逻辑,这其中一定有一个用户关系的入口,用户进入以后只能在这些不同业务中来回执行操作,所以
这个文件夹下的模块是相互调用的关系,不需要集合所有功能给外界调用
db,lib,log没什么好说的明显不需要
那什么样的代码该定义为包?例如你有一个下载文件的模块,这里面可能用到了网络请求叫request.py,
还有文件操作fileopt.py 那就应该将它定义为包,因为这两个文件中的功能都是给别人调用的!
==总结:项目标准结构第一层仅仅是文件夹绝不是包!==
二.定制程序的入口
继续完善程序,四期可以展示用户功能界面 在src中定义run函数,用来启动程序,注意src所在的core中可
能有多个文件,用户在使用时不方便,所以我们程序的入口从src中转移到start.py中
在start.py中导入core下的src并执行run
#file:"start.py" impiory core.src cor.src.run()
由于core这个模块并不存在于环境中,所以程序无法运行!
所以第一步:在环境变量中添加core
#file:"start.py" import sys sys.path.append(r"C:\\yyh\python\day20\ATM\core") import core.src core.src.run()
程序执行成功,但是以上写法存在两个问题.
1.除了core,其他的lib,conf就无法使用
为了能够找到所有模块,我们把ATM文件夹加入环境变量
#file:"start.py" import sys sys.path.appenf(r"c:\\yyh\python\day20\ATM
2.如果用户的安装路径不同,程序也无法运行
此时我们需要动态的获取当前项目的目录
在一个py文件中可以使用file来获取当前文件的路径
可以通过当前文件路径来获取文件所在的目录 使用os.paht.dirname
最终的代码如下:
#file:"start.py" import sys,os BASE_DIR = os.path.dirname(os.path.dirname(__file__))) sys.path.append(BASE_DIR) import core.src core.src.run()
三.使用标准目录后
引用配置文件
在上述案例中我们把文件的路径定义为变量并放在setting.py文件中
那么在src中要使用这些变量 就需要导入conf下的setting.py
由于在启动文件start.py中我们已经将项目根目录添加到path中,所以可以直接导入
#file:"src.py"部分代码
#导入配置文件
from conf import setting def login(): #加载文件 使用配置文件中的路径 with open(setting.DB_PATH( as f: print(f.read()) def register(): print("注册"")
引用自定义模块
为上述案列添加日志功能
#file:"src.py" 部分代码 #日志功能 def logger(msg): with open("/Users/jerry/PycharmProjects/项目结构/log/log.txt") as f: f.write(msg) #导入配置 from conf import setting def login(): #导入配置文件 with open(setting.DB_PATH) as f: print(f.read()) logger("xxx登录系统") def register(): print("注册")
日志功能并不是只有src文件使用 所以我们将它提取为单独的模块
在lib下comon中
#file:"src.py"部分代码 # 导入配置文件获取 日志路径 from conf import setting #日志功能 def logger(msg) with open(setting.LOG_PATH) as f: f.write(msg)
在src中导入日志模块
#file:"src.py" 部分代码 from lib import common #日志功能 def logger(msg): with open("/Users/jerry/PycharmProjects/项目结构/log/log.txt") as f: f.write(msg) #导入配置文件 from conf import setting def login(): #加载文件 使用配置文件中的路径 with open(setting.DB_PATH) as f: print(f.read()) logger("xxx登录系统") def register(): print("注册")