blob: 50aecbe85893dce32fdd2b5e3536a7e6f7617469 [file] [log] [blame]
Guido van Rossuma3309961993-07-28 09:05:47 +00001#ifndef Py_MODSUPPORT_H
2#define Py_MODSUPPORT_H
3#ifdef __cplusplus
4extern "C" {
5#endif
6
Guido van Rossumf70e43a1991-02-19 12:39:46 +00007/***********************************************************
Guido van Rossum5799b521995-01-04 19:06:22 +00008Copyright 1991-1995 by Stichting Mathematisch Centrum, Amsterdam,
9The Netherlands.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000010
11 All Rights Reserved
12
Guido van Rossumd266eb41996-10-25 14:44:06 +000013Permission to use, copy, modify, and distribute this software and its
14documentation for any purpose and without fee is hereby granted,
Guido van Rossumf70e43a1991-02-19 12:39:46 +000015provided that the above copyright notice appear in all copies and that
Guido van Rossumd266eb41996-10-25 14:44:06 +000016both that copyright notice and this permission notice appear in
Guido van Rossumf70e43a1991-02-19 12:39:46 +000017supporting documentation, and that the names of Stichting Mathematisch
Guido van Rossumd266eb41996-10-25 14:44:06 +000018Centrum or CWI or Corporation for National Research Initiatives or
19CNRI not be used in advertising or publicity pertaining to
20distribution of the software without specific, written prior
21permission.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000022
Guido van Rossumd266eb41996-10-25 14:44:06 +000023While CWI is the initial source for this software, a modified version
24is made available by the Corporation for National Research Initiatives
25(CNRI) at the Internet address ftp://ftp.python.org.
26
27STICHTING MATHEMATISCH CENTRUM AND CNRI DISCLAIM ALL WARRANTIES WITH
28REGARD TO THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF
29MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL STICHTING MATHEMATISCH
30CENTRUM OR CNRI BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL
31DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
32PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER
33TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
34PERFORMANCE OF THIS SOFTWARE.
Guido van Rossumf70e43a1991-02-19 12:39:46 +000035
36******************************************************************/
37
Guido van Rossum85a5fbb1990-10-14 12:07:46 +000038/* Module support interface */
39
Guido van Rossumb6775db1994-08-01 11:34:53 +000040#ifdef HAVE_STDARG_PROTOTYPES
41
42#include <stdarg.h>
43
Guido van Rossum43466ec1998-12-04 18:48:25 +000044extern DL_IMPORT(int) PyArg_Parse Py_PROTO((PyObject *, char *, ...));
45extern DL_IMPORT(int) PyArg_ParseTuple Py_PROTO((PyObject *, char *, ...));
46extern DL_IMPORT(int) PyArg_ParseTupleAndKeywords Py_PROTO((PyObject *, PyObject *,
Guido van Rossum36280a71997-02-14 16:36:35 +000047 char *, char **, ...));
Guido van Rossum43466ec1998-12-04 18:48:25 +000048extern DL_IMPORT(PyObject *) Py_BuildValue Py_PROTO((char *, ...));
Guido van Rossumb6775db1994-08-01 11:34:53 +000049
50#else
51
52#include <varargs.h>
53
54/* Better to have no prototypes at all for varargs functions in this case */
Guido van Rossum43466ec1998-12-04 18:48:25 +000055extern DL_IMPORT(int) PyArg_Parse();
56extern DL_IMPORT(int) PyArg_ParseTuple();
57extern DL_IMPORT(PyObject *) Py_BuildValue();
Guido van Rossumb6775db1994-08-01 11:34:53 +000058
Guido van Rossume5372401993-03-16 12:15:04 +000059#endif
60
Guido van Rossum43466ec1998-12-04 18:48:25 +000061extern DL_IMPORT(int) PyArg_VaParse Py_PROTO((PyObject *, char *, va_list));
62extern DL_IMPORT(PyObject *) Py_VaBuildValue Py_PROTO((char *, va_list));
Guido van Rossume5372401993-03-16 12:15:04 +000063
Guido van Rossum21a50bd2000-03-29 01:46:45 +000064#define PYTHON_API_VERSION 1009
65#define PYTHON_API_STRING "1009"
Guido van Rossum970a0a21995-01-09 17:47:20 +000066/* The API version is maintained (independently from the Python version)
67 so we can detect mismatches between the interpreter and dynamically
Guido van Rossumae8a99e1996-07-30 16:41:02 +000068 loaded modules. These are diagnosticised by an error message but
69 the module is still loaded (because the mismatch can only be tested
70 after loading the module). The error message is intended to
71 explain the core dump a few seconds later.
Guido van Rossum970a0a21995-01-09 17:47:20 +000072
Guido van Rossum2ea0b061996-08-22 22:55:47 +000073 The symbol PYTHON_API_STRING defines the same value as a string
74 literal. *** PLEASE MAKE SURE THE DEFINITIONS MATCH. ***
75
Guido van Rossum970a0a21995-01-09 17:47:20 +000076 Please add a line or two to the top of this log for each API
77 version change:
78
Guido van Rossum21a50bd2000-03-29 01:46:45 +000079 14-Mar-2000 GvR 1009 Unicode API added
80
Guido van Rossumf1176c41999-01-03 12:40:24 +000081 3-Jan-1999 GvR 1007 Decided to change back! (Don't reuse 1008!)
82
83 3-Dec-1998 GvR 1008 Python 1.5.2b1
Guido van Rossum7531d501998-12-03 18:18:12 +000084
85 18-Jan-1997 GvR 1007 string interning and other speedups
Guido van Rossumee5cf9b1997-01-18 07:54:03 +000086
Guido van Rossume449af71996-10-11 16:25:41 +000087 11-Oct-1996 GvR renamed Py_Ellipses to Py_Ellipsis :-(
88
Guido van Rossumae8a99e1996-07-30 16:41:02 +000089 30-Jul-1996 GvR Slice and ellipses syntax added
90
91 23-Jul-1996 GvR For 1.4 -- better safe than sorry this time :-)
92
Guido van Rossume0dbd591996-01-12 00:49:39 +000093 7-Nov-1995 GvR Keyword arguments (should've been done at 1.3 :-( )
94
Guido van Rossumcaa63801995-01-12 11:45:45 +000095 10-Jan-1995 GvR Renamed globals to new naming scheme
96
Guido van Rossum970a0a21995-01-09 17:47:20 +000097 9-Jan-1995 GvR Initial version (incompatible with older API)
98*/
99
Guido van Rossum2ea0b061996-08-22 22:55:47 +0000100#ifdef MS_WINDOWS
Guido van Rossumb4cfdfa1997-09-29 23:29:08 +0000101/* Special defines for Windows versions used to live here. Things
102 have changed, and the "Version" is now in a global string variable.
103 Reason for this is that this for easier branding of a "custom DLL"
104 without actually needing a recompile. */
Guido van Rossum2ea0b061996-08-22 22:55:47 +0000105#endif /* MS_WINDOWS */
106
107#ifdef Py_TRACE_REFS
108/* When we are tracing reference counts, rename Py_InitModule4 so
109 modules compiled with incompatible settings will generate a
110 link-time error. */
111#define Py_InitModule4 Py_InitModule4TraceRefs
112#endif
113
Guido van Rossum43466ec1998-12-04 18:48:25 +0000114extern DL_IMPORT(PyObject *) Py_InitModule4 Py_PROTO((char *, PyMethodDef *,
Guido van Rossumcaa63801995-01-12 11:45:45 +0000115 char *, PyObject *, int));
116#define Py_InitModule(name, methods) \
117 Py_InitModule4(name, methods, (char *)NULL, (PyObject *)NULL, \
118 PYTHON_API_VERSION)
Guido van Rossuma3309961993-07-28 09:05:47 +0000119
Guido van Rossuma70d1601998-06-27 18:21:59 +0000120#define Py_InitModule3(name, methods, doc) \
121 Py_InitModule4(name, methods, doc, (PyObject *)NULL, \
122 PYTHON_API_VERSION)
123
Guido van Rossum43466ec1998-12-04 18:48:25 +0000124extern DL_IMPORT(char *) _Py_PackageContext;
Guido van Rossumee6fd1c1997-11-19 18:51:35 +0000125
Guido van Rossuma3309961993-07-28 09:05:47 +0000126#ifdef __cplusplus
127}
128#endif
129#endif /* !Py_MODSUPPORT_H */