Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onurhuseyincantay/Hover
Async network layer with Combine
https://github.com/onurhuseyincantay/Hover
combine combine-framework ios moya networking networklayer reactive-programming swift5
Last synced: 6 days ago
JSON representation
Async network layer with Combine
- Host: GitHub
- URL: https://github.com/onurhuseyincantay/Hover
- Owner: onurhuseyincantay
- License: mit
- Created: 2019-07-11T10:01:02.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-03-24T21:49:30.000Z (over 1 year ago)
- Last Synced: 2024-10-19T01:14:50.163Z (21 days ago)
- Topics: combine, combine-framework, ios, moya, networking, networklayer, reactive-programming, swift5
- Language: Swift
- Homepage:
- Size: 2.94 MB
- Stars: 128
- Watchers: 4
- Forks: 8
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-swiftui - onurhuseyincantay/Hover - Hover an async combine supported network library (Samples)
- awesome-swiftui - Hover an async combine supported network library
README
# Version 1.1
[](https://github.com/onurhuseyincantay/Hover/blob/develop/LICENSE)[](https://cocoapods.org/pods/HoverKitSDK)
[](https://github.com/Carthage/Carthage)
[](https://github.com/apple/swift-package-manager)
## Currently Available
| Platform | Version |
| ------------- |:------------- |
| iOS | 12.0 |
| tvOS | 10.0 |
| macOS | 10.15 |
| watchOS | 3.0 |
| macCatalyst | 13.0 |
Hover is a Network layer which uses Apple's new framework `Combine` and provides async network calls with different kind of request functions.
## Why and When to Use
The main benefit to use Hover is to abstract the networking layer as much as possible and remove redunant code from your projects as we know `Apple` announced a new framework called `Combine` the main goal is to provide a declarative Swift API for processing values over time. These values can represent many kinds of asynchronous events, so networking calls are the most important async events, which actually needs to have a support for `Combine` to prevent and integrate Apple's native framework. Why you shouldnt use is when you dont have that much networking calls and also not so complex data flows to keep track on which means actually that you dont have states for the UI then dont use it. :)
#### Cocoapods Installation
```swift
target 'MyApp' do
pod 'HoverKitSDK', "~> 1.1"
end
```
#### Carthage Installation
```swift
github "onurhuseyincantay/Hover" ~> 1.1
```
#### Swift Package Manager Installation
Package | branch
:-------------------------:|:-------------------------:
| 
# Sample Usage
#### Provide Target
```swift
enum UserTarget {
case login(email: String, password: String)
}
extension UserTarget: NetworkTarget {
var path: String {
switch self {
...
}
var providerType: AuthProviderType {
...
}
var baseURL: URL {
...
}
var methodType: MethodType {
switch self {
...
}
}
var contentType: ContentType? {
switch self {
...
}
}
var workType: WorkType {
switch self {
...
}
}
var headers: [String : String]? {
...
}
}
```
#### Request With Publisher
```swift
let provider = Hover()
let publisher = provider.request(
with: UserTarget.login(email: "[email protected]", password: "123456"),
scheduler: DispatchQueue.main,
class: UserModel.self
)
...
publisher.sink({ ... })
```
#### Request With Subscriber
```swift
let provider = Hover()
let userSubscriber = UserSubscriber()
provider.request(with: UserTarget.login(email: "[email protected]", password: "123456"), class: UserModel.self, subscriber: userSubscriber)
```
Tested with [JsonPlaceholder](https://jsonplaceholder.typicode.com)
Inspired By [Moya](https://github.com/Moya/Moya) Developed with 🧡