Key-Value Coding (KVC) for native Swift classes and structs

Brad Hilton

Last update: Jun 14, 2022

Related tags

Reflection SwiftKVC

Overview

SwiftKVC

SwiftKVC brings key-value coding to native Swift classes and structures. You can easily set and access properties just using a subscript:

var person = Person()
person["name"] = "John"

Or use the more verbose method to catch potential errors:

var person = Person()
do {
  try person.set(value: "John", key: "name")
} catch {
  print(error)
}

SwiftKVC brings the power of Cocoa style key-value coding to Swift.

Installation

SwiftKVC is available through CocoaPods. To install, simply include the following lines in your podfile:

use_frameworks!
pod 'SwiftKVC'

Be sure to import the module at the top of your .swift files:

import SwiftKVC

Alternatively, clone this repo or download it as a zip and include the classes in your project.

Usage

To enable key-value coding for a native Swift structure or class, simply have it conform to either Value or Object respectively:

struct Person : Value {
  var name: String
  var age: Int
}

You can then set and retrieve values from your model by key:

person["name"] = "John"
person["age"] = 36
if let id = person["id"] as? Int {
  print(id)
}

If you would like to handle possible errors, you can use the more verbose methods:

do {
  try person.set(value: "John", key: "name")
  try person.set(value: 36, key: "age")
  if let id = try person.get(key: "id") as? Int {
    print(id)
  }
} catch {
  print(error)
}

Author

Brad Hilton, [email protected]

License

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

An Objective-C wrapper for RocksDB - A Persistent Key-Value Store for Flash and RAM Storage.

ObjectiveRocks ObjectiveRocks is an Objective-C wrapper of Facebook's RocksDB - A Persistent Key-Value Store for Flash and RAM Storage. Current RocksD

56 Nov 5, 2022

A protocol-centric, type and queue safe key-value workflow.

Light-weight, strict protocol-first styled PropertyKit helps you to easily and safely handle guaranteed values, keys or types on various situations of

12 Feb 26, 2021

An efficient, small mobile key-value storage framework developed by WeChat. Works on Android, iOS, macOS, Windows, and POSIX.

中文版本请参看这里 MMKV is an efficient, small, easy-to-use mobile key-value storage framework used in the WeChat application. It's currently available on Andr

15.4k Jan 6, 2023

A key value store for storing per-developer environment and application keys

A key value store for enviroment and application keys. Its good security practice to keep production keys out of developer hands. CocoaPods-keys makes

1.5k Dec 20, 2022

💾 Safe, statically-typed, store-agnostic key-value storage written in Swift!

Storez 💾 Safe, statically-typed, store-agnostic key-value storage Highlights Fully Customizable: Customize the persistence store, the KeyType class,

67 Aug 7, 2022

SwiftStore - Key/Value store for Swift backed by LevelDB.

SwiftStore Key/Value store for Swift backed by LevelDB. Usage Create instances of store import SwiftStore

119 Dec 21, 2022

YapDB is a collection/key/value store with a plugin architecture. It's built atop sqlite, for Swift & objective-c developers.

YapDatabase is a collection/key/value store and so much more. It's built atop sqlite, for Swift & Objective-C developers, targeting macOS, iOS, tvOS &

3.3k Dec 29, 2022

💾 Safe, statically-typed, store-agnostic key-value storage written in Swift!

Storez 💾 Safe, statically-typed, store-agnostic key-value storage Highlights Fully Customizable: Customize the persistence store, the KeyType class,

67 Aug 7, 2022

Key-Value store for Swift backed by LevelDB

SwiftStore Key/Value store for Swift backed by LevelDB. Usage Create instances of store import SwiftStore // Create a store. let store = SwiftStore(s

119 Dec 21, 2022

A really simple key-value wrapper for keychain.

