krzysztofzablocki/Sourcery
Sourcery
Sourcery is a code generation tool for Swift that automates the production of repetitive boilerplate and protocol conformance. It functions as a template engine that scans source files to generate structural code, such as Codable, Equatable, and Hashable implementations, based on marker protocols and static analysis.
The project provides a specialized mocking framework that creates mock objects for protocols to track function calls and capture arguments during testing. It also includes utilities for generating struct lenses, enum case collections, and precise property-level test diffs.
The system supports a real-time workflow using a background daemon for file monitoring and automatic code regeneration. Integration is managed through YAML-driven configuration files and build system plugins to ensure generated code remains consistent during refactoring.
Features
- Swift Code Generators - Provides a comprehensive tool for automating the creation of boilerplate and protocol conformance code for Swift projects.
- Template-Based Code Generators - Functions as a template engine that automates the creation of repetitive structural Swift code.
- Boilerplate Generators - Automates the production of repetitive structural code to eliminate manual errors.
- Marker Protocol Detection - Implements code generation triggers by scanning for specialized marker protocols on Swift types.
- Hashable Object Generators - Automates the creation of hashing logic for types to remove manual boilerplate.
- Codable Implementation Generation - Automatically generates Codable conformance by analyzing associated values and marker protocols.
- Equatable Conformance Generation - Eliminates manual boilerplate by automatically creating equality comparison logic.
- Protocol Conformance Automation - Automatically creates implementations for standard Swift protocols to eliminate tedious manual work.
- Mocking Frameworks - Implements a framework that generates mock objects for protocols to track function calls and capture arguments.
- Protocol-to-Mock Generators - Creates mock classes for protocols to track function calls and capture arguments during testing.
- Static Analysis AST Parsing - Parses source code into structural metadata to populate code generation templates.
- Build System Integrations - Runs custom code generation scripts as plugins during the compilation process.
- Build Plugin Integrations - Integrates the generation process into the build system via plugins to ensure output is up to date.
- Automatic Code Regeneration - Automatically regenerates dependent code in real-time to maintain consistency during refactoring.
- Real-time Generation Previews - Provides immediate feedback by updating generated code in real-time as templates are modified.
- Swift Refactoring Tools - Maintains project consistency by automatically regenerating dependent code when source properties change.
- Directory Monitoring Daemons - Provides a background daemon that monitors source files to trigger immediate code regeneration.
- Real-time Regeneration Engines - Regenerates Swift source code in real-time by monitoring changes to templates and source files via a background daemon.
- YAML Configuration Files - Uses YAML configuration files to define source paths and template arguments for the generation process.
- Generation Configuration Schemas - Uses YAML files to define source paths and template mappings for automated code production.
- Development Tools - Automates boilerplate code generation via meta-programming.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
