Class Response

x.__init__(...) initializes x; see help(type(x)) for signature

Returns:

new empty dictionary

Overrides: object.__init__

(inherited documentation)

Caching method for writing out files. By default, caches in ram for 5 minutes. To change, response.cache_includes = (cache_method, time_expire). Example: (cache.disk, 60) # caches to disk for 1 minute.

If in a controller function::

    return response.stream(file, 100)

the file content will be streamed at 100 bytes at the time

Args:
    stream: filename or read()able content
    chunk_size(int): Buffer size
    request: the request object
    attachment(bool): prepares the correct headers to download the file
        as an attachment. Usually creates a pop-up download window
        on browsers
    filename(str): the name for the attachment

Note:
    for using the stream name (filename) with attachments
    the option must be explicitly set as function parameter (will
    default to the last request argument otherwise)

Example of usage in controller:

   def download():
       return response.download(request, db)

Downloads from http://..../download/filename

assuming:

   def add(a, b):
       return a+b

if a controller function "func":

   return response.xmlrpc(request, [add])

the controller will be able to handle xmlrpc requests for the add function. Example:

   import xmlrpclib
   connection = xmlrpclib.ServerProxy(
       'http://hostname/app/contr/func')
   print connection.add(3, 4)