docs(event-handler): extract and fix REST code examples

[michaelbrewer]

Issue number:

• fixes Docs: Event Handler - Broken AWS Serverless Application Model (SAM) example #1069
• fixes Docs: Event Handler - Rest API - Example response.json in fined grained responses not formatted correctly #1223
• split from Docs: Move code snippets into dedicated python files add formatting and linting, fixing any outstanding errors #1064
• original pr: fix(docs): extract code snippets into dedicated python files and fix examples #1065

Summary

Extracts code examples from the event handler for rest apis, fixes code and yaml

Changes

Please provide a summary of what's being changed

Changes:

• Extract code examples
• Fix python examples and yaml files
• Run isort and black
• Add make task to format, compile and lint examples to prevent future errors
• Update layer version to 20 (1.26.1)

Bug fixes in this PR:

• Fix SAM example for Rest api (and fixes Docs: Event Handler - Broken AWS Serverless Application Model (SAM) example #1069) REST API : Required resources (See issue Docs: Event Handler - Broken AWS Serverless Application Model (SAM) example #1069 )
• Fix json response example in Rest API - Fine grained response - Not formatted as json ( See issue Docs: Event Handler - Rest API - Example response.json in fined grained responses not formatted correctly #1223 )

User experience

Please share what the user experience looks like before and after this change

SAM template example can now be used without errors

Hosted version is here: https://gyft.github.io/aws-lambda-powertools-python/latest/

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of my this change
• Changes are tested
• Changes are documented
• PR title follows conventional commit semantics

Is this a breaking change?

RFC issue number:

Checklist:

• Migration process documented
• Implement warnings (if it can live side by side)

Acknowledgment

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

---

View rendered docs/core/event_handler/api_gateway.md

[codecov-commenter]

Codecov Report

Merging #1117 (d7b10d3) into develop (f62d07a) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1117   +/-   ##
========================================
  Coverage    99.88%   99.88%           
========================================
  Files          119      119           
  Lines         5423     5423           
  Branches       618      618           
========================================
  Hits          5417     5417           
  Misses           2        2           
  Partials         4        4           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update f62d07a...d7b10d3. Read the comment docs.