DefaultsKeys.swift 2.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566
  1. //
  2. // SwiftyUserDefaults
  3. //
  4. // Copyright (c) 2015-present Radosław Pietruszewski, Łukasz Mróz
  5. //
  6. // Permission is hereby granted, free of charge, to any person obtaining a copy
  7. // of this software and associated documentation files (the "Software"), to deal
  8. // in the Software without restriction, including without limitation the rights
  9. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  10. // copies of the Software, and to permit persons to whom the Software is
  11. // furnished to do so, subject to the following conditions:
  12. //
  13. // The above copyright notice and this permission notice shall be included in all
  14. // copies or substantial portions of the Software.
  15. //
  16. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  17. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  19. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  20. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  21. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  22. // SOFTWARE.
  23. //
  24. import Foundation
  25. // MARK: - Static keys
  26. /// Extend this class and add your user defaults keys as static constants
  27. /// so you can use the shortcut dot notation (e.g. `Defaults[.yourKey]`)
  28. open class DefaultsKeys {
  29. fileprivate init() {}
  30. }
  31. /// Base class for static user defaults keys. Specialize with value type
  32. /// and pass key name to the initializer to create a key.
  33. open class DefaultsKey<ValueType: DefaultsSerializable>: DefaultsKeys {
  34. public let _key: String
  35. public let defaultValue: ValueType.T?
  36. public init(_ key: String, defaultValue: ValueType.T) {
  37. self._key = key
  38. self.defaultValue = defaultValue
  39. }
  40. // Couldn't figure out a way of how to pass a nil/none value from extension, thus this initializer.
  41. // Used for creating an optional key (without defaultValue)
  42. private init(key: String) {
  43. self._key = key
  44. self.defaultValue = nil
  45. }
  46. @available(*, unavailable, message: "This key needs a `defaultValue` parameter. If this type does not have a default value, consider using an optional key.")
  47. public init(_ key: String) {
  48. fatalError()
  49. }
  50. }
  51. public extension DefaultsKey where ValueType: DefaultsSerializable, ValueType: OptionalType, ValueType.Wrapped: DefaultsSerializable {
  52. convenience init(_ key: String) {
  53. self.init(key: key)
  54. }
  55. }