You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Unrealm enables you to easily store Swift native Classes, Structs and Enums into Realm . Stop inheriting from Object! Go for Protocol-Oriented programming!
Made with ❤️ by matghazaryan
Features
Unrealm supports the following types:
Swift Primitives
Swift Structs
Swift Classes
Swift Enums
Swift Arrays
Swift Dictionaries
Nested Classes/Structs
Swift Optionals (String, Data, Date)
Swift Optionals of primitives (Int, Float, Double, Bool)
Swift Optionals of Realmables
Swift Optionals of Arrays
Swift Arrays of enums
Example Project
To run the example project, clone the repo, and run pod install from the Example directory first.
See also Unit Tests.
Usage
All you have to do is
Conform your Classes/Structs to Realmable protocol instead of inheriting from Object. Conform your Enums to RealmableEnum protocol.
Register your Classes/Structs and Enums in AppDelegate's didFinishLaunchingWithOptions.
Realm.registerRealmables(ToDoItem.self)
That's it! Now you can store your Struct or Class object into Realm as usually you do with Objc Classes.
Pros and Cons
Pros 🎉
Enables you to store Swift native types (Structs, Classes, Enums, Arrays, Dictionaries, etc...)
Getting rid of redundant inheriting from Object class
Getting rid of Realm crashes like "Object has been deleted or invalidated"
Getting rid of Realm crashes like "Realm accessed from incorrect thread"
Getting rid of boilerplate code such as @objc dynamic var. Use just var or let
Getting rid of boilerplate code such as RealmOptional<Int>. Use just Int?
Works perfect with Swift's Codable and optional types!
Cons 🍟
Losing "Live Objects" feature. Which means when you modify an object got from Realm the other ones will not be updated automatically. So after modifying an object you should manually update it in realm.
f.e.;
letrealm=try!Realm()vartodoItem= realm.object(ofType:ToDoItem.self, forPrimaryKey:"1")
todoItem.text ="Modified text"try! realm.write{
realm.add(todoItem, update:true) //<- force Realm to update the object
}
Installation
CocoaPods
Unrealm is available through CocoaPods. To install
it, simply add the following line to your Podfile:
pod'Unrealm'
Swift Package Manager
You can also use Swift Package Manager to add Unrealm as a dependency to your project. In order to do so, use the following URL:
https://github.com/matghazaryan/Unrealm.git
You need to use "master" branch instead of SPM.
ToDos
Add more UnitTests
Create a sample project for Swift Package Manager when dependencies can be added to many targets in a simple project.
Contribution
⭐️ If you like what you see, star us on GitHub.
Find a bug, a typo, or something that’s not documented well? We’d love for you to open an issue telling me what I can improve!
Contributions are welcome, and they are greatly appreciated!