Giter Club home page Giter Club logo

realmmanager's Introduction

RealmManager

A threaded and easier way of persisting data using Realm Mobile Database

Uses RealmSwift

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

CocoaPods 1.1.0+ is required to build RealmManager 1.0.0+.

To integrate RealmManager into your Xcode project using CocoaPods, specify it in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target '<Your Target Name>' do
    pod 'RealmManager', '~> 1.0.8'
end

Then, run the following command:

$ pod install

Manually

If you prefer not to use any of the aforementioned dependency managers, you can integrate RealmManager into your project manually.

Usage

Add or Update an object to existing model:

You can simply use this method to add or update an object to an existing model

Note: This repo assumes each object as unique, thus the model needs to have a primaryKey
    RealmManager.addOrUpdate(model: "MODEL_NAME", 
                                object: ["foo":"bar"], 
                                completionHandler: { (error) in
        //Code goes here
    })

or if you need to have a configuration for your Realm instance

    var config = Realm.Configuration()
    
    let directory: URL = FileManager.default.containerURL(forSecurityApplicationGroupIdentifier:  
    "group.com.directurl")!.appendingPathComponent("db.realm")
    
    config.fileURL = directory
    
    let foo = Foo(description:"Bar")

    RealmManager.addOrUpdate(configuration: config, 
                                model: "MODEL_NAME", 
                                object: foo, 
                                completionHandler: { (error) in
        //Code goes here
    })

object can be an instance of Object,Array,Dictionary<AnyHashable,AnyObject>, or AnyObject.

Fetching

Fetching an object from the Realm DB:

    let foo = Foo(description:"Bar")
            
    RealmManager.fetch(model: "MODEL_NAME", 
                       condition: "description == '\(foo.description)'", 
                       completionHandler: { (result) in
                       
        //Your code can do anything with 'result' >:)
    })
            

Deleting

Map and Delete an object by using predicate:

    RealmManager.delete(model: "MODEL_NAME",
                        condition: "description = \(foo.description)",
                        completionHandler: { (error) in

        //Code goes here
    })     

or if you have the object and not need to map it:

    RealmManager.deleteObject(object: foo, 
                              completionHandler: { (error) in
        //Code goes here
    })

Author

markcdb , [email protected]

License

RealmManager is available under the MIT license. See the LICENSE file for more info.

realmmanager's People

Contributors

markcdb avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.