Guido van Rossum | f70e43a | 1991-02-19 12:39:46 +0000 | [diff] [blame] | 1 | |
Guido van Rossum | 85a5fbb | 1990-10-14 12:07:46 +0000 | [diff] [blame] | 2 | /* Module definition and import interface */ |
| 3 | |
Fred Drake | 5eb6d4e | 2000-07-08 23:37:28 +0000 | [diff] [blame] | 4 | #ifndef Py_IMPORT_H |
| 5 | #define Py_IMPORT_H |
| 6 | #ifdef __cplusplus |
| 7 | extern "C" { |
| 8 | #endif |
Guido van Rossum | 34679b7 | 1993-01-26 13:33:44 +0000 | [diff] [blame] | 9 | |
Serhiy Storchaka | 9fab79b | 2016-09-11 11:03:14 +0300 | [diff] [blame] | 10 | #ifndef Py_LIMITED_API |
Victor Stinner | f7e5b56 | 2017-11-15 15:48:08 -0800 | [diff] [blame] | 11 | PyAPI_FUNC(_PyInitError) _PyImportZip_Init(void); |
Brett Cannon | fd07415 | 2012-04-14 14:10:13 -0400 | [diff] [blame] | 12 | |
Benjamin Peterson | c65ef77 | 2018-01-29 11:33:57 -0800 | [diff] [blame] | 13 | PyMODINIT_FUNC PyInit__imp(void); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 14 | #endif /* !Py_LIMITED_API */ |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 15 | PyAPI_FUNC(long) PyImport_GetMagicNumber(void); |
Barry Warsaw | 28a691b | 2010-04-17 00:19:56 +0000 | [diff] [blame] | 16 | PyAPI_FUNC(const char *) PyImport_GetMagicTag(void); |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 17 | PyAPI_FUNC(PyObject *) PyImport_ExecCodeModule( |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 18 | const char *name, /* UTF-8 encoded string */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 19 | PyObject *co |
| 20 | ); |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 21 | PyAPI_FUNC(PyObject *) PyImport_ExecCodeModuleEx( |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 22 | const char *name, /* UTF-8 encoded string */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 23 | PyObject *co, |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 24 | const char *pathname /* decoded from the filesystem encoding */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 25 | ); |
Barry Warsaw | 28a691b | 2010-04-17 00:19:56 +0000 | [diff] [blame] | 26 | PyAPI_FUNC(PyObject *) PyImport_ExecCodeModuleWithPathnames( |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 27 | const char *name, /* UTF-8 encoded string */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 28 | PyObject *co, |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 29 | const char *pathname, /* decoded from the filesystem encoding */ |
| 30 | const char *cpathname /* decoded from the filesystem encoding */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 31 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 32 | #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000 |
Victor Stinner | 27ee089 | 2011-03-04 12:57:09 +0000 | [diff] [blame] | 33 | PyAPI_FUNC(PyObject *) PyImport_ExecCodeModuleObject( |
| 34 | PyObject *name, |
| 35 | PyObject *co, |
| 36 | PyObject *pathname, |
| 37 | PyObject *cpathname |
| 38 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 39 | #endif |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 40 | PyAPI_FUNC(PyObject *) PyImport_GetModuleDict(void); |
Serhiy Storchaka | 4e29f56 | 2018-05-22 20:59:42 +0300 | [diff] [blame] | 41 | #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03070000 |
Eric Snow | 3f9eee6 | 2017-09-15 16:35:20 -0600 | [diff] [blame] | 42 | PyAPI_FUNC(PyObject *) PyImport_GetModule(PyObject *name); |
Serhiy Storchaka | 4e29f56 | 2018-05-22 20:59:42 +0300 | [diff] [blame] | 43 | #endif |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 44 | #ifndef Py_LIMITED_API |
| 45 | PyAPI_FUNC(int) _PyImport_IsInitialized(PyInterpreterState *); |
Eric Snow | 3f9eee6 | 2017-09-15 16:35:20 -0600 | [diff] [blame] | 46 | PyAPI_FUNC(PyObject *) _PyImport_GetModuleId(struct _Py_Identifier *name); |
| 47 | PyAPI_FUNC(PyObject *) _PyImport_AddModuleObject(PyObject *name, |
| 48 | PyObject *modules); |
| 49 | PyAPI_FUNC(int) _PyImport_SetModule(PyObject *name, PyObject *module); |
| 50 | PyAPI_FUNC(int) _PyImport_SetModuleString(const char *name, PyObject* module); |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 51 | #endif |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 52 | #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000 |
Victor Stinner | 27ee089 | 2011-03-04 12:57:09 +0000 | [diff] [blame] | 53 | PyAPI_FUNC(PyObject *) PyImport_AddModuleObject( |
| 54 | PyObject *name |
| 55 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 56 | #endif |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 57 | PyAPI_FUNC(PyObject *) PyImport_AddModule( |
| 58 | const char *name /* UTF-8 encoded string */ |
| 59 | ); |
| 60 | PyAPI_FUNC(PyObject *) PyImport_ImportModule( |
| 61 | const char *name /* UTF-8 encoded string */ |
| 62 | ); |
| 63 | PyAPI_FUNC(PyObject *) PyImport_ImportModuleNoBlock( |
| 64 | const char *name /* UTF-8 encoded string */ |
| 65 | ); |
| 66 | PyAPI_FUNC(PyObject *) PyImport_ImportModuleLevel( |
Benjamin Peterson | 04778a8 | 2011-05-25 09:29:00 -0500 | [diff] [blame] | 67 | const char *name, /* UTF-8 encoded string */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 68 | PyObject *globals, |
| 69 | PyObject *locals, |
| 70 | PyObject *fromlist, |
| 71 | int level |
| 72 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 73 | #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03050000 |
Victor Stinner | fe93faf | 2011-03-14 15:54:52 -0400 | [diff] [blame] | 74 | PyAPI_FUNC(PyObject *) PyImport_ImportModuleLevelObject( |
| 75 | PyObject *name, |
| 76 | PyObject *globals, |
| 77 | PyObject *locals, |
| 78 | PyObject *fromlist, |
| 79 | int level |
| 80 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 81 | #endif |
Thomas Wouters | f7f438b | 2006-02-28 16:09:29 +0000 | [diff] [blame] | 82 | |
Thomas Wouters | f7f438b | 2006-02-28 16:09:29 +0000 | [diff] [blame] | 83 | #define PyImport_ImportModuleEx(n, g, l, f) \ |
Brett Cannon | 522267e | 2012-08-10 18:55:08 -0400 | [diff] [blame] | 84 | PyImport_ImportModuleLevel(n, g, l, f, 0) |
Thomas Wouters | f7f438b | 2006-02-28 16:09:29 +0000 | [diff] [blame] | 85 | |
Christian Heimes | 9cd1775 | 2007-11-18 19:35:23 +0000 | [diff] [blame] | 86 | PyAPI_FUNC(PyObject *) PyImport_GetImporter(PyObject *path); |
Mark Hammond | 8235ea1 | 2002-07-19 06:55:41 +0000 | [diff] [blame] | 87 | PyAPI_FUNC(PyObject *) PyImport_Import(PyObject *name); |
| 88 | PyAPI_FUNC(PyObject *) PyImport_ReloadModule(PyObject *m); |
| 89 | PyAPI_FUNC(void) PyImport_Cleanup(void); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 90 | #if !defined(Py_LIMITED_API) || Py_LIMITED_API+0 >= 0x03030000 |
Victor Stinner | 53dc735 | 2011-03-20 01:50:21 +0100 | [diff] [blame] | 91 | PyAPI_FUNC(int) PyImport_ImportFrozenModuleObject( |
| 92 | PyObject *name |
| 93 | ); |
Serhiy Storchaka | 34d0ac8 | 2016-12-27 14:57:39 +0200 | [diff] [blame] | 94 | #endif |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 95 | PyAPI_FUNC(int) PyImport_ImportFrozenModule( |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 96 | const char *name /* UTF-8 encoded string */ |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 97 | ); |
Fred Drake | 5eb6d4e | 2000-07-08 23:37:28 +0000 | [diff] [blame] | 98 | |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 99 | #ifndef Py_LIMITED_API |
Benjamin Peterson | 0df35a9 | 2009-10-04 20:32:25 +0000 | [diff] [blame] | 100 | PyAPI_FUNC(void) _PyImport_AcquireLock(void); |
| 101 | PyAPI_FUNC(int) _PyImport_ReleaseLock(void); |
Benjamin Peterson | 0df35a9 | 2009-10-04 20:32:25 +0000 | [diff] [blame] | 102 | |
Guido van Rossum | 8ee3e5a | 2005-09-14 18:09:42 +0000 | [diff] [blame] | 103 | PyAPI_FUNC(void) _PyImport_ReInitLock(void); |
Raymond Hettinger | db29e0f | 2004-10-07 06:46:25 +0000 | [diff] [blame] | 104 | |
Victor Stinner | d860d5c | 2013-12-10 01:19:58 +0100 | [diff] [blame] | 105 | PyAPI_FUNC(PyObject *) _PyImport_FindBuiltin( |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 106 | const char *name, /* UTF-8 encoded string */ |
| 107 | PyObject *modules |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 108 | ); |
Victor Stinner | d860d5c | 2013-12-10 01:19:58 +0100 | [diff] [blame] | 109 | PyAPI_FUNC(PyObject *) _PyImport_FindExtensionObject(PyObject *, PyObject *); |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 110 | PyAPI_FUNC(PyObject *) _PyImport_FindExtensionObjectEx(PyObject *, PyObject *, |
| 111 | PyObject *); |
Victor Stinner | d860d5c | 2013-12-10 01:19:58 +0100 | [diff] [blame] | 112 | PyAPI_FUNC(int) _PyImport_FixupBuiltin( |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 113 | PyObject *mod, |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 114 | const char *name, /* UTF-8 encoded string */ |
| 115 | PyObject *modules |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 116 | ); |
Eric Snow | d393c1b | 2017-09-14 12:18:12 -0600 | [diff] [blame] | 117 | PyAPI_FUNC(int) _PyImport_FixupExtensionObject(PyObject*, PyObject *, |
| 118 | PyObject *, PyObject *); |
Guido van Rossum | 29e46a9 | 1997-08-02 02:56:48 +0000 | [diff] [blame] | 119 | |
Guido van Rossum | 39c2aae | 1996-05-22 17:25:28 +0000 | [diff] [blame] | 120 | struct _inittab { |
Serhiy Storchaka | c679227 | 2013-10-19 21:03:34 +0300 | [diff] [blame] | 121 | const char *name; /* ASCII encoded string */ |
Martin v. Löwis | 1a21451 | 2008-06-11 05:26:20 +0000 | [diff] [blame] | 122 | PyObject* (*initfunc)(void); |
Guido van Rossum | 39c2aae | 1996-05-22 17:25:28 +0000 | [diff] [blame] | 123 | }; |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 124 | PyAPI_DATA(struct _inittab *) PyImport_Inittab; |
| 125 | PyAPI_FUNC(int) PyImport_ExtendInittab(struct _inittab *newtab); |
| 126 | #endif /* Py_LIMITED_API */ |
Guido van Rossum | 39c2aae | 1996-05-22 17:25:28 +0000 | [diff] [blame] | 127 | |
Christian Heimes | 9cd1775 | 2007-11-18 19:35:23 +0000 | [diff] [blame] | 128 | PyAPI_DATA(PyTypeObject) PyNullImporter_Type; |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 129 | |
Victor Stinner | d7e7640 | 2011-02-22 23:38:34 +0000 | [diff] [blame] | 130 | PyAPI_FUNC(int) PyImport_AppendInittab( |
| 131 | const char *name, /* ASCII encoded string */ |
| 132 | PyObject* (*initfunc)(void) |
| 133 | ); |
Guido van Rossum | 16926bd | 1998-06-29 20:34:46 +0000 | [diff] [blame] | 134 | |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 135 | #ifndef Py_LIMITED_API |
Guido van Rossum | 4ee68d9 | 1996-06-17 17:05:01 +0000 | [diff] [blame] | 136 | struct _frozen { |
Benjamin Peterson | 7701e6e | 2013-03-13 14:06:39 -0500 | [diff] [blame] | 137 | const char *name; /* ASCII encoded string */ |
| 138 | const unsigned char *code; |
Fred Drake | 5eb6d4e | 2000-07-08 23:37:28 +0000 | [diff] [blame] | 139 | int size; |
Guido van Rossum | 4ee68d9 | 1996-06-17 17:05:01 +0000 | [diff] [blame] | 140 | }; |
| 141 | |
| 142 | /* Embedding apps may change this pointer to point to their favorite |
| 143 | collection of frozen modules: */ |
| 144 | |
Benjamin Peterson | 7701e6e | 2013-03-13 14:06:39 -0500 | [diff] [blame] | 145 | PyAPI_DATA(const struct _frozen *) PyImport_FrozenModules; |
Martin v. Löwis | 4d0d471 | 2010-12-03 20:14:31 +0000 | [diff] [blame] | 146 | #endif |
Guido van Rossum | 4ee68d9 | 1996-06-17 17:05:01 +0000 | [diff] [blame] | 147 | |
Guido van Rossum | a330996 | 1993-07-28 09:05:47 +0000 | [diff] [blame] | 148 | #ifdef __cplusplus |
| 149 | } |
| 150 | #endif |
| 151 | #endif /* !Py_IMPORT_H */ |