fix(docs): Extract rest event handler examples

Changes:
- Extract code examples
- Fix python and yaml files
- Run isort and black
- Add make task

Closes:
- aws-powertools#1069

Related:
- aws-powertools#1064

Author: michaelbrewer

Diff for: Makefile

@@ -90,3 +90,14 @@ changelog:
 
 mypy:
 	poetry run mypy --pretty aws_lambda_powertools
+
+format-examples:
+	poetry run isort docs/examples
+	poetry run black docs/examples/*/*/*/*.py
+	poetry run black docs/examples/*/*/*/*/*.py
+
+lint-examples:
+	poetry run python3 -m py_compile docs/examples/*/*/*/*.py
+	poetry run python3 -m py_compile docs/examples/*/*/*/*/*.py
+	cfn-lint docs/examples/*/*/*/*.yml
+	cfn-lint docs/examples/*/*/*/*/*.yml