1
0
mirror of https://github.com/SAP/jenkins-library.git synced 2024-12-14 11:03:09 +02:00

Fix copy-paste-bug for downloading settings (#1284)

* Fix copy-paste-bug for downloading settings
* Extend unit tests accordingly.
* Fix some expected versus actual mixup
This commit is contained in:
Stephan Aßmus 2020-03-17 08:33:35 +01:00 committed by GitHub
parent a0223a2a0e
commit e51cfe276c
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 71 additions and 57 deletions

View File

@ -39,14 +39,15 @@ func Execute(options *ExecuteOptions, command mavenExecRunner) (string, error) {
command.Stdout(stdOut) command.Stdout(stdOut)
command.Stderr(log.Entry().Writer()) command.Stderr(log.Entry().Writer())
parameters := getParametersFromOptions(options, &http.Client{}) parameters, err := getParametersFromOptions(options, &http.Client{})
err := command.RunExecutable(mavenExecutable, parameters...)
if err != nil { if err != nil {
log.Entry(). return "", fmt.Errorf("failed to construct parameters from options: %w", err)
WithError(err). }
WithField("command", append([]string{mavenExecutable}, parameters...)).
Fatal("failed to execute run command") err = command.RunExecutable(mavenExecutable, parameters...)
if err != nil {
commandLine := append([]string{mavenExecutable}, parameters...)
return "", fmt.Errorf("failed to run executable, command: '%s', error: %w", commandLine, err)
} }
if stdOutBuf == nil { if stdOutBuf == nil {
@ -88,23 +89,33 @@ func evaluateStdOut(config *ExecuteOptions) (*bytes.Buffer, io.Writer) {
return stdOutBuf, stdOut return stdOutBuf, stdOut
} }
func getParametersFromOptions(options *ExecuteOptions, client http.Downloader) []string { func downloadSettingsIfURL(settingsFileOption, settingsFile string, client http.Downloader) (string, error) {
result := settingsFileOption
if strings.HasPrefix(settingsFileOption, "http:") || strings.HasPrefix(settingsFileOption, "https:") {
err := downloadSettingsFromURL(settingsFileOption, settingsFile, client)
if err != nil {
return "", err
}
result = settingsFile
}
return result, nil
}
func getParametersFromOptions(options *ExecuteOptions, client http.Downloader) ([]string, error) {
var parameters []string var parameters []string
if options.GlobalSettingsFile != "" { if options.GlobalSettingsFile != "" {
globalSettingsFileName := options.GlobalSettingsFile globalSettingsFileName, err := downloadSettingsIfURL(options.GlobalSettingsFile, "globalSettings.xml", client)
if strings.HasPrefix(options.GlobalSettingsFile, "http:") || strings.HasPrefix(options.GlobalSettingsFile, "https:") { if err != nil {
downloadSettingsFromURL(options.ProjectSettingsFile, "globalSettings.xml", client) return nil, err
globalSettingsFileName = "globalSettings.xml"
} }
parameters = append(parameters, "--global-settings", globalSettingsFileName) parameters = append(parameters, "--global-settings", globalSettingsFileName)
} }
if options.ProjectSettingsFile != "" { if options.ProjectSettingsFile != "" {
projectSettingsFileName := options.ProjectSettingsFile projectSettingsFileName, err := downloadSettingsIfURL(options.ProjectSettingsFile, "projectSettings.xml", client)
if strings.HasPrefix(options.ProjectSettingsFile, "http:") || strings.HasPrefix(options.ProjectSettingsFile, "https:") { if err != nil {
downloadSettingsFromURL(options.ProjectSettingsFile, "projectSettings.xml", client) return nil, err
projectSettingsFileName = "projectSettings.xml"
} }
parameters = append(parameters, "--settings", projectSettingsFileName) parameters = append(parameters, "--settings", projectSettingsFileName)
} }
@ -132,15 +143,17 @@ func getParametersFromOptions(options *ExecuteOptions, client http.Downloader) [
} }
parameters = append(parameters, options.Goals...) parameters = append(parameters, options.Goals...)
return parameters return parameters, nil
} }
// ToDo replace with pkg/maven/settings GetSettingsFile // ToDo replace with pkg/maven/settings GetSettingsFile
func downloadSettingsFromURL(url, filename string, client http.Downloader) { func downloadSettingsFromURL(url, filename string, client http.Downloader) error {
err := client.DownloadFile(url, filename, nil, nil) err := client.DownloadFile(url, filename, nil, nil)
if err != nil { if err != nil {
log.Entry().WithError(err).Fatal("Failed to download maven settings from: " + url) return fmt.Errorf("failed to download maven settings from URL '%s' to file '%s': %w",
url, filename, err)
} }
return nil
} }
func GetTestModulesExcludes() []string { func GetTestModulesExcludes() []string {

View File

@ -10,10 +10,28 @@ import (
"testing" "testing"
piperHttp "github.com/SAP/jenkins-library/pkg/http" piperHttp "github.com/SAP/jenkins-library/pkg/http"
"github.com/SAP/jenkins-library/pkg/log"
"github.com/stretchr/testify/assert" "github.com/stretchr/testify/assert"
) )
type mockDownloader struct {
shouldFail bool
requestedUrls []string
requestedFiles []string
}
func (m *mockDownloader) DownloadFile(url, filename string, header http.Header, cookies []*http.Cookie) error {
m.requestedUrls = append(m.requestedUrls, url)
m.requestedFiles = append(m.requestedFiles, filename)
if m.shouldFail {
return errors.New("something happened")
}
return nil
}
func (m *mockDownloader) SetOptions(options piperHttp.ClientOptions) {
return
}
func TestExecute(t *testing.T) { func TestExecute(t *testing.T) {
t.Run("should return stdOut", func(t *testing.T) { t.Run("should return stdOut", func(t *testing.T) {
expectedOutput := "mocked output" expectedOutput := "mocked output"
@ -36,15 +54,13 @@ func TestExecute(t *testing.T) {
assert.Equal(t, expectedOutput, mavenOutput) assert.Equal(t, expectedOutput, mavenOutput)
}) })
t.Run("should log that command failed if executing maven failed", func(t *testing.T) { t.Run("should log that command failed if executing maven failed", func(t *testing.T) {
var hasFailed bool
log.Entry().Logger.ExitFunc = func(int) { hasFailed = true }
execMockRunner := mock.ExecMockRunner{ShouldFailOnCommand: map[string]error{"mvn --file pom.xml --batch-mode": errors.New("error case")}} execMockRunner := mock.ExecMockRunner{ShouldFailOnCommand: map[string]error{"mvn --file pom.xml --batch-mode": errors.New("error case")}}
opts := ExecuteOptions{PomPath: "pom.xml", ReturnStdout: false} opts := ExecuteOptions{PomPath: "pom.xml", ReturnStdout: false}
output, _ := Execute(&opts, &execMockRunner) output, err := Execute(&opts, &execMockRunner)
assert.True(t, hasFailed, "failed to execute run command") assert.EqualError(t, err, "failed to run executable, command: '[mvn --file pom.xml --batch-mode]', error: error case")
assert.Equal(t, output, "") assert.Equal(t, "", output)
}) })
t.Run("should have all configured parameters in the exec call", func(t *testing.T) { t.Run("should have all configured parameters in the exec call", func(t *testing.T) {
execMockRunner := mock.ExecMockRunner{} execMockRunner := mock.ExecMockRunner{}
@ -59,8 +75,8 @@ func TestExecute(t *testing.T) {
mavenOutput, _ := Execute(&opts, &execMockRunner) mavenOutput, _ := Execute(&opts, &execMockRunner)
assert.Equal(t, len(execMockRunner.Calls[0].Params), len(expectedParameters)) assert.Equal(t, len(expectedParameters), len(execMockRunner.Calls[0].Params))
assert.Equal(t, execMockRunner.Calls[0], mock.ExecCall{Exec: "mvn", Params: expectedParameters}) assert.Equal(t, mock.ExecCall{Exec: "mvn", Params: expectedParameters}, execMockRunner.Calls[0])
assert.Equal(t, "", mavenOutput) assert.Equal(t, "", mavenOutput)
}) })
} }
@ -86,51 +102,36 @@ func TestEvaluate(t *testing.T) {
}) })
} }
type mockDownloader struct {
shouldFail bool
}
func (m *mockDownloader) DownloadFile(url, filename string, header http.Header, cookies []*http.Cookie) error {
if m.shouldFail {
return errors.New("something happened")
}
return nil
}
func (m *mockDownloader) SetOptions(options piperHttp.ClientOptions) {
return
}
func TestGetParameters(t *testing.T) { func TestGetParameters(t *testing.T) {
t.Run("should resolve configured parameters and download the settings files", func(t *testing.T) { t.Run("should resolve configured parameters and download the settings files", func(t *testing.T) {
mockClient := mockDownloader{shouldFail: false} mockClient := mockDownloader{shouldFail: false}
opts := ExecuteOptions{PomPath: "pom.xml", GlobalSettingsFile: "https://mysettings.com", ProjectSettingsFile: "http://myprojectsettings.com", ReturnStdout: false} opts := ExecuteOptions{PomPath: "pom.xml", GlobalSettingsFile: "https://mysettings.com", ProjectSettingsFile: "http://myprojectsettings.com", ReturnStdout: false}
expectedParameters := []string{"--global-settings", "globalSettings.xml", "--settings", "projectSettings.xml", "--file", "pom.xml", "--batch-mode"} expectedParameters := []string{"--global-settings", "globalSettings.xml", "--settings", "projectSettings.xml", "--file", "pom.xml", "--batch-mode"}
parameters := getParametersFromOptions(&opts, &mockClient) parameters, err := getParametersFromOptions(&opts, &mockClient)
if assert.NoError(t, err) {
assert.Equal(t, len(parameters), len(expectedParameters)) assert.Equal(t, len(expectedParameters), len(parameters))
assert.Equal(t, parameters, expectedParameters) assert.Equal(t, expectedParameters, parameters)
if assert.Equal(t, 2, len(mockClient.requestedUrls)) {
assert.Equal(t, "https://mysettings.com", mockClient.requestedUrls[0])
assert.Equal(t, "globalSettings.xml", mockClient.requestedFiles[0])
assert.Equal(t, "http://myprojectsettings.com", mockClient.requestedUrls[1])
assert.Equal(t, "projectSettings.xml", mockClient.requestedFiles[1])
}
}
}) })
} }
func TestDownloadSettingsFromURL(t *testing.T) { func TestDownloadSettingsFromURL(t *testing.T) {
t.Run("should pass if download is successful", func(t *testing.T) { t.Run("should pass if download is successful", func(t *testing.T) {
var hasFailed bool
log.Entry().Logger.ExitFunc = func(int) { hasFailed = true }
mockClient := mockDownloader{shouldFail: false} mockClient := mockDownloader{shouldFail: false}
err := downloadSettingsFromURL("anyURL", "settings.xml", &mockClient)
downloadSettingsFromURL("anyURL", "settings.xml", &mockClient) assert.NoError(t, err)
assert.False(t, hasFailed)
}) })
t.Run("should fail if download fails", func(t *testing.T) { t.Run("should fail if download fails", func(t *testing.T) {
var hasFailed bool
log.Entry().Logger.ExitFunc = func(int) { hasFailed = true }
mockClient := mockDownloader{shouldFail: true} mockClient := mockDownloader{shouldFail: true}
err := downloadSettingsFromURL("anyURL", "settings.xml", &mockClient)
downloadSettingsFromURL("anyURL", "settings.xml", &mockClient) assert.EqualError(t, err, "failed to download maven settings from URL 'anyURL' to file 'settings.xml': something happened")
assert.True(t, hasFailed, "expected command to exit with fatal")
}) })
} }