1
# Universal Unix Makefile for Python extensions
2
# =============================================
7
# 1. Build and install Python (1.5 or newer).
8
# 2. "make -f Makefile.pre.in boot"
10
# You should now have a shared library.
15
# Build *and install* the basic Python 1.5 distribution. See the
16
# Python README for instructions. (This version of Makefile.pre.in
17
# only withs with Python 1.5, alpha 3 or newer.)
19
# Create a file Setup.in for your extension. This file follows the
20
# format of the Modules/Setup.in file; see the instructions there.
21
# For a simple module called "spam" on file "spammodule.c", it can
22
# contain a single line:
24
# You can build as many modules as you want in the same directory --
25
# just have a separate line for each of them in the Setup.in file.
27
# If you want to build your extension as a shared library, insert a
28
# line containing just the string
30
# at the top of your Setup.in file.
32
# Note that the build process copies Setup.in to Setup, and then works
33
# with Setup. It doesn't overwrite Setup when Setup.in is changed, so
34
# while you're in the process of debugging your Setup.in file, you may
35
# want to edit Setup instead, and copy it back to Setup.in later.
36
# (All this is done so you can distribute your extension easily and
37
# someone else can select the modules they actually want to build by
38
# commenting out lines in the Setup file, without editing the
39
# original. Editing Setup is also used to specify nonstandard
40
# locations for include or library files.)
42
# Copy this file (Misc/Makefile.pre.in) to the directory containing
45
# Run "make -f Makefile.pre.in boot". This creates Makefile
46
# (producing Makefile.pre and sedscript as intermediate files) and
47
# config.c, incorporating the values for sys.prefix, sys.exec_prefix
48
# and sys.version from the installed Python binary. For this to work,
49
# the python binary must be on your path. If this fails, try
50
# make -f Makefile.pre.in Makefile VERSION=1.5 installdir=<prefix>
51
# where <prefix> is the prefix used to install Python for installdir
52
# (and possibly similar for exec_installdir=<exec_prefix>).
54
# Note: "make boot" implies "make clobber" -- it assumes that when you
55
# bootstrap you may have changed platforms so it removes all previous
58
# If you are building your extension as a shared library (your
59
# Setup.in file starts with *shared*), run "make" or "make sharedmods"
60
# to build the shared library files. If you are building a statically
61
# linked Python binary (the only solution of your platform doesn't
62
# support shared libraries, and sometimes handy if you want to
63
# distribute or install the resulting Python binary), run "make
66
# Note: Each time you edit Makefile.pre.in or Setup, you must run
67
# "make Makefile" before running "make".
69
# Hint: if you want to use VPATH, you can start in an empty
70
# subdirectory and say (e.g.):
71
# make -f ../Makefile.pre.in boot srcdir=.. VPATH=..
74
# === Bootstrap variables (edited through "make boot") ===
76
# The prefix used by "make inclinstall libainstall" of core python
77
installdir= /depot/sundry/
79
# The exec_prefix used by the same
80
exec_installdir=$(installdir)
82
# Source directory and VPATH in case you want to use VPATH.
83
# (You will have to edit these two lines yourself -- there is no
84
# automatic support as the Makefile is not generated by
89
# === Variables that you may want to customize (rarely) ===
91
# (Static) build target
94
# Installed python binary (used only by boot target)
97
# Add more -I and -D options here
98
CFLAGS= $(OPT) -I$(INCLUDEPY) -I$(EXECINCLUDEPY) $(DEFS)
100
# These two variables can be set in Setup to merge extensions.
105
# Modes for directories, executables and data files created by the
106
# install process. Default to group-writable directories but
107
# user-only-writable for executables and data files.
112
# Portable install script (configure doesn't always guess right)
113
INSTALL= @srcdir@/install-sh -c
114
INSTALL_PROGRAM=${INSTALL} -m $(EXEMODE)
115
INSTALL_DATA= ${INSTALL} -m $(FILEMODE)
117
# === Variables set by makesetup ===
122
# === Definitions added by makesetup ===
124
# === Variables from configure (through sedscript) ===
142
LINKFORSHARED= @LINKFORSHARED@
145
# Install prefix for architecture-independent files
148
# Install prefix for architecture-dependent files
149
exec_prefix= $(prefix)
151
# === Fixed definitions ===
153
# Shell used by make (some versions default to the login shell, which is bad)
156
# Expanded directories
157
BINDIR= $(exec_installdir)/bin
158
LIBDIR= $(exec_prefix)/lib
159
MANDIR= $(installdir)/man
160
INCLUDEDIR= $(installdir)/include
161
SCRIPTDIR= $(prefix)/lib
163
# Detailed destination directories
164
BINLIBDEST= $(LIBDIR)/python$(VERSION)
165
LIBDEST= $(SCRIPTDIR)/python$(VERSION)
166
INCLUDEPY= $(INCLUDEDIR)/python$(VERSION)
167
EXECINCLUDEPY= $(exec_installdir)/include/python$(VERSION)
168
LIBP= $(exec_installdir)/lib/python$(VERSION)
169
DESTSHARED= $(BINLIBDEST)/site-packages
171
LIBPL= $(LIBP)/config
173
PYTHONLIBS= $(LIBPL)/libpython$(VERSION).a
175
MAKESETUP= $(LIBPL)/makesetup
176
MAKEFILE= $(LIBPL)/Makefile
177
CONFIGC= $(LIBPL)/config.c
178
CONFIGCIN= $(LIBPL)/config.c.in
179
SETUP= $(LIBPL)/Setup
181
SYSLIBS= $(LIBM) $(LIBC)
183
ADDOBJS= $(LIBPL)/python.o config.o
185
# Portable install script (configure doesn't always guess right)
186
INSTALL= $(LIBPL)/install-sh -c
187
# Shared libraries must be installed with executable mode on some systems;
188
# rather than figuring out exactly which, we always give them executable mode.
189
# Also, making them read-only seems to be a good idea...
190
INSTALL_SHARED= ${INSTALL} -m 555
192
# === Fixed rules ===
194
# Default target. This builds shared libraries only
201
# Build shared libraries from our extension modules
202
sharedmods: $(SHAREDMODS)
204
# Build a static Python binary containing our extension modules
206
$(TARGET): $(ADDOBJS) lib.a $(PYTHONLIBS) Makefile $(BASELIB)
207
$(LINKCC) $(LDFLAGS) $(LINKFORSHARED) \
208
$(ADDOBJS) lib.a $(PYTHONLIBS) \
209
$(LINKPATH) $(BASELIB) $(MODLIBS) $(LIBS) $(SYSLIBS) \
210
-o $(TARGET) $(LDLAST)
212
# Build the library containing our extension modules
215
ar cr lib.a $(MODOBJS)
218
# This runs makesetup *twice* to use the BASESETUP definition from Setup
219
config.c Makefile: Makefile.pre Setup $(BASESETUP) $(MAKESETUP)
221
-m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP)
222
$(MAKE) -f Makefile do-it-again
224
# Internal target to run makesetup for the second time
227
-m Makefile.pre -c $(CONFIGCIN) Setup -n $(BASESETUP) $(SETUP)
229
# Make config.o from the config.c created by makesetup
231
$(CC) $(CFLAGS) -c config.c
233
# Setup is copied from Setup.in *only* if it doesn't yet exist
235
cp $(srcdir)/Setup.in Setup
237
# Make the intermediate Makefile.pre from Makefile.pre.in
238
Makefile.pre: Makefile.pre.in sedscript
239
sed -f sedscript $(srcdir)/Makefile.pre.in >Makefile.pre
241
# Shortcuts to make the sed arguments on one line
244
H=Generated automatically from Makefile.pre.in by sedscript.
247
# Make the sed script used to create Makefile.pre from Makefile.pre.in
248
sedscript: $(MAKEFILE)
252
-e '/^VERSION=/s/^VERSION=[ ]*\(.*\)/s%@VERSION[@]%\1%/p' \
253
-e '/^CC=/s/^CC=[ ]*\(.*\)/s%@CC[@]%\1%/p' \
254
-e '/^CCC=/s/^CCC=[ ]*\(.*\)/s%#@SET_CCC[@]%CCC=\1%/p' \
255
-e '/^LINKCC=/s/^LINKCC=[ ]*\(.*\)/s%@LINKCC[@]%\1%/p' \
256
-e '/^SGI_ABI=/s/^SGI_ABI=[ ]*\(.*\)/s%@SGI_ABI[@]%\1%/p' \
257
-e '/^OPT=/s/^OPT=[ ]*\(.*\)/s%@OPT[@]%\1%/p' \
258
-e '/^LDFLAGS=/s/^LDFLAGS=[ ]*\(.*\)/s%@LDFLAGS[@]%\1%/p' \
259
-e '/^LDLAST=/s/^LDLAST=[ ]*\(.*\)/s%@LDLAST[@]%\1%/p' \
260
-e '/^DEFS=/s/^DEFS=[ ]*\(.*\)/s%@DEFS[@]%\1%/p' \
261
-e '/^LIBS=/s/^LIBS=[ ]*\(.*\)/s%@LIBS[@]%\1%/p' \
262
-e '/^LIBM=/s/^LIBM=[ ]*\(.*\)/s%@LIBM[@]%\1%/p' \
263
-e '/^LIBC=/s/^LIBC=[ ]*\(.*\)/s%@LIBC[@]%\1%/p' \
264
-e '/^RANLIB=/s/^RANLIB=[ ]*\(.*\)/s%@RANLIB[@]%\1%/p' \
265
-e '/^MACHDEP=/s/^MACHDEP=[ ]*\(.*\)/s%@MACHDEP[@]%\1%/p' \
266
-e '/^SO=/s/^SO=[ ]*\(.*\)/s%@SO[@]%\1%/p' \
267
-e '/^LDSHARED=/s/^LDSHARED=[ ]*\(.*\)/s%@LDSHARED[@]%\1%/p' \
268
-e '/^CCSHARED=/s/^CCSHARED=[ ]*\(.*\)/s%@CCSHARED[@]%\1%/p' \
269
-e '/^$L=/s/^$L=[ ]*\(.*\)/s%@$L[@]%\1%/p' \
270
-e '/^$P=/s/^$P=\(.*\)/s%^$P=.*%$P=\1%/p' \
271
-e '/^$E=/s/^$E=\(.*\)/s%^$E=.*%$E=\1%/p' \
272
$(MAKEFILE) >sedscript
273
echo "/^#@SET_CCC@/d" >>sedscript
274
echo "/^installdir=/s%=.*%= $(installdir)%" >>sedscript
275
echo "/^exec_installdir=/s%=.*%=$(exec_installdir)%" >>sedscript
276
echo "/^srcdir=/s%=.*%= $(srcdir)%" >>sedscript
277
echo "/^VPATH=/s%=.*%= $(VPATH)%" >>sedscript
278
echo "/^LINKPATH=/s%=.*%= $(LINKPATH)%" >>sedscript
279
echo "/^BASELIB=/s%=.*%= $(BASELIB)%" >>sedscript
280
echo "/^BASESETUP=/s%=.*%= $(BASESETUP)%" >>sedscript
284
VERSION=`$(PYTHON) -c "import sys; print sys.version[:3]"`; \
285
installdir=`$(PYTHON) -c "import sys; print sys.prefix"`; \
286
exec_installdir=`$(PYTHON) -c "import sys; print sys.exec_prefix"`; \
287
$(MAKE) -f $(srcdir)/Makefile.pre.in VPATH=$(VPATH) srcdir=$(srcdir) \
289
installdir=$$installdir \
290
exec_installdir=$$exec_installdir \
293
# Handy target to remove intermediate files and backups
296
rm -f `find . -name '*.pyc'`
297
rm -f `find . -name '*.o'`
298
rm -f `find . -name '*~'`
300
# Handy target to remove everything that is easily regenerated
302
-rm -f *.a tags TAGS config.c Makefile.pre $(TARGET) sedscript
303
-rm -f *.so *.sl so_locations
305
# Handy target to remove everything you don't want to distribute
310
# Create directories, if required
311
if test ! -d $(DESTSHARED) ; then \
312
mkdir $(DESTSHARED) ; else true ; fi