docs(validation): extract and fix code examples

[michaelbrewer]

Issue number:

• 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

Extract code examples for validation documentation

Changes

Please provide a summary of what's being changed

Changes:

• Extract code examples
• Run isort and black
• Fix python syntax errors
• Update line highlights
• Add make task to lint and format examples to prevent future errors

Bug Fixes included in this PR:

• Fix name for validator_function.py example, see Validation - Validate function
• Fix ht_line invalid syntax in Validation - Validating custom formats - schema.py

User experience

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

Fixes some of the python code examples, and added linting and syntax checks to prevent regressions.

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/utilities/validation.md

[codecov-commenter]

Codecov Report

Merging #1128 (89cb216) into develop (9d8dd1b) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1128   +/-   ##
========================================
  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 9d8dd1b...89cb216. Read the comment docs.