Merge branch 'main' into add-migration-guide

Author: mtrezza

.codecov.yml

@@ -6,7 +6,7 @@ coverage:
   status:
     patch:
       default:
-        target: 33
+        target: auto
     changes: false
     project:
       default:

.swiftlint.yml

@@ -5,6 +5,7 @@ disabled_rules:
   - type_body_length
   - inclusive_language
   - comment_spacing
+  - identifier_name
 excluded: # paths to ignore during linting. Takes precedence over `included`.
   - Tests/ParseSwiftTests/ParseEncoderTests
   - DerivedData

CHANGELOG.md

@@ -27,7 +27,7 @@ Together we will plan out the best conceptual approach for your contribution, so
 
 When you are ready to code, you can find more information about opening a pull request in the [GitHub docs](https://help.github.com/articles/creating-a-pull-request/).
 
-Whether this is your first contribution or you are already an experienced contributor, the Parse Community has your back – don't hesitate to ask for help!
+Whether this is your first contribution or you are already an experienced contributor, the Parse Community has your back – do not hesitate to ask for help!
 
 ## Why Contributing?
 

CONTRIBUTING.md

@@ -121,7 +121,7 @@ score.save { result in
         assert(savedScore.points == 10)
 
         /*: To modify, need to make it a var as the value type
-            was initialized as immutable. Using `mutable`
+            was initialized as immutable. Using `mergeable`
             allows you to only send the updated keys to the
             parse server as opposed to the whole object.
         */
@@ -195,7 +195,7 @@ var score2ForFetchedLater: GameScore?
     }
 }*/
 
