GeezerVison is showing github.com — cpython/Include/internal/pycore_importdl.h at main · python/cpython

Expand file tree

pycore_importdl.h

Copy path

More file actions

Latest commit

History

160 lines (135 loc) · 5.04 KB

pycore_importdl.h

Copy path

File metadata and controls

160 lines (135 loc) · 5.04 KB

Raw

Copy raw file

Download raw file

Open symbols panel

Edit and raw actions

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

#ifndef Py_INTERNAL_IMPORTDL_H

#define Py_INTERNAL_IMPORTDL_H

#include "patchlevel.h" // PY_MAJOR_VERSION

#ifdef __cplusplus

extern "C" {

#endif

#ifndef Py_BUILD_CORE

# error "this header requires Py_BUILD_CORE define"

#endif

extern const char *_PyImport_DynLoadFiletab[];

#ifdef HAVE_DYNAMIC_LOADING

/* ./configure sets HAVE_DYNAMIC_LOADING if dynamic loading of modules is

supported on this platform. configure will then compile and link in one

of the dynload_*.c files, as appropriate. We will call a function in

those modules to get a function pointer to the module's init function.

The function should return:

- The function pointer on success

- NULL with exception set if the library cannot be loaded

- NULL *without* an extension set if the library could be loaded but the

function cannot be found in it.

#ifdef MS_WINDOWS

#include <windows.h>

typedef FARPROC dl_funcptr;

extern dl_funcptr _PyImport_FindSharedFuncptrWindows(const char *prefix,

const char *shortname,

PyObject *pathname,

FILE *fp);

#else

typedef void (*dl_funcptr)(void);

extern dl_funcptr _PyImport_FindSharedFuncptr(const char *prefix,

const char *shortname,

const char *pathname, FILE *fp);

#endif

#endif /* HAVE_DYNAMIC_LOADING */

typedef enum ext_module_kind {

_Py_ext_module_kind_UNKNOWN = 0,

_Py_ext_module_kind_SINGLEPHASE = 1,

_Py_ext_module_kind_MULTIPHASE = 2,

_Py_ext_module_kind_INVALID = 3,

} _Py_ext_module_kind;

typedef enum ext_module_origin {

_Py_ext_module_origin_CORE = 1, // 'sys' & 'builtins'

_Py_ext_module_origin_BUILTIN = 2, // inittab or PyImport_CreateModuleFromInitfunc

_Py_ext_module_origin_DYNAMIC = 3, // loaded dynamically

} _Py_ext_module_origin;

struct hook_prefixes {

const char *const init_prefix;

const char *const export_prefix;

};

/* Input for loading an extension module. */

struct _Py_ext_module_loader_info {

PyObject *filename;

#ifndef MS_WINDOWS

PyObject *filename_encoded;

#endif

PyObject *name;

PyObject *name_encoded;

/* path is always a borrowed ref of name or filename,

* depending on if it's builtin or not. */

PyObject *path;

_Py_ext_module_origin origin;

const struct hook_prefixes *hook_prefixes;

const char *newcontext;

};

extern void _Py_ext_module_loader_info_clear(

struct _Py_ext_module_loader_info *info);

extern int _Py_ext_module_loader_info_init(

struct _Py_ext_module_loader_info *p_info,

PyObject *name,

PyObject *spec,

_Py_ext_module_origin origin);

/* The result from running an extension module's init function.

* Not used for modules defined via PyModExport (slots array).

struct _Py_ext_module_loader_result {

PyModuleDef *def;

PyObject *module;

_Py_ext_module_kind kind;

struct _Py_ext_module_loader_result_error *err;

struct _Py_ext_module_loader_result_error {

enum _Py_ext_module_loader_result_error_kind {

_Py_ext_module_loader_result_EXCEPTION = 0,

_Py_ext_module_loader_result_ERR_MISSING = 1,

_Py_ext_module_loader_result_ERR_UNREPORTED_EXC = 2,

_Py_ext_module_loader_result_ERR_UNINITIALIZED = 3,

_Py_ext_module_loader_result_ERR_NONASCII_NOT_MULTIPHASE = 4,

_Py_ext_module_loader_result_ERR_NOT_MODULE = 5,

_Py_ext_module_loader_result_ERR_MISSING_DEF = 6,

} kind;

PyObject *exc;

} _err;

};

extern void _Py_ext_module_loader_result_clear(

struct _Py_ext_module_loader_result *res);

extern void _Py_ext_module_loader_result_apply_error(

struct _Py_ext_module_loader_result *res,

const char *name);

/* The module init function. */

typedef PyObject *(*PyModInitFunction)(void);

typedef PySlot *(*PyModExportFunction)(void);

#ifdef HAVE_DYNAMIC_LOADING

extern int _PyImport_GetModuleExportHooks(

struct _Py_ext_module_loader_info *info,

FILE *fp, PyModInitFunction *modinit, PyModExportFunction *modexport);

#endif

extern int _PyImport_RunModInitFunc(

PyModInitFunction p0,

struct _Py_ext_module_loader_info *info,

struct _Py_ext_module_loader_result *p_res);

/* Max length of module suffix searched for -- accommodates "module.slb" */

#define MAXSUFFIXSIZE 12

#ifdef MS_WINDOWS

#ifdef Py_DEBUG

# define PYD_DEBUG_SUFFIX "_d"

#else

# define PYD_DEBUG_SUFFIX ""

#endif

#ifdef Py_GIL_DISABLED

# define PYD_THREADING_TAG "t"

#else

# define PYD_THREADING_TAG ""

#endif

#ifdef PYD_PLATFORM_TAG

# define PYD_SOABI "cp" Py_STRINGIFY(PY_MAJOR_VERSION) Py_STRINGIFY(PY_MINOR_VERSION) PYD_THREADING_TAG "-" PYD_PLATFORM_TAG

#else

# define PYD_SOABI "cp" Py_STRINGIFY(PY_MAJOR_VERSION) Py_STRINGIFY(PY_MINOR_VERSION) PYD_THREADING_TAG

#endif

#define PYD_TAGGED_SUFFIX PYD_DEBUG_SUFFIX "." PYD_SOABI ".pyd"

#define PYD_UNTAGGED_SUFFIX PYD_DEBUG_SUFFIX ".pyd"

#endif

#ifdef __cplusplus

}

#endif

#endif /* !Py_INTERNAL_IMPORTDL_H */