Support templating of the API token

[maxtruxa]

SUMMARY

This PR adds support for templates in the API token field. This mechanism allows retrieving the password from arbitrary sources (for example, a password manager).

TODO

• Add documentation.
• Add tests.

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

Inventory plugin

ADDITIONAL INFORMATION

Example script get-do-token.sh that just writes the API token to stdout:

#!/usr/bin/env sh

# You can do whatever you want here.
echo 'your-api-token-here'

Inventory config inventory_digitalocean.yml, referencing the script:

plugin: community.digitalocean.digitalocean
api_token: '{{ lookup("pipe", "./get-do-token.sh") }}'

[mamercad]

This is a neat idea, thank's for contributing.

[mamercad]

I wonder if there's a function we can call to trigger interpolation, like this:

plugin: community.digitalocean.digitalocean
api_token: "{{ lookup('pipe', './get-do-token.sh') }}"

[maxtruxa]

Oh that is actually a much better idea. That shouldn't be too hard to implement, since it's being used all over the place in Ansible. I'll look into it later today.

[codecov]

Codecov Report

Merging #98 (af81a51) into main (09bc240) will increase coverage by 2.45%.
The diff coverage is 100.00%.

@@            Coverage Diff             @@
##             main      #98      +/-   ##
==========================================
+ Coverage   62.33%   64.78%   +2.45%     
==========================================
  Files          30        1      -29     
  Lines        2153       71    -2082     
  Branches      411       11     -400     
==========================================
- Hits         1342       46    -1296     
+ Misses        577       23     -554     
+ Partials      234        2     -232     

Impacted Files	Coverage Δ
plugins/inventory/digitalocean.py	64.78% <100.00%> (+21.50%)	⬆️
plugins/modules/digital_ocean_volume_info.py
plugins/modules/digital_ocean_domain_info.py
plugins/modules/digital_ocean_certificate.py
plugins/modules/digital_ocean_tag_info.py
plugins/modules/digital_ocean_floating_ip.py
plugins/modules/digital_ocean_certificate_info.py
plugins/modules/digital_ocean_firewall.py
plugins/modules/digital_ocean_droplet_info.py
plugins/modules/digital_ocean_account_info.py
... and 21 more

---

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 09bc240...af81a51. Read the comment docs.

[maxtruxa]

@mamercad Done!

I changed the example to showcase the use of a lookup, because the old example was broken.

[mamercad]

This is great -- thanks so very much! 🎉