openapi2aspida icon indicating copy to clipboard operation
openapi2aspida copied to clipboard

Output deprecated endpoints with deprecation annotations

Open dadajam4 opened this issue 1 year ago • 0 comments

Description

Currently, if an OpenAPI endpoint is marked as deprecated, it seems it won't be output as an endpoint in Aspida. This is problematic because clients won't be able to call the API during gradual specification changes.

Describe the solution you'd like

It would be great to add an option to the Aspida generation settings that allows outputting configurations such as endpoints, even when marked as deprecated.

Describe alternatives you've considered

We'll refrain from setting deprecated flags on the application side. However, this isn't preferable for managing extensive API specification changes.

Additional context

I suspect that the implementation around the following areas is likely relevant.

https://github.com/aspida/openapi2aspida/blob/58696c365396b7527ac6aa670b777e7d196390be/src/buildV3.ts#L70

dadajam4 avatar Mar 12 '24 03:03 dadajam4