Setup 13.8 KB
Newer Older
1
# -*- makefile -*-
2 3
# The file Setup is used by the makesetup script to construct the files
# Makefile and config.c, from Makefile.pre and config.c.in,
4 5
# respectively.  Note that Makefile.pre is created from Makefile.pre.in
# by the toplevel configure script.
6 7

# (VPATH notes: Setup and Makefile.pre are in the build directory, as
8
# are Makefile and config.c; the *.in files are in the source directory.)
9

10
# Each line in this file describes one or more optional modules.
11
# Modules configured here will not be compiled by the setup.py script,
12
# so the file can be used to override setup.py's behavior.
13 14 15 16 17 18 19 20 21
# Tag lines containing just the word "*static*", "*shared*" or "*disabled*"
# (without the quotes but with the stars) are used to tag the following module
# descriptions. Tag lines may alternate throughout this file.  Modules are
# built statically when they are preceded by a "*static*" tag line or when
# there is no tag line between the start of the file and the module
# description.  Modules are built as a shared library when they are preceded by
# a "*shared*" tag line.  Modules are not built at all, not by the Makefile,
# nor by the setup.py script, when they are preceded by a "*disabled*" tag
# line.
22

23 24
# Lines have the following structure:
#
25
# <module> ... [<sourcefile> ...] [<cpparg> ...] [<library> ...]
26
#
27
# <sourcefile> is anything ending in .c (.C, .cc, .c++ are C++ files)
28 29 30 31 32
# <cpparg> is anything starting with -I, -D, -U or -C
# <library> is anything ending in .a or beginning with -l or -L
# <module> is anything else but should be a valid Python
# identifier (letters, digits, underscores, beginning with non-digit)
#
33 34 35 36
# (As the makesetup script changes, it may recognize some other
# arguments as well, e.g. *.so and *.sl as libraries.  See the big
# case statement in the makesetup script.)
#
37 38 39 40 41
# Lines can also have the form
#
# <name> = <value>
#
# which defines a Make variable definition inserted into Makefile.in
42
#
43
# The build process works like this:
44 45 46 47 48 49 50 51 52 53
#
# 1. Build all modules that are declared as static in Modules/Setup,
#    combine them into libpythonxy.a, combine that into python.
# 2. Build all modules that are listed as shared in Modules/Setup.
# 3. Invoke setup.py. That builds all modules that
#    a) are not builtin, and
#    b) are not listed in Modules/Setup, and
#    c) can be build on the target
#
# Therefore, modules declared to be shared will not be
54 55
# included in the config.c file, nor in the list of objects to be
# added to the library archive, and their linker options won't be
56
# added to the linker options. Rules to create their .o files and
57 58
# their shared libraries will still be added to the Makefile, and
# their names will be collected in the Make variable SHAREDMODS.  This
59 60 61
# is used to build modules as shared libraries.  (They can be
# installed using "make sharedinstall", which is implied by the
# toplevel "make install" target.)  (For compatibility,
62
# *noconfig* has the same effect as *shared*.)
63
#
64 65 66
# NOTE: As a standard policy, as many modules as can be supported by a
# platform should be present.  The distribution comes with all modules
# enabled that are supported by most platforms and don't require you
67
# to ftp sources from elsewhere.
68 69


70 71 72 73
# Some special rules to define PYTHONPATH.
# Edit the definitions below to indicate which options you are using.
# Don't add any whitespace or comments!

74 75 76 77
# Directories where library files get installed.
# DESTLIB is for Python modules; MACHDESTLIB for shared libraries.
DESTLIB=$(LIBDEST)
MACHDESTLIB=$(BINLIBDEST)
78

79 80 81
# NOTE: all the paths are now relative to the prefix that is computed
# at run time!

82
# Standard path -- don't edit.
83 84 85
# No leading colon since this is the first entry.
# Empty since this is now just the runtime prefix.
DESTPATH=
86

87 88 89 90
# Site specific path components -- should begin with : if non-empty
SITEPATH=

# Standard path components for test modules
91
TESTPATH=
92

