File: FileBuildSettings.swift

package info (click to toggle)
swiftlang 6.2.3-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 2,856,264 kB
  • sloc: cpp: 9,995,718; ansic: 2,234,019; asm: 1,092,167; python: 313,940; objc: 82,726; f90: 80,126; lisp: 38,373; pascal: 25,580; sh: 20,378; ml: 5,058; perl: 4,751; makefile: 4,725; awk: 3,535; javascript: 3,018; xml: 918; fortran: 664; cs: 573; ruby: 396
file content (89 lines) | stat: -rw-r--r-- 3,850 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
//===----------------------------------------------------------------------===//
//
// 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 Foundation
package import LanguageServerProtocol
import LanguageServerProtocolExtensions

/// Build settings for a single file.
///
/// Encapsulates all the settings needed to compile a single file, including the compiler arguments
/// and working directory. FileBuildSettings are typically the result of a BuildSystem query.
package struct FileBuildSettings: Equatable, Sendable {

  /// The compiler arguments to use for this file.
  package var compilerArguments: [String]

  /// The working directory to resolve any relative paths in `compilerArguments`.
  package var workingDirectory: String? = nil

  /// The language that the document was interpreted as, and which implies the compiler to which the build settings
  /// would be passed.
  package var language: Language

  /// Additional data about the build settings that was received from the BSP server, will not be interpreted by
  /// SourceKit-LSP but returned to clients in the `workspace/_sourceKitOptions` LSP request.
  package var data: LSPAny?

  /// Whether the build settings were computed from a real build system or whether they are synthesized fallback arguments while the build system is still busy computing build settings.
  package var isFallback: Bool

  package init(
    compilerArguments: [String],
    workingDirectory: String? = nil,
    language: Language,
    data: LSPAny? = nil,
    isFallback: Bool = false
  ) {
    self.compilerArguments = compilerArguments
    self.workingDirectory = workingDirectory
    self.language = language
    self.data = data
    self.isFallback = isFallback
  }

  /// Return arguments suitable for use by `newFile`.
  ///
  /// This patches the arguments by searching for the argument corresponding to
  /// `originalFile` and replacing it.
  package func patching(newFile: DocumentURI, originalFile: DocumentURI) -> FileBuildSettings {
    var arguments = self.compilerArguments
    // URL.lastPathComponent is only set for file URLs but we want to also infer a file extension for non-file URLs like
    // untitled:file.cpp
    let basename = originalFile.fileURL?.lastPathComponent ?? (originalFile.pseudoPath as NSString).lastPathComponent
    if let index = arguments.lastIndex(where: {
      // It's possible the arguments use relative paths while the `originalFile` given
      // is an absolute/real path value. We guess based on suffixes instead of hitting
      // the file system.
      $0.hasSuffix(basename) && originalFile.pseudoPath.hasSuffix($0)
    }) {
      arguments[index] = newFile.pseudoPath
      // The `-x<lang>` flag needs to be before the possible `-c <header file>`
      // argument in order for Clang to respect it. If there is a pre-existing `-x`
      // flag though, Clang will honor that one instead since it comes after.
      switch Language(inferredFromFileExtension: originalFile) {
      case .c: arguments.insert("-xc", at: 0)
      case .cpp: arguments.insert("-xc++", at: 0)
      case .objective_c: arguments.insert("-xobjective-c", at: 0)
      case .objective_cpp: arguments.insert("-xobjective-c++", at: 0)
      default: break
      }
    }
    return FileBuildSettings(
      compilerArguments: arguments,
      workingDirectory: self.workingDirectory,
      language: self.language,
      data: self.data,
      isFallback: self.isFallback
    )
  }
}