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