summaryrefslogtreecommitdiff
path: root/INSTALL.win32
diff options
context:
space:
mode:
Diffstat (limited to 'INSTALL.win32')
-rw-r--r--INSTALL.win32107
1 files changed, 107 insertions, 0 deletions
diff --git a/INSTALL.win32 b/INSTALL.win32
new file mode 100644
index 0000000..01f6e70
--- /dev/null
+++ b/INSTALL.win32
@@ -0,0 +1,107 @@
+===========================
+Building PySQLite on Windows
+============================
+
+On Windows, Python's distutils defaults to the Visual C++ compiler from
+Microsoft. If you want to use other compilers for compiling Python extensions
+on Windows, look into chapter 3.1 "Using non-Microsoft compilers on Windows" in
+the "Installing Python Modules" of your Python documentation. It's available
+online at http://www.python.org/doc/current/inst/non-ms-compilers.html
+
+The following are build instructions for the GNU C compiler, Borland C++ and
+for Microsoft's Visual C++ environment.
+
+
+========================
+Using the GNU C compiler
+========================
+
+As you have read the Python documentation for non-Microsoft compilers by now,
+you have mingw or Cygwin installed and created the required import library for
+the Python DLL. Fine, let's continue.
+
+From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
+sqlitedll.zip files. Unpack them all in the same directory.
+
+Create an import library for the GNU linker:
+
+$ dlltool --def sqlite.def --dllname sqlite.dll --output-lib libsqlite.a
+
+Unpack the PySQLite sources and open setup.py in your editor. Search for
+"win32". Change the include_dirs and library_dirs variable to point the place
+where you've unpacked the SQLite files and where you created the import
+library.
+
+Build PySQLite:
+
+$ python setup.py build --compiler=mingw32
+
+
+==========================
+Using the Borland compiler
+==========================
+
+As you have read the Python documentation for non-Microsoft compilers by now,
+you have installed the Borland C++ compiler and created the required import
+library for the Python DLL. Fine, let's continue.
+
+From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
+sqlitedll.zip files. Unpack them all in the same directory.
+
+Create an import library for the Borland linker:
+
+$ implib -a sqlite.lib sqlite.dll
+
+Unpack the PySQLite sources and open setup.py in your editor. Search for
+"win32". Change the include_dirs and library_dirs variable to point the place
+where you've unpacked the SQLite files and where you created the import
+library.
+
+Build PySQLite:
+
+$ python setup.py build --compiler=bcpp
+
+
+==========================
+Using Microsoft Visual C++
+==========================
+
+From http://www.hwaci.com/sw/sqlite/download.html get the sqlite_source.zip and
+sqlitedll.zip files. Unpack them all in the same directory.
+
+Create an import library for the Microsoft linker:
+
+$ lib /def:sqlite.def
+
+Unpack the PySQLite sources and open setup.py in your editor. Search for
+"win32". Change the include_dirs and library_dirs variable to point the place
+where you've unpacked the SQLite files and where you created the import
+library.
+
+Build PySQLite:
+
+$ python setup.py build
+
+
+==================================
+What to do after building pySQLite
+==================================
+
+- Make sure the sqlite.dll can be found. Either copy it into your system
+ directory, somewhere else in your PATH or in the same directory as the .pyd
+ file from pySQLite.
+
+- Run the included test suite with these or similar commands:
+ $ copy ..\sqlite\sqlite.dll build\lib.win32-2.2
+ $ copy test\*.py build\lib.win32-2.2
+ $ cd build\lib.win32-2.2
+ $ python all_tests.py
+
+ All the tests should pass. If something goes wrong, report it to the pySQLite
+ developers using the Sourceforge bug tracker.
+
+- Install pySQLite:
+ $ python setup.py install
+
+ Again make sure the sqlite.dll can be found
+