Merge branch 'release-2.1.0'

stack · stack · commit b9569fe5f09e · 2020-08-16T22:01:32.000-04:00
diff --git a/.travis.yml b/.travis.yml
@@ -1,7 +1,7 @@
 language: objective-c
 
 os: osx
-osx_image: xcode11
+osx_image: xcode11.6
 
 xcode_project: Restructure.xcodeproj
 
@@ -11,22 +11,22 @@ xcode_scheme:
     - Restructure tvOS
 
 xcode_sdk:
-    - iphonesimulator13.0
+    - iphonesimulator13.6
     - macosx10.15
-    - appletvsimulator13.0
+    - appletvsimulator13.4
 
 matrix:
     exclude:
         - xcode_scheme: Restructure iOS
           xcode_sdk: macosx10.15
         - xcode_scheme: Restructure iOS
-          xcode_sdk: appletvsimulator13.0
+          xcode_sdk: appletvsimulator13.4
         - xcode_scheme: Restructure macOS
-          xcode_sdk: iphonesimulator13.0
+          xcode_sdk: iphonesimulator13.6
         - xcode_scheme: Restructure macOS
-          xcode_sdk: appletvsimulator13.0
+          xcode_sdk: appletvsimulator13.4
         - xcode_scheme: Restructure tvOS
-          xcode_sdk: iphonesimulator13.0
+          xcode_sdk: iphonesimulator13.6
         - xcode_scheme: Restructure tvOS
           xcode_sdk: macosx10.15
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 2.1.0 2020-08-16
+### Added
+-   `sqliteVersion` fetches the underlying SQLite version string.
+-   Dynamic member lookup is enabled for `Row`, allowing for direct access to values via property notation.
+
+### Removed
+-   `JournalMode.off` has been removed because of defensive configs.
+
 ## 2.0.0 - 2019-09-12
 ### Added
 -   `AutoVacuum` dictates the automatic vacuuming mode.
diff --git a/LICENSE b/LICENSE
@@ -1,4 +1,4 @@
-Copyright (c) 2019 Stephen H. Gerstacker
+Copyright (c) 2020 Stephen H. Gerstacker
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/README.md b/README.md
@@ -1,7 +1,7 @@
 #  Restructure
 
