istio.io/istio@v0.0.0-20240520182934-d79c90f27776/pkg/test/framework/operations.go (about)

     1  //  Copyright Istio Authors
     2  //
     3  //  Licensed under the Apache License, Version 2.0 (the "License");
     4  //  you may not use this file except in compliance with the License.
     5  //  You may obtain a copy of the License at
     6  //
     7  //      http://www.apache.org/licenses/LICENSE-2.0
     8  //
     9  //  Unless required by applicable law or agreed to in writing, software
    10  //  distributed under the License is distributed on an "AS IS" BASIS,
    11  //  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    12  //  See the License for the specific language governing permissions and
    13  //  limitations under the License.
    14  
    15  package framework
    16  
    17  import (
    18  	"testing"
    19  
    20  	"istio.io/istio/pkg/test/framework/label"
    21  )
    22  
    23  // Run runs the given test.
    24  func Run(t *testing.T, fn func(ctx TestContext)) {
    25  	NewTest(t).Run(fn)
    26  }
    27  
    28  // NewContext creates a new test context and returns. It is up to the caller to close to context by calling
    29  // .Done() at the end of the test run.
    30  func NewContext(goTest *testing.T, labels ...label.Instance) TestContext {
    31  	return newRootContext(nil, goTest, labels...)
    32  }
    33  
    34  // newRootContext creates a new TestContext that has no parent. Delegates to the global runtime.
    35  func newRootContext(test *testImpl, goTest *testing.T, labels ...label.Instance) *testContext {
    36  	rtMu.Lock()
    37  	defer rtMu.Unlock()
    38  
    39  	if rt == nil {
    40  		panic("call to scope without running the test framework")
    41  	}
    42  
    43  	return rt.newRootContext(test, goTest, label.NewSet(labels...))
    44  }