使用 Poetry 快速构建 Python Hello World 项目
Poetry 是一个功能强大的 Python 包管理和构建工具，它简化了项目创建、依赖管理和环境隔离等流程。本教程将引导您一步步使用 Poetry 创建一个简单的 "Hello, World!" Python 项目。
准备工作
在开始之前，请确保您的系统已安装以下软件：
立即学习“Python免费学习笔记（深入）”；
- Python 3.7 或更高版本
- Poetry (请参考官方文档进行安装)
您可以通过以下命令验证安装：
python --version poetry --version
步骤一：创建新项目
首先，创建一个新的项目目录，然后进入该目录，运行以下命令创建项目：
poetry new hello-world
这将会创建一个名为 hello-world 的文件夹，其目录结构如下：
hello-world/
├── readme.rst
├── hello_world
│ └── __init__.py
├── pyproject.toml
└── tests
├── __init__.py
└── test_hello_world.py
关键文件说明：
-
hello_world/: 您的 Python 包所在的目录。 -
pyproject.toml: 定义项目依赖项和元数据。 -
tests/: 测试用例目录。
步骤二：编写 "Hello, World!" 脚本
进入 hello_world 目录下的 hello_world 子目录：
cd hello-world/hello_world
然后，编辑 __init__.py 文件（或创建一个名为 main.py 的新文件），添加以下代码：
# hello_world/main.py
def main():
print("Hello, World!")
if __name__ == "__main__":
main()
步骤三：配置 pyproject.toml 文件
在 pyproject.toml 文件中，添加入口点配置，以便能够直接运行脚本。在 [tool.poetry.scripts] 部分添加以下内容：
[tool.poetry.scripts] hello-world = "hello_world.main:main"
步骤四：安装依赖项
运行以下命令安装依赖项并设置虚拟环境：
poetry install
步骤五：运行脚本
使用以下命令运行您的脚本：
poetry run hello-world
您应该看到控制台输出：
Hello, World!
步骤六：添加测试用例 (可选)
为了确保代码的正确性，可以在 tests/test_hello_world.py 文件中添加测试用例：
def test_main(capsys):
from hello_world.main import main
main()
captured = capsys.readouterr()
assert captured.out == "Hello, World!\n"
使用 Poetry 运行测试：
poetry run pytest
总结
恭喜您！您已经成功使用 Poetry 创建了一个简单的 "Hello, World!" Python 项目。 这个基础能够帮助您构建更复杂的项目，并有效管理依赖和打包过程。 您可以进一步探索 Poetry 的更多高级功能，例如依赖版本管理、虚拟环境管理以及包发布等。
