feat(event_source): decode nested messages on SQS events

[rafaelgsr]

Issue number: #2348

Summary

Changes

Adding decode_nested_s3_event and decode_nested_sns_event functions on SQSEvent to decode nested events originated from S3 and SNS, respectively.

User experience

@event_source(data_class=SQSEvent)
def lambda_handler(event: SQSEvent, context):
     for record in event.records:
        nested_event: S3Event = record.decoded_nested_s3_event

Checklist

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

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been 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.

[boring-cyborg]

Thanks a lot for your first contribution! Please check out our contributing guidelines and don't hesitate to ask whatever you need.
In the meantime, check out the #python channel on our Powertools for AWS Lambda Discord: Invite link

[rubenfonseca]

@leandrodamascena @rafaelgsr what's the status of this PR? What's needed?

[heitorlessa]

reiterating the ask @leandrodamascena @rafaelgsr before we take over

[rafaelgsr]

@heitorlessa @rubenfonseca hey folks, sorry my delayed response. I was on vacations and then on a business trip. I'll resume working on this next week and come up with a proposal based on what @cowsandmilk mentioned.

[codecov-commenter]

Codecov Report

Patch coverage: 100.00% and no project coverage change.

Comparison is base (a7e23dd) 97.23% compared to head (a2c7d39) 97.23%.

❗ Your organization is not using the GitHub App Integration. As a result you may experience degraded service beginning May 15th. Please install the Github App Integration for your organization. Read more.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #2349   +/-   ##
========================================
  Coverage    97.23%   97.23%           
========================================
  Files          161      161           
  Lines         7415     7426   +11     
  Branches       538      538           
========================================
+ Hits          7210     7221   +11     
  Misses         158      158           
  Partials        47       47           

Impacted Files	Coverage Δ
...bda_powertools/utilities/data_classes/sns_event.py	100.00% <100.00%> (ø)
...bda_powertools/utilities/data_classes/sqs_event.py	98.97% <100.00%> (+0.12%)	⬆️

☔ View full report in Codecov by Sentry.
📢 Do you have feedback about the report comment? Let us know in this issue.

[rubenfonseca]

This looks great, thank you @rafaelgsr !

[boring-cyborg]

Awesome work, congrats on your first merged pull request and thank you for helping improve everyone's experience!