File: DependencySource.swift

package info (click to toggle)
swiftlang 6.0.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,519,992 kB
  • sloc: cpp: 9,107,863; ansic: 2,040,022; asm: 1,135,751; python: 296,500; objc: 82,456; f90: 60,502; lisp: 34,951; pascal: 19,946; sh: 18,133; perl: 7,482; ml: 4,937; javascript: 4,117; makefile: 3,840; awk: 3,535; xml: 914; fortran: 619; cs: 573; ruby: 573
file content (142 lines) | stat: -rw-r--r-- 4,817 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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
//===------------------------ Node.swift ----------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 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 class TSCBasic.DiagnosticsEngine

// MARK: - DependencySource
/// Points to the source of dependencies, i.e. the file read to obtain the information.
/*@_spi(Testing)*/
public struct DependencySource: Hashable, CustomStringConvertible {

  public let typedFile: TypedVirtualPath
  /// Keep this for effiencient lookups into the ``ModuleDependencyGraph``
  public let internedFileName: InternedString

  init(typedFile: TypedVirtualPath, internedFileName: InternedString) {
    assert( typedFile.type == .swift ||
            typedFile.type == .swiftModule)
    self.typedFile = typedFile
    self.internedFileName = internedFileName
  }

  public init(_ swiftSourceFile: SwiftSourceFile, _ t: InternedStringTable) {
    let typedFile = swiftSourceFile.typedFile
    self.init(typedFile: typedFile,
              internedFileName: typedFile.file.name.intern(in: t))
  }

  init?(ifAppropriateFor file: VirtualPath.Handle,
        internedString: InternedString) {
    let ext = VirtualPath.lookup(file).extension
    guard let type =
      ext == FileType.swift      .rawValue ? FileType.swift :
      ext == FileType.swiftModule.rawValue ? FileType.swiftModule
      : nil
    else {
      return nil
    }
    self.init(typedFile: TypedVirtualPath(file: file, type: type),
              internedFileName: internedString)
  }

  public var file: VirtualPath { typedFile.file }

  public var description: String {
    typedFile.file.externalDependencyPathDescription
  }

  public func hash(into hasher: inout Hasher) {
    hasher.combine(internedFileName)
  }
  static public func ==(lhs: Self, rhs: Self) -> Bool {
    lhs.internedFileName == rhs.internedFileName
  }
}

// MARK: - reading
extension DependencySource {
  /// Throws if a read error
  /// Returns nil if no dependency info there.
  public func read(
    info: IncrementalCompilationState.IncrementalDependencyAndInputSetup,
    internedStringTable: InternedStringTable
  ) -> SourceFileDependencyGraph? {
    guard let fileToRead = try? fileToRead(info: info) else {return nil}
    do {
      info.reporter?.report("Reading dependencies from \(description)")
      return try SourceFileDependencyGraph.read(from: fileToRead,
                                                on: info.fileSystem,
                                                internedStringTable: internedStringTable)
    }
    catch {
      let msg = "Could not read \(fileToRead) \(error.localizedDescription)"
      info.reporter?.report(msg, fileToRead)
      return nil
    }
  }

  /// Find the file to actually read the dependencies from
  /// - Parameter info: a bundle of useful information
  /// - Returns: The corresponding swiftdeps file for a swift file, or the swiftmodule file for an incremental imports source.
  public func fileToRead(
    info: IncrementalCompilationState.IncrementalDependencyAndInputSetup
  ) throws -> TypedVirtualPath? {
    typedFile.type != .swift
    ? typedFile
    : try info.outputFileMap.getSwiftDeps(for: typedFile, diagnosticEngine: info.diagnosticEngine)
  }
}


extension OutputFileMap {
  fileprivate func getSwiftDeps(
    for sourceFile: TypedVirtualPath,
    diagnosticEngine: DiagnosticsEngine
  ) throws -> TypedVirtualPath? {
    assert(sourceFile.type == FileType.swift)
    guard let swiftDepsHandle = try existingOutput(inputFile: sourceFile.fileHandle,
                                             outputType: .swiftDeps)
    else {
      // The legacy driver fails silently here.
      diagnosticEngine.emit(
        .remarkDisabled("\(sourceFile.file.basename) has no swiftDeps file")
      )
      return nil
    }
    assert(VirtualPath.lookup(swiftDepsHandle).extension == FileType.swiftDeps.rawValue)
    return TypedVirtualPath(file: swiftDepsHandle, type: .swiftDeps)
  }
}


// MARK: - comparing
extension DependencySource: Comparable {
  public static func < (lhs: Self, rhs: Self) -> Bool {
    lhs.file.name < rhs.file.name
  }
}

// MARK: - describing
extension DependencySource {
  /// Answer a single name; for swift modules, the right thing is one level up
  public var shortDescription: String {
    switch typedFile.type {
    case .swiftDeps:
      return file.basename
    case .swiftModule:
      return file.parentDirectory.basename
    default:
      return file.name
    }
  }
}