Things that should¹ be in Swift, but aren't.
Because anything worth doing is worth over-doing.
This is a repository of things I have found useful while writing apps and packages for myself.
You should not include this project in your own code. Instead, use it as an example of how I approach problems and a possible way that you might solve the same problem.
¹ - By "should", I mean "At some point in the past, I found this useful enough to pull out into its own thing."
{
"name": "ExtendedSwift",
"path": "/usr/src/package",
"targets": [
{
"name": "debug",
"path": "Sources/debug",
"type": "executable",
"c99name": "debug",
"sources": [
"debug.swift"
],
"module_type": "SwiftTarget",
"product_memberships": [
"debug"
],
"target_dependencies": [
"ExtendedObjC",
"ExtendedSwift",
"ExtendedKit"
]
},
{
"name": "PrivateAPITests",
"path": "Tests/PrivateAPITests",
"type": "test",
"c99name": "PrivateAPITests",
"sources": [
"GregorianDateTests.m"
],
"module_type": "ClangTarget",
"target_dependencies": [
"PrivateAPI"
]
},
{
"name": "PrivateAPI",
"path": "Sources/PrivateAPI",
"type": "library",
"c99name": "PrivateAPI",
"sources": [
"src/AppSession.m",
"src/GregorianDate+Format.m",
"src/GregorianDate+Formatters.m",
"src/GregorianDate.m",
"src/JSON+Serialize.m",
"src/JSON.m",
"src/NSUUID+Time.m",
"src/SignalSafe.m"
],
"module_type": "ClangTarget",
"product_memberships": [
"ExtendedSwift",
"ExtendedKit",
"HTTP",
"debug"
],
"target_dependencies": [
"ExtendedObjC"
]
},
{
"name": "HTTPTests",
"path": "Tests/HTTPTests",
"type": "test",
"c99name": "HTTPTests",
"sources": [
"DeduplicationTests.swift",
"HTTP+TestHelpers.swift",
"HTTPTests.swift",
"ManualLoaderTests.swift",
"ModifyingLoaderTests.swift",
"RetryTests.swift"
],
"module_type": "SwiftTarget",
"target_dependencies": [
"HTTP",
"ExtendedTest"
]
},
{
"name": "HTTP",
"path": "Sources/HTTP",
"type": "library",
"c99name": "HTTP",
"sources": [
"Bodies/DataBody.swift",
"Bodies/FormBody.swift",
"Bodies/JSONBody.swift",
"Loader/DeduplicatingLoader.swift",
"Loader/HTTPEnvironmentLoader.swift",
"Loader/HTTPLoader.swift",
"Loader/ManualLoader.swift",
"Loader/ModifyingLoader.swift",
"Loader/RetryLoader.swift",
"Loader/ThrottledLoader.swift",
"Loader/URLSessionLoader.swift",
"Message/HTTPBody.swift",
"Message/HTTPError.swift",
"Message/HTTPHeader.swift",
"Message/HTTPHeaders.swift",
"Message/HTTPMethod.swift",
"Message/HTTPOption.swift",
"Message/HTTPQuery.swift",
"Message/HTTPRequest.swift",
"Message/HTTPRequestToken.swift",
"Message/HTTPResponse.swift",
"Message/HTTPResult+Convenience.swift",
"Message/HTTPResult.swift",
"Message/HTTPStatus.swift",
"Options/AuthenticationChallenges.swift",
"Options/Deduplication.swift",
"Options/Redirection.swift",
"Options/RetryStrategy.swift",
"Options/Throttling.swift",
"Utilities/AsyncStream.swift",
"Utilities/Duration.swift",
"Utilities/HTTPError+Construction.swift",
"Utilities/HTTPRequest+URLRequest.swift",
"Utilities/HTTPResponse+URLResponse.swift",
"Utilities/LoaderChain.swift",
"Utilities/Pairs.swift",
"Utilities/URLSession/URLSessionAdapter.swift",
"Utilities/URLSession/URLSessionAdapterDelegate.swift",
"Utilities/URLSession/URLSessionTaskState.swift"
],
"module_type": "SwiftTarget",
"product_memberships": [
"HTTP"
],
"target_dependencies": [
"ExtendedSwift"
]
},
{
"name": "ExtendedTest",
"path": "Sources/ExtendedTest",
"type": "library",
"c99name": "ExtendedTest",
"sources": [
"XCTestHelpers.swift"
],
"module_type": "SwiftTarget"
},
{
"name": "ExtendedSwiftTests",
"path": "Tests/ExtendedSwiftTests",
"type": "test",
"c99name": "ExtendedSwiftTests",
"sources": [
"BuilderTests.swift",
"CharacterTests.swift",
"ClockTests.swift",
"CollectionTests.swift",
"CountedSetTests.swift",
"PlistCodableTests.swift",
"RegexTests.swift",
"ScannerTests.swift",
"StringTests.swift",
"TaskQueueTests.swift"
],
"module_type": "SwiftTarget",
"target_dependencies": [
"ExtendedSwift"
]
},
{
"name": "ExtendedSwift",
"path": "Sources/ExtendedSwift",
"type": "library",
"c99name": "ExtendedSwift",
"sources": [
"CloudKit/CKQueryObserver.swift",
"CloudKit/CKRecordCodable.swift",
"CloudKit/CKSubscriptionObserver.swift",
"Codable/AnyCodingKey.swift",
"Codable/CodingPath.swift",
"Codable/Decoding.swift",
"Codable/DecodingError.swift",
"Codable/Encoding.swift",
"Codable/EncodingError.swift",
"Codable/Plist/PlistCodableSupport.swift",
"Codable/Plist/PlistDecoder.swift",
"Codable/Plist/PlistEncoder.swift",
"Codable/PlistCodable.swift",
"Codable/UserDefaultsCodable.swift",
"Combine/Subscriber.swift",
"CoreData/NSAttributeDescription.swift",
"CoreData/NSEntityDescription.swift",
"CoreData/NSFetchRequestPublisher.swift",
"CoreData/NSManagedObjectContext.swift",
"CoreData/NSManagedObjectModel.swift",
"CoreData/NSPersistedAttributeType.swift",
"CoreData/NSPersistentContainer.swift",
"FSEvents/FSEvent.swift",
"FSEvents/FSPublisher.swift",
"FSEvents/NSFileObserver.swift",
"Foundation/ActionScheduler.swift",
"Foundation/Bookmark.swift",
"Foundation/Bundle.swift",
"Foundation/Calendar.swift",
"Foundation/DateFormatter.swift",
"Foundation/Entitlements.swift",
"Foundation/FileManager.swift",
"Foundation/FileWrapper.swift",
"Foundation/Geometry.swift",
"Foundation/NSLock.swift",
"Foundation/NSPredicate.swift",
"Foundation/Process+Which.swift",
"Foundation/Process.swift",
"Foundation/ProcessInfo.swift",
"Foundation/RunLoop.swift",
"Foundation/Scanner+Characters.swift",
"Foundation/Scanner+Data.swift",
"Foundation/Scanner.swift",
"Foundation/Spotlight.swift",
"Foundation/URL.swift",
"Mach/Dyld.swift",
"Mach/FAT.swift",
"Mach/LoadCommands/CodeSignature.swift",
"Mach/LoadCommands/LoadDylibCommand.swift",
"Mach/LoadCommands/MachLoadCommand.swift",
"Mach/LoadCommands/RPathCommand.swift",
"Mach/LoadCommands/UUIDLoadCommand.swift",
"Mach/Mach+Convenience.swift",
"Mach/Mach+Header.swift",
"Mach/Mach+LoadCommand.swift",
"Mach/Mach+Section.swift",
"Mach/Mach+Segment.swift",
"Path/Path+Bundle.swift",
"Path/Path+Data+String.swift",
"Path/Path+FileHandle.swift",
"Path/Path+FileManager.swift",
"Path/Path+Helpers.swift",
"Path/Path+Home.swift",
"Path/Path+URL.swift",
"Path/Path.swift",
"Path/PathProtocol.swift",
"Path/RelativePath.swift",
"Result Builders/ArrayBuilder.swift",
"Standard/AnyAsyncSequence.swift",
"Standard/Atomic.swift",
"Standard/BidirectionalCollection.swift",
"Standard/Bimap.swift",
"Standard/Bool.swift",
"Standard/Buildable.swift",
"Standard/Character.swift",
"Standard/Clocks/Clock.swift",
"Standard/Clocks/Date+InstantProtocol.swift",
"Standard/Clocks/ManualClock.swift",
"Standard/Clocks/MutableClock.swift",
"Standard/Clocks/UserClock.swift",
"Standard/Collection+Flatten.swift",
"Standard/Collection+Slicing.swift",
"Standard/Collection+Trimming.swift",
"Standard/Collection+Unique.swift",
"Standard/Collection.swift",
"Standard/Comparable.swift",
"Standard/CountedSet.swift",
"Standard/Data.swift",
"Standard/Date.swift",
"Standard/Dictionary.swift",
"Standard/Duration.swift",
"Standard/Error.swift",
"Standard/Fatal.swift",
"Standard/ID.swift",
"Standard/Int.swift",
"Standard/Interpolator.swift",
"Standard/KeyPath.swift",
"Standard/LazyTask.swift",
"Standard/Never.swift",
"Standard/Newtype.swift",
"Standard/Normalized.swift",
"Standard/Once.swift",
"Standard/Optional.swift",
"Standard/Range.swift",
"Standard/RangeReplaceableCollection.swift",
"Standard/Regex+Replacements.swift",
"Standard/Regex.swift",
"Standard/Result+CollectionOperators.swift",
"Standard/Result+Operators.swift",
"Standard/Result.swift",
"Standard/Sandbox.swift",
"Standard/Sendable.swift",
"Standard/Sequence.swift",
"Standard/SetAlgebra.swift",
"Standard/Shim.swift",
"Standard/String+HTML.swift",
"Standard/String+Interpolation.swift",
"Standard/String.swift",
"Standard/TaskQueue.swift",
"Standard/UUID.swift",
"Standard/Unsafe.swift",
"Standard/Updateable.swift",
"Standard/Warn.swift",
"Trees/BreadthFirstTraversal.swift",
"Trees/InOrderTraversal.swift",
"Trees/PostOrderTraversal.swift",
"Trees/PreAndPostOrderTraversal.swift",
"Trees/PreOrderTraversal.swift",
"Trees/Tree.swift",
"Trees/TreeTraversal.swift"
],
"resources": [
{
"path": "/usr/src/package/Sources/ExtendedSwift/Resources/entities.json",
"rule": {
"copy": {}
}
}
],
"module_type": "SwiftTarget",
"product_memberships": [
"ExtendedSwift",
"ExtendedKit",
"HTTP",
"debug"
],
"target_dependencies": [
"PrivateAPI"
],
"product_dependencies": [
"Algorithms",
"Logging"
]
},
{
"name": "ExtendedObjCTests",
"path": "Tests/ExtendedObjCTests",
"type": "test",
"c99name": "ExtendedObjCTests",
"sources": [
"RuntimeTests.m"
],
"module_type": "ClangTarget",
"target_dependencies": [
"ExtendedObjC"
]
},
{
"name": "ExtendedObjC",
"path": "Sources/ExtendedObjC",
"type": "library",
"c99name": "ExtendedObjC",
"sources": [
"src/Runtime.m"
],
"module_type": "ClangTarget",
"product_memberships": [
"ExtendedObjC",
"ExtendedSwift",
"ExtendedKit",
"HTTP",
"debug"
]
},
{
"name": "ExtendedKit",
"path": "Sources/ExtendedKit",
"type": "library",
"c99name": "ExtendedKit",
"sources": [
"AppSession/AppSession.swift",
"CLLocation.swift",
"Cocoa/NSActionHandler.swift",
"Cocoa/NSMenu.swift",
"Cocoa/NSTextField.swift",
"CoreData/Fetch.swift",
"CoreData/FetchFilter.swift",
"CoreData/FetchObserver.swift",
"CoreData/FetchOne.swift",
"CoreData/FetchResults.swift",
"CoreData/Fetchable.swift",
"CoreData/NSFetchRequest.swift",
"ExtendedKit.swift",
"Logging/CoreDataLogHandler.swift",
"Logging/LogEntry.swift",
"Logging/LogRedactor.swift",
"Logging/Logger.Metadata.swift",
"Logging/Logger.swift",
"Logging/OSLogHandler.swift",
"Map/MapCluster.swift",
"Map/MapItem.swift",
"Map/MapView.swift",
"Map/_MapView.swift",
"MapKit/MKCoordinateRegion.swift",
"Path+NSWorkspace.swift",
"Platform.swift",
"SwiftUI/Alert.swift",
"SwiftUI/Binding.swift",
"SwiftUI/EdgeInsets.swift",
"SwiftUI/InterfaceOrientation/InterfaceHostingController.swift",
"SwiftUI/InterfaceOrientation/InterfaceOrientation.swift",
"SwiftUI/InterfaceOrientation/InterfacePreferenceKeys.swift",
"SwiftUI/InterfaceOrientation/View+InterfaceOrientation.swift",
"SwiftUI/PartialCapsule.swift",
"SwiftUI/Path.swift",
"SwiftUI/PathControl.swift",
"SwiftUI/ProxyTransferable.swift",
"SwiftUI/Section.swift",
"SwiftUI/Staged.swift",
"SwiftUI/Symbol+SwiftUI.swift",
"SwiftUI/TextStyle.swift",
"SwiftUI/View.swift",
"Symbol.swift",
"XML/XMLNode.swift"
],
"module_type": "SwiftTarget",
"product_memberships": [
"ExtendedKit",
"debug"
],
"target_dependencies": [
"ExtendedSwift",
"ExtendedObjC",
"PrivateAPI"
],
"product_dependencies": [
"Logging"
]
}
],
"products": [
{
"name": "ExtendedObjC",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedObjC"
]
},
{
"name": "ExtendedSwift",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedSwift"
]
},
{
"name": "ExtendedKit",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedKit"
]
},
{
"name": "HTTP",
"type": {
"library": [
"automatic"
]
},
"targets": [
"HTTP"
]
},
{
"name": "debug",
"type": {
"executable": null
},
"targets": [
"debug"
]
}
],
"platforms": [
{
"name": "macos",
"version": "13.0"
},
{
"name": "ios",
"version": "16.1"
},
{
"name": "watchos",
"version": "9.1"
},
{
"name": "tvos",
"version": "16.1"
},
{
"name": "maccatalyst",
"version": "16.1"
}
],
"dependencies": [
{
"url": "https://github.com/apple/swift-algorithms.git",
"type": "sourceControl",
"identity": "swift-algorithms",
"requirement": {
"range": [
{
"lower_bound": "1.0.0",
"upper_bound": "2.0.0"
}
]
}
},
{
"url": "https://github.com/apple/swift-log.git",
"type": "sourceControl",
"identity": "swift-log",
"requirement": {
"range": [
{
"lower_bound": "1.5.0",
"upper_bound": "2.0.0"
}
]
}
}
],
"tools_version": "5.9",
"manifest_display_name": "ExtendedSwift"
}
{
"name": "ExtendedSwift",
"targets": [
{
"name": "ExtendedObjC",
"type": "regular",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [],
"packageAccess": true
},
{
"name": "PrivateAPI",
"type": "regular",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedObjC",
null
]
}
],
"packageAccess": true
},
{
"name": "ExtendedSwift",
"type": "regular",
"exclude": [],
"settings": [
{
"kind": {
"unsafeFlags": {
"_0": [
"-enable-bare-slash-regex"
]
}
},
"tool": "swift"
}
],
"resources": [
{
"path": "Resources/entities.json",
"rule": {
"copy": {}
}
}
],
"dependencies": [
{
"byName": [
"PrivateAPI",
null
]
},
{
"product": [
"Algorithms",
"swift-algorithms",
null,
null
]
},
{
"product": [
"Logging",
"swift-log",
null,
null
]
}
],
"packageAccess": true
},
{
"name": "ExtendedKit",
"type": "regular",
"exclude": [],
"settings": [
{
"kind": {
"unsafeFlags": {
"_0": [
"-enable-bare-slash-regex"
]
}
},
"tool": "swift"
}
],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedSwift",
null
]
},
{
"byName": [
"ExtendedObjC",
null
]
},
{
"byName": [
"PrivateAPI",
null
]
},
{
"product": [
"Logging",
"swift-log",
null,
null
]
}
],
"packageAccess": true
},
{
"name": "ExtendedTest",
"type": "regular",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [],
"packageAccess": true
},
{
"name": "HTTP",
"type": "regular",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedSwift",
null
]
}
],
"packageAccess": true
},
{
"name": "ExtendedSwiftTests",
"type": "test",
"exclude": [],
"settings": [
{
"kind": {
"unsafeFlags": {
"_0": [
"-enable-bare-slash-regex"
]
}
},
"tool": "swift"
}
],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedSwift",
null
]
}
],
"packageAccess": true
},
{
"name": "PrivateAPITests",
"type": "test",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"PrivateAPI",
null
]
}
],
"packageAccess": true
},
{
"name": "ExtendedObjCTests",
"type": "test",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedObjC",
null
]
}
],
"packageAccess": true
},
{
"name": "HTTPTests",
"type": "test",
"exclude": [],
"settings": [],
"resources": [],
"dependencies": [
{
"byName": [
"HTTP",
null
]
},
{
"byName": [
"ExtendedTest",
null
]
}
],
"packageAccess": true
},
{
"name": "debug",
"type": "executable",
"exclude": [],
"settings": [
{
"kind": {
"unsafeFlags": {
"_0": [
"-enable-bare-slash-regex"
]
}
},
"tool": "swift"
}
],
"resources": [],
"dependencies": [
{
"byName": [
"ExtendedObjC",
null
]
},
{
"byName": [
"ExtendedSwift",
null
]
},
{
"byName": [
"ExtendedKit",
null
]
}
],
"packageAccess": true
}
],
"products": [
{
"name": "ExtendedObjC",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedObjC"
]
},
{
"name": "ExtendedSwift",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedSwift"
]
},
{
"name": "ExtendedKit",
"type": {
"library": [
"automatic"
]
},
"targets": [
"ExtendedKit"
]
},
{
"name": "HTTP",
"type": {
"library": [
"automatic"
]
},
"targets": [
"HTTP"
]
},
{
"name": "debug",
"type": {
"executable": null
},
"targets": [
"debug"
]
}
],
"pkgConfig": null,
"platforms": [
{
"options": [],
"version": "13.0",
"platformName": "macos"
},
{
"options": [],
"version": "16.1",
"platformName": "ios"
},
{
"options": [],
"version": "9.1",
"platformName": "watchos"
},
{
"options": [],
"version": "16.1",
"platformName": "tvos"
},
{
"options": [],
"version": "16.1",
"platformName": "maccatalyst"
}
],
"providers": null,
"packageKind": {
"root": [
"/usr/src/package"
]
},
"dependencies": [
{
"sourceControl": [
{
"identity": "swift-algorithms",
"location": {
"remote": [
{
"urlString": "https://github.com/apple/swift-algorithms.git"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "1.0.0",
"upperBound": "2.0.0"
}
]
},
"productFilter": null
}
]
},
{
"sourceControl": [
{
"identity": "swift-log",
"location": {
"remote": [
{
"urlString": "https://github.com/apple/swift-log.git"
}
]
},
"requirement": {
"range": [
{
"lowerBound": "1.5.0",
"upperBound": "2.0.0"
}
]
},
"productFilter": null
}
]
}
],
"toolsVersion": {
"_version": "5.9.0"
},
"cLanguageStandard": null,
"cxxLanguageStandard": null,
"swiftLanguageVersions": null
}
{
"url": "/usr/src/package",
"name": "ExtendedSwift",
"path": "/usr/src/package",
"version": "unspecified",
"identity": "package",
"dependencies": [
{
"url": "https://github.com/apple/swift-algorithms.git",
"name": "swift-algorithms",
"path": "/usr/src/package/.build/checkouts/swift-algorithms",
"version": "1.0.0",
"identity": "swift-algorithms",
"dependencies": [
{
"url": "https://github.com/apple/swift-numerics",
"name": "swift-numerics",
"path": "/usr/src/package/.build/checkouts/swift-numerics",
"version": "1.0.2",
"identity": "swift-numerics",
"dependencies": []
}
]
},
{
"url": "https://github.com/apple/swift-log.git",
"name": "swift-log",
"path": "/usr/src/package/.build/checkouts/swift-log",
"version": "1.5.2",
"identity": "swift-log",
"dependencies": []
}
]
}