Swinject extension to automatically register your services
Alternatives To Swinjectautoregistration
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
Awilix3,00029430625 days ago77April 04, 2023mitTypeScript
Extremely powerful Inversion of Control (IoC) container for Node.JS
Dryioc9091221294 days ago434April 22, 202240mitC#
DryIoc is fast, small, full-featured IoC Container for .NET
10 months ago11mitC#
C# Source Generator based dependency injection container implementation.
Stronginject6621a year ago296May 24, 202217mitC#
compile time dependency injection for .NET
83a month ago15September 05, 202126mitSwift
Swinject extension for automatic dependency injection via Storyboard
185 months ago9October 03, 20213mitSwift
Swinject extension to automatically register your services
Autofac.annotation2001220 days ago6January 28, 2020mitC#
DI容器,依赖注入,AOP,动态代理等用注解来load autofac 摆脱代码或者xml配置和java的spring的注解注入一样的体验
Stashbox127182118 days ago345March 29, 20232mitC#
A lightweight, fast, and portable dependency injection framework for .NET-based solutions.
Autofac.extras.quartz11625186 months ago181March 27, 20234mitC#
Autofac integration for Quartz.Net
Kickstart4111a month ago72August 20, 20228mitC#
Application initialization helper
Alternatives To Swinjectautoregistration
Select To Compare

Alternative Project Comparisons


Build Status Carthage compatible CocoaPods Version License Platform Swift Version

SwinjectAutoregistration is an extension of Swinject that allows to automatically register your services and greatly reduce the amount of boilerplate code.


  • iOS 9.0+ / Mac OS X 10.10+ / tvOS 9.0+
  • Xcode 8+


Swinject is available through Carthage, CocoaPods or Swift Package Manager.


To install Swinject with Carthage, add the following line to your Cartfile.

github "Swinject/Swinject" "2.8.3"
github "Swinject/SwinjectAutoregistration" "2.8.3"

Then run carthage update --use-xcframeworks --no-use-binaries command or just carthage update --use-xcframeworks. For details of the installation and usage of Carthage, visit its project page.


To install Swinject with CocoaPods, add the following lines to your Podfile.

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '9.0' # or platform :osx, '10.10' if your target is OS X.

pod 'Swinject', '2.8.3'
pod 'SwinjectAutoregistration', '2.8.3'

Then run pod install command. For details of the installation and usage of CocoaPods, visit its official website.

Swift Package Manager

in Package.swift add the following:

dependencies: [
    .package(url: "https://github.com/Swinject/SwinjectAutoregistration.git", from: "2.8.3")
targets: [
        name: "MyProject",
        dependencies: [..., "SwinjectAutoregistration"]


Here is a simple example to auto-register a pet owner

let container = Container()
container.register(Animal.self) { _ in Cat(name: "Mimi") } // Regular register method
container.autoregister(Person.self, initializer: PetOwner.init) // Autoregistration

where PetOwner looks like this:

class PetOwner: Person {
    let pet: Animal

    init(pet: Animal) {
        self.pet = pet

The autoregister function is given the PetOwner initializer init(pet:Animal). From its signature Swinject knows that it needs a dependency Animal and resolves it from the container. Nothing else is needed.

Autoregistration becomes especially useful when used to register services with many dependencies. Compare autoregistration code:

container.autoregister(MyService.self, initializer: MyService.init)

with equivalent code in pure Swinject:

container.register(MyService.self) { r in
    MyService(dependencyA: r.resolve(DependencyA.self)!, dependencyB: r.resolve(DependencyB.self)!, dependencyC: r.resolve(DependencyC.self)!, dependencyD: r.resolve(DependencyD.self)!)

Another advantage is that if you add more dependencies during the development the registration code doesn't have to be rewritten.

Registration with name

Service can be also given name - same as with the regular register method.

container.autoregister(Person.self, name: "johnny", initializer: PetOwner.init)


You can also use auto-registration for services with dynamic arguments. Pet owner whose name needs to be passed as argument is defined like this:

class PetOwner: Person {
    let name: String
    let pet: Animal

    init(name: String, pet: Animal) {
        self.name = name
        self.pet = pet

And registered like this

container.autoregister(Person.self, argument: String.self, initializer: PetOwner.init)

Swinject will register Person with the argument of type String. When container.resolve(Person.self, argument: "Michael") is called Swinject won't try to resolve String as dependency but instead pass "Michael" as the name.

To also pass pet as argument you can call

container.autoregister(Person.self, arguments: String.self, Animal.self, initializer: PetOwner.init)
container.autoregister(Person.self, arguments: Animal.self, String.self, initializer: PetOwner.init)

The order of the arguments listed is interchangeable. The auto-registration can't be used with more arguments and/or dependencies of the same type.

What kind of sorcery is this?

Wondering how does that work? Generics are heavily leveraged for the auto-registration. For registering service with two dependencies something similar to a following function is used:

public func autoregister<Service, A, B>(_ service: Service.Type, initializer: (A, B) -> Service) -> ServiceEntry<Service> {
   return self.register(service.self, factory: { r in
       return initializer(r.resolve(A.self)!, r.resolve(B.self)!)
   } as (ResolverType) -> Service)

The initializer is a function like any other. By passing it as a parameter its dependencies can be inferred as (A, B) and automatically resolved. These functions are generated for up to 20 dependencies. Checkout the code for more info.


This extension also aims to reduce the amount of boilerplate while improving readability of the registration code. For that reason the operator ~> is introduced.

Petowner(pet: r~>)

// equivalent to

Petowner(pet: r.resolve(Animal.self)!)

The dependency is again inferred from the type in the initializer. To specify a concrete class you can use:

Petowner(pet: r ~> Cat.self)

To use a named service:

Petowner(pet: r ~> (Cat.self, name: "mimi"))

or to pass argument/s:

Petowner(pet: r ~> (Cat.self, argument: "Mimi"))
Petowner(pet: r ~> (Cat.self, arguments: ("Mimi", UIColor.black)))


When a service has multiple initializers, swift compiler can't be sure which should be used and you will get a ambigious use of init(x: y: z:). This can also happen if the service is extending another class that have initializer with the same number of arguments.

The solution is to specify the initializer like this:

container.autoregister(Person.self, initializer: PetOwner.init(name:pet:))

Auto-registration can't be used with named dependencies in their initializers. There is no way to get a name of dependency from the initializer. For example, following code can't be auto-registered:

container.register(Animal.self, name: "mimi") { _ in Cat(name: "Mimi") }
container.register(Animal.self, name: "charles") { _ in Cat(name: "Charles") }
container.register(Person.self) {
    PetOwner(pet: r.resolve(Animal.self, name: "mimi")

Swift 5.3

Since Swift 5.3 the compiler behaves differently when infering initializers in structs that have variables with a default value:

struct Cat {
    let height: Int = 50

Compiler will generate two init functions:

Cat.init and Cat.init(height:)

Since the Swift 5.3 the following registration

container.autoregister(Animal.self, initializer: Cat.init)

will try to use the Cat.init(height:) which will then fail with Unresolved service: Int Initializer: (Int) -> Animal

Solution is to make the compiler use the init without a parameter

container.autoregister(Animal.self, initializer: Cat.init as () -> Cat)

For Maintainers

Making a new release version

Our release procedure is described as Makefile. Run make help coomand for more info.


SwinjectAutoregistration generics is inspired by:


MIT license. See the LICENSE file for details.

Popular Dependency Injection Projects
Popular Registration Projects
Popular Software Architecture Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Dependency Injection