nghialv / transporter

A tiny library makes uploading and downloading easier

Features

• uploading/downloading multiple files concurrently or sequentially
  • grouping tasks with awesome custom operators (||| and -->)
• supports background uploading/downloading
• supports progress tracking (single task and group of tasks)
• enable to resume, pause, cancel, retry the task
• header configurable
• request parameters configurable

Quick example

let path = NSBundle.mainBundle().pathForResource("bigfile", ofType: "zip")
let fileUrl = NSURL(fileURLWithPath: path!)!

let task = UploadTask(url: "http://server.com", file: fileUrl)
	.progress { sent, total in
		let per = Double(sent) / Double(total)
		println("uploading: \(per)")
	}
	.completed { response, json, error in
		println("completed")
	}

 
 Transporter.add(task1 ||| task2 ||| task3)                     // concurrent tasks
            .progress { bytes, total in
                let per = Double(bytes) / Double(total)
                println("concurrent tasks: \(per)")
            }
            .completed { alltasks in
                println("task1, task2, task3: completed")
            }
            .add(task4 --> task5 --> task6)                       // sequential tasks 
            .progress { bytes, total in
                println("serial tasks")
            }
            .resume()

Usage

// downloading task

let task = DownloadTask(url: downloadUrl, destination: des)
	.progress { bytes, total in
		let per = Double(bytes) / Double(total)
		println("downloading: \(per)")
	}
	.completed { response, _, error in
		println("completed")
	}


// uploading task
// upload types: File, Data, Stream

let task = UploadTask(url: "http://server.com", data: uploadData)
	.progress { sent, total in
		let per = Double(sent) / Double(total)
		println("uploading: \(per)")
	}
	.completed { response, json, error in
		println("completed")
	}


// using  `|||`  operator to create a group of concurrent tasks

Transporter.add(task1 ||| task2 ||| task3)

// using  `-->`  operator to create a group of sequential tasks

Transporter.add(task1 --> task2 --> task3)


// task

task.headers = ["key": "value"]
task.params = ["key": "value"]
task.pause()
task.cancel()
task.retry

// background handling
// add the following method in the app delegate

func application(application: UIApplication, handleEventsForBackgroundURLSession identifier: String, completionHandler: () -> Void) {
	Transporter.handleEventsForBackgroundURLSection(identifier, completionHandler: completionHandler)
}


// Transporter configurations

Transporter.headers = [key: value]
Transporter.timeoutIntervalForRequest = 30.0
Transporter.timeoutIntervalForResource = 24 * 60 * 60.0
Transporter.HTTPMaximumconnectionsPerHost = 5
			

Installation

• Installation with CocoaPods

pod 'TransporterSwift', '0.1.1'

Then run the following command:

pod install

• Copying all the files into your project
• Using submodule

Todo

• retry, pause, cancel
• validation

Requirements

• iOS 8.0+
• Xcode 6.1

License

Transporter is released under the MIT license. See LICENSE for details.

transporter's Issues

Upload file php script

Can you provide PHP/server side script for uploading file?

Platform minimum requirement documented as ios 7.0+, but required ios 8.0 from podspec file

While into file TransporterSwift.podspec there's a deployment target valued to "8.0", on README.md is stated the library is compatible with ios 7.0+
I this you should update README.md file to match requirements stated within podspec.

[Session] a session task did complete with error : nil

[Session] a session task did complete with error : nil

is what you get when trying to create a download task...

Waiting for Objective C version

Please provide this library for objective c so old projects can also be get benefited from this

Problem with downloaded files not created in your Example

After a successfull download, my files are not created in des directory, so i changed this :

let documentsPath: AnyObject = NSSearchPathForDirectoriesInDomains(.DocumentDirectory,.UserDomainMask,true)[0]
let des =  NSURL(string: documentsPath.stringByAppendingString("/file.pdf"))!

By this :

let fileManager = NSFileManager.defaultManager()
let documentsPath: NSURL = fileManager.URLsForDirectory(.DocumentDirectory,inDomains: .UserDomainMask)[0] as NSURL
let des =  documentsPath.URLByAppendingPathComponent("/file.pdf")

And everytings worked perfectly.

upload issue!! I want to send json data

Thank you for your good code.
I can work veryyyy useful for this good code
I have one question.
I try to use upload function. simultaniously I send json data body
so, when I upload photos, I send json data to my server.
what can I do??

#question# Can I use more than 1 thread to download a file?

Do you have this API?

Swift 3 version

A gentle request to release swift 3 version.