microPython的源码解析之 frozenmod.c

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

microPython Python最小内核源码解析

#include <string.h> // 引入字符串处理函数库
#include <stdint.h> // 引入整数类型定义库

#include "py/lexer.h" // 引入Python词法分析器头文件
#include "py/frozenmod.h" // 引入MicroPython的冻结模块头文件

// 当定义了MICROPY_MODULE_FROZEN时，表示启用冻结模块功能
#if MICROPY_MODULE_FROZEN

// 冻结文件名列表，以空字符分隔。所有字符串类型条目首先列出，
// 然后是mpy类型的条目。使用mp_frozen_str_sizes来确定有多少字符串条目。
extern const char mp_frozen_names[];

// 当定义了MICROPY_MODULE_FROZEN_STR时，表示启用字符串类型的冻结模块
#if MICROPY_MODULE_FROZEN_STR

// 如果没有定义MICROPY_MODULE_FROZEN_LEXER，则使用mp_lexer_new_from_str_len作为默认的词法分析器创建函数
#ifndef MICROPY_MODULE_FROZEN_LEXER
#define MICROPY_MODULE_FROZEN_LEXER mp_lexer_new_from_str_len
#else
// 定义创建词法分析器的函数，用于处理冻结模块中的字符串
mp_lexer_t *MICROPY_MODULE_FROZEN_LEXER(qstr src_name, const char *str, mp_uint_t len, mp_uint_t free_len);
#endif

// 每个字符串条目的大小（以字节为单位），后面跟着一个零（终止符）。
extern const uint32_t mp_frozen_str_sizes[];
// 以空字符分隔的字符串内容。
extern const char mp_frozen_str_content[];

// 当定义了MICROPY_MODULE_FROZEN_MPY时，表示启用mpy类型的冻结模块
#if MICROPY_MODULE_FROZEN_MPY

#include "py/emitglue.h" // 引入代码生成胶水代码头文件

// 指向冻结模块内容的指针数组
extern const mp_frozen_module_t *const mp_frozen_mpy_content[];

#endif // MICROPY_MODULE_FROZEN_MPY

// 在冻结模块中查找名为"str"的条目，返回查找结果（不存在/文件/目录），
// 以及类型（无/字符串/mpy）和数据。如果不需要frozen_type的值，可以将其设置为NULL（此时data也被假定为NULL）。
mp_import_stat_t mp_find_frozen_module(const char *str, int *frozen_type, void **data) {
   
    size_t len = strlen(str); // 计算要查找的字符串长度
    const char *name = mp_frozen_names; // 获取冻结模块名称列表

    // 如果需要frozen_type的值，则初始化为MP_FROZEN_NONE（无）
    if (frozen_type != NULL) {
   
        *frozen_type = MP_FROZEN_NONE;
    }

    // 计算字符串条目的数量，以确定有多少字符串条目。
    size_t num_str = 0;
    #if MICROPY_MODULE_FROZEN_STR && MICROPY_MODULE_FROZEN_MPY
    for (const uint32_t *s = mp_frozen_str_sizes; *s != 0; ++s) {
   
        ++num_str;
    }
    #endif

    // 遍历名称列表
    for (size_t i = 0; *name != 0; i++