MyPaint项目迁移：从distutils到setuptools的技术演进

在Python生态系统中，构建工具的选择对于项目的长期维护至关重要。MyPaint作为一个著名的开源绘画软件，近期面临了一个关键的构建系统升级问题——从传统的distutils迁移到现代setuptools工具链。

背景与挑战

随着Python 3.12版本的发布，标准库中正式移除了distutils模块。这一变化源于PEP 632的规范，该PEP明确建议开发者迁移到更现代的setuptools工具链。对于MyPaint项目而言，这意味着需要重构setup.py构建脚本以及相关测试文件中对distutils的依赖。

技术解决方案

在构建系统迁移过程中，开发团队重点关注了几个关键点：

1. 构建命令的兼容性处理：

   • 原生的distutils.command.build.build已被setuptools继承并维护
   • clean命令则需要重新实现，因为setuptools没有提供直接替代方案

2. 国际化支持调整：

   • 修复了gettext_setup.py中已弃用的API调用
   • 确保本地化支持在新的构建系统下正常工作

3. 测试套件适配：

   • 保留了性能测试中对distutils的临时依赖
   • 计划在未来版本中完全重构测试基础设施

实施细节

迁移工作的核心在于setup.py的重构。开发团队采用了渐进式策略：

# 旧版实现（使用distutils）
from distutils.command.build import build
from distutils.command.clean import clean

# 新版实现（使用setuptools）
from setuptools.command.build import build
# clean命令需要自定义实现

对于清理功能，团队参考了现代Python项目的常见实践，实现了自定义的clean命令逻辑，确保构建环境的干净状态。

对打包生态的影响

这一变更对Linux发行版的打包工作产生了直接影响：

1. Debian和Ubuntu等主流发行版需要应用补丁
2. 确保在Python 3.12环境下能够成功构建
3. 维护向后兼容性，不影响现有用户的升级路径

未来方向

虽然本次迁移解决了燃眉之急，但MyPaint项目的长期构建策略将转向更现代的方案：

1. 逐步淘汰setup.py，转向pyproject.toml
2. 评估使用构建前端如build的可能性
3. 简化依赖管理，提高跨平台兼容性

这次构建系统的成功迁移，不仅保证了MyPaint在Python 3.12及更高版本上的可用性，也为项目的现代化奠定了基础，展现了开源社区应对技术变革的敏捷性和协作精神。