Coverage Report

Created: 2026-02-26 06:53

next uncovered line (L), next uncovered region (R), next uncovered branch (B)
/src/cpython/Objects/clinic/descrobject.c.h
Line
Count
Source
1
/*[clinic input]
2
preserve
3
[clinic start generated code]*/
4
5
#if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
6
#  include "pycore_gc.h"          // PyGC_Head
7
#  include "pycore_runtime.h"     // _Py_ID()
8
#endif
9
#include "pycore_modsupport.h"    // _PyArg_UnpackKeywords()
10
11
PyDoc_STRVAR(mappingproxy_new__doc__,
12
"mappingproxy(mapping)\n"
13
"--\n"
14
"\n"
15
"Read-only proxy of a mapping.");
16
17
static PyObject *
18
mappingproxy_new_impl(PyTypeObject *type, PyObject *mapping);
19
20
static PyObject *
21
mappingproxy_new(PyTypeObject *type, PyObject *args, PyObject *kwargs)
22
738
{
23
738
    PyObject *return_value = NULL;
24
738
    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
25
26
738
    #define NUM_KEYWORDS 1
27
738
    static struct {
28
738
        PyGC_Head _this_is_not_used;
29
738
        PyObject_VAR_HEAD
30
738
        Py_hash_t ob_hash;
31
738
        PyObject *ob_item[NUM_KEYWORDS];
32
738
    } _kwtuple = {
33
738
        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)
34
738
        .ob_hash = -1,
35
738
        .ob_item = { &_Py_ID(mapping), },
36
738
    };
37
738
    #undef NUM_KEYWORDS
38
738
    #define KWTUPLE (&_kwtuple.ob_base.ob_base)
39
40
    #else  // !Py_BUILD_CORE
41
    #  define KWTUPLE NULL
42
    #endif  // !Py_BUILD_CORE
43
44
738
    static const char * const _keywords[] = {"mapping", NULL};
45
738
    static _PyArg_Parser _parser = {
46
738
        .keywords = _keywords,
47
738
        .fname = "mappingproxy",
48
738
        .kwtuple = KWTUPLE,
49
738
    };
50
738
    #undef KWTUPLE
51
738
    PyObject *argsbuf[1];
52
738
    PyObject * const *fastargs;
53
738
    Py_ssize_t nargs = PyTuple_GET_SIZE(args);
54
738
    PyObject *mapping;
55
56
738
    fastargs = _PyArg_UnpackKeywords(_PyTuple_CAST(args)->ob_item, nargs, kwargs, NULL, &_parser,
57
738
            /*minpos*/ 1, /*maxpos*/ 1, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
58
738
    if (!fastargs) {
59
0
        goto exit;
60
0
    }
61
738
    mapping = fastargs[0];
62
738
    return_value = mappingproxy_new_impl(type, mapping);
63
64
738
exit:
65
738
    return return_value;
66
738
}
67
68
PyDoc_STRVAR(property_init__doc__,
69
"property(fget=None, fset=None, fdel=None, doc=None)\n"
70
"--\n"
71
"\n"
72
"Property attribute.\n"
73
"\n"
74
"  fget\n"
75
"    function to be used for getting an attribute value\n"
76
"  fset\n"
77
"    function to be used for setting an attribute value\n"
78
"  fdel\n"
79
"    function to be used for del\'ing an attribute\n"
80
"  doc\n"
81
"    docstring\n"
82
"\n"
83
"Typical use is to define a managed attribute x:\n"
84
"\n"
85
"class C(object):\n"
86
"    def getx(self): return self._x\n"
87
"    def setx(self, value): self._x = value\n"
88
"    def delx(self): del self._x\n"
89
"    x = property(getx, setx, delx, \"I\'m the \'x\' property.\")\n"
90
"\n"
91
"Decorators make defining new properties or modifying existing ones easy:\n"
92
"\n"
93
"class C(object):\n"
94
"    @property\n"
95
"    def x(self):\n"
96
"        \"I am the \'x\' property.\"\n"
97
"        return self._x\n"
98
"    @x.setter\n"
99
"    def x(self, value):\n"
100
"        self._x = value\n"
101
"    @x.deleter\n"
102
"    def x(self):\n"
103
"        del self._x");
104
105
static int
106
property_init_impl(propertyobject *self, PyObject *fget, PyObject *fset,
107
                   PyObject *fdel, PyObject *doc);
