Struct rocket_contrib::serve::Options

pub struct Options(_);

A bitset representing configurable options for the StaticFiles handler.

The valid options are:

• Options::None - Return only present, visible files.
• Options::DotFiles - In addition to visible files, return dotfiles.
• Options::Index - Render index.html pages for directory requests.

Two Options structures can be ord together to slect two or more options. For instance, to request that both dot files and index pages be returned, use Options::DotFiles | Options::Index.

Methods

impl Options

pub const None: Options

Options representing the empty set. No dotfiles or index pages are rendered. This is different than the default, which enables Index.

pub const Index: Options

Options enabling responding to requests for a directory with the index.html file in that directory, if it exists. When this is enabled, the StaticFiles handler will respond to requests for a directory /foo with the file ${root}/foo/index.html if it exists. This is enabled by default.

pub const DotFiles: Options

Options enabling returning dot files. When this is enabled, the StaticFiles handler will respond to requests for files or directories beginning with .. This is not enabled by default.

pub fn contains(self, other: Options) -> bool

Returns true if self is a superset of other. In other words, returns true if all of the options in other are also in self.

Example

use rocket_contrib::serve::Options;

let index_request = Options::Index | Options::DotFiles;
assert!(index_request.contains(Options::Index));
assert!(index_request.contains(Options::DotFiles));

let index_only = Options::Index;
assert!(index_only.contains(Options::Index));
assert!(!index_only.contains(Options::DotFiles));

let dot_only = Options::DotFiles;
assert!(dot_only.contains(Options::DotFiles));
assert!(!dot_only.contains(Options::Index));

Trait Implementations

impl Clone for Options

fn clone(&self) -> Options

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for Options

impl BitOr<Options> for Options

type Output = Self

The resulting type after applying the | operator.

fn bitor(self, rhs: Self) -> Self

Performs the | operation.

impl Debug for Options

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.