-//: Save synchronously (not preferred - all operations on main queue).
+//: Save synchronously (not preferred - all operations on current queue).
 let savedScore: GameScore?
 do {
     savedScore = try score.save()
@@ -211,7 +211,7 @@ assert(savedScore?.updatedAt != nil)
 assert(savedScore?.points == 10)
 
 /*:  To modify, need to make it a var as the value type
-    was initialized as immutable. Using `mutable`
+    was initialized as immutable. Using `mergeable`
     allows you to only send the updated keys to the
     parse server as opposed to the whole object.
 */
@@ -274,7 +274,7 @@ do {
 //: Now we will fetch a ParseObject that has already been saved based on its' objectId.
 let scoreToFetch = GameScore(objectId: savedScore?.objectId)
 
-//: Asynchronously (preferred way) fetch this GameScore based on it's objectId alone.
+//: Asynchronously (preferred way) fetch this GameScore based on it is objectId alone.
 scoreToFetch.fetch { result in
     switch result {
     case .success(let fetchedScore):
@@ -284,7 +284,7 @@ scoreToFetch.fetch { result in
     }
 }
 
-//: Synchronously fetch this GameScore based on it's objectId alone.
+//: Synchronously fetch this GameScore based on it is objectId alone.
 do {
     let fetchedScore = try scoreToFetch.fetch()
     print("Successfully fetched: \(fetchedScore)")
@@ -295,7 +295,7 @@ do {
 //: Now we will fetch `ParseObject`'s in batch that have already been saved based on its' objectId.
 let score2ToFetch = GameScore(objectId: score2ForFetchedLater?.objectId)
 
-//: Asynchronously (preferred way) fetch GameScores based on it's objectId alone.
+//: Asynchronously (preferred way) fetch GameScores based on it is objectId alone.
 [scoreToFetch, score2ToFetch].fetchAll { result in
     switch result {
     case .success(let fetchedScores):
@@ -315,7 +315,7 @@ let score2ToFetch = GameScore(objectId: score2ForFetchedLater?.objectId)
 
 var fetchedScore: GameScore!
 
-//: Synchronously fetchAll GameScore's based on it's objectId's alone.
+//: Synchronously fetchAll GameScore's based on it is objectId's alone.
 do {
     let fetchedScores = try [scoreToFetch, score2ToFetch].fetchAll()
     fetchedScores.forEach { result in
@@ -331,7 +331,7 @@ do {
     assertionFailure("Error fetching: \(error)")
 }
 
-//: Asynchronously (preferred way) deleteAll GameScores based on it's objectId alone.
+//: Asynchronously (preferred way) deleteAll GameScores based on it is objectId alone.
 [scoreToFetch, score2ToFetch].deleteAll { result in
     switch result {
     case .success(let deletedScores):
@@ -348,7 +348,7 @@ do {
     }
 }
 
-//: Synchronously deleteAll GameScore's based on it's objectId's alone.
+//: Synchronously deleteAll GameScore's based on it is objectId's alone.
 //: Commented out because the async above deletes the items already.
 /* do {
     let fetchedScores = try [scoreToFetch, score2ToFetch].deleteAll()

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

@@ -109,10 +109,10 @@ var savedRole: Role<User>?
 
 //: Now we will create the Role.
 guard let currentUser = User.current else {
-    fatalError("User currently isn't signed in")
+    fatalError("User currently is not signed in")
 }
 
-//: Every Role requires an ACL that can't be changed after saving.
+//: Every Role requires an ACL that cannot be changed after saving.
 var acl = ParseACL()
 acl.setReadAccess(user: currentUser, value: true)
 acl.setWriteAccess(user: currentUser, value: true)
@@ -312,7 +312,7 @@ let score2 = GameScore(points: 57)
             print(error)
         }
     case .failure(let error):
-        print("Couldn't save scores. \(error)")
+        print("Could not save scores. \(error)")
     }
 }
 

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

@@ -55,7 +55,7 @@ config.save { result in
     }
 }
 
-//: Fetch the updated config to make sure it's saved.
+//: Fetch the updated config to make sure it is saved.
 config.fetch { result in
     switch result {
     case .success(let currentConfig):
@@ -65,7 +65,7 @@ config.fetch { result in
     }
 }
 
-//: Anytime you fetch or update your Config successfully, it's automatically saved to your Keychain.
+//: Anytime you fetch or update your Config successfully, it is automatically saved to your Keychain.
 print(Config.current ?? "No config")
 
 PlaygroundPage.current.finishExecution()

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

@@ -75,7 +75,7 @@ score.save { result in
         assert(savedScore.updatedAt != nil)
         assert(savedScore.points == 10)
 
-        //: Now that this object has a `createdAt`, it's properly saved to the server.
+        //: Now that this object has a `createdAt`, it is properly saved to the server.
         //: Any changes to `createdAt` and `objectId` will not be saved to the server.
         print("Saved score: \(savedScore)")
 
@@ -123,10 +123,10 @@ query.first { result in
     }
 }
 
-//: Now we will attempt to fetch a ParseObject that isn't saved.
+//: Now we will attempt to fetch a ParseObject that is not saved.
 let scoreToFetch = GameScore(objectId: "hello")
 
-//: Asynchronously (preferred way) fetch this GameScore based on it's objectId alone.
+//: Asynchronously (preferred way) fetch this GameScore based on it is objectId alone.
 scoreToFetch.fetch { result in
     switch result {
     case .success(let fetchedScore):

ParseSwift.playground/Pages/15 - Custom ObjectId.xcplaygroundpage/Contents.swift

@@ -4,7 +4,7 @@
 //: 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
+//: SwiftUI in macOS Playgrounds does not seem to build correctly
 //: Be sure to switch your target and `Playground Settings` back to
 //: macOS after leaving this page.
 

ParseSwift.playground/Pages/17 - SwiftUI - Finding Objects.xcplaygroundpage/Contents.swift

@@ -4,7 +4,7 @@
 //: 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
+//: SwiftUI in macOS Playgrounds does not seem to build correctly
 //: Be sure to switch your target and `Playground Settings` back to
 //: macOS after leaving this page.
 

ParseSwift.playground/Pages/18 - SwiftUI - Finding Objects With Custom ViewModel.xcplaygroundpage/Contents.swift

@@ -4,7 +4,7 @@
 //: 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
+//: SwiftUI in macOS Playgrounds does not seem to build correctly
 //: Be sure to switch your target and `Playground Settings` back to
 //: macOS after leaving this page.
 

ParseSwift.playground/Pages/19 - SwiftUI - LiveQuery.xcplaygroundpage/Contents.swift

@@ -89,7 +89,7 @@ query.limit(2)
     }
 }
 
-//: Query synchronously (not preferred - all operations on main queue).
+//: Query synchronously (not preferred - all operations on current queue).
 let results = try query.find()
 assert(results.count >= 1)
 results.forEach { score in

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

@@ -127,7 +127,7 @@ do {
                   type: .array,
                   options: ParseFieldOptions<[User]>(required: false, defauleValue: nil))
 } catch {
-    print("Can't add field: \(gameScoreSchema)")
+    print("Cannot add field: \(gameScoreSchema)")
 }
 
 //: Now lets create the schema on the server.
@@ -136,7 +136,7 @@ gameScoreSchema.create { result in
     case .success(let savedSchema):
         print("Check GameScore2 in Dashboard. \nThe created schema:  \(savedSchema)")
     case .failure(let error):
-        print("Couldn't save schema: \(error)")
+        print("Could not save schema: \(error)")
     }
 }
 
@@ -157,7 +157,7 @@ gameScoreSchema.update { result in
          */
         gameScoreSchema = updatedSchema
     case .failure(let error):
-        print("Couldn't update schema: \(error)")
+        print("Could not update schema: \(error)")
     }
 }
 
@@ -174,7 +174,7 @@ gameScoreSchema.update { result in
          */
         gameScoreSchema = updatedSchema
     case .failure(let error):
-        print("Couldn't update schema: \(error)")
+        print("Could not update schema: \(error)")
     }
 }
 
@@ -184,13 +184,13 @@ gameScoreSchema.fetch { result in
     case .success(let fetchedGameScore):
         print("The fetched GameScore2 schema is: \(fetchedGameScore)")
     case .failure(let error):
-        print("Couldn't fetch schema: \(error)")
+        print("Could not fetch schema: \(error)")
     }
 }
 
 /*:
  Fields can also be deleted on a schema. Lets remove
- the **data** field since it's not going being used.
+ the **data** field since it is not going being used.
 */
 gameScoreSchema = gameScoreSchema.deleteField("data")
 
@@ -204,7 +204,7 @@ gameScoreSchema.update { result in
          */
         gameScoreSchema = updatedSchema
     case .failure(let error):
-        print("Couldn't update schema: \(error)")
+        print("Could not update schema: \(error)")
     }
 }
 
@@ -228,7 +228,7 @@ gameScoreSchema.update { result in
          */
         gameScoreSchema = updatedSchema
     case .failure(let error):
-        print("Couldn't update schema: \(error)")
+        print("Could not update schema: \(error)")
     }
 }
 
@@ -242,7 +242,7 @@ gameScore.save { result in
     case .success(let savedGameScore):
         print("The saved GameScore is: \(savedGameScore)")
     case .failure(let error):
-        print("Couldn't save schema: \(error)")
+        print("Could not save schema: \(error)")
     }
 }
 
@@ -252,20 +252,20 @@ gameScoreSchema.purge { result in
     case .success:
         print("All objects have been purged from this schema.")
     case .failure(let error):
-        print("Couldn't purge schema: \(error)")
+        print("Could not purge schema: \(error)")
     }
 }
 
 /*:
- As long as there's no data in your `ParseSchema` you can
+ As long as there is no data in your `ParseSchema` you can
  delete the schema.
 */
  gameScoreSchema.delete { result in
     switch result {
     case .success:
         print("The schema has been deleted.")
     case .failure(let error):
-        print("Couldn't delete the schema: \(error)")
+        print("Could not delete the schema: \(error)")
     }
 }
 

ParseSwift.playground/Pages/20 - Cloud Schemas.xcplaygroundpage/Contents.swift

@@ -76,17 +76,17 @@ push.send { result in
         //: Update the stored property with the lastest status id.
         pushStatusId = statusId
     case .failure(let error):
-        print("Couldn't create push: \(error)")
+        print("Could not create push: \(error)")
     }
 }
 
-//: You can fetch the status of notificaiton if you know it's id.
+//: You can fetch the status of notificaiton if you know it is id.
 push.fetchStatus(pushStatusId) { result in
     switch result {
     case .success(let pushStatus):
         print("The push status is: \"\(pushStatus)\"")
     case .failure(let error):
-        print("Couldn't fetch push status: \(error)")
+        print("Could not fetch push status: \(error)")
     }
 }
 
@@ -110,7 +110,7 @@ push2.send { result in
         //: Update the stored property with the lastest status id.
         pushStatusId = statusId
     case .failure(let error):
-        print("Couldn't create push: \(error)")
+        print("Could not create push: \(error)")
     }
 }
 
