aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/manual/cowboy_static.ezdoc
blob: a827832a12d58911d076bab4121ee9771145633a (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
::: cowboy_static

The `cowboy_static` module implements file serving capabilities
by using the REST semantics provided by `cowboy_rest`.

:: Types

: opts() = {priv_file, atom(), string() | binary()}
	| {priv_file, atom(), string() | binary(), extra()}
	| {file, string() | binary()}
	| {file, string() | binary(), extra()}
	| {priv_dir, atom(), string() | binary()}
	| {priv_dir, atom(), string() | binary(), extra()}
	| {dir, string() | binary()}
	| {dir, string() | binary(), extra()}

Configuration for the static handler.

The handler can be configured for sending either one file or
a directory (including its subdirectories).

Extra options allow you to define how the etag should be calculated
and how the mimetype of files should be detected. They are defined
as follow, but do note that these types are not exported, only the
`opts/0` type is public.

: extra() = [extra_etag() | extra_mimetypes()]

: extra_etag() = {etag, module(), function()} | {etag, false}

: extra_mimetypes() = {mimetypes, module(), function()}
	| {mimetypes, binary() | {binary(), binary(), [{binary(), binary()}]}}