A tool for adding safety features to Swinject. Knit parses Swinject code and generates Swift files for type safety and unit testing.

Knit is designed to consume the Swinject syntax in your Assembly file. However there are some important aspects of a registration that are not represented in the Swinject syntax. @knit comment commands allow you to configure your registrations with that additional information.

This is accomplished by adding a comment directly above the registration starting with // @knit and then followed with the configuration command.

Commands can be applied at either the Assembly level or the registration level. Options set at the registration level will override any from the Assembly.

Knit can change the visibility of the generated type-safe accessors. The following commands are available:

• public: Make the type safe function(s) public (default is internal).
• internal: Make the type safe function(s) internal. This is a useful override when the assembly is set to public.
• hidden: Do not generate any type safe function.
• ignore: Completely ignore this assembly or registration

Make the generated type-safe accessor public:

// @knit public
container.register(MyType.self, factory: { /*...*/ })

One of the core capabilities of Knit is to generate type safe getters/accessors for your registrations. There are some additional options to control and configure this behavior.

This allows the call site to simply use resolver() and Swift will use type inference to match the appropriate registration.

In some situations it is helpful to have more control at the call site to specify the registration you would like to resolve. For example, this can happen in unit test situations where there might be an alternate "testing" or "fake" version of an existing protocol registration. Named Getters allow you to write resolver.myType() or resolver.myTypeFake() to specifically resolve the registration for MyType or MyTypeFake.

In both situations the method call is type-safe.

The following commands are available:

• getter-named: Generate a named accessor function. Knit will provide an automatic name based from the type.
• getter-named("myCustomName"): Generate a named accessor function with a custom name. Provide the custom name as an argument to the command.
• getter-callAsFunction: Generate callAsFunction accessor.
• Both commands can be included to specify that both accessors should be generated. // @knit getter-named getter-callAsFunction

By default Knit generates named getters for its type safety.

Located in the Docs/Modules.md file.

Located in the Docs/Release.md file.

Information about the copied dependencies is located in the Docs/Swinject.md file.