PlainKeychain A really simple key-value wrapper for keychain. Features ✅ Key-value pairs using kSecClassGenericPassword. ❌ Internet passwords (kSecCla

0 Nov 27, 2021

An elegant, fast, thread-safe, multipurpose key-value storage, compatible with all Apple platforms.

KeyValueStorage An elegant, fast, thread-safe, multipurpose key-value storage, compatible with all Apple platforms. Supported Platforms iOS macOS watc

3 Aug 21, 2022

Typed key-value storage solution to store Codable types in various persistence layers with few lines of code!

🗂 Stores A typed key-value storage solution to store Codable types in various persistence layers like User Defaults, File System, Core Data, Keychain

94 Dec 31, 2022

Animate numeric value while setting new value to label

NumericAnimatedLabel Example To run the example project, clone the repo, and run pod install from the Example directory first. Requirements Installati

28 Oct 11, 2021

C4 is an open-source creative coding framework that harnesses the power of native iOS programming with a simplified API that gets you working with media right away. Build artworks, design interfaces and explore new possibilities working with media and interaction.

Code, Creatively. C4 is an open-source creative coding framework that harnesses the power of native iOS programming with a simplified API that gets yo

972 Dec 17, 2022

MusicScore - A music score library with MusicPart, Measure, Note, Pitch and Tempo representations in swift structs

Comments

bump podspec version to 4.0.1
Hi, thanks for merging #8. I forgot to bump the version of SwiftKVC itself, so that pod update would work -- adding this now. Would you follow with tagging?

git tag 4.0.1 git push --tags pod trunk push

Thanks in advance!
opened by yonat 2

Reflection.ReflectionError with iOS 12 and the new Xcode beta

Hey when I try to use your library with the new Xcode 10 beta 2 and iOS 12 beta I have following issue:

protocol ITranslation: Value {
    var example: String { get }
}
class TranslationBase: ITranslation {
    var example = "example"
}

let key = "example"
do {
    if let translationString = try translations.get(key: key) as? String {
          print(translationString)
    }

} catch let error {
    print(error) // Reflection.ReflectionError unexpected
}

Do you have an idea how to solve this issue?

opened by armintelker 0

Carthage
Hi, For iOS and macOS projets it's will be great to make your component Carthage compatible

Take a look at these articles:

Ruthlessly Simple Dependency Management with Carthage

Carthage Tutorial: Getting Started

Making Carthage-compatible Frameworks with Swift

Swift Cross Platform Framework (section Configure targets for Carthage) 👍

On your README.md add on top and add section for the installation with Carthage.
opened by TofPlay 2

Key-Value Coding (KVC) for native Swift classes and structs

Related tags

Overview

SwiftKVC

Installation

Usage

Author

License

You might also like...

An Objective-C wrapper for RocksDB - A Persistent Key-Value Store for Flash and RAM Storage.

A protocol-centric, type and queue safe key-value workflow.

An efficient, small mobile key-value storage framework developed by WeChat. Works on Android, iOS, macOS, Windows, and POSIX.

A key value store for storing per-developer environment and application keys

💾 Safe, statically-typed, store-agnostic key-value storage written in Swift!

SwiftStore - Key/Value store for Swift backed by LevelDB.

YapDB is a collection/key/value store with a plugin architecture. It's built atop sqlite, for Swift & objective-c developers.

💾 Safe, statically-typed, store-agnostic key-value storage written in Swift!

Key-Value store for Swift backed by LevelDB

A really simple key-value wrapper for keychain.

An elegant, fast, thread-safe, multipurpose key-value storage, compatible with all Apple platforms.

Typed key-value storage solution to store Codable types in various persistence layers with few lines of code!

Animate numeric value while setting new value to label

C4 is an open-source creative coding framework that harnesses the power of native iOS programming with a simplified API that gets you working with media right away. Build artworks, design interfaces and explore new possibilities working with media and interaction.

MusicScore - A music score library with MusicPart, Measure, Note, Pitch and Tempo representations in swift structs

Codable code is a Swift Package that allows you to convert JSON Strings into Swift structs

Delightful framework for iOS to easily persist structs, images, and data

Easy BMI calculator to review optionals, segues and structs

Generate protobuf message definitions from Swift structs

Comments

bump podspec version to 4.0.1

Reflection.ReflectionError with iOS 12 and the new Xcode beta

Carthage

Releases(4.0.0)

4.0.0(Sep 20, 2017)

Owner

Brad Hilton

A Swift Runtime library for viewing type info, and the dynamic getting and setting of properties.

Reflection based (Dictionary, CKRecord, NSManagedObject, Realm, JSON and XML) object mapping with extensions for Alamofire and Moya with RxSwift or ReactiveSwift

Easy JSON to NSObject mapping using Cocoa's key value coding (KVC)

RSA public/private key encryption, private key signing and public key verification in Swift using the Swift Package Manager. Works on iOS, macOS, and Linux (work in progress).

RSA public/private key encryption, private key signing and public key verification in Swift using the Swift Package Manager. Works on iOS, macOS, and Linux (work in progress).

A protocol to serialize Swift structs and classes for encoding and decoding.

BFKit-Swift is a collection of useful classes, structs and extensions to develop Apps faster.

Core Data Generator (CDG for short) is a framework for generation (using Sourcery) of Core Data entities from plain structs/classes/enums.

Modern thread-safe and type-safe key-value observing for Swift and Objective-C

Cachyr A typesafe key-value data cache for iOS, macOS, tvOS and watchOS written in Swift.