feat: expose http methods

Author: altaywtf

.travis.yml

@@ -2,7 +2,6 @@ import UIKit
 import PutioAPI
 import AuthenticationServices
 
-@available(iOS 13.0, *)
 class ViewController: UIViewController {
     var api: PutioAPI?
     var session: ASWebAuthenticationSession?
@@ -106,7 +105,6 @@ class ViewController: UIViewController {
     }
 }
 
-@available(iOS 13.0, *)
 extension ViewController: ASWebAuthenticationPresentationContextProviding {
     func presentationAnchor(for session: ASWebAuthenticationSession) -> ASPresentationAnchor {
         return view.window ?? ASPresentationAnchor()

Example/PutioAPI/ViewController.swift

@@ -8,14 +8,14 @@
 
 Pod::Spec.new do |s|
   s.name             = 'PutioAPI'
-  s.version          = '1.4.0'
+  s.version          = '1.5.0'
   s.swift_version    = '4.2'
 
-  s.summary          = 'Swift client for put.io API v2'
-  s.description      = 'Swift client for put.io API v2 [https://api.put.io]'
+  s.summary          = 'Swift client for put.io API.'
+  s.description      = 'Swift client for [put.io API](https://api.put.io).'
 
   s.license          = { :type => 'MIT', :file => 'LICENSE' }
-  s.author           = { 'put.io' => 'devs@put.io' }
+  s.author           = { 'put.io' => 'ui@put.io' }
 
   s.homepage         = 'https://github.com/putdotio/putio-swift'
   s.source           = { :git => 'https://github.com/putdotio/putio-swift.git', :tag => s.version.to_s }

PutioAPI.podspec

@@ -7,7 +7,7 @@ public protocol PutioAPIDelegate: class {
 }
 
 public final class PutioAPI {
-    typealias RequestCompletion = (Result<JSON, PutioAPIError>) -> Void
+    public typealias RequestCompletion = (Result<JSON, PutioAPIError>) -> Void
 
     weak var delegate: PutioAPIDelegate?
 
@@ -27,22 +27,22 @@ public final class PutioAPI {
         self.config.token = ""
     }
 
-    func get(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], _ completion: @escaping RequestCompletion) {
+    public func get(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], _ completion: @escaping RequestCompletion) {
         let requestConfig = PutioAPIRequestConfig(apiConfig: config, url: url, method: .get, headers: headers, query: query)
         self.send(requestConfig: requestConfig, completion)
     }
 
-    func post(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], body: Parameters = [:], _ completion: @escaping RequestCompletion) {
+    public func post(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], body: Parameters = [:], _ completion: @escaping RequestCompletion) {
         let requestConfig = PutioAPIRequestConfig(apiConfig: config, url: url, method: .post, headers: headers, query: query, body: body)
         self.send(requestConfig: requestConfig, completion)
     }
 
-    func put(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], body: Parameters = [:], _ completion: @escaping RequestCompletion) {
+    public func put(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], body: Parameters = [:], _ completion: @escaping RequestCompletion) {
         let requestConfig = PutioAPIRequestConfig(apiConfig: config, url: url, method: .put, headers: headers, query: query, body: body)
         self.send(requestConfig: requestConfig, completion)
     }
 
-    func delete(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], _ completion: @escaping RequestCompletion) {
+    public func delete(_ url: String, headers: HTTPHeaders = [:], query: Parameters = [:], _ completion: @escaping RequestCompletion) {
         let requestConfig = PutioAPIRequestConfig(apiConfig: config, url: url, method: .delete, headers: headers, query: query)
         self.send(requestConfig: requestConfig, completion)
     }

PutioAPI/Classes/PutioAPI.swift

@@ -10,7 +10,7 @@ public struct PutioAPIConfig {
     public var clientName: String
     public var timeoutInterval: Double
 
-    public init(clientID: String, clientSecret: String = "", clientName: String = "", token: String = "", timeoutInterval: Double = 10.0) {
+    public init(clientID: String, clientSecret: String = "", clientName: String = "", token: String = "", timeoutInterval: Double = 15.0) {
         self.baseURL = PutioAPI.apiURL
         self.clientID = clientID
         self.clientSecret = clientSecret
@@ -37,11 +37,7 @@ public struct PutioAPIRequestConfig {
 
         self.method = method
 
-        // Header: Correlation ID
         var enhancedHeaders = headers
-        enhancedHeaders.add(name: "X-Putio-Correlation-Id", value: UUID().uuidString)
-
-        // Header: Authorization
         if enhancedHeaders.value(for: "authorization") == nil {
             if apiConfig.token != "" {
                 let authorizationHeader = HTTPHeader.authorization("token \(apiConfig.token)")

PutioAPI/Classes/PutioAPITypes.swift

@@ -25,9 +25,11 @@ pod 'PutioAPI'
 
 ## Usage
 
-See the [Example Project](./Example/PutioAPI/ViewController.swift) for a simple auth -> API call flow.
+- For authentication, check the [Example Project](./Example/PutioAPI/ViewController.swift) for a simple [`ASWebAuthenticationSession`](https://developer.apple.com/documentation/authenticationservices/authenticating_a_user_through_a_web_service) flow.
+- Check [the classes folder](./PutioAPI/Classes/) for available models and respective methods.
+- You can also use `get`, `post`, `put`, and `delete` methods with relative URLs to make requests to the API.
 
-### Development
+## Contribution
 
 Clone the repo.
 
@@ -46,6 +48,7 @@ bundle install
 Install the dependencies then open the workspace.
 
 ```bash
-./scripts/setup.sh
-open ./Example/PutioAPI.xcworkspace
+cd ./Example
+bundle exec pod install
+open ./PutioAPI.xcworkspace
 ```