blob: b6e49333d2d9f146e02918aaef31df547adb327d [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00002/* Module object interface */
3
Fred Drake3cf4d2b2000-07-09 00:55:06 +00004#ifndef Py_MODULEOBJECT_H
5#define Py_MODULEOBJECT_H
6#ifdef __cplusplus
7extern "C" {
8#endif
9
Mark Hammond91a681d2002-08-12 07:21:58 +000010PyAPI_DATA(PyTypeObject) PyModule_Type;
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000011
Guido van Rossumb8755092001-09-10 18:21:59 +000012#define PyModule_Check(op) PyObject_TypeCheck(op, &PyModule_Type)
Christian Heimes90aa7642007-12-19 02:45:37 +000013#define PyModule_CheckExact(op) (Py_TYPE(op) == &PyModule_Type)
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000014
Serhiy Storchaka34d0ac82016-12-27 14:57:39 +020015#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000
Victor Stinner0639b562011-03-04 12:57:07 +000016PyAPI_FUNC(PyObject *) PyModule_NewObject(
17 PyObject *name
18 );
Serhiy Storchaka34d0ac82016-12-27 14:57:39 +020019#endif
Victor Stinnerd7e76402011-02-22 23:38:34 +000020PyAPI_FUNC(PyObject *) PyModule_New(
21 const char *name /* UTF-8 encoded string */
22 );
Mark Hammond91a681d2002-08-12 07:21:58 +000023PyAPI_FUNC(PyObject *) PyModule_GetDict(PyObject *);
Serhiy Storchaka34d0ac82016-12-27 14:57:39 +020024#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000
Victor Stinnerbd475112011-02-23 00:21:43 +000025PyAPI_FUNC(PyObject *) PyModule_GetNameObject(PyObject *);
Serhiy Storchaka34d0ac82016-12-27 14:57:39 +020026#endif
Neal Norwitz312e10d2007-08-26 02:21:42 +000027PyAPI_FUNC(const char *) PyModule_GetName(PyObject *);
28PyAPI_FUNC(const char *) PyModule_GetFilename(PyObject *);
Victor Stinner6c00c142010-08-17 23:37:11 +000029PyAPI_FUNC(PyObject *) PyModule_GetFilenameObject(PyObject *);
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000030#ifndef Py_LIMITED_API
Mark Hammond91a681d2002-08-12 07:21:58 +000031PyAPI_FUNC(void) _PyModule_Clear(PyObject *);
Serhiy Storchaka87a5c512014-02-10 18:21:34 +020032PyAPI_FUNC(void) _PyModule_ClearDict(PyObject *);
Martin v. Löwis4d0d4712010-12-03 20:14:31 +000033#endif
Martin v. Löwis1a214512008-06-11 05:26:20 +000034PyAPI_FUNC(struct PyModuleDef*) PyModule_GetDef(PyObject*);
35PyAPI_FUNC(void*) PyModule_GetState(PyObject*);
36
Yury Selivanovca829102015-06-02 19:06:47 -040037#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
38/* New in 3.5 */
Nick Coghland5cacbb2015-05-23 22:24:10 +100039PyAPI_FUNC(PyObject *) PyModuleDef_Init(struct PyModuleDef*);
Steve Dower11d7b142015-05-23 14:44:37 -070040PyAPI_DATA(PyTypeObject) PyModuleDef_Type;
Yury Selivanovca829102015-06-02 19:06:47 -040041#endif
Nick Coghland5cacbb2015-05-23 22:24:10 +100042
Martin v. Löwis1a214512008-06-11 05:26:20 +000043typedef struct PyModuleDef_Base {
44 PyObject_HEAD
45 PyObject* (*m_init)(void);
46 Py_ssize_t m_index;
47 PyObject* m_copy;
48} PyModuleDef_Base;
49
David Malcolm82e73cb2010-11-17 21:20:18 +000050#define PyModuleDef_HEAD_INIT { \
51 PyObject_HEAD_INIT(NULL) \
52 NULL, /* m_init */ \
53 0, /* m_index */ \
54 NULL, /* m_copy */ \
55 }
Martin v. Löwis1a214512008-06-11 05:26:20 +000056
Yury Selivanovca829102015-06-02 19:06:47 -040057struct PyModuleDef_Slot;
58#if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000
59/* New in 3.5 */
Nick Coghland5cacbb2015-05-23 22:24:10 +100060typedef struct PyModuleDef_Slot{
61 int slot;
62 void *value;
63} PyModuleDef_Slot;
64
Nick Coghland5cacbb2015-05-23 22:24:10 +100065#define Py_mod_create 1
66#define Py_mod_exec 2
67
68#ifndef Py_LIMITED_API
69#define _Py_mod_LAST_SLOT 2
70#endif
Guido van Rossuma3309961993-07-28 09:05:47 +000071
Yury Selivanovca829102015-06-02 19:06:47 -040072#endif /* New in 3.5 */
73
74typedef struct PyModuleDef{
75 PyModuleDef_Base m_base;
76 const char* m_name;
77 const char* m_doc;
78 Py_ssize_t m_size;
79 PyMethodDef *m_methods;
80 struct PyModuleDef_Slot* m_slots;
81 traverseproc m_traverse;
82 inquiry m_clear;
83 freefunc m_free;
Nick Coghlan8682f572016-08-21 17:41:56 +100084} PyModuleDef;
Yury Selivanovca829102015-06-02 19:06:47 -040085
Guido van Rossuma3309961993-07-28 09:05:47 +000086#ifdef __cplusplus
87}
88#endif
89#endif /* !Py_MODULEOBJECT_H */