本文详细介绍了在 Poetry 项目中如何确保特定依赖仅在 Windows 操作系统上安装。针对 distutils.util.get_platform() 返回 win-amd64 无法普适所有 Windows 版本的问题，教程指出使用 poetry add –platform=win32 命令是实现此目的的有效方法。尽管 win32 命名可能令人困惑，但它被 Poetry 识别为通用的 Windows 平台标识符，从而确保依赖在所有 Windows 版本上正确安装，同时避免在非 Windows 系统上尝试安装。
问题背景：跨平台依赖管理挑战
在 Python 项目开发中，尤其是在使用 Poetry 进行依赖管理时，经常会遇到需要为特定操作系统安装依赖的情况。例如，某个库可能只在 Windows 环境下可用，或者其功能仅在 Windows 上有意义。Poetry 提供了 –platform 参数来指定依赖的安装平台。
然而，在使用 distutils.util.get_platform() 获取平台标识时，Windows 系统通常返回如 win-amd64 这样的具体架构信息。这与 Linux 的 linux 或 macOS 的 darwin 等通用标识符不同，导致开发者困惑于如何指定一个能够覆盖所有 Windows 版本的通用平台标识符，而不是仅仅针对 win-amd64。
解决方案：使用 win32 作为通用 Windows 平台标识符
经过实践验证，Poetry 识别 win32 作为通用的 Windows 平台标识符，即使目标系统是 64 位 Windows。这意味着，当您希望某个依赖仅在任何 Windows 系统上安装时，应使用 –platform=win32 参数。
示例命令：
要将 your-package 依赖仅添加到 Windows 系统中，请执行以下 Poetry 命令：
poetry add your-package --platform=win32
执行此命令后，Poetry 会将 your-package 添加到项目的 pyproject.toml 文件中，并为其自动添加 platform = “win32” 环境标记。
pyproject.toml 中的体现：
在 pyproject.toml 文件中，该依赖的配置将类似于：
[tool.poetry.dependencies]python = "^3.8"your-package = { version = "^1.0.0", platform = "win32" }
这里的 platform = “win32” 是一个 PEP 508 环境标记（Environment Marker）。当 Poetry 解析 pyproject.toml 并安装依赖时，它会根据当前运行环境的平台信息评估这些标记。如果当前环境是 Windows（无论是 32 位还是 64 位），则 win32 标记为真，your-package 将被安装；否则，该依赖将被跳过。
注意事项
win32 的含义： 尽管名称为 win32，但它在 Python 包管理和分发领域（包括 Poetry）中被广泛用作所有 Windows 版本的通用标识符，而不仅仅是特指 32 位 Windows 系统。这是历史遗留和兼容性考量的结果。环境标记的强大： –platform 参数是 Poetry CLI 提供的便捷方式，其底层机制是利用 PEP 508 定义的环境标记。除了 platform 之外，环境标记还支持 os_name、sys_platform、python_version、extra 等多种条件，允许开发者根据更复杂的逻辑来控制依赖的安装。验证安装： 在添加带有平台限制的依赖后，建议在不同的操作系统（例如 Windows 和 Linux）上运行 poetry install 或 poetry lock 来验证依赖是否按预期被包含或排除。
总结
在 Poetry 项目中，若要确保某个依赖仅在 Windows 操作系统上安装，最有效且推荐的方法是使用 poetry add –platform=win32 命令。Poetry 会将 win32 识别为通用的 Windows 平台标识符，并相应地在 pyproject.toml 中配置环境标记。这一方法简单直观，能够有效解决跨平台依赖管理的特定需求，确保项目依赖的正确性和环境的整洁性。
以上就是Poetry 项目中如何确保依赖仅在 Windows 系统上安装的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1365460.html
微信扫一扫 
支付宝扫一扫 
