psycopg2/INSTALL
Federico Di Gregorio 1af8b57706 ZPsycopgDA work.
2005-05-26 07:34:27 +00:00

78 lines
2.4 KiB
Plaintext

Compiling and installing psycopg
********************************
While psycopg 1.x used autoconf for its build process psycopg 2 switched to
the more pythoning setup.py. Currently both psycopg's author and distutils
have some limitations so the file setup.cfg is almost unused and most build
options are hidden in setup.py. Before building psycopg look at setup.cfg file
and change any settings to follow your system (or taste); then:
python setup.py build
to build in the local directory; and:
python setup.py install
to install system-wide.
Compiling under Windows with mingw32
************************************
You can compile psycopg under Windows platform with mingw32 compiler. The
software required is:
* MinGW (http://www.mingw.org/). You also get MinGW installed by installing
Dev-C++ IDE (http://www.bloodshed.net/devcpp.html);
* either:
* a binary PostgreSQL installation with include and libary files, at least
release 8.0 (http://www.postgresql.org/download/);
* PostgreSQL sources. You will need to compile PostgreSQL, which also
requires MSYS (http://www.mingw.org/msys.shtml) and Flex and Bison
packages (http://gnuwin32.sourceforge.net/packages.html).
I assume all the software installed in the standard way. gcc compiler directory
should be in your path.
Steps required to package your own version of psycopg:
1. if building from PostgreSQL binaries:
1.1. create the file libpqdll.a (you should already know how to build
Python extensions with mingw: see
http://starship.python.net/crew/kernr/mingw32/Notes.html for
details):
1.1.1. cd C:\Program Files\PostgreSQL\8.0\lib
1.1.2. pexports C:\WINNT\system32\libpq.dll > libpqdll.def
1.1.3. dlltool --dllname libpq.dll --def libpqdll.def \
--output-lib libpqdll.a
2. else, if building from PostgreSQL source:
2.1. compile it:
2.1.1. unpack postgresql source (ex. in c:\)
2.1.2. run MSYS
2.1.3. cd /c/postgresql-8.0
2.1.4. ./configure --without-zlib
2.1.5. make
2.2. create the file libpqdll.a (dlltool is part of MinGW):
2.2.1. cd postgresql-8.0\src\interfaces\libpq
2.2.2. dlltool --dllname libpq.dll --def libpqdll.def \
--output-lib libpqdll.a
3. build psycopg:
3.1. python setup.py build_ext --compiler=mingw32 install