feat(event_handler): add VPCLatticeResolver

[leandrodamascena]

Issue number: #2577

Summary

Changes

Amazon VPC Lattice is a fully managed application networking service that you use to connect, secure, and monitor the services for your application across multiple accounts and virtual private clouds (VPC). You can register your Lambda functions as targets with a VPC Lattice target group, and configure a listener rule to forward requests to the target group for your Lambda function.

In this PR we create a new resolver to support VPC Lattice.

User experience

Customers can use this new resolver to get the benefits of using the Event Handler utility.

import requests
from requests import Response

from aws_lambda_powertools.event_handler import VPCLatticeResolver
from aws_lambda_powertools.utilities.typing import LambdaContext

app = VPCLatticeResolver()

@app.get("/get")
def get_todo():
    todos: Response = requests.get("https://jsonplaceholder.typicode.com/todos")
    todos.raise_for_status()

    # for brevity, we'll limit to the first 10 only
    return {"todos": todos.json()[:10]}

def lambda_handler(event: dict, context: LambdaContext) -> dict:
    return app.resolve(event, context)

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.

[codecov-commenter]

Codecov Report

Patch coverage: 94.44% and project coverage change: -0.06 ⚠️

Comparison is base (e6a999e) 97.22% compared to head (1ac1504) 97.16%.

❗ 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    #2601      +/-   ##
===========================================
- Coverage    97.22%   97.16%   -0.06%     
===========================================
  Files          160      161       +1     
  Lines         7394     7416      +22     
  Branches       537      525      -12     
===========================================
+ Hits          7189     7206      +17     
- Misses         158      161       +3     
- Partials        47       49       +2     

Impacted Files	Coverage Δ
...lambda_powertools/utilities/data_classes/common.py	99.21% <66.66%> (-0.79%)	⬇️
aws_lambda_powertools/event_handler/__init__.py	100.00% <100.00%> (ø)
aws_lambda_powertools/event_handler/api_gateway.py	100.00% <100.00%> (ø)
aws_lambda_powertools/event_handler/vpc_lattice.py	100.00% <100.00%> (ø)
aws_lambda_powertools/logging/correlation_paths.py	100.00% <100.00%> (ø)
aws_lambda_powertools/utilities/batch/types.py	80.00% <100.00%> (-1.25%)	⬇️
...a_powertools/utilities/data_classes/vpc_lattice.py	92.50% <100.00%> (+0.60%)	⬆️
...ools/utilities/idempotency/persistence/dynamodb.py	98.80% <100.00%> (ø)
...s_lambda_powertools/utilities/parser/models/sns.py	100.00% <100.00%> (ø)

... and 3 files with indirect coverage changes

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

[rubenfonseca]

Looking at this now

[rubenfonseca]

Thank you @leandrodamascena ! Super nice work!

It would be nice to have some E2E tests for this, but as I understand correctly, it's still hard to get this on CDK, right?

[leandrodamascena]

Thank you @leandrodamascena ! Super nice work!

It would be nice to have some E2E tests for this, but as I understand correctly, it's still hard to get this on CDK, right?

Yes Rubens! We need to create a VPC + VPC Lattice Network + Listener + Association + A Lambda inside this VPC and we can't invoke the VPC Lattice endpoint outside the vpc because it's not a public endpoint.

[rubenfonseca]

Looks awesome, thank you @leandrodamascena !