Latest | 1.0.3 |
---|---|
Homepage | https://github.com/gperdomor/MoyaObjectMapper |
License | MIT |
Platforms | ios 8.0, osx 10.12, watchos 3.1, tvos 9.0, requires ARC |
Authors |
ObjectMapper bindings for
Moya for easier JSON serialization. Includes
RxSwift and 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
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:
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:
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)
provider = MoyaProvider<GitHub>()
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
provider = RxMoyaProvider<GitHub>()
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:
provider = RxMoyaProvider<GitHub>()
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
provider = ReactiveSwiftMoyaProvider<GitHub>()
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:
provider = ReactiveSwiftMoyaProvider<GitHub>()
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: ModelMapper bindings for Moya
- 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.
Latest podspec
{ "name": "MoyaObjectMapper", "version": "1.0.3", "summary": "ObjectMapper bindings for Moya. Includes RxSwift and ReactiveSwift bindings as well.", "description": "[ObjectMapper](https://github.com/Hearst-DD/ObjectMapper) bindings forn[Moya](https://github.com/Moya/Moya) for easier JSON serialization.nIncludes [RxSwift](https://github.com/ReactiveX/RxSwift/) and [ReactiveSwift](https://github.com/ReactiveCocoa/ReactiveSwift) bindings as well.nInstructions on how to use it are inn[the README](https://github.com/gperdomor/MoyaObjectMapper).", "homepage": "https://github.com/gperdomor/MoyaObjectMapper", "license": { "type": "MIT", "file": "LICENSE" }, "authors": { "Gustavo Perdomo": "[email protected]" }, "social_media_url": "", "platforms": { "ios": "8.0", "osx": "10.12", "watchos": "3.1", "tvos": "9.0" }, "source": { "git": "https://github.com/gperdomor/MoyaObjectMapper.git", "tag": "1.0.3" }, "requires_arc": true, "default_subspecs": "Core", "pushed_with_swift_version": "3.0", "subspecs": [ { "name": "Core", "source_files": "Sources/MoyaObjectMapper/*.swift", "dependencies": { "Moya": [ "~> 8.0" ], "ObjectMapper": [ "~> 2.2" ] }, "frameworks": "Foundation" }, { "name": "RxSwift", "source_files": "Sources/RxMoyaObjectMapper/*.swift", "dependencies": { "MoyaObjectMapper/Core": [], "Moya/RxSwift": [], "RxSwift": [ "~> 3.2" ] } }, { "name": "ReactiveSwift", "source_files": "Sources/ReactiveMoyaObjectMapper/*.swift", "dependencies": { "MoyaObjectMapper/Core": [], "Moya/ReactiveCocoa": [], "ReactiveSwift": [ "~> 1.0" ] } } ] }
Mon, 06 Mar 2017 17:20:04 +0000