Swift Rewrite of TUSKit

An iOS client written in Swift for tus resumable upload protocol.

Simple Example

//TODO: Fill example here

Contributing

Please take a peak at our contributing guidelines for issues and PRs!

Usage

Installation

Before using TUSKit, you must configure your TUSClient using TUSClient.setup(). It is recommended to put this in your AppDelegate.

Parameters

uploadURL : The upload URL that TUSKit should upload to
sessionConfiguration: A URLSessionConfiguration that TUSKit will use for it's network sessions. URLSessionConfiguration.default will be used if omitted.

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.
    var config = TUSConfig(withUploadURLString: "https://master.tus.io/files", andSessionConfig: URLSessionConfiguration.default)
    TUSClient.setup(with: config)
    return true
}

Logging

An optional property can be set to allow TUSKit to log to the console, in order to help you debug or just for better insight to the actions taking place

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    // Override point for customization after application launch.
    var config = TUSConfig(withUploadURLString: "https://master.tus.io/files", andSessionConfig: URLSessionConfiguration.default)
    config.debugLogEnabled = true // Set logging on
    TUSClient.setup(with: config)
    return true
}

Example output logs

TUSKit: Creating file image49 on server
TUSKit: File image49 created
TUSKit: Preparing upload data for file image49
TUSKit: Upload starting for file image49

TUSUpload

An object that holds your uploads data and state. It can be created from a file, data or referenced with just an Id.

//A new upload for a file
var uploadObject = TUSUpload(withId: "Some Id to reference a file", andFile: "FilePathHere")

//A new upload for data
var uploadObject = TUSUpload(withId: "Another Id to reference a file", andData: DataObject)

//An existing upload
var uploadObject = TUSUpload(withId: "Just an ID of a past upload") //Will fail out if data on the device matching the ID isn't found.

//An upload with metadata
var uploadObject = TUSUpload(withId: "Some Id to reference a file", andFile: "FilePathHere")
uploadObject.metadata = ["hello": "world"]

TUSClient

TUSClient is a singleton used to communicate from your application to your TUS server. It will handle all file creation, uploads, and other operations alike.

Create

You can create an upload and start the upload process by passing an upload object.

Parameters

optional withRetries: The number of silent retries to take place before failing out to the delegate

TUSClient.shared.createOrResume(uploadObject) //Create and start upload
TUSClient.shared.createOrResume(uploadObject, withRetries: 3) //Create and start upload

Pause

You can pause a specific upload, or all uploads. If an upload is paused, it will not be deleted when running the cleanUp() method.

TUSClient.shared.pause(uploadObject) //Pause a specific upload
TUSClient.shared.pauseAll() //Pause all uploads

Resume

You can resume a specific upload, or all uploads that have previously been paused- not canceled or failed. If an upload is resumed it will resume the upload from where it last left off.

TUSClient.shared.createOrResume(uploadObject) //Resume a specific upload
TUSClient.shared.resumeAll() //Resume all uploads

Retry

You can retry a specific upload, or all uploads that have previously been canceled or failed - not paused. If an upload is retired it will attempt to create the file on your TUS server, if already existing it will begin or resume the upload from where it last left off.

TUSClient.shared.retry(uploadObject) //retry a specific upload
TUSClient.shared.retryAll() //retry all uploads

Cancel

You can cancel and suspend a specific upload, or all uploads. Canceling an upload will terminate the upload process until retried or cleaned up.

TUSClient.shared.cancel(uploadObject) //Cancel a specific upload
TUSClient.shared.cancelAll() //Cancel all uploads

Clean Up

You can clean up and clear all failed, and canceled uploads or a specific upload from your applications disk-space and memory. After cleanup your file data will no longer be on the device, but the file and any previously uploaded data may still be present on your TUS server.

TUSClient.shared.cleanUp(uploadObject) //cleanup all
TUSClient.shared.cleanUpAll() //cleanup all

Delegate

Progress

You can track the progress of specific uploads, or all uploads

func TUSProgress(bytesUploaded, bytesRemaining) //overall current upload progress
func TUSProgress(TUSUpload, bytesUploaded, bytesRemaining) //Per file upload progress

Success

The delegate method when a file successfully uploads

func TUSSuccess(TUSUpload, TUSResponse)

Failure

The delegate method fire when a file stops (canceled, failure, or paused)

func TUSFailure(TUSUpload, TUSResponse)

Contributors

Made with contributors-img.

marvukusic / TUSKit