Skip to content

ijoshsmith/equatable-code-generator

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Equatable code generator

Suppose you have a struct in your Swift app like this:

struct Person {
    let firstName: String
    let lastName: String
    let birthday: Date
    let inchesTall: Int
}

In order to allow Person instances to be compared for equality, using the == operator, the struct must adopt Swift's Equatable protocol.

// This doesn't work unless Person adopts the Equatable protocol.
let areSamePerson = (person1 == person2)

Writing code to check if two things are the same is boring, so make your computer do it!

// This prints Equatable protocol code for the Person struct.
adoptEquatable(person)

The adoptEquatable function prints this to the console in Xcode…

extension Person: Equatable {
    public static func ==(lhs: Person, rhs: Person) -> Bool {
        guard lhs.firstName == rhs.firstName else { return false }
        guard lhs.lastName == rhs.lastName else { return false }
        guard lhs.birthday == rhs.birthday else { return false }
        guard lhs.inchesTall == rhs.inchesTall else { return false }
        return true
    }
}

Simply copy that code, paste it into your project, and you're done. 🙌

Use it while debugging

Once you've added adoptEquatable to your project you can also call it while debugging, via the po command.

alt tag

That's handy!

Show me the code

Feel free to copy this function into your project and start using it.

import Foundation

// Generates code for a class or struct instance to conform to the Equatable protocol.
public func adoptEquatable(_ subject: Any) {
    let mirror = Mirror(reflecting: subject)
    
    let typeName: String = {
        let fullTypeName = String(reflecting: mirror.subjectType)
        let typeNameParts = fullTypeName.components(separatedBy: ".")
        let hasModulePrefix = typeNameParts.count > 1
        return hasModulePrefix
            ? typeNameParts.dropFirst().joined(separator: ".")
            : fullTypeName
    }()
    
    let propertyNames = mirror.children.map { $0.label ?? "" }
    
    // Associate an indentation level with each snippet of code.
    typealias TemplateGroup = [(Int, String)]
    let templateGroups: [TemplateGroup] = [
        [(0, "extension \(typeName): Equatable {")],
        [(1, "public static func ==(lhs: \(typeName), rhs: \(typeName)) -> Bool {")],
        propertyNames.map { (2, "guard lhs.\($0) == rhs.\($0) else { return false }") },
        [(2, "return true")],
        [(1, "}")],
        [(0, "}")]
    ]
    
    // Apply indentation to each line of code while flattening the list.
    let indent = "    "
    let linesOfCode = templateGroups.flatMap { templateGroup -> [String] in
        return templateGroup.map { (indentLevel: Int, code: String) -> String in
            let indentation = String(repeating: indent, count: indentLevel)
            return "\(indentation)\(code)"
        }
    }
    
    let sourceCode = linesOfCode.joined(separator: "\n")
    print(sourceCode)
}

This repository also includes an Xcode playground if you want to experiment.

About

A Swift utility function that generates Equatable protocol code for any object.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages