[asterisk-bugs] [JIRA] (ASTERISK-25406) Misc anomalies in Swagger definitions

[Asterisk Team (JIRA)]

    [ https://issues.asterisk.org/jira/browse/ASTERISK-25406?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=227625#comment-227625 ] 

Asterisk Team commented on ASTERISK-25406:
------------------------------------------

Thanks for creating a report! The issue has entered the triage process. That means the issue will wait in this status until a Bug Marshal has an opportunity to review the issue. Once the issue has been reviewed you will receive comments regarding the next steps towards resolution.

A good first step is for you to review the [Asterisk Issue Guidelines|https://wiki.asterisk.org/wiki/display/AST/Asterisk+Issue+Guidelines] if you haven't already. The guidelines detail what is expected from an Asterisk issue report.

Then, if you are submitting a patch, please review the [Patch Contribution Process|https://wiki.asterisk.org/wiki/display/AST/Patch+Contribution+Process].

> Misc anomalies in Swagger definitions
> -------------------------------------
>
>                 Key: ASTERISK-25406
>                 URL: https://issues.asterisk.org/jira/browse/ASTERISK-25406
>             Project: Asterisk
>          Issue Type: Improvement
>      Security Level: None
>          Components: Resources/res_ari
>    Affects Versions: 13.5.0
>            Reporter: Lorenzo Emilitri
>            Severity: Minor
>
> I am rewriting the parser that generates ari4java bindings out of Swagger files, and I'm noticing a number of issues/anomalies. As Swagger files are supposed to be machine-parsed, they should match a given format without anomalies.
> The following fields are/have typos:
> Unrecognized field "defalutValue" (class ch.loway.oss.ari4java.codegen2.models.ApiParameter)
>  at [Source: ./codegen-data/ari_1_8_0/channels.json; line: 310, column: 25]
> Unrecognized field "descriptioni" (class ch.loway.oss.ari4java.codegen2.models.ApiParameter)
>  at [Source: ./codegen-data/ari_1_8_0/endpoints.json; line: 58, column: 25] 
>  Unrecognized field "descriptioni" (class ch.loway.oss.ari4java.codegen2.models.ApiParameter)
>  at [Source: ./codegen-data/ari_1_8_0/endpoints.json; line: 180, column: 25] 
>  Unrecognized field "__note" 
>  at [Source: ./codegen-data/ari_1_8_0/sounds.json
> (Either we add a "note" field for good, or we'd better drop it).
> I am also trying to generate enums to assist in code refactoring and making code clean where a parameter has a given set of values.
> In general, restricted values are a mix of upper, lower and CamelCase, but some anomalies stand out (I print them here as :
> EDeviceState=[BUSY, INUSE, INVALID, NOT_INUSE, ONHOLD, RINGING, RINGINUSE, UNAVAILABLE], 
> EDeviceStateState=[BUSY, INUSE, INVALID, NOT_INUSE, ONHOLD, RINGING, RINGINUSE, UNAVAILABLE, UNKNOWN], 
> - DeviceStates appear twice, with a different set of entries!
> EChannelState=[Busy, Dialing, Dialing Offhook, Down, OffHook, Pre-ring, Ring, Ringing, Rsrved, Unknown, Up]}
> - "Rserverd"?



--
This message was sent by Atlassian JIRA
(v6.2#6252)