v5.5.0-beta1

v5.5.0-beta1

v5.4.0

Added

• New AsyncAPI 2 ruleset and format #965
• Custom functions can be async #694
• Expose fetch and cache to custom functions #1078, #1079

Changed

• Drop example-value-or-externalValue rule and introduce oas3-examples-value-or-externalValue #883, #1098
• Drop useless oas rule tags #1095
• AJV: swallow missing references #1147
• Improve ruleset validation #1144
• Allow running spectral from any directory in Docker #1022

Fixed

• Improve oas2-schema and oas3-schema rules #403
• path-params rule now properly detects undefined parameters across operations #1076
• Load custom functions from NPM correctly #1093
• Teach path-params to report an actual endpoint path #1130

v5.4.0-beta1

AsyncAPI Ruleset Support 🥳

v5.3.0

Added

• Built-in functions can now be accessed from custom functions #925
• CLI: --show-unmatched-globs flag #747

Changed

• typed-enum function is no longer a built-in function. It's been migrated into a custom function of the OpenAPI ruleset #924
• openapi-tags rule has been fixed to make it fit its description #1038

Fixed

• Ruleset exceptions used to slip certain errors through cracks #1018
• Correct misleading info-license message #1031
• Requiring packages located under node_modules is possible #1029
• Set proper document source if legacy parsed result is given #1040

v5.2.0

Added

• Rule exceptions are supported #747
• Allow require calls in Node.JS #1011

Changed

• YAMLIncomaptibleValue diagnostics are now considered warnings #1009

Fixed

• Alphabetical rule works correctly for $refs #979

v5.1.0

Features

• Implement a new typed-enum rule to detect enum value that do not respect specified type #913

Added

• API: introduced document #876 - note, this is not a breaking change
• Introduce optional enhancers to casing function #884

Fixed

• Improved Example Object validation #882
• oas3-operation-security-defined rule supports optional authentication #895
• Generate more correct paths when reporting an error #900
• example-value-or-externalValue no longer reports false positives #899
• schema-path accepts a JSON Path expression as a field selector #917
• schema-path handles invalid values gracefully #917
• oas3-valid-(content-)schema-example rules handle nullable correctly #914

v5.0.0

Features

• Alphabetical rule function now supports numeric keys #730
• Non-JSON-ish YAML mapping keys are reported #726
• CLI: new formatter - text #822
• CLI: new formatter - teamcity #823
• CLI: new formatter - HTML #389
• CLI: custom resolver can be provided leveraging --resolver flag #717
• CLI: input can be provided via STDIN #757
• Implement ignoreUnsupportedFormats to make it easier to detect unrecognized formats #678
• Rule's Given can be an array now #799
• Casing built-in function is added #564
• New oas rule - operation-tag-defined #704

Changed

• BREAKING: The oas2 and oas3 rulesets have been merged into a single oas ruleset #773
• BREAKING: Deprecated Spectral#addRules and Spectral#addFunctions have been removed #561
• BREAKING: Some oas rules, such as example-value-or-externalValue and openapi-tags, are now included in the recommended rulset #725 #706
• BREAKING: The model-description and operation-summary-formatted rules have been removed #725
• BREAKING: The when rule property has been removed #585
• BREAKING: Rules are set to recommended by default #719
• Improved error source detection #685
• Error paths point at unresolved document #839
• Validation messages contain more consistent error paths #867
• CLI: Default --fail-severity is now error, so getting a warn, info or a hint will not return a exit status code #706
• Rulesets no longer require a rules property #652

Fixed

• Circular remote references with JSON pointers are resolved correctly json-ref-resolver#141
• Local root JSON pointers are resolved correctly json-ref-resolver#146
• Invalid JSON pointers are reported as errors now json-ref-resolver#140 and json-ref-resolver#147
• Unixify glob patterns under Windows #679
• Improved duplicate keys detection #751
• Spectral should be usable in browsers with no crypto module available #846
• Falsy values are printed in validation messages #824
• Validation results are no longer duplicate #680, #737 and #856

v5.0.0-beta4

v5.0.0-beta4

v5.0.0-beta3

v5.0.0-beta3

v5.0.0-beta2

v5.0.0-beta2