80 Windows installation

    81 ````````````````````

    82 

    83 Base elements

    84 _____________

    85 

    86 Setting up a windows development environment is not too complicated

    87 but requires a series of small steps. What is proposed there is only

    88 an example of what can be done. We assume everything goes into C:\ in

    89 this document. Adjusting the installation drive should be

    90 straightforward.

    91 

    92 You should start by downloading and installing the Python(x,y)

    93 distribution. It contains python 2.5 plus numerous useful third-party

    94 modules and applications::

    95 

    96   http://www.pythonxy.com/download_fr.php

    97 

    98 At the time of this writting, one gets version 2.1.15. Among the many

    99 things provided, one finds Eclipse + pydev (an arguably good IDE for

   100 python under windows).

   101 

   102 Then you must grab Twisted. There is a windows installer directly

   103 available from this page::

   104 

   105   http://twistedmatrix.com/trac/

   106 

   107 A windows installer for lxml will be found there::

   108 

   109   http://pypi.python.org/pypi/lxml/2.2.1

   110 

   111 Check out the lxml-2.2.1-win32-py2.5.exe file. More recent bugfix

   112 releases should probably work, too.

   113 

   114 You should find postgresql 8.4 there::

   115 

   116   http://www.enterprisedb.com/products/pgdownload.do#windows

   117 

   118 The python drivers for posgtresql are to be found there::

   119 

   120   http://www.stickpeople.com/projects/python/win-psycopg/#Version2

   121 

   122 Please be careful to select the right python (2.5) and postgres (8.4)

   123 versions.

   124 

   125 Having graphviz will allow schema drawings, which is quite recommended

   126 (albeit not mandatory). You should get an msi installer there::

   127 

   128   http://www.graphviz.org/Download_windows.php

   129 

   130 Tools

   131 _____

   132 

   133 Get mercurial + its standard windows GUI (TortoiseHG) there (the

   134 latest is the greatest)::

   135 

   136   http://bitbucket.org/tortoisehg/stable/wiki/download

   137 

   138 If you need to peruse mercurial over ssh, it can be helpful to get an

   139 ssh client like Putty::

   140 

   141   http://www.putty.org/

   142 

   143 Integration of mercurial and Eclipse is convenient enough that we want

   144 it. Instructions are set there, in the `Download & Install` section::

   145 

   146   http://www.vectrace.com/mercurialeclipse/

   147 

   148 Setting up the sources

   149 ______________________

   150 

   151 You need to enable the mercurial forest extension. To do this, edit

   152 the file::

   153 

   154   C:\Program Files\TortoiseHg\Mercurial.ini

   155 

   156 In the [extensions] section, add the following line::

   157 

   158   forest=C:\Program Files\TortoiseHg\ext\forest\forest.py

   159 

   160 Now, you need to clone the cubicweb repository. We assume that you use

   161 Eclipse. From the IDE, choose File -> Import. In the box, select

   162 `Mercurial/Clone repository using MercurialEclipse`.

   163 

   164 In the import main panel you just have to:

   165 

   166 * fill the URL field with http://www.logilab.org/hg/forests/cubicwin32

   167 

   168 * check the 'Repository is a forest' box.

   169 

   170 Then, click on 'Finish'. It might take some time to get it all. Note

   171 that the `cubicwin32` forest contains additional python packages such

   172 as yapps, vobject, simplejson and twisted-web2 which are not provided

   173 with Python(x,y). This is provided for convenience, as we do not

   174 ensure the up-to-dateness of these packages, especially with respect

   175 to security fixes.

   176 

   177 Environment variables

   178 _____________________

   179 

   180 You will need some convenience environment variables once all is set

   181 up. These variables are settable through the GUI by getting at the

   182 'System properties' window (by righ-clicking on 'My Computer' ->

   183 properties).

   184 

   185 In the 'advanced' tab, there is an 'Environment variables'

   186 button. Click on it. That opens a small window allowing edition of

   187 user-related and system-wide variables.

   188 

   189 We will consider only user variables. First, the PATH variable. You

   190 should ensure it contains, separated by semi-colons, and assuming you

   191 are logged in as user Jane::

   192 

   193   C:\Documents and Settings\Jane\My Documents\Python\cubicweb\cubicweb\bin

   194   C:\Program Files\Graphviz2.24\bin

   195 

   196 The PYTHONPATH variable should also contain::

   197 

   198   C:\Documents and Settings\Jane\My Documents\Python\cubicweb\

   199 

   200 From now, on a fresh `cmd` shell, you should be able to type::

   201 

   202   cubicweb-ctl list

   203 

   204 ... and get a meaningful output.

   205 

   206