本文介绍如何使用poetry将python项目配置为可直接从命令行运行的工具。通过在`pyproject.toml`文件中配置`[tool.poetry.scripts]`部分，开发者可以定义一个入口点，使项目模块在安装后能够像原生命令一样被调用，无需`python -m`。这种方法简化了命令行工具的部署和使用，提升了用户体验。

在Python项目开发中，尤其当项目旨在提供命令行实用工具时，我们通常希望用户能够像使用系统原生命令一样直接调用它，而不是每次都通过python -m your_module的方式。Poetry作为一款强大的Python依赖管理和打包工具，提供了简洁高效的方式来实现这一目标，即通过在pyproject.toml文件中定义可执行脚本。

配置可执行脚本

Poetry通过pyproject.toml文件中的[tool.poetry.scripts]部分来定义可执行的命令行工具。这个配置项允许你指定一个脚本名称（即用户在命令行中键入的命令）以及它对应的Python入口点。

基本语法：

[tool.poetry.scripts]
<command_name> = '<module_path>:<function_name>'

• ：这是用户在终端中将要执行的命令名称。例如，如果你希望用户键入mycli来运行你的工具，那么这里就写mycli。
• ：这是包含入口函数的Python模块的路径。例如，如果你的入口函数在my_package/console.py中，那么模块路径就是my_package.console。
• ：这是在指定模块中被调用的函数名称。当用户执行时，Poetry会确保调用这个函数。

示例：

假设你有一个名为my_package的Poetry项目，并且希望创建一个名为my_package_cli的命令行工具。这个工具的入口函数位于my_package/console.py文件中的run函数。

MediPro商贸信息网站系统

基于PHP+MYSQL开发，具有完善的企业、信息、产品、文章发布和管理功能，灵活的会员权限控制和会员管理系统，灵活的可视化模版引擎，HTML静态页面生成和多语言支持，丰富的网站辅助工具，用于创建行业商贸信息网站、地方商贸信息门户网站。v5.1版本增加了多项功能,支持了PHP5+MYSQL5环境,前台网站插件开放源码,更利于个性化的商贸网站开发。主要功能模块：企业名录系统 - 企业介绍发布和企业名录

1 查看详情

1. 创建或修改 pyproject.toml 文件： 在你的项目根目录下的pyproject.toml文件中，添加或修改[tool.poetry.scripts]部分，如下所示：

   # pyproject.toml
   [tool.poetry]
   name = "my_package"
   version = "0.1.0"
   description = "A sample Poetry project with a CLI"
   authors = ["Your Name <your.email@example.com>"]
   
   [tool.poetry.dependencies]
   python = "^3.8"
   
   [tool.poetry.dev-dependencies]
   pytest = "^5.2"
   
   [tool.poetry.scripts]
   my_package_cli = 'my_package.console:run' # 定义命令行工具

2. 创建入口模块和函数： 在你的my_package目录（即与pyproject.toml中name字段对应的包名）下，创建console.py文件，并定义run函数：

   # my_package/console.py
   
   def run():
       """
       This function will be executed when 'my_package_cli' is called.
       """
       print("Hello from my_package_cli!")
       print("This is a command-line utility powered by Poetry.")
   
   if __name__ == '__main__':
       run()

安装与使用

完成上述配置和代码编写后，你需要执行以下步骤来安装并使用你的命令行工具：

1. 安装项目依赖： 在项目根目录下，运行Poetry的安装命令。这将安装项目的所有依赖，并根据[tool.poetry.scripts]配置创建可执行脚本。

   poetry install

   如果你的项目已经安装过，并且你只是添加了[tool.poetry.scripts]配置，你可能需要再次运行poetry install来更新环境。

2. 执行命令行工具： 安装完成后，你就可以在Poetry项目的虚拟环境中直接调用你定义的命令了：

   my_package_cli

   你将看到my_package/console.py中run函数定义的输出：

   Hello from my_package_cli!
   This is a command-line utility powered by Poetry.

注意事项与总结

• 虚拟环境激活： poetry install会在当前Poetry项目对应的虚拟环境中创建可执行脚本。因此，你需要确保在执行my_package_cli命令时，该虚拟环境是激活的（例如，通过poetry shell进入）。
• 全局安装： 如果你将此Poetry项目打包并通过pip install安装到其他环境中（例如，作为PyPI包发布），那么这个命令行工具也会在目标环境中可用，无需手动激活Poetry虚拟环境。Poetry和pip都会负责将脚本添加到系统PATH中（或其等效位置）。
• 入口点清晰： 确保你的入口函数（如示例中的run）不接受任何参数，或者能够优雅地处理无参数调用，因为命令行工具通常会在不带参数的情况下被调用。如果需要处理命令行参数，你可以在run函数内部使用argparse等库来解析sys.argv。
• 错误处理： 在实际的命令行工具中，应包含适当的错误处理和用户友好的输出信息。

