feat(event_handler): support any Pydantic Field annotation in parameter

[leandrodamascena]

Issue number: closes #8304

Summary

Changes

This PR makes any Pydantic Field annotation work with any parameter location (Path/Query/Header/Body).

I generalized that path so a plain Field and a location marker can be combined freely. The discriminator case is now just one example of the general behavior, not a special case.

User experience

Before, this raised an error. Now it just works:

StrField = Annotated[str, Field()]

@app.get("/items")
def get_items(q: Annotated[StrField, Query]):           # works
    ...

@app.get("/count")
def get_count(n: Annotated[int, Field(gt=0), Query]):   # gt=0 enforced (422 on n <= 0)
    ...

---

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]

Codecov Report

❌ Patch coverage is 94.73684% with 1 line in your changes missing coverage. Please review.
✅ Project coverage is 96.63%. Comparing base (6c203ea) to head (7c4223b).

Files with missing lines	Patch %	Lines
..._lambda_powertools/event_handler/openapi/params.py	94.73%	0 Missing and 1 partial ⚠️

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #8305   +/-   ##
========================================
  Coverage    96.62%   96.63%           
========================================
  Files          296      296           
  Lines        14686    14689    +3     
  Branches      1230     1231    +1     
========================================
+ Hits         14191    14194    +3     
  Misses         360      360           
  Partials       135      135           

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

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[mergify]

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

• Queue this pull request

[sonarqubecloud]

Quality Gate passed

Issues
1 New issue
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud