Introduce server specification in nameserver_info module

[hakong]

SUMMARY

This merge request introduces the ability to specify custom DNS servers for resolving nameserver information in the nameserver_info module. It includes enhancements to the ResolveDirectlyFromNameServers class to handle custom server addresses and updates the nameserver_info module to accept a new 'servers' parameter.

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

community.dns.nameserver_info

ADDITIONAL INFORMATION

[github-actions]

Docs Build 📝

Thank you for contribution!✨

This PR has been merged and the docs are now incorporated into main:
https://ansible-collections.github.io/community.dns/branch/main

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Comparison is base (b93cd64) 96.81% compared to head (91c7d9c) 96.81%.

Additional details and impacted files

@@           Coverage Diff           @@
##             main     #168   +/-   ##
=======================================
  Coverage   96.81%   96.81%           
=======================================
  Files         107      107           
  Lines        7349     7349           
  Branches     1022     1022           
=======================================
  Hits         7115     7115           
  Misses        167      167           
  Partials       67       67           

Flag	Coverage Δ
integration	40.70% <100.00%> (-0.04%)	⬇️
sanity	31.62% <50.00%> (ø)
units	96.07% <100.00%> (ø)

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

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

[hakong]

@felixfontein Does this look OK? I need is to be able to specify the nameserver to contact. I've tested this and it seems to work fine.
I'm not familiar with writing tests, sorry they aren't included. I'll might give it a try later this week.

  tasks:
    - name: Retrieve name servers of felix.fontein.de
      community.dns.nameserver_info:
        name: "felix.fontein.de"
        servers:
          - "208.67.222.222"
          - "208.67.220.220"
      register: __ff_ns

    - name: "Debug print __ff_ns"
      ansible.builtin.debug:
        msg: "{{ __ff_ns }}"

TASK [Retrieve name servers of felix.fontein.de] **********************************************************************
ok: [localhost]

TASK [Debug print __ff_ns] ********************************************************************************************
ok: [localhost] => {
    "msg": {
        "changed": false,
        "failed": false,
        "results": [
            {
                "name": "felix.fontein.de",
                "nameservers": [
                    "ns1.hostserv.eu.",
                    "ns2.hostserv.eu.",
                    "ns3.hostserv.eu."
                ]
            }
        ]
    }
}

[felixfontein]

Thanks for your contribution! Can you please add a changelog fragment? Also would you mind making the same changes to the nameserver_record_info module?

[hakong]

Thanks for your contribution! Can you please add a changelog fragment? Also would you mind making the same changes to the nameserver_record_info module?

I'll do my best. As you can probably see I'm not very experienced, so I'll take all the help I can get :)

[felixfontein]

Restarting CI (so that integration tests run).

[felixfontein]

Thanks! One little update to the changelog fragment, then it should be done!

[felixfontein]

@hakong thanks for your contribution!

[felixfontein]

I've decided to rename servers to server to adjust notation to the parameters of the lookups. The change is done in #178.