restructured files, added way to transform section names in ManagedObjectListControllers

HardcoreData/FetchClause.swift

@@ -1,32 +0,0 @@
-//
-//  FetchClause.swift
-//  HardcoreData
-//
-//  Copyright (c) 2014 John Rommel Estropia
-//
-//  Permission is hereby granted, free of charge, to any person obtaining a copy
-//  of this software and associated documentation files (the "Software"), to deal
-//  in the Software without restriction, including without limitation the rights
-//  to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-//  copies of the Software, and to permit persons to whom the Software is
-//  furnished to do so, subject to the following conditions:
-//
-//  The above copyright notice and this permission notice shall be included in all
-//  copies or substantial portions of the Software.
-//
-//  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-//  IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-//  FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-//  AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-//  LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-//  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-//  SOFTWARE.
-//
-
-import Foundation
-import CoreData
-
-
-// MARK: - FetchClause
-
-public protocol FetchClause: QueryClause { }

HardcoreData/Fetching and Querying/BaseDataTransaction+Querying.swift

@@ -33,98 +33,98 @@ public extension BaseDataTransaction {
     
     // MARK: Public
     
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> T? {
+    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchOne(from, queryClauses)
+        return self.context.fetchOne(from, fetchClauses)
     }
     
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> T? {
+    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchOne(from, queryClauses)
+        return self.context.fetchOne(from, fetchClauses)
     }
     
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [T]? {
+    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchAll(from, queryClauses)
+        return self.context.fetchAll(from, fetchClauses)
     }
     
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [T]? {
+    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchAll(from, queryClauses)
+        return self.context.fetchAll(from, fetchClauses)
     }
     
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchCount(from, queryClauses)
+        return self.context.fetchCount(from, fetchClauses)
     }
     
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchCount(from, queryClauses)
+        return self.context.fetchCount(from, fetchClauses)
     }
     
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> NSManagedObjectID? {
+    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchObjectID(from, queryClauses)
+        return self.context.fetchObjectID(from, fetchClauses)
     }
     
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> NSManagedObjectID? {
+    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchObjectID(from, queryClauses)
+        return self.context.fetchObjectID(from, fetchClauses)
     }
     
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [NSManagedObjectID]? {
+    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchObjectIDs(from, queryClauses)
+        return self.context.fetchObjectIDs(from, fetchClauses)
     }
     
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [NSManagedObjectID]? {
+    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.fetchObjectIDs(from, queryClauses)
+        return self.context.fetchObjectIDs(from, fetchClauses)
     }
     
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to delete from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.deleteAll(from, queryClauses)
+        return self.context.deleteAll(from, deleteClauses)
     }
     
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to delete from a \(typeName(self)) outside its designated queue.")
         