@@ -123,7 +123,7 @@ push2.fetchStatus(pushStatusId) { result in
     case .success(let pushStatus):
         print("The push status is: \"\(pushStatus)\"")
     case .failure(let error):
-        print("Couldn't fetch push status: \(error)")
+        print("Could not fetch push status: \(error)")
     }
 }
 
@@ -143,7 +143,7 @@ push3.send { result in
         //: Update the stored property with the lastest status id.
         pushStatusId = statusId
     case .failure(let error):
-        print("Couldn't create push: \(error)")
+        print("Could not create push: \(error)")
     }
 }
 
@@ -156,7 +156,7 @@ push3.fetchStatus(pushStatusId) { result in
     case .success(let pushStatus):
         print("The Firebase push status is: \"\(pushStatus)\"")
     case .failure(let error):
-        print("Couldn't fetch push status: \(error)")
+        print("Could not fetch push status: \(error)")
     }
 }
 
@@ -177,7 +177,7 @@ query.findAll(options: [.useMasterKey]) { result in
     case .success(let pushStatus):
         print("All matching statuses: \"\(pushStatus)\"")
     case .failure(let error):
-        print("Couldn't perform query: \(error)")
+        print("Could not perform query: \(error)")
     }
 }
 

ParseSwift.playground/Pages/21 - Cloud Push Notifications.xcplaygroundpage/Contents.swift

@@ -149,7 +149,7 @@ currentUser?.save { result in
 
     switch result {
     case .success(let updatedUser):
-        print("Successfully save custom fields of User to ParseServer: \(updatedUser)")
+        print("Successfully saved custom fields of User to ParseServer: \(updatedUser)")
     case .failure(let error):
         print("Failed to update user: \(error)")
     }

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

@@ -77,7 +77,7 @@ installationToUpdate?.save { results in
 
     switch results {
     case .success(let updatedInstallation):
-        print("Successfully save myCustomInstallationKey to ParseServer: \(updatedInstallation)")
+        print("Successfully saved myCustomInstallationKey to ParseServer: \(updatedInstallation)")
     case .failure(let error):
         print("Failed to update installation: \(error)")
     }