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 2 (modified by godoy, 13 years ago) (diff)


One common thing is storing files inside your database. This is usually done with image files, so this is what I'm going to show you here. You can adapt it to your needs. Complementary fields -- such as alternate_text, mimetype, etc. -- can be added at will.

The model:

class Image(SQLObject):
    class sqlmeta:
        table = 'images'
    fileName = UnicodeCol(length = 255, unique = True)
    image = BLOBCol(notNone = True)

The form:

        form = widgets.TableForm(fields = [
            name = 'image',
            label = _('Some picture'),
            validator = validators.FieldStorageUploadConverter())

Saving the image to the database:

    @validate(validators = {
        'image': validators.FieldStorageUploadConverter()
    def save(self, image):
        image = model.Image(
            fileName = image.filename,
            image =,
        return dict(image_id =

Retrieving the image from the database:

    @turbogears.expose(content_type = "image/jpg")
    def show_image(self, image_id):
        # "model.Image.q.image is where the image is stored
        return model.Image.get(image_id).image

You can use these in your template like this:

  # put this in your controller, in the method where you'll expose() the page
  images = [[, image.fileName] for image in

  # and add "images = images" to the returned dict

After adding this to your model, you can then add it to your template:

  <!--! Showing all images in a list -->
    <li py:for="image_id, filename in images"><a href="/show_image/${image_id}">${filename}</a></li>

If you want to show the images you put the "src" attribute from the "img" tag pointing to that URL (/show_image/${image_id}).