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 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251
|
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift open source project
//
// Copyright (c) 2021 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See http://swift.org/LICENSE.txt for license information
// See http://swift.org/CONTRIBUTORS.txt for the list of Swift project authors
//
//===----------------------------------------------------------------------===//
import Basics
import Dispatch
import PackageGraph
import PackageLoading
import PackageModel
import PackageRegistry
import class TSCBasic.InMemoryFileSystem
import struct TSCUtility.Version
public class RegistryPackageContainer: PackageContainer {
public let package: PackageReference
private let registryClient: RegistryClient
private let identityResolver: IdentityResolver
private let dependencyMapper: DependencyMapper
private let manifestLoader: ManifestLoaderProtocol
private let currentToolsVersion: ToolsVersion
private let observabilityScope: ObservabilityScope
private var knownVersionsCache = ThreadSafeBox<[Version]>()
private var toolsVersionsCache = ThreadSafeKeyValueStore<Version, ToolsVersion>()
private var validToolsVersionsCache = ThreadSafeKeyValueStore<Version, Bool>()
private var manifestsCache = ThreadSafeKeyValueStore<Version, Manifest>()
private var availableManifestsCache = ThreadSafeKeyValueStore<Version, (manifests: [String: (toolsVersion: ToolsVersion, content: String?)], fileSystem: FileSystem)>()
public init(
package: PackageReference,
identityResolver: IdentityResolver,
dependencyMapper: DependencyMapper,
registryClient: RegistryClient,
manifestLoader: ManifestLoaderProtocol,
currentToolsVersion: ToolsVersion,
observabilityScope: ObservabilityScope
) {
self.package = package
self.identityResolver = identityResolver
self.dependencyMapper = dependencyMapper
self.registryClient = registryClient
self.manifestLoader = manifestLoader
self.currentToolsVersion = currentToolsVersion
self.observabilityScope = observabilityScope.makeChildScope(
description: "RegistryPackageContainer",
metadata: package.diagnosticsMetadata)
}
// MARK: - PackageContainer
public func isToolsVersionCompatible(at version: Version) -> Bool {
self.validToolsVersionsCache.memoize(version) {
do {
let toolsVersion = try self.toolsVersion(for: version)
try toolsVersion.validateToolsVersion(currentToolsVersion, packageIdentity: package.identity)
return true
} catch {
return false
}
}
}
public func toolsVersion(for version: Version) throws -> ToolsVersion {
try self.toolsVersionsCache.memoize(version) {
let result = try temp_await {
self.getAvailableManifestsFilesystem(version: version, completion: $0)
}
// find the manifest path and parse it's tools-version
let manifestPath = try ManifestLoader.findManifest(packagePath: .root, fileSystem: result.fileSystem, currentToolsVersion: self.currentToolsVersion)
return try ToolsVersionParser.parse(manifestPath: manifestPath, fileSystem: result.fileSystem)
}
}
public func versionsDescending() throws -> [Version] {
try self.knownVersionsCache.memoize {
let metadata = try temp_await {
self.registryClient.getPackageMetadata(
package: self.package.identity,
observabilityScope: self.observabilityScope,
callbackQueue: .sharedConcurrent,
completion: $0
)
}
return metadata.versions.sorted(by: >)
}
}
public func versionsAscending() throws -> [Version] {
try self.versionsDescending().reversed()
}
public func toolsVersionsAppropriateVersionsDescending() throws -> [Version] {
try self.versionsDescending().filter(self.isToolsVersionCompatible(at:))
}
public func getDependencies(at version: Version, productFilter: ProductFilter) throws -> [PackageContainerConstraint] {
let manifest = try self.loadManifest(version: version)
return try manifest.dependencyConstraints(productFilter: productFilter)
}
public func getDependencies(at revision: String, productFilter: ProductFilter) throws -> [PackageContainerConstraint] {
throw InternalError("getDependencies for revision not supported by RegistryPackageContainer")
}
public func getUnversionedDependencies(productFilter: ProductFilter) throws -> [PackageContainerConstraint] {
throw InternalError("getUnversionedDependencies not supported by RegistryPackageContainer")
}
public func loadPackageReference(at boundVersion: BoundVersion) throws -> PackageReference {
return self.package
}
// marked internal for testing
internal func loadManifest(version: Version) throws -> Manifest {
return try self.manifestsCache.memoize(version) {
try temp_await {
self.loadManifest(version: version, completion: $0)
}
}
}
private func loadManifest(version: Version, completion: @escaping (Result<Manifest, Error>) -> Void) {
self.getAvailableManifestsFilesystem(version: version) { result in
switch result {
case .failure(let error):
return completion(.failure(error))
case .success(let result):
do {
let manifests = result.manifests
let fileSystem = result.fileSystem
// first, decide the tools-version we should use
guard let defaultManifestToolsVersion = manifests.first(where: { $0.key == Manifest.filename })?.value.toolsVersion else {
throw StringError("Could not find the '\(Manifest.filename)' file for '\(self.package.identity)' '\(version)'")
}
// find the preferred manifest path and parse it's tools-version
let preferredToolsVersionManifestPath = try ManifestLoader.findManifest(packagePath: .root, fileSystem: fileSystem, currentToolsVersion: self.currentToolsVersion)
let preferredToolsVersion = try ToolsVersionParser.parse(manifestPath: preferredToolsVersionManifestPath, fileSystem: fileSystem)
// load the manifest content
let loadManifest = {
self.manifestLoader.load(
packagePath: .root,
packageIdentity: self.package.identity,
packageKind: self.package.kind,
packageLocation: self.package.locationString,
packageVersion: (version: version, revision: nil),
currentToolsVersion: self.currentToolsVersion,
identityResolver: self.identityResolver,
dependencyMapper: self.dependencyMapper,
fileSystem: result.fileSystem,
observabilityScope: self.observabilityScope,
delegateQueue: .sharedConcurrent,
callbackQueue: .sharedConcurrent,
completion: completion
)
}
if preferredToolsVersion == defaultManifestToolsVersion {
// default tools version - we already have the content on disk from getAvailableManifestsFileSystem()
loadManifest()
} else {
// custom tools-version, we need to fetch the content from the server
self.registryClient.getManifestContent(
package: self.package.identity,
version: version,
customToolsVersion: preferredToolsVersion,
observabilityScope: self.observabilityScope,
callbackQueue: .sharedConcurrent
) { result in
switch result {
case .failure(let error):
return completion(.failure(error))
case .success(let manifestContent):
do {
// find the fake manifest so we can replace it with the real manifest content
guard let placeholderManifestFileName = try fileSystem.getDirectoryContents(.root).first(where: { file in
if file == Manifest.basename + "@swift-\(preferredToolsVersion).swift" {
return true
} else if preferredToolsVersion.patch == 0, file == Manifest.basename + "@swift-\(preferredToolsVersion.major).\(preferredToolsVersion.minor).swift" {
return true
} else {
return false
}
}) else {
throw StringError("failed locating placeholder manifest for \(preferredToolsVersion)")
}
// replace the fake manifest with the real manifest content
let manifestPath = AbsolutePath.root.appending(component: placeholderManifestFileName)
try fileSystem.removeFileTree(manifestPath)
try fileSystem.writeFileContents(manifestPath, string: manifestContent)
// finally, load the manifest
loadManifest()
} catch {
return completion(.failure(error))
}
}
}
}
} catch {
return completion(.failure(error))
}
}
}
}
private func getAvailableManifestsFilesystem(version: Version, completion: @escaping (Result<(manifests: [String: (toolsVersion: ToolsVersion, content: String?)], fileSystem: FileSystem), Error>) -> Void) {
// try cached first
if let availableManifests = self.availableManifestsCache[version] {
return completion(.success(availableManifests))
}
// get from server
self.registryClient.getAvailableManifests(
package: self.package.identity,
version: version,
observabilityScope: self.observabilityScope,
callbackQueue: .sharedConcurrent
) { result in
completion(result.tryMap { manifests in
// ToolsVersionLoader is designed to scan files to decide which is the best tools-version
// as such, this writes a fake manifest based on the information returned by the registry
// with only the header line which is all that is needed by ToolsVersionLoader
let fileSystem = InMemoryFileSystem()
for manifest in manifests {
let content = manifest.value.content ?? "// swift-tools-version:\(manifest.value.toolsVersion)"
try fileSystem.writeFileContents(AbsolutePath.root.appending(component: manifest.key), string: content)
}
self.availableManifestsCache[version] = (manifests: manifests, fileSystem: fileSystem)
return (manifests: manifests, fileSystem: fileSystem)
})
}
}
}
// MARK: - CustomStringConvertible
extension RegistryPackageContainer: CustomStringConvertible {
public var description: String {
return "RegistryPackageContainer(\(package.identity))"
}
}
|