microsoft / OpenAPI.NET

The OpenAPI.NET SDK contains a useful object model for OpenAPI documents in .NET along with common serializers to extract raw OpenAPI JSON and YAML documents from the model.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Consolidate slicing to OpenApi.NET lib

peombwa opened this issue · comments

Is your feature request related to a problem? Please describe.
To improve the efficiency and consistency of creating subsets by downstream tools, we should look at consolidating slicing functionality into the OpenApi.NET library. The functionality will be used to support dynamic creation of OpenAPI subsets in SK.

Describe the solution you'd like
The library should offer methods on the OpenApiDocument instance that support slicing based on the following OpenAPI constructs:

  • Tags: This functionality is currently available in both Hidi and DevX API.
  • OperationIds: This functionality is also present in Hidi and DevX API.
  • Paths: This functionality is currently implemented in Kiota. We should adopt Kiota's path filtering syntax for this purpose.

Describe alternatives you've considered
While using a predicate works, it is a low-level solution that necessitates defining the same slicing logic in multiple places where we depend on the library. Consolidating the slicing functionality into the OpenApi.NET library would eliminate this redundancy.

Additional context
N/A