使用poetry来更优雅的管理 python 包

简介: Poetry 的优势在于它提供了一个统一的工具来处理 Python 项目的整个生命周期,从依赖管理到打包和发布。它的依赖解析器非常强大,能够有效地处理复杂的依赖关系。此外,Poetry 还提供了一个直观的命令行界面,使得项目管理变得更加简单。对于团队协作和项目部署来说,Poetry 的依赖锁定功能(通过 poetry.lock 文件)特别有用,因为它确保了所有环境中使用相同版本的依赖。

Poetry 是一个 Python 依赖管理和打包工具,简化了 Python 项目的依赖管理、构建和发布过程。


FastAPI、Httpx、Pylint 等等项目也正在使用它做依赖管理。


它主要特点有:

  • 依赖管理:自动处理项目依赖,包括解析和锁定版本。
  • 虚拟环境管理:自动创建和管理项目的虚拟环境。
  • 构建和打包:简化项目的构建和打包过程。
  • 发布:轻松将项目发布到 PyPI。
  • 脚本运行:可以定义和运行项目相关的脚本。


poetry 提供了一系列覆盖整个开发流程的命令,这些命令使用也很简单:


名称

功能

new

创建一个项目脚手架,包含基本结构、pyproject.toml 文件

init

基于已有的项目代码创建 pyproject.toml 文件,支持交互式填写

install

安装依赖库

update

更新依赖库

add

添加依赖库

remove

移除依赖库

show

查看具体依赖库信息,支持显示树形依赖链

build

构建 tar.gz 或 wheel 包

publish

发布到 PyPI

run

运行脚本和代码

依赖管理方式

使用 new或 init 初始化了项目之后,会在项目目录下生成pyproject.toml 。Poetry 使用 pyproject.toml 文件来管理项目配置和依赖。


使用 install 或 add 添加了依赖库后,会生成 poetry.lock 文件。同时依赖会自动添加到 pyproject.toml 中。


name = "my-project"
version = "0.1.0"
description = "A sample Python project"
authors = ["Your Name you@example.com"]
[tool.poetry.dependencies]
python = "^3.9"
requests = "^2.25.1"
[tool.poetry.dev-dependencies]
pytest = "^6.2.3"

发布依赖到仓库

使用 build 命令可以方便的构建出 tar.gz 或 wheel 包。


配置私有仓库的地址:


poetry config repositories.foo https://bar.com/simple # 配置仓库地址
poetry config http-basic.foo username password  # 配置仓库的认证
poetry publish -r foo

1724660815359.jpg

根据 poetry config -h 的指引


PS:但是在这边通过配置用户名和密码到系统中的时候,经常出现这个异常:


Unable to retrieve the password for poetry-repository-foo from the key ring


因此使用了另外一种 publish 方式:


poetry config repositories.foo https://bar.com/simple # 配置仓库地址
poetry publish  -r pack1 -u username -p password

注意

  • 需要有一个包名与你的package 一致。


例如 package 名设置的 pack-111,那么在项目路径下,必须有一个 python 包 的文件夹,命名为:pack_111。否则在 build 的时候会报错:


No file/folder found for package pack-111


可以参考 fastapi 的目录结构:


1724660868809.jpg

总结

Poetry 的优势在于它提供了一个统一的工具来处理 Python 项目的整个生命周期,从依赖管理到打包和发布。它的依赖解析器非常强大,能够有效地处理复杂的依赖关系。此外,Poetry 还提供了一个直观的命令行界面,使得项目管理变得更加简单。


对于团队协作和项目部署来说,Poetry 的依赖锁定功能(通过 poetry.lock 文件)特别有用,因为它确保了所有环境中使用相同版本的依赖。


作者:麦麦麦造

链接:https://juejin.cn/post/7406355689075294247

相关文章
|
2月前
|
Python
下载python所有的包 国内地址
下载python所有的包 国内地址
WK
|
3月前
|
Python
如何在Python中导入包
在 Python 中,包是一种组织代码的方式,通过包含 `__init__.py` 文件(在 Python 3.3 及以上版本可选)的目录实现。包内可以包含多个模块(`.py` 文件)和其他子包。导入包有多种方式:整体导入包、导入特定模块、导入特定函数或类、导入子包等。推荐的做法是明确指定导入内容以提高代码的可读性和可维护性。此外,确保包目录结构正确,并将其添加到 Python 的搜索路径中。对于分发包,使用 setuptools 和 pip 等工具更为便捷。
WK
125 66
WK
|
3月前
|
Python
如何在Python中创建包
在Python中创建包十分简便,主要涉及目录结构的设置及`__init__.py`文件的配置。虽然Python 3.3后空`__init__.py`文件不再强制要求,但在特定场景下保留它有助于保持兼容性或执行包初始化代码。创建包的具体步骤包括:构建目录结构、编写模块代码、(可选)编写初始化代码等。例如,可以创建一个名为`mypackage`的目录,其中包含`__init__.py`及多个模块文件如
WK
114 62
|
2月前
|
机器学习/深度学习 搜索推荐 数据可视化
Python量化炒股常用的Matplotlib包
Python量化炒股常用的Matplotlib包
28 7
|
2月前
|
数据采集 数据可视化 数据挖掘
Python量化炒股常用的Pandas包
Python量化炒股常用的Pandas包
47 7
|
2月前
|
人工智能 算法 数据处理
Python常用的Numpy包
Python常用的Numpy包
42 7
|
2月前
|
人工智能 数据可视化 搜索推荐
Python异常模块与包
Python异常模块与包
|
2月前
|
开发者 Python
30天拿下Python之模块和包
30天拿下Python之模块和包
16 2
|
2月前
|
编解码 Python Windows
python有没有包 可以检测 这个视频是否可以播放
python有没有包 可以检测 这个视频是否可以播放
|
2月前
|
Python
Python变量用法——变量解包
Python变量用法——变量解包
33 0