spacenation / swift-equatable

:rocket: Swift Macro for synthesizing Equatable conformance for classes and actors

Swift Equatable Macro

This package automatically generates Equatable conformance for both classes and actors. This means that you do not need to manually implement the == operator for your classes and actors, as this package will handle it for you.

By conforming to Equatable, instances of your classes and actors can be easily compared for equality, which is useful for many operations such as sorting, searching, and maintaining collections. This package ensures that the generated == operator correctly compares all relevant properties of your classes and actors, providing a robust and efficient implementation.

Note: Classes must be marked as final to use this package. This ensures that the synthesized == operator is accurate and efficient, as it does not need to account for potential subclassing.

Usage

Add @Equatable annotation to class or actor

import Equatable

@Equatable
public final class Planet {
    let name: String
    let mass: Mass
}

/// Expands to
extension Planet: Equatable {
    public static func == (lhs: Planet, rhs: Planet) -> Bool {
        lhs.name == rhs.name &&
        lhs.mass == rhs.mass
    }
}

Installation

To use the Equatable library in a SwiftPM project, add it to the dependencies for your package and your target:

let package = Package(
    // name, platforms, products, etc.
    dependencies: [
        // other dependencies
        .package(url: "https://github.com/spacenation/swift-equatable", from: "1.0.0"),
    ],
    targets: [
        .target(
            // name, etc.
            dependencies: [
                // other dependencies
                .product(name: "Equatable", package: "swift-equatable")
            ]
        )
        // other targets
    ]
)

Contributions

Feel free to contribute via fork/pull request to the main branch. If you want to request a feature or report a bug, please start a new issue.

Become a Sponsor

If you find this project useful, please consider becoming our GitHub Sponsor.