SmartCodable - Swift data decoding & encoding

[]()

SmartCodable is a data parsing library based on Swift's Codable protocol, designed to provide more powerful and flexible parsing capabilities. By optimizing and rewriting the standard features of Codable, SmartCodable effectively solves common problems in the traditional parsing process and improves the fault tolerance and flexibility of parsing.

SmartCodable 是一个基于Swift的Codable协议的数据解析库，旨在提供更为强大和灵活的解析能力。通过优化和重写Codable的标准功能，SmartCodable 有效地解决了传统解析过程中的常见问题，并提高了解析的容错性和灵活性。

struct Model: SmartCodable {
    var age: Int?
    var name: String = ""
}

let model = Model.deserialize(from: json)

SmartCodable在Codable基础上做了大幅度的优化，支持：

Use SmartCodable

Installation - cocopods

Add the following line to your Podfile:

pod 'SmartCodable'

Then, run the following command:

$ pod install

Installation - Swift Package Manager

• File > Swift Packages > Add Package Dependency
• Add https://github.com/intsig171/SmartCodable.git

Usages

import SmartCodable

struct Model: SmartCodable {
    var string: String?
    var date: Date?
    var subModel: SubModel?

    @SmartAny
    var dict: [String: Any]?

    @IgnoredKey
    var ignoreKey: String?

    static func mappingForKey() -> [SmartKeyTransformer]? {
        [
            CodingKeys.date <--- "nowDate"
        ]
    }

    static func mappingForValue() -> [SmartValueTransformer]? {
        [
            CodingKeys.date <--- SmartDateTransformer(),
        ]
    }

    func didFinishMapping() {
        // do something
    }
}

If you don't know how to use it, check it out.

如果你不知道如何使用，请查看它。

👉 How to use SmartCodable?

Supported types

只要遵循了Codable，就可以参与解析。

• Int/Int8/Int16/Int32/Int64

• UInt/UInt8/UInt16/UInt32/UInt64

• String

• Bool

• Float/CGFloat/Double

• Dictionary（如果包含Any，请使用@SmartAny修饰该字典）

• Array（如果包含Any，请使用@SmartAny修饰该数组）

• URL/Date/Data/UIColor/enum

• 其他遵循了Codable协议的类型。

SmarCodable Test

👉 To learn more about how SmartCodable is tested, click here

Debug log

SmartLog Error indicates that SmartCodable encountered a resolution problem and executed compatibility logic. This does not mean that the analysis failed.

SmartCodable encourages the root of the resolution problem: it does not require SmartCodable compatibility logic.

出现 SmartLog Error 日志代表着 SmartCodable 遇到了解析问题，执行了兼容逻辑。 并不代表着本次解析失败。

SmartCodable鼓励从根本上解决解析中的问题，即：不需要用到SmartCodable的兼容逻辑。

 ========================  [Smart Decoding Log]  ========================
 Family 👈🏻 👀
    |- name    : Expected to decode String but found an array instead.
    |- location: Expected to decode String but found an array instead.
    |- date    : Expected to decode Date but found an array instead.
    |> father: Father
       |- name: Expected String value but found null instead.
       |- age : Expected to decode Int but found a string/data instead.
       |> dog: Dog
          |- hobby: Expected to decode String but found a number instead.
    |> sons: [Son]
       |- [Index 0] hobby: Expected to decode String but found a number instead.
       |- [Index 0] age  : Expected to decode Int but found a string/data instead.
       |- [Index 1] age  : Expected to decode Int but found an array instead.
 =========================================================================

Codable vs HandyJSON

If you are using HandyJSON and would like to replace it, follow this link.

如果你正在使用HandyJSON，并希望替换掉它，请关注该链接。

👉 SmartCodable - Compare With HandyJSON

FAQ

If you're looking forward to learning more about the Codable protocol and the design thinking behind SmartCodable, check it out.

如果你期望了解更多Codable协议以及SmartCodable的设计思考，请关注它。

👉 learn more

Github Stars

Join us

SmartCodable is an open source project, and we welcome all developers interested in improving data parsing performance and robustness. Whether it's using feedback, feature suggestions, or code contributions, your participation will greatly advance the SmartCodable project.

SmartCodable 是一个开源项目，我们欢迎所有对提高数据解析性能和健壮性感兴趣的开发者加入。无论是使用反馈、功能建议还是代码贡献，你的参与都将极大地推动 SmartCodable 项目的发展。