93
COREPYTHONPATH=$(DESTPATH)$(SITEPATH)$(TESTPATH)
94
PYTHONPATH=$(COREPYTHONPATH)
95 96


97 98 99 100
# The modules listed here can't be built as shared libraries for
# various reasons; therefore they are listed here instead of in the
# normal order.

101
# This only contains the minimal set of modules required to run the
102
# setup.py script in the root of the Python source tree.
103

104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120
posix -DPy_BUILD_CORE posixmodule.c	# posix (UNIX) system calls
errno errnomodule.c			# posix (UNIX) errno values
pwd pwdmodule.c				# this is needed to find out the user's home dir
					# if $HOME is not set
_sre _sre.c				# Fredrik Lundh's new regular expressions
_codecs _codecsmodule.c			# access to the builtin codecs and codec registry
_weakref _weakref.c			# weak references
_functools -DPy_BUILD_CORE _functoolsmodule.c   # Tools for working with functions and callable objects
_operator _operator.c	        	# operator.add() and similar goodies
_collections _collectionsmodule.c	# Container types
_abc _abc.c				# Abstract base classes
itertools itertoolsmodule.c		# Functions creating iterators for efficient looping
atexit atexitmodule.c			# Register functions to be run at interpreter-shutdown
_signal -DPy_BUILD_CORE signalmodule.c
_stat _stat.c				# stat.h interface
time -DPy_BUILD_CORE timemodule.c	# -lm # time operations and variables
_thread -DPy_BUILD_CORE _threadmodule.c	# low-level threading interface
121 122 123

# access to ISO C locale support
_locale _localemodule.c  # -lintl
124 125

# Standard I/O baseline
126
_io -DPy_BUILD_CORE -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
127

128 129 130
# faulthandler module
faulthandler faulthandler.c

131 132 133
# debug tool to trace memory blocks allocated by Python
_tracemalloc _tracemalloc.c hashtable.c

134 135 136
# The rest of the modules listed in this file are all commented out by
# default.  Usually they can be detected and built as dynamically
# loaded modules by the new setup.py script added in Python 2.1.  If
137 138 139
# you're on a platform that doesn't support dynamic loading, want to
# compile modules statically into the Python binary, or need to
# specify some odd set of compiler switches, you can uncomment the
140 141 142 143
# appropriate lines below.

# ======================================================================

144 145 146
# The Python symtable module depends on .h files that setup.py doesn't track
_symtable symtablemodule.c

147 148
# Uncommenting the following line tells makesetup that all following
# modules are to be built as shared libraries (see above for more
149
# detail; also note that *static* or *disabled* cancels this effect):
150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166

#*shared*

# GNU readline.  Unlike previous Python incarnations, GNU readline is
# now incorporated in an optional module, configured in the Setup file
# instead of by a configure script switch.  You may have to insert a
# -L option pointing to the directory where libreadline.* lives,
# and you may have to change -ltermcap to -ltermlib or perhaps remove
# it, depending on your system -- see the GNU readline instructions.
# It's okay for this to be a shared library, too.

#readline readline.c -lreadline -ltermcap


# Modules that should always be present (non UNIX dependent):

#array arraymodule.c	# array objects
167
#cmath cmathmodule.c _math.c # -lm # complex math library functions
168
#math mathmodule.c _math.c # -lm # math library functions, e.g. sin()
169
#_contextvars _contextvarsmodule.c  # Context Variables
170
#_struct _struct.c	# binary structure packing/unpacking
171
#_weakref _weakref.c	# basic weak reference support
172
#_testcapi _testcapimodule.c    # Python C API test module
173
#_random _randommodule.c	# Random number generator
174
#_elementtree -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI _elementtree.c	# elementtree accelerator
175
#_pickle _pickle.c	# pickle accelerator
176
#_datetime _datetimemodule.c	# datetime accelerator
177
#_bisect _bisectmodule.c	# Bisection algorithms
178
#_heapq _heapqmodule.c	# Heap queue algorithm
179
#_asyncio _asynciomodule.c  # Fast asyncio Future
180

181
#unicodedata unicodedata.c    # static Unicode character database
182 183 184 185 186 187 188


