Dekoter alternatives and similar libraries
Based on the "Data Structures / Algorithms" category.
Alternatively, view Dekoter alternatives based on common mentions on social networks and blogs.
-
KeyPathKit
KeyPathKit is a library that provides the standard functions to manipulate data along with a call-syntax that relies on typed keypaths to make the call sites as short and clean as possible. -
BinaryKit
💾🔍🧮 BinaryKit helps you to break down binary data into bits and bytes, easily access specific parts and write data to binary. -
RandMyMod
RandMyMod base on your own struct or class create one or a set of instance, which the variable's value in the instance is automatic randomized. -
OneWaySynchronizer
The simplest abstraction to synchronize local data with remote source. For iOS, wirtten in swift.
CodeRabbit: AI Code Reviews for Developers
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest.
Do you think we are missing an alternative of Dekoter or a related project?
Popular Comparisons
README
Dekoter
- Why You Might Be Interested
- How Much Familiar It Feels
- One More Example
- Features
- Micromission
- Why Dekoter
- Installation
- Collaboration
- License
Why You Might Be Interested
Fills a gap left by the missing NSCoding
's support for Swift structs.
If you've ever implemented NSCoding
, Koting
will be familiar to you as well.
How Much Familiar It Feels
A quick reminder how to implement NSCoding
:
class Cat: NSObject, NSCoding {
let name: String
init(name: String) {
self.name = name
}
// MARK: - NSCoding
private struct Key {
static let name = "name"
}
func encode(with aCoder: NSCoder) {
aCoder.encode(name, forKey: Key.name)
}
required convenience init?(coder aDecoder: NSCoder) {
guard let name = aDecoder.decodeObject(forKey: Key.name) as? String else {
return nil
}
self.init(name: name)
}
}
Let's compare it to Koting
:
struct Cat: Koting {
let name: String
// MARK: - Koting
private struct Key {
static let name = "name"
}
init?(koter: Koter) {
guard let name: String = koter.dekotObject(forKey: Key.name) else {
return nil
}
self.init(name: name)
}
func enkot(with koter: Koter) {
koter.enkotObject(name, forKey: Key.name)
}
}
Thus, not much different besides naming.
To summarize:
- Add the
Koting
protocol to the class declaration. - Implement
init?(koter:)
and funcenkot(with:)
. - Done!
Once it's done, the compiler is happy, and you can convert objects to Data
and back.
let puss = Cat(name: "Puss")
let data = NSKeyedArchiver.de_archivedData(withRootObject: puss)
guard let againPuss: Cat = NSKeyedUnarchiver.de_unarchiveObject(with: data) else { return }
One More Example
This one is going to depict most of the Dekoter's features.
struct Cat {
enum Sex: Int {
case male
case female
}
let name: String
let surname: String?
let sex: Sex
let nationality: String
let birthPlace: Place?
// MARK: - Koting
private struct Key {
static let name = "name"
static let surname = "surname"
static let sex = "sex"
static let nationality = "nationality"
static let birthPlace = "birthPlace"
}
init?(koter: Koter) {
guard let name: String = koter.dekotObject(forKey: Key.name),
let nationality: String = koter.dekotObject(forKey: Key.nationality),
let sexValue: Int = koter.dekotObject(forKey: Key.sex),
let sex = Sex(rawValue: sexValue) else {
return nil
}
let surname: String? = koter.dekotObject(forKey: Key.surname)
let birthPlace: Place? = koter.dekotObject(forKey: Key.birthPlace)
self.init(name: name, surname: surname, sex: sex, nationality: nationality, birthPlace: birthPlace)
}
func enkot(with koter: Koter) {
koter.enkotObject(name, forKey: Key.name)
koter.enkotObject(surname, forKey: Key.surname)
koter.enkotObject(sex.rawValue, forKey: Key.sex)
koter.enkotObject(nationality, forKey: Key.nationality)
koter.enkotObject(birthPlace, forKey: Key.birthPlace)
}
}
What We've Learned from It
- It's okay to have optional properties.
As you can see, there're two optional properties. To encode them you don't do anything special, enkotObject(_, forKey:)
takes optional as the first argument. For decoding you use dekotObject(forKey:)
which also returns optional and it's up to you how whether you unwrap it or not.
Koter
supports the same parameter types asNSCoding
and additionally types which implementKoting
.
In the example above Cat
has an optional birthPlace
property of a type Place
.
- There's only one method for encoding and one – for decoding.
Regardless the type, you use the same methods: enkotObject(_, forKey:)
for encoding and dekotObject(forKey:)
for decoding. These methods are generic, they derive a type based on the expected return value, that's why you should always explicitly specify it.
Features
Save an Object to UserDefaults
There are two methods implemented in a UserDefaults
extension: de_set(_, forKey:)
and de_object(forKey:)
let murzik = Cat(name: "Murzik", surname: nil, sex: .male, nationality: "GER", birthPlace: nil)
userDefaults.de_set(murzik, forKey: "cat")
let againMurzik: Cat? = userDefaults.de_object(forKey: "cat")
and
let sonya = Cat(name: "Sonya", surname: "Kryvonis", sex: .female, nationality: "UA", birthPlace: Place(country: "Ukraine", city: "Lviv"))
let puff: Cat = Cat(name: "Puff", surname: nil, sex: .female, nationality: "US", birthPlace: nil)
let cats = [ sonya, puff ]
userDefaults.de_set(cats, forKey: Key.cat)
guard let againCats: [Cat] = userDefaults.de_object(forKey: Key.cat) else { return }
Archive and Unarchive an Object
The library contains two extensions for NSKeyedArchiver
and NSKeyedUnarchiver
with methods for objects which implement the Koting
protocol.
let emma = Cat(name: "Emma", surname: "Lambert", sex: .female, nationality: "FR", birthPlace: Place(country: "France", city: "Marseille"))
let data = NSKeyedArchiver.de_archivedData(withRootObject: emma)
guard let againEmma: Cat = NSKeyedUnarchiver.de_unarchiveObject(with: data) else { return }
and
let sonya = Cat(name: "Sonya", surname: "Kryvonis", sex: .female, nationality: "UA", birthPlace: Place(country: "Ukraine", city: "Lviv"))
let puff: Cat = Cat(name: "Puff", surname: nil, sex: .female, nationality: "US", birthPlace: nil)
let cats = [ sonya, puff ]
let data = NSKeyedArchiver.de_archivedData(withRootObject: cats)
guard let againCats: [Cat] = NSKeyedUnarchiver.de_unarchiveObject(with: data) else { return }
JSON
A JSONSerialization
extension makes deserialization from JSON very easy.
let oneCat: Cat? = JSONSerialization.de_jsonObject(with: oneCatData)
let cats: [Cat]? = JSONSerialization.de_jsonObject(with: catsData)
For structs which make use only of this feature there's no need to implement the Koting
protocol (contains 2 methods), instead implement a Dekoting
protocol (only 1 method).
Micromission
The library is small but proud of its mission, though the latter is also not that big. It's willing to serve developers as good as NSCoding
does. Developers shouldn't feel lost and disappointed without a convenient tool to convert their Swift structs to Data
and back.
Why Dekoter
You might have noticed a few cats here and there. There's a reason. "Kot" in some slavic languages means "cat", and it sounds similar to "code".
"enkot" -> "encode"
"dekot" -> "decode"
"koter" -> "coder"
"koting" -> "coding"
"dekoter" -> "decoder"
Installation
CocoaPods
Add pod 'Dekoter'
similar to the following to your Podfile:
target 'MyApp' do
pod 'Dekoter'
end
Then run a pod install
inside your terminal, or from CocoaPods.app.
Collaboration
Dear friends, your help is more than welcome! There're multiple ways to support the project.
if you find a problem, or you know how to improve, or you have a question.
if you develop something important (previously filed as an issue).
if you want to share your either positive or negative experience using the library and have a hard time expressing it in a form of issue. Or, maybe, you don't want to make it publicly available.
I'm always happy to read an email from you.
License
It's available under the MIT license. See the [LICENSE](LICENSE) file for more info.
*Note that all licence references and agreements mentioned in the Dekoter README section above
are relevant to that project's source code only.