teeks99/boost-python-test Docker 镜像 - 轩辕镜像

boost::python测试镜像文档

镜像概述和主要用途

该Docker镜像专为测试boost::python库设计，提供预配置的隔离环境，帮助开发者快速验证boost::python库的功能正确性、接口兼容性及跨版本稳定性。镜像已集成必要依赖，无需手动搭建复杂环境，适用于开发测试、兼容性验证及自动化测试场景。

核心功能和特性

• 预配置环境：已安装boost::python库、Python开发环境及Boost核心组件，开箱即可使用
• 多版本支持：兼容多种Python版本（3.6+）及Boost版本（1.70.0+），满足不同兼容性测试需求
• 环境隔离：基于Docker容器技术，测试过程不影响宿主系统配置
• 轻量级设计：基于官方Python/Boost镜像构建，最小化镜像体积，减少资源占用
• 标准化测试：提供基础测试脚本模板，便于快速编写和执行测试用例

使用场景和适用范围

• 开发测试：boost::python库开发者验证新功能或修复bug后的功能正确性
• 兼容性验证：应用开发者在集成boost::python前，测试目标版本与项目的兼容性
• CI/CD集成：作为自动化测试环节的基础环境，确保代码提交不破坏boost::python相关功能
• 学习实践：快速搭建测试环境，验证boost::python示例代码或学习教程

使用方法和配置说明

基本使用

通过docker run命令启动容器并执行测试脚本：

bash
# 挂载本地测试目录到容器内/test目录，运行测试脚本
docker run --rm -v $(pwd):/test boost-python-test-image python /test/your_test_script.py

参数说明：--rm表示容器退出后自动清理；-v $(pwd):/test将当前目录挂载到容器内/test路径

自定义配置

通过环境变量调整镜像配置：

示例：指定Python 3.8和Boost 1.72.0运行测试

bash
docker run --rm -e PYTHON_VERSION=3.8 -e BOOST_VERSION=1.72.0 -v $(pwd):/test boost-python-test-image python /test/compatibility_test.py

测试流程示例

1. 编写测试脚本
   创建本地测试脚本test_boost_python.py：

   python
   import test_module  # 假设test_module为boost::python编译的模块
   
   def test_greet_function():
       result = test_module.greet()
       assert result == "Hello from boost::python", f"测试失败: 预期'Hello from boost::python'，实际{result}"
       print("greet函数测试通过")
   
   if __name__ == "__main__":
       test_greet_function()
   

2. 编译boost::python模块（如需）
   若测试需自定义C++模块，可在容器内编译：

   bash
   # 进入容器交互模式
   docker run -it --rm -v $(pwd):/test boost-python-test-image /bin/bash
   
   # 在容器内编译C++模块（假设源代码为test_module.cpp）
   g++ -shared -fPIC -I/usr/include/python${PYTHON_VERSION} -lboost_python$(echo ${PYTHON_VERSION} | tr -d .) test_module.cpp -o /test/test_module.so
   

3. 执行测试
   运行挂载的测试脚本：

   bash
   docker run --rm -v $(pwd):/test boost-python-test-image python /test/test_boost_python.py
   

docker-compose配置示例

创建docker-compose.yml实现更复杂的测试场景：

yaml
version: '3'
services:
  boost-python-test:
    image: boost-python-test-image
    environment:
      - BOOST_VERSION=1.76.0
      - PYTHON_VERSION=3.9
      - TEST_LOG_PATH=/test/logs
    volumes:
      - ./tests:/test
      - ./logs:/test/logs  # 持久化测试日志
    command: python /test/run_all_tests.py

通过以上配置和方法，可快速利用该镜像完成boost::python库的各类测试任务。