poetry 的 `new` 命令行为在2025年4月发生了重要变更。此后，它不再默认生成 `test_*.py` 测试文件，并且 `__init__.py` 文件也会被创建为空。这一变化旨在简化项目初始化流程并与现代python打包实践对齐。因此，用户在遵循旧教程时应注意此差异，并始终查阅poetry的最新官方文档以获取准确信息，测试文件需手动创建。

Poetry new 命令的行为演变

在Poetry早期版本中，当用户执行 poetry new 命令来创建一个新项目时，Poetry会自动生成一个包含基本项目结构、一个空的 __init__.py 文件以及一个预设的 test_.py 测试文件的目录。这种行为对于初学者来说可能很方便，但随着Python生态系统的发展和最佳实践的演变，这种默认行为被重新评估。

2025年4月，Poetry的核心开发团队通过一次重要的提交（commit 85f922dfddb8d8e61408b5d8e53f3bffb6beb2b2b）修改了 poetry new 命令的默认行为。主要变更点如下：

1. 不再自动生成测试文件：poetry new 命令不再默认创建 test_.py 文件。这意味着新创建的项目将不会在 tests/ 目录下包含任何测试骨架文件。
2. __init__.py 文件默认为空：项目模块中的 __init__.py 文件（例如 my_project/__init__.py）现在默认创建为空，而不是包含版本信息或其他样板代码。这与Python 3.3+ 以来包的隐式命名空间包（Implicit Namespace Packages）和更简洁的包定义趋势保持一致。

这些变化旨在提供一个更精简、更符合现代Python项目结构的起始点，让开发者可以根据自己的需求和偏好来配置测试和包结构。

当前工作流与最佳实践

鉴于 poetry new 命令行为的改变，开发者在初始化项目时需要调整其工作流。

1. 项目初始化

使用 poetry new 命令创建项目，其输出将只包含最基本的项目骨架：

poetry new my-project

执行上述命令后，my-project 目录结构大致如下：

my-project/
├── pyproject.toml
├── README.md
├── my_project/
│   └── __init__.py
└── tests/

请注意，tests/ 目录下不会有任何 test_*.py 文件，且 my_project/__init__.py 文件是空的。

2. 手动创建测试文件

由于不再自动生成测试文件，开发者需要手动创建并组织测试。推荐使用流行的测试框架，如 pytest。

首先，将 pytest 添加为开发依赖：

cd my-project
poetry add pytest --group dev

然后，在 tests/ 目录下手动创建测试文件，例如 tests/test_example.py：

PictoGraphic

AI驱动的矢量插图库和插图生成平台

133 查看详情

# tests/test_example.py

from my_project import __version__

def test_version():
    assert __version__ == "0.1.0" # 假设pyproject.toml中定义了版本

为了使上述测试通过，你可能需要在 my_project/__init__.py 中定义 __version__：

# my_project/__init__.py

__version__ = "0.1.0"

最后，运行测试：

poetry run pytest

3. __init__.py 的作用

现在 __init__.py 默认为空，这符合Python 3.3+ 版本的包定义规范。在许多情况下，一个空的 __init__.py 足以将目录标记为一个Python包。如果你需要公开包的版本信息、进行包级别的初始化操作或暴露特定的模块/函数，你可以在 __init__.py 中添加相应代码。

例如，为了从包外部导入版本信息，你可以在 my_project/__init__.py 中定义：

# my_project/__init__.py

__version__ = "0.1.0"

# 你也可以在这里导入包内的其他模块，例如：
# from .module_a import some_function

4. 查阅最新文档

由于Python工具链和最佳实践的快速发展，教程和工具行为可能会随时间而变化。因此，强烈建议在学习和使用Poetry时，始终查阅其官方文档的最新版本。官方文档是获取最准确、最权威信息的来源。

• Poetry 官方文档：https://www.php.cn/link/a5220ac660ce8c78e452e5edc69d33cf
• poetry new 命令文档：https://www.php.cn/link/a5220ac660ce8c78e452e5edc69d33cfcli/#new

总结与建议

Poetry new 命令的行为变更反映了Python社区对项目初始化和包管理实践的演进。虽然这可能导致一些旧教程与当前Poetry版本不符，但理解这些变化有助于开发者更好地利用Poetry构建和管理项目。

核心要点包括：

• 测试文件需手动创建：不再依赖Poetry自动生成测试骨架。
• __init__.py 默认为空：根据需要自行填充，以定义版本或进行包初始化。
• 始终参考最新官方文档：这是避免混淆和获取最新最佳实践的关键。

