SwiftConnect

What is SwiftConnect?

SwiftConnect is a lightweight network abstraction layer, built on top of Alamofire. It can be used to dramatically simplify interacting with RESTful JSON web-services.

Table of contents

• Why should I use SwiftConnect and not any other abstraction layer?
• Transformers
  • Codable Transformer
  • Dictionary Transformer
  • Void Transformer
  • Creating your own transformer
• Usage
  • How to use SwiftConnect?
  • Connect
  • Connect Middleware
  • Error Handler
  • Requestable
  • Available propertyWarppers
  • What is @Query?
  • What is @Path?
  • What is @RawData?
  • What is @Object?
  • What is @Header?
  • Creating Complex Request
  • AuthorizedRequest
  • File
  • Using Connect
  • Module
  • Building Modules
  • Cancelling Requests
• Debugging

Requirements

• iOS 13.0+
• Xcode 13.2+
• Swift 5.5+

Installation

SwiftConnect is available through Swift Package Manager To install it, simply add the following line to your Package.swift:

dependencies: [
    .package(url: "https://github.com/tareksabry1337/SwiftConnect.git", .upToNextMajor(from: "3.0.0"))
]

Previous Versions

SwiftConnect has move away from all closure based code and is now completely implemented using Swift's new shiny async / await, if you are still interested in the legacy version that supports iOS 10.0 please refer to the v2 branch instead for the documentation and installation

Support

Please, don't hesitate to file an issue if you have questions.

What's Next ?

• Unit Testing
• OAuth2 Support
• Support for downloading tasks
• Support for handling refresh tokens.

Dependncies

SwiftConnect doesn't have any depedency except Alamofire

Everything else was built from scratch natively and using Swift's Modern APIs

License

SwiftConnect is available under the MIT license. See the LICENSE file for more info.