Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gperdomor/moyaobjectmapper
ObjectMapper bindings for Moya, RxSwift and ReactiveSwift
https://github.com/gperdomor/moyaobjectmapper
json mapper moya objectmapper reactiveswift rxswift swift swift3
Last synced: about 19 hours ago
JSON representation
ObjectMapper bindings for Moya, RxSwift and ReactiveSwift
- Host: GitHub
- URL: https://github.com/gperdomor/moyaobjectmapper
- Owner: gperdomor
- License: mit
- Archived: true
- Created: 2017-02-20T23:15:30.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2017-05-29T07:55:03.000Z (over 7 years ago)
- Last Synced: 2024-09-24T20:39:12.573Z (about 24 hours ago)
- Topics: json, mapper, moya, objectmapper, reactiveswift, rxswift, swift, swift3
- Language: Swift
- Homepage:
- Size: 85 KB
- Stars: 11
- Watchers: 3
- Forks: 2
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# MoyaObjectMapper
[](https://travis-ci.org/gperdomor/MoyaObjectMapper)
[](https://codecov.io/gh/gperdomor/MoyaObjectMapper)
[](https://github.com/Carthage/Carthage)
[](https://cocoapods.org/pods/MoyaObjectMapper)
[](https://github.com/apple/swift-package-manager)
[ObjectMapper](https://github.com/Hearst-DD/ObjectMapper) bindings for
[Moya](https://github.com/Moya/Moya) for easier JSON serialization. Includes
[RxSwift](https://github.com/ReactiveX/RxSwift) and [ReactiveSwift](https://github.com/ReactiveCocoa/ReactiveSwift) bindings as well.
# Installation
## CocoaPods
Use the following entry in your Podfile
```
pod 'MoyaObjectMapper', '1.0.3'
```
The subspec if you want to use the bindings over RxSwift.
```
pod 'MoyaObjectMapper/RxSwift', '1.0.3'
```
And the subspec if you want to use the bindings over ReactiveSwift.
```
pod 'MoyaObjectMapper/ReactiveSwift', '1.0.3'
```
# Usage
Create a model struct or class. It needs to implement protocol Mappable. More details about model creation [here](https://github.com/lyft/mapper/)
```swift
import Foundation
import ObjectMapper
struct Repository: Mappable {
var identifier: Int!
var name: String!
var fullName: String!
var language: String?
init?(map: Map) {
if map.JSON["id"] == nil {
return nil
}
}
mutating func mapping(map: Map) {
identifier <- map["id"]
name <- map["name"]
fullName <- map["full_name"]
language <- map["language"]
}
}
```
Then you have methods that extends the response from Moya. These methods are:
```swift
map(to: type, context: MapContext? = nil) // map object
map(to: [type], context: MapContext? = nil) // map array of objects
```
For `RxSwift` and `ReactiveCocoa` additionally methods for optional mapping are provided.
These methods are:
```swift
mapOptional(to: type, context: MapContext? = nil)
mapOptional(to: [type], context: MapContext? = nil)
```
See examples below, or in a Demo project.
## 1. Normal usage (without RxSwift or ReactiveCocoa)
```swift
provider = MoyaProvider()
provider.request(GitHub.repos(username: "gperdomor")) { (result) in
if case .success(let response) = result {
do {
let repos = try response.map(to: [Repository.self])
print(repos)
} catch Error.jsonMapping(let error) {
print(try? error.mapString())
} catch {
print(":(")
}
}
}
```
## 2. RxSwift
```swift
provider = RxMoyaProvider()
provider.request(GitHub.repo(fullName: "gperdomor/sygnaler"))
.map(to: Repository.self)
.subscribe { event in
switch event {
case .next(let repo):
print(repo)
case .error(let error):
print(error)
default: break
}
}
```
Additionally, modules for `RxSwift` contains optional mappings. It basically means that if the mapping fails, mapper doesn't throw errors but returns nil. For instance:
```swift
provider = RxMoyaProvider()
provider
.request(GitHub.repos(username: "gperdomor"))
.mapOptional(to: [Repository.self])
.subscribe { event in
switch event {
case .next(let repos):
// Here we can have either nil or [Repository] object.
print(repos)
case .error(let error):
print(error)
default: break
}
}
```
## 3. ReactiveSwift
```swift
provider = ReactiveSwiftMoyaProvider()
provider
.request(GitHub.repos(username: "gperdomor"))
.map(to: [Repository.self])
.start { event in
switch event {
case .value(let repos):
print(repos)
case .failed(let error):
print(error)
default: break
}
}
```
Additionally, modules for `ReactiveSwift` contains optional mappings. It basically means that if the mapping fails, mapper doesn't throw errors but returns nil. For instance:
```swift
provider = ReactiveSwiftMoyaProvider()
provider
.request(GitHub.repos(username: "gperdomor"))
.mapOptional(to: [Repository.self])
.start { event in
switch event {
case .value(let repos):
// Here we can have either nil or [Repository] object.
print(repos)
case .failed(let error):
print(error)
default: break
}
}
```
## Sample Project
There's a sample project in the Demo directory. To use it, run `pod install` to download the required libraries. Have fun!
## Other Mappers
- [MoyaModelMapper](https://github.com/gperdomor/MoyaModelMapper): ModelMapper bindings for Moya
- [MoyaUnbox](https://github.com/gperdomor/MoyaUnbox): Unbox bindings for Moya
## Contributing
Hey! Like MoyaObjectMapper? Awesome! We could actually really use your help!
Open source isn't just writing code. MoyaObjectMapper could use your help with any of the
following:
- Finding (and reporting!) bugs.
- New feature suggestions.
- Answering questions on issues.
- Documentation improvements.
- Reviewing pull requests.
- Helping to manage issue priorities.
- Fixing bugs/new features.
If any of that sounds cool to you, send a pull request! After a few
contributions, we'll add you as an admin to the repo so you can merge pull
requests and help steer the ship :ship:
## License
MoyaObjectMapper is available under the MIT license. See the LICENSE file for more info.