Rocket Networking 🚀

Lightweight Protocol-Oriented Networking layer. Start developing quickly by defining Endpoints for your API.

Installation

Dependency Managers

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate RocketNetworking into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!
pod 'RocketNetworking'

Then, run the following command:

$ pod install

Setup

Define Endpoints

A type that conforms to EndPointType defines the http request to be used in the Router. All Objects to be encoded must conform to Encodable.

enum MyAPIEndpoint {
    case getMyEndpoint(id: Int)
    case submitForm(data: MyEncodable)
}

Conform to EndpointType

extension MyAPIEndpoint: EndPointType {

  var environmentBaseURL: String {
      return "http://staging.my-api-url.net/api"
  }

  var baseURL: URL {
      guard let url = URL(string: environmentBaseURL) else { fatalError("base url could not be config") }
      return url
  }

  var path: String {
      switch self {
      case .getMyEndpoint(id: let id):
          return "/user/info/\(id)"
      case .submitForm:
          return "/message/"
      }
  }

  var httpMethod: HTTPMethod {
      switch self {
      case .getMyEndpoint: return .get
      case .submitForm: return .post
      }
  }

  var task: HTTPTask {
      switch self {
      case .getMyEndpoint(let data):
          return .requestParameters(bodyParameters: data, urlParameters: nil)
      default:
          return .request
      }
  }

  var headers: HTTPHeaders? {
      switch self {
      case .getMyEndpoint:
          return ["hello": "world"]
      default:
          return nil
      }
  }
}

Instance of RocketNetworkManager

struct NetworkManager {
    static let sharedInstance = RocketNetworkManager<MyAPIEndpoint>()

    static func setEnvironment(for environment: NetworkEnvironment) {
        NetworkManager.sharedInstance.setupNetworkLayer(in: environment)
    }
}

Configure in AppDelegate

func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
    NetworkManger.sharedInstance.setEnvironment(for: .development)
    return true
}

Use

var myNetworkObject: MyObject? // MyObject must conform to Codable
let networkManager = NetworkManager.sharedInstance
let endpoint = MyAPIEndpoint.getMyEndpoint(id: 0)

networkManager.request(for: endpoint, MyObject.self) { result in
    switch result {
    case .success(let httpBodyData):
        print("Data Received 🚀")
        myNetworkObject = httpBodyData
    case .error(let error):
        print(error.localizedDescription)
    }
}

willbrandin / RocketNetworking