# Class StaticFilesHandler (1.18.0)

1.18.0 (latest) 1.17.0 1.16.0 1.15.0 1.14.2 1.13.0 1.12.1 1.11.5 1.10.0 1.9.4 1.8.1 1.7.1 1.6.0 1.5.3 1.4.1 1.3.3 1.2.1 1.1.5 1.0.2 0.2.0 0.1.0

    StaticFilesHandler(mapping=None, *, ignore_unknown_fields=False, **kwargs)

Files served directly to the user for a given URL, such as
images, CSS stylesheets, or JavaScript source files. Static file
handlers describe which files in the application directory are
static files, and which URLs serve them.

| ## Attributes ||
|---|---|
| **Name** | **Description** |
| `path` | `str` Path to the static files matched by the URL pattern, from the application root directory. The path can refer to text matched in groupings in the URL pattern. |
| `upload_path_regex` | `str` Regular expression that matches the file paths for all files that should be referenced by this handler. |
| `http_headers` | `MutableMapping[str, str]` HTTP headers to use for all responses from these URLs. |
| `mime_type` | `str` MIME type used to serve all files served by this handler. Defaults to file-specific MIME types, which are derived from each file's filename extension. |
| `expiration` | `google.protobuf.duration_pb2.Duration` Time a static file served by this handler should be cached by web proxies and browsers. |
| `require_matching_file` | `bool` Whether this handler should match the request if the file referenced by the handler does not exist. |
| `application_readable` | `bool` Whether files should also be uploaded as code data. By default, files declared in static file handlers are uploaded as static data and are only served to end users; they cannot be read by the application. If enabled, uploads are charged against both your code and static data storage resource quotas. |

## Classes

### HttpHeadersEntry

    HttpHeadersEntry(mapping=None, *, ignore_unknown_fields=False, **kwargs)

The abstract base class for a message.

| **Parameters** ||
|---|---|
| **Name** | **Description** |
| `kwargs` | `dict` Keys and values corresponding to the fields of the message. |
| `mapping` | ``Union[dict, `.Message`]`` A dictionary or message to be used to determine the values for this message. |
| `ignore_unknown_fields` | `Optional(bool)` If True, do not raise errors for unknown fields. Only applied if `mapping` is a mapping type or there are keyword parameters. |