如何在 Fedora 上使用 Poetry 来管理你的 Python 项目?

系统 Linux 后端
Python 开发人员经常创建一个新的虚拟环境来分离项目依赖,然后用 pip、pipenv 等工具来管理它们。Poetry 是一个简化 Python 中依赖管理和打包的工具。这篇文章将向你展示如何在 Fedora 上使用 Poetry 来管理你的 Python 项目。

[[387434]]

Python 开发人员经常创建一个新的虚拟环境来分离项目依赖,然后用 pippipenv 等工具来管理它们。Poetry 是一个简化 Python 中依赖管理和打包的工具。这篇文章将向你展示如何在 Fedora 上使用 Poetry 来管理你的 Python 项目。

与其他工具不同,Poetry 只使用一个配置文件来进行依赖管理、打包和发布。这消除了对不同文件的需求,如 PipfileMANIFEST.insetup.py 等。这也比使用多个工具更快。

下面详细介绍一下开始使用 Poetry 时使用的命令。

在 Fedora 上安装 Poetry

如果你已经使用 Fedora 32 或以上版本,你可以使用这个命令直接从命令行安装 Poetry:

  1. $ sudo dnf install poetry

编者注:在 Fedora Silverblue 或 CoreOs上,Python 3.9.2 是核心提交的一部分,你可以用下面的命令安装 Poetry:

  1. rpm-ostree install poetry

初始化一个项目

使用 new 命令创建一个新项目:

  1. $ poetry new poetry-project

用 Poetry 创建的项目结构是这样的:

  1. ├── poetry_project
  2. └── init.py
  3. ├── pyproject.toml
  4. ├── README.rst
  5. └── tests
  6. ├── init.py
  7. └── test_poetry_project.py

Poetry 使用 pyproject.toml 来管理项目的依赖。最初,这个文件看起来类似于这样:

  1. [tool.poetry]
  2. name = "poetry-project"
  3. version = "0.1.0"
  4. description = ""
  5. authors = ["Kadermiyanyedi <kadermiyanyedi@hotmail.com>"]
  6.  
  7. [tool.poetry.dependencies]
  8. python = "^3.9"
  9.  
  10. [tool.poetry.dev-dependencies]
  11. pytest = "^5.2"
  12.  
  13. [build-system]
  14. requires = ["poetry>=0.12"]
  15. build-backend = "poetry.masonry.api"

这个文件包含 4 个部分:

  • 第一部分包含描述项目的信息,如项目名称、项目版本等。
  • 第二部分包含项目的依赖。这些依赖是构建项目所必需的。
  • 第三部分包含开发依赖。
  • 第四部分描述的是符合 PEP 517 的构建系统。

如果你已经有一个项目,或者创建了自己的项目文件夹,并且你想使用 Poetry,请在你的项目中运行 init 命令。

  1. $ poetry init

在这个命令之后,你会看到一个交互式的 shell 来配置你的项目。

创建一个虚拟环境

如果你想创建一个虚拟环境或激活一个现有的虚拟环境,请使用以下命令:

  1. $ poetry shell

Poetry 默认在 /home/username/.cache/pypoetry 项目中创建虚拟环境。你可以通过编辑 Poetry 配置来更改默认路径。使用下面的命令查看配置列表:

  1. $ poetry config --list
  2.  
  3. cache-dir = "/home/username/.cache/pypoetry"
  4. virtualenvs.create = true
  5. virtualenvs.in-project = true
  6. virtualenvs.path = "{cache-dir}/virtualenvs"

修改 virtualenvs.in-project 配置变量,在项目目录下创建一个虚拟环境。Poetry 命令是:

  1. $ poetry config virtualenv.in-project true

添加依赖

使用 poetry add 命令为项目安装一个依赖:

  1. $ poetry add django

你可以使用带有 --dev 选项的 add 命令来识别任何只用于开发环境的依赖:

  1. $ poetry add black --dev

add 命令会创建一个 poetry.lock 文件,用来跟踪软件包的版本。如果 poetry.lock 文件不存在,那么会安装 pyproject.toml 中所有依赖项的最新版本。如果 poetry.lock 存在,Poetry 会使用文件中列出的确切版本,以确保每个使用这个项目的人的软件包版本是一致的。

使用 poetry install 命令来安装当前项目中的所有依赖:

  1. $ poetry install

通过使用 --no-dev 选项防止安装开发依赖:

  1. $ poetry install --no-dev

列出软件包

show 命令会列出所有可用的软件包。--tree 选项将以树状列出软件包:

  1. $ poetry show --tree
  2.  
  3. django 3.1.7 A high-level Python Web framework that encourages rapid development and clean, pragmatic design.
  4. ├── asgiref >=3.2.10,<4
  5. ├── pytz *
  6. └── sqlparse >=0.2.2

包含软件包名称,以列出特定软件包的详细信息:

  1. $ poetry show requests
  2.  
  3. name : requests
  4. version : 2.25.1
  5. description : Python HTTP for Humans.
  6.  
  7. dependencies
  8. - certifi >=2017.4.17
  9. - chardet >=3.0.2,<5
  10. - idna >=2.5,<3
  11. - urllib3 >=1.21.1,<1.27

最后,如果你想知道软件包的最新版本,你可以通过 --latest 选项:

  1. $ poetry show --latest
  2.  
  3. idna 2.10 3.1 Internationalized Domain Names in Applications
  4. asgiref 3.3.1 3.3.1 ASGI specs, helper code, and adapters

 

 

责任编辑:庞桂玉 来源: Linux中国
相关推荐

2021-07-25 10:34:17

FedoraPodmanLinux

2023-11-26 16:23:16

FedoraVSCodium

2024-03-05 10:45:07

PoetryPython开发

2021-11-28 06:33:24

Discord消息收发应用 Linux

2021-08-18 11:19:25

FedoraLinuxJava

2018-06-11 09:55:09

LinuxFedorazsh

2018-05-14 08:36:06

JavaFedoraOpenJDK

2018-11-06 09:24:55

LinuxLutries命令

2020-12-28 06:44:45

FedoraLinux RPM文件

2015-06-01 12:19:03

FedoraCentOSSamba

2019-03-31 17:28:37

Arch LinuxLinux镜像

2014-07-14 09:24:51

Debiansystemd

2020-03-02 18:16:12

FedoraLinuxMongoDB

2020-06-15 18:20:37

Fedora电子书开源

2014-10-11 11:30:43

CentOSDocker

2012-08-09 16:37:45

服务器管理Rex

2012-05-22 15:19:55

Rex服务器管理

2018-03-07 11:32:44

LinuxVundleVim

2017-04-11 13:20:06

CentOSRHELFedora

2021-11-05 08:00:00

数据库PostgreSQL开源
点赞
收藏

51CTO技术栈公众号