Struct hypers_openapi::RapiDoc

#[non_exhaustive]
pub struct RapiDoc {
    pub title: Cow<'static, str>,
    pub keywords: Option<Cow<'static, str>>,
    pub description: Option<Cow<'static, str>>,
    pub lib_url: Cow<'static, str>,
    pub spec_url: Cow<'static, str>,
}

Implements [Handler] for serving RapiDoc.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

title: Cow<'static, str>

The title of the html page. The default title is “RapiDoc”.

keywords: Option<Cow<'static, str>>

The version of the html page.

description: Option<Cow<'static, str>>

The description of the html page.

lib_url: Cow<'static, str>

The lib url path.

spec_url: Cow<'static, str>

The spec url path.

Implementations

impl RapiDoc

pub fn new(spec_url: impl Into<Cow<'static, str>>) -> Self

Create a new RapiDoc for given path. Path argument will expose the RapiDoc to the user and should be something that the underlying application framework / library supports.

Examples

let doc = RapiDoc::new("/openapi.json");

pub fn title(self, title: impl Into<Cow<'static, str>>) -> Self

Set title of the html page. The default title is “RapiDoc”.

pub fn keywords(self, keywords: impl Into<Cow<'static, str>>) -> Self

Set keywords of the html page.

pub fn description(self, description: impl Into<Cow<'static, str>>) -> Self

Set description of the html page.

pub fn lib_url(self, lib_url: impl Into<Cow<'static, str>>) -> Self

Set the lib url path.

Trait Implementations

impl Clone for RapiDoc

fn clone(&self) -> RapiDoc

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for RapiDoc

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

Formats the value using the given formatter.