Decouple unit test code from business code (#17623)
parent
7f802631c5
commit
df64fa4865
@ -0,0 +1,8 @@ |
||||
// Copyright 2021 The Gitea Authors. All rights reserved.
|
||||
// Use of this source code is governed by a MIT-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package paginator |
||||
|
||||
// dummy only. in the future, the models/db/list_options.go should be moved here to decouple from db package
|
||||
// otherwise the unit test will cause cycle import
|
@ -0,0 +1,54 @@ |
||||
// Copyright 2021 The Gitea Authors. All rights reserved.
|
||||
// Use of this source code is governed by a MIT-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package unittest |
||||
|
||||
import ( |
||||
"code.gitea.io/gitea/modules/unittestbridge" |
||||
"github.com/stretchr/testify/assert" |
||||
) |
||||
|
||||
// For legacy code only, please refer to the `unittestbridge` package.
|
||||
|
||||
// TestifyAsserter uses "stretchr/testify/assert" to do assert
|
||||
type TestifyAsserter struct { |
||||
t unittestbridge.Tester |
||||
} |
||||
|
||||
// Errorf assert Errorf
|
||||
func (ta TestifyAsserter) Errorf(format string, args ...interface{}) { |
||||
ta.t.Errorf(format, args) |
||||
} |
||||
|
||||
// NoError assert NoError
|
||||
func (ta TestifyAsserter) NoError(err error, msgAndArgs ...interface{}) bool { |
||||
return assert.NoError(ta, err, msgAndArgs...) |
||||
} |
||||
|
||||
// EqualValues assert EqualValues
|
||||
func (ta TestifyAsserter) EqualValues(expected, actual interface{}, msgAndArgs ...interface{}) bool { |
||||
return assert.EqualValues(ta, expected, actual, msgAndArgs...) |
||||
} |
||||
|
||||
// Equal assert Equal
|
||||
func (ta TestifyAsserter) Equal(expected, actual interface{}, msgAndArgs ...interface{}) bool { |
||||
return assert.Equal(ta, expected, actual, msgAndArgs...) |
||||
} |
||||
|
||||
// True assert True
|
||||
func (ta TestifyAsserter) True(value bool, msgAndArgs ...interface{}) bool { |
||||
return assert.True(ta, value, msgAndArgs...) |
||||
} |
||||
|
||||
// False assert False
|
||||
func (ta TestifyAsserter) False(value bool, msgAndArgs ...interface{}) bool { |
||||
return assert.False(ta, value, msgAndArgs...) |
||||
} |
||||
|
||||
// InitUnitTestBridge init the unit test bridge. eg: models.CheckConsistencyFor can use testing and assert frameworks
|
||||
func InitUnitTestBridge() { |
||||
unittestbridge.SetNewAsserterFunc(func(t unittestbridge.Tester) unittestbridge.Asserter { |
||||
return &TestifyAsserter{t: t} |
||||
}) |
||||
} |
@ -0,0 +1,154 @@ |
||||
// Copyright 2021 The Gitea Authors. All rights reserved.
|
||||
// Use of this source code is governed by a MIT-style
|
||||
// license that can be found in the LICENSE file.
|
||||
|
||||
package unittest |
||||
|
||||
import ( |
||||
"fmt" |
||||
"net/url" |
||||
"os" |
||||
"path/filepath" |
||||
"testing" |
||||
|
||||
"code.gitea.io/gitea/models/db" |
||||
"code.gitea.io/gitea/modules/base" |
||||
"code.gitea.io/gitea/modules/setting" |
||||
"code.gitea.io/gitea/modules/storage" |
||||
"code.gitea.io/gitea/modules/util" |
||||
|
||||
"github.com/stretchr/testify/assert" |
||||
|
||||
"xorm.io/xorm" |
||||
"xorm.io/xorm/names" |
||||
) |
||||
|
||||
// giteaRoot a path to the gitea root
|
||||
var ( |
||||
giteaRoot string |
||||
fixturesDir string |
||||
) |
||||
|
||||
// FixturesDir returns the fixture directory
|
||||
func FixturesDir() string { |
||||
return fixturesDir |
||||
} |
||||
|
||||
func fatalTestError(fmtStr string, args ...interface{}) { |
||||
_, _ = fmt.Fprintf(os.Stderr, fmtStr, args...) |
||||
os.Exit(1) |
||||
} |
||||
|
||||
// MainTest a reusable TestMain(..) function for unit tests that need to use a
|
||||
// test database. Creates the test database, and sets necessary settings.
|
||||
func MainTest(m *testing.M, pathToGiteaRoot string, fixtureFiles ...string) { |
||||
var err error |
||||
InitUnitTestBridge() |
||||
giteaRoot = pathToGiteaRoot |
||||
fixturesDir = filepath.Join(pathToGiteaRoot, "models", "fixtures") |
||||
|
||||
var opts FixturesOptions |
||||
if len(fixtureFiles) == 0 { |
||||
opts.Dir = fixturesDir |
||||
} else { |
||||
for _, f := range fixtureFiles { |
||||
if len(f) != 0 { |
||||
opts.Files = append(opts.Files, filepath.Join(fixturesDir, f)) |
||||
} |
||||
} |
||||
} |
||||
|
||||
if err = CreateTestEngine(opts); err != nil { |
||||
fatalTestError("Error creating test engine: %v\n", err) |
||||
} |
||||
|
||||
setting.AppURL = "https://try.gitea.io/" |
||||
setting.RunUser = "runuser" |
||||
setting.SSH.Port = 3000 |
||||
setting.SSH.Domain = "try.gitea.io" |
||||
setting.Database.UseSQLite3 = true |
||||
setting.RepoRootPath, err = os.MkdirTemp(os.TempDir(), "repos") |
||||
if err != nil { |
||||
fatalTestError("TempDir: %v\n", err) |
||||
} |
||||
setting.AppDataPath, err = os.MkdirTemp(os.TempDir(), "appdata") |
||||
if err != nil { |
||||
fatalTestError("TempDir: %v\n", err) |
||||
} |
||||
setting.AppWorkPath = pathToGiteaRoot |
||||
setting.StaticRootPath = pathToGiteaRoot |
||||
setting.GravatarSourceURL, err = url.Parse("https://secure.gravatar.com/avatar/") |
||||
if err != nil { |
||||
fatalTestError("url.Parse: %v\n", err) |
||||
} |
||||
setting.Attachment.Storage.Path = filepath.Join(setting.AppDataPath, "attachments") |
||||
|
||||
setting.LFS.Storage.Path = filepath.Join(setting.AppDataPath, "lfs") |
||||
|
||||
setting.Avatar.Storage.Path = filepath.Join(setting.AppDataPath, "avatars") |
||||
|
||||
setting.RepoAvatar.Storage.Path = filepath.Join(setting.AppDataPath, "repo-avatars") |
||||
|
||||
setting.RepoArchive.Storage.Path = filepath.Join(setting.AppDataPath, "repo-archive") |
||||
|
||||
if err = storage.Init(); err != nil { |
||||
fatalTestError("storage.Init: %v\n", err) |
||||
} |
||||
|
||||
if err = util.RemoveAll(setting.RepoRootPath); err != nil { |
||||
fatalTestError("util.RemoveAll: %v\n", err) |
||||
} |
||||
if err = util.CopyDir(filepath.Join(pathToGiteaRoot, "integrations", "gitea-repositories-meta"), setting.RepoRootPath); err != nil { |
||||
fatalTestError("util.CopyDir: %v\n", err) |
||||
} |
||||
|
||||
exitStatus := m.Run() |
||||
if err = util.RemoveAll(setting.RepoRootPath); err != nil { |
||||
fatalTestError("util.RemoveAll: %v\n", err) |
||||
} |
||||
if err = util.RemoveAll(setting.AppDataPath); err != nil { |
||||
fatalTestError("util.RemoveAll: %v\n", err) |
||||
} |
||||
os.Exit(exitStatus) |
||||
} |
||||
|
||||
// FixturesOptions fixtures needs to be loaded options
|
||||
type FixturesOptions struct { |
||||
Dir string |
||||
Files []string |
||||
} |
||||
|
||||
// CreateTestEngine creates a memory database and loads the fixture data from fixturesDir
|
||||
func CreateTestEngine(opts FixturesOptions) error { |
||||
x, err := xorm.NewEngine("sqlite3", "file::memory:?cache=shared&_txlock=immediate") |
||||
if err != nil { |
||||
return err |
||||
} |
||||
x.SetMapper(names.GonicMapper{}) |
||||
db.SetUnitTestEngine(x) |
||||
|
||||
if err = db.SyncAllTables(); err != nil { |
||||
return err |
||||
} |
||||
switch os.Getenv("GITEA_UNIT_TESTS_VERBOSE") { |
||||
case "true", "1": |
||||
x.ShowSQL(true) |
||||
} |
||||
|
||||
return InitFixtures(opts) |
||||
} |
||||
|
||||
// PrepareTestDatabase load test fixtures into test database
|
||||
func PrepareTestDatabase() error { |
||||
return LoadFixtures() |
||||
} |
||||
|
||||
// PrepareTestEnv prepares the environment for unit tests. Can only be called
|
||||
// by tests that use the above MainTest(..) function.
|
||||
func PrepareTestEnv(t testing.TB) { |
||||
assert.NoError(t, PrepareTestDatabase()) |
||||
assert.NoError(t, util.RemoveAll(setting.RepoRootPath)) |
||||
metaPath := filepath.Join(giteaRoot, "integrations", "gitea-repositories-meta") |
||||
assert.NoError(t, util.CopyDir(metaPath, setting.RepoRootPath)) |
||||
base.SetupGiteaRoot() // Makes sure GITEA_ROOT is set
|
||||
} |
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue