v0.1.0

Author: groue

.gitignore

@@ -0,0 +1,4 @@
+.DS_Store
+xcuserdata/
+.swiftpm
+.build/

CHANGELOG.md

@@ -0,0 +1,5 @@
+# Release Notes
+
+## v0.1.0
+
+Released on 2012/11/25

Documentation/QueryDemo/QueryDemo.xcodeproj/project.pbxproj

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

Documentation/QueryDemo/QueryDemo.xcodeproj/project.xcworkspace/contents.xcworkspacedata

@@ -0,0 +1,16 @@
+{
+  "object": {
+    "pins": [
+      {
+        "package": "GRDB",
+        "repositoryURL": "https://github.com/groue/GRDB.swift.git",
+        "state": {
+          "branch": null,
+          "revision": "8658b7bc1009237457324fc050cd06e0d961b72a",
+          "version": "5.13.0"
+        }
+      }
+    ]
+  },
+  "version": 1
+}

Documentation/QueryDemo/QueryDemo.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,11 @@
+{
+  "colors" : [
+    {
+      "idiom" : "universal"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Documentation/QueryDemo/QueryDemo.xcodeproj/project.xcworkspace/xcshareddata/swiftpm/Package.resolved

@@ -0,0 +1,98 @@
+{
+  "images" : [
+    {
+      "idiom" : "iphone",
+      "scale" : "2x",
+      "size" : "20x20"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "3x",
+      "size" : "20x20"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "2x",
+      "size" : "29x29"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "3x",
+      "size" : "29x29"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "2x",
+      "size" : "40x40"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "3x",
+      "size" : "40x40"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "2x",
+      "size" : "60x60"
+    },
+    {
+      "idiom" : "iphone",
+      "scale" : "3x",
+      "size" : "60x60"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "1x",
+      "size" : "20x20"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "2x",
+      "size" : "20x20"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "1x",
+      "size" : "29x29"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "2x",
+      "size" : "29x29"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "1x",
+      "size" : "40x40"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "2x",
+      "size" : "40x40"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "1x",
+      "size" : "76x76"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "2x",
+      "size" : "76x76"
+    },
+    {
+      "idiom" : "ipad",
+      "scale" : "2x",
+      "size" : "83.5x83.5"
+    },
+    {
+      "idiom" : "ios-marketing",
+      "scale" : "1x",
+      "size" : "1024x1024"
+    }
+  ],
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Documentation/QueryDemo/QueryDemo/Assets.xcassets/AccentColor.colorset/Contents.json

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Documentation/QueryDemo/QueryDemo/Assets.xcassets/AppIcon.appiconset/Contents.json

@@ -0,0 +1,38 @@
+import GRDB
+
+struct Player: Codable, Identifiable {
+    var id: Int64?
+    var name: String
+    var score: Int
+    var photoID: Int
+}
+
+extension Player {
+    private static let names = [
+        "Arthur", "Anita", "Barbara", "Bernard", "Craig", "Chiara", "David",
+        "Dean", "Éric", "Elena", "Fatima", "Frederik", "Gilbert", "Georgette",
+        "Henriette", "Hassan", "Ignacio", "Irene", "Julie", "Jack", "Karl",
+        "Kristel", "Louis", "Liz", "Masashi", "Mary", "Noam", "Nicole",
+        "Ophelie", "Oleg", "Pascal", "Patricia", "Quentin", "Quinn", "Raoul",
+        "Rachel", "Stephan", "Susie", "Tristan", "Tatiana", "Ursule", "Urbain",
+        "Victor", "Violette", "Wilfried", "Wilhelmina", "Yvon", "Yann",
+        "Zazie", "Zoé"]
+    
+    /// Creates a new player with random name and random score
+    static func makeRandom(id: ID = nil) -> Player {
+        Player(
+            id: id,
+            name: names.randomElement()!,
+            score: 10 * Int.random(in: 0...100),
+            photoID: Int.random(in: 0...1000))
+    }
+    
+    /// A placeholder Player
+    static let placeholder = Player(name: "xxxxxx", score: 100, photoID: 1)
+}
+
+extension Player: FetchableRecord, MutablePersistableRecord {
+    mutating func didInsert(with rowID: Int64, for column: String?) {
+        id = rowID
+    }
+}

Documentation/QueryDemo/QueryDemo/Assets.xcassets/Contents.json

@@ -0,0 +1,34 @@
+import GRDB
+
+/// Returns an empty in-memory database for the application.
+func emptyDatabaseQueue() -> DatabaseQueue {
+    let dbQueue = DatabaseQueue()
+    try! migrator().migrate(dbQueue)
+    return dbQueue
+}
+
+/// Returns an in-memory database that contains one player.
+///
+/// - parameter playerId: The ID of the inserted player.
+func populatedDatabaseQueue(playerId: Int64? = nil) -> DatabaseQueue {
+    let dbQueue = emptyDatabaseQueue()
+    try! dbQueue.write { db in
+        // insert a random player (and ignore generated id)
+        _ = try Player.makeRandom(id: playerId).inserted(db)
+    }
+    return dbQueue
+}
+
+/// The migrator that defines the schema of the database.
+private func migrator() -> DatabaseMigrator {
+    var migrator = DatabaseMigrator()
+    migrator.registerMigration("createPlayer") { db in
+        try db.create(table: "player") { t in
+            t.autoIncrementedPrimaryKey("id")
+            t.column("name", .text).notNull()
+            t.column("score", .integer).notNull()
+            t.column("photoID", .integer).notNull()
+        }
+    }
+    return migrator
+}

Documentation/QueryDemo/QueryDemo/Models/Player.swift

@@ -0,0 +1,6 @@
+{
+  "info" : {
+    "author" : "xcode",
+    "version" : 1
+  }
+}

Documentation/QueryDemo/QueryDemo/Persistence.swift

@@ -0,0 +1,41 @@
+import GRDB
+import GRDBQuery
+import SwiftUI
+
+@main
+struct QueryDemoApp: App {
+    var body: some Scene {
+        WindowGroup {
+            AppView()
+        }
+    }
+}
+
+// MARK: - Give SwiftUI access to the database
+//
+// Define a new environment key that grants access to a DatabaseQueue.
+//
+// The technique is documented at
+// <https://developer.apple.com/documentation/swiftui/environmentkey>.
+
+private struct DatabaseQueueKey: EnvironmentKey {
+    /// The default dbQueue is an empty in-memory database of players
+    static let defaultValue = emptyDatabaseQueue()
+}
+
+extension EnvironmentValues {
+    var dbQueue: DatabaseQueue {
+        get { self[DatabaseQueueKey.self] }
+        set { self[DatabaseQueueKey.self] = newValue }
+    }
+}
+
+// In this demo app, views observe the database with the @Query property
+// wrapper, defined in the local Query package. Its documentation recommends to
+// define a dedicated initializer for `dbQueue` access, so we comply:
+
+extension Query where Request.DatabaseContext == DatabaseQueue {
+    init(_ request: Request) {
+        self.init(request, in: \.dbQueue)
+    }
+}

Documentation/QueryDemo/QueryDemo/Preview Content/Preview Assets.xcassets/Contents.json

@@ -0,0 +1,15 @@
+import GRDB
+import GRDBQuery
+
+/// A @Query request that observes the number of players in the database. This
+/// request is used in the preview for the database buttons
+/// (see DatabaseButtons.swift).
+struct PlayerCountRequest: Queryable {
+    static var defaultValue: Int { 0 }
+    
+    func publisher(in dbQueue: DatabaseQueue) -> DatabasePublishers.Value<Int> {
+        ValueObservation
+            .tracking(Player.fetchCount)
+            .publisher(in: dbQueue, scheduling: .immediate)
+    }
+}

Documentation/QueryDemo/QueryDemo/QueryDemoApp.swift

@@ -0,0 +1,55 @@
+import Combine
+import GRDB
+import GRDBQuery
+
+/// A @Query request that observes the _presence_ of the player in the database.
+struct PlayerPresenceRequest: Queryable {
+    static var defaultValue: PlayerPresence { .missing }
+    
+    var id: Int64
+    
+    func publisher(in dbQueue: DatabaseQueue) -> AnyPublisher<PlayerPresence, Error> {
+        ValueObservation
+            .tracking(Player.filter(id: id).fetchOne)
+            .publisher(in: dbQueue, scheduling: .immediate)
+            .scan(.missing) { (previous, player) in
+                if let player = player {
+                    return .existing(player)
+                } else if let player = previous.player {
+                    return .gone(player)
+                } else {
+                    return .missing
+                }
+            }
+            .eraseToAnyPublisher()
+    }
+}
+
+enum PlayerPresence {
+    /// The player exists in the database
+    case existing(Player)
+    
+    /// Player no longer exists, but we have its latest value.
+    case gone(Player)
+    
+    /// Player does not exist, and we don't have any information about it.
+    case missing
+    
+    var player: Player? {
+        switch self {
+        case let .existing(player), let .gone(player):
+            return player
+        case .missing:
+            return nil
+        }
+    }
+    
+    var exists: Bool {
+        switch self {
+        case .existing:
+            return true
+        case .gone, .missing:
+            return false
+        }
+    }
+}

Documentation/QueryDemo/QueryDemo/Requests/PlayerCountRequest.swift

@@ -0,0 +1,13 @@
+import GRDB
+import GRDBQuery
+
+/// A @Query request that observes the player (any player, actually) in the database
+struct PlayerRequest: Queryable {
+    static var defaultValue: Player? { nil }
+    
+    func publisher(in dbQueue: DatabaseQueue) -> DatabasePublishers.Value<Player?> {
+        ValueObservation
+            .tracking(Player.fetchOne)
+            .publisher(in: dbQueue, scheduling: .immediate)
+    }
+}