motion-yapper 0.0.1 → 0.0.2

data/vendor/Pods/YapDatabase/YapDatabase/Extensions/Relationships/YapDatabaseRelationshipEdge.h

@@ -0,0 +1,163 @@
+#import <Foundation/Foundation.h>
+
+/**
+ * Welcome to YapDatabase!
+ *
+ * The project page has a wealth of documentation if you have any questions.
+ * https://github.com/yaptv/YapDatabase
+ *
+ * If you're new to the project you may want to visit the wiki.
+ * https://github.com/yaptv/YapDatabase/wiki
+ *
+ * The YapDatabaseRelationship extension allow you to create relationships between objects,
+ * and configure automatic deletion rules.
+ *
+ * For tons of information about this extension, see the wiki article:
+ * https://github.com/yaptv/YapDatabase/wiki/Relationships
+**/
+
+enum {
+	// notify only
+	YDB_NotifyIfSourceDeleted      = 1 << 0,
+	YDB_NotifyIfDestinationDeleted = 1 << 1,
+	
+	// one-to-one
+	YDB_DeleteSourceIfDestinationDeleted = 1 << 2,
+	YDB_DeleteDestinationIfSourceDeleted = 1 << 3,
+	
+	// one-to-many & many-to-many
+	YDB_DeleteSourceIfAllDestinationsDeleted = 1 << 4,
+	YDB_DeleteDestinationIfAllSourcesDeleted = 1 << 5,
+};
+typedef uint16_t YDB_NodeDeleteRules;
+
+
+@interface YapDatabaseRelationshipEdge : NSObject <NSCoding, NSCopying>
+
+/**
+ * Returns an edge with the given name, destination & nodeDeleteRules.
+ * 
+ * This method is suitable for use with the YapDatabaseRelationshipNode protocol.
+ * When using this protocol, the source object is directly queried by the YapDatabaseRelationship extension.
+ * Thus the extension already knows what the source node is,
+ * and so the source node information (sourceKey & sourceCollection) doesn't need to be explicitly set on the edge.
+ * 
+ * This method is not suitable for use with manual edge management.
+ * When manually adding an edge, you must fully specify the source node.
+**/
++ (instancetype)edgeWithName:(NSString *)name
+              destinationKey:(NSString *)destinationKey
+                  collection:(NSString *)destinationCollection
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * Returns an edge with the given name, destinationFilePath & nodeDeleteRules.
+ * 
+ * When using a destinationFilePath, only a subset of the nodeDeleteRules apply.
+ * Specifically only the following work:
+ * - YDB_DeleteDestinationIfSourceDeleted
+ * - YDB_DeleteDestinationIfAllSourcesDeleted
+ *
+ * This method is suitable for use with the YapDatabaseRelationshipNode protocol.
+ * When using this protocol, the source object is directly queried by the YapDatabaseRelationship extension.
+ * Thus the extension already knows what the source node is,
+ * and so the source node information (sourceKey & sourceCollection) doesn't need to be explicitly set on the edge.
+ * 
+ * This method is not suitable for use with manual edge management.
+ * When directly adding an edge, you must fully specify the source node.
+**/
++ (instancetype)edgeWithName:(NSString *)name
+         destinationFilePath:(NSString *)destinationFilePath
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * Returns a fully specified edge.
+ * 
+ * This method is suitable for use with manual edge management.
+ * 
+ * If you're using the YapDatabaseRelationshipNode protocol, then you can use the shorter version of this method
+ * which doesn't specify the source node. This is because the source node is implied with the
+ * YapDatabaseRelationshipNode protocol, and thus doesn't need to be explicitly specified in the edge.
+**/
++ (instancetype)edgeWithName:(NSString *)name
+                   sourceKey:(NSString *)sourceKey
+                  collection:(NSString *)sourceCollection
+              destinationKey:(NSString *)destinationKey
+                  collection:(NSString *)destinationCollection
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * Returns a fully specified edge.
+ * 
+ * When using a destinationFilePath, only a subset of the nodeDeleteRules apply.
+ * Specifically only the following work:
+ * - YDB_DeleteDestinationIfSourceDeleted
+ * - YDB_DeleteDestinationIfAllSourcesDeleted
+ *
+ * This method is suitable for use with manual edge management.
+ *
+ * If you're using the YapDatabaseRelationshipNode protocol, then you can use the shorter version of this method
+ * which doesn't specify the source node. This is because the source node is implied with the
+ * YapDatabaseRelationshipNode protocol, and thus doesn't need to be explicitly specified in the edge.
+**/
++ (instancetype)edgeWithName:(NSString *)name
+                   sourceKey:(NSString *)sourceKey
+                  collection:(NSString *)sourceCollection
+         destinationFilePath:(NSString *)destinationFilePath
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+#pragma mark Init
+
+/**
+ * For documentation @see edgeWithName:destinationKey:collection:nodeDeleteRules:
+**/
+- (id)initWithName:(NSString *)name
+    destinationKey:(NSString *)key
+        collection:(NSString *)collection
+   nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * For documentation @see edgeWithName:destinationFilePath:nodeDeleteRules:
+**/
+- (id)initWithName:(NSString *)name destinationFilePath:(NSString *)destinationFilePath
+                                        nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * For documentation @see edgeWithName:sourceKey:collection:destinationKey:collection:nodeDeleteRules:
+**/
+- (id)initWithName:(NSString *)name
+         sourceKey:(NSString *)sourceKey
+        collection:(NSString *)sourceCollection
+    destinationKey:(NSString *)destinationKey
+        collection:(NSString *)destinationCollection
+   nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+/**
+ * For documentation @see edgeWithName:sourceKey:collection:destinationFilePath:nodeDeleteRules:
+**/
+- (id)initWithName:(NSString *)name sourceKey:(NSString *)sourceKey
+                                   collection:(NSString *)sourceCollection
+                          destinationFilePath:(NSString *)destinationFilePath
+                              nodeDeleteRules:(YDB_NodeDeleteRules)rules;
+
+#pragma mark Properties
+
+@property (nonatomic, copy, readonly) NSString *name;
+
+@property (nonatomic, copy, readonly) NSString *sourceKey;
+@property (nonatomic, copy, readonly) NSString *sourceCollection;
+
+@property (nonatomic, copy, readonly) NSString *destinationKey;
+@property (nonatomic, copy, readonly) NSString *destinationCollection;
+
+@property (nonatomic, copy, readonly) NSString *destinationFilePath;
+
+@property (nonatomic, assign, readonly) YDB_NodeDeleteRules nodeDeleteRules;
+
+/**
+ * NO if the edge was created via the YapDatabaseRelationshipNode protocol.
+ * YES if the edge was created via "manual edge management" methods.
+**/
+@property (nonatomic, assign, readonly) BOOL isManualEdge;
+
+@end