通过适应这些变化，开发者可以更灵活、高效地使用Poetry管理Python项目。

以上就是Poetry new 命令：测试文件与__init__.py的最新行为解析的详细内容，更多请关注其它相关文章！

# 如何将  # 掇刀seo费用  # 晋安区公司seo服务费  # 设计公司企业推广营销  # 花溪区公司网站建设  # 龙华网站建设制作设计  # seo实战经验怎样总结  # 亚色444seo  # 华蓥关键词快速排名系统  # 海南营销推广产品公司排名  # 网站建设的市场有哪些  # 源代码  # python  # 命令行  # 转换为  # 目录下  # 工作流  # 你可以  # 自动生成  # 为空  # 文档  # python包  # 工具 

相关栏目： 【 科技资讯46185 】 【 网络学院92790 】

相关推荐： 邮政快递单号查询入口 邮政快递物流信息在线查询入口  c++20的std::jthread是什么_c++可中断线程与RAII式管理  Win11如何开启讲述人功能 Win11屏幕阅读器（讲述人）开启与关闭【教程】  在J*a中如何开发在线活动报名与管理系统_活动报名管理项目实战解析  PyTorch模型训练效果不佳？深入剖析常见错误与调试技巧  html网页设计源代码怎么运行_运行html网页设计源代码步骤【指南】  优化大型XML文件解析：基于Python流式处理的内存高效方案  Sublime怎么配置Nim语言环境_Sublime Nim代码高亮与补全  PDO预处理语句中冒号的正确处理：区分SQL函数格式与命名占位符  铁路12306的积分有效期是多久_铁路12306积分有效期说明  大象笔记网页版入口 印象笔记网页版登录入口  QQ邮箱网页版入口 QQ邮箱官方邮箱登录通道  Composer如何在生产环境安全地执行composer update  Descript怎样用AI剪辑自动去噪_Descript用AI剪辑自动去噪【自动降噪】  12306选座系统怎么选连座_12306选座多人连坐操作方法  包子漫画官方网站阅读入口-包子漫画在线漫画官网直达链接  Golang如何使用buffered channel提高性能_Golang buffered channel优化技巧  漫蛙2网页版漫画入口 漫蛙漫画在线官方登录  深入理解J*aScript中的B样条曲线与节点向量生成  Lar*el 递归关系中排除指定分支的教程  海量存储：机器视觉智能化的核心基石  汽水音乐网页版使用入口_汽水音乐电脑版播放指南  Vue.js 图片显示异常排查：理解应用挂载范围与DOM ID唯一性  想当下一个《2077》？《心之眼》Steam评价升至"多半好评"  Excel函数批量查找替换超快方法_Excel用REPLACE和FIND函数秒级替换  如何使用spryker/configurable-bundles-products-resource-relationship模块解决复杂产品捆绑关系难题  快手赚钱渠道_快手收益来源  J*a递归快速排序中静态变量导致数据累积的陷阱与解决方案  Golang如何测试channel通信行为_Golang channel通信测试与分析方法  最新韩小圈网页版登录入口_官网在线观看官方链接  PySpark中高效提取字符串右侧可变长度数字：使用regexp_extract  vivo浏览器怎么扫描二维码 vivo浏览器内置扫一扫功能使用方法  火狐浏览器占用内存高卡顿怎么办 火狐浏览器性能优化设置技巧  Win11截图该按哪些键 Win11截屏完整流程解析【教程】  CKEditor 5 自定义构建在React应用中渲染失败的调试与解决  铁路12306改签能改到更早的车次吗_铁路12306改签提前车次规则  PyTorch模型训练准确率不提升：诊断与修复常见指标计算错误  漫蛙2正版漫画站 漫蛙2网页版快速访问入口  蛙漫正版漫画平台入口_蛙漫免费阅读全站漫画资源  《刺客信条4：黑旗》重制版新细节曝光：无缝加载 地图更细致！  处理Kafka消费者会话超时：深入理解消息处理语义与幂等性  Tailwind CSS line-clamp 布局问题解析与修复指南  MAC怎么在地图App里使用“四处看看”_MAC体验部分城市的3D实景街景  mc.js免安装版 mc.js一键畅玩入口  React中useState与局部变量：理解组件状态管理与渲染机制  Win11 USB传输速度慢怎么解决 Win11 USB驱动更新与设置  夸克浏览器网页版最新地址 夸克浏览器官方入口合集  抖音网页版怎么|直播|_抖音网页版开播操作指南  微信怎么把收藏的内容分类管理 微信收藏内容标签分类方法  php源码怎么看淘宝客系统_看php源码淘宝客系统技巧