Maintenance: Refactor and split documentation snippets to standalone python files

[heitorlessa]

Summary

We should refactor documentation snippets to improve the value new and existing customers get from them. Code snippets should be run as-is and provide what's necessary to demonstrate an utility's feature value - it might need to make an external API call to a fake API, raise Exceptions, etc.

Example of a recent work part of ~152 doc snippets refactoring: https://awslabs.github.io/aws-lambda-powertools-python/latest/core/event_handler/api_gateway/#api-gateway-rest-api

Tasks:

• [x] #1367
• [x] #1368
• [x] #1369
• [x] #1370
• [ ] #1371
• [x] #1372
• [x] #1373
• [x] #1374
• [x] #1453
• [ ] #1163

Why is this needed?

Besides improving customer value, it helps us lint and enforce consistency across the documentation.

Which area does this relate to?

Middleware factory, Parameters, Batch processing, Validation, Parser, Idempotency, Feature flags, JMESPath functions

Solution

No response

Acknowledgment

• [X] This request meets Lambda Powertools Tenets
• [ ] Should this be considered in other Lambda Powertools languages? i.e. Java, TypeScript

[leandrodamascena]

Hi @heitorlessa. Please add this issue #1453 to the task list.