micropython/unix

micropython/unix 镜像文档

镜像概述和主要用途

micropython/unix镜像提供预构建的MicroPython Unix端口实例，旨在为开发者提供便捷的MicroPython运行环境。该镜像可用于在容器中快速启动MicroPython解释器，支持交互式实验（REPL）、单元测试执行以及日常开发工作。

核心功能和特性

• 预构建环境：包含完整的MicroPython Unix端口预编译版本，无需手动编译
• 版本支持：提供从v1.17开始的所有重要MicroPython版本标签，可按需选择特定版本
• 轻量级设计：专注于核心功能，镜像体积小，启动迅速
• 交互支持：原生支持交互式终端（REPL），便于实时代码测试和调试

使用场景和适用范围

• REPL实验：快速启动MicroPython解释器进行代码片段测试和学习
• 单元测试：在隔离环境中运行MicroPython单元测试，确保环境一致性
• 开发辅助：作为开发环境的补充，用于验证跨版本兼容性或快速原型开发
• 教学演示：为MicroPython教学提供统一、可复制的运行环境

使用方法和配置说明

基本使用命令

通过以下命令启动指定版本的MicroPython交互式终端：

bash
docker run -ti --rm docker.xuanyuan.run/micropython/unix:版本标签

参数说明：

• -t：分配伪终端（pseudo-tty）
• -i：保持标准输入打开，支持交互
• --rm：容器退出后自动删除，避免残留容器文件
• 版本标签：指定MicroPython版本，如v1.19（从v1.17开始的所有重要版本均有对应标签）

示例：启动v1.19版本

bash
docker run -ti --rm docker.xuanyuan.run/micropython/unix:v1.19

执行后将进入MicroPython交互式环境，显示类似以下信息：

MicroPython v1.19.1-60-ge22b7fb4a-dirty on 2022-06-26; linux [GCC 8.3.0] version
Use Ctrl-D to exit, Ctrl-E for paste mode
>>>

交互操作说明：

• 输入Python代码并按回车执行
• 使用Ctrl-D退出交互式环境
• 使用Ctrl-E进入粘贴模式（支持多行代码粘贴）

运行指定脚本文件

如需运行本地Python脚本，可通过挂载主机目录的方式实现：

bash
docker run -ti --rm -v $(pwd):/scripts docker.xuanyuan.run/micropython/unix:v1.19 /scripts/your_script.py

其中-v $(pwd):/scripts将当前目录挂载到容器内的/scripts目录，随后指定要执行的脚本路径/scripts/your_script.py。