Generate separate service files automatically based on the tags in OpenAPI defintion

[RakhithaRR]

Description:
Currently, the ballerina openapi gen tool provides the --tag flag which can be used to generate separate service files manually. However, this is not easy when there are lots of resources with different tags. It would be helpful if there was a way to automatically generate service files based on the tags assigned for each resource in the OpenAPI definition.

A sample definition can be found in [1].

[1] - https://github.com/wso2/carbon-apimgt/blob/master/components/apimgt/org.wso2.carbon.apimgt.rest.api.publisher.v1/src/main/resources/publisher-api.yaml

Describe your problem(s)

Describe your solution(s)

Related Issues (optional):

Suggested Labels (optional):

Suggested Assignees (optional):

@lnash94

[lnash94]

We had a basic feasibility study with this requirement. During that, we identified an issue that

• if one operation has multiple tags, it will automatically duplicate with several ballerina services and it causes to have compilation errors.

example openapi spec

paths:
  /store/inventory:
    get:
      tags:
       - store
       - pet
      summary: Returns pet inventories by status
      description: Returns a map of status codes to quantities
      operationId: "id_01"
      responses:
        "200":
          description: successful operation

This is one of the issues that we can encounter currently and there can be issues with service endpoint binding as well (still assuming couldn't test it).
Furthermore, we will be investigating the ability to provide this feature. Once we complete the background testing, will update this issue.