blob: 2d67f3e59bbecbb0f159f80523b1a7788370e45b [file] [log] [blame]
Guido van Rossumf70e43a1991-02-19 12:39:46 +00001
Fred Draked5c84ed2000-07-08 17:25:55 +00002#ifndef Py_MODSUPPORT_H
3#define Py_MODSUPPORT_H
4#ifdef __cplusplus
5extern "C" {
6#endif
7
Guido van Rossum85a5fbb1990-10-14 12:07:46 +00008/* Module support interface */
9
Guido van Rossumb6775db1994-08-01 11:34:53 +000010#include <stdarg.h>
11
Mark Hammond91a681d2002-08-12 07:21:58 +000012PyAPI_FUNC(int) PyArg_Parse(PyObject *, char *, ...);
13PyAPI_FUNC(int) PyArg_ParseTuple(PyObject *, char *, ...);
14PyAPI_FUNC(int) PyArg_ParseTupleAndKeywords(PyObject *, PyObject *,
Fred Draked5c84ed2000-07-08 17:25:55 +000015 char *, char **, ...);
Mark Hammond91a681d2002-08-12 07:21:58 +000016PyAPI_FUNC(int) PyArg_UnpackTuple(PyObject *, char *, int, int, ...);
17PyAPI_FUNC(PyObject *) Py_BuildValue(char *, ...);
Guido van Rossumb6775db1994-08-01 11:34:53 +000018
Mark Hammond91a681d2002-08-12 07:21:58 +000019PyAPI_FUNC(int) PyArg_VaParse(PyObject *, char *, va_list);
Brett Cannon711e7d92004-07-10 22:20:32 +000020PyAPI_FUNC(int) PyArg_VaParseTupleAndKeywords(PyObject *, PyObject *,
21 char *, char **, va_list);
Mark Hammond91a681d2002-08-12 07:21:58 +000022PyAPI_FUNC(PyObject *) Py_VaBuildValue(char *, va_list);
Guido van Rossume5372401993-03-16 12:15:04 +000023
Mark Hammond91a681d2002-08-12 07:21:58 +000024PyAPI_FUNC(int) PyModule_AddObject(PyObject *, char *, PyObject *);
25PyAPI_FUNC(int) PyModule_AddIntConstant(PyObject *, char *, long);
26PyAPI_FUNC(int) PyModule_AddStringConstant(PyObject *, char *, char *);
Fred Drake9e285152000-09-23 03:24:27 +000027
Guido van Rossum45ec02a2002-08-19 21:43:18 +000028#define PYTHON_API_VERSION 1012
29#define PYTHON_API_STRING "1012"
Guido van Rossum970a0a21995-01-09 17:47:20 +000030/* The API version is maintained (independently from the Python version)
31 so we can detect mismatches between the interpreter and dynamically
Thomas Wouters7e474022000-07-16 12:04:32 +000032 loaded modules. These are diagnosed by an error message but
Guido van Rossumae8a99e1996-07-30 16:41:02 +000033 the module is still loaded (because the mismatch can only be tested
34 after loading the module). The error message is intended to
35 explain the core dump a few seconds later.
Guido van Rossum970a0a21995-01-09 17:47:20 +000036
Guido van Rossum2ea0b061996-08-22 22:55:47 +000037 The symbol PYTHON_API_STRING defines the same value as a string
38 literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
39
Guido van Rossum970a0a21995-01-09 17:47:20 +000040 Please add a line or two to the top of this log for each API
41 version change:
42
Guido van Rossum45ec02a2002-08-19 21:43:18 +000043 19-Aug-2002 GvR 1012 Changes to string object struct for
44 interning changes, saving 3 bytes.
45
Tim Peters6d6c1a32001-08-02 04:15:00 +000046 17-Jul-2001 GvR 1011 Descr-branch, just to be on the safe side
47
Fred Drake73a3c8f2001-01-25 22:13:34 +000048 25-Jan-2001 FLD 1010 Parameters added to PyCode_New() and
49 PyFrame_New(); Python 2.1a2
50
Guido van Rossum21a50bd2000-03-29 01:46:45 +000051 14-Mar-2000 GvR 1009 Unicode API added
52
Guido van Rossumf1176c41999-01-03 12:40:24 +000053 3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
54
55 3-Dec-1998 GvR 1008 Python 1.5.2b1
Guido van Rossum7531d501998-12-03 18:18:12 +000056
57 18-Jan-1997 GvR 1007 string interning and other speedups
Guido van Rossumee5cf9b1997-01-18 07:54:03 +000058
Guido van Rossume449af71996-10-11 16:25:41 +000059 11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
60
Guido van Rossumae8a99e1996-07-30 16:41:02 +000061 30-Jul-1996 GvR Slice and ellipses syntax added
62
63 23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
64
Guido van Rossume0dbd591996-01-12 00:49:39 +000065 7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
66
Guido van Rossumcaa63801995-01-12 11:45:45 +000067 10-Jan-1995 GvR Renamed globals to new naming scheme
68
Guido van Rossum970a0a21995-01-09 17:47:20 +000069 9-Jan-1995 GvR Initial version (incompatible with older API)
70*/
71
Guido van Rossum2ea0b061996-08-22 22:55:47 +000072#ifdef MS_WINDOWS
Guido van Rossumb4cfdfa1997-09-29 23:29:08 +000073/* Special defines for Windows versions used to live here. Things
74 have changed, and the "Version" is now in a global string variable.
75 Reason for this is that this for easier branding of a "custom DLL"
76 without actually needing a recompile. */
Guido van Rossum2ea0b061996-08-22 22:55:47 +000077#endif /* MS_WINDOWS */
78
79#ifdef Py_TRACE_REFS
80/* When we are tracing reference counts, rename Py_InitModule4 so
81 modules compiled with incompatible settings will generate a
82 link-time error. */
83#define Py_InitModule4 Py_InitModule4TraceRefs
84#endif
85
Mark Hammond91a681d2002-08-12 07:21:58 +000086PyAPI_FUNC(PyObject *) Py_InitModule4(char *name, PyMethodDef *methods,
Fred Draked5c84ed2000-07-08 17:25:55 +000087 char *doc, PyObject *self,
88 int apiver);
89
Guido van Rossumcaa63801995-01-12 11:45:45 +000090#define Py_InitModule(name, methods) \
91 Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
92 PYTHON_API_VERSION)
Guido van Rossuma3309961993-07-28 09:05:47 +000093
Guido van Rossuma70d1601998-06-27 18:21:59 +000094#define Py_InitModule3(name, methods, doc) \
95 Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
96 PYTHON_API_VERSION)
97
Mark Hammond91a681d2002-08-12 07:21:58 +000098PyAPI_DATA(char *) _Py_PackageContext;
Guido van Rossumee6fd1c1997-11-19 18:51:35 +000099
Guido van Rossuma3309961993-07-28 09:05:47 +0000100#ifdef __cplusplus
101}
102#endif
103#endif /* !Py_MODSUPPORT_H */