HTTPCab

Latest	2.0.3
Homepage	https://github.com/nullgr/http-cab
License	MIT
Platforms	ios 8.0
Authors	Aleksey Zgurskiy

HTTPCab – network framework for HTTP requests and REST.

Usage

Using Providers for structure you requests:

enum ProfileRequests {
  case getUserProfile(id: String)
  case postUserPhoneNumber(phoneNumber: String)
}

Then you need to specify all data you need for requests:

extension ProfileRequests: Request {
  var baseURL: String { 
    return "https://your.domain.com"
  }

  var path: String { 
    switch self {
    case .getUserProfile,
         .postUserPhoneNumber:
      return "/user"
    }
  }

  var method: Method {
    switch self {
    case .getUserProfile:
      return .get
    case .postUserPhoneNumber:
      return .post
    }
  }

  var parameters: [String: String]? { 
    switch self {
    case .getUserProfile(id: let id):
      return ["user_id": id]
    case .postUserPhoneNumber:
      return nil
    }
  }

  var body: Any? {
    switch self {
    case .getUserProfile:
      return nil
    case .postUserPhoneNumber(phoneNumber: let phoneNumber):
      return ["phone_number": phoneNumber]
    }
  }

  var encoder: BodyEncoder? {
    switch self {
    case .getUserProfile:
      return nil
    case .postUserPhoneNumber:
      return BodyJSONEncoder()
    }
  }

  var headers: [String: String]? { 
    return nil
  }
}

For usage you need to specify the Provider that will handle this requests:

class YourProfileProvider: Provider {
  let sessionManager: SessionManager = .default

  func getUser(id: String) {
    dataRequest {
      ProfileRequests.getUserProfile(id: id)
    }.response { data, response, error in {
      //...
    }
  }

  func updatePhoneNumber(phone: String) {
    dataRequest {
      ProfileRequests.postUserPhoneNumber(phoneNumber: phoneNumber)
    }.response { data, response, error in {
      //...
    }
  }
}

Encoding

There are 2 main encoding types:

• BodyJSONEncoder
• BodyPlistEncoder

You can create a custom encoder by implement BodyEncoder protocol:

class CustomEncoder: BodyEncoder {
  func encode(_ body: Any?) -> Data? {
    //...
  }
}

License

MIT license. See the LICENSE file for details.

Latest podspec

{
    "name": "HTTPCab",
    "version": "2.0.3",
    "summary": "HTTPCab - network framework for HTTP requests and REST.",
    "homepage": "https://github.com/nullgr/http-cab",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "Aleksey Zgurskiy": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/nullgr/http-cab.git",
        "tag": "2.0.3"
    },
    "source_files": "HTTPCab/HTTPCab/**/*.{swift}",
    "swift_version": "4.1"
}

Thu, 06 Dec 2018 11:00:25 +0000