Version 2 (modified by andrew, 6 years ago) (diff)


The latest release of South is 0.2. Read the release announcement.

You can either download South as a gzipped tar, or check it out of subversion using:

svn co south

Make sure the south directory is in your python path - just like you did with Django when you installed it - and then add 'south' to your INSTALLED_APPS setting. Run ./ syncdb (taking notice of the new migration-enabled syncdb) and you're ready to go! Have a look at docs/README for a detailed listing of what to do, or read the tutorial. You might also want to subscribe to my South feed to get updates on new features.

Remember, South is currently only in beta and thus only has PostgreSQL and most MySQL support support, and only supports the most common field types. However, it's behind this site and a major (but not yet public) project at Torchbox, so it definitely works so far.

Note that South requires a reasonably new version of Django; we're running it against 1.0 alpha, but it should work on 0.97-pre-svn too.

Documentation is contained in the docs/ directory of the codebase; if you want to ask more questions, please get in touch with me.

South is released under the Apache Public License, version two.