Warning: Can't synchronize with repository "(default)" (Unsupported version control system "svn": No module named svn). Look in the Trac log for more information.

Version 18 (modified by mramm, 11 years ago) (diff)


Change Log



  • New highly customizable replacement for Buffet renderers.
    • These are not on by default, you must add base_config.use_legacy_renderer = False to your file to use them.
    • When using the new renderers, you have to switch genshi from dotted lookup to using paths+filenames.
  • TG2 now supports automatic transactions, so you no longer have to explicitly commit transactions
    • Transaction middleware supports cross-database transactions
    • Transactions are not begun until the SQLAlchemy session becomes dirty, so no transaction overhead is wasted on requests that don't ever write to the database
  • The SQLAlchemy metadata is no longer automatically bound in the config setup, so we can more easily support multiple database engines (eg., for master-slave replication).
  • added start_response to the context, so we're easily able to use it to use WSGI applications anywhere
  • added a use_wsgi_app() function that makes it very, very easy to mount a wsgi app in your tg2 controller, or use a TG2 controller as middleware.
  • Improved support and documentation for returning a WebOb? response object, so tg2 controllers can take over all aspects of defining the responce whenever that's needed.
  • Simply set base_config.serve_static to False to stop your TG2 app from serving up static content, no manual editing of the middleware setup required.
  • request, repsonse, etc all available from tg as well as pylons now
  • default template namspace now has request, response, and tg variables automatically injected into it.
  • quickstart now imports from tg wherever possible so there's less what's in tg what's in pylons
  • a custom content type can now be set dynamically within a controller method by setting the content type in @expose to tg.controllers.CUSTOM_CONTENT_TYPE and using pylons.response.headersContent-Type?
  • The declarative plugin of SQLAlchemy is now used in the default template, instead of the traditional method.
  • TG1's DBTest has been ported to TG2.


  • You were not able to use non-standard class names for User, Group, and Permissions in tg.ext.repoze.who
  • Configuring an alternate location for controllers did not work with PylonsApp? (now we have TGApp, an it will work)>
  • the Content-Type header will not have charset=utf8 appended to it when it is not required

Contributors (in alphabetic order)

  • Gustavo Narea, Mark Ramm, Matthew Sherborne, Alberto Valverde

Upgrading from 1.9.7a3

  • You must define the user_class, group_class, and permission_class in when using the authorizaiton plugin.
    -base_config.sa_auth.user = model.User
    +base_config.sa_auth.user_class = model.User
     base_config.sa_auth.user_criterion = model.User.user_name
     base_config.sa_auth.user_id_column = 'user_id'
    +base_config.sa_auth.group_class = model.Group
    +base_config.sa_auth.permission_class = model.Permission
  • TG2 no longer binds the database engine to the DBSession or metadata soyou can decide how you want to handle this (perhaps to re-bind the session dynamically to a different engine on a per-request basis, etc...).

This is now done in the yourapp.model.init_model callback which iscalled when your app is loaded and passed a configured engine as a parameter. To upgrade an existing project just add one line to init in you model directory, as shown here.

def init_model(engine):
   DBSession.configure(bind=enigne) # <-- this, add this

Of course if you're starthing a new project, this is done automatically for you by quickstart.

  • If you turn on new-style renderers, you must now provide the filename (and whatever path information is nessisary) in expose, including the .html extension. Furthermore, we're now regestring the template directory in the search path directly, so expose can be simpler. The old expose:
    def index(self):
        return dict(page='index')

Should be replaced by the new expose:

    def index(self):
        return dict(page='index')

1.9.7a3 (July, 29, 2008):


  • TurboGears 2 now defaults to making multiple request parameters into a list that's passed to the controller (emulating the tg1 behavior).
  • The base_config object now has a number of methods for those who need very fine grained control of how the middleware and environment are setup.
  • tg2 now uses sphinx extensions to import code samples from svn, as well as to test the example code.
  • new support of calling wsgi_apps from a TG2 controller method (see the use_wsgi_app function)
  • added tg_vars to template namespace to more closely match tg1
  • Lots and lots of new docs covering:
    • Updated TW docs
    • Updated config docs
    • Updated PyAMF integration docs
    • Updated install and offline install docs


  • updated by splee to act more like tg1
  • pep 8 compiance
  • Fix for #1885 development.ini now runs only on localhost to avoid security issues related to the debugging interface being turned on.
  • Added missing package requirement while using develop
  • updated Paste dependencies, in order to work around an import appconfig issue mentioned on the mailing list
  • updated the default quickstart project to look a bit nicer (thanks to Lukasz Szybalski)

Contributors (in alphabetic order)

Florent Aide, Bruno J. M. Melo, Lee McFadden?, Christopher Perkins, Mark Ramm, Sanjiv Singh, and Lukasz Szybalski.

Upgrading from 1.9.7a2

  • The changes to the base_config object make it necessary to change config/ and config/ Without these changes your app will raise deprecation warnings.
  • in config/
-load_environment = make_load_environment(base_config)
+load_environment = base_config.make_load_environment()
  • in config/
+-make_base_app = setup_tg_wsgi_app(load_environment, base_config)
+make_base_app = base_config.setup_tg_wsgi_app(load_environment)
  • You can also delete the from tg.environment import make_load_environment statements from both config/ and config/