Data structures 作为API蓝图数据结构的基元类型

Data structures 作为API蓝图数据结构的基元类型,data-structures,apiblueprint,aglio,mson,Data Structures,Apiblueprint,Aglio,Mson,我想使用原语类型来描述数据结构。像这样: # Data Structures ## Video Delete (enum[number]) + `0` - Successful deletion. + `1` - Error occured. 输出为 { "enum": [ 1, 0 ], "$schema": "http://json-schema.org/draft-04/schema#" } 所以描述不见了。我试着把描述放在不同

我想使用原语类型来描述数据结构。像这样:

# Data Structures

## Video Delete (enum[number])
+ `0` - Successful deletion.
+ `1` - Error occured.
输出为

{
    "enum": [
        1,
        0
    ],
    "$schema": "http://json-schema.org/draft-04/schema#"
}
所以描述不见了。我试着把描述放在不同的地方。我做了很多事情(不想谈论它们)。我还尝试向枚举值添加信息,如下所示:

+ `0` (number) - Successful deletion.

我不知道这个问题是与MSON语法有关还是与Aglio生成器有关。

据我所知,MSON支持上述语法。问题是Aglio没有对这个描述做任何事情,当我开始考虑添加它时,我意识到在JSON模式中并不真正支持它。人们似乎用两种方法来回避这个事实:

<> >将枚举值描述添加到主描述中,OLIO主题1.62支持此,但是C++分析器在这个特性方面仍然存在一些缺陷:

##视频删除(枚举[编号])-0表示成功,1表示错误

  • 使用一种奇怪的
    oneOf
    语法,在该语法中可以创建带有描述的单个枚举集。我不推荐这个

  • 不幸的是,第一个选项需要您自己的工作,在Aglio中无法轻松完成。其他人有更好的描述和MSON input->JSON模式输出的一些示例吗