Kyuubi项目中Python依赖命名的规范化改进

在开源项目Kyuubi的Python模块开发过程中，我们发现了一个关于依赖声明规范性的重要问题。这个问题涉及到Python包管理中的依赖声明方式，特别是extra依赖项的命名规范。

问题背景

在Python生态系统中，PyHive是一个常用的Hive客户端库，它支持通过extra依赖项来声明可选功能。Kyuubi项目在使用PyHive时，通过hive_pure_sasl这个extra名称来声明对SASL认证的支持。然而，这种下划线形式的命名方式实际上不符合Python官方的PEP规范。

技术细节分析

根据Python Enhancement Proposals的两个重要规范：

1. PEP 503定义了Python包的规范化名称标准，明确指出包名应该使用连字符(hyphen)而非下划线(underscore)
2. PEP 685进一步细化了extra依赖项的命名规范，同样推荐使用连字符

在实际使用中，特别是使用Poetry这样的现代包管理工具时，使用下划线命名的extra依赖项会导致工具无法正确识别依赖关系。具体表现为：当用户安装依赖时，会收到"不提供该extra"的警告，导致关键的依赖包如pure-sasl、thrift和thrift_sasl无法被正确安装。

解决方案

针对这一问题，我们决定将PyHive的extra依赖项声明从hive_pure_sasl改为hive-pure-sasl。这一改动虽然看似微小，但具有以下重要意义：

1. 符合Python社区的官方规范，提高项目的标准化程度
2. 确保在各种包管理工具(如pip、poetry等)中的兼容性
3. 避免用户安装时出现警告和依赖缺失的问题

实施影响

这一改动将通过发布PyHive 0.7.1版本来实现。对于Kyuubi项目来说，这意味着：

1. Python客户端将获得更可靠的依赖解析能力
2. 使用Poetry等工具的用户将不再遇到依赖安装问题
3. 项目整体与Python生态系统的集成更加规范

总结

这个案例展示了开源项目中依赖管理规范性的重要性。即使是看似微小的命名差异，在实际使用中也可能导致显著的问题。通过遵循PEP规范，我们不仅解决了当前的问题，还为项目的长期维护和发展奠定了更好的基础。这也提醒我们在开发过程中，应该始终关注并遵循相关技术规范，以确保项目的健壮性和兼容性。