Python 入门:使用 Poetry 创建 Hello World 项目
使用 Poetry 快速构建 Python Hello World 项目
Poetry 是一个功能强大的 Python 包管理和构建工具,它简化了项目创建、依赖管理和环境隔离等流程。本教程将引导您一步步使用 Poetry 创建一个简单的 "Hello, World!" Python 项目。
准备工作
在开始之前,请确保您的系统已安装以下软件:
立即学习“Python免费学习笔记(深入)”;
- Python 3.7 或更高版本
- Poetry (请参考官方文档进行安装)
您可以通过以下命令验证安装:
python --versionpoetry --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!" 脚本
进入 hello_world 目录下的 hello_world 子目录:
cd hello-world/hello_world
然后,编辑 __init__.py 文件(或创建一个名为 main.py 的新文件),添加以下代码:
# hello_world/main.pydef 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!"
使用 Poetry 运行测试:
poetry run pytest
总结
恭喜您!您已经成功使用 Poetry 创建了一个简单的 "Hello, World!" Python 项目。 这个基础能够帮助您构建更复杂的项目,并有效管理依赖和打包过程。 您可以进一步探索 Poetry 的更多高级功能,例如依赖版本管理、虚拟环境管理以及包发布等。