[Enhancement] Lossy codable list property wrapper (#19)

This PR contains the work done to implement the `LossyCodableList` struct and property wrapper, which is used in lossy decoding/encoding processes.

Co-authored-by: Javier Cicchelli <javier@rock-n-code.com>
Reviewed-on: #19
This commit was merged in pull request #19.
This commit is contained in:
2023-05-07 19:40:29 +00:00
parent 7fb72509c2
commit 28c9232962
9 changed files with 371 additions and 0 deletions
@@ -0,0 +1,75 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
import Core
import Foundation
import XCTest
final class LossyCodableList_DecodableTests: XCTestCase {
// MARK: Properties
private let decoder = JSONDecoder()
private var dataToDecode: Data!
private var decodedList: TestCodableList!
// MARK: Tests
func test_decode_whenAllDataIsComplete() throws {
// GIVEN
dataToDecode = .Seed.itemsWithAllKeysHavingIntValues
// WHEN
decodedList = try decoder.decode(TestCodableList.self, from: dataToDecode)
// THEN
XCTAssertNotNil(decodedList)
XCTAssertTrue(decodedList.items.isNotEmpty)
XCTAssertEqual(decodedList.items, [
.init(key: "One", value: 1),
.init(key: "Two", value: 2),
.init(key: "Three", value: 3),
.init(key: "Four", value: 4)
])
}
func test_decode_whenSomeDataHasNil() throws {
// GIVEN
dataToDecode = .Seed.itemsWithSomeKeysAndValuesAreNil
// WHEN
decodedList = try decoder.decode(TestCodableList.self, from: dataToDecode)
// THEN
XCTAssertNotNil(decodedList)
XCTAssertTrue(decodedList.items.isNotEmpty)
XCTAssertEqual(decodedList.items, [
.init(key: "One", value: 1),
.init(key: "Three", value: 3)
])
}
func test_decode_whenAllDataHasNil() throws {
// GIVEN
dataToDecode = .Seed.itemsWithAllKeysAndValuesAreNil
// WHEN
decodedList = try decoder.decode(TestCodableList.self, from: dataToDecode)
// THEN
XCTAssertNotNil(decodedList)
XCTAssertTrue(decodedList.items.isEmpty)
XCTAssertEqual(decodedList.items, [])
}
}
@@ -0,0 +1,80 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
import Foundation
import XCTest
@testable import Core
final class LossyCodableList_EncodableTests: XCTestCase {
// MARK: Properties
private let decoder = JSONDecoder()
private let encoder = JSONEncoder()
private var dataToDecode: Data!
private var encodedData: Data!
private var list: TestCodableList!
// MARK: Setup
override func setUpWithError() throws {
// This setting is used to guarantee that the properties of the model are being generated by sorted keys order.
encoder.outputFormatting = .sortedKeys
}
// MARK: Tests
func test_encode_whenAllKeysHaveIntValues() throws {
// GIVEN
dataToDecode = .Seed.itemsWithAllKeysHavingIntValues
list = try decoder.decode(TestCodableList.self, from: dataToDecode)
// WHEN
encodedData = try encoder.encode(list)
// THEN
XCTAssertNotNil(encodedData)
XCTAssertTrue(encodedData.isNotEmpty)
XCTAssertEqual(encodedData, .Result.allItemsNotFilteredOut)
}
func test_encode_whenSomeKeysAndValuesAreNil() throws {
// GIVEN
dataToDecode = .Seed.itemsWithSomeKeysAndValuesAreNil
list = try decoder.decode(TestCodableList.self, from: dataToDecode)
// WHEN
encodedData = try encoder.encode(list)
// THEN
XCTAssertNotNil(encodedData)
XCTAssertTrue(encodedData.isNotEmpty)
XCTAssertEqual(encodedData, .Result.someItemsFilteredOut)
}
func test_encode_whenAllKeysAndValuesAreNil() throws {
// GIVEN
dataToDecode = .Seed.itemsWithAllKeysAndValuesAreNil
list = try decoder.decode(TestCodableList.self, from: dataToDecode)
// WHEN
encodedData = try encoder.encode(list)
// THEN
XCTAssertNotNil(encodedData)
XCTAssertTrue(encodedData.isNotEmpty)
XCTAssertEqual(encodedData, .Result.allItemsFilteredOut)
}
}
@@ -0,0 +1,21 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
import Foundation
extension Data {
enum Result {
static let allItemsNotFilteredOut = String.Result.allItemsNotFilteredOut.data(using: .utf8)
static let someItemsFilteredOut = String.Result.someItemsFilteredOut.data(using: .utf8)
static let allItemsFilteredOut = String.Result.allItemsFilteredOut.data(using: .utf8)
}
}
@@ -0,0 +1,21 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
import Foundation
extension Data {
enum Seed {
static let itemsWithAllKeysHavingIntValues = String.Seed.itemsWithAllKeysHavingIntValues.data(using: .utf8)
static let itemsWithSomeKeysAndValuesAreNil = String.Seed.itemsWithSomeKeysAndValuesAreNil.data(using: .utf8)
static let itemsWithAllKeysAndValuesAreNil = String.Seed.itemsWithAllKeysAndValuesAreNil.data(using: .utf8)
}
}
@@ -0,0 +1,19 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
extension String {
enum Result {
static let allItemsNotFilteredOut = "{\"items\":[{\"key\":\"One\",\"value\":1},{\"key\":\"Two\",\"value\":2},{\"key\":\"Three\",\"value\":3},{\"key\":\"Four\",\"value\":4}]}"
static let someItemsFilteredOut = "{\"items\":[{\"key\":\"One\",\"value\":1},{\"key\":\"Three\",\"value\":3}]}"
static let allItemsFilteredOut = "{\"items\":[]}"
}
}
@@ -0,0 +1,19 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
extension String {
enum Seed {
static let itemsWithAllKeysHavingIntValues = "{\"items\":[{\"key\":\"One\",\"value\":1},{\"key\":\"Two\",\"value\":2},{\"key\":\"Three\",\"value\":3},{\"key\":\"Four\",\"value\":4}]}"
static let itemsWithSomeKeysAndValuesAreNil = "{\"items\":[{\"key\":\"One\",\"value\":1},{\"key\":\"Two\",\"value\":null},{\"key\":\"Three\",\"value\":3},{\"key\":null,\"value\":4}]}"
static let itemsWithAllKeysAndValuesAreNil = "{\"items\":[{\"key\":\"One\",\"value\":null},{\"key\":null,\"value\":2},{\"key\":\"Three\",\"value\":null},{\"key\":null,\"value\":4}]}"
}
}
@@ -0,0 +1,30 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
struct TestCodable: Codable, Equatable {
let key: String
let value: Int
}
// MARK: - Initialisers
extension TestCodable {
init?(
key: String? = nil,
value: Int? = nil
) {
guard let key, let value else { return nil }
self.key = key
self.value = value
}
}
@@ -0,0 +1,17 @@
//===----------------------------------------------------------------------===//
//
// This source file is part of the SwiftLibs open source project
//
// Copyright (c) 2023 Röck+Cöde VoF. and the SwiftLibs project authors
// Licensed under the EUPL 1.2 or later.
//
// See LICENSE.txt for license information
// See CONTRIBUTORS.txt for the list of SwiftLibs project authors
//
//===----------------------------------------------------------------------===//
import Core
struct TestCodableList: Codable {
@LossyCodableList var items: [TestCodable]
}