Add helper function to return helpful import error msg

[jborean93]

SUMMARY

Return a prettier error msg to use when failing to import a required Python library. This will include the Python that is involved and the hostname to clear up any ambiguities when failing to import a Python library.

Supersedes #41793
Supersedes #38379

ISSUE TYPE

• Feature Pull Request

COMPONENT NAME

basic.py

ANSIBLE VERSION

devel

ADDITIONAL INFORMATION

An example output with this change is now

# with no v's
An exception occurred during task execution. To see the full traceback, use -vvv. The error was: ModuleNotFoundError: No module named 'pypsexec'
fatal: [2016 -> localhost]: FAILED! => {"changed": false, "msg": "Failed to import the required Python library (pypsexec) on jborean-osx's Python /Users/jborean/venvs/ansible-py37/bin/python. Please read module documentation and install in the appropriate location."}

# with 3+ v's
The full traceback is:
Traceback (most recent call last):
  File "/var/folders/83/v33q_n515ps10nvlrpmd4x000000gn/T/ansible_psexec_payload_79ha7qpc/__main__.py", line 332, in <module>
    from pypsexec import client
ModuleNotFoundError: No module named 'pypsexec'

fatal: [2016 -> localhost]: FAILED! => {
    "changed": false,
    "invocation": {
        "module_args": {
            "arguments": "Write-Output abc",
            "asynchronous": false,
            "connection_password": "VALUE_SPECIFIED_IN_NO_LOG_PARAMETER",
            "connection_timeout": 60,
            "connection_username": "VALUE_SPECIFIED_IN_NO_LOG_PARAMETER",
            "encrypt": true,
            "executable": "powershell.exe",
            "hostname": "server2016.domain.local",
            "integrity_level": "default",
            "interactive": false,
            "interactive_session": 0,
            "load_profile": true,
            "port": 445,
            "priority": "normal",
            "process_password": null,
            "process_timeout": 0,
            "process_username": null,
            "show_ui_on_logon_screen": false,
            "stdin": null,
            "working_directory": "C:\\Windows\\System32"
        }
    },
    "msg": "Failed to import the required Python library (pypsexec) on jborean-osx's Python /Users/jborean/venvs/ansible-py37/bin/python. Please read module documentation and install in the appropriate location."                                                                     
}

[ansibot]

Hi @jborean93, thank you for submitting this pull-request!

click here for bot help

[ansibot]

cc @acozine
click here for bot help

[gundalow]

Love it!