microPython的源码解析之 objmodule.c

MicroPython 是一种适用于微控制器和其他受限环境的 Python 编程语言的实现。它旨在提供与 Python 3 语言的紧密兼容，同时考虑到内存和计算资源的限制。MicroPython 库是这门语言的核心组成部分，提供了一系列的模块和函数，使得开发者能够在硬件上执行各种任务。
下面将通过系列文章,逐一解读microPython,以便让读者了解掌握microPython的整个核心逻辑.,以便读者可以透过这个Python的最小内核,掌握Python解析器的核心实现逻辑,学习世界上最优秀的源码设计之一.

---

microPython Python最小内核源码解析
NI-motion运动控制c语言示例代码解析
python编程示例系列 python编程示例系列二
python的Web神器Streamlit

---

这段代码是MicroPython的一部分，MicroPython是一个为嵌入式系统设计的Python解释器。代码主要涉及模块的创建、打印和属性处理。代码中的注释已经翻译为中文，并且补充了一些注释以便更好地理解代码的功能和结构。

#include <stdlib.h> // 标准库，提供内存分配、随机数等函数
#include <string.h> // 字符串操作库，提供字符串处理函数
#include <assert.h> // 断言库，用于程序调试时检查条件是否为真

// 引入MicroPython特有的头文件
#include "py/bc.h" // 字节码定义
#include "py/objmodule.h" // 模块对象定义
#include "py/runtime.h" // 运行时环境定义
#include "py/builtin.h" // 内置对象和函数定义

// 打印模块信息的函数
static void module_print(const mp_print_t *print, mp_obj_t self_in, mp_print_kind_t kind) {
   
    (void)kind; // 未使用的参数，用于兼容不同打印方式
    mp_obj_module_t *self = MP_OBJ_TO_PTR(self_in); // 将对象转换为模块指针

    // 获取模块名称，如果不存在则默认为空字符串
    const char *module_name = "";
    mp_map_elem_t *elem = mp_map_lookup(&self->globals->map, MP_OBJ_NEW_QSTR(MP_QSTR___name__), MP_MAP_LOOKUP);
    if (elem != NULL) {
   
        module_name = mp_obj_str_get_str(elem->value); // 获取模块名称字符串
    }

    // 如果模块存储了__file__属性，则尝试查找该符号以获取更多模块信息
    #if MICROPY_PY___FILE__
    if (elem != NULL) {
   
        mp_printf(print, "<module '%s' from '%s'>", module_name, mp_obj_str_get_str(elem->value)); // 打印模块及其来源文件信息
        return;
    }
    #endif

    mp_printf(print, "<module '%s'>", module_name); // 打印模块名称
}

// 尝试委托属性获取的函数
static void module_attr_try_delegation(mp_obj_t self_in, qstr attr, mp_obj_t *dest);

// 处理模块属性的函数
static void module_attr(mp_obj_t self_in, qstr attr, mp_obj_t *dest) {
   
    mp_obj_module_t *self = MP_OBJ_TO_PTR(self_in); // 将对象转换为模块指针
    if (dest[0] == MP_OBJ_NULL) {
    // 如果目标对象为空，则尝试加载属性
        // 查找全局字典中的属性
        mp_map_elem_t *elem = mp_map_lookup(&self->globals->map, MP_OBJ_NEW_QSTR(attr), MP_MAP_LOOKUP);
        if (elem != NULL) {
   
            dest[0] = elem->value; // 如果找到属性，则将其值赋给目标对象
        #if MICROPY_CPYTHON_COMPAT
        } else if (attr == MP_QSTR___dict__) {
    // 如果属性是__dict__，则返回模块的全局字典
            dest[0] = MP_OBJ_FROM_PTR(self->globals);
        #endif
        #if MICROPY_MODULE_GETATTR
        } else if (attr != MP_QSTR___getattr__) {
    // 如果属性不是__getattr__，则尝试查找__getattr__方法
            elem = mp_map_lookup(&self->globals->map, MP_OBJ_NEW_QSTR(MP_QSTR___getattr__), MP_MAP_LOOKUP);
            if (elem != NULL) {
   
                dest[0] = mp_call_function_1