2021-12-04 16:42:11 +00:00

186 lines
5.7 KiB
Go

// Copyright (c) 2016 Uber Technologies, Inc.
//
// Permission is hereby granted, free of charge, to any person obtaining a copy
// of this software and associated documentation files (the "Software"), to deal
// in the Software without restriction, including without limitation the rights
// to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
// copies of the Software, and to permit persons to whom the Software is
// furnished to do so, subject to the following conditions:
//
// The above copyright notice and this permission notice shall be included in
// all copies or substantial portions of the Software.
//
// THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
// IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
// FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
// AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
// LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
// OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
// THE SOFTWARE.
package zap
import (
"encoding/hex"
"errors"
"io/ioutil"
"math/rand"
"net/url"
"os"
"path/filepath"
"strings"
"testing"
"github.com/stretchr/testify/assert"
"github.com/stretchr/testify/require"
"go.uber.org/zap/zapcore"
)
func TestOpenNoPaths(t *testing.T) {
ws, cleanup, err := Open()
defer cleanup()
assert.NoError(t, err, "Expected opening no paths to succeed.")
assert.Equal(
t,
zapcore.AddSync(ioutil.Discard),
ws,
"Expected opening no paths to return a no-op WriteSyncer.",
)
}
func TestOpen(t *testing.T) {
tempName := tempFileName("", "zap-open-test")
assert.False(t, fileExists(tempName))
require.True(t, strings.HasPrefix(tempName, "/"), "Expected absolute temp file path.")
tests := []struct {
paths []string
errs []string
}{
{[]string{"stdout"}, nil},
{[]string{"stderr"}, nil},
{[]string{tempName}, nil},
{[]string{"file://" + tempName}, nil},
{[]string{"file://localhost" + tempName}, nil},
{[]string{"/foo/bar/baz"}, []string{"open /foo/bar/baz: no such file or directory"}},
{[]string{"file://localhost/foo/bar/baz"}, []string{"open /foo/bar/baz: no such file or directory"}},
{
paths: []string{"stdout", "/foo/bar/baz", tempName, "file:///baz/quux"},
errs: []string{
"open /foo/bar/baz: no such file or directory",
"open /baz/quux: no such file or directory",
},
},
{[]string{"file:///stderr"}, []string{"open /stderr:"}},
{[]string{"file:///stdout"}, []string{"open /stdout:"}},
{[]string{"file://host01.test.com" + tempName}, []string{"empty or use localhost"}},
{[]string{"file://rms@localhost" + tempName}, []string{"user and password not allowed"}},
{[]string{"file://localhost" + tempName + "#foo"}, []string{"fragments not allowed"}},
{[]string{"file://localhost" + tempName + "?foo=bar"}, []string{"query parameters not allowed"}},
{[]string{"file://localhost:8080" + tempName}, []string{"ports not allowed"}},
}
for _, tt := range tests {
_, cleanup, err := Open(tt.paths...)
if err == nil {
defer cleanup()
}
if len(tt.errs) == 0 {
assert.NoError(t, err, "Unexpected error opening paths %v.", tt.paths)
} else {
msg := err.Error()
for _, expect := range tt.errs {
assert.Contains(t, msg, expect, "Unexpected error opening paths %v.", tt.paths)
}
}
}
assert.True(t, fileExists(tempName))
os.Remove(tempName)
}
func TestOpenRelativePath(t *testing.T) {
const name = "test-relative-path.txt"
require.False(t, fileExists(name), "Test file already exists.")
s, cleanup, err := Open(name)
require.NoError(t, err, "Open failed.")
defer func() {
err := os.Remove(name)
if !t.Failed() {
// If the test has already failed, we probably didn't create this file.
require.NoError(t, err, "Deleting test file failed.")
}
}()
defer cleanup()
_, err = s.Write([]byte("test"))
assert.NoError(t, err, "Write failed.")
assert.True(t, fileExists(name), "Didn't create file for relative path.")
}
func TestOpenFails(t *testing.T) {
tests := []struct {
paths []string
}{
{paths: []string{"./non-existent-dir/file"}}, // directory doesn't exist
{paths: []string{"stdout", "./non-existent-dir/file"}}, // directory doesn't exist
{paths: []string{"://foo.log"}}, // invalid URL, scheme can't begin with colon
{paths: []string{"mem://somewhere"}}, // scheme not registered
}
for _, tt := range tests {
_, cleanup, err := Open(tt.paths...)
require.Nil(t, cleanup, "Cleanup function should never be nil")
assert.Error(t, err, "Open with invalid URL should fail.")
}
}
type testWriter struct {
expected string
t testing.TB
}
func (w *testWriter) Write(actual []byte) (int, error) {
assert.Equal(w.t, []byte(w.expected), actual, "Unexpected write error.")
return len(actual), nil
}
func (w *testWriter) Sync() error {
return nil
}
func TestOpenWithErroringSinkFactory(t *testing.T) {
defer resetSinkRegistry()
msg := "expected factory error"
factory := func(_ *url.URL) (Sink, error) {
return nil, errors.New(msg)
}
assert.NoError(t, RegisterSink("test", factory), "Failed to register sink factory.")
_, _, err := Open("test://some/path")
assert.Contains(t, err.Error(), msg, "Unexpected error.")
}
func TestCombineWriteSyncers(t *testing.T) {
tw := &testWriter{"test", t}
w := CombineWriteSyncers(tw)
w.Write([]byte("test"))
}
func tempFileName(prefix, suffix string) string {
randBytes := make([]byte, 16)
rand.Read(randBytes)
return filepath.Join(os.TempDir(), prefix+hex.EncodeToString(randBytes)+suffix)
}
func fileExists(name string) bool {
if _, err := os.Stat(name); os.IsNotExist(err) {
return false
}
return true
}