Small, self-contained Swift extensions for the standard library, Foundation, UIKit, AppKit and other Apple frameworks.

Each extension lives in its own file and depends only on the standard library and Apple's frameworks, never on another part of SwifterSwift. Use the whole library, pick the areas you need, or copy a single file into your project.

• Self-contained. One extension per file, with no shared helpers, so any file can be copied on its own.
• Tested. Every extension has its own Swift Testing suite, including edge cases such as empty input, Unicode, other locales and time zones.
• Documented. Every extension has a documentation comment with an example, and the full reference is built with DocC.
• Modular. One product per area, plus a SwifterSwift product that includes them all.
• Cross-platform. Apple platforms, plus Linux, Android, WebAssembly and Windows for the areas available there.

The standard library and Foundation areas also build on Linux, Android, WebAssembly and Windows.

SwifterSwift is distributed with Swift Package Manager.

Add the package to your dependencies:

dependencies: [
    .package(url: "https://github.com/SwifterSwift/SwifterSwift.git", from: "9.0.0")
]

Then add the products you need to your target:

.target(
    name: "MyApp",
    dependencies: [
        .product(name: "SwifterSwift", package: "SwifterSwift")
    ]
)

Choose File › Add Package Dependencies…, enter https://github.com/SwifterSwift/SwifterSwift.git, and select the products to add to your target.

import SwifterSwift

let numbers = [10, 20, 30]
numbers[safe: 3]  // nil

let url = URL(string: "https://example.com/search?q=swift")!
url.queryValue(for: "q")  // "swift"

let frame = CGRect(x: 0, y: 0, width: 100, height: 50)
frame.center  // (50.0, 25.0)

Every product builds on every platform. Where a framework isn't available, its product is empty.

SwifterSwiftFoundation includes a privacy manifest that declares its use of UserDefaults. If you copy a UserDefaults extension into your project instead, declare the API in your app's own privacy manifest.

Every extension is in Sources/<Product>/<Type>/<Type>+<Name>.swift. For example, Collection[safe:] is in Sources/SwifterSwiftStdlib/Collection/Collection+SubscriptSafe.swift. Copy the file into your project and it compiles as is.

The API reference for every product is on the Swift Package Index.

Contributions are welcome. Read CONTRIBUTING.md for the rules every extension follows and how to test your changes. This project follows the Contributor Covenant code of conduct.

SwifterSwift is available under the MIT license. See LICENSE for details.