A micro-framework that leverages Swift Property Wrappers to implement the Service Locator pattern

Vincent Pradeilles

Last update: Jan 9, 2022

Related tags

Dependency Injection locatable

Overview

Locatable

Context

Locatable is a Swift micro framework that leverages Property Wrappers to implement the Service Locator pattern, through a custom attribute @Locatable.

Here's an example of how it can be used:

protocol Servicing {
    func action()
}

class Service: Servicing {
    func action() {
        print("I'm performing a service 😊")
    }
}

Locator.register(Servicing.self, { return Service() })

class MyController {
    @Locatable(.sharedInstance) var service: Servicing
    
    func work() {
        self.service.action()
    }
}

let controller = MyController()

controller.work() // I'm performing a service 😊

For convenience, some shorthand syntax are also available:

// leverages @autoclosure
Locator.register(Servicing.self, Service())

// leverages default argument values
Locator.register { return Service() as Servicing }

Service locating supports two distinct semantics:

// Will return an instance that is shared across the app
Locatable(.sharedInstance) var service: Servicing

// Will return a new instance every time
Locatable(.newInstance) var service: Servicing

Requirements

Xcode 11+ & Swift 5.1

Installation

CocoaPods

Add the following to your Podfile:

pod "Locatable"

Carthage

Add the following to your Cartfile:

github "vincent-pradeilles/locatable"

Author

Twitter: @v_pradeilles

An elegant, flexible, type-safe dependency resolution framework for Swift

Guise is an elegant, flexible, type-safe dependency resolution framework for Swift. Flexible dependency resolution, with optional caching Elegant, str

52 Oct 3, 2022

Container is a lightweight dependency injection framework for Swift.

Container Container is a lightweight dependency injection framework for Swift. Installation is available in the Swift Package Manager. Swift Package M

17 Oct 13, 2022

Framework-level dependency graph generator for Xcode projects - with support for custom graphing

XCGrapher xcgrapher is, by default, a framework-level dependency graph generator for Xcode projects. It works by reading local clones of the source, s

74 Dec 14, 2022

Alchemic - The most advanced iOS DI framework available

Alchemic By Derek Clarkson Alchemic is a Dependency Injection (DI) framework for iOS. It's goal is to help you manage object creation, object properti

15 Jun 14, 2022

DIContainer Swift is an ultra-light dependency injection container made to help developers to handle dependencies easily. It works with Swift 5.1 or above.

🏺 DIContainer Swift It is an ultra-light dependency injection container made to help developers to handle dependencies easily. We know that handle wi

10 Nov 23, 2022

Comments

Use auto closure and inferred type
On my phone so not ideal to make the PR myself but you should change to this:

static func register<T>(_ type: T.Type = T.self, _ factory: @autoclosure @escaping () -> T) {

This would allow the call site to either choose to use the autoclosure feature:

Resolver.register( Servicing.self, Service() )

Or to use the = T.self and inference and be able to write:

Resolver.register { Service() as Servicing }
opened by AliSoftware 1
Fixed a compilation error in 'Locatable'

Fixed a Swift 5 compilation error in 'Locatable' which was complaining of wrapper type 'Locatable' missing a non-static property named 'wrappedValue'. Renaming the Locatable.value property to Locatable.wrappedValue fixes it.

opened by adil-hussain-84 0