This library is a thin wrapper around RealmSwift.
RxRealm adds to Results
, List
, LinkingObjects
and AnyRealmCollection
these methods:
asObservable()
- emits every time the collection changes:
let realm = try! Realm()
realm.objects(Lap).asObservable()
.map {laps in "\(laps.count) laps"}
.subscribeNext { text in
print(text)
}
asObservableArray()
- fetches the a snapshot of a Realm collection and converts it to an array value (for example if you want to use array methods on the collection):
let realm = try! Realm()
realm.objects(Lap).asObservableArray()
.map {array in
return array.prefix(3) //slice of first 3 items
}
.subscribeNext { text in
print(text)
}
asObservableChangeset()
- emits every time the collection changes and provides the exact indexes that has been deleted, inserted or updated:
let realm = try! Realm()
realm.objects(Lap).asObservableChangeset()
.subscribeNext {result, changes in
if let changes = changes {
//it's an update
print(result)
print("deleted: \(changes.deleted) inserted: \(changes.inserted) updated: \(changes.updated)")
} else {
//it's the initial data
print(result)
}
}
asObservableArrayChangeset()
combines the result of asObservableArray()
and asObservableChangeset()
returning an Observable<Array<T>, RealmChangeset?>
.
write to existing realm reference) You can add newly created objects to a realm that you already have initialized:
let realm = try! Realm()
[Message("hello"), Message("world")].toObservable()
.subscribe(realm.rx_add())
Be careful, this will retain your realm until the Observable
completes or errors out.
write to the default realm) You can leave it to RxRealm to grab the default Realm on any thread your subscribe and write objects to it:
[Message("hello"), Message("world")].toObservable()
.observeOn( ..you can switch threads if you want )
.subscribe(Realm.rx_add())
write to a specific realm) If you want to switch threads and don't use the default realm, provide a Realm.Configuration
:
var conf = Realm.Configuration()
... custom configuration settings ...
[Message("hello"), Message("world")].toObservable()
.observeOn( ..you can switch threads if you want )
.subscribe(Realm.rx_add(conf))
If you want to create yourself the Realm on a different thread than the subscription you can do that too (allows you to error handle):
[Message("hello"), Message("world")].toObservable()
.observeOn( ..you can switch threads if you want )
.subscribeNext {messages in
let realm = try! Realm()
try! realm.write {
realm.add(messages)
}
}
delete from existing realm reference) Delete objects from existing realm reference:
let realm = try! Realm()
realm.objects(Messages).asObservable()
.subscribe(realm.rx_delete())
Be careful, this will retain your realm until the Observable
completes or errors out.
delete automatically from objects' realm) You can leave it to RxRealm to grab the Realm from the first object and use it:
someCollectionOfPersistedObjects.toObservable()
.subscribe(Realm.rx_delete())
To run the example project, clone the repo, and run pod install
from the Example directory first. The app uses RxSwift, RxCocoa using RealmSwift, RxRealm to observe Results from Realm.
Further you're welcome to peak into the RxRealmTests folder of the example app, which features the library's unit tests.
This library depends on both RxSwift and RealmSwift 1.0+.
RxRealm is available through CocoaPods. To install it, simply add the following line to your Podfile:
pod "RxRealm"
RxRealm is available through Carthage. You can install Carthage with Homebrew using the following command:
$ brew update
$ brew install carthage
To integrate RxRealm into your Xcode project using Carthage, specify it in your Cartfile
:
github "RxSwiftCommunity/RxRealm" ~> 1.0
Run carthage update
to build the framework and drag the built RxRealm.framework
into your Xcode project.
You can grab the files in Pod/Classes
from this repo and include them in your project.
- Test add platforms and add compatibility for the pod
This library belongs to RxSwiftCommunity.
RxRealm is available under the MIT license. See the LICENSE file for more info.