Repository navigation
Feature request: Mark API operation as deprecated for OpenAPI documentation #5674
Description
Use case
When customizing API operations, I'd like to be able to mark an operation as deprecated (see Operation Object, OAS v3.0.3).
This helps to tell the users that an operation will be, well, deprecated. Here's what it looks like with Petstore example in Swagger Editor:
Solution/User Experience
An extra deprecated boolean parameter with a False default:
from aws_lambda_powertools.event_handler import APIGatewayRestResolver
from aws_lambda_powertools.event_handler.api_gateway import Router
app = APIGatewayRestResolver()
@app.get("/spam", deprecated=True)
def spam(name):
return {"message": "mmm... tasty"}
@app.get("/eggs") # deprecated=False by default
def eggs(name):
return {"message": "cheese"}
router = Router()
@router.get("/ham", deprecated=True)
def ham():
return {"message": "ham!"}Acknowledgment
- This feature request meets Powertools for AWS Lambda (Python) Tenets
- Should this be considered in other Powertools for AWS Lambda languages? i.e. Java, TypeScript, and .NET
Thanks for your hard work!
Reacted by Sarthak and Alex
Activity
boring-cyborg commentedon Dec 1, 2024
Thanks for opening your first issue here! We'll come back to you as soon as we can.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link
anafalcao commentedon Dec 10, 2024
Hi @tcysin ! Thanks for opening this feature request, and sorry for the delay, we were at re:invent last week.
Would you like to open a PR with your solution or do you prefer us to work on it and come back to you?
tcysin commentedon Dec 12, 2024
It's all good 👍
Yeah, I'm giving it a try.
github-actions commentedon Dec 19, 2024
This issue is now closed. Please be mindful that future comments are hard for our team to see.
If you need more assistance, please either tag a team member or open a new issue that references this one.
If you wish to keep having a conversation with other community members under this issue feel free to do so.