SwiftWings Wiki

SwiftWings is a grab bag of pragmatic Foundation Swift extensions. This wiki expands on the README by showing how to install the library, mirror docs, and jump straight to the API notes you need.

How to Use the Library

Swift Package Manager (recommended)

1. In Xcode choose File > Add Package Dependencies....
2. Paste https://github.com/leacode/SwiftWings and pick the latest version (1.9.1+ for Linux + macOS 11 support).
3. Add SwiftWings to every target that needs the extensions.

Server-side: add a dependency entry to Package.swift.

dependencies: [
  .package(url: "https://github.com/leacode/SwiftWings.git", from: "1.9.1")
],
targets: [
  .target(
    name: "App",
    dependencies: [.product(name: "SwiftWings", package: "SwiftWings")]
  )
]

CocoaPods

use_frameworks!

target '<Your Target>' do
  pod 'SwiftWings'
end

Run pod install and open the generated workspace.

Carthage

brew install carthage
echo 'github "leacode/SwiftWings"' >> Cartfile
carthage update --use-xcframeworks

Drag the built SwiftWings.xcframework into your app target.

Working with the Wiki

• The docs that live under Docs/ in the main repo can be synced here with Scripts/mirror_docs_to_wiki.sh.
• Treat SwiftWings.wiki as a normal Git repo: edit locally, git add/commit, then git push.
• Keep screenshot assets or fixtures inside this repo so every page renders correctly.

API Reference Index

• Extensions Reference – Catalog of every namespace plus where to find its source/tests.
• Date Utilities – Start/end-of-component math, comparisons, date ranges, and distance helpers.
• Time-Zone Utilities – Wall-clock conversion, formatting, and DST helpers.

Per-Namespace Notes

• Array
• Bundle
• Codable
• Data & Mime Types
• Date
• Double
• Int
• Mirror
• NSNumber
• NSObject
• Optional
• Range
• Sequence
• String
• TimeZone

Need something that is not listed yet? Open an issue or PR so we can expand the docs together.