microPython的源码解析之 objproperty.c

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

---

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

---

代码是MicroPython中属性对象的实现，其中包含了属性对象的定义、创建、以及获取器、设置器和删除器的设置和获取等功能。代码中的注释已经翻译为中文，并对部分内容进行了补充说明，以便更好地理解代码的功能和作用。

#include <stdlib.h> // 标准库头文件，提供内存分配等函数
#include <assert.h> // 断言库头文件，用于程序调试

#include "py/runtime.h" // 导入MicroPython运行时环境的头文件

// 如果编译时开启了MICROPY_PY_BUILTINS_PROPERTY宏，则定义属性相关的数据结构和函数
#if MICROPY_PY_BUILTINS_PROPERTY

// 定义属性对象的结构体，继承自mp_obj_base_t基础对象
typedef struct _mp_obj_property_t {
   
    mp_obj_base_t base; // 基础对象部分
    mp_obj_t proxy[3]; // 属性的访问器（getter）、修改器（setter）和删除器（deleter）
} mp_obj_property_t;

// 定义创建属性对象的函数
static mp_obj_t property_make_new(const mp_obj_type_t *type, size_t n_args, size_t n_kw, const mp_obj_t *args) {
   
    // 定义参数的枚举，分别为获取器(fget)、设置器(fset)、删除器(fdel)和文档字符串(doc)
    enum {
    ARG_fget, ARG_fset, ARG_fdel, ARG_doc };
    // 定义允许的参数列表，每个参数的名字和类型
    static const mp_arg_t allowed_args[] = {
   
        {
    MP_QSTR_, MP_ARG_OBJ, {
   .u_rom_obj = MP_ROM_NONE} }, // 获取器参数
        {
    MP_QSTR_, MP_ARG_OBJ, {
   .u_rom_obj = MP_ROM_NONE} }, // 设置器参数
        {
    MP_QSTR_, MP_ARG_OBJ, {
   .u_rom_obj = MP_ROM_NONE} }, // 删除器参数
        {
    MP_QSTR_doc, MP_ARG_OBJ, {
   .u_rom_obj = MP_ROM_NONE} }, // 文档字符串参数
    };
    // 解析传入的参数
    mp_arg_val_t vals[MP_ARRAY_SIZE(allowed_args)];
    mp_arg_parse_all_kw_array(n_args, n_kw, args, MP_ARRAY_SIZE(allowed_args), allowed_args, vals);

    // 为属性对象分配内存
    mp_obj_property_t *o = mp_obj_malloc(mp_obj_property_t, type);
    // 将参数赋值给对象的proxy数组
    o->proxy[0] = vals[ARG_fget].u_obj; // 获取器
    o->proxy[1] = vals[ARG_fset].u_obj; // 设置器
    o->proxy[2] = vals[ARG_fdel].u_obj; // 删除器
    // 文档字符串参数被忽略
    return MP_OBJ_FROM_PTR(o); // 返回创建的对象
}

// 定义获取属性的获取器的函数
static mp_obj_t property_getter(mp_obj_t self_in, mp_obj_t getter) {
   
    // 创建一个新的属性对象
    mp_obj_property_t *p2 = m_new_obj(mp_obj_property_t);
    // 复制传入对象的内容
    *p2 = *(mp_obj_property_t *)MP_OBJ_TO_PTR(self_in);
    // 设置新的获取器
    p2->proxy[0] = getter;
    return MP_OBJ_FROM_PTR(p2); // 返回新对象
}

// 定义获取属性的设置器的函数
static mp_obj_t property_setter(mp_obj_t self_in, mp_obj_t setter) {
   
    // 创建一个新的属性对象
    mp_obj_property_t *p2 = m_new_obj(mp_obj_property_t);
    // 复制传入对象的内容
    *p2 = *(mp_obj_property_t *)MP_OBJ_TO_PTR(self_in)