swift-foundation-extensions

Contents

Coding

init(from decoder: Decoder) throws {
 self = try container.decode(RawCodingKey.self) { container in
 return .init(
 someProperty1: container.decode("someProperty1"),
 someProperty2: container.decode("some_property_2")
 )
 }
}
func encode(to encoder: encoder) throws {
 try encoder.encode(RawCodingKey.self) { container in
 try container.encode(someProperty1, forKey: "someProperty1")
 try container.encode(someProperty2, forKey: "some_property_2")
 }
}

NSLocking

Optional

Undo/Redo management

struct State {
 var value: Int = 0
}
@Resettable
let state = State()
state.value = 1 // value == 1
state.value *= 10 // value == 10
state.undo() // value == 1
state.value += 1 // value == 2
state.undo() // value == 1
state.redo() // value == 2

Indirect

struct ListNode<Value> {
 var value: Value
 
	@Indirect
 var next: ListNode<Value>?
}

PropertyProxy

class MyView: UIView {
 private let label: UILabel
 
 @PropertyProxy(\MyView.label.text)
 var text: String?
}
let view: MyView = .init()
view.label.text // ❌
view.text = "Hello, World!"

Object Association

extension UIViewController {
 var someStoredProperty: Int {
 get { getAssociatedObject(forKey: #function).or(0) }
 set { setAssociatedObject(newValue, forKey: #function) }
 }
}
let value: Bool = getAssociatedObject(forKey: "value", from: object)

import FoundationExtensionsMacros
extension SomeClass {
 @AssociatedObject
 var storedVariableInExtension: Int = 0
 
 @AssociatedObject(readonly: true)
 var storedVariableInExtension: SomeObject = .init()
 
 @AssociatedObject
 var optionalValue: Int?
 
 @AssociatedObject
 var object: Int?
 
 @AssociatedObject(threadSafety: .atomic)
 var threadSafeValue: Int?
 
 @AssociatedObject(threadSafety: .atomic)
 var threadSafeObject: Object?
 
 @AssociatedObject(policy: .assign)
 var customPolicyValue: Int?
 
 @AssociatedObject(policy: .retain(.atomic))
 var customPolicyThreadSafeObject: Object?
}

Swizzling

extension UIViewController {
 // Runs once in app lifetime
 // Repeated calls do nothing
 private static let swizzle: Void = {
 // This example is not really representative since these methods
 // can be simply globally overriden, but it's just an example
 // for the readme and you can find live example at
 // https://github.com/capturecontext/combine-cocoa-navigation
 
 objc_exchangeImplementations(
 	#selector(viewWillAppear)
 #selector(__swizzledViewWillAppear)
 )
 
 objc_exchangeImplementations(
 	#selector(viewDidAppear)
 #selector(__swizzledViewDidAppear)
 )
 }()
 @objc dynamic
 private func __swizzledViewWillAppear(_ animated: Bool) {
 __swizzledViewWillAppear(animated) // calls original method
 print(type(of: self), ObjectIdentifier(self), "will appear")
 }
 @objc dynamic
 private func __swizzledViewDidAppear(_ animated: Bool) {
 __swizzledViewDidAppear(animated) // calls original method
 print(type(of: self), ObjectIdentifier(self), "did appear")
 }
}

Installation

Basic

Recommended

.package(
 url: "https://github.com/capturecontext/swift-foundation-extensions.git", 
 .upToNextMinor(from: "0.5.0")
)

.product(
 name: "FoundationExtensions", 
 package: "swift-foundation-extensions"
)

.product(
 name: "FoundationExtensionsMacros", 
 package: "swift-foundation-extensions"
)

License