Quelle  test.go   Sprache: unbekannt

// Copyright 2019 The Android Open Source Project
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package rust

import (
 "path/filepath"

 "github.com/google/blueprint/proptools"

 "android/soong/android"
 "android/soong/cc"
 "android/soong/tradefed"
)

type TestProperties struct {
 // Disables the creation of a test-specific directory when used with
 // relative_install_path. Useful if several tests need to be in the same
 // directory.
 No_named_install_directory *bool

 // the name of the test configuration (for example "AndroidTest.xml") that should be
 // installed with the module.
 Test_config proptools.Configurable[string] `android:"path,arch_variant,replace_instead_of_append"`

 // the name of the test configuration template (for example "AndroidTestTemplate.xml") that
 // should be installed with the module.
 Test_config_template *string `android:"path,arch_variant"`

 // list of compatibility suites (for example "cts", "vts") that the module should be
 // installed into.
 Test_suites []string `android:"arch_variant"`

 // list of files or filegroup modules that provide data that should be installed alongside
 // the test
 Data []string `android:"path,arch_variant"`

 // Same as data, but adds dependencies on modules using the device's os variant, and common
 // architecture's variant. Can be useful to add device-built apps to the data of a host
 // test.
 Device_common_data []string `android:"path_device_common"`

 // Same as data, but will add dependencies on modules using the host's os variation and
 // the common arch variation. Useful for a device test that wants to depend on a host
 // module, for example to include a custom Tradefed test runner.
 Host_common_data []string `android:"path_host_common"`

 // list of shared library modules that should be installed alongside the test
 Data_libs []string `android:"arch_variant"`

 // list of binary modules that should be installed alongside the test
 Data_bins []string `android:"arch_variant"`

 // Flag to indicate whether or not to create test config automatically. If AndroidTest.xml
 // doesn't exist next to the Android.bp, this attribute doesn't need to be set to true
 // explicitly.
 Auto_gen_config *bool

 // if set, build with the standard Rust test harness. Defaults to true.
 Test_harness *bool

 // Test options.
 Test_options android.CommonTestOptions

 // Add RootTargetPreparer to auto generated test config. This guarantees the test to run
 // with root permission.
 Require_root *bool
}

// A test module is a binary module with extra --test compiler flag
// and different default installation directory.
// In golang, inheriance is written as a component.
type testDecorator struct {
 *binaryDecorator
 Properties TestProperties
 testConfig android.Path

 data []android.DataPath
}

func (test *testDecorator) dataPaths() []android.DataPath {
 return test.data
}

func (test *testDecorator) nativeCoverage() bool {
 return true
}

func (test *testDecorator) testHarness() bool {
 return BoolDefault(test.Properties.Test_harness, true)
}

func NewRustTest(hod android.HostOrDeviceSupported) (*Module, *testDecorator) {
 // Build both 32 and 64 targets for device tests.
 // Cannot build both for host tests yet if the test depends on
 // something like proc-macro2 that cannot be built for both.
 multilib := android.MultilibBoth
 if hod != android.DeviceSupported && hod != android.HostAndDeviceSupported {
  multilib = android.MultilibFirst
 }
 module := newModule(hod, multilib)

 test := &testDecorator{
  binaryDecorator: &binaryDecorator{
   baseCompiler: NewBaseCompiler("nativetest", "nativetest64", InstallInData),
  },
 }

 module.compiler = test
 return module, test
}

func (test *testDecorator) compilerProps() []any {
 return append(test.binaryDecorator.compilerProps(), &test.Properties)
}

