访问官网
Github
文档
论文项目简介：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添加到你的下一个项目中，你会发现它为你节省了大量时间，并让代码更加整洁和一致。
