Plan for TG2 App Testing Documentation & Examples

• AppTesting doc page (ticket:1662)
  • Start at  http://docs.turbogears.org/2.0/RoughDocs/AppTesting
  • Crib content from  http://wiki.pylonshq.com/display/pylonsdocs/Unit+Testing and  http://pythonpaste.org/webtest/
  • Write (at least partially) from a Test Driven Development perspective (even though the example tests will all be in the quickstart) and provide some context for testing and TDD (support for refactoring, limitation of feature creep, better code design)
  • Discuss other testing tools that are not part of default tg2 install, but may be useful, e.g.:
    • coverage -  http://nedbatchelder.com/code/modules/coverage.html
    • BeautifulSoup -  http://www.crummy.com/software/BeautifulSoup/
    • nosy -  http://douglatornell.ca/software/python/nosy/
  • Move into docs build once the page is useful

• Add test examples used on AppTesting doc page to quickstart app templates
  • Need to use an app with identity to get a model to test against, but the test code should degrade gracefully for an app without identity (ticket:1977)
  • Examples:
    • controller units tests
      • check dict returned by controller is in response.namespace
    • controller functional tests
      • check for expected html in response.body
      • follow login requests through redirects
    • model units tests:
      • check structure of model objects
      • check operation of model object methods
    • widget units tests
      • check that widget objects have expected attributes
      • this only scratches the surface of tests that might be done on widgets
  • Need to add a login form, etc. to quickstart identity app in order to implement a number of the above examples

• Get the quickstart test working again (ticket:1867)