Add cloud function/job calls and user password reset. (#43)

* Add cloud function/job calls and user password reset.

- Also adds more command tests for User and cleans up user docs

* Fixed bug. Make sure the right encoders are always used

* Add results response for Cloud Code

* Clean up docs

* Fix Password Reset error. Add playgrounds example

* Fix CloudCode server response error

* Add Cloud function/job error tests

* Improve server error responses (established priority of errors).

- Added ResultsResponse for explain and hint

* Bug fix: User logout was calling incorrect endpoint for server

* Clean up docs

* Added direct calls to Users and Installations endpoints. Added requestEmiailVerificaiton

* Fixed URL error

* Bump codecov

* Update Sources/ParseSwift/Types/ParseFile.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Types/ParseFile.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Types/ParseFile.swift

Co-authored-by: Tom Fox <[email protected]>

* Resolve review, fix playground project

* Fix backwards compatability with Swift < 5.3. Add a build to CI for Swift 5.2

* make Swift 5.2 build go after others

* make other CI builds go after watchOS build since it never tests

* Add LocallyIdentifiable protocol

* wip

* Improved batch and encoder

* Remove json encoder from ParseEncoder

* Reduce codecov

* Update .codecov.yml

* clean up

* Improve LocallyIdentifiable protocol, change file structure of project

* Save for later: ParseObject with localID, but doesn't work. This will be reverted back

* cleaned up code

* Switch to localId

* Batch in waves of 50 by default.

* Update Sources/ParseSwift/Objects/ParseObject.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseObject.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseObject.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseInstallation.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseInstallation.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseInstallation.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseInstallation.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseUser.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseUser.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseUser.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseObject.swift

Co-authored-by: Tom Fox <[email protected]>

* Update Sources/ParseSwift/Objects/ParseUser.swift

Co-authored-by: Tom Fox <[email protected]>

Co-authored-by: Tom Fox <[email protected]>

Author: cbaker6

.codecov.yml

@@ -5,10 +5,10 @@ coverage:
   status:
     patch:
       default:
-        target: auto
+        target: 73
     changes: false
     project:
       default:
-        target: 72
+        target: 74
 comment:
   require_changes: true

.github/workflows/ci.yml

@@ -66,9 +66,29 @@ jobs:
       run: xcrun llvm-cov export -format="lcov" .build/debug/ParseSwiftPackageTests.xctest/Contents/MacOS/ParseSwiftPackageTests -instr-profile .build/debug/codecov/default.profdata > info.lcov
     - name: Send codecov
       run: bash <(curl https://codecov.io/bash)
-      
+
+  spm-test-5_2:
+    needs: xcode-build-watchos
+    runs-on: macos-latest
+    steps:
+    - uses: actions/checkout@v2
+    - name: Create and set the default keychain
+      run: |
+        security create-keychain -p "" temporary
+        security default-keychain -s temporary
+        security unlock-keychain -p "" temporary
+        security set-keychain-settings -lut 7200 temporary
+    - name: Build
+      run: swift build -v
+      env:
+          DEVELOPER_DIR: ${{ env.CI_XCODE_VER }}
+    - name: Test
+      run: swift test --enable-code-coverage -v
+      env:
+          DEVELOPER_DIR: ${{ env.CI_XCODE_VER }}
+
   docs:
-    needs: spm-test
+    needs: xcode-build-watchos
     runs-on: macos-latest
     steps:
       - uses: actions/checkout@v2
@@ -94,15 +114,15 @@ jobs:
           publish_dir: ./docs
 
   cocoapods:
-    needs: spm-test
+    needs: xcode-build-watchos
     runs-on: macos-latest
     steps:
       - uses: actions/checkout@v2
       - name: CocoaPods
         run: pod lib lint --allow-warnings
 
   carthage:
-   needs: spm-test
+   needs: xcode-build-watchos
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v2

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

@@ -0,0 +1,38 @@
+//: [Previous](@previous)
+
+import PlaygroundSupport
+import Foundation
+import ParseSwift
+
+PlaygroundPage.current.needsIndefiniteExecution = true
+initializeParse()
+
+//: Create your own ValueTyped ParseCloud type
+struct Cloud: ParseCloud {
+    //: These are required for Object
+    var functionJobName: String
+
+    //: If your cloud function takes arguments, they can be passed by creating properties
+    //var argument1: [String: Int] = ["test": 5]
+}
+
+/*: Assuming you have the Cloud Function named "hello" on your parse-server:
+     // main.js
+     Parse.Cloud.define('hello', async () => {
+       return 'Hello world!';
+     });
+ */
+let cloud = Cloud(functionJobName: "hello")
+
+cloud.callFunction { result in
+    switch result {
+    case .success(let response):
+        print("Response from cloud function: \(response)")
+    case .failure(let error):
+        assertionFailure("Error calling cloud function: \(error)")
+    }
+}
+
+//: Jobs can be run the same way by using the method `callJob()`
+
+//: [Next](@next)

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

@@ -35,7 +35,7 @@ User.current?.save { results in
     case .success(let updatedUser):
         print("Successfully save myCustomKey to ParseServer: \(updatedUser)")
     case .failure(let error):
-        assertionFailure("Failed to update user: \(error)")
+        print("Failed to update user: \(error)")
     }
 }
 
@@ -44,7 +44,7 @@ do {
     try User.logout()
     print("Successfully logged out")
 } catch let error {
-    assertionFailure("Error logging out: \(error)")
+    print("Error logging out: \(error)")
 }
 
 /*: Login - asynchronously - Performs work on background
@@ -64,7 +64,7 @@ User.login(username: "hello", password: "world") { results in
         print("Successfully logged in as user: \(user)")
 
     case .failure(let error):
-        assertionFailure("Error logging in: \(error)")
+        print("Error logging in: \(error)")
     }
 }
 
@@ -73,7 +73,23 @@ do {
     try User.logout()
     print("Successfully logged out")
 } catch let error {
-    assertionFailure("Error logging out: \(error)")
+    print("Error logging out: \(error)")
+}
+
+//: Password Reset Request - synchronously
+do {
+    try User.verificationEmailRequest(email: "[email protected]")
+    print("Successfully requested verification email be sent")
+} catch let error {
+    print("Error requesting verification email be sent: \(error)")
+}
+
+//: Password Reset Request - synchronously
+do {
+    try User.passwordReset(email: "[email protected]")
+    print("Successfully requested password reset")
+} catch let error {
+    print("Error requesting password reset: \(error)")
 }
 
 //: Another way to sign up
@@ -88,7 +104,7 @@ newUser.signup { result in
         print("Parse signup successful: \(user)")
 
     case .failure(let error):
-        assertionFailure("Error logging in: \(error)")
+        print("Error logging in: \(error)")
     }
 }
 

ParseSwift.playground/Pages/9 - Files.xcplaygroundpage/Contents.swift

@@ -90,7 +90,7 @@ score.save { result in
     }
 }
 
-/*: Files can also be saved from data. Below is how to do it synchrously, but async is similar to above
+/*: Files can also be saved from data. Below is how to do it synchronously, but async is similar to above
  Create a new ParseFile for your data
  */
 let sampleData = "Hello World".data(using: .utf8)!
@@ -116,7 +116,7 @@ do {
         print("The file is saved to your Parse Server at: \(url)")
         print("The full details of your data file are: \(myData)")
 
-        //: If you need to download your profilePicture
+        //: If you need to download your file
         let fetchedFile = try myData.fetch()
         if fetchedFile.localURL != nil {
             print("The file is now saved at: \(fetchedFile.localURL!)")

ParseSwift.playground/contents.xcplayground

@@ -10,5 +10,6 @@
         <page name='7 - GeoPoint'/>
         <page name='8 - Pointers'/>
         <page name='9 - Files'/>
+        <page name='10 - Cloud Code'/>
     </pages>
 </playground>