Transporter

by nghialv

nghialv / Transporter

A tiny library makes uploading and downloading easier

442 Stars 43 Forks Last release: over 5 years ago (0.1.1) MIT License 52 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Platform Language License Issues

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.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.