4.6.0 release.

Author: Pranay Sowdaboina

README.md

@@ -131,7 +131,7 @@ To install the Dropbox Swift SDK via Carthage, you need to create a `Cartfile` i
 
 ```
 # SwiftyDropbox
-github "https://github.com/dropbox/SwiftyDropbox" ~> 4.5.0
+github "https://github.com/dropbox/SwiftyDropbox" ~> 4.6.0
 ```
 
 Then, run the following command to install the dependency to checkout and build the Dropbox Swift SDK repository:

Source/SwiftyDropbox/Platform/SwiftyDropbox_iOS/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>4.5.0</string>
+	<string>4.6.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSPrincipalClass</key>

Source/SwiftyDropbox/Platform/SwiftyDropbox_macOS/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>FMWK</string>
 	<key>CFBundleShortVersionString</key>
-	<string>4.5.0</string>
+	<string>4.6.0</string>
 	<key>CFBundleVersion</key>
 	<string>$(CURRENT_PROJECT_VERSION)</string>
 	<key>NSHumanReadableCopyright</key>

Source/SwiftyDropbox/Shared/Generated/Files.swift

@@ -5077,7 +5077,7 @@ open class Files {
     public enum UploadError: CustomStringConvertible {
         /// Unable to save the uploaded contents to a file.
         case path(Files.UploadWriteFailed)
-        /// The supplied property group is invalid.
+        /// The supplied property group is invalid. The file has uploaded without property groups.
         case propertiesError(FileProperties.InvalidPropertyGroupError)
         /// An unspecified error.
         case other
@@ -5130,7 +5130,7 @@ open class Files {
     public enum UploadErrorWithProperties: CustomStringConvertible {
         /// Unable to save the uploaded contents to a file.
         case path(Files.UploadWriteFailed)
-        /// The supplied property group is invalid.
+        /// The supplied property group is invalid. The file has uploaded without property groups.
         case propertiesError(FileProperties.InvalidPropertyGroupError)
         /// An unspecified error.
         case other
@@ -5496,8 +5496,11 @@ open class Files {
     public enum UploadSessionFinishError: CustomStringConvertible {
         /// The session arguments are incorrect; the value explains the reason.
         case lookupFailed(Files.UploadSessionLookupError)
-        /// Unable to save the uploaded contents to a file.
+        /// Unable to save the uploaded contents to a file. Data has already been appended to the upload session. Please
+        /// retry with empty data body and updated offset.
         case path(Files.WriteError)
+        /// The supplied property group is invalid. The file has uploaded without property groups.
+        case propertiesError(FileProperties.InvalidPropertyGroupError)
         /// The batch request commits files into too many different shared folders. Please limit your batch request to
         /// files contained in a single shared folder.
         case tooManySharedFolderTargets
@@ -5522,6 +5525,10 @@ open class Files {
                     var d = ["path": Files.WriteErrorSerializer().serialize(arg)]
                     d[".tag"] = .str("path")
                     return .dictionary(d)
+                case .propertiesError(let arg):
+                    var d = ["properties_error": FileProperties.InvalidPropertyGroupErrorSerializer().serialize(arg)]
+                    d[".tag"] = .str("properties_error")
+                    return .dictionary(d)
                 case .tooManySharedFolderTargets:
                     var d = [String: JSON]()
                     d[".tag"] = .str("too_many_shared_folder_targets")
@@ -5547,6 +5554,9 @@ open class Files {
                         case "path":
                             let v = Files.WriteErrorSerializer().deserialize(d["path"] ?? .null)
                             return UploadSessionFinishError.path(v)
+                        case "properties_error":
+                            let v = FileProperties.InvalidPropertyGroupErrorSerializer().deserialize(d["properties_error"] ?? .null)
+                            return UploadSessionFinishError.propertiesError(v)
                         case "too_many_shared_folder_targets":
                             return UploadSessionFinishError.tooManySharedFolderTargets
                         case "too_many_write_operations":
@@ -5574,6 +5584,9 @@ open class Files {
         case closed
         /// The session must be closed before calling upload_session/finish_batch.
         case notClosed
+        /// You can not append to the upload session because the size of a file should not reach the max file size limit
+        /// (i.e. 350GB).
+        case tooLarge
         /// An unspecified error.
         case other
 
@@ -5601,6 +5614,10 @@ open class Files {
                     var d = [String: JSON]()
                     d[".tag"] = .str("not_closed")
                     return .dictionary(d)
+                case .tooLarge:
+                    var d = [String: JSON]()
+                    d[".tag"] = .str("too_large")
+                    return .dictionary(d)
                 case .other:
                     var d = [String: JSON]()
                     d[".tag"] = .str("other")
@@ -5621,6 +5638,8 @@ open class Files {
                             return UploadSessionLookupError.closed
                         case "not_closed":
                             return UploadSessionLookupError.notClosed
+                        case "too_large":
+                            return UploadSessionLookupError.tooLarge
                         case "other":
                             return UploadSessionLookupError.other
                         default:
@@ -5729,7 +5748,8 @@ open class Files {
     open class UploadWriteFailed: CustomStringConvertible {
         /// The reason why the file couldn't be saved.
         open let reason: Files.WriteError
-        /// The upload session ID; this may be used to retry the commit.
+        /// The upload session ID; data has already been uploaded to the corresponding upload session and this ID may be
+        /// used to retry the commit with uploadSessionFinish.
         open let uploadSessionId: String
         public init(reason: Files.WriteError, uploadSessionId: String) {
             self.reason = reason

Source/SwiftyDropbox/Shared/Generated/FilesRoutes.swift

@@ -900,7 +900,8 @@ open class FilesRoutes {
         return client.request(route, serverArgs: serverArgs, input: .stream(input))
     }
 
-    /// Append more data to an upload session. A single request should not upload more than 150 MB.
+    /// Append more data to an upload session. A single request should not upload more than 150 MB. The maximum size of
+    /// a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter sessionId: The upload session ID (returned by uploadSessionStart).
     /// - parameter offset: The amount of data that has been uploaded so far. We use this to make sure upload data isn't
@@ -916,7 +917,8 @@ open class FilesRoutes {
         return client.request(route, serverArgs: serverArgs, input: .data(input))
     }
 
-    /// Append more data to an upload session. A single request should not upload more than 150 MB.
+    /// Append more data to an upload session. A single request should not upload more than 150 MB. The maximum size of
+    /// a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter sessionId: The upload session ID (returned by uploadSessionStart).
     /// - parameter offset: The amount of data that has been uploaded so far. We use this to make sure upload data isn't
@@ -932,7 +934,8 @@ open class FilesRoutes {
         return client.request(route, serverArgs: serverArgs, input: .file(input))
     }
 
-    /// Append more data to an upload session. A single request should not upload more than 150 MB.
+    /// Append more data to an upload session. A single request should not upload more than 150 MB. The maximum size of
+    /// a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter sessionId: The upload session ID (returned by uploadSessionStart).
     /// - parameter offset: The amount of data that has been uploaded so far. We use this to make sure upload data isn't
@@ -949,7 +952,8 @@ open class FilesRoutes {
     }
 
     /// Append more data to an upload session. When the parameter close is set, this call will close the session. A
-    /// single request should not upload more than 150 MB.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
@@ -965,7 +969,8 @@ open class FilesRoutes {
     }
 
     /// Append more data to an upload session. When the parameter close is set, this call will close the session. A
-    /// single request should not upload more than 150 MB.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
@@ -981,7 +986,8 @@ open class FilesRoutes {
     }
 
     /// Append more data to an upload session. When the parameter close is set, this call will close the session. A
-    /// single request should not upload more than 150 MB.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
@@ -997,7 +1003,7 @@ open class FilesRoutes {
     }
 
     /// Finish an upload session and save the uploaded data to the given file path. A single request should not upload
-    /// more than 150 MB.
+    /// more than 150 MB. The maximum size of a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter commit: Contains the path and other optional modifiers for the commit.
@@ -1012,7 +1018,7 @@ open class FilesRoutes {
     }
 
     /// Finish an upload session and save the uploaded data to the given file path. A single request should not upload
-    /// more than 150 MB.
+    /// more than 150 MB. The maximum size of a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter commit: Contains the path and other optional modifiers for the commit.
@@ -1027,7 +1033,7 @@ open class FilesRoutes {
     }
 
     /// Finish an upload session and save the uploaded data to the given file path. A single request should not upload
-    /// more than 150 MB.
+    /// more than 150 MB. The maximum size of a file one can upload to an upload session is 350 GB.
     ///
     /// - parameter cursor: Contains the upload session ID and the offset.
     /// - parameter commit: Contains the path and other optional modifiers for the commit.
@@ -1045,11 +1051,11 @@ open class FilesRoutes {
     /// uploadSessionAppendV2 to upload file contents. We recommend uploading many files in parallel to increase
     /// throughput. Once the file contents have been uploaded, rather than calling uploadSessionFinish, use this route
     /// to finish all your upload sessions in a single request. close in UploadSessionStartArg or close in
-    /// UploadSessionAppendArg needs to be true for the last uploadSessionStart or uploadSessionAppendV2 call. This
-    /// route will return a job_id immediately and do the async commit job in background. Use
-    /// uploadSessionFinishBatchCheck to check the job status. For the same account, this route should be executed
-    /// serially. That means you should not start the next job before current job finishes. We allow up to 1000 entries
-    /// in a single request.
+    /// UploadSessionAppendArg needs to be true for the last uploadSessionStart or uploadSessionAppendV2 call. The
+    /// maximum size of a file one can upload to an upload session is 350 GB. This route will return a job_id
+    /// immediately and do the async commit job in background. Use uploadSessionFinishBatchCheck to check the job
+    /// status. For the same account, this route should be executed serially. That means you should not start the next
+    /// job before current job finishes. We allow up to 1000 entries in a single request.
     ///
     /// - parameter entries: Commit information for each file in the batch.
     ///
@@ -1078,9 +1084,10 @@ open class FilesRoutes {
     /// Upload sessions allow you to upload a single file in one or more requests, for example where the size of the
     /// file is greater than 150 MB.  This call starts a new upload session with the given data. You can then use
     /// uploadSessionAppendV2 to add more data and uploadSessionFinish to save all the data to a file in Dropbox. A
-    /// single request should not upload more than 150 MB. An upload session can be used for a maximum of 48 hours.
-    /// Attempting to use an sessionId in UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish
-    /// more than 48 hours after its creation will return a notFound in UploadSessionLookupError.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB. An upload session can be used for a maximum of 48 hours. Attempting to use an sessionId in
+    /// UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish more than 48 hours after its creation
+    /// will return a notFound in UploadSessionLookupError.
     ///
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
     /// uploadSessionAppendV2 anymore with the current session.
@@ -1097,9 +1104,10 @@ open class FilesRoutes {
     /// Upload sessions allow you to upload a single file in one or more requests, for example where the size of the
     /// file is greater than 150 MB.  This call starts a new upload session with the given data. You can then use
     /// uploadSessionAppendV2 to add more data and uploadSessionFinish to save all the data to a file in Dropbox. A
-    /// single request should not upload more than 150 MB. An upload session can be used for a maximum of 48 hours.
-    /// Attempting to use an sessionId in UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish
-    /// more than 48 hours after its creation will return a notFound in UploadSessionLookupError.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB. An upload session can be used for a maximum of 48 hours. Attempting to use an sessionId in
+    /// UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish more than 48 hours after its creation
+    /// will return a notFound in UploadSessionLookupError.
     ///
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
     /// uploadSessionAppendV2 anymore with the current session.
@@ -1116,9 +1124,10 @@ open class FilesRoutes {
     /// Upload sessions allow you to upload a single file in one or more requests, for example where the size of the
     /// file is greater than 150 MB.  This call starts a new upload session with the given data. You can then use
     /// uploadSessionAppendV2 to add more data and uploadSessionFinish to save all the data to a file in Dropbox. A
-    /// single request should not upload more than 150 MB. An upload session can be used for a maximum of 48 hours.
-    /// Attempting to use an sessionId in UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish
-    /// more than 48 hours after its creation will return a notFound in UploadSessionLookupError.
+    /// single request should not upload more than 150 MB. The maximum size of a file one can upload to an upload
+    /// session is 350 GB. An upload session can be used for a maximum of 48 hours. Attempting to use an sessionId in
+    /// UploadSessionStartResult with uploadSessionAppendV2 or uploadSessionFinish more than 48 hours after its creation
+    /// will return a notFound in UploadSessionLookupError.
     ///
     /// - parameter close: If true, the current session will be closed, at which point you won't be able to call
     /// uploadSessionAppendV2 anymore with the current session.

Source/SwiftyDropbox/Shared/Generated/PaperRoutes.swift

@@ -127,8 +127,8 @@ open class PaperRoutes {
 
     /// Retrieves folder information for the given Paper doc. This includes:   - folder sharing policy; permissions for
     /// subfolders are set by the top-level folder.   - full 'filepath', i.e. the list of folders (both folderId and
-    /// folderName) from the root folder to the folder directly containing the Paper doc.  Note: If the Paper doc is not
-    /// in any folder (aka unfiled) the response will be empty.
+    /// folderName) from     the root folder to the folder directly containing the Paper doc.  Note: If the Paper doc is
+    /// not in any folder (aka unfiled) the response will be empty.
     ///
     /// - parameter docId: The Paper doc ID.
     ///