feat: Factories, Container, Thread Safety, Resolvers, & Registration

Author: mcgaryp

Package.swift

@@ -5,6 +5,9 @@ import PackageDescription
 
 let package = Package(
     name: "Astroject",
+    platforms: [
+        .iOS(.v13)
+    ],
     products: [
         // Products define the executables and libraries a package produces, making them visible to other packages.
         .library(

README.md

@@ -0,0 +1,11 @@
+# Astroject
+Library for Dependency Injection with Swift concurrency in mind.
+
+## Overview
+Astroject is an advanced dependency injection library designed to help make dependency trees manageable and sufficient from the smallest to the largest scaled software project.
+
+## Features
+- **Thread Safety**
+- **Swift Concurrency**
+- **Ease of Use & Adaptation**
+

Sources/Astroject/.swift

@@ -0,0 +1,8 @@
+//
+//  File.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation

Sources/Astroject/Astroject.swift

@@ -0,0 +1,52 @@
+//
+//  Container.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+// ✅ Registration
+// ✅ Resolution
+// TODO: InstanceStore
+
+public class Container {
+    var factories: ThreadSafeDictionary<FactoryKey, any FactoryRegistrable> = .init()
+    
+    public init() {}
+    
+    public func registerAsync<Product>(_ productType: Product.Type, name: String? = nil, factory block: @escaping (Resolver) async -> Product) {
+        let factoryKey = FactoryKey(productType: productType, name: name)
+        let factory = Factory.async(block)
+        let registration = FactoryRegistration(factory: factory)
+        factories.insert(registration, for: factoryKey)
+    }
+    
+    public func register<Product>(_ productType: Product.Type, name: String? = nil, factory block: @escaping (Resolver) -> Product) {
+        let factoryKey = FactoryKey(productType: productType, name: name)
+        let factory = Factory.sync(block)
+        let registration = FactoryRegistration(factory: factory)
+        factories.insert(registration, for: factoryKey)
+    }
+}
+
+extension Container: Resolver {
+    public func resolve<Product>(_ productType: Product.Type, name: String?) -> Product? {
+        let registration = registration(for: productType, with: name)
+        let product = registration?.factory.make(self)
+        return product
+    }
+    
+    public func resolveAsync<Product>(_ productType: Product.Type, name: String?) async -> Product? {
+        let registration = registration(for: productType, with: name)
+        let product = await registration?.factory.makeAsync(self)
+        return product
+    }
+    
+    func registration<Product>(for productType: Product.Type, with name: String?) -> FactoryRegistration<Product>? {
+        let factoryKey = FactoryKey(productType: productType, name: name)
+        let registration = factories.getValue(for: factoryKey) as? FactoryRegistration<Product>
+        return registration
+    }
+}

Sources/Astroject/Container.swift

@@ -0,0 +1,44 @@
+//
+//  Factory.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+enum Factory<Product> {
+    case sync((Resolver) -> Product)
+    case async((Resolver) async -> Product)
+    
+    var isSync: Bool {
+        switch self {
+        case .sync:
+            return true
+        case .async:
+            return false
+        }
+    }
+    
+    var isAsync: Bool {
+        return !isSync
+    }
+    
+    func make(_ resolver: Resolver) -> Product {
+        switch self {
+        case .sync(let closure):
+            closure(resolver)
+        case .async:
+            fatalError("Factory Method is Async. Try calling the async version of this method.")
+        }
+    }
+    
+    func makeAsync(_ resolver: Resolver) async -> Product {
+        switch self {
+        case .sync(let closure):
+            closure(resolver)
+        case .async(let closure):
+            await closure(resolver)
+        }
+    }
+}

Sources/Astroject/Factory.swift

@@ -0,0 +1,31 @@
+//
+//  FactoryKey.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+struct FactoryKey {
+    let productType: Any.Type
+    let name: String?
+    
+    init(productType: Any.Type, name: String? = nil) {
+        self.productType = productType
+        self.name = name
+    }
+}
+
+extension FactoryKey: Hashable {
+    func hash(into hasher: inout Hasher) {
+        ObjectIdentifier(self.productType).hash(into: &hasher)
+        self.name?.hash(into: &hasher)
+    }
+}
+
+extension FactoryKey: Equatable {
+    static func == (lhs: FactoryKey, rhs: FactoryKey) -> Bool {
+        lhs.productType == rhs.productType && lhs.name == rhs.name
+    }
+}

Sources/Astroject/FactoryKey.swift

@@ -0,0 +1,14 @@
+//
+//  FactoryRegistrable.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+protocol FactoryRegistrable {
+    associatedtype Product
+    
+    var factory: Factory<Product> { get }
+}

Sources/Astroject/FactoryRegistrable.swift

@@ -0,0 +1,16 @@
+//
+//  FactoryRegistration.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+struct FactoryRegistration<Product>: FactoryRegistrable {
+    let factory: Factory<Product>
+    
+    init(factory: Factory<Product>) {
+        self.factory = factory
+    }
+}

Sources/Astroject/FactoryRegistration.swift

@@ -0,0 +1,26 @@
+//
+//  Resolver.swift
+//  Astroject
+//
+//  Created by Porter McGary on 2/25/25.
+//
+
+import Foundation
+
+public protocol Resolver {
+    func resolve<Product>(_ productType: Product.Type) -> Product?
+    func resolve<Product>(_ productType: Product.Type, name: String?) -> Product?
+    
+    func resolveAsync<Product>(_ productType: Product.Type) async -> Product?
+    func resolveAsync<Product>(_ productType: Product.Type, name: String?) async -> Product?
+}
+
+public extension Resolver {
+    func resolve<Product>(_ productType: Product.Type) -> Product? {
+        resolve(productType, name: nil)
+    }
+    
+    func resolveAsync<Product>(_ productType: Product.Type) async -> Product? {
+        await resolveAsync(productType, name: nil)
+    }
+}