func (test *testDecorator) install(ctx ModuleContext) {
 // TODO: (b/167308193) Switch to /data/local/tests/unrestricted as the default install base.
 testInstallBase := "/data/local/tmp"
 if ctx.RustModule().InVendorOrProduct() {
  testInstallBase = "/data/local/tests/vendor"
 }

 var configs []tradefed.Config
 if Bool(test.Properties.Require_root) {
  configs = append(configs, tradefed.Object{Type: "target_preparer", Class: "com.android.tradefed.targetprep.RootTargetPreparer", Options: nil})
 } else {
  var options []tradefed.Option
  options = append(options, tradefed.Option{Name: "force-root", Value: "false"})
  configs = append(configs, tradefed.Object{Type: "target_preparer", Class: "com.android.tradefed.targetprep.RootTargetPreparer", Options: options})
 }

 test.testConfig = tradefed.AutoGenTestConfig(ctx, tradefed.AutoGenTestConfigOptions{
  TestConfigProp:         test.Properties.Test_config,
  TestConfigTemplateProp: test.Properties.Test_config_template,
  TestSuites:             test.Properties.Test_suites,
  Config:                 configs,
  AutoGenConfig:          test.Properties.Auto_gen_config,
  TestInstallBase:        testInstallBase,
  DeviceTemplate:         "${RustDeviceTestConfigTemplate}",
  HostTemplate:           "${RustHostTestConfigTemplate}",
 })

 dataSrcPaths := android.PathsForModuleSrc(ctx, test.Properties.Data)
 dataSrcPaths = append(dataSrcPaths, android.PathsForModuleSrc(ctx, test.Properties.Device_common_data)...)
 dataSrcPaths = append(dataSrcPaths, android.PathsForModuleSrc(ctx, test.Properties.Host_common_data)...)

 ctx.VisitDirectDepsProxyWithTag(dataLibDepTag, func(dep android.ModuleProxy) {
  depName := ctx.OtherModuleName(dep)
  linkableDep, ok := android.OtherModuleProvider(ctx, dep, cc.LinkableInfoProvider)
  if !ok {
   ctx.ModuleErrorf("data_lib %q is not a linkable module", depName)
  }
  if linkableDep.OutputFile.Valid() {
   // Copy the output in "lib[64]" so that it's compatible with
   // the default rpath values.
   commonInfo := android.OtherModulePointerProviderOrDefault(ctx, dep, android.CommonModuleInfoProvider)
   libDir := "lib"
   if commonInfo.Target.Arch.ArchType.Multilib == "lib64" {
    libDir = "lib64"
   }
   test.data = append(test.data,
    android.DataPath{SrcPath: linkableDep.OutputFile.Path(),
     RelativeInstallPath: filepath.Join(libDir, linkableDep.RelativeInstallPath)})
  }
 })

 ctx.VisitDirectDepsProxyWithTag(dataBinDepTag, func(dep android.ModuleProxy) {
  depName := ctx.OtherModuleName(dep)
  linkableDep, ok := android.OtherModuleProvider(ctx, dep, cc.LinkableInfoProvider)
  if !ok {
   ctx.ModuleErrorf("data_bin %q is not a linkable module", depName)
  }
  if linkableDep.OutputFile.Valid() {
   test.data = append(test.data,
    android.DataPath{SrcPath: linkableDep.OutputFile.Path(),
     RelativeInstallPath: linkableDep.RelativeInstallPath})
  }
 })

 for _, dataSrcPath := range dataSrcPaths {
  test.data = append(test.data, android.DataPath{SrcPath: dataSrcPath})
 }

 // default relative install path is module name
 if !Bool(test.Properties.No_named_install_directory) {
  test.relative = ctx.ModuleName()
 } else if String(test.baseCompiler.Properties.Relative_install_path) == "" {
  ctx.PropertyErrorf("no_named_install_directory", "Module install directory may only be disabled if relative_install_path is set")
 }

 if ctx.Host() && test.Properties.Test_options.Unit_test == nil {
  test.Properties.Test_options.Unit_test = proptools.BoolPtr(true)
 }

 // Install the test config in testcases/ directory for atest.
 mainFile := ctx.RustModule().OutputFile().Path()
 ctx.SetTestSuiteInfo(android.TestSuiteInfo{
  NameSuffix:      ctx.RustModule().SubName(),
  TestSuites:      test.Properties.Test_suites,
  MainFile:        mainFile,
  MainFileStem:    mainFile.Base(),
  ConfigFile:      test.testConfig,
  Data:            test.data,
  NeedsArchFolder: true,
  IsUnitTest:      Bool(test.Properties.Test_options.Unit_test),
 })

 test.installTestData(ctx, test.data)
 test.binaryDecorator.install(ctx)
}

func (test *testDecorator) compilerFlags(ctx ModuleContext, flags Flags) Flags {
 flags = test.binaryDecorator.compilerFlags(ctx, flags)
 if test.testHarness() {
  flags.RustFlags = append(flags.RustFlags, "--test")
  flags.RustFlags = append(flags.RustFlags, "-A missing-docs")
 }
 if ctx.Device() {
  flags.RustFlags = append(flags.RustFlags, "-Z panic_abort_tests")
 }

 // Add a default rpath to allow tests to dlopen libraries specified in data_libs.
 flags.GlobalLinkFlags.Flags += ` -Wl,-rpath,\$$ORIGIN/lib64`
 flags.GlobalLinkFlags.Flags += ` -Wl,-rpath,\$$ORIGIN/lib`

 return flags
}

