// swift-tools-version:6.4 //===----------------------------------------------------------------------===// // // This source file is part of the Swift Collections open source project // // Copyright (c) 2021 - 2026 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 // // SPDX-License-Identifier: Apache-2.0 WITH Swift-exception // //===----------------------------------------------------------------------===// import PackageDescription let _traits: Set = [ .default( enabledTraits: [ // "UnstableContainersPreview", // "UnstableHashedContainers", // "UnstableSortedCollections", ]), .trait( name: "UnstableContainersPreview", description: """ Enables source-unstable components of the ContainersPreview module in swift-collections. This allows experimental use of the Container protocols and associated algorithms. """), .trait( name: "UnstableSortedCollections", description: """ Enables source-unstable prototypes of `SortedSet` and `SortedDictionary`, two potential new collection types implementing in-memory B-trees. These are early developer drafts, and they not ready for use in production. We will make significant, source breaking API changes to these types before they ship. """), .trait( name: "UnstableHashedContainers", description: """ Enables support for noncopyable set members and dictionary keys in `BasicContainers`. This requires a Standard Library with generalized `Equatable` and `Hashable` protocols that allow noncopyable conformers; this feature has not shipped in a stable compiler version yet. """), ] // This package recognizes the conditional compilation flags listed below. // To use enable them, uncomment the corresponding lines or define them // from the package manager command line: // // swift build -Xswiftc -DCOLLECTIONS_INTERNAL_CHECKS var defines: [SwiftSetting] = [ // Enables internal consistency checks at the end of initializers and // mutating operations. This can have very significant overhead, so enabling // this setting invalidates all documented performance guarantees. // // This is mostly useful while debugging an issue with the implementation of // the hash table itself. This setting should never be enabled in production // code. // .define("COLLECTIONS_INTERNAL_CHECKS"), // Hashing collections provided by this package usually seed their hash // function with the address of the memory location of their storage, // to prevent some common hash table merge/copy operations from regressing to // quadratic behavior. This setting turns off this mechanism, seeding // the hash function with the table's size instead. // // When used in conjunction with the SWIFT_DETERMINISTIC_HASHING environment // variable, this enables reproducible hashing behavior. // // This is mostly useful while debugging an issue with the implementation of // the hash table itself. This setting should never be enabled in production // code. // .define("COLLECTIONS_DETERMINISTIC_HASHING"), // Enables randomized testing of some data structure implementations. .define("COLLECTIONS_RANDOMIZED_TESTING"), // Enable this to build the sources as a single, large module. // This removes the distinct modules for each data structure, instead // putting them all directly into the `Collections` module. // Note: This is a source-incompatible variation of the default configuration. // .define("COLLECTIONS_SINGLE_MODULE"), // Enables longer, more exhaustive tests. // .define("COLLECTIONS_LONG_TESTS"), ] let availabilityMacros: KeyValuePairs = [ "SwiftStdlib 5.0": "macOS 10.14.4, iOS 12.2, watchOS 5.2, tvOS 12.2", "SwiftStdlib 5.1": "macOS 10.15, iOS 13.0, watchOS 6.0, tvOS 13.0", "SwiftStdlib 5.6": "macOS 12.3, iOS 15.4, watchOS 8.5, tvOS 15.4", "SwiftStdlib 5.7": "macOS 13.0, iOS 16.0, watchOS 9.0, tvOS 16.0", "SwiftStdlib 5.8": "macOS 13.3, iOS 16.4, watchOS 9.4, tvOS 16.4", "SwiftStdlib 5.9": "macOS 14.0, iOS 17.0, watchOS 10.0, tvOS 17.0", "SwiftStdlib 5.10": "macOS 14.4, iOS 17.4, watchOS 10.4, tvOS 17.4, visionOS 1.1", "SwiftStdlib 6.0": "macOS 15.0, iOS 18.0, watchOS 11.0, tvOS 18.0, visionOS 2.0", "SwiftStdlib 6.1": "macOS 15.4, iOS 18.4, watchOS 11.4, tvOS 18.4, visionOS 2.4", "SwiftStdlib 6.2": "macOS 26.0, iOS 26.0, watchOS 26.0, tvOS 26.0, visionOS 26.0", "SwiftStdlib 6.3": "macOS 26.4, iOS 26.4, watchOS 26.4, tvOS 26.4, visionOS 26.4", "SwiftStdlib 6.4": "macOS 27.0, iOS 27.0, watchOS 27.0, tvOS 27.0, visionOS 27.0", "SwiftStdlib 6.5": "macOS 9999, iOS 9999, watchOS 9999, tvOS 9999, visionOS 9999", // Note: if you touch these, please make sure to also update the similar lists in // CMakeLists.txt and Xcode/Shared.xcconfig. ] let extraSettings: [SwiftSetting] = [ .strictMemorySafety(), .enableUpcomingFeature("MemberImportVisibility"), .enableExperimentalFeature("BuiltinModule"), .enableExperimentalFeature("Lifetimes"), .enableExperimentalFeature("InoutLifetimeDependence"), .enableExperimentalFeature("SuppressedAssociatedTypesWithDefaults"), // Requires Swift 6.4 // Note: if you touch these, please make sure to also update the similar lists in // CMakeLists.txt and Xcode/Shared.xcconfig. ] let _baseSettings: [SwiftSetting] = ( defines + availabilityMacros.map { name, value in .enableExperimentalFeature("AvailabilityMacro=\(name): \(value)") } ) let _settings: [SwiftSetting] = _baseSettings + extraSettings let _testSettings: [SwiftSetting] = _settings struct CustomTarget { enum Kind { case exported case hidden case test case testSupport } var kind: Kind var name: String var dependencies: [Target.Dependency] var directory: String var exclude: [String] var sources: [String]? var settings: [SwiftSetting] } extension CustomTarget.Kind { func path(for name: String) -> String { switch self { case .exported, .hidden: return "Sources/\(name)" case .test, .testSupport: return "Tests/\(name)" } } var isTest: Bool { switch self { case .exported, .hidden: return false case .test, .testSupport: return true } } } extension CustomTarget { static func target( kind: Kind, name: String, dependencies: [Target.Dependency] = [], directory: String? = nil, exclude: [String] = [], sources: [String]? = nil, settings: [SwiftSetting]? = nil ) -> CustomTarget { CustomTarget( kind: kind, name: name, dependencies: dependencies, directory: directory ?? name, exclude: exclude, sources: sources, settings: settings ?? (kind.isTest ? _testSettings : _settings)) } func toTarget() -> Target { var linkerSettings: [LinkerSetting] = [] if kind == .testSupport { linkerSettings.append( .linkedFramework("XCTest", .when(platforms: [.macOS, .iOS, .watchOS, .tvOS]))) } switch kind { case .exported, .hidden, .testSupport: return Target.target( name: name, dependencies: dependencies, path: kind.path(for: directory), exclude: exclude, sources: sources, swiftSettings: settings, linkerSettings: linkerSettings) case .test: return Target.testTarget( name: name, dependencies: dependencies, path: kind.path(for: directory), exclude: exclude, swiftSettings: settings, linkerSettings: linkerSettings) } } } let targets: [CustomTarget] = [ .target( kind: .testSupport, name: "_CollectionsTestSupport", dependencies: [ "InternalCollectionsUtilities", "ContainersPreview", "BasicContainers", "DequeModule", "SpanPreview", ]), .target( kind: .test, name: "CollectionsTestSupportTests", dependencies: ["_CollectionsTestSupport"]), .target( kind: .hidden, name: "InternalCollectionsUtilities", exclude: [ "CMakeLists.txt", ]), .target( kind: .exported, name: "BasicContainers", dependencies: ["InternalCollectionsUtilities", "SpanPreview"], exclude: ["CMakeLists.txt"] ), .target( kind: .test, name: "BasicContainersTests", dependencies: [ "BasicContainers", "_CollectionsTestSupport" ]), .target( kind: .exported, name: "BitCollections", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "BitCollectionsTests", dependencies: [ "BitCollections", "_CollectionsTestSupport", "OrderedCollections" ]), .target( kind: .exported, name: "ContainersPreview", dependencies: [ "InternalCollectionsUtilities", "BasicContainers", "DequeModule", "SpanPreview", ], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "ContainersTests", dependencies: [ "ContainersPreview", "_CollectionsTestSupport" ]), .target( kind: .exported, name: "DequeModule", dependencies: ["InternalCollectionsUtilities", "SpanPreview"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "DequeTests", dependencies: ["DequeModule", "_CollectionsTestSupport"]), .target( kind: .exported, name: "HashTreeCollections", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "HashTreeCollectionsTests", dependencies: ["HashTreeCollections", "_CollectionsTestSupport"]), .target( kind: .exported, name: "HeapModule", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "HeapTests", dependencies: ["HeapModule", "_CollectionsTestSupport"]), .target( kind: .exported, name: "OrderedCollections", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "OrderedCollectionsTests", dependencies: ["OrderedCollections", "_CollectionsTestSupport"]), .target( kind: .exported, name: "_RopeModule", dependencies: ["InternalCollectionsUtilities"], directory: "RopeModule", exclude: ["CMakeLists.txt"], // FIXME: _modify accessors in RopeModule seem to be broken in Swift 6 mode settings: _settings + [.swiftLanguageMode(.v5)]), .target( kind: .test, name: "RopeModuleTests", dependencies: ["_RopeModule", "_CollectionsTestSupport"]), .target( kind: .exported, name: "SpanPreview", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "SpanPreviewTests", dependencies: ["SpanPreview", "_CollectionsTestSupport"]), .target( kind: .exported, name: "TrailingElementsModule", dependencies: ["InternalCollectionsUtilities"], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "TrailingElementsTests", dependencies: ["TrailingElementsModule", "_CollectionsTestSupport"]), .target( kind: .exported, name: "SortedCollections", dependencies: ["InternalCollectionsUtilities"], directory: "SortedCollections"), .target( kind: .test, name: "SortedCollectionsTests", dependencies: ["SortedCollections", "_CollectionsTestSupport"]), .target( kind: .exported, name: "Collections", dependencies: [ "BitCollections", "DequeModule", "HashTreeCollections", "HeapModule", "OrderedCollections", "_RopeModule", ], exclude: ["CMakeLists.txt"]), .target( kind: .test, name: "CollectionsModuleTests", dependencies: ["Collections", "_CollectionsTestSupport"], settings: _baseSettings + [.enableUpcomingFeature("MemberImportVisibility")]), ] let _products: [Product] = targets.compactMap { t in guard t.kind == .exported else { return nil } return .library(name: t.name, targets: [t.name]) } let _targets: [Target] = targets.map { $0.toTarget() } let package = Package( name: "swift-collections", products: _products, traits: _traits, targets: _targets)