feat(event_handler): add support for multiValueQueryStringParameters in OpenAPI schema

[leandrodamascena]

Issue number: #3622

Summary

Changes

This pull request enhances the OpenAPI utility by introducing support for multiValueQueryStringParameters in the OpenAPI schema. Previously, our utility encountered issues parsing multi-value query fields, leading to errors for customers attempting to utilize such fields. Work did:

• Added support for multiValueQueryStringParameters in the OpenAPI schema.
• Resolved parsing issues previously encountered when dealing with multi-value fields in different Resolvers.
• Added new tests

User experience

Using the code below now we can validate multi value param.

from enum import Enum
from http import HTTPStatus

from aws_lambda_powertools.event_handler import APIGatewayRestResolver
from aws_lambda_powertools.event_handler.openapi.params import Query
from aws_lambda_powertools.shared.types import Annotated
from aws_lambda_powertools.utilities.typing import LambdaContext

app = APIGatewayRestResolver(enable_validation=True)


class ExampleEnum(Enum):
    """Example of an Enum class."""

    ONE = "value_one"
    TWO = "value_two"
    THREE = "value_three"


@app.get("/example-resource")
def get(
    example_multi_value_param: Annotated[
        ExampleEnum,
        Query(
            description="This should be a multi value query parameter."
        ),  # TODO: How should this represent multi-value query string parameters?
    ]
):
    """Return validated multi-value param values."""
    return example_multi_value_param


def lambda_handler(event: dict, context: LambdaContext):
    """Handler to route API Gateway events."""
    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

Attention: 1 lines in your changes are missing coverage. Please review.

Comparison is base (517acd6) 95.57% compared to head (ee83b1b) 95.65%.
Report is 5 commits behind head on develop.

Files	Patch %	Lines
...lambda_powertools/utilities/data_classes/common.py	66.66%	1 Missing ⚠️

❗ Your organization needs to install the Codecov GitHub app to enable full functionality.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3667      +/-   ##
===========================================
+ Coverage    95.57%   95.65%   +0.07%     
===========================================
  Files          214      214              
  Lines         9993    10031      +38     
  Branches      1827     1840      +13     
===========================================
+ Hits          9551     9595      +44     
+ Misses         329      326       -3     
+ Partials       113      110       -3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[rubenfonseca]

Great job diving deep into OpenAPI :D Just left some small things

[leandrodamascena]

Great job diving deep into OpenAPI :D Just left some small things

Thanks @rubenfonseca! Can you review it again pls?

[sonarqubecloud]

Quality Gate passed

The SonarCloud Quality Gate passed, but some issues were introduced.

1 New issue
0 Security Hotspots
No data about Coverage
No data about Duplication

See analysis details on SonarCloud

[rubenfonseca]

Great job, I've also checked the highlights in the documentation and it looks good!