8 "github.com/edwarnicke/exechelper"
9 "github.com/stretchr/testify/assert"
10 "github.com/stretchr/testify/suite"
15 defaultNamespaceName string = "default"
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) log(args ...any) {
114 func (s *HstSuite) skip(args ...any) {
119 func (s *HstSuite) ResetContainers() {
120 for _, container := range s.containers {
125 func (s *HstSuite) RemoveVolumes() {
126 for _, volumeName := range s.volumes {
127 cmd := "docker volume rm " + volumeName
129 os.RemoveAll(volumeName)
133 func (s *HstSuite) getContainerByName(name string) *Container {
134 return s.containers[name]
138 * Create a copy and return its address, so that individial tests which call this
139 * are not able to modify the original container and affect other tests by doing that
141 func (s *HstSuite) getTransientContainerByName(name string) *Container {
142 containerCopy := *s.containers[name]
143 return &containerCopy
146 func (s *HstSuite) loadContainerTopology(topologyName string) {
147 data, err := ioutil.ReadFile(ContainerTopologyDir + topologyName + ".yaml")
149 s.T().Fatalf("read error: %v", err)
151 var yamlTopo YamlTopology
152 err = yaml.Unmarshal(data, &yamlTopo)
154 s.T().Fatalf("unmarshal error: %v", err)
157 for _, elem := range yamlTopo.Volumes {
158 volumeMap := elem["volume"].(VolumeConfig)
159 hostDir := volumeMap["host-dir"].(string)
160 s.volumes = append(s.volumes, hostDir)
163 s.containers = make(map[string]*Container)
164 for _, elem := range yamlTopo.Containers {
165 newContainer, err := NewContainer(elem)
166 newContainer.suite = s
168 s.T().Fatalf("container config error: %v", err)
170 s.log(newContainer.getRunCommand())
171 s.containers[newContainer.name] = newContainer
175 func (s *HstSuite) loadNetworkTopology(topologyName string) {
176 data, err := ioutil.ReadFile(NetworkTopologyDir + topologyName + ".yaml")
178 s.T().Fatalf("read error: %v", err)
180 var yamlTopo YamlTopology
181 err = yaml.Unmarshal(data, &yamlTopo)
183 s.T().Fatalf("unmarshal error: %v", err)
186 s.addresser = NewAddresser(s)
187 s.netInterfaces = make(map[string]NetInterface)
188 for _, elem := range yamlTopo.Devices {
189 switch elem["type"].(string) {
192 if namespace, err := NewNetNamespace(elem); err == nil {
193 s.netConfigs = append(s.netConfigs, &namespace)
195 s.T().Fatalf("network config error: %v", err)
200 if veth, err := NewVeth(elem, s.addresser); err == nil {
201 s.netConfigs = append(s.netConfigs, &veth)
202 s.netInterfaces[veth.Name()] = &veth
204 s.T().Fatalf("network config error: %v", err)
209 if tap, err := NewTap(elem, s.addresser); err == nil {
210 s.netConfigs = append(s.netConfigs, &tap)
211 s.netInterfaces[tap.Name()] = &tap
213 s.T().Fatalf("network config error: %v", err)
218 if bridge, err := NewBridge(elem); err == nil {
219 s.netConfigs = append(s.netConfigs, &bridge)
221 s.T().Fatalf("network config error: %v", err)
228 func (s *HstSuite) configureNetworkTopology(topologyName string) {
229 s.loadNetworkTopology(topologyName)
231 for _, nc := range s.netConfigs {
232 if err := nc.Configure(); err != nil {
233 s.T().Fatalf("network config error: %v", err)
238 func (s *HstSuite) unconfigureNetworkTopology() {
242 for _, nc := range s.netConfigs {
247 type NamespaceAddresses struct {
249 numberOfAddresses int
252 type Addresser struct {
253 namespaces []*NamespaceAddresses
257 func (a *Addresser) AddNamespace(name string) {
258 var newNamespace = &NamespaceAddresses{
260 numberOfAddresses: 0,
262 a.namespaces = append(a.namespaces, newNamespace)
265 func (a *Addresser) NewIp4Address() (string, error) {
266 return a.NewIp4AddressWithNamespace(defaultNamespaceName)
269 func (a *Addresser) NewIp4AddressWithNamespace(namespace string) (string, error) {
270 for i, val := range a.namespaces {
271 if val.namespace != namespace {
274 if val.numberOfAddresses == 255 {
275 return "", fmt.Errorf("no available IPv4 addresses")
277 address := fmt.Sprintf("10.10.%v.%v/24", i, val.numberOfAddresses+1)
278 val.numberOfAddresses++
281 a.AddNamespace(namespace)
282 return a.NewIp4AddressWithNamespace(namespace)
285 func NewAddresser(suite *HstSuite) *Addresser {
286 var addresser = new(Addresser)
287 addresser.suite = suite
288 addresser.AddNamespace(defaultNamespaceName)