about.rst 2.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546
  1. .. _about:
  2. About South
  3. ===========
  4. South brings migrations to Django applications. Its main objectives are to
  5. provide a simple, stable and database-independent migration layer to prevent
  6. all the hassle schema changes over time bring to your Django applications.
  7. We try to make South both as easy-to-use and intuitive as possible, by making it
  8. automate most of your schema-changing tasks, while at the same time providing a
  9. powerful set of tools for large or complex projects; you can easily write your
  10. own migrations by hand, or even use the database altering API directly.
  11. While South started as a relative unknown in the Django database-schema-altering
  12. world, it has slowly risen in popularity and is now widely regarded as the most
  13. popular schema migration tool for Django.
  14. Key features
  15. ------------
  16. South has a few key features:
  17. - Automatic migration creation: South can see what's changed in your models.py
  18. file and automatically write migrations that match your changes.
  19. - Database independence: As far as possible, South is completely
  20. database-agnostic, supporting five different database backends.
  21. - App-savvy: South knows and works with the concept of Django apps, allowing
  22. you to use migrations for some of your apps and leave the rest to carry on
  23. using syncdb.
  24. - VCS-proof: South will notice if someone else commits migrations to the same
  25. app as you and they conflict.
  26. A brief history
  27. ---------------
  28. South was originally developed at `Torchbox <http://www.torchbox.com>`_ in 2008,
  29. when no existing solution provided the workflow and features that were needed.
  30. It was open-sourced shortly thereafter, and quickly gained steam after the
  31. Schema Evolution panel at DjangoCon 2008.
  32. Sometime in 2009, it became the most popular of the various migration
  33. alternatives, and seems to have been going strong ever since. While there have
  34. been growing calls to integrate South, or something like it, into Django itself,
  35. such an integration has not yet been made, mostly due to the relative
  36. immaturity of database migration solutions.