Enum SpecKind 

pub enum SpecKind {
    OpenApi,
    AsyncApi,
    GraphQl,
    McpTools,
}

Spec dialects soothfast reads and writes.

Variants

OpenApi

AsyncApi

GraphQl

McpTools

Implementations

impl SpecKind

pub const ALL: &'static [SpecKind]

Every dialect that can be generated, for help text and diagnostics.

pub fn name(self) -> &'static str

The name used in soothfast.toml and in messages.

pub fn parse_name(s: &str) -> Option<SpecKind>

Parse a dialect = "..." value.

pub fn for_path(path: &str) -> SpecKind

Guess the dialect of a spec file from its path.

Generation needs a dialect before the file exists, so content sniffing (which crate::sniff_kind does on the reconcile path) is not available here. The guess is conservative and always overridable with an explicit dialect = key: OpenAPI is the default because it is what an unqualified spec.yaml almost always means.

pub fn document(self, info: &Info, ops: &[Operation]) -> Document

Assemble a document from inferred route shapes.

pub fn render(self, path: &str, value: &Value) -> String

Serialize a document for writing to path.

GraphQL ignores the extension because SDL is its only serialization; the rest honour .json and default to the dialect’s usual form.

pub fn parse(self, path: &str, text: &str) -> Result<Value, String>

Parse a committed spec file back into its generated document.

Round-trips the result through SpecKind::render and fails on any drift, so a stale or hand-edited file can never be silently diffed as the base.

pub fn diff(self, old: &Value, new: &Value) -> Vec<Change>

Compare two revisions of a document for consumer compatibility.

pub fn empty(self) -> Value

The document a spec file that does not yet exist compares as, so that everything in a newly added file reads as additive by construction.

pub fn summarize(self, value: &Value) -> (usize, usize)

Operation and named-schema counts, for the one-line generation summary.

Trait Implementations

impl Clone for SpecKind

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for SpecKind

impl Debug for SpecKind

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

Formats the value using the given formatter.

impl Eq for SpecKind

impl PartialEq for SpecKind

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for SpecKind