2
# The file Setup is used by the makesetup script to construct the files
3
# Makefile and config.c, from Makefile.pre and config.c.in,
4
# respectively. The file Setup itself is initially copied from
5
# Setup.dist; once it exists it will not be overwritten, so you can edit
6
# Setup to your heart's content. Note that Makefile.pre is created
7
# from Makefile.pre.in by the toplevel configure script.
9
# (VPATH notes: Setup and Makefile.pre are in the build directory, as
10
# are Makefile and config.c; the *.in and *.dist files are in the source
13
# Each line in this file describes one or more optional modules.
14
# Modules enabled here will not be compiled by the setup.py script,
15
# so the file can be used to override setup.py's behavior.
17
# Lines have the following structure:
19
# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
21
# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
22
# <cpparg> is anything starting with -I, -D, -U or -C
23
# <library> is anything ending in .a or beginning with -l or -L
24
# <module> is anything else but should be a valid Python
25
# identifier (letters, digits, underscores, beginning with non-digit)
27
# (As the makesetup script changes, it may recognize some other
28
# arguments as well, e.g. *.so and *.sl as libraries. See the big
29
# case statement in the makesetup script.)
31
# Lines can also have the form
35
# which defines a Make variable definition inserted into Makefile.in
37
# Finally, if a line contains just the word "*shared*" (without the
38
# quotes but with the stars), then the following modules will not be
39
# built statically. The build process works like this:
41
# 1. Build all modules that are declared as static in Modules/Setup,
42
# combine them into libpythonxy.a, combine that into python.
43
# 2. Build all modules that are listed as shared in Modules/Setup.
44
# 3. Invoke setup.py. That builds all modules that
45
# a) are not builtin, and
46
# b) are not listed in Modules/Setup, and
47
# c) can be build on the target
49
# Therefore, modules declared to be shared will not be
50
# included in the config.c file, nor in the list of objects to be
51
# added to the library archive, and their linker options won't be
52
# added to the linker options. Rules to create their .o files and
53
# their shared libraries will still be added to the Makefile, and
54
# their names will be collected in the Make variable SHAREDMODS. This
55
# is used to build modules as shared libraries. (They can be
56
# installed using "make sharedinstall", which is implied by the
57
# toplevel "make install" target.) (For compatibility,
58
# *noconfig* has the same effect as *shared*.)
60
# In addition, *static* explicitly declares the following modules to
61
# be static. Lines containing "*static*" and "*shared*" may thus
62
# alternate throughout this file.
64
# NOTE: As a standard policy, as many modules as can be supported by a
65
# platform should be present. The distribution comes with all modules
66
# enabled that are supported by most platforms and don't require you
67
# to ftp sources from elsewhere.
70
# Some special rules to define PYTHONPATH.
71
# Edit the definitions below to indicate which options you are using.
72
# Don't add any whitespace or comments!
74
# Directories where library files get installed.
75
# DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
77
MACHDESTLIB=$(BINLIBDEST)
79
# NOTE: all the paths are now relative to the prefix that is computed
82
# Standard path -- don't edit.
83
# No leading colon since this is the first entry.
84
# Empty since this is now just the runtime prefix.
87
# Site specific path components -- should begin with : if non-empty
90
# Standard path components for test modules
93
# Path components for machine- or system-dependent modules and shared libraries
94
MACHDEPPATH=:$(PLATDIR)
97
COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)$(MACHDEPPATH)$(EXTRAMACHDEPPATH)
98
PYTHONPATH=$(COREPYTHONPATH)
101
# The modules listed here can't be built as shared libraries for
102
# various reasons; therefore they are listed here instead of in the
105
# This only contains the minimal set of modules required to run the
106
# setup.py script in the root of the Python source tree.
108
posix posixmodule.c # posix (UNIX) system calls
109
errno errnomodule.c # posix (UNIX) errno values
110
pwd pwdmodule.c # this is needed to find out the user's home dir
111
# if $HOME is not set
112
_sre _sre.c # Fredrik Lundh's new regular expressions
113
_codecs _codecsmodule.c # access to the builtin codecs and codec registry
114
_weakref _weakref.c # weak references
115
_functools _functoolsmodule.c # Tools for working with functions and callable objects
116
_operator _operator.c # operator.add() and similar goodies
117
_collections _collectionsmodule.c # Container types
118
itertools itertoolsmodule.c # Functions creating iterators for efficient looping
119
atexit atexitmodule.c # Register functions to be run at interpreter-shutdown
120
_stat _stat.c # stat.h interface
121
time timemodule.c # -lm # time operations and variables
123
# access to ISO C locale support
124
_locale _localemodule.c # -lintl
126
# Standard I/O baseline
127
_io -I$(srcdir)/Modules/_io _io/_iomodule.c _io/iobase.c _io/fileio.c _io/bytesio.c _io/bufferedio.c _io/textio.c _io/stringio.c
129
# The zipimport module is always imported at startup. Having it as a
130
# builtin module avoids some bootstrapping problems and reduces overhead.
131
zipimport zipimport.c
133
# faulthandler module
134
faulthandler faulthandler.c
136
# debug tool to trace memory blocks allocated by Python
137
_tracemalloc _tracemalloc.c hashtable.c
139
# The rest of the modules listed in this file are all commented out by
140
# default. Usually they can be detected and built as dynamically
141
# loaded modules by the new setup.py script added in Python 2.1. If
142
# you're on a platform that doesn't support dynamic loading, want to
143
# compile modules statically into the Python binary, or need to
144
# specify some odd set of compiler switches, you can uncomment the
145
# appropriate lines below.
147
# ======================================================================
149
# The Python symtable module depends on .h files that setup.py doesn't track
150
_symtable symtablemodule.c
152
# Uncommenting the following line tells makesetup that all following
153
# modules are to be built as shared libraries (see above for more
154
# detail; also note that *static* reverses this effect):
158
# GNU readline. Unlike previous Python incarnations, GNU readline is
159
# now incorporated in an optional module, configured in the Setup file
160
# instead of by a configure script switch. You may have to insert a
161
# -L option pointing to the directory where libreadline.* lives,
162
# and you may have to change -ltermcap to -ltermlib or perhaps remove
163
# it, depending on your system -- see the GNU readline instructions.
164
# It's okay for this to be a shared library, too.
166
#readline readline.c -lreadline -ltermcap
169
# Modules that should always be present (non UNIX dependent):
171
#array arraymodule.c # array objects
172
#cmath cmathmodule.c _math.c # -lm # complex math library functions
173
#math mathmodule.c _math.c # -lm # math library functions, e.g. sin()
174
#_struct _struct.c # binary structure packing/unpacking
175
#_weakref _weakref.c # basic weak reference support
176
#_testcapi _testcapimodule.c # Python C API test module
177
#_random _randommodule.c # Random number generator
178
#_elementtree _elementtree.c -lexpat # elementtree accelerator
179
#_pickle _pickle.c # pickle accelerator
180
#_datetime _datetimemodule.c # datetime accelerator
181
#_bisect _bisectmodule.c # Bisection algorithms
182
#_heapq _heapqmodule.c # Heap queue algorithm
184
#unicodedata unicodedata.c # static Unicode character database
187
# Modules with some UNIX dependencies -- on by default:
188
# (If you have a really backward UNIX, select and socket may not be
191
#fcntl fcntlmodule.c # fcntl(2) and ioctl(2)
192
#spwd spwdmodule.c # spwd(3)
193
#grp grpmodule.c # grp(3)
194
#select selectmodule.c # select(2); not on ancient System V
196
# Memory-mapped files (also works on Win32).
202
# Socket module helper for socket(2)
203
#_socket socketmodule.c
205
# Socket module helper for SSL support; you must comment out the other
206
# socket line above, and possibly edit the SSL variable:
207
#_ssl _ssl.c -lssl -lcrypto
209
# The crypt module is now disabled by default because it breaks builds
210
# on many systems (where -lcrypt is needed), e.g. Linux (I believe).
212
# First, look at Setup.config; configure may have set this for you.
214
#_crypt _cryptmodule.c # -lcrypt # crypt(3); needs -lcrypt on some systems
217
# Some more UNIX dependent modules -- off by default, since these
218
# are not supported by all UNIX systems:
220
#nis nismodule.c -lnsl # Sun yellow pages -- not everywhere
221
#termios termios.c # Steen Lumholt's termios module
222
#resource resource.c # Jeremy Hylton's rlimit interface
224
#_posixsubprocess _posixsubprocess.c # POSIX subprocess module helper
226
# Multimedia modules -- off by default.
227
# These don't work for 64-bit platforms!!!
228
# #993173 says audioop works on 64-bit platforms, though.
229
# These represent audio samples or images as strings:
231
#audioop audioop.c # Operations on audio samples
234
# Note that the _md5 and _sha modules are normally only built if the
235
# system does not have the OpenSSL libs containing an optimized version.
237
# The _md5 module implements the RSA Data Security, Inc. MD5
238
# Message-Digest Algorithm, described in RFC 1321.
243
# The _sha module implements the SHA checksum algorithms.
244
# (NIST's Secure Hash Algorithms.)
246
#_sha256 sha256module.c
247
#_sha512 sha512module.c
249
#_hashlib _hashopenssl.c -lssl -lcrypto
251
# The _tkinter module.
253
# The command for _tkinter is long and site specific. Please
254
# uncomment and/or edit those parts as indicated. If you don't have a
255
# specific extension (e.g. Tix or BLT), leave the corresponding line
256
# commented out. (Leave the trailing backslashes in! If you
257
# experience strange errors, you may want to join all uncommented
258
# lines and remove the backslashes -- the backslash interpretation is
259
# done by the shell's "read" command and it may not be implemented on
262
# *** Always uncomment this (leave the leading underscore in!):
263
# _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
264
# *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
266
# *** Uncomment and edit to reflect where your Tcl/Tk headers are:
267
# -I/usr/local/include \
268
# *** Uncomment and edit to reflect where your X11 header files are:
269
# -I/usr/X11R6/include \
270
# *** Or uncomment this for Solaris:
271
# -I/usr/openwin/include \
272
# *** Uncomment and edit for Tix extension only:
273
# -DWITH_TIX -ltix8.1.8.2 \
274
# *** Uncomment and edit for BLT extension only:
275
# -DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
276
# *** Uncomment and edit for PIL (TkImaging) extension only:
277
# (See http://www.pythonware.com/products/pil/ for more info)
278
# -DWITH_PIL -I../Extensions/Imaging/libImaging tkImaging.c \
279
# *** Uncomment and edit for TOGL extension only:
280
# -DWITH_TOGL togl.c \
281
# *** Uncomment and edit to reflect your Tcl/Tk versions:
283
# *** Uncomment and edit to reflect where your X11 libraries are:
285
# *** Or uncomment this for Solaris:
286
# -L/usr/openwin/lib \
287
# *** Uncomment these for TOGL extension only:
288
# -lGL -lGLU -lXext -lXmu \
289
# *** Uncomment for AIX:
291
# *** Always uncomment this; X11 libraries to link with:
294
# Lance Ellinghaus's syslog module
295
#syslog syslogmodule.c # syslog daemon interface
298
# Curses support, requiring the System V version of curses, often
299
# provided by the ncurses library. e.g. on Linux, link with -lncurses
300
# instead of -lcurses).
302
# First, look at Setup.config; configure may have set this for you.
304
#_curses _cursesmodule.c -lcurses -ltermcap
305
# Wrapper for the panel library that's part of ncurses and SYSV curses.
306
#_curses_panel _curses_panel.c -lpanel -lncurses
309
# Modules that provide persistent dictionary-like semantics. You will
310
# probably want to arrange for at least one of them to be available on
311
# your machine, though none are defined by default because of library
312
# dependencies. The Python module dbm/__init__.py provides an
313
# implementation independent wrapper for these; dbm/dumb.py provides
314
# similar functionality (but slower of course) implemented in Python.
316
# The standard Unix dbm module has been moved to Setup.config so that
317
# it will be compiled as a shared library by default. Compiling it as
318
# a built-in module causes conflicts with the pybsddb3 module since it
319
# creates a static dependency on an out-of-date version of db.so.
321
# First, look at Setup.config; configure may have set this for you.
323
#_dbm _dbmmodule.c # dbm(3) may require -lndbm or similar
325
# Anthony Baxter's gdbm module. GNU dbm(3) will require -lgdbm:
327
# First, look at Setup.config; configure may have set this for you.
329
#_gdbm _gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
332
# Helper module for various ascii-encoders
335
# Fred Drake's interface to the Python parser
336
#parser parsermodule.c
338
#_ctypes _ctypes/_ctypes.c _ctypes/callbacks.c _ctypes/callproc.c _ctypes/stgdict.c _ctypes/cfield.c _ctypes/malloc_closure.c -lffi
340
# Lee Busby's SIGFPE modules.
341
# The library to link fpectl with is platform specific.
342
# Choose *one* of the options below for fpectl:
344
# For SGI IRIX (tested on 5.3):
345
#fpectl fpectlmodule.c -lfpe
347
# For Solaris with SunPro compiler (tested on Solaris 2.5 with SunPro C 4.2):
348
# (Without the compiler you don't have -lsunmath.)
349
#fpectl fpectlmodule.c -R/opt/SUNWspro/lib -lsunmath -lm
351
# For other systems: see instructions in fpectlmodule.c.
352
#fpectl fpectlmodule.c ...
354
# Test module for fpectl. No extra libraries needed.
355
#fpetest fpetestmodule.c
357
# Andrew Kuchling's zlib module.
358
# This require zlib 1.1.3 (or later).
359
# See http://www.gzip.org/zlib/
360
#zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz
362
# Interface to the Expat XML parser
364
# Expat was written by James Clark and is now maintained by a group of
365
# developers on SourceForge; see www.libexpat.org for more
366
# information. The pyexpat module was written by Paul Prescod after a
367
# prototype by Jack Jansen. Source of Expat 1.95.2 is included in
368
# Modules/expat/. Usage of a system shared libexpat.so/expat.dll is
371
# More information on Expat can be found at www.libexpat.org.
373
#pyexpat pyexpat.c -lexpat
375
# Hye-Shik Chang's CJKCodecs
377
# multibytecodec is required for all the other CJK codec modules
378
#_multibytecodec cjkcodecs/multibytecodec.c
380
#_codecs_cn cjkcodecs/_codecs_cn.c
381
#_codecs_hk cjkcodecs/_codecs_hk.c
382
#_codecs_iso2022 cjkcodecs/_codecs_iso2022.c
383
#_codecs_jp cjkcodecs/_codecs_jp.c
384
#_codecs_kr cjkcodecs/_codecs_kr.c
385
#_codecs_tw cjkcodecs/_codecs_tw.c
387
# Example -- included for reference only:
390
# Another example -- the 'xxsubtype' module shows C-level subtyping in action
391
xxsubtype xxsubtype.c