|
1 #ifndef Py_SYMTABLE_H |
|
2 #define Py_SYMTABLE_H |
|
3 |
|
4 #ifdef __cplusplus |
|
5 extern "C" { |
|
6 #endif |
|
7 |
|
8 typedef enum _block_type { FunctionBlock, ClassBlock, ModuleBlock } |
|
9 _Py_block_ty; |
|
10 |
|
11 struct _symtable_entry; |
|
12 |
|
13 struct symtable { |
|
14 const char *st_filename; /* name of file being compiled */ |
|
15 struct _symtable_entry *st_cur; /* current symbol table entry */ |
|
16 struct _symtable_entry *st_top; /* module entry */ |
|
17 PyObject *st_symbols; /* dictionary of symbol table entries */ |
|
18 PyObject *st_stack; /* stack of namespace info */ |
|
19 PyObject *st_global; /* borrowed ref to MODULE in st_symbols */ |
|
20 int st_nblocks; /* number of blocks */ |
|
21 PyObject *st_private; /* name of current class or NULL */ |
|
22 int st_tmpname; /* temporary name counter */ |
|
23 PyFutureFeatures *st_future; /* module's future features */ |
|
24 }; |
|
25 |
|
26 typedef struct _symtable_entry { |
|
27 PyObject_HEAD |
|
28 PyObject *ste_id; /* int: key in st_symbols */ |
|
29 PyObject *ste_symbols; /* dict: name to flags */ |
|
30 PyObject *ste_name; /* string: name of block */ |
|
31 PyObject *ste_varnames; /* list of variable names */ |
|
32 PyObject *ste_children; /* list of child ids */ |
|
33 _Py_block_ty ste_type; /* module, class, or function */ |
|
34 int ste_unoptimized; /* false if namespace is optimized */ |
|
35 int ste_nested; /* true if block is nested */ |
|
36 unsigned ste_free : 1; /* true if block has free variables */ |
|
37 unsigned ste_child_free : 1; /* true if a child block has free vars, |
|
38 including free refs to globals */ |
|
39 unsigned ste_generator : 1; /* true if namespace is a generator */ |
|
40 unsigned ste_varargs : 1; /* true if block has varargs */ |
|
41 unsigned ste_varkeywords : 1; /* true if block has varkeywords */ |
|
42 unsigned ste_returns_value : 1; /* true if namespace uses return with |
|
43 an argument */ |
|
44 int ste_lineno; /* first line of block */ |
|
45 int ste_opt_lineno; /* lineno of last exec or import * */ |
|
46 int ste_tmpname; /* counter for listcomp temp vars */ |
|
47 struct symtable *ste_table; |
|
48 } PySTEntryObject; |
|
49 |
|
50 PyAPI_DATA(PyTypeObject) PySTEntry_Type; |
|
51 |
|
52 #define PySTEntry_Check(op) (Py_TYPE(op) == &PySTEntry_Type) |
|
53 |
|
54 PyAPI_FUNC(int) PyST_GetScope(PySTEntryObject *, PyObject *); |
|
55 |
|
56 PyAPI_FUNC(struct symtable *) PySymtable_Build(mod_ty, const char *, |
|
57 PyFutureFeatures *); |
|
58 PyAPI_FUNC(PySTEntryObject *) PySymtable_Lookup(struct symtable *, void *); |
|
59 |
|
60 PyAPI_FUNC(void) PySymtable_Free(struct symtable *); |
|
61 |
|
62 /* Flags for def-use information */ |
|
63 |
|
64 #define DEF_GLOBAL 1 /* global stmt */ |
|
65 #define DEF_LOCAL 2 /* assignment in code block */ |
|
66 #define DEF_PARAM 2<<1 /* formal parameter */ |
|
67 #define USE 2<<2 /* name is used */ |
|
68 #define DEF_STAR 2<<3 /* parameter is star arg */ |
|
69 #define DEF_DOUBLESTAR 2<<4 /* parameter is star-star arg */ |
|
70 #define DEF_INTUPLE 2<<5 /* name defined in tuple in parameters */ |
|
71 #define DEF_FREE 2<<6 /* name used but not defined in nested block */ |
|
72 #define DEF_FREE_GLOBAL 2<<7 /* free variable is actually implicit global */ |
|
73 #define DEF_FREE_CLASS 2<<8 /* free variable from class's method */ |
|
74 #define DEF_IMPORT 2<<9 /* assignment occurred via import */ |
|
75 |
|
76 #define DEF_BOUND (DEF_LOCAL | DEF_PARAM | DEF_IMPORT) |
|
77 |
|
78 /* GLOBAL_EXPLICIT and GLOBAL_IMPLICIT are used internally by the symbol |
|
79 table. GLOBAL is returned from PyST_GetScope() for either of them. |
|
80 It is stored in ste_symbols at bits 12-14. |
|
81 */ |
|
82 #define SCOPE_OFF 11 |
|
83 #define SCOPE_MASK 7 |
|
84 |
|
85 #define LOCAL 1 |
|
86 #define GLOBAL_EXPLICIT 2 |
|
87 #define GLOBAL_IMPLICIT 3 |
|
88 #define FREE 4 |
|
89 #define CELL 5 |
|
90 |
|
91 /* The following three names are used for the ste_unoptimized bit field */ |
|
92 #define OPT_IMPORT_STAR 1 |
|
93 #define OPT_EXEC 2 |
|
94 #define OPT_BARE_EXEC 4 |
|
95 #define OPT_TOPLEVEL 8 /* top-level names, including eval and exec */ |
|
96 |
|
97 #define GENERATOR 1 |
|
98 #define GENERATOR_EXPRESSION 2 |
|
99 |
|
100 #ifdef __cplusplus |
|
101 } |
|
102 #endif |
|
103 #endif /* !Py_SYMTABLE_H */ |