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