aws_iam auth - rename auth method, add tests

[briantist]

SUMMARY

Fixes: #118

This PR contains several changes to AWS auth support:

• the name of the auth method is changing from aws_iam_login to aws_iam. This corrects an error that I made when introducing it, including the hvac "login" convention as part of the auth method name. That is corrected in this PR, in doc fragments, choices, class and file names, etc. The old name will work until 3.0.0 when it will be removed, and warning is displayed if the old name is used.
• Fill out the unit tests for this method.
• Adds mmock to the integration test dependencies and the docker localenv setup. This allows for mocking API calls and acting as a proxy. That lets us do some level of integration testing against stuff we can't easily integrate Vault with, like in this case: AWS
• Add the integration tests for aws_iam auth!
• Update the localenv docs for MMock

ISSUE TYPE

• Tests/Enhancement Pull Request

COMPONENT NAME

aws_iam auth

ADDITIONAL INFORMATION

N/A

[codecov]

Codecov Report

Merging #193 (2fc510a) into main (8852550) will increase coverage by 1.52%.
The diff coverage is 98.62%.

@@            Coverage Diff             @@
##             main     #193      +/-   ##
==========================================
+ Coverage   92.43%   93.96%   +1.52%     
==========================================
  Files          41       41              
  Lines        1639     1739     +100     
  Branches      125      135      +10     
==========================================
+ Hits         1515     1634     +119     
+ Misses        111       91      -20     
- Partials       13       14       +1     

Flag	Coverage Δ
env_docker-default	93.96% <98.62%> (+1.52%)	⬆️
integration	78.36% <62.50%> (+1.79%)	⬆️
sanity	37.44% <37.50%> (-0.21%)	⬇️
target_ansible-doc	100.00% <ø> (ø)
target_auth_approle	89.47% <ø> (ø)
target_auth_aws_iam	50.00% <100.00%> (?)
target_auth_cert	86.36% <ø> (ø)
target_auth_jwt	91.30% <ø> (ø)
target_auth_none	100.00% <ø> (ø)
target_auth_token	71.42% <ø> (ø)
target_auth_userpass	85.71% <ø> (ø)
target_connection_options	74.76% <ø> (ø)
target_controller	66.44% <62.50%> (-0.19%)	⬇️
target_import	37.44% <37.50%> (-0.21%)	⬇️
target_lookup_hashi_vault	81.33% <ø> (ø)
target_lookup_vault_read	90.00% <ø> (ø)
target_module_utils	93.03% <98.62%> (+1.93%)	⬆️
target_module_vault_read	92.10% <ø> (ø)
units	91.36% <98.62%> (+1.73%)	⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ
plugins/doc_fragments/auth.py	100.00% <ø> (ø)
plugins/lookup/hashi_vault.py	84.00% <ø> (ø)
...s/module_utils/authentication/test_auth_aws_iam.py	98.29% <98.29%> (ø)
plugins/module_utils/_auth_method_aws_iam.py	94.23% <100.00%> (ø)
plugins/module_utils/_authenticator.py	100.00% <100.00%> (ø)
...s/authentication/test_hashi_vault_authenticator.py	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 8852550...2fc510a. Read the comment docs.

[github-actions]

##Docs Build 📝

Thank you for contribution!✨

This PR has been merged and the docs are now incorporated into main:
https://community-hashi-vault-main.surge.sh