Code Generation Classroom

Learn to use SwiftGen & Sourcery to avoid having to type repetitive, boring code and improve your productivity and your code's type safety & maintenance!

Requirements

• This classroom expects that you already know how to write Swift 3+ code and have written a few (ideally iOS) applications.
• We'll use Xcode 8.x, but Xcode 9.x should work too

During the classroom, we'll learn how to install SwiftGen and Sourcery, but you are encouraged to download the following ZIP files in advance to have them around in your Download folders and avoid any download latency during the classroom:

• SwiftGen 5.1.1 (downloadable here)
• Sourcery 0.8.0 (downloadable here)

Resources

During the classroom, we'll use the following websites

• SwiftGen & Sourcery GitHub repositories for their README & documentation
• Sourcery dedicated documentation's website
• Stencil documentation

Walkthrough & Step-Commits

The classroom will consist of multiple steps that we'll go through together

• All the individual steps that we're gonna follow are listed in this repo's wiki.
• Each step is represented by an individual commit in the steps branch of this repository.

💡 Be sure to keep that wiki open to follow along.

💡 In case you get lost or left behind, don't hesitate to look at the markers in the wiki walkthrough and jump directly to the corresponding commit to catch up with the rest of the class!

---

Topics Overview

Discover the project

• Clone this repository
• The teacher will make a quick tour of the code and app features

SwiftGen

• Download, install & discover SwiftGen
• Convert the existing code to use it
• [Bonus] learn how to customize a template

Sourcery

• Download, install & discover Sourcery
• Try our first template to understand basic principles, discover the daemon mode
• Discover & use the AutoCases template bundled with Sourcery
• Try a third-party AutoJSONDeserialization template
• Use AutoEquatable & AutoHashable templates
• Create our own template for custom swift code

Bonus : Gyro

We won't probably have time to make a tour of Gyro, but if you're using Realm in your project, you'll likely be very interested in it.

It's again another Code-Generation tool, but this time to generate code (typically your Realm.Object classes) from .xcdatamodel, so that you can use Xcode's visual datamodel editor to edit your Realm model with a nice UI.

• Install gyro using gem install gyro
• Visit Gyro's repository and read the README
• Open one xcdatamodel from the repo (or create your own)
• Run gyro on that xcdatamodel with one of the template (Swift, ObjC, Android) provided and look at the generated code