Skip to main content

Genrate CRUD interface in TurboGears

Project description

tgcrud is an TurboGears command extension, which could generate a sqlobject/sqlalchemy backend editor/crud (create, read, update, delete) interface based on your Model with kid template. It could be plugged into any projects even if you don’t use kid template.

The generated codes are fully customizable. tgcrud heavily use form widgets and show you many TG 1.0 features in it’s controllers/templates.

Please refer to for detail

The command follow the TurboGears quickstart template style, you could easily add identity, form validation, paginate in your crud interface.

If you are a TG beginer, tgcrud help you create a general admin skeleton based on your model.

If you are an experienced TG developer, you could get it in minutes since it just done the basic procedure that every time you write a management interface of your model.


Fully customizable admin interface (the create, read, update, delete functions) with easy to extend(form validation, identity, paginate) templates.

No Magic

  • The generated codes are normal TG source.

  • No extra magic encapsulation. No need to rewrite the interface when you need extra flexibility (not the same as Rails’scaffold)

  • Separate Form definition from Model (not the same as Django admin)

  • Use standard TurboGears syntax and code organization.

  • It’s a good crud implementation reference by TG.


  • Bundles a TurboGears “tg-admin crud” command.

  • Support SQLObject and SQLAlchemy models

  • tgcrud kid interface works for you no matter whatever template engine you currently choose for your project.

  • You could customize the model relationship by widgets(document shows how to customize 1-to-1, 1-to-many, many-to-many relationship with widgets. Or you could do it in your way)

  • Takes advantage of TurboGears form widgets and validation. you’d hardly need to modify the HTML.


The ‘tgcrud’ command extension is available in Python CheeseShop and TurboGears svn.

You can use setuptools to install tgcrud with following command:

$ easy_install tgcrud

or download the source code and install tgcrud manually.


Yes, there’s a ‘Make a Book Site with TurboGears’ screencast with tgcrud.

If you are an experienced TG developer, you could skip to the third.

If you are new to TG, you may want to watch all of them to get familiar with TurboGears.

With tgcrud you could easily generate a Rails scaffold style CRUD interface. The difference is all code in tgcrud is implicit, which leads to more easy customization.


  1. Define your model in

  2. Once you’ve defined your model, you could use “tg-admin crud” command to generate the crud pack. The syntax is:

    $ tg-admin crud [model class name] [package name]

    e.x if the model name is BookMark, and the package name we want is BookMarkController, the command is:

    $ tg-admin crud BookMark BookMarkController

    Then the ‘admin’ package is generated.

    You just need take several minutes to customize the formfield to have a proper crud interface.

    ..note:: you could estimate the result by passing “–dry-run” to the command, such as:

        $ tg-admin crud BookMark BookMarkController --dry-run
    With this argument the command will not effect your physical directories.
  3. Import the package to your with a line:

    from BookMarkController import BookMarkController

    and add a branch on your Root():

    foo = BookMarkController()
  4. Customize the form filed in admin/

  5. Open the http://localhost:8080/foo to use the customizable interface.

Please check for detail instructions.


  • Expand compatibility to all TurboGears 1 version

  • Minor template updates

  • Fully SQLAlchemy support with
    • SQLObject/SQLAlchemy auto detection

    • Able to specify the primary id

  • Minor template updates

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution (24.3 kB view hashes)

Uploaded source

Built Distribution

tgcrud-1.0.2-py2.5.egg (18.8 kB view hashes)

Uploaded 2 5

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page