如何优雅的搭建 Python 项目

当你熟悉了 Python 之后,就不会再满足只写一个脚本就完事,这个时候就需要考虑项目结构的事情了,尤其与别人合作完成一个项目的时候,项目的结构尤其重要。

本文分享如何优雅的开启一个 Python 项目。

简单来讲,分为 5 个步骤:

1、创建虚拟环境

你可以在项目目录中执行下面的命令,然后就会生成一个 venv 目录,这就是 Python 的虚拟环境,后面记得把 venv 添加到 .Gitignore 文件中,避免被 Git 管理,从而避免上传到 GitHub。

python3 -m venv venv #创建
source venv/bin/activate #激活
deactivate #取消激活

在后面的编码过程中,我们会 pip install 一些依赖,项目依赖全部安装完成后,记得执行 pip freeze> requirements.txt 来保存项目的依赖,以便后续迁移或者部署的时候,可以很快安装依赖。

2、建立单独的单元测试目录

通常,在项目目录下建立 tests 文件夹,来存放单元测试文件,假如有一个 Python 文件名是 greetings.py 那单元测试的文件名就是 test_greetings.py,通常大家都用 pytest 来进行单元测试,可以查询 pytest 文件命名规范。

3、创建不同的内容目录

这个是灵活的,按个人风格来,总体上来说,以英文命名,体现架构层次,可以参照 Django 里面的 models,views,utils,app 等。

在一个目录中放入 __init__.py,表示这个目录是一个包,是用来导入使用的。

4、设计文档字符串及类型提示

文档字符串及类型提示,都是为了方便他人或自己来阅读和调用代码。

如何优雅的搭建 Python 项目
如何优雅的搭建 Python 项目
如何优雅的搭建 Python 项目

5、使用 Git、GitHub 进行版本管理

如果与其他人一起工作,Git GitHub 对于进行版本管理、代码审查、避免合并冲突是必不可少的。即使是自己独立编码,Git 和 GitHub 也是必备的版本控制工具。

最后

上面一些步骤在 Python 老司机看来比较繁琐,那么你可以使用 poetry 这个脚手架工具,自动为你创建好目录结构,管理虚拟环境、依赖、构建、运行等快捷服务。如果觉得有帮助,还请点个在看支持一下,感谢老铁。


原文始发于微信公众号(Python七号):如何优雅的搭建 Python 项目

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 举报,一经查实,本站将立刻删除。

文章由极客之音整理,本文链接:https://www.bmabk.com/index.php/post/39692.html

(0)
小半的头像小半

相关推荐

发表回复

登录后才能评论
极客之音——专业性很强的中文编程技术网站,欢迎收藏到浏览器,订阅我们!