data/vendor/Pods/YapDatabase/YapDatabase/Extensions/Relationships/YapDatabaseRelationshipEdge.m

@@ -0,0 +1,408 @@
+#import "YapDatabaseRelationshipEdge.h"
+#import "YapDatabaseRelationshipEdgePrivate.h"
+
+
+@implementation YapDatabaseRelationshipEdge
+
+@synthesize name = name;
+
+@synthesize sourceCollection = sourceCollection;
+@synthesize sourceKey = sourceKey;
+
+@synthesize destinationCollection = destinationCollection;
+@synthesize destinationKey = destinationKey;
+
+@synthesize destinationFilePath = destinationFilePath;
+
+@synthesize nodeDeleteRules = nodeDeleteRules;
+@synthesize isManualEdge = isManualEdge;
+
+#pragma mark Class Init
+
++ (instancetype)edgeWithName:(NSString *)name
+              destinationKey:(NSString *)destinationKey
+                  collection:(NSString *)destinationCollection
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	return [[YapDatabaseRelationshipEdge alloc] initWithName:name
+	                                          destinationKey:destinationKey
+	                                              collection:destinationCollection
+	                                         nodeDeleteRules:rules];
+}
+
++ (instancetype)edgeWithName:(NSString *)name
+         destinationFilePath:(NSString *)destinationFilePath
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	return [[YapDatabaseRelationshipEdge alloc] initWithName:name
+	                                     destinationFilePath:destinationFilePath
+	                                         nodeDeleteRules:rules];
+}
+
++ (instancetype)edgeWithName:(NSString *)name
+                   sourceKey:(NSString *)sourceKey
+                  collection:(NSString *)sourceCollection
+              destinationKey:(NSString *)destinationKey
+                  collection:(NSString *)destinationCollection
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	return [[YapDatabaseRelationshipEdge alloc] initWithName:name
+	                                               sourceKey:sourceKey
+	                                              collection:sourceCollection
+	                                          destinationKey:destinationKey
+	                                              collection:destinationCollection
+	                                         nodeDeleteRules:rules];
+}
+
++ (instancetype)edgeWithName:(NSString *)name
+                   sourceKey:(NSString *)sourceKey
+                  collection:(NSString *)sourceCollection
+         destinationFilePath:(NSString *)destinationFilePath
+             nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	return [[YapDatabaseRelationshipEdge alloc] initWithName:name
+	                                               sourceKey:sourceKey
+	                                              collection:sourceCollection
+	                                     destinationFilePath:destinationFilePath
+	                                         nodeDeleteRules:rules];
+}
+
+#pragma mark Init
+
+/**
+ * Public init method.
+ * Suitable for use with YapDatabaseRelationshipNode protocol.
+**/
+- (id)initWithName:(NSString *)inName
+    destinationKey:(NSString *)dstKey
+        collection:(NSString *)dstCollection
+   nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	if (inName == nil) return nil; // Edge requires name
+	if (dstKey == nil) return nil; // Edge requires destination
+	
+	if ((self = [super init]))
+	{
+		name = [inName copy];
+		
+		destinationKey = [dstKey copy];
+		destinationCollection = dstCollection ? [dstCollection copy] : @"";
+		
+		nodeDeleteRules = rules;
+		isManualEdge = NO;
+	}
+	return self;
+}
+
+/**
+ * Public init method.
+ * Suitable for use with YapDatabaseRelationshipNode protocol.
+**/
+- (id)initWithName:(NSString *)inName destinationFilePath:(NSString *)dstFilePath
+                                          nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	if (inName == nil) return nil;      // Edge requires name
+	if (dstFilePath == nil) return nil; // Edge requires destination
+	
+	if ((self = [super init]))
+	{
+		name = [inName copy];
+		
+		destinationFilePath = [dstFilePath copy];
+		
+		nodeDeleteRules = rules;
+		isManualEdge = NO;
+		
+		flags = YDB_FlagsHasDestinationRowid; // no need for destinationRowid lookup
+	}
+	return self;
+}
+
+/**
+ * Public init method.
+ * Suitable for use with manual edge management.
+**/
+- (id)initWithName:(NSString *)inName
+         sourceKey:(NSString *)srcKey
+        collection:(NSString *)srcCollection
+    destinationKey:(NSString *)dstKey
+        collection:(NSString *)dstCollection
+   nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	if (inName == nil) return nil; // Edge requires name
+	if (srcKey == nil) return nil; // Edge requires source
+	if (dstKey == nil) return nil; // Edge requires destination
+	
+	if ((self = [super init]))
+	{
+		name = [inName copy];
+		
+		sourceKey = [srcKey copy];
+		sourceCollection = srcCollection ? [srcCollection copy] : @"";
+		
+		destinationKey = [dstKey copy];
+		destinationCollection = dstCollection ? [dstCollection copy] : @"";
+		
+		nodeDeleteRules = rules;
+		isManualEdge = YES;
+	}
+	return self;
+}
+
+- (id)initWithName:(NSString *)inName sourceKey:(NSString *)srcKey
+                                     collection:(NSString *)srcCollection
+                            destinationFilePath:(NSString *)dstFilePath
+                                nodeDeleteRules:(YDB_NodeDeleteRules)rules
+{
+	if (inName == nil) return nil;      // Edge requires name
+	if (srcKey == nil) return nil;      // Edge requires source
+	if (dstFilePath == nil) return nil; // Edge requires destination
+	
+	if ((self = [super init]))
+	{
+		name = [inName copy];
+		
+		sourceKey = [srcKey copy];
+		sourceCollection = srcCollection ? [srcCollection copy] : @"";
+		
+		destinationFilePath = [dstFilePath copy];
+		
+		nodeDeleteRules = rules;
+		isManualEdge = YES;
+		
+		flags = YDB_FlagsHasDestinationRowid; // no need for destinationRowid lookup
+	}
+	return self;
+}
+
+/**
+ * Internal init method.
+ * This method is used when reading an edge from a row in the database.
+**/
+- (id)initWithRowid:(int64_t)rowid
+               name:(NSString *)inName
+                src:(int64_t)src
+                dst:(int64_t)dst
+        dstFilePath:(NSString *)dstFilePath
+              rules:(int)rules
+             manual:(BOOL)manual
+{
+	if ((self = [super init]))
+	{
+		name = [inName copy];
+		destinationFilePath = [dstFilePath copy];
+		nodeDeleteRules = rules;
+		isManualEdge = manual;
+		
+		edgeRowid = rowid;
+		sourceRowid = src;
+		destinationRowid = dst;
+		
+		flags = YDB_FlagsHasSourceRowid | YDB_FlagsHasDestinationRowid | YDB_FlagsHasEdgeRowid;
+	}
+	return self;
+}
+
+#pragma mark NSCoding
+
+- (id)initWithCoder:(NSCoder *)decoder
+{
+	if ((self = [super init]))
+	{
+		name = [decoder decodeObjectForKey:@"name"];
+		
+		sourceKey = [decoder decodeObjectForKey:@"sourceKey"];
+		sourceCollection = [decoder decodeObjectForKey:@"sourceCollection"];
+		
+		destinationKey = [decoder decodeObjectForKey:@"destinationKey"];
+		destinationCollection = [decoder decodeObjectForKey:@"destinationCollection"];
+		
+		destinationFilePath = [decoder decodeObjectForKey:@"destinationFilePath"];
+		
+		nodeDeleteRules = [decoder decodeIntForKey:@"nodeDeleteRules"];
+		isManualEdge = [decoder decodeBoolForKey:@"isManualEdge"];
+		
+		if (destinationFilePath)
+			flags = YDB_FlagsHasDestinationRowid;
+		else
+			flags = YDB_FlagsNone;
+	}
+	return self;
+}
+
+- (void)encodeWithCoder:(NSCoder *)coder
+{
+	[coder encodeObject:name forKey:@"name"];
+	
+	[coder encodeObject:sourceKey forKey:@"sourceKey"];
+	[coder encodeObject:sourceCollection forKey:@"sourceCollection"];
+	
+	[coder encodeObject:destinationKey forKey:@"destinationKey"];
+	[coder encodeObject:destinationCollection forKey:@"destinationCollection"];
+	
+	[coder encodeObject:destinationFilePath forKey:@"destinationFilePath"];
+	
+	[coder encodeInt:nodeDeleteRules forKey:@"nodeDeleteRules"];
+	[coder encodeBool:isManualEdge forKey:@"isManualEdge"];
+}
+
+#pragma mark NSCopying
+
+- (id)copyWithZone:(NSZone *)zone
+{
+	YapDatabaseRelationshipEdge *copy = [[YapDatabaseRelationshipEdge alloc] init];
+	
+	copy->name = name;
+	copy->sourceKey = sourceKey;
+	copy->sourceCollection = sourceCollection;
+	copy->destinationKey = destinationKey;
+	copy->destinationCollection = destinationCollection;
+	copy->destinationFilePath = destinationFilePath;
+	copy->nodeDeleteRules = nodeDeleteRules;
+	copy->isManualEdge = isManualEdge;
+	
+	copy->edgeRowid = edgeRowid;
+	copy->sourceRowid = sourceRowid;
+	copy->destinationRowid = destinationRowid;
+	
+	copy->edgeAction = YDB_EdgeActionNone; // Return a clean copy
+	copy->flags = YDB_FlagsNone;           // Return a clean copy
+	
+	// Set appropriate flags
+	
+	if ((flags & YDB_FlagsHasSourceRowid))
+		copy->flags |= YDB_FlagsHasSourceRowid;
+	
+	if ((flags & YDB_FlagsHasDestinationRowid) || destinationFilePath)
+		copy->flags |= YDB_FlagsHasDestinationRowid;
+	
+	if ((flags & YDB_FlagsHasEdgeRowid))
+		copy->flags |= YDB_FlagsHasEdgeRowid;
+	
+	return copy;
+}
+
+- (id)copyWithSourceKey:(NSString *)newSrcKey collection:(NSString *)newSrcCollection rowid:(int64_t)newSrcRowid
+{
+	YapDatabaseRelationshipEdge *copy = [[YapDatabaseRelationshipEdge alloc] init];
+	
+	copy->name = name;
+	copy->sourceKey = [newSrcKey copy];
+	copy->sourceCollection = [newSrcCollection copy];
+	copy->destinationKey = destinationKey;
+	copy->destinationCollection = destinationCollection;
+	copy->destinationFilePath = destinationFilePath;
+	copy->nodeDeleteRules = nodeDeleteRules;
+	copy->isManualEdge = NO; // Force proper value
+	
+	copy->edgeRowid = edgeRowid;
+	copy->sourceRowid = newSrcRowid;
+	copy->destinationRowid = destinationRowid;
+	
+	copy->edgeAction = YDB_EdgeActionNone; // Return a clean copy
+	copy->flags = YDB_FlagsNone;           // Return a clean copy
+	
+	// Set appropriate flags
+	
+	copy->flags |= YDB_FlagsHasSourceRowid;
+	
+	if ((flags & YDB_FlagsHasDestinationRowid) || destinationFilePath)
+		copy->flags |= YDB_FlagsHasDestinationRowid;
+	
+	if ((flags & YDB_FlagsHasEdgeRowid))
+		copy->flags |= YDB_FlagsHasEdgeRowid;
+	
+	return copy;
+}
+
+#pragma mark Comparison
+
+/**
+ * Compares two manual edges to see if they represent the same relationship.
+ * That is, if both edges are manual edges, and the following are equal:
+ *
+ * - name
+ * - sourceKey / sourceCollection
+ * - destinationKey / destinationCollection
+ * - destinationFilePath
+ *
+ * The nodeDeleteRules do NOT need to match.
+**/
+- (BOOL)matchesManualEdge:(YapDatabaseRelationshipEdge *)edge
+{
+	if (edge == nil) return NO;
+	
+	if (!isManualEdge) return NO;
+	if (!edge->isManualEdge) return NO;
+	
+	if (![name isEqualToString:edge->name]) return NO;
+	
+	if (![sourceKey isEqualToString:edge->sourceKey]) return NO;
+	if (![sourceCollection isEqualToString:edge->sourceCollection]) return NO;
+	
+	if (destinationFilePath)
+	{
+		if (![destinationFilePath isEqualToString:edge->destinationFilePath]) return NO;
+	}
+	else
+	{
+		if (![destinationKey isEqualToString:edge->destinationKey]) return NO;
+		if (![destinationCollection isEqualToString:edge->destinationCollection]) return NO;
+	}
+	
+	return YES;
+}
+
+#pragma mark Description
+
+- (NSString *)description
+{
+	NSMutableString *rules = [NSMutableString stringWithCapacity:64];
+
+	if (nodeDeleteRules & YDB_NotifyIfSourceDeleted)
+		[rules appendString:@"NotifyIfSourceDeleted, "];
+	
+	if (nodeDeleteRules & YDB_NotifyIfDestinationDeleted)
+		[rules appendString:@"NotifyIfDestinationDeleted, "];
+	
+	if (nodeDeleteRules & YDB_DeleteSourceIfDestinationDeleted)
+		[rules appendString:@"DeleteSourceIfDestinationDeleted, "];
+	
+	if (nodeDeleteRules & YDB_DeleteDestinationIfSourceDeleted)
+		[rules appendString:@"DeleteDestinationIfSourceDeleted, "];
+	
+	if (nodeDeleteRules & YDB_DeleteSourceIfAllDestinationsDeleted)
+		[rules appendString:@"DeleteSourceIfAllDestinationsDeleted, "];
+	
+	if (nodeDeleteRules & YDB_DeleteDestinationIfAllSourcesDeleted)
+		[rules appendString:@"DeleteDestinationIfAllSourcesDeleted, "];
+	
+	if ([rules length] > 0)
+		[rules deleteCharactersInRange:NSMakeRange([rules length] - 2, 2)];
+	
+	NSMutableString *description = [NSMutableString stringWithCapacity:128];
+	
+	[description appendFormat:@"<YapDatabaseRelationshipEdge[%p]", self];
+	[description appendFormat:@" name(%@)", name];
+	
+	if (sourceKey)
+		[description appendFormat:@" src(%@, %@)", sourceKey, (sourceCollection ?: @"")];
+	
+	if (destinationKey)
+		[description appendFormat:@" dst(%@, %@)", destinationKey, (destinationCollection ?: @"")];
+	else
+		[description appendFormat:@" dstFilePath(%@)", destinationFilePath];
+	
+	[description appendFormat:@" rules(%@)", rules];
+	
+	if (isManualEdge)
+	{
+		[description appendString:@" manual"];
+	}
+	
+	[description appendString:@">"];
+	
+	return description;
+}
+
+@end