search

Open-Network-Models-and-Interfaces-ONMI / TAPI

LF ONMI Transport API Repository (TAPI)
https://github.com/Open-Network-Models-and-Interfaces-ONMI/TAPI/wiki
Apache License 2.0
95 stars 80 forks source link

OAS Document Structure #392

Closed damianoneill closed 3 years ago

damianoneill commented 5 years ago

Per OAS Document Structure definition can the OAS output be updated to include a root document, openapi.yaml that includes the multiple documents that are generated in OAS

amazzini commented 3 years ago

The multiple generated documents are described in the script https://github.com/OpenNetworkingFoundation/TAPI/blob/develop_v2_1/YANG/yang2oas213.txt used for OAS generation, where the dependencies between YANG modules are specified. There are two important aspects: 1) The order in which YANG modules are listed, which specifies the dependencies between modules. 2) The last YANG module in the row becomes the generated YAML module, e.g.

[6]='tapi-common tapi-notification tapi-topology tapi-path-computation tapi-connectivity'

generates the tapi-connectivity.yaml file.