refactor(parameters): improve typing for get_secret method

[TonySherman]

Issue number:
#3909

Summary

Changes

Adds overloads to get_secret, very similar to #3534

Please provide a summary of what's being changed

User experience

Type checkers should return the expected type based on the value in the transform argument.

If None, return type should be str
If "json", return type should be dict
If "binary", return type should be bytes
If "auto", return type should be bytes

Please share what the user experience looks like before and after this change

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

All modified and coverable lines are covered by tests ✅

Project coverage is 96.35%. Comparing base (e14e768) to head (90bb5f0).
Report is 138 commits behind head on develop.

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

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #3910      +/-   ##
===========================================
- Coverage    96.38%   96.35%   -0.03%     
===========================================
  Files          214      214              
  Lines        10030    10126      +96     
  Branches      1846     1873      +27     
===========================================
+ Hits          9667     9757      +90     
- Misses         259      265       +6     
  Partials       104      104              

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

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

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

See analysis details on SonarCloud

[leandrodamascena]

Thanks for helping us improve the developer experience by adding these overloads and typing autocomplete in the IDE @TonySherman!

APPROVED!