DotUserDefaults

NSUserDefaults + Enums = 🙌

.UserDefaults has two main functions. It will let you access NSUserDefaults using string type Enums, so you don’t have to type .rawValue every time you want to use Enums as the keys of your NSUserDefaults. Also, this extension adds methods that will let you easily store RawRepresentable Enums in the NSUserDefaults.

Usage

import DotUserDefaults

Enums as NSUserDefaults keys

Normally you would define constants to access your user default values or, if you like to live dangerously, type in the string directly. Now, you can safely access NSUserDefaults via Enums without having to use rawValue all the time.

enum MyDefaults: String {
  case WelcomeText = "welcomeText"
}

func viewDidLoad() {
  super.viewDidLoad()
  welcomeLabel.text = NSUserDefaults.standardUserDefaults().stringForKey(MyDefaults.WelcomeText)
}

func updateWelcomeText(text: String) {
  NSUserDefaults.standardUserDefaults().setObject(text, forKey: MyDefaults.WelcomeText)
}

Storing Enums in NSUserDefaults

Out of the box, you can only store Objects in NSUserDefaults unless you’re brave enough to use NSData to do the convertion. This convenience extension allows you to “store” and access enums without the need of much convertion. It’s limited only to RawRepresentable enums of the type String, Int, Float, Double.

enum MyDefaults: String {
  case WelcomeText = "welcomeText"
}

enum WelcomeText: String {
  case Hai = "👋"
  case Cheers = "🍻"
  case Cool = "👌"
}

func viewDidLoad() {
  super.viewDidLoad()
  welcomeText = NSUserDefaults.standardUserDefaults().stringForKey(MyDefaults.WelcomeText)
}

func updateWelcomeText(text: WelcomeText) {
  NSUserDefaults.standardUserDefaults().setObject(text, forKey: MyDefaults.WelcomeText)
}

Instalation

Author

Gustavo Saume, [email protected]

License

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