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
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift.org open source project
//
// Copyright (c) 2014 - 2024 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 SKCore
/// Protocol of tasks that are executed on the index task scheduler.
///
/// It is assumed that `IndexTaskDescription` of different types are allowed to execute in parallel.
protocol IndexTaskDescription: TaskDescriptionProtocol {
/// A string that is unique to this type of `IndexTaskDescription`. It is used to produce unique IDs for tasks of
/// different types in `AnyIndexTaskDescription`
static var idPrefix: String { get }
var id: UInt32 { get }
}
extension IndexTaskDescription {
func dependencies(
to currentlyExecutingTasks: [AnyIndexTaskDescription]
) -> [TaskDependencyAction<AnyIndexTaskDescription>] {
return self.dependencies(to: currentlyExecutingTasks.compactMap { $0.wrapped as? Self })
.map {
switch $0 {
case .cancelAndRescheduleDependency(let td):
return .cancelAndRescheduleDependency(AnyIndexTaskDescription(td))
case .waitAndElevatePriorityOfDependency(let td):
return .waitAndElevatePriorityOfDependency(AnyIndexTaskDescription(td))
}
}
}
}
/// Type-erased wrapper of an `IndexTaskDescription`.
public struct AnyIndexTaskDescription: TaskDescriptionProtocol {
let wrapped: any IndexTaskDescription
init(_ wrapped: any IndexTaskDescription) {
self.wrapped = wrapped
}
public var isIdempotent: Bool {
return wrapped.isIdempotent
}
public var estimatedCPUCoreCount: Int {
return wrapped.estimatedCPUCoreCount
}
public var id: String {
return "\(type(of: wrapped).idPrefix)-\(wrapped.id)"
}
public var description: String {
return wrapped.description
}
public var redactedDescription: String {
return wrapped.redactedDescription
}
public func execute() async {
return await wrapped.execute()
}
/// Forward to the underlying task to compute the dependencies. Preparation and index tasks don't have any
/// dependencies that are managed by `TaskScheduler`. `SemanticIndexManager` awaits the preparation of a target before
/// indexing files within it.
public func dependencies(
to currentlyExecutingTasks: [AnyIndexTaskDescription]
) -> [TaskDependencyAction<AnyIndexTaskDescription>] {
return wrapped.dependencies(to: currentlyExecutingTasks)
}
}
|