Update changelog
[joel/debian/python-sqlite.git] / INSTALL.win32
1 ===========================
2 Building PySQLite on Windows
3 ============================
4
5 On Windows, Python's distutils defaults to the Visual C++ compiler from
6 Microsoft. If you want to use other compilers for compiling Python extensions
7 on Windows, look into chapter 3.1 "Using non-Microsoft compilers on Windows" in
8 the "Installing Python Modules" of your Python documentation. It's available
9 online at http://www.python.org/doc/current/inst/non-ms-compilers.html 
10
11 The following are build instructions for the GNU C compiler, Borland C++ and
12 for Microsoft's Visual C++ environment.
13
14
15 ========================
16 Using the GNU C compiler
17 ========================
18
19 As you have read the Python documentation for non-Microsoft compilers by now,
20 you have mingw or Cygwin installed and created the required import library for
21 the Python DLL. Fine, let's continue.
22
23 From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
24 sqlitedll.zip files. Unpack them all in the same directory.
25
26 Create an import library for the GNU linker:
27
28 $ dlltool --def sqlite.def --dllname sqlite.dll --output-lib libsqlite.a
29
30 Unpack the PySQLite sources and open setup.py in your editor. Search for
31 "win32". Change the include_dirs and library_dirs variable to point the place
32 where you've unpacked the SQLite files and where you created the import
33 library.
34
35 Build PySQLite:
36
37 $ python setup.py build --compiler=mingw32
38
39
40 ==========================
41 Using the Borland compiler
42 ==========================
43
44 As you have read the Python documentation for non-Microsoft compilers by now,
45 you have installed the Borland C++ compiler and created the required import
46 library for the Python DLL. Fine, let's continue.
47
48 From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
49 sqlitedll.zip files. Unpack them all in the same directory.
50
51 Create an import library for the Borland linker:
52
53 $ implib -a sqlite.lib sqlite.dll 
54
55 Unpack the PySQLite sources and open setup.py in your editor. Search for
56 "win32". Change the include_dirs and library_dirs variable to point the place
57 where you've unpacked the SQLite files and where you created the import
58 library.
59
60 Build PySQLite:
61
62 $ python setup.py build --compiler=bcpp
63
64
65 ==========================
66 Using Microsoft Visual C++
67 ==========================
68
69 From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
70 sqlitedll.zip files. Unpack them all in the same directory.
71
72 Create an import library for the Microsoft linker:
73
74 $ lib /def:sqlite.def
75
76 Unpack the PySQLite sources and open setup.py in your editor. Search for
77 "win32". Change the include_dirs and library_dirs variable to point the place
78 where you've unpacked the SQLite files and where you created the import
79 library.
80
81 Build PySQLite:
82
83 $ python setup.py build
84
85
86 ==================================
87 What to do after building pySQLite
88 ==================================
89
90 - Make sure the sqlite.dll can be found. Either copy it into your system
91   directory, somewhere else in your PATH or in the same directory as the .pyd
92   file from pySQLite.
93
94 - Run the included test suite with these or similar commands:
95   $ copy ..\sqlite\sqlite.dll build\lib.win32-2.2 
96   $ copy test\*.py build\lib.win32-2.2
97   $ cd build\lib.win32-2.2
98   $ python all_tests.py
99
100   All the tests should pass. If something goes wrong, report it to the pySQLite
101   developers using the Sourceforge bug tracker.
102
103 - Install pySQLite:
104   $ python setup.py install
105
106   Again make sure the sqlite.dll can be found
107