# Modules with some UNIX dependencies -- on by default:
# (If you have a really backward UNIX, select and socket may not be
# supported...)

#fcntl fcntlmodule.c	# fcntl(2) and ioctl(2)
189
#spwd spwdmodule.c		# spwd(3)
190 191 192 193 194 195
#grp grpmodule.c		# grp(3)
#select selectmodule.c	# select(2); not on ancient System V

# Memory-mapped files (also works on Win32).
#mmap mmapmodule.c

Skip Montanaro's avatar
Skip Montanaro committed
196 197 198
# CSV file helper
#_csv _csv.c

199
# Socket module helper for socket(2)
200 201
#_socket socketmodule.c

202
# Socket module helper for SSL support; you must comment out the other
203 204
# socket line above, and possibly edit the SSL variable:
#SSL=/usr/local/ssl
205
#_ssl _ssl.c \
206 207 208 209 210 211
#	-DUSE_SSL -I$(SSL)/include -I$(SSL)/include/openssl \
#	-L$(SSL)/lib -lssl -lcrypto

# The crypt module is now disabled by default because it breaks builds
# on many systems (where -lcrypt is needed), e.g. Linux (I believe).

212
#_crypt _cryptmodule.c # -lcrypt	# crypt(3); needs -lcrypt on some systems
213 214 215 216 217 218 219 220 221


# Some more UNIX dependent modules -- off by default, since these
# are not supported by all UNIX systems:

#nis nismodule.c -lnsl	# Sun yellow pages -- not everywhere
#termios termios.c	# Steen Lumholt's termios module
#resource resource.c	# Jeremy Hylton's rlimit interface

222
#_posixsubprocess _posixsubprocess.c  # POSIX subprocess module helper
223 224 225

# Multimedia modules -- off by default.
# These don't work for 64-bit platforms!!!
226
# #993173 says audioop works on 64-bit platforms, though.
227 228 229 230 231
# These represent audio samples or images as strings:

#audioop audioop.c	# Operations on audio samples


232 233 234 235
# Note that the _md5 and _sha modules are normally only built if the
# system does not have the OpenSSL libs containing an optimized version.

# The _md5 module implements the RSA Data Security, Inc. MD5
236
# Message-Digest Algorithm, described in RFC 1321.
237

238
#_md5 md5module.c
239 240


Georg Brandl's avatar
Georg Brandl committed
241 242
# The _sha module implements the SHA checksum algorithms.
# (NIST's Secure Hash Algorithms.)
243
#_sha1 sha1module.c
Georg Brandl's avatar
Georg Brandl committed
244 245
#_sha256 sha256module.c
#_sha512 sha512module.c
246
#_sha3 _sha3/sha3module.c
247

248 249
# _blake module
#_blake2 _blake2/blake2module.c _blake2/blake2b_impl.c _blake2/blake2s_impl.c
250 251 252 253 254 255 256 257 258 259 260 261 262 263

# The _tkinter module.
#
# The command for _tkinter is long and site specific.  Please
# uncomment and/or edit those parts as indicated.  If you don't have a
# specific extension (e.g. Tix or BLT), leave the corresponding line
# commented out.  (Leave the trailing backslashes in!  If you
# experience strange errors, you may want to join all uncommented
# lines and remove the backslashes -- the backslash interpretation is
# done by the shell's "read" command and it may not be implemented on
# every system.

