Streamlining, documentation

Author: Revolucent

CoreDataQueryInterface/EntityType.swift

@@ -46,10 +46,8 @@ public func entityNameForClass(aClass: AnyClass, inManagedObjectModel managedObj
     dispatch_sync(EntityCacheQueue) {
         entityName = EntityCache[className]
         if entityName == nil {
-            entityName = managedObjectModel.entities.filter({ $0.managedObjectClassName == className }).first!.name!
-            if entityName != nil {
-                EntityCache[className] = entityName
-            }
+            entityName = managedObjectModel.entities.filter{ $0.managedObjectClassName == className }.first?.name
+            EntityCache[className] = entityName
         }
     }
     return entityName

CoreDataQueryInterface/PredicateBuilder.swift

@@ -28,6 +28,9 @@ import Foundation
  Helper class to build predicates.
 
  Use this class to bypass CDQI's type safety in filter expressions, if needed.
+ Any type which implements `CustomExpressionConvertible` or its subclass
+ `TypedExpressionConvertible` can be used here. Types such as `Int`, `String`,
+ `NSNumber` and so on can be used directly.
  */
 public struct PredicateBuilder {
     private init() {}

CoreDataQueryInterface/PredicateComparable.swift

@@ -11,5 +11,15 @@ import Foundation
 /**
  Types which implement this protocol can appear on the left-hand 
  side of an expression that generates a filter predicate.
+ 
+ - note: Without this type, CDQI can hijack Swift's built-in boolean
+ expressions. For instance, an expression such as `import CoreDataQueryInterface;
+ if x == 3 && y == 4 { print('ok') }` might not even compile because
+ the compiler believes `x == 3 && y == 4` is trying to build `NSPredicate`
+ instead of `Bool`. `PredicateComparable` prevents this from happening.
+ 
+ For this reason, `PredicateComparable` should be used very sparingly. I recommend
+ never adding it to your own types unless you really know what you are doing. **Never**
+ add it to any built-in Swift type such as `Int`, `String`, etc.
  */
 public protocol PredicateComparable {}