Struct hypers_openapi::Scalar

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

Implements [Handler] for serving Scalar.

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 “Scalar”.

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

The version of the html page.

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

The description of the html page.

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

Custom style for the html page.

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

Custom header for the html page.

lib_url: Cow<'static, str>

The lib url path.

spec_url: Cow<'static, str>

The spec url path.

Implementations

impl Scalar

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

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

Examples

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

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

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

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 Scalar

fn clone(&self) -> Scalar

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Scalar

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

Formats the value using the given formatter.