Skip to content

Latest commit

 

History

History
51 lines (33 loc) · 2.21 KB

testing.md

File metadata and controls

51 lines (33 loc) · 2.21 KB
Raw

Testing

Tests are playing a primary role and we take them seriously. It is expected from PRs to add, modify or delete tests on case by case scenario. To contribute you need to be familiar with:

  • Ginkgo - BDD Testing Framework for Go
  • Gomega - Matcher/assertion library

Prerequisites

Make sure that the tool dependencies are already in place. The ginkgo and mockgen binaries that are required for testing will be installed as part of tool dependencies.

Bootstrapping the tests

$ cd pkg/maintenance
$ ginkgo bootstrap
$ ginkgo generate maintenance.go

find .
./maintenance.go
./maintenance_suite_test.go
./maintenance_test.go

How to run the tests

  • You can run the tests using make test or go test ./...

Writing tests

Mocking interfaces

This project makes use of GoMock to mock service interfaces. This comes with the mockgen utility which can be used to generate or re-generate mock interfaces that can be used to simulate the behaviour of an external dependency.

Once installed, an interface can be mocked by running:

mockgen -s=/path/to/file_containing_interface.go > /path/to/output_mock_file.go

However, it is considered good practice to include a go generate directive above the interface which defines the specific mockgen command that will generate your mocked interface.

Internal interfaces including pkg/maintenance/maintenance.go and pkg/controller/upgradeconfig/cluster_upgrader.go are mocked using this method. When making changes to these packages, you should re-generate the mocks to ensure they too are updated. This can be performed manually by running go generate /path/to/file.go or for the whole project via make generate.

  • Mocks might need to be regenerated upon dependency updates, e.g. k8s/controller-runtime

To regenerate controller-runtime mock (cr-client.go), run

mockgen -package mocks -destination=util/mocks/cr-client.go sigs.k8s.io/controller-runtime/pkg/client Client,StatusWriter,Reader,Writer```