TESTING.md

Instructions for testing

This check implements testing via go test, which can be easily run like:

go test -v ./...

Integration testing

Some testing requires a real WinRM host to test against, this can be enabled by using environment variables.

On a Unix/Linux shell:

export WINRM_HOST=win10
export WINRM_USER=administrator
export WINRM_PASSWORD=secret

On PowerShell:

$Env:WINRM_HOST = "win10"
$Env:WINRM_USER = "administrator"
$Env:WINRM_PASSWORD = "secret"

With the vars set, just run the normal test command, and no tests should be skipped.

go test -v ./...

Other vars have some additional behavior, that can be overridden, set or enabled:

• WINRM_BASIC_USER Use a different user for Basic Auth
• WINRM_BASIC_PASSWORD Use a different password for Basic Auth
• WINRM_NTLM_USER Use a different user for NTLM
• WINRM_NTLM_PASSWORD Use a different password for NTLM
• WINRM_SKIP_TLS If set, don't run checks via a TLS/HTTPS connection
• WINRM_SKIP_BASIC If set, don't test basic auth
• WINRM_SKIP_UNENCRYPTED If set, don't test HTTP connections
• WINRM_INSECURE If set, disable certificate validation
• WINRM_TLS_CA Path for a CA certificate to use
• WINRM_TLS_CERT Path for a client certificate to use
• WINRM_TLS_KEY Path for a client certificate key to use