-        return self.context.deleteAll(from, queryClauses)
+        return self.context.deleteAll(from, deleteClauses)
     }
     
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: FetchClause...) -> U? {
+    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to query from a \(typeName(self)) outside its designated queue.")
         
         return self.context.queryValue(from, selectClause, queryClauses)
     }
     
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [FetchClause]) -> U? {
+    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
         
         HardcoreData.assert(self.transactionQueue.isCurrentExecutionContext(), "Attempted to query from a \(typeName(self)) outside its designated queue.")
         

HardcoreData/Fetching and Querying/Concrete Clauses/CustomizeFetch.swift

@@ -29,7 +29,7 @@ import CoreData
 
 // MARK: - CustomizeFetch
 
-public struct CustomizeFetch: FetchClause {
+public struct CustomizeFetch: FetchClause, QueryClause, DeleteClause {
     
     // MARK: Public
     
@@ -39,7 +39,7 @@ public struct CustomizeFetch: FetchClause {
     }
     
     
-    // MARK: QueryClause
+    // MARK: FetchClause, QueryClause, DeleteClause
     
     public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
         

HardcoreData/Fetching and Querying/Concrete Clauses/GroupBy.swift

@@ -24,6 +24,7 @@
 //
 
 import Foundation
+import CoreData
 
 
 // MARK: - GroupBy

HardcoreData/Fetching and Querying/Concrete Clauses/SortedBy.swift

@@ -48,7 +48,7 @@ public enum SortOrder {
 
 // MARK: - SortedBy
 
-public struct SortedBy: FetchClause {
+public struct SortedBy: FetchClause, QueryClause, DeleteClause {
     
     // MARK: Public
     
@@ -92,7 +92,7 @@ public struct SortedBy: FetchClause {
     public let sortDescriptors: [NSSortDescriptor]
     
     
-    // MARK: QueryClause
+    // MARK: FetchClause, QueryClause, DeleteClause
     
     public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
         

HardcoreData/Fetching and Querying/Concrete Clauses/Where.swift

@@ -44,7 +44,7 @@ public prefix func !(clause: Where) -> Where {
 
 // MARK: - Where
 
-public struct Where: FetchClause {
+public struct Where: FetchClause, QueryClause, DeleteClause {
     
     // MARK: Public
     
@@ -83,7 +83,7 @@ public struct Where: FetchClause {
     public let predicate: NSPredicate
     
     
-    // MARK: QueryClause
+    // MARK: FetchClause, QueryClause, DeleteClause
     
     public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
         

HardcoreData/Fetching and Querying/DataStack+Querying.swift

@@ -34,98 +34,98 @@ public extension DataStack {
     
     // MARK: Public
     
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> T? {
+    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchOne(from, queryClauses)
+        return self.mainContext.fetchOne(from, fetchClauses)
     }
     
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> T? {
+    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchOne(from, queryClauses)
+        return self.mainContext.fetchOne(from, fetchClauses)
     }
     
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [T]? {
+    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchAll(from, queryClauses)
+        return self.mainContext.fetchAll(from, fetchClauses)
     }
     
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [T]? {
+    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchAll(from, queryClauses)
+        return self.mainContext.fetchAll(from, fetchClauses)
     }
     
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchCount(from, queryClauses)
+        return self.mainContext.fetchCount(from, fetchClauses)
     }
     
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchCount(from, queryClauses)
+        return self.mainContext.fetchCount(from, fetchClauses)
     }
     
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> NSManagedObjectID? {
+    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchObjectID(from, queryClauses)
+        return self.mainContext.fetchObjectID(from, fetchClauses)
     }
     
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> NSManagedObjectID? {
+    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchObjectID(from, queryClauses)
+        return self.mainContext.fetchObjectID(from, fetchClauses)
     }
     
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [NSManagedObjectID]? {
+    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchObjectIDs(from, queryClauses)
+        return self.mainContext.fetchObjectIDs(from, fetchClauses)
     }
     
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [NSManagedObjectID]? {
+    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to fetch from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.fetchObjectIDs(from, queryClauses)
+        return self.mainContext.fetchObjectIDs(from, fetchClauses)
     }
     
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to delete from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.deleteAll(from, queryClauses)
+        return self.mainContext.deleteAll(from, deleteClauses)
     }
     
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to delete from a \(typeName(self)) outside the main queue.")
         
-        return self.mainContext.deleteAll(from, queryClauses)
+        return self.mainContext.deleteAll(from, deleteClauses)
     }
     
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: FetchClause...) -> U? {
+    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to query from a \(typeName(self)) outside the main queue.")
         
         return self.mainContext.queryValue(from, selectClause, queryClauses)
     }
     
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [FetchClause]) -> U? {
+    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to query from a \(typeName(self)) outside the main queue.")
         

HardcoreData/Fetching and Querying/HardcoreData+Querying.swift

@@ -31,72 +31,72 @@ public extension HardcoreData {
     
     // MARK: Public
     
-    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> T? {
+    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
         
-        return self.defaultStack.fetchOne(from, queryClauses)
+        return self.defaultStack.fetchOne(from, fetchClauses)
     }
     
-    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> T? {
+    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
         
-        return self.defaultStack.fetchOne(from, queryClauses)
+        return self.defaultStack.fetchOne(from, fetchClauses)
     }
     
-    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [T]? {
+    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
         
-        return self.defaultStack.fetchAll(from, queryClauses)
+        return self.defaultStack.fetchAll(from, fetchClauses)
     }
     
-    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [T]? {
+    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
         
-        return self.defaultStack.fetchAll(from, queryClauses)
+        return self.defaultStack.fetchAll(from, fetchClauses)
     }
     
-    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
         
-        return self.defaultStack.fetchCount(from, queryClauses)
+        return self.defaultStack.fetchCount(from, fetchClauses)
     }
     
-    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
         
-        return self.defaultStack.fetchCount(from, queryClauses)
+        return self.defaultStack.fetchCount(from, fetchClauses)
     }
     
-    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> NSManagedObjectID? {
+    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
         
-        return self.defaultStack.fetchObjectID(from, queryClauses)
+        return self.defaultStack.fetchObjectID(from, fetchClauses)
     }
     
-    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> NSManagedObjectID? {
+    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
         
-        return self.defaultStack.fetchObjectID(from, queryClauses)
+        return self.defaultStack.fetchObjectID(from, fetchClauses)
     }
     
-    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [NSManagedObjectID]? {
+    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
         
-        return self.defaultStack.fetchObjectIDs(from, queryClauses)
+        return self.defaultStack.fetchObjectIDs(from, fetchClauses)
     }
     
-    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [NSManagedObjectID]? {
+    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
         
-        return self.defaultStack.fetchObjectIDs(from, queryClauses)
+        return self.defaultStack.fetchObjectIDs(from, fetchClauses)
     }
     
-    public static func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    public static func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
         
-        return self.defaultStack.deleteAll(from, queryClauses)
+        return self.defaultStack.deleteAll(from, deleteClauses)
     }
     
-    public static func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    public static func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
         
-        return self.defaultStack.deleteAll(from, queryClauses)
+        return self.defaultStack.deleteAll(from, deleteClauses)
     }
     
-    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: FetchClause...) -> U? {
+    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
         
         return self.defaultStack.queryValue(from, selectClause, queryClauses)
     }
     
-    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [FetchClause]) -> U? {
+    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
         
         return self.defaultStack.queryValue(from, selectClause, queryClauses)
     }

HardcoreData/Fetching and Querying/Protocol Clauses/ClauseTypes.swift

@@ -1,8 +1,8 @@
 //
-//  QueryClause.swift
+//  ClauseTypes.swift
 //  HardcoreData
 //
-//  Copyright (c) 2015 John Rommel Estropia
+//  Copyright (c) 2014 John Rommel Estropia
 //
 //  Permission is hereby granted, free of charge, to any person obtaining a copy
 //  of this software and associated documentation files (the "Software"), to deal
@@ -27,9 +27,25 @@ import Foundation
 import CoreData
 
 
+// MARK: - FetchClause
+
+public protocol FetchClause {
+    
+    func applyToFetchRequest(fetchRequest: NSFetchRequest)
+}
+
+
 // MARK: - QueryClause
 
 public protocol QueryClause {
     
     func applyToFetchRequest(fetchRequest: NSFetchRequest)
 }
+
+
+// MARK: - DeleteClause
+
+public protocol DeleteClause {
+    
+    func applyToFetchRequest(fetchRequest: NSFetchRequest)
+}

HardcoreData/Internal/NSManagedObjectContext+Querying.swift

@@ -33,19 +33,19 @@ internal extension NSManagedObjectContext {
     
     // MARK: Public
     
-    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> T? {
+    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
         
-        return self.fetchOne(from, queryClauses)
+        return self.fetchOne(from, fetchClauses)
     }
     
-    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> T? {
+    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
         fetchRequest.fetchLimit = 1
         fetchRequest.resultType = .ManagedObjectResultType
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -67,19 +67,19 @@ internal extension NSManagedObjectContext {
         return fetchResults?.first
     }
     
-    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [T]? {
+    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
         
-        return self.fetchAll(from, queryClauses)
+        return self.fetchAll(from, fetchClauses)
     }
     
-    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [T]? {
+    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
         fetchRequest.fetchLimit = 0
         fetchRequest.resultType = .ManagedObjectResultType
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -101,17 +101,17 @@ internal extension NSManagedObjectContext {
         return fetchResults
     }
     
-    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
     
-        return self.fetchCount(from, queryClauses)
+        return self.fetchCount(from, fetchClauses)
     }
     
-    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -133,19 +133,19 @@ internal extension NSManagedObjectContext {
         return count
     }
     
-    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> NSManagedObjectID? {
+    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
         
-        return self.fetchObjectID(from, queryClauses)
+        return self.fetchObjectID(from, fetchClauses)
     }
     
-    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> NSManagedObjectID? {
+    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
         fetchRequest.fetchLimit = 1
         fetchRequest.resultType = .ManagedObjectIDResultType
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -167,19 +167,19 @@ internal extension NSManagedObjectContext {
         return fetchResults?.first
     }
     
-    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> [NSManagedObjectID]? {
+    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
         
-        return self.fetchObjectIDs(from, queryClauses)
+        return self.fetchObjectIDs(from, fetchClauses)
     }
     
-    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> [NSManagedObjectID]? {
+    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
         fetchRequest.fetchLimit = 0
         fetchRequest.resultType = .ManagedObjectIDResultType
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -201,12 +201,12 @@ internal extension NSManagedObjectContext {
         return fetchResults
     }
     
-    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> Int? {
+    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
         
-        return self.deleteAll(from, queryClauses)
+        return self.deleteAll(from, deleteClauses)
     }
     
-    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> Int? {
+    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)
@@ -214,7 +214,7 @@ internal extension NSManagedObjectContext {
         fetchRequest.resultType = .ManagedObjectResultType
         fetchRequest.returnsObjectsAsFaults = true
         
-        for clause in queryClauses {
+        for clause in deleteClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -246,12 +246,12 @@ internal extension NSManagedObjectContext {
         return numberOfDeletedObjects
     }
     
-    internal func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: FetchClause...) -> U? {
+    internal func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
         
         return self.queryValue(from, selectClause, queryClauses)
     }
     
-    internal func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [FetchClause]) -> U? {
+    internal func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
         
         let fetchRequest = NSFetchRequest()
         fetchRequest.entity = self.entityDescriptionForEntityClass(T)

HardcoreData/LICENSE

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2014 John Rommel Estropia
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

HardcoreData/Observing/DataStack+Observing.swift

@@ -44,21 +44,37 @@ public extension DataStack {
         )
     }
     
-    public func observeObjectList<T: NSManagedObject>(from: From<T>, _ groupBy: GroupBy? = nil, _ queryClauses: FetchClause...) -> ManagedObjectListController<T> {
+    public func observeObjectList<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> ManagedObjectListController<T> {
         
-        return self.observeObjectList(from, groupBy, queryClauses)
+        return self.observeObjectList(from, fetchClauses)
     }
     
-    public func observeObjectList<T: NSManagedObject>(from: From<T>, _ groupBy: GroupBy? = nil, _ queryClauses: [FetchClause]) -> ManagedObjectListController<T> {
+    public func observeObjectList<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> ManagedObjectListController<T> {
         
         HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to observe objects from \(typeName(self)) outside the main queue.")
         
         return ManagedObjectListController(
             dataStack: self,
             entity: T.self,
-            sectionNameKeyPath: groupBy?.keyPaths.first,
-            cacheResults: false,
-            queryClauses: queryClauses
+            sectionedBy: nil,
+            fetchClauses: fetchClauses
+        )
+    }
+    
+    public func observeSectionedList<T: NSManagedObject>(from: From<T>, _ sectionedBy: SectionedBy, _ fetchClauses: FetchClause...) -> ManagedObjectListController<T> {
+     
+        return self.observeSectionedList(from, sectionedBy, fetchClauses)
+    }
+    
+    public func observeSectionedList<T: NSManagedObject>(from: From<T>, _ sectionedBy: SectionedBy, _ fetchClauses: [FetchClause]) -> ManagedObjectListController<T> {
+        
+        HardcoreData.assert(GCDQueue.Main.isCurrentExecutionContext(), "Attempted to observe objects from \(typeName(self)) outside the main queue.")
+        
+        return ManagedObjectListController(
+            dataStack: self,
+            entity: T.self,
+            sectionedBy: sectionedBy,
+            fetchClauses: fetchClauses
         )
     }
 }

HardcoreData/Observing/HardcoreData+Observing.swift

@@ -40,6 +40,21 @@ public extension HardcoreData {
     
     public static func observeObjectList<T: NSManagedObject>(from: From<T>, _ groupBy: GroupBy? = nil, _ queryClauses: FetchClause...) -> ManagedObjectListController<T> {
         
-        return self.defaultStack.observeObjectList(from, groupBy, queryClauses)
+        return self.defaultStack.observeObjectList(from, queryClauses)
+    }
+    
+    public static func observeObjectList<T: NSManagedObject>(from: From<T>, _ groupBy: GroupBy? = nil, _ queryClauses: [FetchClause]) -> ManagedObjectListController<T> {
+        
+        return self.defaultStack.observeObjectList(from, queryClauses)
+    }
+    
+    public static func observeSectionedList<T: NSManagedObject>(from: From<T>, _ sectionedBy: SectionedBy, _ fetchClauses: FetchClause...) -> ManagedObjectListController<T> {
+        
+        return self.defaultStack.observeSectionedList(from, sectionedBy, fetchClauses)
+    }
+    
+    public static func observeSectionedList<T: NSManagedObject>(from: From<T>, _ sectionedBy: SectionedBy, _ fetchClauses: [FetchClause]) -> ManagedObjectListController<T> {
+        
+        return self.defaultStack.observeSectionedList(from, sectionedBy, fetchClauses)
     }
 }

HardcoreData/Observing/ManagedObjectListController.swift

@@ -28,36 +28,25 @@ import CoreData
 import GCDKit
 
 
-private let ManagedObjectListControllerWillChangeListNotification = "ManagedObjectListControllerWillChangeListNotification"
-private let ManagedObjectListControllerDidChangeListNotification = "ManagedObjectListControllerDidChangeListNotification"
+// MARK: - SectionedBy
 
-private let ManagedObjectListControllerDidInsertObjectNotification = "ManagedObjectListControllerDidInsertObjectNotification"
-private let ManagedObjectListControllerDidDeleteObjectNotification = "ManagedObjectListControllerDidDeleteObjectNotification"
-private let ManagedObjectListControllerDidUpdateObjectNotification = "ManagedObjectListControllerDidUpdateObjectNotification"
-private let ManagedObjectListControllerDidMoveObjectNotification = "ManagedObjectListControllerDidMoveObjectNotification"
-
-private let ManagedObjectListControllerDidInsertSectionNotification = "ManagedObjectListControllerDidInsertSectionNotification"
-private let ManagedObjectListControllerDidDeleteSectionNotification = "ManagedObjectListControllerDidDeleteSectionNotification"
-
-private let UserInfoKeyObject = "UserInfoKeyObject"
-private let UserInfoKeyIndexPath = "UserInfoKeyIndexPath"
-private let UserInfoKeyNewIndexPath = "UserInfoKeyNewIndexPath"
-
-private let UserInfoKeySectionInfo = "UserInfoKeySectionInfo"
-private let UserInfoKeySectionIndex = "UserInfoKeySectionIndex"
-
-private struct NotificationKey {
+public struct SectionedBy {
     
-    static var willChangeList: Void?
-    static var didChangeList: Void?
+    // MARK: Public
     
-    static var didInsertObject: Void?
-    static var didDeleteObject: Void?
-    static var didUpdateObject: Void?
-    static var didMoveObject: Void?
+    public init(_ sectionKeyPath: KeyPath) {
+        
+        self.init(sectionKeyPath, { $0 })
+    }
     
-    static var didInsertSection: Void?
-    static var didDeleteSection: Void?
+    public init(_ sectionKeyPath: KeyPath, _ sectionNameTransformer: (sectionKeyPath: KeyPath?) -> String?) {
+        
+        self.sectionKeyPath = sectionKeyPath
+        self.sectionNameTransformer = sectionNameTransformer
+    }
+    
+    internal let sectionKeyPath: KeyPath
+    internal let sectionNameTransformer: (sectionKeyPath: KeyPath?) -> String?
 }
 
 
@@ -456,13 +445,13 @@ public final class ManagedObjectListController<T: NSManagedObject>: FetchedResul
     
     private func controller(controller: NSFetchedResultsController, sectionIndexTitleForSectionName sectionName: String?) -> String? {
         
-        return nil
+        return self.sectionNameTransformer(sectionKeyPath: sectionName)
     }
     
     
     // MARK: Internal
     
-    internal init(dataStack: DataStack, entity: T.Type, sectionNameKeyPath: KeyPath?, cacheResults: Bool, queryClauses: [FetchClause]) {
+    internal init(dataStack: DataStack, entity: T.Type, sectionedBy: SectionedBy?, fetchClauses: [FetchClause]) {
         
         let context = dataStack.mainContext
         
@@ -471,7 +460,7 @@ public final class ManagedObjectListController<T: NSManagedObject>: FetchedResul
         fetchRequest.fetchLimit = 0
         fetchRequest.resultType = .ManagedObjectResultType
         
-        for clause in queryClauses {
+        for clause in fetchClauses {
             
             clause.applyToFetchRequest(fetchRequest)
         }
@@ -479,10 +468,8 @@ public final class ManagedObjectListController<T: NSManagedObject>: FetchedResul
         let fetchedResultsController = NSFetchedResultsController(
             fetchRequest: fetchRequest,
             managedObjectContext: context,
-            sectionNameKeyPath: sectionNameKeyPath,
-            cacheName: (cacheResults
-                ? "\(self.dynamicType).\(NSUUID())"
-                : nil)
+            sectionNameKeyPath: sectionedBy?.sectionKeyPath,
+            cacheName: nil
         )
         
         let fetchedResultsControllerDelegate = FetchedResultsControllerDelegate()
@@ -491,6 +478,16 @@ public final class ManagedObjectListController<T: NSManagedObject>: FetchedResul
         self.fetchedResultsControllerDelegate = fetchedResultsControllerDelegate
         self.parentStack = dataStack
         
+        if let sectionNameTransformer = sectionedBy?.sectionNameTransformer {
+            
+            self.sectionNameTransformer = sectionNameTransformer
+        }
+        else {
+            
+            self.sectionNameTransformer = { $0 }
+        }
+        
+        
         fetchedResultsControllerDelegate.handler = self
         fetchedResultsControllerDelegate.fetchedResultsController = fetchedResultsController
         
@@ -508,6 +505,7 @@ public final class ManagedObjectListController<T: NSManagedObject>: FetchedResul
     
     private let fetchedResultsController: NSFetchedResultsController
     private let fetchedResultsControllerDelegate: FetchedResultsControllerDelegate
+    private let sectionNameTransformer: (sectionKeyPath: KeyPath?) -> String?
     private weak var parentStack: DataStack?
     
     private func registerChangeNotification(notificationKey: UnsafePointer<Void>, name: String, toObserver observer: AnyObject, callback: (listController: ManagedObjectListController<T>) -> Void) {
@@ -648,3 +646,36 @@ private final class FetchedResultsControllerDelegate: NSFetchedResultsController
         self.fetchedResultsController?.delegate = nil
     }
 }
+
+
+private let ManagedObjectListControllerWillChangeListNotification = "ManagedObjectListControllerWillChangeListNotification"
+private let ManagedObjectListControllerDidChangeListNotification = "ManagedObjectListControllerDidChangeListNotification"
+
+private let ManagedObjectListControllerDidInsertObjectNotification = "ManagedObjectListControllerDidInsertObjectNotification"
+private let ManagedObjectListControllerDidDeleteObjectNotification = "ManagedObjectListControllerDidDeleteObjectNotification"
+private let ManagedObjectListControllerDidUpdateObjectNotification = "ManagedObjectListControllerDidUpdateObjectNotification"
+private let ManagedObjectListControllerDidMoveObjectNotification = "ManagedObjectListControllerDidMoveObjectNotification"
+
+private let ManagedObjectListControllerDidInsertSectionNotification = "ManagedObjectListControllerDidInsertSectionNotification"
+private let ManagedObjectListControllerDidDeleteSectionNotification = "ManagedObjectListControllerDidDeleteSectionNotification"
+
+private let UserInfoKeyObject = "UserInfoKeyObject"
+private let UserInfoKeyIndexPath = "UserInfoKeyIndexPath"
+private let UserInfoKeyNewIndexPath = "UserInfoKeyNewIndexPath"
+
+private let UserInfoKeySectionInfo = "UserInfoKeySectionInfo"
+private let UserInfoKeySectionIndex = "UserInfoKeySectionIndex"
+
+private struct NotificationKey {
+    
+    static var willChangeList: Void?
+    static var didChangeList: Void?
+    
+    static var didInsertObject: Void?
+    static var didDeleteObject: Void?
+    static var didUpdateObject: Void?
+    static var didMoveObject: Void?
+    
+    static var didInsertSection: Void?
+    static var didDeleteSection: Void?
+}

HardcoreData/README.md

@@ -1,101 +0,0 @@
-# HardcoreData
-[![Version](https://img.shields.io/cocoapods/v/HardcoreData.svg?style=flat)](http://cocoadocs.org/docsets/HardcoreData)
-[![Platform](https://img.shields.io/cocoapods/p/HardcoreData.svg?style=flat)](http://cocoadocs.org/docsets/HardcoreData)
-[![License](https://img.shields.io/cocoapods/l/HardcoreData.svg?style=flat)](http://cocoadocs.org/docsets/HardcoreData)
-
-Simple, elegant, and smart Core Data programming with Swift
-
-## Features
-- Supports multiple persistent stores per *data stack*, just the way .xcdatamodeld files are supposed to. HardcoreData will also manage one *data stack* by default, but you can create and manage as many as you need. (see "Setting up")
-- Ability to plug-in your own logging framework (or your favorite 3rd-party logger). (see "Logging and error handling")
-- Makes it hard to fall into common concurrency mistakes. All Core Data tasks are encapsulated into safer, higher-level abstractions without sacrificing flexibility and customizability. (see "Saving and processing transactions")
-- Provides convenient API for common use cases. (see "Fetching and querying")
-- Pleasant API designed around Swift’s code elegance and type safety. (see "TL;DR sample codes")
-
-#### TL;DR sample codes
-
-Quick-setup:
-```swift
-HardcoreData.defaultStack.addSQLiteStore("MyStore.sqlite")
-```
-
-Simple transactions:
-```swift
-HardcoreData.beginAsynchronous { (transaction) -> Void in
-    let object = transaction.create(MyEntity)
-    object.entityID = 1
-    object.name = "test entity"
-
-    transaction.commit { (result) -> Void in
-        switch result {
-            case .Success(let hasChanges): println("success!")
-            case .Failure(let error): println(error)
-        }
-    }
-}
-```
-
-Easy fetching:
-```swift
-let objects = HardcoreData.fetchAll(From(MyEntity))
-```
-```swift
-let objects = HardcoreData.fetchAll(
-    From(MyEntity),
-    Where("entityID", isEqualTo: 1),
-    SortedBy(.Ascending("entityID"), .Descending("name")),
-    CustomizeFetch { (fetchRequest) -> Void in
-        fetchRequest.includesPendingChanges = true
-    }
-)
-```
-
-Simple queries:
-```swift
-let count = HardcoreData.queryValue(
-    From(MyEntity),
-    Select<Int>(.Count("entityID"))
-)
-```
-
-
-
-## Architecture
-For maximum safety and performance, HardcoreData will enforce coding patterns and practices it was designed for. (Don't worry, it's not as scary as it sounds.) But it is advisable to understand the "magic" of HardcoreData before you use it in your apps.
-
-If you are already familiar with the inner workings of CoreData, here is a mapping of `HardcoreData` abstractions:
-
-| *Core Data* | *HardcoreData* |
-| --- | --- |
-| `NSManagedObjectModel` / `NSPersistentStoreCoordinator`<br />(.xcdatamodeld file) | `DataStack` |
-| `NSPersistentStore`<br />("Configuration"s in the .xcdatamodeld file) | `DataStack` configuration<br />(multiple sqlite / in-memory stores per stack) |
-| `NSManagedObjectContext` | `BaseDataTransaction` subclasses<br />(`SynchronousDataTransaction`, `AsynchronousDataTransaction`, `DetachedDataTransaction`) |
-
-RestKit and MagicalRecord set up their `NSManagedObjectContext`s this way:
-
-<img src="https://cloud.githubusercontent.com/assets/3029684/6734049/40579660-ce99-11e4-9d38-829877386afb.png" alt="nested contexts" height=271 />
-
-This ensures maximum data integrity between contexts without blocking the main queue. But as <a href="http://floriankugler.com/2013/04/29/concurrent-core-data-stack-performance-shootout/">Florian Kugler's investigation</a> found out, merging contexts is still by far faster than saving nested contexts. HardcoreData's `DataStack` takes the best of both worlds by treating the main `NSManagedObjectContext` as a read-only context, and only allows changes to be made within *transactions*:
-
-<img src="https://cloud.githubusercontent.com/assets/3029684/6734050/4078b642-ce99-11e4-95ea-c0c1d24fbe80.png" alt="nested contexts and merge hybrid" height=212 />
-
-This allows for a butter-smooth main thread, while still taking advantage of safe nested contexts.
-
-
-
-## Setting up
-
-
-## Saving and processing transactions
-
-
-## Fetching and querying
-
-
-## Logging and error handling
-
-
-## Observing changes and notifications (currently in the works)
-
-
-