- (void)motisTest
{
	// Some JSON object
	NSDictionary *jsonObject = [...];

	// Creating an instance of your class
	MyClass instance = [[MyClass alloc] init];

	// Parsing and setting the values of the JSON object
	[instance mts_setValuesForKeysWithDictionary:jsonObject];
}

{
  {
    "user_name" : "john.doe",
    "user_id" : 42,
    "creation_date" :  "1979-11-07 17:23:51",
    "webiste" : "http://www.domain.com",
    "user_stats" : {
                     "views" : 431,
                     "ranking" : 12,
                   },
    "user_avatars": [{
      "avatar_type": "standard",
      "image_url": "http://www.avatars.com/john.doe"
    }, {
      "avatar_type": "large",
      "image_url": "http://www.avatars.com/john.doe/large"
    }]
  }
}

// --- User.h --- //

@interface User : NSObject

@property (nonatomic, strong) NSString *name;
@property (nonatomic, assign) NSIntger userId;
@property (nonatomic, strong) NSDate *creationDate;
@property (nonatomic, strong) NSURL *website;
@property (nonatomic, assign) NSInteger views;
@property (nonatomic, assign) NSInteger ranking;
@property (nonatomic, assign) NSURL *avatar;

@end

// --- User.m --- //

@implementation User

+ (NSDictionary*)mts_mapping
{
    return @{@"user_name": mts_key(name),
             @"user_id": mts_key(userId),
             @"creation_date": mts_key(creationDate),
             @"website": mts_key(website),
             @"user_stats.views": mts_key(views),  // <-- KeyPath access
             @"user_stats.ranking": mts_key(ranking), // <-- KeyPath access
             @"user_avatars.0.image_url": mts_key(avatar) // <-- KeyPath access using array index
            };
}

@end

+ (BOOL)mts_shouldSetUndefinedKeys
{
    // By default this method return NO unless you haven't defined a mapping.
    // You can override it and return YES to only accept any key.
    return NO;
}

{
  {
    "user_name" : "john.doe",
    "user_gender": "male",
  }
}

typedef NS_ENUM(NSUInteger, MJUserGender)
{
    MJUserGenderUndefined,
    MJUserGenderMale,
    MJUserGenderFemale,
};

@interface User : NSObject
@property (nonatomic, strong) NSString *name;
@property (nonatomic, assing) MJUserGender gender;
@end

@implementation User
+ (NSDictionary*)mts_mapping
{
    return @{"user_name": mts_key(name),
             "user_gender": mts_key(gender),
            };
}

+ (NSDictionary*)mts_valueMappingForKey:(NSString*)key
{
    if ([key isEqualToString:mts_key(gender)])
    {
        return @{"male": @(MJUserGenderMale),
                 "female": @(MJUserGenderFemale),
                 MTSDefaultValue: @(MJUserGenderUndefined),
                };
    }
    return nil;
}
@end

{
  "user_name": "john.doe",
  "user_id" : 42,
  ...
  "user_followers": [
                      {
                        "user_name": "william",
                        "user_id": 55,
                        ...
                      },
                      {
                        "user_name": "jenny",
                        "user_id": 14,
                        ...
                      },
                      ...
                    ]
}

@implementation User

+ (NSDictionary*)mts_mapping
{
    return @{@"user_name": mts_key(name),
             @"user_id": mts_key(userId),
             ...
             @"user_followers": mts_key(followers),
            };
}

+ (NSDictionary*)mts_arrayClassMapping
{
    return @{mts_key(followers): User.class};
}

@end

@implementation User

- (id)mts_willCreateObjectOfClass:(Class)typeClass withDictionary:(NSDictionary*)dictionary forKey:(NSString*)key abort:(BOOL*)abort
{
    // Return "nil" if you want Motis to handle the object creation and mapping.
    // Otherwise, create/reuse an object of the given "typeClass" and map the values from the dictionary and return it.
    // If you set "abort" to yes, the value for the given "key" won't be set.

    // This method is also used for array contents. In this case, "key" will be the name of the array.
}

- (void)mts_didCreateObject:(id)object forKey:(NSString *)key
{
    // Motis notifies you the new created object.
    // This method is also used for array contents. In this case, "key" will be the name of the array.
}

@end

- (BOOL)mts_validateValue:(inout __autoreleasing id *)ioValue forKey:(NSString *)inKey error:(out NSError *__autoreleasing *)outError;

- (BOOL)validate<Key>:(id *)ioValue error:(NSError * __autoreleasing *)outError
{
	// Check *ioValue and assign new value to ioValue if needed.
	// Return YES if *ioValue can be assigned to the attribute, NO otherwise
	return YES;
}

- (BOOL)mts_validateArrayObject:(inout __autoreleasing id *)ioValue forArrayKey:(NSString *)arrayKey error:(out NSError *__autoreleasing *)outError;
{
	// Check *ioValue and assign new value to ioValue if needed.
	// Return YES if *ioValue can be included into the array, NO otherwise

	return YES;
}

@interface User : MTSMotisObject

@property (nonatomic, strong) NSString *name;
@property (nonatomic, strong) NSDate *birthday;
@property (nonatomic, strong) NSURL *webiste;

@end

@implementation MTSMotisObject

+ (NSDictionary*)mts_mapping
{
	return @{@"user_name": mts_key(name),
	     	 @"birth_day": mts_key(birthday),
	         @"website_url": mts_key(website),
	        };
}

@end

- (void)foo
{
    User *user1 = [[User alloc] init];
    user1.name = @"John Doe";
    user1.birthday = [NSDate date];
    user1.website = [NSURL URLWithString:@"http://www.google.com"];

    // Create a copy of user1
    User *user2 = [user1 copy];

    // Transform user into NSData
    NSData *data = [NSKeyedArchiver archivedDataWithRootObject:user1];

    // Transform the data into a User instance
    User *user3 = [NSKeyedUnarchiver unarchiveObjectWithData:data];
}

- (BOOL)mts_validateValue:(inout __autoreleasing id *)ioValue forKey:(NSString *)inKey error:(out NSError *__autoreleasing *)outError
{
    // Do manual validation for the given "inKey"
    return YES;
}

- (id)mts_willCreateObjectOfClass:(Class)typeClass withDictionary:(NSDictionary*)dictionary forKey:(NSString*)key abort:(BOOL*)abort
{
    if ([typeClass isSubclassOfClass:NSManagedObject.class])
    {
        // Get the entityName
        NSString *entityName = [typeClass entityName]; // <-- This is a custom method that returns the entity name

        // Create a new managed object for the given class (for example).
        NSEntityDescription *entityDescription = [NSEntityDescription entityForName:entityName inManagedObjectContext:self.context];
        NSManagedObject *object = [[typeClass alloc] initWithEntity:entityDescription insertIntoManagedObjectContext:self.context];

        // Perform Motis on the object instance
        [object mts_setValuesForKeysWithDictionary:dictionary];

        return object;
    }
    return nil;
}

- (BOOL)mts_checkValueEqualityBeforeAssignmentForKey:(NSString*)key
{
   // Return YES to make Motis check for equality before making an assignment via KVC.
   // Return NO to make Motis always assign a value via KVC without checking for equality before.

   return YES;
}