Nothing Special   »   [go: up one dir, main page]

Skip to content

v1.0.0

Compare
Choose a tag to compare
@trupin trupin released this 15 Dec 04:13
· 140 commits to master since this release

First stable version of Weaver 🎉

Foundations rework

  • Dependency Graph: The dependency graph representation has been entirely reworked in order to allow for more flexibility at use. Basically, it is now linked using hash keys rather than direct object references.
  • Linker/Inspector: Since the dependency graph changed, the linker & Inspector naturally changed as well. Accessing to data through the graph can now throw, giving a more precise error handling. The visitor algorithm for resolving and building remains fairly the same, but now supports new features, which I will describe a bit below.
  • Generator: The generator has been entirely rewritten using Meta. It also supports new features which I will describe below.

Optimizations

  • Lexer: A cache (LexerCache) has been added in order to avoid SourceKitten to parse the source files every time (~1s for ~30 files). This cache stores one token list per file. A token list is invalidated once its file has changed after it was stored. The format for storing is an optimized JSON where every key is only one or two characters.
  • Generator: The generated Swift code is now relying a lot more on runtime, which brings more flexibility for supporting new features, but also allows Weaver to generate one single dependency container per project instead of one per injectable type
  • Misc optimizations as a result of profiling the binary (~0.5s instead of ~2s for ~30 files when cache is complete).

New Features

  • Property wrapper support. With Swift 5.1, Weaver is now able to detect property wrappers named @Weaver(...) as annotations.
  • Dependencies can now be resolved by name and/or by type.
  • Abstract types can be composite (eg. A & B) and still be resolved correctly as soon as a registration is declared up the tree with a super set abstract type (eg. A & B & C).
  • Some new (more specific) errors are now thrown. Eg. type mismatch, ambiguous type, ambiguous dependency name, etc...
  • Added generation of a stub implementation of the main dependency resolver to facilitate testing. The code is generated in a separated file WeaverTests.swift.
  • Added scope lazy which activates a lazy loading mechanism for a given dependency.
  • Added configuration attribute setter which makes Weaver generate a setter for a given dependency.
  • An injectable type can now reference itself. The stored reference is weak, avoiding retain cycles. The optionality of that reference is abstracted away by Weaver though.

Breaking changes

  • Only one unique file per target (app/tests) can be generated while Weaver used to offer an option to generate multiple files.
  • Naturally, the xcfilelist command has been removed since its necessity was very limited by the fact that only one file is generated now.
  • Detailed resolvers are always on, which means the option doesn't exist anymore.
  • Custom stencil templates aren't supported anymore, since Stencil has been replaced by Meta.
  • The argument --output-path has been renamed to --main-output-path in order to go along with the --test-output-path.