ruudjhuu/freecad

FreeCAD Python测试运行器镜像

镜像概述

本镜像包含FreeCAD环境，专门用于运行和测试FreeCAD相关的Python代码。它提供了一致的执行环境，是验证FreeCAD Python脚本、模块及工作台功能的理想工具。

核心功能与特性

• 内置完整FreeCAD环境，可直接运行FreeCAD Python代码
• 支持Python脚本、自定义模块及工作台的测试验证
• 需优先导入freecad模块进行环境初始化，确保后续FreeCAD模块正常加载

使用场景

• FreeCAD Python脚本的自动化测试
• 自定义FreeCAD模块的功能验证
• FreeCAD工作台开发过程中的环境一致性保障
• CI/CD流程中集成FreeCAD代码测试环节

使用方法

代码编写要求

必须首先导入freecad模块以完成环境初始化，随后才能导入其他FreeCAD模块：

python
# 必须作为第一个FreeCAD相关导入
import freecad

# 其他FreeCAD模块导入
import FreeCAD
import Part

# 示例：创建一个10x10x10的立方体
box = Part.makeBox(10, 10, 10)

容器运行示例

假设测试代码文件为example.py，可通过以下命令在容器内运行：

bash
docker run -v $(pwd):/app -w /app [镜像名称] python example.py

参数说明：

• -v $(pwd):/app：将当前目录挂载到容器内的/app目录
• -w /app：设置工作目录为/app
• [镜像名称]：替换为实际的Docker镜像名称
• python example.py：执行测试脚本

注意事项

• freecad模块必须作为首个FreeCAD相关模块导入，否则可能导致其他模块无法找到
• 确保测试代码中所有依赖的FreeCAD功能在镜像环境中均受支持
• 对于复杂项目，建议结合docker-compose管理多容器测试环境