Convenience api for updating a single column

Author: groue

GRDB/QueryInterface/Request/QueryInterfaceRequest.swift

@@ -77,6 +77,7 @@
 ///
 /// ### Batch Update
 ///
+/// - ``updateAll(_:onConflict:assignment:)``
 /// - ``updateAll(_:onConflict:assignments:)``
 /// - ``updateAll(_:onConflict:_:)-9r4v``
 /// - ``updateAll(_:onConflict:_:)-49qg8``
@@ -1036,7 +1037,41 @@ extension QueryInterfaceRequest {
     /// try dbQueue.write { db in
     ///     // UPDATE player SET score = 0
     ///     let request = Player.all()
-    ///     try request.updateAll(db) { [$0.score.set(to: 0)] }
+    ///     try request.updateAll(db) { $0.score.set(to: 0) }
+    /// }
+    /// ```
+    ///
+    /// - parameter db: A database connection.
+    /// - parameter conflictResolution: A policy for conflict resolution.
+    /// - parameter assignment: A closure that returns an assignment.
+    /// - returns: The number of updated rows.
+    /// - throws: A ``DatabaseError`` whenever an SQLite error occurs.
+    @discardableResult
+    public func updateAll(
+        _ db: Database,
+        onConflict conflictResolution: Database.ConflictResolution? = nil,
+        assignments: (RowDecoder.ColumnsProvider) -> ColumnAssignment
+    ) throws -> Int
+    where RowDecoder: TableRecord
+    {
+        try updateAll(db, onConflict: conflictResolution, [assignments(RowDecoder.columns)])
+    }
+    
+    /// Updates matching rows, and returns the number of updated rows.
+    ///
+    /// For example:
+    ///
+    /// ```swift
+    /// struct Player: TableRecord {
+    ///     enum Columns {
+    ///         static let score = Column("score")
+    ///     }
+    /// }
+    ///
+    /// try dbQueue.write { db in
+    ///     // UPDATE player SET score = 0
+    ///     let request = Player.all()
+    ///     try request.updateAll(db) { $0.score.set(to: 0) }
     /// }
     /// ```
     ///
@@ -1797,9 +1832,9 @@ extension QueryInterfaceRequest {
 ///
 /// try dbQueue.write { db in
 ///     // UPDATE player SET score = 0
-///     try Player.updateAll(db) { [
+///     try Player.updateAll(db) {
 ///         $0.score.set(to: 0)
-///     ] }
+///     }
 /// }
 /// ```
 public struct ColumnAssignment {

GRDB/QueryInterface/SQL/Table.swift

@@ -48,6 +48,7 @@
 ///
 /// ### Updating Rows
 ///
+/// - ``updateAll(_:onConflict:assignment:)``
 /// - ``updateAll(_:onConflict:assignments:)``
 /// - ``updateAll(_:onConflict:_:)-4w9b``
 /// - ``updateAll(_:onConflict:_:)-4cvap``
@@ -1914,7 +1915,42 @@ extension Table {
     ///
     /// try dbQueue.write { db in
     ///     // UPDATE player SET score = 0
-    ///     try playerTable.updateAll(db) { [$0.score.set(to: 0)] }
+    ///     try playerTable.updateAll(db) { $0.score.set(to: 0) }
+    /// }
+    /// ```
+    ///
+    /// - parameter db: A database connection.
+    /// - parameter conflictResolution: A policy for conflict resolution.
+    /// - parameter assignment: A closure that returns an assignments.
+    /// - returns: The number of updated rows.
+    /// - throws: A ``DatabaseError`` whenever an SQLite error occurs.
+    @discardableResult
+    public func updateAll(
+        _ db: Database,
+        onConflict conflictResolution: Database.ConflictResolution? = nil,
+        assignment: (RowDecoder.ColumnsProvider) -> ColumnAssignment)
+    throws -> Int
+    where RowDecoder: TableRecord
+    {
+        try updateAll(db, onConflict: conflictResolution, [assignment(RowDecoder.columns)])
+    }
+    
+    /// Updates all rows, and returns the number of updated rows.
+    ///
+    /// For example:
+    ///
+    /// ```swift
+    /// struct Player: TableRecord {
+    ///     enum Columns {
+    ///         static let score = Column("score")
+    ///     }
+    /// }
+    ///
+    /// let playerTable = Table<Player>("player")
+    ///
+    /// try dbQueue.write { db in
+    ///     // UPDATE player SET score = 0
+    ///     try playerTable.updateAll(db) { $0.score.set(to: 0) }
     /// }
     /// ```
     ///
@@ -1934,7 +1970,7 @@ extension Table {
     {
         try updateAll(db, onConflict: conflictResolution, assignments(RowDecoder.columns))
     }
-
+    
     /// Updates all rows, and returns the number of updated rows.
     ///
     /// For example:

GRDB/Record/TableRecord.swift

@@ -49,6 +49,8 @@ import Foundation
 ///
 /// ### Updating Records
 ///
+/// - ``updateAll(_:onConflict:assignment:)``
+/// - ``updateAll(_:onConflict:assignments:)``
 /// - ``updateAll(_:onConflict:_:)-7vv9x``
 /// - ``updateAll(_:onConflict:_:)-7atfw``
 ///
@@ -758,7 +760,7 @@ extension TableRecord {
     ///
     /// try dbQueue.write { db in
     ///     // UPDATE player SET score = 0
-    ///     try Player.updateAll(db) { [$0.score.set(to: 0)] }
+    ///     try Player.updateAll(db) { $0.score.set(to: 0) }
     /// }
     /// ```
     ///
@@ -779,6 +781,39 @@ extension TableRecord {
         try updateAll(db, onConflict: conflictResolution, assignments(columns))
     }
 
+    /// Updates all records, and returns the number of updated records.
+    ///
+    /// For example:
+    ///
+    /// ```swift
+    /// struct Player: TableRecord {
+    ///     enum Columns {
+    ///         static let score = Column("score")
+    ///     }
+    /// }
+    ///
+    /// try dbQueue.write { db in
+    ///     // UPDATE player SET score = 0
+    ///     try Player.updateAll(db) { $0.score.set(to: 0) }
+    /// }
+    /// ```
+    ///
+    /// - parameter db: A database connection.
+    /// - parameter conflictResolution: A policy for conflict resolution,
+    ///   defaulting to the record's persistenceConflictPolicy.
+    /// - parameter assignments: A closure that returns an assignment.
+    /// - returns: The number of updated records.
+    /// - throws: A ``DatabaseError`` whenever an SQLite error occurs.
+    @discardableResult
+    public static func updateAll(
+        _ db: Database,
+        onConflict conflictResolution: Database.ConflictResolution? = nil,
+        assignment: (ColumnsProvider) -> ColumnAssignment)
+    throws -> Int
+    {
+        try updateAll(db, onConflict: conflictResolution, [assignment(columns)])
+    }
+    
     /// Updates all records, and returns the number of updated records.
     ///
     /// For example:

README.md

@@ -1767,7 +1767,7 @@ See the [query interface](#the-query-interface) for batch updates:
 ```swift
 try Player
     .filter { $0.team == "red" }
-    .updateAll(db) { [$0.score += 1] }
+    .updateAll(db) { $0.score += 1 }
 ```
 
 :point_right: update methods are available for types that adopt the [PersistableRecord] protocol. Batch updates are available on the [TableRecord] protocol.
@@ -3237,7 +3237,7 @@ try dbQueue.write { db in
     // Batch update
     try Player
         .filter { $0.team == "Reds" }
-        .updateAll(db) { [$0.score += 100] }
+        .updateAll(db) { $0.score += 100 }
 
     // Batch delete
     try Player
@@ -4448,34 +4448,34 @@ try Player.updateAll(db) { [
 // UPDATE player SET score = 0 WHERE team = 'Reds'
 try Player
     .filter { $0.team == "Reds" }
-    .updateAll(db) { [$0.score.set(to: 0)] }
+    .updateAll(db) { $0.score.set(to: 0) }
 
 // UPDATE player SET isGreat = 1 ORDER BY score DESC LIMIT 10
 try Player
     .order(\.score.desc)
     .limit(10)
-    .updateAll(db) { [$0.isGreat.set(to: true)] }
+    .updateAll(db) { $0.isGreat.set(to: true) }
 
 // UPDATE country SET population = 67848156 WHERE id = 'FR'
 try Country
     .filter(id: "FR")
-    .updateAll(db) { [$0.population.set(to: 67_848_156)] }
+    .updateAll(db) { $0.population.set(to: 67_848_156) }
 ```
 
 Column assignments accept any expression:
 
 ```swift
 // UPDATE player SET score = score + (bonus * 2)
-try Player.updateAll(db) { [
+try Player.updateAll(db) {
     $0.score.set(to: $0.score + $0.bonus * 2)
-] }
+}
 ```
 
 As a convenience, you can also use the `+=`, `-=`, `*=`, or `/=` operators:
 
 ```swift
 // UPDATE player SET score = score + (bonus * 2)
-try Player.updateAll(db) { [$0.score += $0.bonus * 2] }
+try Player.updateAll(db) { $0.score += $0.bonus * 2 }
 ```
 
 Default [Conflict Resolution] rules apply, and you may also provide a specific one: