Struct OpenApiBuilder 

pub struct OpenApiBuilder { /* private fields */ }

Builder for composing OpenAPI specs from multiple sources.

Example

use server_less::OpenApiBuilder;

let spec = OpenApiBuilder::new()
    .title("My API")
    .version("1.0.0")
    .merge(UserService::openapi_spec())
    .merge(OrderService::openapi_spec())
    .build()?;

Conflict Resolution

• Paths: Last write wins (later merge() calls override earlier ones for same path+method).
• Schemas: Identical schemas are deduplicated; different schemas with same name cause an error.

Implementations

impl OpenApiBuilder

pub fn new() -> OpenApiBuilder

Create a new builder.

pub fn title(self, title: impl Into<String>) -> OpenApiBuilder

Set the API title.

pub fn version(self, version: impl Into<String>) -> OpenApiBuilder

Set the API version.

pub fn description(self, description: impl Into<String>) -> OpenApiBuilder

Set the API description.

pub fn merge(self, spec: Value) -> Result<OpenApiBuilder, OpenApiError>

Merge an OpenAPI spec (as JSON value).

This extracts paths and schemas from the spec and merges them.

Conflict Resolution

• Paths: Last write wins
• Schemas: Identical schemas dedupe, different schemas error

pub fn merge_paths(self, paths: Vec<OpenApiPath>) -> OpenApiBuilder

Merge typed paths.

pub fn merge_schemas( self, schemas: Vec<OpenApiSchema>, ) -> Result<OpenApiBuilder, OpenApiError>

Merge typed schemas.

pub fn build(self) -> Value

Build the final OpenAPI spec.

Trait Implementations

impl Clone for OpenApiBuilder

fn clone(&self) -> OpenApiBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for OpenApiBuilder

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

Formats the value using the given formatter.

impl Default for OpenApiBuilder

fn default() -> OpenApiBuilder

Returns the “default value” for a type.