Injektion

Introduction

A simple way to handle dependency injection using property wrappers. It is available as a Swift Package or as a CocoaPod. The concept is heavily based on the work of Antoine van der Lee:

https://www.avanderlee.com/swift/dependency-injection/

Install

Swift Package

Injektion can be added to an Xcode project as a swift package. Using the regular Xcode tool, search for the following URL:

https://github.com/andrewmcgee/Injektion

Cocoapods

Injektion can be added to a project as a pod by adding the folloing to your Podfile under the correct target:

pod 'Injektion', '~> 1.0.0'

and then running the following command in yout terminal:

pod install

Usage

To set up a dependency, define a new (optionally private) key struct that conforms to the DependencyKey protocol. Its current value should be the dependency, which can be abstracted behind a protocol.

private struct SomeDependencyKey: DependencyKey {
    static var currentValue: DependencyType = Dependency()
}

Then extend the Dependencies type to include a new key provider computed property. Its type should be the same as the DependencyKey‘s currentValue. Using its getter and setter it should act as a proxy for the static subscript of Dependencies that takes the implementation of DependencyKey‘s type defined above as an input.

extension Dependencies {
    
    var dependencyKeyProvider: DependencyType {
        get { Self[SomeDependencyKey.self] }
        set { Self[SomeDependencyKey.self] = newValue }
    }
}

With these parts in place, you can now refer to the dependency throughout you code in the following way:

class SomeClass {
    
    @Dependency(\.dependencyKeyProvider) private var dependency: DependencyType
    
}

You can update a dependency in two ways. Either like this:

class SomeClass {
    
    @Dependency(\.dependencyKeyProvider) private var dependency: DependencyType
    
    func updateDependency() {
        self.dependency = NewDependency()
    }
}

or directly like this:

Dependencies[SomeDependencyKey.self] = NewDependency()

Please note that if you update a dependency, then it will be updated in all the places where it is used.

GitHub

View Github