Skip to content

Latest commit

 

History

History
327 lines (204 loc) · 9.44 KB

CHANGELOG.md

File metadata and controls

327 lines (204 loc) · 9.44 KB
Raw

Drafter Changelog

3.2.7

Bug Fixes

  • Fix JSON Schema for OneOf when required is present. #453

  • Allow fixed-type when the nested type in array is six characters. #463

  • Fix a few issues with codeblocks format.

3.2.6

Bug Fixes

  • Fix JSON Schema support for nullable with enums. #455

3.2.5

Bug Fixes

  • Action identifiers may now contain ( and ) characters.

    ## My Action (Deprecated) [GET]

3.2.4

Bug Fixes

  • Parameters values in API Elements are always serialized as API Element strings. This ensure consistency with API Blueprint AST and to prevent values being serialized differently. For example boolean of value 1 in API Blueprint AST would be treated as a string and therefore be serialized as 1. However in API Elements it wouldn't be treated as truthy since 1 is not equal to true and would be serialized as false.

3.2.3

Bug Fixes

  • Prevent exposing duplicate parameters in API Elements output when a parameter is overshadowed.

  • Fix support for escaped MSON-style parameters. #445

3.2.2

Bug Fixes

  • Ensure that escaped property names in MSON are not treated as markdown. snowcrash#422

3.2.1

Bug Fixes

  • Properly handle MD "code fences" while parsing headers (related to changes in sundown paser)

  • fix crash - changes in sundown leads to crash for undisclosed item list

3.2.0

Enhancements

  • Improved sourcemaps of warnings when encountering malformed headers

  • Added warning when default and sample is specified without value

  • Improved JSON Schema regarding defaults #424

3.1.3

Bug Fixes

  • Handle fixed-type with variable property names when generating JSON Schemas. #390

  • Drafter will now check the validity of header names and provide a warning for invalid characters found within a header name. Invalid headers will be skipped in the parse outputs. #382

  • Fix handling of escaped parameter identifiers with the older non-MSON parameter syntax. #391

  • Rectify JSON Schema generation for variable property names #367

3.1.2

Enhancements

  • Add missing sourcemaps for named type references #386

  • Warn user on "action" with non-absolute path #350

Bug Fixes

  • Prevent crashing and improve structure of result from parsing regarding markdown lists.

  • Correctly set the content type for custom JSON Schema. #392

  • Fix the JSON Schema generated when using fixed-type attribute #389

  • Fix and improve URI Template parameters validation #402

3.1.1

Bug Fixes

  • Prevent crashing when no default value is specified for enum members

3.1.0

Enhancements

  • Warn when primitive values in MSON doesn't follow the given type format #334

Bug Fixes

  • While overriding a property on an inherited object, the description and type annotation was not being overridden. #366

  • Always give an error when unable to find named type. snowcrash#354

  • Ensure that escaped values in MSON are not treated as markdown #365

  • Fixes detection of parameters using the MSON syntax when the description of a parameter includes ( or ). snowcrash#345

3.1.0-pre.0

Enhancements

  • Warn about reserved characters in Named type declaration. snowcrash#335

  • Add fixed-type keyword support. mson#66

  • Add warnings when the given MSON type attributes contradict each other.

Bug Fixes

  • Ensure that sample values are rendered in JSON Schema when using the fixed attribute. #343

  • Prevents an empty properties section being treated as an unrecognized block. #127 snowcrash#200

  • Fixes rendering when One Of contains member sections with named types. #360

  • Default and sample enum values will take precedence as the example value in the rendered JSON structure over the enum members.

  • Add type attributes for array values. #193

  • Value members with required will not have items in JSON Schema anymore. #371

  • Ensures that MSON validation warnings are present when generating APIB AST.

  • Improved validation of Request keyword matching.

3.0.0

Breaking

  • Drafter now uses C++11.

    The following compiler versions are supported:

    • Microsoft Visual C++ 2013 or higher
    • GCC 4.8 or higher
    • Clang 3.5 or higher

Enhancements

  • Drafter now provides a full C and C++ API interface, you may now validate, parse and serialize an API Blueprint. Please see drafter.h header for full API documentation.

  • Improve error messages for a few blueprint errors

Bug Fixes

  • Correctly render named primitive types when used as a nested or member type such as items (array[Other Type]) in JSON. #312

  • Fixes an issue where defining an implicit object data structure would raise an invalid syntax warning and not be parsed. #318

  • Prevent causing an infinite loop when parsing a resource which inherits from itself. #328

  • Correctly parse object samples within arrays. #246

  • Correctly render JSON Schema when fixed is used on attributes section or named type mson#60

2.3.1

Bug Fixes

  • Fixes a bug when a referenced mixin inherits another named type #254

  • Some of the errors have been changed to warnings

  • Fixes "One Of" JSON rendering. This fix does not include JSON schema for multiple One of definition in MSON object. #288

2.3.0

Bug Fixes

  • Parameters in Refract output will no longer contain a content value when there is no sample value. #286

  • Errors raised from Snowcrash, the underlying parser are now treated as errors. This resolves an issue where Drafter would get into an infinite loop when certain circular references are found in MSON Data Structures. #255

  • Errors raised from drafter are now correctly treated as errors, previously they were exposed as warnings.

  • Improved error reporting with source maps when using cdrafter.

  • Resolved an issue when using a mixins from implicit objects would raise a warning that the implicit object was not an object. #138 #243

2.3.0-pre.2

This release restores an API that caused a breaking change in the previous pre-release 2.3.0-pre.1.

2.3.0-pre.1

Bug Fixes

  • It was causing lot of different problems like segmentation faults, stack overflows or even infinite loops depending on what error was ignored. #269

  • Variable property name issues are fixed including correct generation of JSON Schema.

  • Improved error reporting. Some of the semantic errors like circular references were issued without a sourcemap information, that is not the case anymore.

  • httpRequest and httpResponse payloads now have source maps attached while using the Refract output. #259

2.3.0-pre.0

Enhancements

  • Partial implementation of RFC 4: Request Parameters has been added. Request parameters are now parsed, however validation of these parameters is not yet handled.

  • Adds support for building Drafter with Microsoft Visual Studio 2015.

Bug Fixes

  • The content-type for JSON Schema messageBodySchema is now correctly application/schema+json.

  • Fixes a problem while rendering JSON Schema may have resulted in an ExtendElement warning. #217

2.2.0

Enhancements

  • The JavaScript API has been aligned with the Protagonist binding, allowing you to use Drafter JS and Protagonist with the same interface.

Bug Fixes

  • Fixes a crash when handling circular references in MSON Mixins.