added fasttrack requests

Author: swiftuiux

README.md

@@ -17,6 +17,26 @@ Network layer for running requests like GET, POST, PUT, DELETE etc customizable
 
  ![Http requests](https://github.com/The-Igor/async-http-client-example/blob/main/async-http-client-example/img/image11.gif) 
 
+## Fast track
+
+## 1. Use
+```swift
+   try await Http.Get.from(url, retry: 5)
+```
+```swift
+   try await Http.Post.from(url, taskDelegate : TaskDelegate())
+```
+
+```swift
+   try await Http.Put.from(url, body: data)
+```
+
+```swift
+   try await Http.Delete.from(url)
+```
+
+## Extended track
+
 ## 1. Create
 ```swift
     let url = URL(string: "http://localhost:3000")

Sources/async-http-client/proxy/helper/RequestHelper.swift

@@ -0,0 +1,83 @@
+//
+//  RequestHelper.swift
+//  
+//
+//  Created by Igor on 11.03.2023.
+//
+
+import Foundation
+
+/// A URL load request builder method
+/// - Parameters:
+///   - baseURL: Base url
+///   - path: Path
+///   - method: The HTTP request method
+///   - query: An array of name-value pairs
+///   - body: The data sent as the message body of a request, such as for an HTTP POST or PUT requests
+///   - headers: A dictionary containing all of the HTTP header fields for a request
+/// - Returns: A URL load request
+func buildURLRequest(
+    _ baseURL : URL,
+    for path: String,
+    method : Http.Method = .get,
+    query : Http.Query? = nil,
+    body : Data? = nil,
+    headers : Http.Headers?    
+) throws -> URLRequest {
+    //url + query
+    let url = try buildURL(baseURL: baseURL, for: path, query: query)
+    
+    var request = URLRequest(url: url)
+    
+    //headers
+    if let headers{
+        request.allHTTPHeaderFields = headers
+    }
+    
+    // method
+    request.httpMethod = method.rawValue
+    
+    //body
+    if let body = body{
+        request.httpBody = body
+
+    }
+    
+    return request
+}
+
+/// A URL load request builder method
+/// - Parameters:
+///   - url: Base url
+///   - method: The HTTP request method
+///   - query: An array of name-value pairs
+///   - body: The data sent as the message body of a request, such as for an HTTP POST or PUT requests
+///   - headers: A dictionary containing all of the HTTP header fields for a request
+/// - Returns: A URL load request
+func buildURLRequest(
+    for url : URL,
+    method : Http.Method = .get,
+    query : Http.Query? = nil,
+    body : Data? = nil,
+    headers : Http.Headers?
+    
+) throws -> URLRequest {
+    
+    var request = URLRequest(url: url)
+    
+    //headers
+    if let headers{
+        request.allHTTPHeaderFields = headers
+    }
+    
+    // method
+    request.httpMethod = method.rawValue
+    
+    //body
+    if let body = body{
+        request.httpBody = body
+
+    }
+    
+    return request
+}

Sources/async-http-client/proxy/helper/SendHelper.swift

@@ -0,0 +1,42 @@
+//
+//  SendHelper.swift
+//  
+//
+//  Created by Igor on 11.03.2023.
+//
+
+import Foundation
+import retry_policy_service
+
+/// - Parameters:
+///   - request: A URL load request that is independent of protocol or URL scheme
+///   - retry: ``RetryService`` strategy
+///   - taskDelegate: A protocol that defines methods that URL session instances call on their delegates to handle task-level events
+func sendRetry(
+    with request : URLRequest,
+    retry strategy : RetryService.Strategy,
+    _ taskDelegate: ITaskDelegate? = nil,
+    _ session : URLSession = .shared
+) async throws -> (Data, URLResponse)
+{
+    let service = RetryService(strategy: strategy)
+
+    for delay in service.dropLast(){
+        do{
+            return try await session.data(for: request, delegate: taskDelegate)
+        }catch{
+            #if DEBUG
+            print("retry send \(delay)")
+            #endif
+        }
+        
+        try? await Task.sleep(nanoseconds: delay)
+    }
+
+    #if DEBUG
+    //print("retry send last")
+    #endif
+    
+    /// one more time to let the error to propagate if it fails the last time
+    return try await session.data(for: request, delegate: taskDelegate)
+}

Sources/async-http-client/proxy/helper/UrlHelper.swift

@@ -0,0 +1,43 @@
+//
+//  UrlHelper.swift
+//  
+//
+//  Created by Igor on 11.03.2023.
+//
+
+import Foundation
+import retry_policy_service
+
+/// Url builder method
+/// - Parameters:
+///   - url:  url
+///   - query: An array of name-value pairs
+/// - Returns: A value that identifies the location of a resource
+public func append(_ url: URL,with query : Http.Query? = nil) throws -> URL{
+    
+    guard var components = URLComponents(url: url, resolvingAgainstBaseURL: true)else{
+        throw URLError(.badURL)
+    }
+    
+    if let query = query, query.isEmpty == false {
+        components.queryItems = query.map(URLQueryItem.init) }
+    
+    guard let url = components.url else { throw URLError(.badURL) }
+    
+    return url
+}
+    
+/// Url builder method
+/// - Parameters:
+///   - baseURL: Base url
+///   - path: Path
+///   - query: An array of name-value pairs
+/// - Returns: A value that identifies the location of a resource
+func buildURL(baseURL: URL, for path: String, query : Http.Query? = nil) throws -> URL{
+    
+    guard let url = URL(string: path, relativeTo: baseURL)else{
+        throw URLError(.badURL)
+    }
+    
+    return try append(url, with: query)
+}

Sources/async-http-client/proxy/http/Direct.swift

@@ -0,0 +1,74 @@
+//
+//  Direct.swift
+//  
+//
+//  Created by Igor on 11.03.2023.
+//
+
+import Foundation
+import retry_policy_service
+
+public extension Http{
+    
+    struct Get{
+        public static func from(
+            _ url : URL,
+            query : Http.Query? = nil,
+            headers : Http.Headers? = nil,
+            retry : UInt = 1,
+            taskDelegate: ITaskDelegate? = nil
+        ) async throws -> (Data, URLResponse){
+            let request = try buildURLRequest(for: url, query: query, headers: headers)
+            let strategy = RetryService.Strategy.exponential(retry: retry)
+            
+           return try await sendRetry(with: request, retry: strategy)
+        }
+    }
+    
+    struct Post{
+        public static func from(
+            _ url : URL,
+            query : Http.Query? = nil,
+            body : Data? = nil,
+            headers : Http.Headers? = nil,
+            retry : UInt = 1,
+            taskDelegate: ITaskDelegate? = nil
+        ) async throws -> (Data, URLResponse){
+            let request = try buildURLRequest(for: url, method: .post, query: query, body: body, headers: headers)
+            let strategy = RetryService.Strategy.exponential(retry: retry)
+
+           return try await sendRetry(with: request, retry: strategy)
+        }
+    }
+    
+    struct Put{
+        public static func from(
+            _ url : URL,
+            query : Http.Query? = nil,
+            body : Data? = nil,
+            headers : Http.Headers? = nil,
+            retry : UInt = 1,
+            taskDelegate: ITaskDelegate? = nil
+        ) async throws -> (Data, URLResponse){
+            let request = try buildURLRequest(for: url, method: .put, query: query, body: body, headers: headers)
+            let strategy = RetryService.Strategy.exponential(retry: retry)
+            
+           return try await sendRetry(with: request, retry: strategy)
+        }
+    }
+    
+    struct Delete{
+        public static func from(
+            _ url : URL,
+            query : Http.Query? = nil,
+            headers : Http.Headers? = nil,
+            retry : UInt = 1,
+            taskDelegate: ITaskDelegate? = nil
+        ) async throws -> (Data, URLResponse){
+            let request = try buildURLRequest(for: url, method: .delete, query: query, headers: headers)
+            let strategy = RetryService.Strategy.exponential(retry: retry)
+            
+           return try await sendRetry(with: request, retry: strategy)
+        }
+    }
+}

Sources/async-http-client/proxy/http/Http.swift

@@ -11,5 +11,10 @@ import Foundation
 @available(iOS 15.0, macOS 12.0, tvOS 15.0, watchOS 8.0, *)
 public struct Http{
 
+    /// An array of name-value pairs for a request
+    public typealias Query = [(String, String?)]
 
+    /// A dictionary containing all of the HTTP header fields for a request
+    public typealias Headers = [String: String]
+    
 }