RaAPIWrapper uses @propertyWrapper to achieve a similar effect to that of defining network requests in the Android Retrofit library.
When you have a large number of network request apis in the same file RaAPIWrapper can help you define each request in a more aggregated form, so you don't have to jump back and forth within the file.
Special Note! : RaAPIWrapper is just a syntactic sugar for defining web requests. You need to use Alamofire, Moya, other third-party web framework or call URLSession directly to initiate web requests on this basis.
The good thing is that you can easily integrate RaAPIWrapper into your existing project with few or no code changes, and RaAPIWrapper can coexist very well with the existing web framework in your project.
- iOS 12γmacOS 10.14γwatchOS 5.0γtvOS 12 or later.
- Xcode 14 or later required.
- Swift 5.7 or later required.
@GET("/api/v1/no_param")
static var noParamAPI: APIParameterBuilder<()>? = nil
@POST("/api/v1/tuple_param")
static var tupleParamAPI: APIParameterBuilder<(id: Int, name: String?)>? = .init {
// `Dictionary` and `Array` can be used directly as parameters.
["id": $0.id, "name": $0.name]
}
@POST("/post")
static var postWithModel: APIParameterBuilder<Arg>? = .init {
// When the parameter `Arg` complies with the `APIParameter` (`Encodable & Hashable`) protocol,
// it can be used directly as a parameter.
$0
}pod 'RaAPIWrapper'If your project relies on Alamofire, then you may also consider relying on RaAPIWrapper/AF. This module provides a wrapper for ParameterEncoding.
- File > Swift Packages > Add Package Dependency
- Add https://github.com/RakuyoKit/RaAPIWrapper.git
- Select "Up to Next Major" and fill in the corresponding version number
Or add the following to your Package.swift file:
dependencies: [
.package(
url: "https://github.com/RakuyoKit/RaAPIWrapper.git",
.upToNextMajor(from: "1.2.1")
)
]Please refer to the example in Demo.playground.
Since playground depends on
RaAPIWrapperin the form of Swift Package Manager, please open the project viaPackage.swiftfirst, then selectDemo.playgroundfrom the left navigation bar and run the content.
RaAPIWrapper is available under the MIT license. For more information, see LICENSE.