Fetch

A modern, Swift-native HTTP client library that provides a clean and intuitive API for making network requests. Built with Swift's modern concurrency features, Fetch offers a powerful and type-safe way to interact with web services.

Features

• 🚀 Modern Swift Concurrency: Built with async/await for clean, readable asynchronous code
• 🔒 Type-Safe: Strongly typed API for request and response handling
• 📦 Multiple Response Formats: Support for JSON, text, and binary data
• 📤 Flexible Request Options: Customizable headers, methods, and body content
• 📥 Streaming Support: Efficient handling of large responses with streaming
• 🔄 Download Support: Built-in support for file downloads
• 🎯 Cross-Platform: Works on iOS, macOS, macCatalyst, tvOS, and watchOS
• 🔍 URL Parameter Handling: Built-in support for URL search parameters
• 📝 Form Data Support: Easy handling of multipart/form-data requests

Requirements

• iOS 13.0+
• macOS 10.15+
• macCatalyst 13.0+
• tvOS 13.0+
• watchOS 6.0+
• Swift 5.10+ (Swift 6.0+ recommended)

Installation

Swift Package Manager

Add the following to your Package.swift file:

dependencies: [
    .package(url: "https://github.com/grdsdev/Fetch.git", from: "1.0.0")
]

Usage

Basic GET Request

import Fetch

// Simple GET request
let response = try await fetch("https://api.example.com/data")
let data = await response.blob()

POST Request with JSON

import Fetch

// POST request with JSON body
let response = try await fetch("https://api.example.com/data") {
    $0.method = .post
    $0.body = ["key": "value"]
}
let json = try await response.json()

Download File

import Fetch

// Download a file
let response = try await fetch.download("https://example.com/file.zip")
let data = await response.blob()

// Download with custom options
let response = try await fetch.download("https://example.com/file.zip") {
    $0.timeoutInterval = 30.0
    $0.headers["User-Agent"] = "MyApp/1.0"
}
let data = await response.blob()

Working with URL Parameters

import Fetch

// Create URL with search parameters
var url = URL(string: "https://api.example.com/search")!
url.searchParams.append("query", value: "swift")
url.searchParams.append("page", value: "1")

let response = try await fetch(url)

Form Data Upload

import Fetch

// Create form data
var formData = FormData()
formData.append("file", fileData, filename: "document.pdf")
formData.append("description", "My document")

// Upload with form data
let response = try await fetch("https://api.example.com/upload") {
    $0.method = .post
    $0.body = formData
}

Custom Headers

import Fetch

// Request with custom headers
let response = try await fetch("https://api.example.com/data") {
    $0.headers["Authorization"] = "Bearer token123"
    $0.headers["Content-Type"] = "application/json"
}

Advanced Usage

Custom Configuration

import Fetch

// Create custom Fetch instance with configuration
let customConfig = FetchClient.Configuration(
    sessionConfiguration: .ephemeral,
    sessionDelegate: customDelegate
)
let customFetch = FetchClient(configuration: customConfig)

// Use custom instance
let response = try await customFetch("https://api.example.com/data")

// Use with builder pattern
let response = try await customFetch("https://api.example.com/users") {
    $0.method = .post
    $0.headers["Authorization"] = "Bearer token"
    $0.body = newUser
}

Response Handling

import Fetch

let response = try await fetch("https://api.example.com/data")

// Get response as different types
let json: MyModel = try await response.json(decoder: customDecoder)
let text = try await response.text()
let data = await response.blob()

Advanced Builder Pattern Usage

import Fetch

// Complex request with multiple configurations
let response = try await fetch("https://api.example.com/complex") {
    $0.method = .put
    $0.headers["Authorization"] = "Bearer \(authToken)"
    $0.headers["Content-Type"] = "application/json"
    $0.headers["X-API-Version"] = "2.0"
    $0.body = complexData
    $0.timeoutInterval = 60.0
    $0.cachePolicy = .reloadIgnoringLocalCacheData
}

// File upload with metadata
let response = try await fetch("https://api.example.com/files") {
    $0.method = .post
    $0.headers["Authorization"] = "Bearer \(token)"
    $0.body = fileURL  // Automatically handles file upload
}

// Download with timeout and error handling
let response = try await fetch.download("https://example.com/large-file.zip") {
    $0.timeoutInterval = 300.0 // 5 minutes for large files
    $0.headers["User-Agent"] = "MyApp/2.0"
}

// Handle response
if response.status == 200 {
    let data = await response.blob()
    // Process downloaded data
}

License

This project is licensed under the MIT License - see the LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.