// 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 ( "os" "runtime" "strings" "testing" "github.com/google/blueprint/proptools" "android/soong/android" "android/soong/genrule" ) func TestMain(m *testing.M) { os.Exit(m.Run()) } var prepareForRustTest = android.GroupFixturePreparers( android.PrepareForTestWithArchMutator, android.PrepareForTestWithDefaults, android.PrepareForTestWithPrebuilts, genrule.PrepareForTestWithGenRuleBuildComponents, PrepareForTestWithRustIncludeVndk, android.FixtureModifyProductVariables(func(variables android.FixtureProductVariables) { variables.DeviceVndkVersion = StringPtr("current") variables.ProductVndkVersion = StringPtr("current") variables.Platform_vndk_version = StringPtr("29") }), ) var rustMockedFiles = android.MockFS{ "foo.rs": nil, "foo.c": nil, "src/bar.rs": nil, "src/any.h": nil, "c_includes/c_header.h": nil, "rust_includes/rust_headers.h": nil, "proto.proto": nil, "proto/buf.proto": nil, "buf.proto": nil, "foo.proto": nil, "liby.so": nil, "libz.so": nil, "data.txt": nil, "liblog.map.txt": nil, } // testRust returns a TestContext in which a basic environment has been setup. // This environment contains a few mocked files. See rustMockedFiles for the list of these files. func testRust(t *testing.T, bp string) *android.TestContext { skipTestIfOsNotSupported(t) result := android.GroupFixturePreparers( prepareForRustTest, rustMockedFiles.AddToFixture(), ). RunTestWithBp(t, bp) return result.TestContext } func testRustVndk(t *testing.T, bp string) *android.TestContext { return testRustVndkFs(t, bp, rustMockedFiles) } const ( sharedVendorVariant = "android_vendor.29_arm64_armv8-a_shared" rlibVendorVariant = "android_vendor.29_arm64_armv8-a_rlib_rlib-std" sharedRecoveryVariant = "android_recovery_arm64_armv8-a_shared" rlibRecoveryVariant = "android_recovery_arm64_armv8-a_rlib_rlib-std" binaryCoreVariant = "android_arm64_armv8-a" binaryVendorVariant = "android_vendor.29_arm64_armv8-a" binaryProductVariant = "android_product.29_arm64_armv8-a" binaryRecoveryVariant = "android_recovery_arm64_armv8-a" ) func testRustVndkFs(t *testing.T, bp string, fs android.MockFS) *android.TestContext { return testRustVndkFsVersions(t, bp, fs, "current", "current", "29") } func testRustVndkFsVersions(t *testing.T, bp string, fs android.MockFS, device_version, product_version, vndk_version string) *android.TestContext { skipTestIfOsNotSupported(t) result := android.GroupFixturePreparers( prepareForRustTest, fs.AddToFixture(), android.FixtureModifyProductVariables( func(variables android.FixtureProductVariables) { variables.DeviceVndkVersion = StringPtr(device_version) variables.ProductVndkVersion = StringPtr(product_version) variables.Platform_vndk_version = StringPtr(vndk_version) }, ), ).RunTestWithBp(t, bp) return result.TestContext } func testRustRecoveryFsVersions(t *testing.T, bp string, fs android.MockFS, device_version, vndk_version, recovery_version string) *android.TestContext { skipTestIfOsNotSupported(t) result := android.GroupFixturePreparers( prepareForRustTest, fs.AddToFixture(), android.FixtureModifyProductVariables( func(variables android.FixtureProductVariables) { variables.DeviceVndkVersion = StringPtr(device_version) variables.RecoverySnapshotVersion = StringPtr(recovery_version) variables.Platform_vndk_version = StringPtr(vndk_version) }, ), ).RunTestWithBp(t, bp) return result.TestContext } // testRustCov returns a TestContext in which a basic environment has been // setup. This environment explicitly enables coverage. func testRustCov(t *testing.T, bp string) *android.TestContext { skipTestIfOsNotSupported(t) result := android.GroupFixturePreparers( prepareForRustTest, rustMockedFiles.AddToFixture(), android.FixtureModifyProductVariables( func(variables android.FixtureProductVariables) { variables.ClangCoverage = proptools.BoolPtr(true) variables.Native_coverage = proptools.BoolPtr(true) variables.NativeCoveragePaths = []string{"*"} }, ), ).RunTestWithBp(t, bp) return result.TestContext } // testRustError ensures that at least one error was raised and its value // matches the pattern provided. The error can be either in the parsing of the // Blueprint or when generating the build actions. func testRustError(t *testing.T, pattern string, bp string) { skipTestIfOsNotSupported(t) android.GroupFixturePreparers( prepareForRustTest, rustMockedFiles.AddToFixture(), ). ExtendWithErrorHandler(android.FixtureExpectsAtLeastOneErrorMatchingPattern(pattern)). RunTestWithBp(t, bp) } // testRustVndkError is similar to testRustError, but can be used to test VNDK-related errors. func testRustVndkError(t *testing.T, pattern string, bp string) { testRustVndkFsError(t, pattern, bp, rustMockedFiles) } func testRustVndkFsError(t *testing.T, pattern string, bp string, fs android.MockFS) { skipTestIfOsNotSupported(t) android.GroupFixturePreparers( prepareForRustTest, fs.AddToFixture(), android.FixtureModifyProductVariables( func(variables android.FixtureProductVariables) { variables.DeviceVndkVersion = StringPtr("current") variables.ProductVndkVersion = StringPtr("current") variables.Platform_vndk_version = StringPtr("VER") }, ), ). ExtendWithErrorHandler(android.FixtureExpectsAtLeastOneErrorMatchingPattern(pattern)). RunTestWithBp(t, bp) } // testRustCtx is used to build a particular test environment. Unless your // tests requires a specific setup, prefer the wrapping functions: testRust, // testRustCov or testRustError. type testRustCtx struct { bp string fs map[string][]byte env map[string]string config *android.Config } func skipTestIfOsNotSupported(t *testing.T) { // TODO (b/140435149) if runtime.GOOS != "linux" { t.Skip("Rust Soong tests can only be run on Linux hosts currently") } } // Test that we can extract the link path from a lib path. func TestLinkPathFromFilePath(t *testing.T) { barPath := android.PathForTesting("out/soong/.intermediates/external/libbar/libbar/linux_glibc_x86_64_shared/libbar.so") libName := linkPathFromFilePath(barPath) expectedResult := "out/soong/.intermediates/external/libbar/libbar/linux_glibc_x86_64_shared/" if libName != expectedResult { t.Errorf("libNameFromFilePath returned the wrong name; expected '%#v', got '%#v'", expectedResult, libName) } } // Test to make sure dependencies are being picked up correctly. func TestDepsTracking(t *testing.T) { ctx := testRust(t, ` cc_library { host_supported: true, name: "cc_stubs_dep", } rust_ffi_host_static { name: "libstatic", srcs: ["foo.rs"], crate_name: "static", } rust_ffi_host_static { name: "libwholestatic", srcs: ["foo.rs"], crate_name: "wholestatic", } rust_ffi_host_shared { name: "libshared", srcs: ["foo.rs"], crate_name: "shared", } rust_library_host_dylib { name: "libdylib", srcs: ["foo.rs"], crate_name: "dylib", } rust_library_host_rlib { name: "librlib", srcs: ["foo.rs"], crate_name: "rlib", static_libs: ["libstatic"], whole_static_libs: ["libwholestatic"], shared_libs: ["cc_stubs_dep"], } rust_proc_macro { name: "libpm", srcs: ["foo.rs"], crate_name: "pm", } rust_binary_host { name: "fizz-buzz", dylibs: ["libdylib"], rlibs: ["librlib"], proc_macros: ["libpm"], static_libs: ["libstatic"], shared_libs: ["libshared"], srcs: ["foo.rs"], } `) module := ctx.ModuleForTests("fizz-buzz", "linux_glibc_x86_64").Module().(*Module) rustc := ctx.ModuleForTests("librlib", "linux_glibc_x86_64_rlib_rlib-std").Rule("rustc") rustLink := ctx.ModuleForTests("fizz-buzz", "linux_glibc_x86_64").Rule("rustLink") // Since dependencies are added to AndroidMk* properties, we can check these to see if they've been picked up. if !android.InList("libdylib", module.Properties.AndroidMkDylibs) { t.Errorf("Dylib dependency not detected (dependency missing from AndroidMkDylibs)") } if !android.InList("librlib.rlib-std", module.Properties.AndroidMkRlibs) { t.Errorf("Rlib dependency not detected (dependency missing from AndroidMkRlibs)") } if !android.InList("libpm", module.Properties.AndroidMkProcMacroLibs) { t.Errorf("Proc_macro dependency not detected (dependency missing from AndroidMkProcMacroLibs)") } if !android.InList("libshared", module.Properties.AndroidMkSharedLibs) { t.Errorf("Shared library dependency not detected (dependency missing from AndroidMkSharedLibs)") } if !android.InList("libstatic", module.Properties.AndroidMkStaticLibs) { t.Errorf("Static library dependency not detected (dependency missing from AndroidMkStaticLibs)") } if !strings.Contains(rustc.Args["rustcFlags"], "-lstatic=wholestatic") { t.Errorf("-lstatic flag not being passed to rustc for static library %#v", rustc.Args["rustcFlags"]) } if !strings.Contains(rustLink.Args["linkFlags"], "cc_stubs_dep.so") { t.Errorf("shared cc_library not being passed to rustc linkFlags %#v", rustLink.Args["linkFlags"]) } if !android.SuffixInList(rustLink.OrderOnly.Strings(), "cc_stubs_dep.so") { t.Errorf("shared cc dep not being passed as order-only to rustc %#v", rustLink.OrderOnly.Strings()) } if !android.SuffixInList(rustLink.Implicits.Strings(), "cc_stubs_dep.so.toc") { t.Errorf("shared cc dep TOC not being passed as implicit to rustc %#v", rustLink.Implicits.Strings()) } } func TestSourceProviderDeps(t *testing.T) { ctx := testRust(t, ` rust_binary { name: "fizz-buzz-dep", srcs: [ "foo.rs", ":my_generator", ":libbindings", ], rlibs: ["libbindings"], } rust_proc_macro { name: "libprocmacro", srcs: [ "foo.rs", ":my_generator", ":libbindings", ], rlibs: ["libbindings"], crate_name: "procmacro", } rust_library { name: "libfoo", srcs: [ "foo.rs", ":my_generator", ":libbindings", ], rlibs: ["libbindings"], crate_name: "foo", } genrule { name: "my_generator", tools: ["any_rust_binary"], cmd: "$(location) -o $(out) $(in)", srcs: ["src/any.h"], out: ["src/any.rs"], } rust_binary_host { name: "any_rust_binary", srcs: [ "foo.rs", ], } rust_bindgen { name: "libbindings", crate_name: "bindings", source_stem: "bindings", host_supported: true, wrapper_src: "src/any.h", } `) libfoo := ctx.ModuleForTests("libfoo", "android_arm64_armv8-a_rlib_dylib-std").Rule("rustc") if !android.SuffixInList(libfoo.Implicits.Strings(), "/out/bindings.rs") { t.Errorf("rust_bindgen generated source not included as implicit input for libfoo; Implicits %#v", libfoo.Implicits.Strings()) } if !android.SuffixInList(libfoo.Implicits.Strings(), "/out/any.rs") { t.Errorf("genrule generated source not included as implicit input for libfoo; Implicits %#v", libfoo.Implicits.Strings()) } fizzBuzz := ctx.ModuleForTests("fizz-buzz-dep", "android_arm64_armv8-a").Rule("rustc") if !android.SuffixInList(fizzBuzz.Implicits.Strings(), "/out/bindings.rs") { t.Errorf("rust_bindgen generated source not included as implicit input for fizz-buzz-dep; Implicits %#v", libfoo.Implicits.Strings()) } if !android.SuffixInList(fizzBuzz.Implicits.Strings(), "/out/any.rs") { t.Errorf("genrule generated source not included as implicit input for fizz-buzz-dep; Implicits %#v", libfoo.Implicits.Strings()) } libprocmacro := ctx.ModuleForTests("libprocmacro", "linux_glibc_x86_64").Rule("rustc") if !android.SuffixInList(libprocmacro.Implicits.Strings(), "/out/bindings.rs") { t.Errorf("rust_bindgen generated source not included as implicit input for libprocmacro; Implicits %#v", libfoo.Implicits.Strings()) } if !android.SuffixInList(libprocmacro.Implicits.Strings(), "/out/any.rs") { t.Errorf("genrule generated source not included as implicit input for libprocmacro; Implicits %#v", libfoo.Implicits.Strings()) } // Check that our bindings are picked up as crate dependencies as well libfooMod := ctx.ModuleForTests("libfoo", "android_arm64_armv8-a_dylib").Module().(*Module) if !android.InList("libbindings.dylib-std", libfooMod.Properties.AndroidMkRlibs) { t.Errorf("bindgen dependency not detected as a rlib dependency (dependency missing from AndroidMkRlibs)") } fizzBuzzMod := ctx.ModuleForTests("fizz-buzz-dep", "android_arm64_armv8-a").Module().(*Module) if !android.InList("libbindings.dylib-std", fizzBuzzMod.Properties.AndroidMkRlibs) { t.Errorf("bindgen dependency not detected as a rlib dependency (dependency missing from AndroidMkRlibs)") } libprocmacroMod := ctx.ModuleForTests("libprocmacro", "linux_glibc_x86_64").Module().(*Module) if !android.InList("libbindings.rlib-std", libprocmacroMod.Properties.AndroidMkRlibs) { t.Errorf("bindgen dependency not detected as a rlib dependency (dependency missing from AndroidMkRlibs)") } } func TestSourceProviderTargetMismatch(t *testing.T) { // This might error while building the dependency tree or when calling depsToPaths() depending on the lunched // target, which results in two different errors. So don't check the error, just confirm there is one. testRustError(t, ".*", ` rust_proc_macro { name: "libprocmacro", srcs: [ "foo.rs", ":libbindings", ], crate_name: "procmacro", } rust_bindgen { name: "libbindings", crate_name: "bindings", source_stem: "bindings", wrapper_src: "src/any.h", } `) } // Test to make sure proc_macros use host variants when building device modules. func TestProcMacroDeviceDeps(t *testing.T) { ctx := testRust(t, ` rust_library_host_rlib { name: "libbar", srcs: ["foo.rs"], crate_name: "bar", } rust_proc_macro { name: "libpm", rlibs: ["libbar"], srcs: ["foo.rs"], crate_name: "pm", } rust_binary { name: "fizz-buzz", proc_macros: ["libpm"], srcs: ["foo.rs"], } `) rustc := ctx.ModuleForTests("libpm", "linux_glibc_x86_64").Rule("rustc") if !strings.Contains(rustc.Args["libFlags"], "libbar/linux_glibc_x86_64") { t.Errorf("Proc_macro is not using host variant of dependent modules.") } } // Test that no_stdlibs suppresses dependencies on rust standard libraries func TestNoStdlibs(t *testing.T) { ctx := testRust(t, ` rust_binary { name: "fizz-buzz", srcs: ["foo.rs"], no_stdlibs: true, }`) module := ctx.ModuleForTests("fizz-buzz", "android_arm64_armv8-a").Module().(*Module) if android.InList("libstd", module.Properties.AndroidMkDylibs) { t.Errorf("no_stdlibs did not suppress dependency on libstd") } } // Test that libraries provide both 32-bit and 64-bit variants. func TestMultilib(t *testing.T) { ctx := testRust(t, ` rust_library_rlib { name: "libfoo", srcs: ["foo.rs"], crate_name: "foo", }`) _ = ctx.ModuleForTests("libfoo", "android_arm64_armv8-a_rlib_dylib-std") _ = ctx.ModuleForTests("libfoo", "android_arm_armv7-a-neon_rlib_dylib-std") } // Test that library size measurements are generated. func TestLibrarySizes(t *testing.T) { ctx := testRust(t, ` rust_library_dylib { name: "libwaldo", srcs: ["foo.rs"], crate_name: "waldo", }`) m := ctx.SingletonForTests("file_metrics") m.Output("unstripped/libwaldo.dylib.so.bloaty.csv") m.Output("libwaldo.dylib.so.bloaty.csv") } func assertString(t *testing.T, got, expected string) { t.Helper() if got != expected { t.Errorf("expected %q got %q", expected, got) } }