To simplify the migration from one qooxdoo version to another we have added support for semi-automatic updates for your projects. The migration script, written in Python, will automatically modify all files with one of these extensions: .php, .asp, .jsp, .html, .htm, .js. Some stuff can’t automatically be fixed. You will get information messages for these cases (including the line number).

You can run the script using Cygwin under Windows, or directly if you already have Python installed.

$ cd frontend
$ framework/tool/migrator/migrator.py --input YOUR_APPLICATION_DIRECTORY --version TARGET

You can only jump from one version to the next one. It is not possible to directly update a project from 0.5.3 to 0.6.1 for example. This must be done in multiple steps, e.g. 0.5.3 to 0.6 to 0.6.1. The data available can be seen in the data subfolder. The name of the subfolder is the same as the target version.

The default encoding expected by the migration script is utf-8. If your files have a different encoding, you can easily configure this using the argument --encoding.

If you don’t want to overwrite existing files, you have the option to save the files with an extension different to the original files. For users who don’t have the features of a version control system (like SVN) available for their project, this may be a good idea.

You can also enable the verbose mode of the script to show more debug information. Just add --verbose to your argument list.

To see all available arguments, use –h or –help.

Sometimes it’s a good idea to save the output to an file on your filesystem. You can easily use tee for this under Linux or Cygwin:

$ cd frontend
$ framework/tool/migrator/migrator.py --input DIRECTORY --version TARGET | tee FILENAME

This will output the stuff to the console, as before, but also logs it to FILENAME. In Windows, use “>” to save the output to a file.