#openapi #extension #utilities #methods #openapi-v3 #data #information


Extension method and utilities to work with OpenAPI 3.0 files

13 unstable releases (5 breaking)

0.6.0 Feb 24, 2024
0.5.2 Nov 17, 2023
0.5.0 Oct 9, 2023
0.4.0 Feb 5, 2022
0.1.1 Dec 12, 2019

#628 in Parser implementations

Download history 9/week @ 2024-01-08 3/week @ 2024-01-29 194/week @ 2024-02-19 96/week @ 2024-02-26 17/week @ 2024-03-04 28/week @ 2024-03-11 10/week @ 2024-03-18 61/week @ 2024-04-01

102 downloads per month
Used in openapi-fuzzer


503 lines

Openapi Utils

This crate provides extensions methods for multiple structs of the Openapiv3 crate.

It aims at making it more ergonomic to work with the information in the openapi contracts.


This crate provides a deref_all method on the openapiv3::OpenAPI data type. This method would inline all the $ref in the document.


use openapi_utils::SpecExt;

pub fn read<P: AsRef<Path>>(filename: P) -> openapiv3::OpenAPI {
    let data = std::fs::read_to_string(filename).expect("OpenAPI file could not be read.");
    serde_yaml::from_str(&data).expect("Could not deserialize file as OpenAPI v3.0 yaml")

let spec = read(filename).deref_all();

The to_item, to_item_ref and to_item_mut methods in the ReferenceOr structure assumes deref_all has been called on the spec previously and will panic otherwise. These methods are really a shorthand to choose the right element in the enumeration (the item).

For other methods in other structures please refer to the documentation of each extension. To have these methods available in your structures you need to use the corresponding extension.

no_std support

This crate is compatible with no_std, although a global allocator is required.


Licensed under either of Apache License, Version 2.0 or MIT license at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


~61K SLoC