Crate mockforge_openapi 

MockForge OpenAPI

OpenAPI 3.x / Swagger 2.0 specification loading, parsing, schema validation, and response selection primitives for MockForge.

This crate owns the OpenApiSpec domain model used throughout MockForge to drive mock responses, routing, validation, and contract analysis. It was extracted from mockforge-core so that downstream crates (contract drift, intelligence, recorders, etc.) can depend on OpenAPI types without pulling in the entirety of core.

Modules

• spec — OpenApiSpec loader (file / string / JSON / YAML), schema resolution, operation iteration. Handles transparent Swagger 2.0 → OpenAPI 3.0 conversion via swagger_convert.
• schema — OpenApiSchema wrapper with JSON-Schema-backed validation.
• multi_spec — [MultiSpec], load and merge multiple OpenAPI docs with conflict strategies.
• response_selection — ResponseSelectionMode + ResponseSelector for choosing between multiple example responses (first / scenario / sequential / random / weighted).
• spec_parser — unified OpenApiValidator / GraphQLValidator + SpecFormat detector covering OpenAPI 2.0/3.0/3.1 and GraphQL.
• validation — request/response validation helpers against an OpenApiSpec.
• swagger_convert — Swagger 2.0 → OpenAPI 3.0 conversion helper used by spec (re-exported for advanced callers).

Re-exports

pub use custom_fixture::CustomFixtureLoader;

pub use request_fingerprint::RequestFingerprint;

pub use response_rewriter::ResponseRewriter;

pub use spec_parser::GraphQLValidator;

pub use spec_parser::OpenApiValidator;

pub use spec_parser::SpecFormat;

pub use response::*;

pub use route::*;

pub use schema::*;

pub use spec::*;

pub use validation::*;

Modules

custom_fixture

Custom fixture format support for simple JSON fixtures

multi_spec

Multi-spec loading and merging utilities

openapi_routes

OpenAPI-based route generation for MockForge

request_fingerprint

Request fingerprinting system for unique request identification and priority-based response selection.

response

OpenAPI response generation and mocking

response_rewriter

ResponseRewriter trait for post-generation response mutation.

response_selection

ResponseSelectionMode / ResponseSelector live in mockforge_foundation::response_selection — it’s a generic selection primitive used by non-OpenAPI response trace code. Re-export here so mockforge_openapi::response_selection::... paths keep resolving. Response selection modes for multiple responses/examples

response_trace

Response generation trace instrumentation

route

OpenAPI route generation from specifications

schema

OpenAPI schema validation and handling

spec

OpenAPI specification loading and parsing

spec_parser

Unified specification parser and validator

swagger_convert

Swagger 2.0 to OpenAPI 3.0 conversion

validation

OpenAPI request/response validation

Structs

OpenApiOperation

Wrapper for OpenAPI operation with enhanced metadata.

ResponseSelector

Response selector with state for sequential mode

Enums

ResponseSelectionMode

Mode for selecting responses when multiple options are available

Type Aliases

OpenApiSecurityRequirement

Type alias for OpenAPI security requirements.