8 "github.com/edwarnicke/exechelper"
9 "github.com/stretchr/testify/assert"
10 "github.com/stretchr/testify/suite"
15 defaultNetworkNumber int = 1
18 func IsPersistent() bool {
19 return os.Getenv("HST_PERSIST") == "1"
22 func IsVerbose() bool {
23 return os.Getenv("HST_VERBOSE") == "1"
26 type HstSuite struct {
28 containers map[string]*Container
30 netConfigs []NetConfig
31 netInterfaces map[string]NetInterface
35 func (s *HstSuite) TearDownSuite() {
36 s.unconfigureNetworkTopology()
39 func (s *HstSuite) TearDownTest() {
47 func (s *HstSuite) SetupTest() {
52 func (s *HstSuite) SetupVolumes() {
53 for _, volume := range s.volumes {
54 cmd := "docker volume create --name=" + volume
60 func (s *HstSuite) SetupContainers() {
61 for _, container := range s.containers {
62 if container.isOptional == false {
68 func (s *HstSuite) hstFail() {
72 func (s *HstSuite) assertNil(object interface{}, msgAndArgs ...interface{}) {
73 if !assert.Nil(s.T(), object, msgAndArgs...) {
78 func (s *HstSuite) assertNotNil(object interface{}, msgAndArgs ...interface{}) {
79 if !assert.NotNil(s.T(), object, msgAndArgs...) {
84 func (s *HstSuite) assertEqual(expected, actual interface{}, msgAndArgs ...interface{}) {
85 if !assert.Equal(s.T(), expected, actual, msgAndArgs...) {
90 func (s *HstSuite) assertNotEqual(expected, actual interface{}, msgAndArgs ...interface{}) {
91 if !assert.NotEqual(s.T(), expected, actual, msgAndArgs...) {
96 func (s *HstSuite) assertContains(testString, contains interface{}, msgAndArgs ...interface{}) {
97 if !assert.Contains(s.T(), testString, contains, msgAndArgs...) {
102 func (s *HstSuite) assertNotContains(testString, contains interface{}, msgAndArgs ...interface{}) {
103 if !assert.NotContains(s.T(), testString, contains, msgAndArgs...) {
108 func (s *HstSuite) assertNotEmpty(object interface{}, msgAndArgs ...interface{}) {
109 if !assert.NotEmpty(s.T(), object, msgAndArgs...) {
114 func (s *HstSuite) log(args ...any) {
120 func (s *HstSuite) skip(args ...any) {
125 func (s *HstSuite) ResetContainers() {
126 for _, container := range s.containers {
131 func (s *HstSuite) RemoveVolumes() {
132 for _, volumeName := range s.volumes {
133 cmd := "docker volume rm " + volumeName
135 os.RemoveAll(volumeName)
139 func (s *HstSuite) getContainerByName(name string) *Container {
140 return s.containers[name]
144 * Create a copy and return its address, so that individial tests which call this
145 * are not able to modify the original container and affect other tests by doing that
147 func (s *HstSuite) getTransientContainerByName(name string) *Container {
148 containerCopy := *s.containers[name]
149 return &containerCopy
152 func (s *HstSuite) loadContainerTopology(topologyName string) {
153 data, err := ioutil.ReadFile(ContainerTopologyDir + topologyName + ".yaml")
155 s.T().Fatalf("read error: %v", err)
157 var yamlTopo YamlTopology
158 err = yaml.Unmarshal(data, &yamlTopo)
160 s.T().Fatalf("unmarshal error: %v", err)
163 for _, elem := range yamlTopo.Volumes {
164 volumeMap := elem["volume"].(VolumeConfig)
165 hostDir := volumeMap["host-dir"].(string)
166 s.volumes = append(s.volumes, hostDir)
169 s.containers = make(map[string]*Container)
170 for _, elem := range yamlTopo.Containers {
171 newContainer, err := NewContainer(elem)
172 newContainer.suite = s
174 s.T().Fatalf("container config error: %v", err)
176 s.containers[newContainer.name] = newContainer
180 func (s *HstSuite) loadNetworkTopology(topologyName string) {
181 data, err := ioutil.ReadFile(NetworkTopologyDir + topologyName + ".yaml")
183 s.T().Fatalf("read error: %v", err)
185 var yamlTopo YamlTopology
186 err = yaml.Unmarshal(data, &yamlTopo)
188 s.T().Fatalf("unmarshal error: %v", err)
191 s.addresser = NewAddresser(s)
192 s.netInterfaces = make(map[string]NetInterface)
193 for _, elem := range yamlTopo.Devices {
194 switch elem["type"].(string) {
197 if namespace, err := NewNetNamespace(elem); err == nil {
198 s.netConfigs = append(s.netConfigs, &namespace)
200 s.T().Fatalf("network config error: %v", err)
205 if veth, err := NewVeth(elem, s.addresser); err == nil {
206 s.netConfigs = append(s.netConfigs, &veth)
207 s.netInterfaces[veth.Name()] = &veth
209 s.T().Fatalf("network config error: %v", err)
214 if tap, err := NewTap(elem, s.addresser); err == nil {
215 s.netConfigs = append(s.netConfigs, &tap)
216 s.netInterfaces[tap.Name()] = &tap
218 s.T().Fatalf("network config error: %v", err)
223 if bridge, err := NewBridge(elem); err == nil {
224 s.netConfigs = append(s.netConfigs, &bridge)
226 s.T().Fatalf("network config error: %v", err)
233 func (s *HstSuite) configureNetworkTopology(topologyName string) {
234 s.loadNetworkTopology(topologyName)
236 for _, nc := range s.netConfigs {
237 if err := nc.Configure(); err != nil {
238 s.T().Fatalf("network config error: %v", err)
243 func (s *HstSuite) unconfigureNetworkTopology() {
247 for _, nc := range s.netConfigs {
252 type NetworkAddresses struct {
254 numberOfAddresses int
257 type AddressCounter = int
259 type Addresser struct {
260 networks map[int]AddressCounter
264 func (a *Addresser) AddNetwork(networkNumber int) {
265 a.networks[networkNumber] = 1
268 func (a *Addresser) NewIp4Address(inputNetworkNumber ...int) (string, error) {
269 var networkNumber int = 0
270 if len(inputNetworkNumber) > 0 {
271 networkNumber = inputNetworkNumber[0]
274 if _, ok := a.networks[networkNumber]; !ok {
275 a.AddNetwork(networkNumber)
278 numberOfAddresses := a.networks[networkNumber]
280 if numberOfAddresses == 254 {
281 return "", fmt.Errorf("no available IPv4 addresses")
284 address := fmt.Sprintf("10.10.%v.%v/24", networkNumber, numberOfAddresses)
285 a.networks[networkNumber] = numberOfAddresses + 1
290 func NewAddresser(suite *HstSuite) *Addresser {
291 var addresser = new(Addresser)
292 addresser.suite = suite
293 addresser.networks = make(map[int]AddressCounter)
294 addresser.AddNetwork(0)