docs(metrics): 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
• Fixes : Docs: Metrics - Assert multiple EMF blobs with pytest has invalid python syntax #1212
• Fixes : Docs: Metrics - Invalid AWS Serverless Application Model (SAM) example #1213

Summary

Extract code examples from the metric documentation and fix python syntax errors and yaml formatting and errors

Changes

Please provide a summary of what's being changed

Changes:

• Extract code examples
• Run isort and black
• Fix python and yaml examples
• Update line highlights
• Add make task to run formatter and linting to prevent future errors

Bug Fixes included in this PR:

• Fix python syntax ',' or ')' expected on Metrics - Assert multiple EMF blobs with pytest example ( See issue Docs: Metrics - Assert multiple EMF blobs with pytest has invalid python syntax #1212 )
• Fix metrics SAM Metrics - template.yml with missing attributes ( See issue Docs: Metrics - Invalid AWS Serverless Application Model (SAM) example #1213 )
• Fix missing imports for Metrics - Clear metrics tests

User experience

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

SAM templates are not correctly formatted and python examples don't include syntax errors.

Hosted version for testing has been publish 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/metrics.md

[codecov-commenter]

Codecov Report

Merging #1122 (212615e) into develop (f62d07a) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff            @@
##           develop    #1122   +/-   ##
========================================
  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...212615e. Read the comment docs.