From 4ddc323eee7823e30035dec5a0487a26fe3dd5f4 Mon Sep 17 00:00:00 2001
From: Xin Hong <hongxinhope@gmail.com>
Date: Mon, 22 Aug 2016 12:28:02 +0800
Subject: [PATCH] update readme

---
 README.md | 102 +++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 101 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 9a720bb..ac2463f 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,103 @@
 # ManagedObjectAdapter
 [![Build Status](https://travis-ci.org/teambition/ManagedObjectAdapter.svg?branch=master)](https://travis-ci.org/teambition/ManagedObjectAdapter)
-[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
\ No newline at end of file
+[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)
+
+ManagedObjectAdapter is a lightweight adapter for the converts between Model instances and Core Data managed objects.
+
+## How To Get Started
+### Carthage
+Specify "ManagedObjectAdapter" in your ```Cartfile```:
+```ogdl 
+github "teambition/ManagedObjectAdapter"
+```
+
+### Usage
+Models that you want to use ManagedObjectAdapter must conform to ```ManagedObjectSerializing``` protocol.
+
+```swift
+protocol ManagedObjectSerializing: AnyObject {
+    init()
+    func valueForKey(key: String) -> AnyObject?
+    func setValue(value: AnyObject?, forKey key: String)
+
+    static func managedObjectEntityName() -> String
+    static func managedObjectKeysByPropertyKey() -> [String: String]
+    static func valueTransformersByPropertyKey() -> [String: NSValueTransformer]
+    static func relationshipModelClassesByPropertyKey() -> [String: AnyClass]
+    static func propertyKeysForManagedObjectUniquing() -> Set<String>
+}
+```
+
+You can use ManagedObjectAdapter like this:
+
+```swift
+class TestModel: NSObject, ManagedObjectSerializing {
+    var id: String?
+
+    // Property name of this property in xcdatamodeld is "downloadUrl"
+    var downloadURL: NSURL?
+
+    // Type of this property in xcdatamodeld is Transformable
+    var transformableModel: TransformableModel?
+
+    // Type of this property in xcdatamodeld is to many relationship
+    var relationshipModels: Set<RelationshipModel>?
+
+    required override init() { }
+
+    static func managedObjectKeysByPropertyKey() -> [String: String] {
+        return ["downloadURL": "downloadUrl"]
+    }
+
+    static func valueTransformersByPropertyKey() -> [String : NSValueTransformer] {
+        return ["transformableModel": TransformableModelTransformer()]
+    }
+
+    static func propertyKeysForManagedObjectUniquing() -> Set<String> {
+        return ["id"]
+    }
+
+    static func relationshipModelClassesByPropertyKey() -> [String: AnyClass] {
+        return ["relationshipModels": RelationshipModel.self]
+    }
+}
+
+class TransformableModel: NSObject, ManagedObjectSerializing {
+    var id: String?
+
+    required override init() { }
+}
+
+class RelationshipModel: NSObject, ManagedObjectSerializing {
+    var id: String?
+
+    required override init() { }
+}
+
+class TransformableModelTransformer: NSValueTransformer {
+    override func transformedValue(value: AnyObject?) -> AnyObject? {
+        // Model to NSData
+    }
+
+    override func reverseTransformedValue(value: AnyObject?) -> AnyObject? {
+        // NSData to Model
+    }
+}
+
+let managedObjectContext = ...
+let originModel = ...
+let moTestModel = originModel.toManagedObject(managedObjectContext)
+let testModel = TestModel.modelFromManagedObject(moTestModel!)
+```
+
+## Minimum Requirement
+iOS 8.0
+
+## Release Notes
+* [Release Notes](https://github.com/teambition/ManagedObjectAdapter/releases)
+
+## License
+ManagedObjectAdapter is released under the MIT license. See [LICENSE](https://github.com/teambition/ManagedObjectAdapter/blob/master/LICENSE) for details.
+
+## More Info
+Have a question? Please [open an issue](https://github.com/teambition/ManagedObjectAdapter/issues/new)!