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