Files
sourcekit-lsp/Sources/SKCore/FallbackBuildSystem.swift
Alex Hoppen 3e9c682cc9 Allow configuring of SourceKit-LSP’s options using .sourcekit-lsp configuration files
The idea here is to unify the different ways in which we can currently set options on SourceKit-LSP in a scalable way: Environment variables, command line arguments to `sourcekit-lsp` and initialization options.

The idea is that a user can define a `~/.sourcekit-lsp/.sourcekit-lsp` file (we store logs in `~/.sourcekit-lsp/logs` on non-Darwin platforms), which will be used as the default configuration for all SourceKit-LSP instances. They can also place a `.sourcekit-lsp` file in the root of a workspace to configure SourceKit-LSP for that project specifically, eg. setting arguments that need to be passed to `swift build` for that project and which thus also need to be set on SourceKit-LSP.

For compatibility reasons, I’m mapping the existing command line options into the new options structure for now. I hope to delete the command line arguments in the future and solely rely on `.sourcekit-lsp` configuration files.

Environment variable will be migrated to `.sourcekit-lsp` in a follow-up commit.

# Conflicts:
#	Sources/SourceKitLSP/SourceKitLSPServer+Options.swift
#	Sources/SourceKitLSP/Swift/SwiftLanguageService.swift
#	Sources/sourcekit-lsp/SourceKitLSP.swift
#	Tests/SourceKitLSPTests/BackgroundIndexingTests.swift
#	Tests/SourceKitLSPTests/ExecuteCommandTests.swift
2024-06-28 22:35:15 +02:00

104 lines
3.2 KiB
Swift

//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2020 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
// See https://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
import BuildServerProtocol
import Dispatch
import Foundation
import LanguageServerProtocol
import SKSupport
import enum PackageLoading.Platform
import struct TSCBasic.AbsolutePath
import class TSCBasic.Process
/// A simple BuildSystem suitable as a fallback when accurate settings are unknown.
public actor FallbackBuildSystem {
private let options: SourceKitLSPOptions.FallbackBuildSystemOptions
public init(options: SourceKitLSPOptions.FallbackBuildSystemOptions) {
self.options = options
}
/// The path to the SDK.
public lazy var sdkpath: AbsolutePath? = {
guard Platform.current == .darwin else { return nil }
return try? AbsolutePath(
validating: Process.checkNonZeroExit(args: "/usr/bin/xcrun", "--show-sdk-path", "--sdk", "macosx")
.trimmingCharacters(in: .whitespacesAndNewlines)
)
}()
@_spi(Testing) public func setSdkPath(_ newValue: AbsolutePath?) {
self.sdkpath = newValue
}
/// Delegate to handle any build system events.
public weak var delegate: BuildSystemDelegate? = nil
public func setDelegate(_ delegate: BuildSystemDelegate?) async {
self.delegate = delegate
}
public var indexStorePath: AbsolutePath? { return nil }
public var indexDatabasePath: AbsolutePath? { return nil }
public var indexPrefixMappings: [PathPrefixMapping] { return [] }
public func buildSettings(for uri: DocumentURI, language: Language) -> FileBuildSettings? {
var fileBuildSettings: FileBuildSettings?
switch language {
case .swift:
fileBuildSettings = settingsSwift(uri.pseudoPath)
case .c, .cpp, .objective_c, .objective_cpp:
fileBuildSettings = settingsClang(uri.pseudoPath, language)
default:
fileBuildSettings = nil
}
fileBuildSettings?.isFallback = true
return fileBuildSettings
}
func settingsSwift(_ file: String) -> FileBuildSettings {
var args: [String] = []
args.append(contentsOf: self.options.swiftCompilerFlags ?? [])
if let sdkpath = sdkpath, !args.contains("-sdk") {
args += [
"-sdk",
sdkpath.pathString,
]
}
args.append(file)
return FileBuildSettings(compilerArguments: args)
}
func settingsClang(_ file: String, _ language: Language) -> FileBuildSettings {
var args: [String] = []
switch language {
case .c:
args.append(contentsOf: self.options.cCompilerFlags ?? [])
case .cpp:
args.append(contentsOf: self.options.cxxCompilerFlags ?? [])
default:
break
}
if let sdkpath = sdkpath, !args.contains("-isysroot") {
args += [
"-isysroot",
sdkpath.pathString,
]
}
args.append(file)
return FileBuildSettings(compilerArguments: args)
}
}