feat(event-source): add function to get multi-value query string params by name

[TonySherman]

Issue number: #3845

Summary

Changes

This adds a helper function to retrieve a list of multi-value query string params similar to the get_query_string_value function.

User experience

Rather than getting the entire dictionary of multi-value parameters (multi_value_query_string_parameters), users
can get a single list of parameters by the name of the parameter.

event.get_multi_value_query_string_values(name='param', default_values=['value_1']

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.

[heitorlessa]

Thanks a lot @TonySherman for following through our Discord chat -- reviewing and merging this today

[heitorlessa]

tiny changes to return a default instead of None.

• Empty dict if you try to get all multi-value query strings params when there are none
• Empty list if you try to get a specific multi-value query string param that does not exist

The adjacent code has a tech debt we plan to pay in v3, where all Optional will have empty defaults.. dict, lists, etc. So we can fix this one now as it's an addition

[heitorlessa]

I'm gonna accept the changes as we need to make a patch release shortly before you're awake ;)

[codecov-commenter]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 96.42%. Comparing base (e14e768) to head (cf183c4).
Report is 93 commits behind head on develop.

❗ Current head cf183c4 differs from pull request most recent head ab5f09e. Consider uploading reports for the commit ab5f09e to get more accurate results

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

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3846      +/-   ##
===========================================
+ Coverage    96.38%   96.42%   +0.04%     
===========================================
  Files          214      214              
  Lines        10030    10101      +71     
  Branches      1846     1866      +20     
===========================================
+ Hits          9667     9740      +73     
+ Misses         259      258       -1     
+ Partials       104      103       -1     

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

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues

Measures
0 Security Hotspots
No data about Coverage
4.6% Duplication on New Code

See analysis details on SonarCloud