-[![Build Status](https://travis-ci.org/stack/Restructure.svg?branch=swift-5.1)](https://travis-ci.org/stack/Restructure)
-![Swift 5.1](https://img.shields.io/badge/Swift-5.0-orange.svg)
+[![Build Status](https://travis-ci.org/stack/Restructure.svg)](https://travis-ci.org/stack/Restructure)
+![Swift 5.1](https://img.shields.io/badge/Swift-5.1-orange.svg)
 
 Restructure is a wrapper library for [SQLite](https://sqlite.org/index.html) for
 iOS, macOS, and tvOS. It's fairly opinionated, as in, it does exactly what I
@@ -185,6 +185,23 @@ for row in statement }
 }
 ```
 
+
+### Rows support Dynamic Member Lookup
+
+You can extract data from a row with direct property access using Dynamic Member Lookup.
+
+```swift
+let statement = try! restructure.prepare(query: "SELECT a, b, c, d, e FROM foo LIMIT 1")
+
+guard case let .row(row) = statement.step() else {
+    /// Handle error
+}
+
+let a: Int = row.a
+let b: String = row.b
+let c: Double = row.c
+```
+
 ### Migrations
 
 The Restructure object has a `userVersion` property to track the version of a
diff --git a/Sources/Restructure/ArrayStrategy.swift b/Sources/Restructure/ArrayStrategy.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/10/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/AutoVacuum.swift b/Sources/Restructure/AutoVacuum.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 8/12/19.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/Date+Julian.swift b/Sources/Restructure/Date+Julian.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/4/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/DateStrategy.swift b/Sources/Restructure/DateStrategy.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/4/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/JournalMode.swift b/Sources/Restructure/JournalMode.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 8/12/19.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
@@ -20,8 +20,6 @@ public enum JournalMode: CaseIterable, PragmaRepresentable {
     case memory
     /// A write-ahead log is used as opposed to a rollback journal. This is the default for a file-backed database.
     case wal
-    /// No rollback journal is used.
-    case off
     
     /// Create a `JournalMode` from a SQlite representation
     static func from(value: String) -> JournalMode {
@@ -36,8 +34,6 @@ public enum JournalMode: CaseIterable, PragmaRepresentable {
             return .memory
         case "WAL":
             return .wal
-        case "OFF":
-            return .off
         default:
             fatalError("Unsupported JournalMode string: \(value)")
         }
@@ -56,8 +52,6 @@ public enum JournalMode: CaseIterable, PragmaRepresentable {
             return "MEMORY"
         case .wal:
             return "WAL"
-        case .off:
-            return "OFF"
         }
     }
 }
diff --git a/Sources/Restructure/PragmaRepresentable.swift b/Sources/Restructure/PragmaRepresentable.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 8/12/19.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/Restructure.swift b/Sources/Restructure/Restructure.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
@@ -67,6 +67,23 @@ public class Restructure {
         get { get(pragma: "user_version") }
         set { set(pragma: "user_version", value: newValue) }
     }
+
+    /// The underlying SQLite version {
+    public var sqliteVersion: String {
+        do {
+            let statement = try prepare(query: "SELECT sqlite_version()")
+            let result = statement.step()
+
+            switch result {
+            case let .row(row):
+                return row[0]
+            default:
+                fatalError("Failed to fetch sqlite_version from a result: \(result)")
+            }
+        } catch {
+            fatalError("Failed to fetch sqlite_version: \(error)")
+        }
+    }
     
     
     // MARK: - Initialization
diff --git a/Sources/Restructure/RestructureError.swift b/Sources/Restructure/RestructureError.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/Row.swift b/Sources/Restructure/Row.swift
@@ -3,13 +3,14 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/4/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
 import SQLite3
 
 /// A row result from a `Statement`.
+@dynamicMemberLookup
 public class Row {
     
     // MARK: - Properties
@@ -78,6 +79,15 @@ public class Row {
         
         return self[Int(index)]
     }
+
+    /// Returns the non-null `Structurable` value via dynamic look up
+    ///
+    /// - Parameter dynamicMember: The dynamic member to look for.
+    ///
+    /// - Returns: The `Structurable` value associated with the key, transformated by the underlying SQLite API if necessary.
+    public subscript<T: Structurable>(dynamicMember key: String) -> T {
+        return self[key]
+    }
     
     ///Returns the nullable `Structurable` value for the given index value.
     ///
@@ -106,4 +116,13 @@ public class Row {
         
         return self[Int(index)]
     }
+
+    /// Returns the nullable `Structurable` value via dynamic look up
+    ///
+    /// - Parameter dynamicMember: The dynamic member to look for.
+    ///
+    /// - Returns: The `Structurable` value associated with the key, transformated by the underlying SQLite API if necessary.
+    public subscript<T: Structurable>(dynamicMember key: String) -> T? {
+        return self[key]
+    }
 }
diff --git a/Sources/Restructure/RowDecoder.swift b/Sources/Restructure/RowDecoder.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/15/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/SecureDelete.swift b/Sources/Restructure/SecureDelete.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 8/12/19.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/Statement.swift b/Sources/Restructure/Statement.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/StatementEncoder.swift b/Sources/Restructure/StatementEncoder.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/10/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/StepResult.swift b/Sources/Restructure/StepResult.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/4/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/String+SQLite3.swift b/Sources/Restructure/String+SQLite3.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Sources/Restructure/Structurable.swift b/Sources/Restructure/Structurable.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import Foundation
diff --git a/Tests/RestructureTests/RestructureInitializationTests.swift b/Tests/RestructureTests/RestructureInitializationTests.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/4/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import XCTest
diff --git a/Tests/RestructureTests/RestructureTests.swift b/Tests/RestructureTests/RestructureTests.swift
@@ -3,7 +3,7 @@
 //  Restructure macOS Tests
 //
 //  Created by Stephen H. Gerstacker on 11/3/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import XCTest
@@ -71,6 +71,13 @@ class RestructureTests: XCTestCase {
         XCTAssertNoThrow(try restructure.execute(query: "CREATE TABLE foo (a INTEGER PRIMARY KEY AUTOINCREMENT, b INT); INSERT INTO foo (b) VALUES(42);"))
         XCTAssertGreaterThan(restructure.lastInsertedId, 0)
     }
+
+    // MARK: - SQLite Version Tests
+
+    func testSQLiteVersionExists() {
+        let version = restructure.sqliteVersion
+        XCTAssertFalse(version.isEmpty)
+    }
     
     
     // MARK: - Migration Tests
diff --git a/Tests/RestructureTests/RowDecoderTests.swift b/Tests/RestructureTests/RowDecoderTests.swift
@@ -3,7 +3,7 @@
 //  Restructure
 //
 //  Created by Stephen H. Gerstacker on 11/30/18.
-//  Copyright @ 2019 Stephen H. Gerstacker. All rights reserved.
+//  Copyright @ 2020 Stephen H. Gerstacker. All rights reserved.
 //
 
 import XCTest
diff --git a/Tests/RestructureTests/RowTests.swift b/Tests/RestructureTests/RowTests.swift
diff --git a/Tests/RestructureTests/StatementEncoderTests.swift b/Tests/RestructureTests/StatementEncoderTests.swift
diff --git a/Tests/RestructureTests/StatementSequenceTests.swift b/Tests/RestructureTests/StatementSequenceTests.swift
diff --git a/Tests/RestructureTests/StatementTests.swift b/Tests/RestructureTests/StatementTests.swift
diff --git a/Tests/RestructureTests/TestHelpers.swift b/Tests/RestructureTests/TestHelpers.swift

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-Copyright (c) 2019 Stephen H. Gerstacker`
	`1`	`+Copyright (c) 2020 Stephen H. Gerstacker`
`2`	`2`
`3`	`3`	`Permission is hereby granted, free of charge, to any person obtaining a copy`
`4`	`4`	`of this software and associated documentation files (the "Software"), to deal`