-
Notifications
You must be signed in to change notification settings - Fork 54
Escaping parameter names and values fails #391
Comments
Old parameter format doesn't support escaping for the parameter name. This is intentional. |
Huh, what? Why? Is it documented somewhere? I haven't found it. |
Old parameter format is not an MSON format. Escaping as a concept only exists in MSON. Old parameter format is deprecated currently. |
I see, so we should issue deprecation warning I suppose as this is confusing. |
We currently support both formats albeit one of them without being the spec. MSON parameters and headers RFC should take care of this later. I am closing this for now. |
This is not solved really, as it is nowhere to be seen that I am using deprecated feature. |
It is not deprecated yet. But there is no mention of the old format anywhere in the spec. |
So lets clarify it somehow (spec, docs, warning) and then we can close it. |
A parameter list item such as ``+ `u_u` (required, string, `a_a`)`` was being treated as an MSON aligned parameter when it wasn't. Fixes apiaryio/drafter#391
Following APIB produces warning on the first parameter
warning: (3) unable to parse additional parameter traits, expected '([required | optional], [<type> | enum[<type>])', e.g. '(optional, string)'; line 8, column 7 - line 8, column 38
If the escaping takes place on the parameter name as well as example value it fails.
CURRENT WORKAROUND
Use different syntax for the example:
The text was updated successfully, but these errors were encountered: