feat: add ParseFile caching using download folder (#416)

* deprecate ParseCloud for ParseCloudable

* update project

* more pros updates

* add ParseFileManager helpers

* add caching and tests

Author: cbaker6

CHANGELOG.md

@@ -1,9 +1,15 @@
 # Parse-Swift Changelog
 
 ### main
-[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/4.13.1...main)
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/4.14.0...main)
 * _Contributing to this repo? Add info about your change here to be included in the next release_
 
+### 4.14.0
+[Full Changelog](https://github.com/parse-community/Parse-Swift/compare/4.13.1...4.14.0)
+
+__New features__
+- Add file caching using the Parse download folder ([#416](https://github.com/parse-community/Parse-Swift/pull/416)), thanks to [Corey Baker](https://github.com/cbaker6).
+
 ### 4.13.1
 [Full Changelog](https://github.com/parse-community/Parse-Swift/compare/4.13.0...4.13.1)
 

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

@@ -13,38 +13,38 @@ import ParseSwift
 PlaygroundPage.current.needsIndefiniteExecution = true
 initializeParse()
 
-//: Create your own value typed `ParseCloud` type.
-struct Hello: ParseCloud {
+//: Create your own value typed `ParseCloudable` type.
+struct Hello: ParseCloudable {
 
     //: Return type of your Cloud Function
     typealias ReturnType = String
 
-    //: These are required by `ParseCloud`, you can set the default value to make it easier
+    //: These are required by `ParseCloudable`, you can set the default value to make it easier
     //: to use.
     var functionJobName: String = "hello"
 }
 
-//: Create another `ParseCloud` type.
-struct TestCloudCode: ParseCloud {
+//: Create another `ParseCloudable` type.
+struct TestCloudCode: ParseCloudable {
 
     //: Return type of your Cloud Function
     typealias ReturnType = [String: Int]
 
-    //: These are required by `ParseCloud`, you can set the default value to make it easier
+    //: These are required by `ParseCloudable`, you can set the default value to make it easier
     //: to use.
     var functionJobName: String = "testCloudCode"
 
     //: If your cloud function takes arguments, they can be passed by creating properties:
     var argument1: [String: Int]
 }
 
-//: Create another `ParseCloud` type.
-struct TestCloudCodeError: ParseCloud {
+//: Create another `ParseCloudable` type.
+struct TestCloudCodeError: ParseCloudable {
 
     //: Return type of your Cloud Function
     typealias ReturnType = String
 
-    //: These are required by `ParseCloud`, you can set the default value to make it easier
+    //: These are required by `ParseCloudable`, you can set the default value to make it easier
     //: to use.
     var functionJobName: String = "testCloudCodeError"
 }

ParseSwift.xcodeproj/project.pbxproj

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1210"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/ParseSwift (iOS).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1210"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/ParseSwift (macOS).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1210"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/ParseSwift (tvOS).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1210"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/ParseSwift (watchOS).xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1300"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/TestHost.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "1300"
+   LastUpgradeVersion = "1400"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"

ParseSwift.xcodeproj/xcshareddata/xcschemes/TestHostTV.xcscheme

@@ -358,12 +358,10 @@ internal extension API.Command {
                     parseURL: object.url,
                     otherURL: object.cloudURL) { (data) -> ParseFile in
             let tempFileLocation = try ParseCoding.jsonDecoder().decode(URL.self, from: data)
-            guard let fileManager = ParseFileManager(),
-                  let defaultDirectoryPath = fileManager.defaultDataDirectoryPath else {
+            guard let fileManager = ParseFileManager() else {
                 throw ParseError(code: .unknownError, message: "Cannot create fileManager")
             }
-            let downloadDirectoryPath = defaultDirectoryPath
-                .appendingPathComponent(ParseConstants.fileDownloadsDirectory, isDirectory: true)
+            let downloadDirectoryPath = try ParseFileManager.downloadDirectory()
             try fileManager.createDirectoryIfNeeded(downloadDirectoryPath.relativePath)
             let fileNameURL = URL(fileURLWithPath: object.name)
             let fileLocation = downloadDirectoryPath.appendingPathComponent(fileNameURL.lastPathComponent)