Update build instructions for Windows.
[jelmer/subvertpy.git] / README
1 Subvertpy
2 =========
3
4 Homepage: http://samba.org/~jelmer/subvertpy/
5
6 Python bindings for the Subversion version control system that are aimed to be
7 complete, fast and feel native to Python programmers.
8
9 Bindings are provided for the working copy, client, delta, remote access and
10 repository APIs. A hookable server side implementation of the custom Subversion
11 protocol (svn_ra) is also provided.
12
13 Differences with similar packages
14 ---------------------------------
15 subvertpy covers more of the APIs than python-svn. It provides a more
16 "Pythonic" API than python-subversion, which wraps the Subversion C API pretty
17 much directly. Neither provide a hookable server-side.
18
19 Dependencies
20 ------------
21 Subvertpy depends on Python 2.4 or later, and Subversion 1.4 or later. It should
22 work on Windows as well as most POSIX-based platforms (including Linux, BSDs
23 and Mac OS X).
24
25 A port to Python 3 is planned but has not happened yet. Patches are welcome.
26
27 Installation
28 ------------
29 Standard distutils are used - use "setup.py build" to build and "setup.install"
30 to install. On most platforms, setup will find the Python and Subversion
31 development libraries by itself. On Windows you may have to set various
32 environment variables, see the next section for details.
33
34 Build instructions for Windows
35 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36 * Install the SVN dev kit ZIP for Windows from
37   http://sourceforge.net/projects/win32svn/files/
38   E.g. svn-win32-1.4.6_dev.zip
39 * Find the SVN binary ZIP file with the binaries for your dev kit.
40   E.g. svn-win32-1.4.6.zip
41   Unzip this in the *same directory* as the dev kit - README.txt will be
42   overwritten, but that is all. This is the default location the .ZIP file
43   will suggest (ie, the directory embedded in both .zip files are the same)
44 * Set SVN_DEV to point at this directory.
45 * Install BDB.
46   For Subversion 1.7.0 and later:
47   http://www.oracle.com/technetwork/database/berkeleydb/downloads/index-082944.html
48   download Berkeley DB 4.8.30.msi Windows installer and install it.
49   For Subversion 1.6.17 and earlier:
50   http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=688
51   download "db-4.4.20-win32.zip" or earlier version of BDB and extract it.
52 * Set SVN_BDB to the installed directory or extracted directory.
53 * Install SVN libintl.
54   http://subversion.tigris.org/servlets/ProjectDocumentList?folderID=2627
55   Download svn-win32-libintl.zip.
56   extrat it to the directory that you want.
57 * Set SVN_LIBINTL to the extract dir.