108
109
static int
110
property_init(PyObject *self, PyObject *args, PyObject *kwargs)
111
2.38k
{
112
2.38k
    int return_value = -1;
113
2.38k
    #if defined(Py_BUILD_CORE) && !defined(Py_BUILD_CORE_MODULE)
114
115
2.38k
    #define NUM_KEYWORDS 4
116
2.38k
    static struct {
117
2.38k
        PyGC_Head _this_is_not_used;
118
2.38k
        PyObject_VAR_HEAD
119
2.38k
        Py_hash_t ob_hash;
120
2.38k
        PyObject *ob_item[NUM_KEYWORDS];
121
2.38k
    } _kwtuple = {
122
2.38k
        .ob_base = PyVarObject_HEAD_INIT(&PyTuple_Type, NUM_KEYWORDS)
123
2.38k
        .ob_hash = -1,
124
2.38k
        .ob_item = { &_Py_ID(fget), &_Py_ID(fset), &_Py_ID(fdel), &_Py_ID(doc), },
125
2.38k
    };
126
2.38k
    #undef NUM_KEYWORDS
127
2.38k
    #define KWTUPLE (&_kwtuple.ob_base.ob_base)
128
129
    #else  // !Py_BUILD_CORE
130
    #  define KWTUPLE NULL
131
    #endif  // !Py_BUILD_CORE
132
133
2.38k
    static const char * const _keywords[] = {"fget", "fset", "fdel", "doc", NULL};
134
2.38k
    static _PyArg_Parser _parser = {
135
2.38k
        .keywords = _keywords,
136
2.38k
        .fname = "property",
137
2.38k
        .kwtuple = KWTUPLE,
138
2.38k
    };
139
2.38k
    #undef KWTUPLE
140
2.38k
    PyObject *argsbuf[4];
141
2.38k
    PyObject * const *fastargs;
142
2.38k
    Py_ssize_t nargs = PyTuple_GET_SIZE(args);
143
2.38k
    Py_ssize_t noptargs = nargs + (kwargs ? PyDict_GET_SIZE(kwargs) : 0) - 0;
144
2.38k
    PyObject *fget = NULL;
145
2.38k
    PyObject *fset = NULL;
146
2.38k
    PyObject *fdel = NULL;
147
2.38k
    PyObject *doc = NULL;
148
149
2.38k
    fastargs = _PyArg_UnpackKeywords(_PyTuple_CAST(args)->ob_item, nargs, kwargs, NULL, &_parser,
150
2.38k
            /*minpos*/ 0, /*maxpos*/ 4, /*minkw*/ 0, /*varpos*/ 0, argsbuf);
151
2.38k
    if (!fastargs) {
152
0
        goto exit;
153
0
    }
154
2.38k
    if (!noptargs) {
155
0
        goto skip_optional_pos;
156
0
    }
157
2.38k
    if (fastargs[0]) {
158
2.38k
        fget = fastargs[0];
159
2.38k
        if (!--noptargs) {
160
2.14k
            goto skip_optional_pos;
161
2.14k
        }
162
2.38k
    }
163
237
    if (fastargs[1]) {
164
237
        fset = fastargs[1];
165
237
        if (!--noptargs) {
166
28
            goto skip_optional_pos;
167
28
        }
168
237
    }
169
209
    if (fastargs[2]) {
170
209
        fdel = fastargs[2];
171
209
        if (!--noptargs) {
172
2
            goto skip_optional_pos;
173
2
        }
174
209
    }
175
207
    doc = fastargs[3];
176
2.38k
skip_optional_pos:
177
2.38k
    return_value = property_init_impl((propertyobject *)self, fget, fset, fdel, doc);
178
179
2.38k
exit:
180
2.38k
    return return_value;
181
2.38k
}
182
/*[clinic end generated code: output=2e8df497abc4f915 input=a9049054013a1b77]*/