Sourcery

项目简介：Sourcery

什么是Sourcery？

Sourcery是一个专为Swift语言开发的代码生成工具，赋予程序员自动生成样板代码的能力。它基于Apple的SwiftSyntax构建，利用语言抽象的扩展，帮助开发者摆脱重复代码，从而专注于项目的核心功能。

应用范围

Sourcery已被应用于超过40,000个iOS和macOS项目中，被众多广受好评的应用使用，包括Airbnb、Bumble以及纽约时报等。这种广泛的社区采用催生了苹果公司对自动生成等价性（Equality）以及自动Codable符合性的实现。

功能特性

Sourcery的核心功能在于自动消除重复代码，为开发者提供更优的架构和工作流程。以下是一项具体应用的例子：

• 在没有Sourcery时，开发者需要为每个协议手动编写大量的Mock代码。
• 使用Sourcery后，开发者只需简单地声明协议即可自动生成所需代码。

extension MyProtocol: AutoMockable {}

Sourcery不仅能减少Mock代码的编写量，还确保了每个Mock的一致性，并能在重构或添加属性时自动更新代码，避免人为错误。

常见使用场景

• 自动生成等价性（Equality）和哈希（Hashing）代码
• 枚举案例和计数
• 透镜（Lenses）
• Mocks和Stubs
• LinuxMain适配
• 装饰器（Decorators）
• 高级Codable和持久化实现
• 属性级别的差异检测

此外，Sourcery还可以用于生成应用中的UI设置等。

如何开始使用

Sourcery提供了多种安装和使用的选项，包括二进制形式、Homebrew、CocoaPods、Mint，以及从源码构建等。用户可以选择适合自己项目的安装方式。对初学者，可以参阅多种在线教程，诸如“自动化Swift样板代码生成”一文，帮助理解如何通过Sourcery优化开发流程。

文档与支持

Sourcery提供详细的文档说明和一系列使用指南，开发者可以在相关页面获取详细的使用指导。它对Linux平台也有良好的支持，页面中详细介绍了如何在Linux上使用Sourcery。

贡献与支持

Sourcery由活跃的社区维护和贡献，任何开发者都可以加入到贡献行列。其代码贡献准则已使用许多开源社区所认同的Contributor Covenant，为社区的参与者提供清晰的期望说明。

如果希望支持Sourcery的发展，可以通过GitHub赞助或Open Collective进行支持。

完成许可与其他工具

Sourcery在MIT许可下开放使用。此外，开发者还可以使用SwiftGen工具，来处理资源数据的代码生成，SwiftGen和Sourcery是相辅相成的工具。

无论你是一名开发新手还是经验丰富的程序员，使用Sourcery都能极大地提高你的开发效率和代码质量。尝试将Sourcery添加到你的下一个项目中，你会发现它为你节省了大量时间，并让代码更加整洁和一致。