How do I add SwiftFoundation to a Swift Package Manager project?

You can include it as a dependency in your Package.swift file by specifying the GitHub repository. It's designed to be cross-platform, so you can target Linux, Darwin, or WebAssembly directly without additional setup.

SwiftFoundation vs Apple's Foundation for a Linux backend app?

SwiftFoundation offers a pure Swift, protocol-oriented design with better portability, but Apple's Foundation is more feature-complete and stable on Linux. Choose SwiftFoundation if you need modern Swift idioms and can work around missing features.

Does SwiftFoundation support JSON encoding and decoding?

No, JSON functionality is currently not implemented, as noted in the README. You would need to use alternative libraries like Swift's Codable with custom serializers or wait for future updates to SwiftFoundation.

Can I use SwiftFoundation with Vapor or other Swift web frameworks?

It might be possible, but since many frameworks depend on Apple's Foundation for core types, you could face integration challenges. You may need to adapt or find workarounds for compatibility.

What platforms does SwiftFoundation run on besides Linux and macOS?

It also supports watchOS, tvOS, and WebAssembly, making it suitable for embedded systems or web applications using Swift, as highlighted in the targeted platforms section.

Is SwiftFoundation thread-safe for concurrent data handling?

Yes, by using Swift structs and value types, it inherently improves concurrency safety by avoiding shared mutable state, which reduces bugs in multithreaded environments compared to Objective-C classes.

Open-Awesome

SwiftFoundation

MITSwift3.0.0

A cross-platform, protocol-oriented Swift library that reimplements Foundation with pure Swift for better portability and performance.

GitHub

626 stars46 forks0 contributors

What is SwiftFoundation?

SwiftFoundation is a cross-platform, protocol-oriented programming base library that complements the Swift Standard Library by reimplementing Apple's Foundation framework in pure Swift. It solves problems like Objective-C legacy, incomplete implementations in open-source Foundation, and limited portability, offering a modern alternative with better performance and safety.

Target Audience

Swift developers building applications for multiple platforms (Darwin, Linux, WebAssembly) who need a reliable, pure Swift foundation library without Objective-C dependencies.

Value Proposition

Developers choose SwiftFoundation for its protocol-oriented design, cross-platform compatibility, and pure Swift implementation, which provide performance improvements, concurrency safety, and freedom from legacy Cocoa frameworks.

Overview

Cross-Platform, Protocol-Oriented Programming base library to complement the Swift Standard Library. (Pure Swift, Supports Linux)

Use Cases

Best For

Building cross-platform Swift applications that run on Linux and WebAssembly
Replacing Apple's Foundation in pure Swift projects for better portability
Implementing protocol-oriented designs for core data types like Date and UUID
Developing Swift libraries that require a lightweight, dependency-free foundation layer
Ensuring thread-safe data handling with Swift structs and value types
Targeting ARM-based Linux systems with Swift

Not Ideal For

Applications requiring comprehensive Foundation features like FileManager or JSON serialization, which are not yet implemented.
Teams building iOS/macOS apps deeply integrated with Apple's ecosystem tools that depend on full Foundation APIs.
Projects needing immediate stability and full compatibility with existing Swift packages reliant on Apple's Foundation.
Developers who prioritize access to advanced, production-ready networking or file system APIs available in Apple's Foundation.

Pros & Cons

Pros

Cross-Platform Versatility

Supports Darwin, Linux (x86_64 and Armv7), and WebAssembly, offering broader portability than Apple's open-source Foundation, which is limited to Darwin and Linux.

Protocol-Oriented Safety

Reimplements core types like Date and UUID as Swift structs, eliminating Objective-C pointers and memory management issues, and improving multithreading safety as highlighted in the README.

Pure Swift Codebase

Written entirely in Swift without C dependencies, making it accessible and maintainable for Swift developers, addressing the goal of a long-term Swift base library.

Addresses Foundation Gaps

Implements basic functionalities like Base64 and Thread that are marked as unimplemented in Apple's swift-corelibs-foundation, providing a more complete open-source alternative.

Cons

Incomplete Feature Set

The README explicitly lists FileManager and JSON as not implemented, limiting its use for applications that rely on these common Foundation components.

Developmental Instability

Positioned as a long-term replacement, the project may undergo breaking changes and lacks the maturity and stability of Apple's established Foundation framework.

Ecosystem Integration Hurdles

Many Swift libraries and tools assume Apple's Foundation, so using SwiftFoundation could lead to compatibility issues or require significant adaptation work.

Frequently Asked Questions

Related Projects

SwifterSwift

A handy collection of more than 500 native Swift extensions to boost your productivity.

Stars15,194

Forks1,660

Last commit1 month ago

BlocksKit

The Objective-C block utilities you always wish you had.

Stars6,825

Forks1,244

Last commit8 years ago

libextobjc

A Cocoa library to extend the Objective-C programming language.

Stars4,496

Forks460

Last commit7 years ago

Then

✨ Super sweet syntactic sugar for Swift initializers

Stars4,393

Forks300

Last commit6 months ago

Community-curated · Updated weekly · 100% open source

Found a gem we're missing?

Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.

Submit a project Star on GitHub