# *** Always uncomment this (leave the leading underscore in!):
# _tkinter _tkinter.c tkappinit.c -DWITH_APPINIT \
264 265
# *** Uncomment and edit to reflect where your Tcl/Tk libraries are:
#	-L/usr/local/lib \
266 267 268 269 270 271 272
# *** Uncomment and edit to reflect where your Tcl/Tk headers are:
#	-I/usr/local/include \
# *** Uncomment and edit to reflect where your X11 header files are:
#	-I/usr/X11R6/include \
# *** Or uncomment this for Solaris:
#	-I/usr/openwin/include \
# *** Uncomment and edit for Tix extension only:
273
#	-DWITH_TIX -ltix8.1.8.2 \
274 275 276 277 278 279 280 281
# *** Uncomment and edit for BLT extension only:
#	-DWITH_BLT -I/usr/local/blt/blt8.0-unoff/include -lBLT8.0 \
# *** Uncomment and edit for PIL (TkImaging) extension only:
#     (See http://www.pythonware.com/products/pil/ for more info)
#	-DWITH_PIL -I../Extensions/Imaging/libImaging  tkImaging.c \
# *** Uncomment and edit for TOGL extension only:
#	-DWITH_TOGL togl.c \
# *** Uncomment and edit to reflect your Tcl/Tk versions:
282
#	-ltk8.2 -ltcl8.2 \
283 284 285 286 287 288 289 290 291 292 293
# *** Uncomment and edit to reflect where your X11 libraries are:
#	-L/usr/X11R6/lib \
# *** Or uncomment this for Solaris:
#	-L/usr/openwin/lib \
# *** Uncomment these for TOGL extension only:
#	-lGL -lGLU -lXext -lXmu \
# *** Uncomment for AIX:
#	-lld \
# *** Always uncomment this; X11 libraries to link with:
#	-lX11

294
# Lance Ellinghaus's syslog module
295 296 297
#syslog syslogmodule.c		# syslog daemon interface


Florent Xicluna's avatar
Florent Xicluna committed
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).
301 302 303

#_curses _cursesmodule.c -lcurses -ltermcap
# Wrapper for the panel library that's part of ncurses and SYSV curses.
304
#_curses_panel _curses_panel.c -lpanel -lncurses
305 306 307 308 309


# Modules that provide persistent dictionary-like semantics.  You will
# probably want to arrange for at least one of them to be available on
# your machine, though none are defined by default because of library
310 311
# dependencies.  The Python module dbm/__init__.py provides an
# implementation independent wrapper for these; dbm/dumb.py provides
312 313
# similar functionality (but slower of course) implemented in Python.

314
#_dbm _dbmmodule.c 	# dbm(3) may require -lndbm or similar
315 316 317

# Anthony Baxter's gdbm module.  GNU dbm(3) will require -lgdbm:

318
#_gdbm _gdbmmodule.c -I/usr/local/include -L/usr/local/lib -lgdbm
319 320 321 322 323 324 325 326 327 328 329


# Helper module for various ascii-encoders
#binascii binascii.c

# Fred Drake's interface to the Python parser
#parser parsermodule.c


# Andrew Kuchling's zlib module.
# This require zlib 1.1.3 (or later).
330
# See http://www.gzip.org/zlib/
331 332 333
#zlib zlibmodule.c -I$(prefix)/include -L$(exec_prefix)/lib -lz

# Interface to the Expat XML parser
334
# More information on Expat can be found at www.libexpat.org.
335
#
336
#pyexpat expat/xmlparse.c expat/xmlrole.c expat/xmltok.c pyexpat.c -I$(srcdir)/Modules/expat -DHAVE_EXPAT_CONFIG_H -DUSE_PYEXPAT_CAPI
337 338 339 340 341 342

# Hye-Shik Chang's CJKCodecs

# multibytecodec is required for all the other CJK codec modules
#_multibytecodec cjkcodecs/multibytecodec.c

343 344 345 346 347 348
#_codecs_cn cjkcodecs/_codecs_cn.c
#_codecs_hk cjkcodecs/_codecs_hk.c
#_codecs_iso2022 cjkcodecs/_codecs_iso2022.c
#_codecs_jp cjkcodecs/_codecs_jp.c
#_codecs_kr cjkcodecs/_codecs_kr.c
#_codecs_tw cjkcodecs/_codecs_tw.c
349

350 351 352
# Example -- included for reference only:
# xx xxmodule.c

353 354
# Another example -- the 'xxsubtype' module shows C-level subtyping in action
xxsubtype xxsubtype.c
355 356 357 358 359 360 361 362

# Uncommenting the following line tells makesetup that all following modules
# are not built (see above for more detail).
#
#*disabled*
#
#_sqlite3 _tkinter _curses pyexpat
#_codecs_jp _codecs_kr _codecs_tw unicodedata