通过[tool.poetry.scripts]，Poetry极大地简化了Python项目向可执行命令行工具的转换过程，使其与传统的setup.py或手动脚本创建相比，更加现代化和便捷。这种方法不仅提升了开发效率，也为最终用户提供了更直观、更专业的工具使用体验。

以上就是Poetry项目：创建可执行的命令行工具的详细内容，更多请关注其它相关文章！

# 数据包  # 正规网站seo外包产品  # 宁波seo营销费用排名  # 洛阳推广营销公司  # 宣城论坛网站建设方案  # 深圳百度营销推广专员  # 海外社交媒体推广营销  # 台州百度快照seo  # seo和高手对比  # 景区营销推广方案建议  # 许昌网站建设加盟电话  # 源代码  # 如何将  # python  # 转换为  # 企业名录  # 如果你  # 会在  # 这是  # 可执行  # 命令行  # red  # 虚拟环境  # ai  # 工具 

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

相关推荐： sublime如何配置Go语言开发环境_sublime搭建Golang编译运行系统  Lar*el DB::listen 事件中的查询执行时间单位解析  sublime怎么进行远程开发编辑_配置rsub/rmate实现sublime编辑服务器文件  windows10怎么查看硬盘序列号_windows10硬盘id查询命令  Golang如何使用new_Go new分配内存机制讲解  React项目中导航栏Logo自适应布局：避免裁剪与布局溢出  b站赚钱渠道_b站收益来源  将HTML Canvas内容转换为可上传的图像文件（File对象）  win11开机启动修复循环怎么办 Win11无法进入系统高级启动解决方法【修复】  如何在J*a中使用Locale处理多语言环境  win11专注助手在哪 Win11免打扰模式设置与自动化规则【指南】  J*aScript Promise链中如何正确终止后续.then执行并处理错误  126邮箱手机版登录官网2026_126手机邮箱免费入口最新  MAC怎么让Dock栏只显示当前运行的应用_MAC终端命令实现极简Dock栏  Win11截图该按哪些键 Win11截屏完整流程解析【教程】  如何使用Go和Martini动态服务解码后的图片  J*aScript中在Map循环中检测并处理空数组元素  如何将HTML表格多行数据保存到Google Sheets  为什么我的微信朋友圈看不到别人的更新_微信朋友圈更新显示异常解决方法  ACG动漫视频网入口 ACG动漫*免费正版观看地址  KFC早餐时段怎么领特惠代码_KFC早餐订餐优惠代码获取与使用说明  J*a如何使用AtomicInteger控制计数_J*a无锁计数器性能分析  J*a 递归快速排序中静态变量的状态管理与陷阱  MAC的“快捷指令”怎么同步到iPhone_MAC利用iCloud同步所有设备的自动化指令  中兴BladeV30怎样用测距估书架层高_iPhone中兴BladeV30测距估书架层高【家装参考】  深入理解J*aScript中的B样条曲线与节点向量生成  Python自定义类排序：解决lambda键值访问TypeError的实践指南  写好的html代码怎么运行出来_运行写好的html代码方法【教程】  微信客户端如何收红包_微信客户端接收红包使用教程  蛙漫官方正版入口 蛙漫网页在线全集免费观看  如何在J*a中实现统一对象行为接口_项目大型化时的接口规范化  ArrayList与LinkedList操作复杂度详解：遍历与修改  虚幻5科幻题材ARPG大作遭取消！本是《奇异人生》厂商新作  Composer的 "licenses" 命令如何帮助你遵守开源协议_检查项目依赖的许可证合规性  58动漫网在线官方网 58动漫网正版动漫入口网址  使用CSS更改登录屏幕输入框中PNG图标颜色的策略与局限性  Win11怎么合并任务栏图标 Win11开启任务栏合并减少图标占空间【方法】  使用 Pandas 高效处理 .dat 文件：数据清洗与数值计算实战  微信网页版扫码登录入口 微信网页版二维码登录入口  C++ map遍历方法大全_C++ map迭代器使用总结  word邮件合并后日期格式不对怎么改_Word邮件合并日期格式修改方法  AngularJS $http POST请求数据传递与Go后端接收实践  PyTorch模型训练准确率不提升：诊断与修复常见指标计算错误  如何仅使用CSS更改登录界面背景图像图标的颜色  Mac怎么使用表情符号_Mac Emoji快捷键面板  如何将HTML表格多行数据保存到Google Sheet  抖音网页版平台入口 抖音网页版官网在线访问教程  Lar*el 递归关系中排除指定分支的教程  知乎APP怎么管理已购盐选内容_知乎APP盐选内容购买记录与查看方法  在FastAPI中利用lifespan与依赖注入高效管理Redis连接池