Question 1

How do I integrate Sourcery into my Xcode project?

Accepted Answer

Sourcery can be added via CocoaPods, Homebrew, or Swift Package Manager. For Xcode, set up a custom build phase to run the sourcery command with a .sourcery.yml configuration file, as detailed in the usage section.

Question 2

Sourcery vs SwiftGen: which should I use for asset code generation?

Accepted Answer

Sourcery is best for general Swift boilerplate like mocks and Equatable, while SwiftGen is specialized for assets like .xib and .storyboards. The README notes they are complementary tools, so use both if needed for different tasks.

Question 3

Can Sourcery generate code for SwiftUI views?

Accepted Answer

Yes, through custom Stencil templates, Sourcery can automate SwiftUI code generation, such as creating view modifiers or binding setups, but it requires writing templates tailored to your specific use cases.

Question 4

How to create a custom template for Sourcery?

Accepted Answer

Start by learning Stencil syntax from the documentation, then define templates based on Swift types in your project. Examples are provided for common uses, and you can extend them for advanced automation like property diffing.

Question 5

Does Sourcery work with Swift Package Manager on Linux?

Accepted Answer

Yes, Sourcery supports Linux and can be used as a Swift package command plugin, but note that JS templates are not supported when building with SPM, as mentioned in the installation section.

Question 6

What are the limitations of AutoMockable in Sourcery?

Accepted Answer

AutoMockable generates basic mocks for protocols, but complex protocols with associated types, generic constraints, or advanced behaviors might require manual adjustments or custom templates to handle properly.

Question 7

Is Sourcery Pro necessary for advanced features?

Accepted Answer

Sourcery Pro offers a Stencil editor and Xcode integration for live AST templates, but the core tool is open-source and free. Pro is useful for teams needing enhanced editor support, but not required for basic code generation.

Sourcery

What is Sourcery?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions