Fail compilation with an error diagnostic when specified 'SWIFT_DRIVER_<tool>_EXEC' argument does not exist

Resolves rdar://128636621

Author: artemcm

Sources/SwiftDriver/Toolchains/Toolchain.swift

@@ -15,6 +15,7 @@ import class Foundation.Bundle
 
 import func TSCBasic.getEnvSearchPaths
 import func TSCBasic.lookupExecutablePath
+import protocol TSCBasic.DiagnosticData
 import class TSCBasic.DiagnosticsEngine
 import protocol TSCBasic.FileSystem
 import struct TSCBasic.AbsolutePath
@@ -221,33 +222,47 @@ extension Toolchain {
   /// looks in the `executableDir`, `xcrunFind` or in the `searchPaths`.
   /// - Parameter executable: executable to look for [i.e. `swift`]. Executable suffix (eg. `.exe`) should be omitted.
   func lookup(executable: String) throws -> AbsolutePath {
+    // 1. Check the `SWIFT_DRIVER_<TOOLNAME>_EXEC` override.
     if let overrideString = envVar(forExecutable: executable),
        let path = try? AbsolutePath(validating: overrideString) {
+      if !fallbackToExecutableDefaultPath && !fileSystem.isExecutableFile(path) {
+        throw ToolchainError.notAValidExecutablePath(path.pathString)
+      }
       return path
+    // 2. If `-tools-directory` is set, check there.
     } else if let toolDir = toolDirectory,
               let path = lookupExecutablePath(filename: executableName(executable), currentWorkingDirectory: nil, searchPaths: [toolDir]) {
-      // Looking for tools from the tools directory.
       return path
+    // 3. Perform lookup relative to the driver's executable
     } else if let path = lookupExecutablePath(filename: executableName(executable), currentWorkingDirectory: fileSystem.currentWorkingDirectory, searchPaths: [try executableDir]) {
       return path
     }
+
+    // 4. Attempt lookup with `xcrun --find`.
 #if canImport(Darwin)
     if let path = try? xcrunFind(executable: executableName(executable)) {
       return path
     }
 #endif
+
+    // 5. If querying not the compiler frontend itself and the above attempts failed,
+    //    attempt to resolve adjacent to the compiler frontend.
     if !["swift-frontend", "swift"].contains(executable),
         let parentDirectory = try? getToolPath(.swiftCompiler).parentDirectory,
         try parentDirectory != executableDir,
         let path = lookupExecutablePath(filename: executableName(executable), searchPaths: [parentDirectory]) {
       // If the driver library's client and the frontend are in different directories,
       // try looking for tools next to the frontend.
       return path
+    // 6. Perform lookup in the toolchain search paths (e.g. $PATH)
     } else if let path = lookupExecutablePath(filename: executableName(executable), searchPaths: searchPaths) {
       return path
+    // 7. Attempt lookup of `swift` for the compiler frontned
+    //    FIXME: we should remove this now
     } else if executable == "swift-frontend" {
       // Temporary shim: fall back to looking for "swift" before failing.
       return try lookup(executable: "swift")
+    // 8. For testing purposes, attempt lookup in the system "default" paths
     } else if fallbackToExecutableDefaultPath {
       if self is WindowsToolchain {
         return try getToolPath(.swiftCompiler)
@@ -258,7 +273,7 @@ extension Toolchain {
       }
     }
 
-    throw ToolchainError.unableToFind(tool: executable)
+    throw ToolchainError.unableToFind(executable)
   }
 
   /// Looks for the executable in the `SWIFT_DRIVER_SWIFTSCAN_LIB` environment variable, if found nothing,
@@ -311,7 +326,7 @@ extension Toolchain {
   private func xcrunFind(executable: String) throws -> AbsolutePath {
     let xcrun = "xcrun"
     guard lookupExecutablePath(filename: xcrun, searchPaths: searchPaths) != nil else {
-      throw ToolchainError.unableToFind(tool: xcrun)
+      throw ToolchainError.unableToFind(xcrun)
     }
 
     let path = try executor.checkNonZeroExit(
@@ -378,6 +393,17 @@ extension Toolchain {
   }
 }
 
-@_spi(Testing) public enum ToolchainError: Swift.Error {
-  case unableToFind(tool: String)
+@_spi(Testing) public enum ToolchainError: Swift.Error, Equatable, DiagnosticData {
+  case unableToFind(String)
+  case notAValidExecutablePath(String)
+
+  public var description: String {
+    switch self {
+    case .unableToFind(let tool):
+      return "unable to locate tool: '\(tool)'"
+    case .notAValidExecutablePath(let path):
+      return "not a valid executable: \(path)"
+
+    }
+  }
 }

Tests/SwiftDriverTests/SwiftDriverTests.swift

@@ -82,6 +82,7 @@ final class SwiftDriverTests: XCTestCase {
     // so there is no swift-help in the toolchain yet. Set the environment variable
     // as if we had found it for the purposes of testing build planning.
     var env = ProcessEnv.block
+    env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
     env["SWIFT_DRIVER_SWIFT_HELP_EXEC"] = "/tmp/.test-swift-help"
     return env
   }
@@ -2504,6 +2505,7 @@ final class SwiftDriverTests: XCTestCase {
 
   func testWebAssemblyUnsupportedFeatures() throws {
     var env = ProcessEnv.block
+    env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
     env["SWIFT_DRIVER_SWIFT_AUTOLINK_EXTRACT_EXEC"] = "/garbage/swift-autolink-extract"
     do {
       var driver = try Driver(args: ["swift", "-target", "wasm32-unknown-wasi", "foo.swift"], env: env)
@@ -4841,6 +4843,7 @@ final class SwiftDriverTests: XCTestCase {
       // Drop SWIFT_DRIVER_CLANG_EXEC from the environment so it doesn't
       // interfere with tool lookup.
       var env = ProcessEnv.block
+      env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
       env.removeValue(forKey: "SWIFT_DRIVER_CLANG_EXEC")
 
       var driver = try Driver(args: ["swiftc",
@@ -5248,6 +5251,7 @@ final class SwiftDriverTests: XCTestCase {
       // As per Unix conventions, /var/empty is expected to exist and be empty.
       // This gives us a non-existent path that we can use for libtool which
       // allows us to run this this on non-Darwin platforms.
+      env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
       env["SWIFT_DRIVER_LIBTOOL_EXEC"] = "/var/empty/libtool"
 
       // No dSYM generation (-g -emit-library -static)
@@ -6760,6 +6764,7 @@ final class SwiftDriverTests: XCTestCase {
 
   func testEmbeddedSwiftOptions() throws {
     var env = ProcessEnv.block
+    env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
     env["SWIFT_DRIVER_SWIFT_AUTOLINK_EXTRACT_EXEC"] = "/garbage/swift-autolink-extract"
 
     do {
@@ -6916,6 +6921,7 @@ final class SwiftDriverTests: XCTestCase {
     // better override.
     var env = ProcessEnv.block
     let swiftHelp: AbsolutePath = try AbsolutePath(validating: "/usr/bin/nonexistent-swift-help")
+    env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
     env["SWIFT_DRIVER_SWIFT_HELP_EXEC"] = swiftHelp.pathString
     env["SWIFT_DRIVER_CLANG_EXEC"] = "/usr/bin/clang"
     var driver = try Driver(
@@ -6929,6 +6935,7 @@ final class SwiftDriverTests: XCTestCase {
   func testSwiftClangOverride() throws {
     var env = ProcessEnv.block
     let swiftClang = try AbsolutePath(validating: "/A/Path/swift-clang")
+    env["SWIFT_DRIVER_TESTS_ENABLE_EXEC_PATH_FALLBACK"] = "1"
     env["SWIFT_DRIVER_CLANG_EXEC"] = swiftClang.pathString
 
     var driver = try Driver(