muukii / onestore

📕A single value proxy for NSUserDefaults, with clean API.

OneStore

A single value proxy for NSUserDefaults, with clean API.

With OneStore…

• Create one proxy(an OneStore object) for each NSUserDefaults value.
• Multiple NSUserDefaults and namespaces are supported with Stacks.

Example

Basic

let name = OneStore<String>("name")
let age = OneStore<Int>("age")

name.value = "muukii"
age.value = 18

Specify Stack

let stack = Stack(userDefaults: NSUserDefaults(suiteName: "group.me.muukii.Fil")!, namespace: "me")
let name = OneStore<String>("name", stack: stack)
let age = OneStore<Int>("age", stack: stack)

name.value = "muukii"
age.value = 18

Remove object

let name = OneStore<String>("name", stack: stack)
name.value = nil

Remove all objects on namespace

let stack = Stack(userDefaults: NSUserDefaults.standardUserDefaults(), namespace: "me")
let name = OneStore<String>("name", stack: stack)

stack.removeAllObjectsOnNamespace()
/* or */
name.stack.removeAllObjectsOnNamespace()

Realworld example

enum Me {

    static let name = OneStore<String>("name", stack: Me.stack)
    static let age = OneStore<Int>("age", stack: Me.stack)

    private static let stack = Stack(userDefaults: NSUserDefaults.standardUserDefaults(), namespace: "me")
}

Me.name.value = "muukii"

Requirements

Swift 3.0

Installation

OneStore is available through CocoaPods. To install it, simply add the following line to your Podfile:

pod "OneStore"

Author

muukii, [email protected]

License

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

onestore's Issues

Setting value = nil, not removing key value from User Defaults; Not updating value to nil.

When I am setting "nil" value to OneStore property and then fetching it's value, getting old value instead of "nil".

I think it is happening due to optional value is not unwrapped and handled for nil values.

I have handled it for nil value. You can check latest code on left side.

Do OneStore support to store an array of values to UserDefaults?

@muukii, ## Do OneStore support to store an array of values to UserDefaults?

For example, if we need to store array, [5, 6, 8], then can we directly do below?

let storableIntArray = OneStore<[Int]>(...)
storableIntArray.value = [5, 6, 8]

Manual Installation

CocoaPods and Carthage are awesome tools and make our life really easier, but there are some devs who still don't know how to use them.

It would be cool to add the Manual installation guide in your README.md. You can take a look at my iOS Readme Template to see how you can do it.

Does this support storing Custom Object types?

QUESTION
Does this library provide support to save Custom Object types (i.e. User, Person, Animal etc) to User Defaults?