Pylons projects should be updated using the paster command create. In addition to creating new projects, paster create when run over an existing project will provide several ways to update the project template to the latest version.

Using this tool properly can make upgrading a fairly minor task. For the purpose of this document, the project being upgraded will be called 'demoapp' and all commands will use that name.

Running paster create to upgrade

You'll first need to cd to the directory above your projects main directory. The main directory is the one that contains your setup.py, setup.cfg, and development.ini files.

1 2
/home/joe/demoapp $ cd .. /home/joe $

Then run paster create on the project directory:

1
/home/joe $ paster create demoapp -t pylons

paster will prompt you on how to handle conflicts and updates to the existing project files. The options let you (hit the key in the parens to perform the operation):

(d)iff them, and show you the changes between your projects file and the one: that has changed in Pylons
(b)ackup the file, and copy the new version into its place. The old one will: end in .bak
(y)es to overwrite the existing file with the new one. Not recommended since: you will then have no way to see your existing one, unless you have seen the diff first and know there is no changes you're losing.
(n)o to overwrite, and just keep your existing file. Also safe if you know: that nothing has changed.

It's recommended when upgrading your project that you always look at the diff first to see whats changed. Then either overwrite your existing one if you are not going to lose changes you want, or backup yours and write the new one in. You can then manually compare and add your changes back in.