Hello all,<br><br>As several people have mentioned they had trouble starting with the rewrite branch, I decided to do a step-by-step log of installing the rewrite in a way that is good for developing -- this means you are able to edit the framework files, while not inflicting any changes on other users (or other bots you run!) of the system. By using setup.py develop, edits you make to the framework will immediately be used (no need to setup.py install them), but only <i>within the virtualenv</i>.<br>
<br>As a prerequisite, install virtualenv. All other dependencies should be installed automatically. The following is a log of what I did - and what you could/should do ;-) The output is <font face="'courier new', monospace">monospaced</font><font face="arial, helvetica, sans-serif">, the things I entered are </font><font face="arial, helvetica, sans-serif"><b>bold</b>.</font><br>
<br>------------------------------------------------<br><div><font face="'courier new', monospace">valhallasw@dorthonion:~/src$ </font><font face="arial, helvetica, sans-serif"><b>virtualenv pwb</b></font></div>
<div><font face="'courier new', monospace">New python executable in pwb/bin/python</font></div><div><font face="'courier new', monospace">Installing setuptools............done.</font></div>
<div><font face="'courier new', monospace">valhallasw@dorthonion:~/src$ </font><b><font face="arial, helvetica, sans-serif">cd pwb</font></b></div><div><font face="'courier new', monospace">valhallasw@dorthonion:~/src/pwb$ </font><b><font face="arial, helvetica, sans-serif">source bin/activate # activate virtualenv</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb$ </font><b><font face="arial, helvetica, sans-serif">mkdir src</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb$ </font><b><font face="arial, helvetica, sans-serif">cd src</font></b></div>
<div><font face="'courier new', monospace">(</font><b style="font-family:'courier new', monospace">pwb</b><font face="'courier new', monospace">)valhallasw@dorthonion:~/src/pwb/src$ </font><b><font face="arial, helvetica, sans-serif">svn co svn+ssh://<a href="http://svn.wikimedia.org/svnroot/pywikipedia/branches/rewrite/" target="_blank">svn.wikimedia.org/svnroot/pywikipedia/branches/rewrite/</a> . # note trailing dot</font></b></div>
<div><font face="'courier new', monospace">A generate_user_files.py</font></div><div><font face="'courier new', monospace">A pywikibot</font></div><div>
<font face="'courier new', monospace">(...snip...)</font></div><div><font face="'courier new', monospace">Checked out revision 8837</font><font face="'courier new', monospace" size="1">.</font></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src$ </font><b><font face="arial, helvetica, sans-serif">python setup.py develop</font></b></div>
<div><font face="'courier new', monospace">Downloading <a href="http://pypi.python.org/packages/source/d/distribute/distribute-0.6.10.tar.gz" target="_blank">http://pypi.python.org/packages/source/d/distribute/distribute-0.6.10.tar.gz</a></font></div>
<div><font face="'courier new', monospace">(...snip...)</font></div><div><font face="'courier new', monospace">Finished processing dependencies for Pywikipediabot==2.0alpha</font></div>
<div><font face="'courier new', monospace" size="1"><br></font></div><div><font face="'courier new', monospace">Your default user directory is "/home/valhallasw/.pywikibot"</font></div>
<div><font face="'courier new', monospace">How to proceed? ([K]eep [c]hange)</font> <b><font face="arial, helvetica, sans-serif">c</font></b></div><div><font face="'courier new', monospace">New user directory? </font><b><font face="arial, helvetica, sans-serif">/home/valhallasw/src/pwb/conf</font></b></div>
<div><font face="'courier new', monospace">OK: Created new directory.</font></div><div><font face="'courier new', monospace">WARNING: Your user files will be created in the directory</font></div>
<div><font face="'courier new', monospace">'/home/valhallasw/src/pwb/conf' you have chosen. To access these files, you</font></div><div><font face="'courier new', monospace">will either have to use the argument "-dir:/home/valhallasw/src/pwb/conf"</font></div>
<div><font face="'courier new', monospace">every time you run the bot, or set the environment variable "PYWIKIBOT2_DIR"</font></div><div><font face="'courier new', monospace">equal to this directory name in your operating system. See your operating</font></div>
<div><font face="'courier new', monospace">system documentation for how to set environment variables.</font></div><div><font face="'courier new', monospace">Is this OK? ([yes], [N]o) </font><b><font face="arial, helvetica, sans-serif">y</font></b></div>
<div><font face="'courier new', monospace">Do you want to copy user files from an existing pywikipedia installation? </font><b><font face="arial, helvetica, sans-serif">y</font></b></div>
<div><font face="'courier new', monospace">Path to existing wikipedia.py? </font><b><font face="arial, helvetica, sans-serif">/home/valhallasw/src/pywikipedia/trunk</font></b></div>
<div><font face="'courier new', monospace">NOTE: user-config.py already exists in the directory</font></div><div><font face="'courier new', monospace">Create user-fixes.py file? ([y]es, [N]o) </font><b><font face="arial, helvetica, sans-serif">n</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src$ </font><b><font face="arial, helvetica, sans-serif">echo "export PYWIKIBOT2_DIR=/home/valh allasw/src/pwb/conf" >> ../bin/activate</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src$ </font><b><font face="arial, helvetica, sans-serif">source ../bin/activate</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src$ </font><b><font face="arial, helvetica, sans-serif">cd scripts/</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src/scripts$ </font><b><font face="arial, helvetica, sans-serif">python touch.py Gebruiker:Valhallasw</font></b></div>
<div><span style="font-family:'courier new', monospace">Password for user valhallasw on wikipedia:nl:</span></div><div><font face="'courier new', monospace">Logging in to wikipedia:nl as valhallasw</font></div>
<div><font face="'courier new', monospace">Retrieving 1 pages from wikipedia:nl.</font></div><div><font face="'courier new', monospace">Page [[Gebruiker:Valhallasw]] saved</font></div>
-----------------------------------------------------------------------------------<div><br></div><div>Now, the next time you want to run the bot, you have to do the following:</div><div>-----------------------------------------------------------------------------------</div>
<div><div><font face="'courier new', monospace">valhallasw@dorthonion:~$ </font><b><font face="arial, helvetica, sans-serif">cd ~/src/pwb/src/scripts/</font></b></div>
<div><font face="'courier new', monospace">valhallasw@dorthonion:~/src/pwb/src/scripts$ </font><b><font face="arial, helvetica, sans-serif">source ../../bin/activate</font></b></div>
<div><font face="'courier new', monospace">(<b>pwb</b>)valhallasw@dorthonion:~/src/pwb/src/scripts$ </font><b><font face="arial, helvetica, sans-serif">python touch.py Gebruiker:Valhallasw</font></b></div>
<div><span style="font-family:'courier new', monospace">Password for user valhallasw on wikipedia:nl:</span></div><div><font face="'courier new', monospace">Logging in to wikipedia:nl as valhallasw</font></div>
<div><font face="'courier new', monospace">Retrieving 1 pages from wikipedia:nl.</font></div><div><font face="'courier new', monospace">Page [[Gebruiker:Valhallasw]] saved</font></div>
<div>-----------------------------------------------------------------------------------</div><br>Best regards,<br>Merlijn van Deen<br></div>