µWeb

h1. Converting from uWeb2 to uWeb3

- Make a 'base' directory in your repository root directory.

- Move your pagemaker and config files, as well as router, static and templates directtories into this new base directory.

- Move your router file to the base directory and rename it to __init__.py

- Search and replace (case sensitive) in all python files all references of 'uweb' to 'uweb3'.

- Rename your config file to config.ini

- Change 'server' to 'host' in the mysql section of the config file.

- Add the following to the config file:

<pre>[routing]

disable_automatic_route_detection = False

default_routing = routes</pre>

- Replace the 'standalone' block with the following:

<pre>[development]

access_logging = True

error_logging = True

port = 8000

dev = True</pre>

- import os in the init file

- Remove the 'CONFIG' and 'PACKAGE' variables in the init file.

- Make 'routes' lower case.

- Move the routes and serversetup into a def main().

- Add path = os.path.dirname(os.path.abspath(__file__)) at the top of your main function.

- Replace the serversetup line in your init file with "  return uweb3.uWeb(pages.PageMaker, routes, executing_path=path)"

- Remove the 'static' routes from your router config as this is now built in.

- Replace all page file imports with "from . import <name>".

- Update all sqltalk imports to: from uweb3.ext_lib.underdark.libs.sqltalk import <module>

- Copy a serve.py and base.wsgi from https://github.com/stefvanhouten/uweb3_template

- Add a file like the following to /etc/apache2/sites-available:

<pre><VirtualHost *:80>

    ServerName none

    WSGIScriptAlias / /var/www/project/base.wsgi

    <Directory /var/www/project/base/>

        Require all granted

    </Directory>

</VirtualHost></pre>