SwiftIdentifier

1.1.1

A lightweight library that helps to define ID types.
jrsaruo/SwiftIdentifier

What's New

Release 1.1.1

2023-09-22T14:41:44Z

What's Changed

🧰 Maintenance

Other Changes

Full Changelog: 1.1.0...1.1.1

SwiftIdentifier

A lightweight library that helps to define ID types.

Requirements

  • Swift 5.4+

Features

What problems does SwiftIdentifier solve?

Suppose you have User and Book types, each of which has an ID of type Int:

struct User {
    let id: Int
}

struct Book {
    let id: Int
}

and have a userIDHandler closure:

let userIDHandler: (Int) -> Void = { ... }

There are two main problems here.

  • userIDHandler accepts a Book ID, leading to silent bugs.
  • The argument type of userIDHandler does not fully convey intent.

Solution with SwiftIdentifier

You can easily define different ID types for each type!

struct User {
    typealias ID = Identifier<Self, Int>
    let id: ID
}
struct Book {
    typealias ID = Identifier<Self, Int>
    let id: ID
}

let user = User(id: 10)
let book = Book(id: 500)

// The argument type become clearer!
let userIDHandler: (User.ID) -> Void = { ... }

userIDHandler(user.id) // OK
userIDHandler(book.id) // Compile error!

Other features

  • You can collaborate nicely with Codable.

    struct User: Codable {
        typealias ID = Identifier<Self, Int>
        let id: ID
        let name: String
    }
    
    // Compatible JSON
    """
    {
        "id": 100,
        "name": "John"
    }
    """

Using SwiftIdentifier in your project

To use the SwiftIdentifier library in a SwiftPM project, add the following line to the dependencies in your Package.swift file:

.package(url: "https://github.com/jrsaruo/SwiftIdentifier", from: "1.1.1"),

and add SwiftIdentifier as a dependency for your target:

.target(name: "<target>", dependencies: [
    .product(name: "SwiftIdentifier", package: "SwiftIdentifier"),
    // other dependencies
]),

Finally, add import SwiftIdentifier in your source code.

Description

  • Swift Tools 5.4.0
View More Packages from this Author

Dependencies

  • None
Last updated: Thu Oct 17 2024 20:00:14 GMT-0900 (Hawaii-Aleutian Daylight Time)