Merge branch 'develop' into release

Author: finestructure

Sources/ValueCodable/Value.swift

@@ -196,11 +196,11 @@ extension Value {
     }
 
     public subscript(index: Int) -> Value? {
-        switch self {
-        case .array(let v):
-            return index >= 0
-                ? v[index]
-                : v[v.index(v.endIndex, offsetBy: index)]  // from end
+        switch (self, index) {
+        case (.array(let v), index) where (0..<v.count).contains(index):
+            return v[index]
+        case (.array(let v), index) where (-v.count..<0).contains(index):
+            return v[v.index(v.endIndex, offsetBy: index)]  // from end
         default:
             return nil
         }

Tests/LinuxMain.swift

@@ -1,4 +1,4 @@
-// Generated using Sourcery 0.15.0 — https://github.com/krzysztofzablocki/Sourcery
+// Generated using Sourcery 0.16.0 — https://github.com/krzysztofzablocki/Sourcery
 // DO NOT EDIT
 
 

Tests/ValueCodableTests/ValueCodableTests.swift

@@ -211,6 +211,11 @@ final class ValueCodableTests: XCTestCase {
         XCTAssertEqual(a[0], "a")
         XCTAssertEqual(a[-1], "z")
         XCTAssertEqual(a[1], a[-2])
+        XCTAssertEqual(a[-3], "a")
+        XCTAssertNil(a[-4])
+        let empty: Value = .array([])
+        XCTAssertNil(empty[0])
+        XCTAssertNil(empty[-1])
     }
 
 }

examples/basic.swift

@@ -0,0 +1,41 @@
+#!/usr/bin/swift sh
+import ValueCodable  // @finestructure ~> 0.0.2
+import Yams          // @jpsim
+
+let s = """
+    name: foo
+    data:
+        obj:
+            a: 1
+            b: two
+        list:
+            - 1
+            - two
+            - foo: bar
+    """
+
+struct Test: Decodable {
+    let name: String
+    // capture the unstructure data as "Value"
+    let data: Value
+}
+
+let t = try YAMLDecoder().decode(Test.self, from: s)
+
+// access "data" via subscript
+print(t.data["obj"])       // Optional(["a": 1, "b": "two"])
+print(t.data["list"])      // Optional([1, "two", ["foo": "bar"]])
+print(t.data["list"]?[0])  // Optional(1)
+
+// act on the decoded types
+switch t.data["list"]?[2] {
+case let .some(.dictionary(dict)):
+    print(dict)            // ["foo": "bar"]
+default:
+    print("unhandled type")
+}
+
+// access propertyies via key paths
+print(t.data["obj.b"])         // Optional("two")
+print(t.data["list[0]"])       // Optional(1)
+print(t.data["list[2].foo"])   // Optional("bar")