func (test *testDecorator) autoDep(ctx android.BottomUpMutatorContext) autoDep {
 return rlibAutoDep
}

func init() {
 // Rust tests are binary files built with --test.
 android.RegisterModuleType("rust_test", RustTestFactory)
 android.RegisterModuleType("rust_test_host", RustTestHostFactory)
}

func RustTestFactory() android.Module {
 module, _ := NewRustTest(android.HostAndDeviceSupported)

 // NewRustTest will set MultilibBoth true, however the host variant
 // cannot produce the non-primary target. Therefore, add the
 // rustTestHostMultilib load hook to set MultilibFirst for the
 // host target.
 android.AddLoadHook(module, rustTestHostMultilib)

 // Keep symbols for test binaries, so that they can have proper backtraces.
 android.AddLoadHook(module, rustTestKeepSymbols)

 // Windows tests are currently unsupported, so disable them.
 // To support Windows test modules, we likely need to switch
 // to panic=unwind.
 android.AddLoadHook(module, rustTestDisableWindows)
 module.testModule = true
 return module.Init()
}

func RustTestHostFactory() android.Module {
 module, _ := NewRustTest(android.HostSupported)

 // Windows tests are unsupported, so disable them.
 // To support Windows test modules, we likely need to switch
 // to panic=unwind.
 android.AddLoadHook(module, rustTestDisableWindows)
 module.testModule = true
 return module.Init()
}

func (test *testDecorator) stdLinkage(device bool) StdLinkage {
 return RlibStd
}

func (test *testDecorator) compilerDeps(ctx DepsContext, deps Deps) Deps {
 deps = test.binaryDecorator.compilerDeps(ctx, deps)

 deps.Rustlibs = append(deps.Rustlibs, "libtest")

 deps.DataLibs = append(deps.DataLibs, test.Properties.Data_libs...)
 deps.DataBins = append(deps.DataBins, test.Properties.Data_bins...)

 return deps
}

func (test *testDecorator) testBinary() bool {
 return true
}

func (test *testDecorator) moduleInfoJSON(ctx ModuleContext, moduleInfoJSON *android.ModuleInfoJSON) {
 test.binaryDecorator.moduleInfoJSON(ctx, moduleInfoJSON)
 moduleInfoJSON.Class = []string{"NATIVE_TESTS"}
 if Bool(test.Properties.Test_options.Unit_test) {
  moduleInfoJSON.IsUnitTest = "true"
  if ctx.Host() {
   moduleInfoJSON.CompatibilitySuites = append(moduleInfoJSON.CompatibilitySuites, "host-unit-tests")
  }
 }
 moduleInfoJSON.TestOptionsTags = append(moduleInfoJSON.TestOptionsTags, test.Properties.Test_options.Tags...)
 if test.testConfig != nil {
  if _, ok := test.testConfig.(android.WritablePath); ok {
   moduleInfoJSON.AutoTestConfig = []string{"true"}
  }
  moduleInfoJSON.TestConfig = append(moduleInfoJSON.TestConfig, test.testConfig.String())
 }

 moduleInfoJSON.DataDependencies = append(moduleInfoJSON.DataDependencies, test.Properties.Data_bins...)

 if len(test.Properties.Test_suites) > 0 {
  moduleInfoJSON.CompatibilitySuites = append(moduleInfoJSON.CompatibilitySuites, test.Properties.Test_suites...)
 } else {
  moduleInfoJSON.CompatibilitySuites = append(moduleInfoJSON.CompatibilitySuites, "null-suite")
 }
}

func rustTestHostMultilib(ctx android.LoadHookContext) {
 type props struct {
  Target struct {
   Host struct {
    Compile_multilib *string
   }
  }
 }
 p := &props{}
 p.Target.Host.Compile_multilib = proptools.StringPtr("first")
 ctx.AppendProperties(p)
}

func rustTestDisableWindows(ctx android.LoadHookContext) {
 type props struct {
  Target struct {
   Windows struct {
    Enabled bool
   }
  }
 }
 p := &props{}
 p.Target.Windows.Enabled = false
 ctx.AppendProperties(p)
}

func rustTestKeepSymbols(ctx android.LoadHookContext) {
 type props struct {
  Strip struct {
   Keep_symbols *bool
  }
 }
 p := &props{}
 p.Strip.Keep_symbols = proptools.BoolPtr(true)
 ctx.AppendProperties(p)
}