parse
Parses an OpenAPI 3.0 specification file into an ApiSpec intermediate model.
Accepts YAML or JSON files. Swagger 2.0 specs are automatically converted to OpenAPI 3.0 by the underlying Swagger Parser before model extraction.
Uses Arrow either for the internal parse pipeline; the result is collapsed to ParseResult via arrow.core.merge so callers always receive a ParseResult and never an arrow.core.Either.
Return
ParseResult.Success with the parsed model and any warnings, or ParseResult.Failure with a non-empty list of error messages
Parameters
specFile
path to the OpenAPI or Swagger 2.0 specification file