Add batch transactions

CHANGELOG.md

@@ -1,10 +1,14 @@
 # Parse-Swift Changelog
 
 ### main
-[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.1.6...main)
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.1.7...main)
 * _Contributing to this repo? Add info about your change here to be included in the next release_
 
+### 1.1.7
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/1.1.6...1.1.7)
+
 __New features__
+- Add transaction support to batch saveAll and deleteAll ([#89](https://github.com/parse-community/Parse-Swift/pull/89)), thanks to [Corey Baker](https://github.com/cbaker6).
 - Add modifiers to containsString, hasPrefix, hasSuffix ([#85](https://github.com/parse-community/Parse-Swift/pull/85)), thanks to [Corey Baker](https://github.com/cbaker6).
 
 __Improvements__

ParseSwift.playground/Pages/1 - Your first Object.xcplaygroundpage/Contents.swift

@@ -1,3 +1,9 @@
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -38,7 +44,7 @@ let score = GameScore(score: 10)
 let score2 = GameScore(score: 3)
 
 /*: Save asynchronously (preferred way) - Performs work on background
-    queue and returns to designated on designated callbackQueue.
+    queue and returns to specified callbackQueue.
     If no callbackQueue is specified it returns to main queue.
 */
 score.save { result in
@@ -101,6 +107,29 @@ var score2ForFetchedLater: GameScore?
     }
 }
 
+//: Saving multiple GameScores at once using a transaction.
+[score, score2].saveAll(transaction: true) { results in
+    switch results {
+    case .success(let otherResults):
+        var index = 0
+        otherResults.forEach { otherResult in
+            switch otherResult {
+            case .success(let savedScore):
+                print("Saved \"\(savedScore.className)\" with score \(savedScore.score) successfully")
+                if index == 1 {
+                    score2ForFetchedLater = savedScore
+                }
+                index += 1
+            case .failure(let error):
+                assertionFailure("Error saving: \(error)")
+            }
+        }
+
+    case .failure(let error):
+        assertionFailure("Error saving: \(error)")
+    }
+}
+
 //: Save synchronously (not preferred - all operations on main queue).
 let savedScore: GameScore?
 do {
@@ -235,7 +264,7 @@ do {
 }
 
 //: Asynchronously (preferred way) deleteAll GameScores based on it's objectId alone.
-[scoreToFetch, score2ToFetch].deleteAll { result in
+[scoreToFetch, score2ToFetch].deleteAll(transaction: true) { result in
     switch result {
     case .success(let deletedScores):
         deletedScores.forEach { result in

ParseSwift.playground/Pages/10 - Cloud Code.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift

ParseSwift.playground/Pages/11 - LiveQuery.xcplaygroundpage/Contents.swift

@@ -1,5 +1,12 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (iOS) and targeting
+//: an iPhone, iPod, or iPad. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = iOS`. This is because
+//: SwiftUI in macOS Playgrounds doesn't seem to build correctly
+//: Be sure to switch your target and `Playground Settings` back to
+//: macOS after leaving this page.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift

ParseSwift.playground/Pages/12 - Roles and Relations.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift

ParseSwift.playground/Pages/13 - Operations.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift

ParseSwift.playground/Pages/14 - Config.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift

ParseSwift.playground/Pages/2 - Finding Objects.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -31,9 +37,9 @@ var query = GameScore.query("score" > 50,
                             "createdAt" > afterDate)
     .order([.descending("score")])
 
-// Query asynchronously (preferred way) - Performs work on background
-// queue and returns to designated on designated callbackQueue.
-// If no callbackQueue is specified it returns to main queue.
+//: Query asynchronously (preferred way) - Performs work on background
+//: queue and returns to specified callbackQueue.
+//: If no callbackQueue is specified it returns to main queue.
 query.limit(2).find(callbackQueue: .main) { results in
     switch results {
     case .success(let scores):
@@ -50,7 +56,7 @@ query.limit(2).find(callbackQueue: .main) { results in
     }
 }
 
-// Query synchronously (not preferred - all operations on main queue).
+//: Query synchronously (not preferred - all operations on main queue).
 let results = try query.find()
 assert(results.count >= 1)
 results.forEach { (score) in
@@ -59,9 +65,9 @@ results.forEach { (score) in
     print("Found score: \(score)")
 }
 
-// Query first asynchronously (preferred way) - Performs work on background
-// queue and returns to designated on designated callbackQueue.
-// If no callbackQueue is specified it returns to main queue.
+//: Query first asynchronously (preferred way) - Performs work on background
+//: queue and returns to specified callbackQueue.
+//: If no callbackQueue is specified it returns to main queue.
 query.first { results in
     switch results {
     case .success(let score):

ParseSwift.playground/Pages/3 - User - Sign Up.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 PlaygroundPage.current.needsIndefiniteExecution = true
@@ -25,7 +31,7 @@ struct User: ParseUser {
 }
 
 /*: Sign up user asynchronously - Performs work on background
-    queue and returns to designated on designated callbackQueue.
+    queue and returns to specified callbackQueue.
     If no callbackQueue is specified it returns to main queue.
 */
 User.signup(username: "hello", password: "world") { results in

ParseSwift.playground/Pages/4 - User - Continued.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -47,24 +53,6 @@ struct GameScore: ParseObject {
     }
 }
 
-/*: Save your first customKey value to your `ParseUser`
-    Asynchrounously - Performs work on background
-    queue and returns to designated on designated callbackQueue.
-    If no callbackQueue is specified it returns to main queue.
-*/
-User.current?.customKey = "myCustom"
-User.current?.score = GameScore(score: 12)
-User.current?.targetScore = GameScore(score: 100)
-User.current?.save { results in
-
-    switch results {
-    case .success(let updatedUser):
-        print("Successfully save custom fields of User to ParseServer: \(updatedUser)")
-    case .failure(let error):
-        print("Failed to update user: \(error)")
-    }
-}
-
 //: Logging out - synchronously
 do {
     try User.logout()
@@ -74,7 +62,7 @@ do {
 }
 
 /*: Login - asynchronously - Performs work on background
-    queue and returns to designated on designated callbackQueue.
+    queue and returns to specified callbackQueue.
     If no callbackQueue is specified it returns to main queue.
 */
 User.login(username: "hello", password: "world") { results in
@@ -94,9 +82,27 @@ User.login(username: "hello", password: "world") { results in
     }
 }
 
+/*: Save your first `customKey` value to your `ParseUser`
+    Asynchrounously - Performs work on background
+    queue and returns to specified callbackQueue.
+    If no callbackQueue is specified it returns to main queue.
+*/
+User.current?.customKey = "myCustom"
+User.current?.score = GameScore(score: 12)
+User.current?.targetScore = GameScore(score: 100)
+User.current?.save { results in
+
+    switch results {
+    case .success(let updatedUser):
+        print("Successfully save custom fields of User to ParseServer: \(updatedUser)")
+    case .failure(let error):
+        print("Failed to update user: \(error)")
+    }
+}
+
 //: Looking at the output of user from the previous login, it only has
-//: a pointer to the `score`and `targetScore` fields. You can fetch using `include` to
-//: get the score.
+//: a pointer to the `score` and `targetScore` fields. You can
+//: fetch using `include` to get the score.
 User.current?.fetch(includeKeys: ["score"]) { result in
     switch result {
     case .success:

ParseSwift.playground/Pages/5 - ACL.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -40,7 +46,7 @@ var score = GameScore(score: 40)
 score.ACL = try? ParseACL.defaultACL()
 
 /*: Save asynchronously (preferred way) - Performs work on background
-    queue and returns to designated on designated callbackQueue.
+    queue and returns to specified callbackQueue.
     If no callbackQueue is specified it returns to main queue.
 */
 score.save { result in

ParseSwift.playground/Pages/6 - Installation.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -34,7 +40,7 @@ struct Installation: ParseInstallation {
 //: WARNING: All calls on Installation need to be done on the main queue
 DispatchQueue.main.async {
 
-    /*: Save your first customKey value to your `ParseInstallation`.
+    /*: Save your first `customKey` value to your `ParseInstallation`.
         Performs work on background queue and returns to designated on
         designated callbackQueue. If no callbackQueue is specified it
         returns to main queue.

ParseSwift.playground/Pages/7 - GeoPoint.xcplaygroundpage/Contents.swift

@@ -1,5 +1,11 @@
 //: [Previous](@previous)
 
+//: For this page, make sure your build target is set to ParseSwift (macOS) and targeting
+//: `My Mac` or whatever the name of your mac is. Also be sure your `Playground Settings`
+//: in the `File Inspector` is `Platform = macOS`. This is because
+//: Keychain in iOS Playgrounds behaves differently. Every page in Playgrounds should
+//: be set to build for `macOS` unless specified.
+
 import PlaygroundSupport
 import Foundation
 import ParseSwift
@@ -29,7 +35,7 @@ var score = GameScore(score: 10)
 score.location = ParseGeoPoint(latitude: 40.0, longitude: -30.0)
 
 /*: Save asynchronously (preferred way) - performs work on background
-    queue and returns to designated on designated callbackQueue.
+    queue and returns to specified callbackQueue.
     If no callbackQueue is specified it returns to main queue.
 */
 score.save { result in