paste.fileapp – Serve files — Paste v1.7.5 documentation

### Navigation

- index
- modules |
- Paste v1.7.5 documentation »

# `paste.fileapp` – Serve files

This module handles sending static content such as in-memory data or files. At this time it has cache helpers and understands the if-modified-since request header.

## Module Contents

class `paste.fileapp.` `FileApp`(filename, headers=None, **kwargs)

  Returns an application that will send the file at the given filename. Adds a mime type based on `mimetypes.guess_type()`. See DataApp for the arguments beyond `filename`.

class `paste.fileapp.` `DirectoryApp`(path)

  Returns an application that dispatches requests to corresponding FileApps based on PATH_INFO. FileApp instances are cached. This app makes sure not to serve any files that are not in a subdirectory. To customize FileApp creation override `DirectoryApp.make_fileapp`

`paste.fileapp.` `DataApp`(content, headers=None, allowed_methods=None, **kwargs)

  Returns an application that will send content in a single chunk, this application has support for setting cache-control and for responding to conditional (or HEAD) requests.

  Constructor Arguments:

  > `content` the content being sent to the client

  > `headers` the headers to send /w the response

  > The remaining `kwargs` correspond to headers, where the underscore is replaced with a dash. These values are only added to the headers if they are not already provided; thus, they can be used for default values. Examples include, but are not limited to:

  > > `content_type` `content_encoding` `content_location`

  `cache_control()`

  > This method provides validated construction of the `Cache-Control` header as well as providing for automated filling out of the `EXPIRES` header for HTTP/1.0 clients.

  `set_content()`

  > This method provides a mechanism to set the content after the application has been constructed. This method does things like changing `Last-Modified` and `Content-Length` headers.

`paste.fileapp.` `ArchiveStore`(filepath)

  Returns an application that serves up a DataApp for items requested in a given zip or tar archive.

  Constructor Arguments:

  > `filepath` the path to the archive being served

  `cache_control()`

  > This method provides validated construction of the `Cache-Control` header as well as providing for automated filling out of the `EXPIRES` header for HTTP/1.0 clients.

### Navigation

- index
- modules |
- Paste v1.7.5 documentation »