refactor!(jmespath_utils): deprecate extract_data_from_envelope in jmespath_utils and replace with query

[n-k1]

Issue number: #4218

Summary

Changes

• Added a query method in jmespath_utils/__init__.py with the same implementation as extract_data_from_envelope
• Added a warning to extract_data_from_envelope and updated docstring

User experience

extract_data_from_envelope will continue to work with a deprecation warning and will be removed in the next major version. query will replace extract_data_from_envelope.

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?

This is not a breaking change. extract_data_from_envelope will continue to work with a deprecation warning and will only be removed in the next major version.

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