fix podspec

Fix warning

.cocoapods.yml

@@ -0,0 +1,2 @@
+try:
+  project: 'CoreStore.xcworkspace'

.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [JohnEstropia]

.gitignore

@@ -6,3 +6,11 @@ Carthage/Build
 CoreStore.xcworkspace/xcuserdata
 .DS_Store
 DerivedData
+*.orig
+build
+Playground_macOS.playground/playground.xcworkspace/xcuserdata
+.swiftpm/xcode/package.xcworkspace/xcuserdata
+.swiftpm/xcode/xcuserdata
+Playground_iOS.playground/playground.xcworkspace/xcuserdata
+LegacyDemo/LegacyDemo.xcodeproj/xcuserdata
+Demo/Demo.xcodeproj/xcuserdata

.gitmodules

@@ -1,3 +0,0 @@
-[submodule "Carthage/Checkouts/GCDKit"]
-	path = Carthage/Checkouts/GCDKit
-	url = https://github.com/JohnEstropia/GCDKit.git

.jazzy.yaml

@@ -0,0 +1,15 @@
+author: John Estropia
+author_url: https://github.com/JohnEstropia
+github_url: https://github.com/JohnEstropia/CoreStore
+module: CoreStore
+readme: README.md
+include: Sources/*
+output: docs
+theme: fullwidth
+clean: true
+skip_undocumented: true
+xcodebuild_arguments:
+- -sdk
+- iphonesimulator
+- -scheme
+- CoreStore iOS

.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata

@@ -2,6 +2,6 @@
 <Workspace
    version = "1.0">
    <FileRef
-      location = "self:CoreStoreDemo.xcodeproj">
+      location = "self:">
    </FileRef>
 </Workspace>

.swiftpm/xcode/package.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -2,9 +2,7 @@
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
-	<key>HasAskedToTakeAutomaticSnapshotBeforeSignificantChanges</key>
+	<key>IDEDidComputeMac32BitWarning</key>
-	<true/>
-	<key>SnapshotAutomaticallyBeforeSignificantChanges</key>
 	<true/>
 </dict>
 </plist>

.swiftpm/xcode/xcuserdata/JohnEstropia.xcuserdatad/xcschemes/xcschememanagement.plist

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>SchemeUserState</key>
+	<dict>
+		<key>CoreStore.xcscheme_^#shared#^_</key>
+		<dict>
+			<key>orderHint</key>
+			<integer>0</integer>
+		</dict>
+	</dict>
+</dict>
+</plist>

.travis.yml

@@ -1,42 +0,0 @@
-language: objective-c
-osx_image: xcode7.3
-sudo: false
-git:
-  submodules: false
-notifications:
-  email: false
-env:
-  global:
-  - LC_CTYPE=en_US.UTF-8
-  - LANG=en_US.UTF-8
-  matrix:
-    - DESTINATION="OS=9.3,name=iPhone 6s"          SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=9.0,name=iPhone 6 Plus"      SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=8.4,name=iPhone 6"           SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=8.3,name=iPhone 5S"          SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=8.2,name=iPhone 5"           SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=8.1,name=iPhone 4S"          SCHEME="CoreStore iOS"     SDK=iphonesimulator9.3  RUN_TESTS="YES" POD_LINT="YES"
-    - DESTINATION="arch=x86_64"                    SCHEME="CoreStore OSX"     SDK=macosx10.11         RUN_TESTS="YES" POD_LINT="NO"
-    - DESTINATION="OS=2.2,name=Apple Watch - 42mm" SCHEME="CoreStore watchOS" SDK=watchsimulator2.2   RUN_TESTS="NO"  POD_LINT="NO"
-    - DESTINATION="OS=9.2,name=Apple TV 1080p"     SCHEME="CoreStore tvOS"    SDK=appletvsimulator9.2 RUN_TESTS="YES" POD_LINT="NO"
-before_install:
-  - gem install cocoapods --no-rdoc --no-ri --no-document --quiet
-  - gem install xcpretty --no-rdoc --no-ri --no-document --quiet
-  - curl -OlL "https://github.com/Carthage/Carthage/releases/download/0.11/Carthage.pkg"
-  - sudo installer -pkg "Carthage.pkg" -target /
-  - rm "Carthage.pkg"
-before_script:
-  - carthage update --use-submodules
-script:
-  - set -o pipefail
-  - xcodebuild -version
-  - xcodebuild -showsdks
-  - if [ $RUN_TESTS == "YES" ]; then 
-      xcodebuild -workspace CoreStore.xcworkspace -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Debug ONLY_ACTIVE_ARCH=NO clean test | xcpretty -c;
-      xcodebuild -workspace CoreStore.xcworkspace -scheme "$SCHEME" -sdk "$SDK" -destination "$DESTINATION" -configuration Release ONLY_ACTIVE_ARCH=NO clean test | xcpretty -c;
-    fi
-  - xcodebuild -workspace "CoreStore.xcworkspace" -scheme "CoreStore iOS" -sdk "iphonesimulator9.3" -destination "OS=9.3,name=iPhone 6s" -configuration Debug ONLY_ACTIVE_ARCH=NO clean test | xcpretty -c;
-  - xcodebuild -workspace "CoreStore.xcworkspace" -scheme "CoreStore iOS" -sdk "iphonesimulator9.3" -destination "OS=9.3,name=iPhone 6s" -configuration Release ONLY_ACTIVE_ARCH=NO clean test | xcpretty -c;
-  - if [ $POD_LINT == "YES" ]; then
-      pod lib lint --quick;
-    fi

Cartfile

@@ -1 +0,0 @@
-github "JohnEstropia/GCDKit" == 1.1.7

Cartfile.resolved

@@ -1 +0,0 @@
-github "JohnEstropia/GCDKit" "1.1.7"

CoreStore.podspec

@@ -1,22 +1,22 @@
 Pod::Spec.new do |s|
     s.name = "CoreStore"
-    s.version = "1.5.4"
+    s.version = "7.3.0"
+    s.swift_version = "5.3"
     s.license = "MIT"
-    s.summary = "Unleashing the real power of Core Data with the elegance and safety of Swift"
     s.homepage = "https://github.com/JohnEstropia/CoreStore"
+    s.documentation_url = "https://JohnEstropia.github.io/CoreStore"
+    s.summary = "Unleashing the real power of Core Data with the elegance and safety of Swift"
     s.author = { "John Rommel Estropia" => "rommel.estropia@gmail.com" }
     s.source = { :git => "https://github.com/JohnEstropia/CoreStore.git", :tag => s.version.to_s }
 
-    s.ios.deployment_target = "8.0"
+    s.ios.deployment_target = "10.0"
-    s.osx.deployment_target = "10.10"
+    s.osx.deployment_target = "10.12"
-    s.watchos.deployment_target = "2.0"
+    s.watchos.deployment_target = "3.0"
-    s.tvos.deployment_target = "9.0"
+    s.tvos.deployment_target = "10.0"
 
-    s.source_files = "CoreStore", "CoreStore/**/*.{swift}"
+    s.source_files = "Sources", "Sources/**/*.{swift,h,m}"
-    s.osx.exclude_files = "CoreStore/Observing/*.{swift}", "CoreStore/Internal/FetchedResultsControllerDelegate.swift", "CoreStore/Internal/CoreStoreFetchedResultsController.swift", "CoreStore/Convenience Helpers/NSFetchedResultsController+Convenience.swift"
+    s.public_header_files = "Sources/**/*.h"
     s.frameworks = "Foundation", "CoreData"
     s.requires_arc = true
-    s.pod_target_xcconfig = { 'OTHER_SWIFT_FLAGS' => '-D USE_FRAMEWORKS' }
+    s.pod_target_xcconfig = { 'OTHER_SWIFT_FLAGS[config=Debug]' => '-D DEBUG', 'OTHER_LDFLAGS' => '-weak_framework Combine -weak_framework SwiftUI' }
-    
-    s.dependency "GCDKit", "1.2.1"
 end

CoreStore.xcodeproj/project.xcworkspace/xcshareddata/CoreStore.xcscmblueprint

@@ -10,10 +10,10 @@
   "DVTSourceControlWorkspaceBlueprintIdentifierKey" : "F347F55F-7F5C-4476-9148-6E902F06E4AD",
   "DVTSourceControlWorkspaceBlueprintWorkingCopyPathsKey" : {
     "8B2E522D57154DFA93A06982C36315ECBEA4FA97" : "CoreStoreLibraries\/GCDKit",
-    "4B60F1BCB491FF717C56441AE7783C74F417BE48" : "CoreStore"
+    "4B60F1BCB491FF717C56441AE7783C74F417BE48" : "CoreStore\/"
   },
   "DVTSourceControlWorkspaceBlueprintNameKey" : "CoreStore",
-  "DVTSourceControlWorkspaceBlueprintVersion" : 203,
+  "DVTSourceControlWorkspaceBlueprintVersion" : 204,
   "DVTSourceControlWorkspaceBlueprintRelativePathToProjectKey" : "CoreStore.xcodeproj",
   "DVTSourceControlWorkspaceBlueprintRemoteRepositoriesKey" : [
     {

CoreStore.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

CoreStore.xcodeproj/xcshareddata/xcschemes/CoreStore OSX.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0710"
+   LastUpgradeVersion = "1020"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -27,6 +27,15 @@
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "B52DD1731BE1F8CC00949AFE"
+            BuildableName = "CoreStore.framework"
+            BlueprintName = "CoreStore OSX"
+            ReferencedContainer = "container:CoreStore.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
       <Testables>
          <TestableReference
             skipped = "NO">
@@ -39,17 +48,6 @@
             </BuildableReference>
          </TestableReference>
       </Testables>
-      <MacroExpansion>
-         <BuildableReference
-            BuildableIdentifier = "primary"
-            BlueprintIdentifier = "B52DD1731BE1F8CC00949AFE"
-            BuildableName = "CoreStore.framework"
-            BlueprintName = "CoreStore OSX"
-            ReferencedContainer = "container:CoreStore.xcodeproj">
-         </BuildableReference>
-      </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -70,8 +68,6 @@
             ReferencedContainer = "container:CoreStore.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
       buildConfiguration = "Release"

CoreStore.xcodeproj/xcshareddata/xcschemes/CoreStore iOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0700"
+   LastUpgradeVersion = "1020"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -41,6 +41,22 @@
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "2F03A52F19C5C6DA005002A5"
+            BuildableName = "CoreStore.framework"
+            BlueprintName = "CoreStore iOS"
+            ReferencedContainer = "container:CoreStore.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
+      <AdditionalOptions>
+         <AdditionalOption
+            key = "NSZombieEnabled"
+            value = "YES"
+            isEnabled = "YES">
+         </AdditionalOption>
+      </AdditionalOptions>
       <Testables>
          <TestableReference
             skipped = "NO">
@@ -53,17 +69,6 @@
             </BuildableReference>
          </TestableReference>
       </Testables>
-      <MacroExpansion>
-         <BuildableReference
-            BuildableIdentifier = "primary"
-            BlueprintIdentifier = "2F03A52F19C5C6DA005002A5"
-            BuildableName = "CoreStore.framework"
-            BlueprintName = "CoreStore iOS"
-            ReferencedContainer = "container:CoreStore.xcodeproj">
-         </BuildableReference>
-      </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -84,8 +89,12 @@
             ReferencedContainer = "container:CoreStore.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
+      <CommandLineArguments>
-      </AdditionalOptions>
+         <CommandLineArgument
+            argument = "-com.apple.CoreData.SQLDebug 2"
+            isEnabled = "NO">
+         </CommandLineArgument>
+      </CommandLineArguments>
    </LaunchAction>
    <ProfileAction
       buildConfiguration = "Release"

CoreStore.xcodeproj/xcshareddata/xcschemes/CoreStore tvOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0720"
+   LastUpgradeVersion = "1020"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -27,6 +27,15 @@
       selectedDebuggerIdentifier = "Xcode.DebuggerFoundation.Debugger.LLDB"
       selectedLauncherIdentifier = "Xcode.DebuggerFoundation.Launcher.LLDB"
       shouldUseLaunchSchemeArgsEnv = "YES">
+      <MacroExpansion>
+         <BuildableReference
+            BuildableIdentifier = "primary"
+            BlueprintIdentifier = "82BA18881C4BBCBA00A0916E"
+            BuildableName = "CoreStore.framework"
+            BlueprintName = "CoreStore tvOS"
+            ReferencedContainer = "container:CoreStore.xcodeproj">
+         </BuildableReference>
+      </MacroExpansion>
       <Testables>
          <TestableReference
             skipped = "NO">
@@ -39,17 +48,6 @@
             </BuildableReference>
          </TestableReference>
       </Testables>
-      <MacroExpansion>
-         <BuildableReference
-            BuildableIdentifier = "primary"
-            BlueprintIdentifier = "82BA18881C4BBCBA00A0916E"
-            BuildableName = "CoreStore.framework"
-            BlueprintName = "CoreStore tvOS"
-            ReferencedContainer = "container:CoreStore.xcodeproj">
-         </BuildableReference>
-      </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -70,8 +68,6 @@
             ReferencedContainer = "container:CoreStore.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
       buildConfiguration = "Release"

CoreStore.xcodeproj/xcshareddata/xcschemes/CoreStore watchOS.xcscheme

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Scheme
-   LastUpgradeVersion = "0700"
+   LastUpgradeVersion = "1020"
    version = "1.3">
    <BuildAction
       parallelizeBuildables = "YES"
@@ -29,8 +29,6 @@
       shouldUseLaunchSchemeArgsEnv = "YES">
       <Testables>
       </Testables>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </TestAction>
    <LaunchAction
       buildConfiguration = "Debug"
@@ -51,8 +49,6 @@
             ReferencedContainer = "container:CoreStore.xcodeproj">
          </BuildableReference>
       </MacroExpansion>
-      <AdditionalOptions>
-      </AdditionalOptions>
    </LaunchAction>
    <ProfileAction
       buildConfiguration = "Release"

CoreStore.xcworkspace/contents.xcworkspacedata

@@ -1,13 +1,13 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <Workspace
    version = "1.0">
+   <FileRef
+      location = "group:Demo/Demo.xcodeproj">
+   </FileRef>
    <FileRef
       location = "group:CoreStore.xcodeproj">
    </FileRef>
    <FileRef
-      location = "group:CoreStoreDemo/CoreStoreDemo.xcodeproj">
+      location = "group:/Users/JohnEstropia/Documents/XCodeProjects/CoreStore/LegacyDemo/LegacyDemo.xcodeproj">
-   </FileRef>
-   <FileRef
-      location = "group:Carthage/Checkouts/GCDKit/GCDKit.xcodeproj">
    </FileRef>
 </Workspace>

CoreStore.xcworkspace/xcshareddata/CoreStore.xcscmblueprint

@@ -5,11 +5,13 @@
   },
   "DVTSourceControlWorkspaceBlueprintWorkingCopyStatesKey" : {
     "8B2E522D57154DFA93A06982C36315ECBEA4FA97" : 0,
+    "95438028B10BBB846574013D29F154A00556A9D1" : 0,
     "4B60F1BCB491FF717C56441AE7783C74F417BE48" : 0
   },
   "DVTSourceControlWorkspaceBlueprintIdentifierKey" : "EBFDEFFE-8BA0-441A-862A-1DE28AA5CD21",
   "DVTSourceControlWorkspaceBlueprintWorkingCopyPathsKey" : {
     "8B2E522D57154DFA93A06982C36315ECBEA4FA97" : "CoreStore\/Carthage\/Checkouts\/GCDKit\/",
+    "95438028B10BBB846574013D29F154A00556A9D1" : "CoreStore\/Carthage\/Checkouts\/Nimble\/",
     "4B60F1BCB491FF717C56441AE7783C74F417BE48" : "CoreStore\/"
   },
   "DVTSourceControlWorkspaceBlueprintNameKey" : "CoreStore",
@@ -25,6 +27,11 @@
       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "https:\/\/github.com\/JohnEstropia\/GCDKit.git",
       "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
       "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "8B2E522D57154DFA93A06982C36315ECBEA4FA97"
+    },
+    {
+      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "https:\/\/github.com\/Quick\/Nimble.git",
+      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
+      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "95438028B10BBB846574013D29F154A00556A9D1"
     }
   ]
 }

CoreStore.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+	<key>IDEDidComputeMac32BitWarning</key>
+	<true/>
+</dict>
+</plist>

CoreStore/CartFile

@@ -1 +0,0 @@
-github "JohnEstropia/GCDKit" == 1.2.1

CoreStore/Convenience Helpers/NSFetchedResultsController+Convenience.swift

@@ -1,92 +0,0 @@
-//
-//  NSManagedObject+Convenience.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - NSFetchedResultsController
-
-public extension NSFetchedResultsController {
-    
-    /**
-     Utility for creating an `NSFetchedResultsController` from a `DataStack`. This is useful to partially support Objective-C classes by passing an `NSFetchedResultsController` instance instead of a `ListMonitor`.
-     */
-    public static func createForStack<T: NSManagedObject>(dataStack: DataStack, fetchRequest: NSFetchRequest, from: From<T>? = nil, sectionBy: SectionBy? = nil, fetchClauses: [FetchClause]) -> NSFetchedResultsController {
-        
-        return CoreStoreFetchedResultsController<T>(
-            context: dataStack.mainContext,
-            fetchRequest: fetchRequest,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    @available(*, deprecated=1.5.2, message="Use NSFetchedResultsController.createForStack(_:fetchRequest:from:sectionBy:fetchClauses:) to create NSFetchedResultsControllers directly")
-    public convenience init<T: NSManagedObject>(dataStack: DataStack, fetchRequest: NSFetchRequest, from: From<T>? = nil, sectionBy: SectionBy? = nil, fetchClauses: [FetchClause]) {
-        
-        let context = dataStack.mainContext
-        from?.applyToFetchRequest(fetchRequest, context: context, applyAffectedStores: false)
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        if let from = from {
-            
-            from.applyAffectedStoresForFetchedRequest(fetchRequest, context: context)
-        }
-        else {
-            
-            guard let from = (fetchRequest.entity.flatMap { $0.managedObjectClassName }).flatMap(NSClassFromString).flatMap(From.init) else {
-                
-                fatalError("Attempted to create an \(typeName(NSFetchedResultsController)) without a  From clause or an NSEntityDescription.")
-            }
-            from.applyAffectedStoresForFetchedRequest(fetchRequest, context: context)
-        }
-        
-        self.init(
-            fetchRequest: fetchRequest,
-            managedObjectContext: context,
-            sectionNameKeyPath: sectionBy?.sectionKeyPath,
-            cacheName: nil
-        )
-    }
-    
-    
-    // MARK: Internal
-    
-    internal static func createFromContext<T: NSManagedObject>(context: NSManagedObjectContext, fetchRequest: NSFetchRequest, from: From<T>? = nil, sectionBy: SectionBy? = nil, fetchClauses: [FetchClause]) -> NSFetchedResultsController {
-        
-        return CoreStoreFetchedResultsController<T>(
-            context: context,
-            fetchRequest: fetchRequest,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses
-        )
-    }
-}

CoreStore/Fetching and Querying/BaseDataTransaction+Querying.swift

@@ -1,393 +0,0 @@
-//
-//  BaseDataTransaction+Querying.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - DataTransaction
-
-public extension BaseDataTransaction {
-    
-    /**
-     Fetches the `NSManagedObject` instance in the transaction's context from a reference created from a transaction or from a different managed object context.
-     
-     - parameter object: a reference to the object created/fetched outside the transaction
-     - returns: the `NSManagedObject` instance if the object exists in the transaction, or `nil` if not found.
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject>(object: T) -> T? {
-        
-        do {
-            
-            return (try self.context.existingObjectWithID(object.objectID) as! T)
-        }
-        catch _ {
-            
-            return nil
-        }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instance in the transaction's context from an `NSManagedObjectID`.
-     
-     - parameter objectID: the `NSManagedObjectID` for the object
-     - returns: the `NSManagedObject` instance if the object exists in the transaction, or `nil` if not found.
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject>(objectID: NSManagedObjectID) -> T? {
-        
-        do {
-            
-            return (try self.context.existingObjectWithID(objectID) as! T)
-        }
-        catch _ {
-            
-            return nil
-        }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instances in the transaction's context from references created from a transaction or from a different managed object context.
-     
-     - parameter objects: an array of `NSManagedObject`s created/fetched outside the transaction
-     - returns: the `NSManagedObject` array for objects that exists in the transaction
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == T>(objects: S) -> [T] {
-        
-        return objects.flatMap { (try? self.context.existingObjectWithID($0.objectID)) as? T }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instances in the transaction's context from a list of `NSManagedObjectID`.
-     
-     - parameter objectIDs: the `NSManagedObjectID` array for the objects
-     - returns: the `NSManagedObject` array for objects that exists in the transaction
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == NSManagedObjectID>(objectIDs: S) -> [T] {
-        
-        return objectIDs.flatMap { (try? self.context.existingObjectWithID($0)) as? T }
-    }
-    
-    /**
-     Fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to fetch from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Deletes all `NSManagedObject`s that satisfy the specified `DeleteClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter deleteClauses: a series of `DeleteClause` instances for the delete request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number of `NSManagedObject`s deleted
-     */
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to delete from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.deleteAll(from, deleteClauses)
-    }
-    
-    /**
-     Deletes all `NSManagedObject`s that satisfy the specified `DeleteClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter deleteClauses: a series of `DeleteClause` instances for the delete request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number of `NSManagedObject`s deleted
-     */
-    public func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to delete from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.deleteAll(from, deleteClauses)
-    }
-    
-    /**
-     Queries aggregate values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to query from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries aggregate values or aggregates as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to query from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries a dictionary of attribute values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: QueryClause...) -> [[NSString: AnyObject]]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to query from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.queryAttributes(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries a dictionary of attribute values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: [QueryClause]) -> [[NSString: AnyObject]]? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to query from a \(typeName(self)) outside its designated queue."
-        )
-        
-        return self.context.queryAttributes(from, selectClause, queryClauses)
-    }
-}

CoreStore/Fetching and Querying/Concrete Clauses/From.swift

@@ -1,374 +0,0 @@
-//
-//  From.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - From
-
-/**
- A `From` clause specifies the source entity and source persistent store for fetch and query methods. A common usage is to just indicate the entity:
- ```
- let person = transaction.fetchOne(From(MyPersonEntity))
- ```
- For cases where multiple `NSPersistentStore`s contain the same entity, the source configuration's name needs to be specified as well:
- ```
- let person = transaction.fetchOne(From<MyPersonEntity>("Configuration1"))
- ```
- */
-public struct From<T: NSManagedObject> {
-    
-    /**
-     Initializes a `From` clause.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From<MyPersonEntity>())
-     ```
-     */
-    public init(){
-        
-        self.init(entityClass: T.self)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified entity type.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From<MyPersonEntity>())
-     ```
-     - parameter entity: the `NSManagedObject` type to be created
-     */
-    public init(_ entity: T.Type) {
-        
-        self.init(entityClass: entity)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified entity class.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From<MyPersonEntity>())
-     ```
-     - parameter entityClass: the `NSManagedObject` class type to be created
-     */
-    public init(_ entityClass: AnyClass) {
-        
-        self.init(entityClass: entityClass)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From<MyPersonEntity>(nil, "Configuration1"))
-     ```
-     - parameter configuration: the `NSPersistentStore` configuration name to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     - parameter otherConfigurations: an optional list of other configuration names to associate objects from (see `configuration` parameter)
-     */
-    public init(_ configuration: String?, otherConfigurations: String?...) {
-        
-        self.init(entityClass: T.self, configurations: [configuration] + otherConfigurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From<MyPersonEntity>(["Configuration1", "Configuration2"]))
-     ```
-     - parameter configurations: a list of `NSPersistentStore` configuration names to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     */
-    public init(_ configurations: [String?]) {
-        
-        self.init(entityClass: T.self, configurations: configurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From(MyPersonEntity.self, nil, "Configuration1"))
-     ```
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter configuration: the `NSPersistentStore` configuration name to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     - parameter otherConfigurations: an optional list of other configuration names to associate objects from (see `configuration` parameter)
-     */
-    public init(_ entity: T.Type, _ configuration: String?, _ otherConfigurations: String?...) {
-        
-        self.init(entityClass: entity, configurations: [configuration] + otherConfigurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From(MyPersonEntity.self, ["Configuration1", "Configuration1"]))
-     ```
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter configurations: a list of `NSPersistentStore` configuration names to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     */
-    public init(_ entity: T.Type, _ configurations: [String?]) {
-        
-        self.init(entityClass: entity, configurations: configurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From(MyPersonEntity.self, nil, "Configuration1"))
-     ```
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter configuration: the `NSPersistentStore` configuration name to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     - parameter otherConfigurations: an optional list of other configuration names to associate objects from (see `configuration` parameter)
-     */
-    public init(_ entityClass: AnyClass, _ configuration: String?, _ otherConfigurations: String?...) {
-        
-        self.init(entityClass: entityClass, configurations: [configuration] + otherConfigurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified configurations.
-     Sample Usage:
-     ```
-     let people = transaction.fetchAll(From(MyPersonEntity.self, ["Configuration1", "Configuration1"]))
-     ```
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter configurations: a list of `NSPersistentStore` configuration names to associate objects from. This parameter is required if multiple configurations contain the created `NSManagedObject`'s entity type. Set to `nil` to use the default configuration.
-     */
-    public init(_ entityClass: AnyClass, _ configurations: [String?]) {
-        
-        self.init(entityClass: entityClass, configurations: configurations)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter storeURL: the persistent store URL to associate objects from.
-     - parameter otherStoreURLs: an optional list of other persistent store URLs to associate objects from (see `storeURL` parameter)
-     */
-    public init(_ storeURL: NSURL, _ otherStoreURLs: NSURL...) {
-        
-        self.init(entityClass: T.self, storeURLs: [storeURL] + otherStoreURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter storeURLs: the persistent store URLs to associate objects from.
-     */
-    public init(_ storeURLs: [NSURL]) {
-        
-        self.init(entityClass: T.self, storeURLs: storeURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter storeURL: the persistent store URL to associate objects from.
-     - parameter otherStoreURLs: an optional list of other persistent store URLs to associate objects from (see `storeURL` parameter)
-     */
-    public init(_ entity: T.Type, _ storeURL: NSURL, _ otherStoreURLs: NSURL...) {
-        
-        self.init(entityClass: entity, storeURLs: [storeURL] + otherStoreURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter storeURLs: the persistent store URLs to associate objects from.
-     */
-    public init(_ entity: T.Type, _ storeURLs: [NSURL]) {
-        
-        self.init(entityClass: entity, storeURLs: storeURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter storeURL: the persistent store URL to associate objects from.
-     - parameter otherStoreURLs: an optional list of other persistent store URLs to associate objects from (see `storeURL` parameter)
-     */
-    public init(_ entityClass: AnyClass, _ storeURL: NSURL, _ otherStoreURLs: NSURL...) {
-        
-        self.init(entityClass: entityClass, storeURLs: [storeURL] + otherStoreURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified store URLs.
-     
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter storeURLs: the persistent store URLs to associate objects from.
-     */
-    public init(_ entityClass: AnyClass, _ storeURLs: [NSURL]) {
-        
-        self.init(entityClass: entityClass, storeURLs: storeURLs)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter persistentStore: the `NSPersistentStore` to associate objects from.
-     - parameter otherPersistentStores: an optional list of other `NSPersistentStore`s to associate objects from (see `persistentStore` parameter)
-     */
-    public init(_ persistentStore: NSPersistentStore, _ otherPersistentStores: NSPersistentStore...) {
-        
-        self.init(entityClass: T.self, persistentStores: [persistentStore] + otherPersistentStores)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter persistentStores: the `NSPersistentStore`s to associate objects from.
-     */
-    public init(_ persistentStores: [NSPersistentStore]) {
-        
-        self.init(entityClass: T.self, persistentStores: persistentStores)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter persistentStore: the `NSPersistentStore` to associate objects from.
-     - parameter otherPersistentStores: an optional list of other `NSPersistentStore`s to associate objects from (see `persistentStore` parameter)
-     */
-    public init(_ entity: T.Type, _ persistentStore: NSPersistentStore, _ otherPersistentStores: NSPersistentStore...) {
-        
-        self.init(entityClass: entity, persistentStores: [persistentStore] + otherPersistentStores)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter entity: the associated `NSManagedObject` type
-     - parameter persistentStores: the `NSPersistentStore`s to associate objects from.
-     */
-    public init(_ entity: T.Type, _ persistentStores: [NSPersistentStore]) {
-        
-        self.init(entityClass: entity, persistentStores: persistentStores)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter persistentStore: the `NSPersistentStore` to associate objects from.
-     - parameter otherPersistentStores: an optional list of other `NSPersistentStore`s to associate objects from (see `persistentStore` parameter)
-     */
-    public init(_ entityClass: AnyClass, _ persistentStore: NSPersistentStore, _ otherPersistentStores: NSPersistentStore...) {
-        
-        self.init(entityClass: entityClass, persistentStores: [persistentStore] + otherPersistentStores)
-    }
-    
-    /**
-     Initializes a `From` clause with the specified `NSPersistentStore`s.
-     
-     - parameter entity: the associated `NSManagedObject` entity class
-     - parameter persistentStores: the `NSPersistentStore`s to associate objects from.
-     */
-    public init(_ entityClass: AnyClass, _ persistentStores: [NSPersistentStore]) {
-        
-        self.init(entityClass: entityClass, persistentStores: persistentStores)
-    }
-    
-    
-    // MARK: Internal
-    
-    internal func applyToFetchRequest(fetchRequest: NSFetchRequest, context: NSManagedObjectContext, applyAffectedStores: Bool = true) {
-        
-        fetchRequest.entity = context.entityDescriptionForEntityClass(self.entityClass)
-        if applyAffectedStores {
-            
-            self.applyAffectedStoresForFetchedRequest(fetchRequest, context: context)
-        }
-    }
-    
-    internal func applyAffectedStoresForFetchedRequest(fetchRequest: NSFetchRequest, context: NSManagedObjectContext) -> Bool {
-        
-        let stores = self.findPersistentStores(context: context)
-        fetchRequest.affectedStores = stores
-        return stores?.isEmpty == false
-    }
-    
-    
-    // MARK: Private
-    
-    private let entityClass: AnyClass
-    
-    private let findPersistentStores: (context: NSManagedObjectContext) -> [NSPersistentStore]?
-    
-    private init(entityClass: AnyClass) {
-        
-        self.entityClass = entityClass
-        self.findPersistentStores = { (context: NSManagedObjectContext) -> [NSPersistentStore]? in
-            
-            return context.parentStack?.persistentStoresForEntityClass(entityClass)
-        }
-    }
-    
-    private init(entityClass: AnyClass, configurations: [String?]) {
-        
-        let configurationsSet = Set(configurations.map { $0 ?? Into.defaultConfigurationName })
-        self.entityClass = entityClass
-        self.findPersistentStores = { (context: NSManagedObjectContext) -> [NSPersistentStore]? in
-            
-            return context.parentStack?.persistentStoresForEntityClass(entityClass)?.filter {
-                
-                return configurationsSet.contains($0.configurationName)
-            }
-        }
-    }
-    
-    private init(entityClass: AnyClass, storeURLs: [NSURL]) {
-        
-        let storeURLsSet = Set(storeURLs)
-        self.entityClass = entityClass
-        self.findPersistentStores = { (context: NSManagedObjectContext) -> [NSPersistentStore]? in
-            
-            return context.parentStack?.persistentStoresForEntityClass(entityClass)?.filter {
-                
-                return $0.URL != nil && storeURLsSet.contains($0.URL!)
-            }
-        }
-    }
-    
-    private init(entityClass: AnyClass, persistentStores: [NSPersistentStore]) {
-        
-        let persistentStores = Set(persistentStores)
-        self.entityClass = entityClass
-        self.findPersistentStores = { (context: NSManagedObjectContext) -> [NSPersistentStore]? in
-            
-            return context.parentStack?.persistentStoresForEntityClass(entityClass)?.filter {
-                
-                return persistentStores.contains($0)
-            }
-        }
-    }
-}

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

@@ -1,83 +0,0 @@
-//
-//  GroupBy.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - GroupBy
-
-/**
- The `GroupBy` clause specifies that the result of a query be grouped accoording to the specified key path.
- */
-public struct GroupBy: QueryClause {
-    
-    /**
-     Initializes a `GroupBy` clause with a list of key path strings
-     
-     - parameter keyPaths: a list of key path strings to group results with
-     */
-    public init(_ keyPaths: [KeyPath]) {
-        
-        self.keyPaths = keyPaths
-    }
-    
-    /**
-     Initializes a `GroupBy` clause with an empty list of key path strings
-     */
-    public init() {
-        
-        self.init([])
-    }
-    
-    /**
-     Initializes a `GroupBy` clause with a list of key path strings
-     
-     - parameter keyPath: a key path string to group results with
-     - parameter keyPaths: a series of key path strings to group results with
-     */
-    public init(_ keyPath: KeyPath, _ keyPaths: KeyPath...) {
-        
-        self.init([keyPath] + keyPaths)
-    }
-    
-    public let keyPaths: [KeyPath]
-    
-    
-    // MARK: QueryClause
-    
-    public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
-        
-        if let keyPaths = fetchRequest.propertiesToGroupBy as? [String] where keyPaths != self.keyPaths {
-            
-            CoreStore.log(
-                .Warning,
-                message: "An existing \"propertiesToGroupBy\" for the \(typeName(NSFetchRequest)) was overwritten by \(typeName(self)) query clause."
-            )
-        }
-        
-        fetchRequest.propertiesToGroupBy = self.keyPaths
-    }
-}

CoreStore/Fetching and Querying/Concrete Clauses/OrderBy.swift

@@ -1,150 +0,0 @@
-//
-//  OrderBy.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-public func +(left: OrderBy, right: OrderBy) -> OrderBy {
-    
-    return OrderBy(left.sortDescriptors + right.sortDescriptors)
-}
-
-public func +=(inout left: OrderBy, right: OrderBy) {
-    
-    left = left + right
-}
-
-
-// MARK: - KeyPath
-    
-public typealias KeyPath = String
-
-
-// MARK: - SortKey
-
-/**
- The `SortKey` is passed to the `OrderBy` clause to indicate the sort keys and their sort direction.
- */
-public enum SortKey {
-    
-    /**
-     Indicates that the `KeyPath` should be sorted in ascending order
-     */
-    case Ascending(KeyPath)
-    
-    /**
-     Indicates that the `KeyPath` should be sorted in descending order
-     */
-    case Descending(KeyPath)
-}
-
-
-// MARK: - OrderBy
-
-/**
- The `OrderBy` clause specifies the sort order for results for a fetch or a query.
- */
-public struct OrderBy: FetchClause, QueryClause, DeleteClause {
-    
-    /**
-     Initializes a `OrderBy` clause with a list of sort descriptors
-     
-     - parameter sortDescriptors: a series of `NSSortDescriptor`s
-     */
-    public init(_ sortDescriptors: [NSSortDescriptor]) {
-        
-        self.sortDescriptors = sortDescriptors
-    }
-    
-    /**
-     Initializes a `OrderBy` clause with an empty list of sort descriptors
-     */
-    public init() {
-        
-        self.init([NSSortDescriptor]())
-    }
-    
-    /**
-     Initializes a `OrderBy` clause with a single sort descriptor
-     
-     - parameter sortDescriptor: a `NSSortDescriptor`
-     */
-    public init(_ sortDescriptor: NSSortDescriptor) {
-        
-        self.init([sortDescriptor])
-    }
-    
-    /**
-     Initializes a `OrderBy` clause with a series of `SortKey`s
-     
-     - parameter sortKey: a series of `SortKey`s
-     */
-    public init(_ sortKey: [SortKey]) {
-        
-        self.init(
-            sortKey.map { sortKey -> NSSortDescriptor in
-                
-                switch sortKey {
-                    
-                case .Ascending(let keyPath):
-                    return NSSortDescriptor(key: keyPath, ascending: true)
-                    
-                case .Descending(let keyPath):
-                    return NSSortDescriptor(key: keyPath, ascending: false)
-                }
-            }
-        )
-    }
-    
-    /**
-     Initializes a `OrderBy` clause with a series of `SortKey`s
-     
-     - parameter sortKey: a single `SortKey`
-     - parameter sortKeys: a series of `SortKey`s
-     */
-    public init(_ sortKey: SortKey, _ sortKeys: SortKey...) {
-        
-        self.init([sortKey] + sortKeys)
-    }
-    
-    public let sortDescriptors: [NSSortDescriptor]
-    
-    
-    // MARK: FetchClause, QueryClause, DeleteClause
-    
-    public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
-        
-        if let sortDescriptors = fetchRequest.sortDescriptors where sortDescriptors != self.sortDescriptors {
-            
-            CoreStore.log(
-                .Warning,
-                message: "Existing sortDescriptors for the \(typeName(NSFetchRequest)) was overwritten by \(typeName(self)) query clause."
-            )
-        }
-        
-        fetchRequest.sortDescriptors = self.sortDescriptors
-    }
-}

CoreStore/Fetching and Querying/Concrete Clauses/Select.swift

@@ -1,668 +0,0 @@
-//
-//  Select.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - SelectResultType
-
-/**
- The `SelectResultType` protocol is implemented by return types supported by the `Select` clause.
- */
-public protocol SelectResultType { }
-
-
-// MARK: - SelectValueResultType
-
-/**
- The `SelectValueResultType` protocol is implemented by return types supported by the `queryValue(...)` methods.
- */
-public protocol SelectValueResultType: SelectResultType {
-    
-    static func fromResultObject(result: AnyObject) -> Self?
-}
-
-
-// MARK: - SelectAttributesResultType
-
-/**
- The `SelectValueResultType` protocol is implemented by return types supported by the `queryAttributes(...)` methods.
- */
-public protocol SelectAttributesResultType: SelectResultType {
-    
-    static func fromResultObjects(result: [AnyObject]) -> [[NSString: AnyObject]]
-}
-
-
-// MARK: - SelectTerm
-
-/**
- The `SelectTerm` is passed to the `Select` clause to indicate the attributes/aggregate keys to be queried.
- */
-public enum SelectTerm: StringLiteralConvertible {
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for querying an entity attribute. A shorter way to do the same is to assign from the string keypath directly:
-     ```
-     let fullName = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<String>(.Attribute("fullName")),
-         Where("employeeID", isEqualTo: 1111)
-     )
-     ```
-     is equivalent to:
-     ```
-     let fullName = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<String>("fullName"),
-         Where("employeeID", isEqualTo: 1111)
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - returns: a `SelectTerm` to a `Select` clause for querying an entity attribute
-     */
-    public static func Attribute(keyPath: KeyPath) -> SelectTerm {
-        
-        return ._Attribute(keyPath)
-    }
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for querying the average value of an attribute.
-     ```
-     let averageAge = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<Int>(.Average("age"))
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - parameter alias: the dictionary key to use to access the result. Ignored when the query return value is not an `NSDictionary`. If `nil`, the default key "average(<attributeName>)" is used
-     - returns: a `SelectTerm` to a `Select` clause for querying the average value of an attribute
-     */
-    public static func Average(keyPath: KeyPath, As alias: KeyPath? = nil) -> SelectTerm {
-        
-        return ._Aggregate(
-            function: "average:",
-            keyPath,
-            As: alias ?? "average(\(keyPath))",
-            nativeType: .DecimalAttributeType
-        )
-    }
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for a count query.
-     ```
-     let numberOfEmployees = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<Int>(.Count("employeeID"))
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - parameter alias: the dictionary key to use to access the result. Ignored when the query return value is not an `NSDictionary`. If `nil`, the default key "count(<attributeName>)" is used
-     - returns: a `SelectTerm` to a `Select` clause for a count query
-     */
-    public static func Count(keyPath: KeyPath, As alias: KeyPath? = nil) -> SelectTerm {
-        
-        return ._Aggregate(
-            function: "count:",
-            keyPath,
-            As: alias ?? "count(\(keyPath))",
-            nativeType: .Integer64AttributeType
-        )
-    }
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for querying the maximum value for an attribute.
-     ```
-     let maximumAge = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<Int>(.Maximum("age"))
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - parameter alias: the dictionary key to use to access the result. Ignored when the query return value is not an `NSDictionary`. If `nil`, the default key "max(<attributeName>)" is used
-     - returns: a `SelectTerm` to a `Select` clause for querying the maximum value for an attribute
-     */
-    public static func Maximum(keyPath: KeyPath, As alias: KeyPath? = nil) -> SelectTerm {
-        
-        return ._Aggregate(
-            function: "max:",
-            keyPath,
-            As: alias ?? "max(\(keyPath))",
-            nativeType: .UndefinedAttributeType
-        )
-    }
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for querying the minimum value for an attribute.
-     ```
-     let minimumAge = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<Int>(.Minimum("age"))
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - parameter alias: the dictionary key to use to access the result. Ignored when the query return value is not an `NSDictionary`. If `nil`, the default key "min(<attributeName>)" is used
-     - returns: a `SelectTerm` to a `Select` clause for querying the minimum value for an attribute
-     */
-    public static func Minimum(keyPath: KeyPath, As alias: KeyPath? = nil) -> SelectTerm {
-        
-        return ._Aggregate(
-            function: "min:",
-            keyPath,
-            As: alias ?? "min(\(keyPath))",
-            nativeType: .UndefinedAttributeType
-        )
-    }
-    
-    /**
-     Provides a `SelectTerm` to a `Select` clause for querying the sum value for an attribute.
-     ```
-     let totalAge = CoreStore.queryValue(
-         From(MyPersonEntity),
-         Select<Int>(.Sum("age"))
-     )
-     ```
-     - parameter keyPath: the attribute name
-     - parameter alias: the dictionary key to use to access the result. Ignored when the query return value is not an `NSDictionary`. If `nil`, the default key "sum(<attributeName>)" is used
-     - returns: a `SelectTerm` to a `Select` clause for querying the sum value for an attribute
-     */
-    public static func Sum(keyPath: KeyPath, As alias: KeyPath? = nil) -> SelectTerm {
-        
-        return ._Aggregate(
-            function: "sum:",
-            keyPath,
-            As: alias ?? "sum(\(keyPath))",
-            nativeType: .DecimalAttributeType
-        )
-    }
-    
-    
-    // MARK: StringLiteralConvertible
-    
-    public init(stringLiteral value: KeyPath) {
-        
-        self = ._Attribute(value)
-    }
-    
-    public init(unicodeScalarLiteral value: KeyPath) {
-        
-        self = ._Attribute(value)
-    }
-    
-    public init(extendedGraphemeClusterLiteral value: KeyPath) {
-        
-        self = ._Attribute(value)
-    }
-    
-    
-    // MARK: Internal
-    
-    case _Attribute(KeyPath)
-    case _Aggregate(function: String, KeyPath, As: String, nativeType: NSAttributeType)
-}
-
-
-// MARK: - Select
-
-/**
- The `Select` clause indicates the attribute / aggregate value to be queried. The generic type is a `SelectResultType`, and will be used as the return type for the query.
- 
- You can bind the return type by specializing the initializer:
- ```
- let maximumAge = CoreStore.queryValue(
-     From(MyPersonEntity),
-     Select<Int>(.Maximum("age"))
- )
- ```
- or by casting the type of the return value:
- ```
- let maximumAge: Int = CoreStore.queryValue(
-     From(MyPersonEntity),
-     Select(.Maximum("age"))
- )
- ```
- Valid return types depend on the query:
- 
- - for `queryValue(...)` methods:
-     - `Bool`
-     - `Int8`
-     - `Int16`
-     - `Int32`
-     - `Int64`
-     - `Double`
-     - `Float`
-     - `String`
-     - `NSNumber`
-     - `NSString`
-     - `NSDecimalNumber`
-     - `NSDate`
-     - `NSData`
-     - `NSManagedObjectID`
-     - `NSString`
- - for `queryAttributes(...)` methods:
-     - `NSDictionary`
- 
- - parameter sortDescriptors: a series of `NSSortDescriptor`s
- */
-public struct Select<T: SelectResultType> {
-    
-    /**
-     The `SelectResultType` type for the query's return value
-     */
-    public typealias ReturnType = T
-    
-    /**
-     Initializes a `Select` clause with a list of `SelectTerm`s
-     
-     - parameter selectTerm: a `SelectTerm`
-     - parameter selectTerms: a series of `SelectTerm`s
-     */
-    public init(_ selectTerm: SelectTerm, _ selectTerms: SelectTerm...) {
-        
-        self.selectTerms = [selectTerm] + selectTerms
-    }
-    
-    
-    // MARK: Internal
-    
-    internal func applyToFetchRequest(fetchRequest: NSFetchRequest) {
-        
-        if fetchRequest.propertiesToFetch != nil {
-            
-            CoreStore.log(
-                .Warning,
-                message: "An existing \"propertiesToFetch\" for the \(typeName(NSFetchRequest)) was overwritten by \(typeName(self)) query clause."
-            )
-        }
-        
-        fetchRequest.includesPendingChanges = false
-        fetchRequest.resultType = .DictionaryResultType
-        
-        let entityDescription = fetchRequest.entity!
-        let propertiesByName = entityDescription.propertiesByName
-        let attributesByName = entityDescription.attributesByName
-        
-        var propertiesToFetch = [AnyObject]()
-        for term in self.selectTerms {
-            
-            switch term {
-                
-            case ._Attribute(let keyPath):
-                if let propertyDescription = propertiesByName[keyPath] {
-                    
-                    propertiesToFetch.append(propertyDescription)
-                }
-                else {
-                    
-                    CoreStore.log(
-                        .Warning,
-                        message: "The property \"\(keyPath)\" does not exist in entity \(typeName(entityDescription.managedObjectClassName)) and will be ignored by \(typeName(self)) query clause."
-                    )
-                }
-                
-            case ._Aggregate(let function, let keyPath, let alias, let nativeType):
-                if let attributeDescription = attributesByName[keyPath] {
-                    
-                    let expressionDescription = NSExpressionDescription()
-                    expressionDescription.name = alias
-                    if nativeType == .UndefinedAttributeType {
-                        
-                        expressionDescription.expressionResultType = attributeDescription.attributeType
-                    }
-                    else {
-                        
-                        expressionDescription.expressionResultType = nativeType
-                    }
-                    expressionDescription.expression = NSExpression(
-                        forFunction: function,
-                        arguments: [NSExpression(forKeyPath: keyPath)]
-                    )
-                    
-                    propertiesToFetch.append(expressionDescription)
-                }
-                else {
-                    
-                    CoreStore.log(
-                        .Warning,
-                        message: "The attribute \"\(keyPath)\" does not exist in entity \(typeName(entityDescription.managedObjectClassName)) and will be ignored by \(typeName(self)) query clause."
-                    )
-                }
-            }
-        }
-        
-        fetchRequest.propertiesToFetch = propertiesToFetch
-    }
-    
-    internal func keyPathForFirstSelectTerm() -> KeyPath {
-        
-        switch self.selectTerms.first! {
-            
-        case ._Attribute(let keyPath):
-            return keyPath
-            
-        case ._Aggregate(_, _, let alias, _):
-            return alias
-        }
-    }
-    
-    
-    // MARK: Private
-    
-    private let selectTerms: [SelectTerm]
-}
-
-
-// MARK: - Bool: SelectValueResultType
-
-extension Bool: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .BooleanAttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Bool? {
-        
-        return (result as? NSNumber)?.boolValue
-    }
-}
-
-
-// MARK: - Int8: SelectValueResultType
-
-extension Int8: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Int8? {
-        
-        guard let value = (result as? NSNumber)?.longLongValue else {
-            
-            return nil
-        }
-        return numericCast(value) as Int8
-    }
-}
-
-
-// MARK: - Int16: SelectValueResultType
-
-extension Int16: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Int16? {
-        
-        guard let value = (result as? NSNumber)?.longLongValue else {
-            
-            return nil
-        }
-        return numericCast(value) as Int16
-    }
-}
-
-
-// MARK: - Int32: SelectValueResultType
-
-extension Int32: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Int32? {
-        
-        guard let value = (result as? NSNumber)?.longLongValue else {
-            
-            return nil
-        }
-        return numericCast(value) as Int32
-    }
-}
-
-
-// MARK: - Int64: SelectValueResultType
-
-extension Int64: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Int64? {
-        
-        return (result as? NSNumber)?.longLongValue
-    }
-}
-
-
-// MARK: - Int: SelectValueResultType
-
-extension Int: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Int? {
-        
-        guard let value = (result as? NSNumber)?.longLongValue else {
-            
-            return nil
-        }
-        return numericCast(value) as Int
-    }
-}
-
-
-// MARK: - Double : SelectValueResultType
-
-extension Double: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .DoubleAttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Double? {
-        
-        return (result as? NSNumber)?.doubleValue
-    }
-}
-
-
-// MARK: - Float: SelectValueResultType
-
-extension Float: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .FloatAttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> Float? {
-        
-        return (result as? NSNumber)?.floatValue
-    }
-}
-
-
-// MARK: - String: SelectValueResultType
-
-extension String: SelectValueResultType {
-    
-    public static var attributeType: NSAttributeType {
-        
-        return .StringAttributeType
-    }
-    
-    public static func fromResultObject(result: AnyObject) -> String? {
-        
-        return result as? NSString as? String
-    }
-}
-
-
-// MARK: - NSNumber: SelectValueResultType
-
-extension NSNumber: SelectValueResultType {
-    
-    public class var attributeType: NSAttributeType {
-        
-        return .Integer64AttributeType
-    }
-    
-    public class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSNumber>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSString: SelectValueResultType
-
-extension NSString: SelectValueResultType {
-    
-    public class var attributeType: NSAttributeType {
-        
-        return .StringAttributeType
-    }
-    
-    public class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSString>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSDecimalNumber: SelectValueResultType
-
-extension NSDecimalNumber {
-    
-    public override class var attributeType: NSAttributeType {
-        
-        return .DecimalAttributeType
-    }
-    
-    public override class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSDecimalNumber>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSDate: SelectValueResultType
-
-extension NSDate: SelectValueResultType {
-    
-    public class var attributeType: NSAttributeType {
-        
-        return .DateAttributeType
-    }
-    
-    public class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSDate>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSData: SelectValueResultType
-
-extension NSData: SelectValueResultType {
-    
-    public class var attributeType: NSAttributeType {
-        
-        return .BinaryDataAttributeType
-    }
-    
-    public class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSData>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSManagedObjectID: SelectValueResultType
-
-extension NSManagedObjectID: SelectValueResultType {
-    
-    public class var attributeType: NSAttributeType {
-        
-        return .ObjectIDAttributeType
-    }
-    
-    public class func fromResultObject(result: AnyObject) -> Self? {
-        
-        func forceCast<T: NSManagedObjectID>(object: AnyObject) -> T? {
-            
-            return (object as? T)
-        }
-        return forceCast(result)
-    }
-}
-
-
-// MARK: - NSManagedObjectID: SelectAttributesResultType
-
-extension NSDictionary: SelectAttributesResultType {
-    
-    // MARK: SelectAttributesResultType
-    
-    public class func fromResultObjects(result: [AnyObject]) -> [[NSString: AnyObject]] {
-        
-        return result as! [[NSString: AnyObject]]
-    }
-}

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

@@ -1,155 +0,0 @@
-//
-//  Where.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-public func &&(left: Where, right: Where) -> Where {
-    
-    return Where(NSCompoundPredicate(type: .AndPredicateType, subpredicates: [left.predicate, right.predicate]))
-}
-
-public func ||(left: Where, right: Where) -> Where {
-    
-    return Where(NSCompoundPredicate(type: .OrPredicateType, subpredicates: [left.predicate, right.predicate]))
-}
-
-public prefix func !(clause: Where) -> Where {
-    
-    return Where(NSCompoundPredicate(type: .NotPredicateType, subpredicates: [clause.predicate]))
-}
-
-
-// MARK: - Where
-
-/**
- The `Where` clause specifies the conditions for a fetch or a query.
- */
-public struct Where: FetchClause, QueryClause, DeleteClause {
-    
-    /**
-     Initializes a `Where` clause with an `NSPredicate`
-     
-     - parameter predicate: the `NSPredicate` for the fetch or query
-     */
-    public init(_ predicate: NSPredicate) {
-        
-        self.predicate = predicate
-    }
-    
-    /**
-     Initializes a `Where` clause with a predicate that always evaluates to `true`
-     */
-    public init() {
-        
-        self.init(true)
-    }
-    
-    /**
-     Initializes a `Where` clause with a predicate that always evaluates to the specified boolean value
-     
-     - parameter value: the boolean value for the predicate
-     */
-    public init(_ value: Bool) {
-        
-        self.init(NSPredicate(value: value))
-    }
-    
-    /**
-     Initializes a `Where` clause with a predicate using the specified string format and arguments
-     
-     - parameter format: the format string for the predicate
-     - parameter args: the arguments for `format`
-     */
-    public init(_ format: String, _ args: NSObject...) {
-        
-        self.init(NSPredicate(format: format, argumentArray: args))
-    }
-    
-    /**
-     Initializes a `Where` clause with a predicate using the specified string format and arguments
-     
-     - parameter format: the format string for the predicate
-     - parameter argumentArray: the arguments for `format`
-     */
-    public init(_ format: String, argumentArray: [NSObject]?) {
-        
-        self.init(NSPredicate(format: format, argumentArray: argumentArray))
-    }
-    
-    /**
-     Initializes a `Where` clause that compares equality
-     
-     - parameter keyPath: the keyPath to compare with
-     - parameter value: the arguments for the `==` operator
-     */
-    public init(_ keyPath: KeyPath, isEqualTo value: NSObject?) {
-        
-        self.init(value == nil
-            ? NSPredicate(format: "\(keyPath) == nil")
-            : NSPredicate(format: "\(keyPath) == %@", argumentArray: [value!]))
-    }
-    
-    /**
-     Initializes a `Where` clause that compares membership
-     
-     - parameter keyPath: the keyPath to compare with
-     - parameter list: the array to check membership of
-     */
-    public init(_ keyPath: KeyPath, isMemberOf list: NSArray) {
-        
-        self.init(NSPredicate(format: "\(keyPath) IN %@", list))
-    }
-    
-    /**
-     Initializes a `Where` clause that compares membership
-     
-     - parameter keyPath: the keyPath to compare with
-     - parameter list: the sequence to check membership of
-     */
-    public init<S: SequenceType where S.Generator.Element: NSObject>(_ keyPath: KeyPath, isMemberOf list: S) {
-        
-        self.init(NSPredicate(format: "\(keyPath) IN %@", Array(list) as NSArray))
-    }
-    
-    public let predicate: NSPredicate
-    
-    
-    // MARK: FetchClause, QueryClause, DeleteClause
-    
-    public func applyToFetchRequest(fetchRequest: NSFetchRequest) {
-        
-        if let predicate = fetchRequest.predicate where predicate != self.predicate {
-            
-            CoreStore.log(
-                .Warning,
-                message: "An existing predicate for the \(typeName(NSFetchRequest)) was overwritten by \(typeName(self)) query clause."
-            )
-        }
-        
-        fetchRequest.predicate = self.predicate
-    }
-}

CoreStore/Fetching and Querying/CoreStore+Querying.swift

@@ -1,275 +0,0 @@
-//
-//  CoreStore+Querying.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - CoreStore
-
-public extension CoreStore {
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObject` instance in the `DataStack`'s context from a reference created from a transaction or from a different managed object context.
-     
-     - parameter object: a reference to the object created/fetched outside the `DataStack`
-     - returns: the `NSManagedObject` instance if the object exists in the `DataStack`, or `nil` if not found.
-     */
-    @warn_unused_result
-    public static func fetchExisting<T: NSManagedObject>(object: T) -> T? {
-        
-        return self.defaultStack.fetchExisting(object)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObject` instance in the `DataStack`'s context from an `NSManagedObjectID`.
-     
-     - parameter objectID: the `NSManagedObjectID` for the object
-     - returns: the `NSManagedObject` instance if the object exists in the `DataStack`, or `nil` if not found.
-     */
-    @warn_unused_result
-    public static func fetchExisting<T: NSManagedObject>(objectID: NSManagedObjectID) -> T? {
-        
-        return self.defaultStack.fetchExisting(objectID)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObject` instances in the `DataStack`'s context from references created from a transaction or from a different managed object context.
-     
-     - parameter objects: an array of `NSManagedObject`s created/fetched outside the `DataStack`
-     - returns: the `NSManagedObject` array for objects that exists in the `DataStack`
-     */
-    @warn_unused_result
-    public static func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == T>(objects: S) -> [T] {
-        
-        return self.defaultStack.fetchExisting(objects)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObject` instances in the `DataStack`'s context from a list of `NSManagedObjectID`.
-     
-     - parameter objectIDs: the `NSManagedObjectID` array for the objects
-     - returns: the `NSManagedObject` array for objects that exists in the `DataStack`
-     */
-    @warn_unused_result
-    public static func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == NSManagedObjectID>(objectIDs: S) -> [T] {
-        
-        return self.defaultStack.fetchExisting(objectIDs)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
-        
-        return self.defaultStack.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
-        
-        return self.defaultStack.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
-        
-        return self.defaultStack.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
-        
-        return self.defaultStack.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
-        
-        return self.defaultStack.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
-        
-        return self.defaultStack.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
-        
-        return self.defaultStack.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
-        
-        return self.defaultStack.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
-        
-        return self.defaultStack.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public static func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
-        
-        return self.defaultStack.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, queries aggregate values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
-        
-        return self.defaultStack.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, queries aggregate values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public static func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
-        
-        return self.defaultStack.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, queries a dictionary of attribtue values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public static func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: QueryClause...) -> [[NSString: AnyObject]]? {
-        
-        return self.defaultStack.queryAttributes(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, queries a dictionary of attribute values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public static func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: [QueryClause]) -> [[NSString: AnyObject]]? {
-        
-        return self.defaultStack.queryAttributes(from, selectClause, queryClauses)
-    }
-}

CoreStore/Fetching and Querying/DataStack+Querying.swift

@@ -1,362 +0,0 @@
-//
-//  DataStack+Querying.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - DataStack
-
-public extension DataStack {
-    
-    /**
-     Fetches the `NSManagedObject` instance in the `DataStack`'s context from a reference created from a transaction or from a different managed object context.
-     
-     - parameter object: a reference to the object created/fetched outside the `DataStack`
-     - returns: the `NSManagedObject` instance if the object exists in the `DataStack`, or `nil` if not found.
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject>(object: T) -> T? {
-        
-        do {
-            
-            return (try self.mainContext.existingObjectWithID(object.objectID) as! T)
-        }
-        catch _ {
-            
-            return nil
-        }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instance in the `DataStack`'s context from an `NSManagedObjectID`.
-     
-     - parameter objectID: the `NSManagedObjectID` for the object
-     - returns: the `NSManagedObject` instance if the object exists in the `DataStack`, or `nil` if not found.
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject>(objectID: NSManagedObjectID) -> T? {
-        
-        do {
-            
-            return (try self.mainContext.existingObjectWithID(objectID) as! T)
-        }
-        catch _ {
-            
-            return nil
-        }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instances in the `DataStack`'s context from references created from a transaction or from a different managed object context.
-     
-     - parameter objects: an array of `NSManagedObject`s created/fetched outside the `DataStack`
-     - returns: the `NSManagedObject` array for objects that exists in the `DataStack`
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == T>(objects: S) -> [T] {
-        
-        return objects.flatMap { (try? self.mainContext.existingObjectWithID($0.objectID)) as? T }
-    }
-    
-    /**
-     Fetches the `NSManagedObject` instances in the `DataStack`'s context from a list of `NSManagedObjectID`.
-     
-     - parameter objectIDs: the `NSManagedObjectID` array for the objects
-     - returns: the `NSManagedObject` array for objects that exists in the `DataStack`
-     */
-    @warn_unused_result
-    public func fetchExisting<T: NSManagedObject, S: SequenceType where S.Generator.Element == NSManagedObjectID>(objectIDs: S) -> [T] {
-        
-        return objectIDs.flatMap { (try? self.mainContext.existingObjectWithID($0)) as? T }
-    }
-    
-    /**
-     Fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the first `NSManagedObject` instance that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the first `NSManagedObject` instance that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchOne(from, fetchClauses)
-    }
-    
-    /**
-     Fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Fetches all `NSManagedObject` instances that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: all `NSManagedObject` instances that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchAll(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the number of `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the number `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchCount(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for the first `NSManagedObject` that satisfies the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchObjectID(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Fetches the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for the fetch request. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: the `NSManagedObjectID` for all `NSManagedObject`s that satisfy the specified `FetchClause`s
-     */
-    @warn_unused_result
-    public func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to fetch from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    /**
-     Queries aggregate values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: QueryClause...) -> U? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to query from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries aggregate values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryValue<T: NSManagedObject, U: SelectValueResultType>(from: From<T>, _ selectClause: Select<U>, _ queryClauses: [QueryClause]) -> U? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to query from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.queryValue(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries a dictionary of attribute values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: QueryClause...) -> [[NSString: AnyObject]]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to query from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.queryAttributes(from, selectClause, queryClauses)
-    }
-    
-    /**
-     Queries a dictionary of attribute values as specified by the `QueryClause`s. Requires at least a `Select` clause, and optional `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     
-     A "query" differs from a "fetch" in that it only retrieves values already stored in the persistent store. As such, values from unsaved transactions or contexts will not be incorporated in the query result.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter selectClause: a `Select<U>` clause indicating the properties to fetch, and with the generic type indicating the return type.
-     - parameter queryClauses: a series of `QueryClause` instances for the query request. Accepts `Where`, `OrderBy`, `GroupBy`, and `Tweak` clauses.
-     - returns: the result of the the query. The type of the return value is specified by the generic type of the `Select<U>` parameter.
-     */
-    @warn_unused_result
-    public func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: [QueryClause]) -> [[NSString: AnyObject]]? {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to query from a \(typeName(self)) outside the main thread."
-        )
-        
-        return self.mainContext.queryAttributes(from, selectClause, queryClauses)
-    }
-}

CoreStore/Importing Data/BaseDataTransaction+Importing.swift

@@ -1,248 +0,0 @@
-//
-//  BaseDataTransaction+Importing.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - BaseDataTransaction
-
-public extension BaseDataTransaction {
-    
-    /**
-     Creates an `ImportableObject` by importing from the specified import source.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter source: the object to import values from
-     - returns: the created `ImportableObject` instance, or `nil` if the import was ignored
-     */
-    public func importObject<T where T: NSManagedObject, T: ImportableObject>(
-        into: Into<T>,
-        source: T.ImportSource) throws -> T? {
-            
-            CoreStore.assert(
-                self.isRunningInAllowedQueue(),
-                "Attempted to import an object of type \(typeName(into.entityClass)) outside the transaction's designated queue."
-            )
-            
-            return try autoreleasepool {
-                
-                guard T.shouldInsertFromImportSource(source, inTransaction: self) else {
-                    
-                    return nil
-                }
-                
-                let object = self.create(into)
-                try object.didInsertFromImportSource(source, inTransaction: self)
-                return object
-            }
-    }
-    
-    /**
-     Updates an existing `ImportableObject` by importing values from the specified import source.
-     
-     - parameter object: the `NSManagedObject` to update
-     - parameter source: the object to import values from
-     */
-    public func importObject<T where T: NSManagedObject, T: ImportableObject>(
-        object: T,
-        source: T.ImportSource) throws {
-            
-            CoreStore.assert(
-                self.isRunningInAllowedQueue(),
-                "Attempted to import an object of type \(typeName(object)) outside the transaction's designated queue."
-            )
-            
-            try autoreleasepool {
-                
-                guard T.shouldInsertFromImportSource(source, inTransaction: self) else {
-                    
-                    return
-                }
-                
-                try object.didInsertFromImportSource(source, inTransaction: self)
-            }
-    }
-    
-    /**
-     Creates multiple `ImportableObject`s by importing from the specified array of import sources.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter sourceArray: the array of objects to import values from
-     - returns: the array of created `ImportableObject` instances
-     */
-    public func importObjects<T, S: SequenceType where T: NSManagedObject, T: ImportableObject, S.Generator.Element == T.ImportSource>(
-        into: Into<T>,
-        sourceArray: S) throws -> [T] {
-            
-            CoreStore.assert(
-                self.isRunningInAllowedQueue(),
-                "Attempted to import an object of type \(typeName(into.entityClass)) outside the transaction's designated queue."
-            )
-            
-            return try autoreleasepool {
-                
-                return try sourceArray.flatMap { (source) -> T? in
-                    
-                    guard T.shouldInsertFromImportSource(source, inTransaction: self) else {
-                        
-                        return nil
-                    }
-                    
-                    return try autoreleasepool {
-                        
-                        let object = self.create(into)
-                        try object.didInsertFromImportSource(source, inTransaction: self)
-                        return object
-                    }
-                }
-            }
-    }
-    
-    /**
-     Updates an existing `ImportableUniqueObject` or creates a new instance by importing from the specified import source.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter source: the object to import values from
-     - returns: the created/updated `ImportableUniqueObject` instance, or `nil` if the import was ignored
-     */
-    public func importUniqueObject<T where T: NSManagedObject, T: ImportableUniqueObject>(
-        into: Into<T>,
-        source: T.ImportSource) throws -> T?  {
-            
-            CoreStore.assert(
-                self.isRunningInAllowedQueue(),
-                "Attempted to import an object of type \(typeName(into.entityClass)) outside the transaction's designated queue."
-            )
-            
-            return try autoreleasepool {
-                
-                let uniqueIDKeyPath = T.uniqueIDKeyPath
-                guard let uniqueIDValue = try T.uniqueIDFromImportSource(source, inTransaction: self) else {
-                    
-                    return nil
-                }
-                
-                if let object = self.fetchOne(From(T), Where(uniqueIDKeyPath, isEqualTo: uniqueIDValue)) {
-                    
-                    guard T.shouldUpdateFromImportSource(source, inTransaction: self) else {
-                        
-                        return nil
-                    }
-                    
-                    try object.updateFromImportSource(source, inTransaction: self)
-                    return object
-                }
-                else {
-                    
-                    guard T.shouldInsertFromImportSource(source, inTransaction: self) else {
-                        
-                        return nil
-                    }
-                    
-                    let object = self.create(into)
-                    object.uniqueIDValue = uniqueIDValue
-                    try object.didInsertFromImportSource(source, inTransaction: self)
-                    return object
-                }
-            }
-    }
-    
-    /**
-     Updates existing `ImportableUniqueObject`s or creates them by importing from the specified array of import sources.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter sourceArray: the array of objects to import values from
-     - parameter preProcess: a closure that lets the caller tweak the internal `UniqueIDType`-to-`ImportSource` mapping to be used for importing. Callers can remove from/add to/update `mapping` and return the updated array from the closure.
-     - returns: the array of created/updated `ImportableUniqueObject` instances
-     */
-    public func importUniqueObjects<T, S: SequenceType where T: NSManagedObject, T: ImportableUniqueObject, S.Generator.Element == T.ImportSource>(
-        into: Into<T>,
-        sourceArray: S,
-        @noescape preProcess: (mapping: [T.UniqueIDType: T.ImportSource]) throws -> [T.UniqueIDType: T.ImportSource] = { $0 }) throws -> [T] {
-            
-            CoreStore.assert(
-                self.isRunningInAllowedQueue(),
-                "Attempted to import an object of type \(typeName(into.entityClass)) outside the transaction's designated queue."
-            )
-            
-            return try autoreleasepool {
-                
-                var mapping = Dictionary<T.UniqueIDType, T.ImportSource>()
-                let sortedIDs = try autoreleasepool {
-                    
-                    return try sourceArray.flatMap { (source) -> T.UniqueIDType? in
-                        
-                        guard let uniqueIDValue = try T.uniqueIDFromImportSource(source, inTransaction: self) else {
-                            
-                            return nil
-                        }
-                        
-                        mapping[uniqueIDValue] = source
-                        return uniqueIDValue
-                    }
-                }
-                
-                mapping = try autoreleasepool { try preProcess(mapping: mapping) }
-                
-                var objects = Dictionary<T.UniqueIDType, T>()
-                for object in self.fetchAll(From(T), Where(T.uniqueIDKeyPath, isMemberOf: mapping.keys)) ?? [] {
-                    
-                    try autoreleasepool {
-                        
-                        let uniqueIDValue = object.uniqueIDValue
-                        
-                        guard let source = mapping.removeValueForKey(uniqueIDValue)
-                            where T.shouldUpdateFromImportSource(source, inTransaction: self) else {
-                                
-                                return
-                        }
-                        
-                        try object.updateFromImportSource(source, inTransaction: self)
-                        objects[uniqueIDValue] = object
-                    }
-                }
-                
-                for (uniqueIDValue, source) in mapping {
-                    
-                    try autoreleasepool {
-                        
-                        guard T.shouldInsertFromImportSource(source, inTransaction: self) else {
-                            
-                            return
-                        }
-                        
-                        let object = self.create(into)
-                        object.uniqueIDValue = uniqueIDValue
-                        try object.didInsertFromImportSource(source, inTransaction: self)
-                        
-                        objects[uniqueIDValue] = object
-                    }
-                }
-                
-                return sortedIDs.flatMap { objects[$0] }
-            }
-    }
-}

CoreStore/Internal/AssociatedObjects.swift

@@ -1,68 +0,0 @@
-//
-//  NSObject+CoreStore.swift
-//  CoreStore
-//
-//  Copyright © 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
-
-internal func getAssociatedObjectForKey<T: AnyObject>(key: UnsafePointer<Void>, inObject object: AnyObject) -> T? {
-    
-    switch objc_getAssociatedObject(object, key) {
-        
-    case let associatedObject as T:
-        return associatedObject
-        
-    case let associatedObject as WeakObject:
-        return associatedObject.object as? T
-        
-    default:
-        return nil
-    }
-}
-
-internal func setAssociatedRetainedObject<T: AnyObject>(associatedObject: T?, forKey key: UnsafePointer<Void>, inObject object: AnyObject) {
-    
-    objc_setAssociatedObject(object, key, associatedObject, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
-}
-
-internal func setAssociatedCopiedObject<T: AnyObject>(associatedObject: T?, forKey key: UnsafePointer<Void>, inObject object: AnyObject) {
-    
-    objc_setAssociatedObject(object, key, associatedObject, .OBJC_ASSOCIATION_COPY_NONATOMIC)
-}
-
-internal func setAssociatedAssignedObject<T: AnyObject>(associatedObject: T?, forKey key: UnsafePointer<Void>, inObject object: AnyObject) {
-    
-    objc_setAssociatedObject(object, key, associatedObject, .OBJC_ASSOCIATION_ASSIGN)
-}
-
-internal func setAssociatedWeakObject<T: AnyObject>(associatedObject: T?, forKey key: UnsafePointer<Void>, inObject object: AnyObject) {
-    
-    if let associatedObject = associatedObject {
-        
-        objc_setAssociatedObject(object, key, WeakObject(associatedObject), .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
-    }
-    else {
-        
-        objc_setAssociatedObject(object, key, nil, .OBJC_ASSOCIATION_RETAIN_NONATOMIC)
-    }
-}

CoreStore/Internal/CoreStoreFetchedResultsController.swift

@@ -1,101 +0,0 @@
-//
-//  CoreStoreFetchedResultsController.swift
-//  CoreStore
-//
-//  Copyright © 2016 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: - CoreStoreFetchedResultsController
-
-@available(OSX, unavailable)
-internal final class CoreStoreFetchedResultsController<T: NSManagedObject>: NSFetchedResultsController {
-    
-    
-    // MARK: Internal
-    
-    internal convenience init<T>(dataStack: DataStack, fetchRequest: NSFetchRequest, from: From<T>? = nil, sectionBy: SectionBy? = nil, fetchClauses: [FetchClause]) {
-        
-        self.init(
-            context: dataStack.mainContext,
-            fetchRequest: fetchRequest,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    internal init<T>(context: NSManagedObjectContext, fetchRequest: NSFetchRequest, from: From<T>? = nil, sectionBy: SectionBy? = nil, fetchClauses: [FetchClause]) {
-        
-        from?.applyToFetchRequest(fetchRequest, context: context, applyAffectedStores: false)
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        if let from = from {
-            
-            self.reapplyAffectedStores = {
-                
-                return from.applyAffectedStoresForFetchedRequest(fetchRequest, context: context)
-            }
-        }
-        else {
-            
-            guard let from = (fetchRequest.entity.flatMap { $0.managedObjectClassName }).flatMap(NSClassFromString).flatMap(From.init) else {
-                
-                fatalError("Attempted to create an \(typeName(NSFetchedResultsController)) without a  From clause or an NSEntityDescription.")
-            }
-            
-            self.reapplyAffectedStores = {
-                
-                return from.applyAffectedStoresForFetchedRequest(fetchRequest, context: context)
-            }
-        }
-        
-        super.init(
-            fetchRequest: fetchRequest,
-            managedObjectContext: context,
-            sectionNameKeyPath: sectionBy?.sectionKeyPath,
-            cacheName: nil
-        )
-    }
-    
-    internal func performFetchFromSpecifiedStores() throws {
-        
-        if !self.reapplyAffectedStores() {
-            
-            CoreStore.log(
-                .Warning,
-                message: "Attempted to perform a fetch on an \(typeName(NSFetchedResultsController)) but could not find any persistent store for the entity \(typeName(self.fetchRequest.entityName))"
-            )
-        }
-        try self.performFetch()
-    }
-    
-    
-    // MARK: Private
-    
-    private let reapplyAffectedStores: () -> Bool
-}

CoreStore/Internal/FetchedResultsControllerDelegate.swift

@@ -1,219 +0,0 @@
-//
-//  FetchedResultsControllerDelegate.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - FetchedResultsControllerHandler
-
-@available(OSX, unavailable)
-internal protocol FetchedResultsControllerHandler: class {
-    
-    func controller(controller: NSFetchedResultsController, didChangeObject anObject: AnyObject, atIndexPath indexPath: NSIndexPath?, forChangeType type: NSFetchedResultsChangeType, newIndexPath: NSIndexPath?)
-    
-    func controller(controller: NSFetchedResultsController, didChangeSection sectionInfo: NSFetchedResultsSectionInfo, atIndex sectionIndex: Int, forChangeType type: NSFetchedResultsChangeType)
-    
-    func controllerWillChangeContent(controller: NSFetchedResultsController)
-    
-    func controllerDidChangeContent(controller: NSFetchedResultsController)
-    
-    func controller(controller: NSFetchedResultsController, sectionIndexTitleForSectionName sectionName: String?) -> String?
-}
-
-
-// MARK: - FetchedResultsControllerDelegate
-
-@available(OSX, unavailable)
-internal final class FetchedResultsControllerDelegate: NSObject, NSFetchedResultsControllerDelegate {
-    
-    // MARK: Internal
-    
-    internal var enabled = true
-    
-    internal weak var handler: FetchedResultsControllerHandler?
-    internal weak var fetchedResultsController: NSFetchedResultsController? {
-        
-        didSet {
-            
-            oldValue?.delegate = nil
-            self.fetchedResultsController?.delegate = self
-        }
-    }
-    
-    deinit {
-        
-        self.fetchedResultsController?.delegate = nil
-    }
-    
-    
-    // MARK: NSFetchedResultsControllerDelegate
-    
-    @objc dynamic func controllerWillChangeContent(controller: NSFetchedResultsController) {
-        
-        guard self.enabled else {
-            
-            return
-        }
-        
-        self.deletedSections = []
-        self.insertedSections = []
-        
-        self.handler?.controllerWillChangeContent(controller)
-    }
-    
-    @objc dynamic func controllerDidChangeContent(controller: NSFetchedResultsController) {
-        
-        guard self.enabled else {
-            
-            return
-        }
-        
-        self.handler?.controllerDidChangeContent(controller)
-    }
-    
-    @objc dynamic func controller(controller: NSFetchedResultsController, didChangeObject anObject: AnyObject, atIndexPath indexPath: NSIndexPath?, forChangeType type: NSFetchedResultsChangeType, newIndexPath: NSIndexPath?) {
-        
-        guard self.enabled else {
-            
-            return
-        }
-        
-        guard let actualType = NSFetchedResultsChangeType(rawValue: type.rawValue) else {
-            
-            // This fix is for a bug where iOS passes 0 for NSFetchedResultsChangeType, but this is not a valid enum case.
-            // Swift will then always execute the first case of the switch causing strange behaviour.
-            // https://forums.developer.apple.com/thread/12184#31850
-            return
-        }
-        
-        // This whole dance is a workaround for a nasty bug introduced in XCode 7 targeted at iOS 8 devices
-        // http://stackoverflow.com/questions/31383760/ios-9-attempt-to-delete-and-reload-the-same-index-path/31384014#31384014
-        // https://forums.developer.apple.com/message/9998#9998
-        // https://forums.developer.apple.com/message/31849#31849
-        
-        switch actualType {
-            
-        case .Update:
-            guard let section = indexPath?.indexAtPosition(0) else {
-                
-                return
-            }
-            if self.deletedSections.contains(section)
-                || self.insertedSections.contains(section) {
-                    
-                    return
-            }
-            
-        case .Move:
-            guard let indexPath = indexPath, let newIndexPath = newIndexPath else {
-                
-                return
-            }
-            guard indexPath == newIndexPath else {
-                
-                break
-            }
-            if self.insertedSections.contains(indexPath.indexAtPosition(0)) {
-                
-                // Observers that handle the .Move change are advised to delete then reinsert the object instead of just moving. This is especially true when indexPath and newIndexPath are equal. For example, calling tableView.moveRowAtIndexPath(_:toIndexPath) when both indexPaths are the same will crash the tableView.
-                self.handler?.controller(
-                    controller,
-                    didChangeObject: anObject,
-                    atIndexPath: indexPath,
-                    forChangeType: .Move,
-                    newIndexPath: newIndexPath
-                )
-                return
-            }
-            if self.deletedSections.contains(indexPath.indexAtPosition(0)) {
-                
-                self.handler?.controller(
-                    controller,
-                    didChangeObject: anObject,
-                    atIndexPath: nil,
-                    forChangeType: .Insert,
-                    newIndexPath: indexPath
-                )
-                return
-            }
-            self.handler?.controller(
-                controller,
-                didChangeObject: anObject,
-                atIndexPath: indexPath,
-                forChangeType: .Update,
-                newIndexPath: nil
-            )
-            return
-            
-        default:
-            break
-        }
-        
-        self.handler?.controller(
-            controller,
-            didChangeObject: anObject,
-            atIndexPath: indexPath,
-            forChangeType: actualType,
-            newIndexPath: newIndexPath
-        )
-    }
-    
-    @objc dynamic func controller(controller: NSFetchedResultsController, didChangeSection sectionInfo: NSFetchedResultsSectionInfo, atIndex sectionIndex: Int, forChangeType type: NSFetchedResultsChangeType) {
-        
-        guard self.enabled else {
-            
-            return
-        }
-        
-        switch type {
-            
-        case .Delete:   self.deletedSections.insert(sectionIndex)
-        case .Insert:   self.insertedSections.insert(sectionIndex)
-        default: break
-        }
-        
-        self.handler?.controller(
-            controller,
-            didChangeSection: sectionInfo,
-            atIndex: sectionIndex,
-            forChangeType: type
-        )
-    }
-    
-    @objc dynamic func controller(controller: NSFetchedResultsController, sectionIndexTitleForSectionName sectionName: String) -> String? {
-        
-        return self.handler?.controller(
-            controller,
-            sectionIndexTitleForSectionName: sectionName
-        )
-    }
-    
-    
-    // MARK: Private
-    
-    private var deletedSections = Set<Int>()
-    private var insertedSections = Set<Int>()
-}

CoreStore/Internal/NSFileManager+Setup.swift

@@ -1,26 +0,0 @@
-//
-//  NSFileManager+Setup.swift
-//  CoreStore
-//
-//  Created by John Rommel Estropia on 2015/07/19.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import Foundation
-
-
-// MARK: - NSFileManager
-
-internal extension NSFileManager {
-    
-    // MARK: Internal
-    
-    internal func removeSQLiteStoreAtURL(fileURL: NSURL) {
-        
-        _ = try? self.removeItemAtURL(fileURL)
-        
-        let filePath = fileURL.path!
-        _ = try? self.removeItemAtPath(filePath.stringByAppendingString("-shm"))
-        _ = try? self.removeItemAtPath(filePath.stringByAppendingString("-wal"))
-    }
-}

CoreStore/Internal/NSManagedObjectContext+CoreStore.swift

@@ -1,136 +0,0 @@
-//
-//  NSManagedObjectContext+CoreStore.swift
-//  CoreStore
-//
-//  Copyright © 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - NSManagedObjectContext
-
-internal extension NSManagedObjectContext {
-    
-    // MARK: Internal
-    
-    internal var shouldCascadeSavesToParent: Bool {
-        
-        get {
-            
-            let number: NSNumber? = getAssociatedObjectForKey(
-                &PropertyKeys.shouldCascadeSavesToParent,
-                inObject: self
-            )
-            return number?.boolValue ?? false
-        }
-        set {
-            
-            setAssociatedCopiedObject(
-                NSNumber(bool: newValue),
-                forKey: &PropertyKeys.shouldCascadeSavesToParent,
-                inObject: self
-            )
-        }
-    }
-    
-    internal func entityDescriptionForEntityType(entity: NSManagedObject.Type) -> NSEntityDescription? {
-        
-        return self.entityDescriptionForEntityClass(entity)
-    }
-    
-    internal func entityDescriptionForEntityClass(entity: AnyClass) -> NSEntityDescription? {
-        
-        guard let entityName = self.parentStack?.entityNameForEntityClass(entity) else {
-            
-            return nil
-        }
-        return NSEntityDescription.entityForName(
-            entityName,
-            inManagedObjectContext: self
-        )
-    }
-    
-    internal func setupForCoreStoreWithContextName(contextName: String) {
-        
-        self.name = contextName
-        
-        self.observerForWillSaveNotification = NotificationObserver(
-            notificationName: NSManagedObjectContextWillSaveNotification,
-            object: self,
-            closure: { (note) -> Void in
-                
-                let context = note.object as! NSManagedObjectContext
-                let insertedObjects = context.insertedObjects
-                let numberOfInsertedObjects = insertedObjects.count
-                guard numberOfInsertedObjects > 0 else {
-                    
-                    return
-                }
-                
-                do {
-                    
-                    try context.obtainPermanentIDsForObjects(Array(insertedObjects))
-                }
-                catch {
-                    
-                    CoreStore.handleError(
-                        error as NSError,
-                        "Failed to obtain permanent ID(s) for \(numberOfInsertedObjects) inserted object(s)."
-                    )
-                }
-            }
-        )
-    }
-    
-    
-    // MARK: Private
-    
-    private struct PropertyKeys {
-        
-        static var observerForWillSaveNotification: Void?
-        static var shouldCascadeSavesToParent: Void?
-    }
-    
-    private var observerForWillSaveNotification: NotificationObserver? {
-        
-        get {
-            
-            return getAssociatedObjectForKey(
-                &PropertyKeys.observerForWillSaveNotification,
-                inObject: self
-            )
-        }
-        set {
-            
-            setAssociatedRetainedObject(
-                newValue,
-                forKey: &PropertyKeys.observerForWillSaveNotification,
-                inObject: self
-            )
-        }
-    }
-}
-

CoreStore/Internal/NSManagedObjectContext+Querying.swift

@@ -1,422 +0,0 @@
-//
-//  NSManagedObjectContext+Querying.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - NSManagedObjectContext
-
-internal extension NSManagedObjectContext {
-    
-    // MARK: Internal
-    
-    internal func fetchExisting<T: NSManagedObject>(object: T) -> T? {
-        
-        if object.objectID.temporaryID {
-            
-            do {
-                
-                try withExtendedLifetime(self) { (context: NSManagedObjectContext) -> Void in
-                    
-                    try context.obtainPermanentIDsForObjects([object])
-                }
-            }
-            catch {
-                
-                CoreStore.handleError(
-                    error as NSError,
-                    "Failed to obtain permanent ID for object."
-                )
-                return nil
-            }
-        }
-        
-        do {
-            
-            let existingObject = try self.existingObjectWithID(object.objectID)
-            return (existingObject as! T)
-        }
-        catch {
-            
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to load existing \(typeName(object)) in context."
-            )
-            return nil
-        }
-    }
-    
-    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> T? {
-        
-        return self.fetchOne(from, fetchClauses)
-    }
-    
-    internal func fetchOne<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> T? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 1
-        fetchRequest.resultType = .ManagedObjectResultType
-        
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [T]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest) as? [T]
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if fetchResults == nil {
-            
-            CoreStore.handleError(
-                fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return fetchResults?.first
-    }
-    
-    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [T]? {
-        
-        return self.fetchAll(from, fetchClauses)
-    }
-    
-    internal func fetchAll<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [T]? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 0
-        fetchRequest.resultType = .ManagedObjectResultType
-        
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [T]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest) as? [T]
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if fetchResults == nil {
-            
-            CoreStore.handleError(
-                fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return fetchResults
-    }
-    
-    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> Int? {
-    
-        return self.fetchCount(from, fetchClauses)
-    }
-    
-    internal func fetchCount<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> Int? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var count = 0
-        var error: NSError?
-        self.performBlockAndWait {
-            
-            count = self.countForFetchRequest(fetchRequest, error: &error)
-        }
-        if count == NSNotFound {
-            
-            CoreStore.handleError(
-                error ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return count
-    }
-    
-    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> NSManagedObjectID? {
-        
-        return self.fetchObjectID(from, fetchClauses)
-    }
-    
-    internal func fetchObjectID<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> NSManagedObjectID? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 1
-        fetchRequest.resultType = .ManagedObjectIDResultType
-        
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [NSManagedObjectID]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest) as? [NSManagedObjectID]
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if fetchResults == nil {
-            
-            CoreStore.handleError(
-                fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return fetchResults?.first
-    }
-    
-    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> [NSManagedObjectID]? {
-        
-        return self.fetchObjectIDs(from, fetchClauses)
-    }
-    
-    internal func fetchObjectIDs<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> [NSManagedObjectID]? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 0
-        fetchRequest.resultType = .ManagedObjectIDResultType
-        
-        for clause in fetchClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [NSManagedObjectID]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest) as? [NSManagedObjectID]
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if fetchResults == nil {
-            
-            CoreStore.handleError(
-                fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return fetchResults
-    }
-    
-    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: DeleteClause...) -> Int? {
-        
-        return self.deleteAll(from, deleteClauses)
-    }
-    
-    internal func deleteAll<T: NSManagedObject>(from: From<T>, _ deleteClauses: [DeleteClause]) -> Int? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 0
-        fetchRequest.resultType = .ManagedObjectResultType
-        fetchRequest.returnsObjectsAsFaults = true
-        fetchRequest.includesPropertyValues = false
-        
-        for clause in deleteClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var numberOfDeletedObjects: Int?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            autoreleasepool {
-                
-                do {
-                    
-                    let fetchResults = try self.executeFetchRequest(fetchRequest) as? [T] ?? []
-                    for object in fetchResults {
-                        
-                        self.deleteObject(object)
-                    }
-                    numberOfDeletedObjects = fetchResults.count
-                }
-                catch {
-                    
-                    fetchError = error as NSError
-                }
-            }
-        }
-        if numberOfDeletedObjects == nil {
-            
-            CoreStore.handleError(
-                fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-                "Failed executing fetch request."
-            )
-            return nil
-        }
-        
-        return numberOfDeletedObjects
-    }
-    
-    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: [QueryClause]) -> U? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 0
-        
-        selectClause.applyToFetchRequest(fetchRequest)
-        
-        for clause in queryClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [AnyObject]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest)
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if let fetchResults = fetchResults {
-            
-            if let rawResult = fetchResults.first as? NSDictionary,
-                let rawObject: AnyObject = rawResult[selectClause.keyPathForFirstSelectTerm()] {
-                    
-                    return Select<U>.ReturnType.fromResultObject(rawObject)
-            }
-            return nil
-        }
-        
-        CoreStore.handleError(
-            fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-            "Failed executing fetch request."
-        )
-        return nil
-    }
-    
-    internal func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: QueryClause...) -> [[NSString: AnyObject]]? {
-        
-        return self.queryAttributes(from, selectClause, queryClauses)
-    }
-    
-    internal func queryAttributes<T: NSManagedObject>(from: From<T>, _ selectClause: Select<NSDictionary>, _ queryClauses: [QueryClause]) -> [[NSString: AnyObject]]? {
-        
-        let fetchRequest = NSFetchRequest()
-        from.applyToFetchRequest(fetchRequest, context: self)
-        
-        fetchRequest.fetchLimit = 0
-        
-        selectClause.applyToFetchRequest(fetchRequest)
-        
-        for clause in queryClauses {
-            
-            clause.applyToFetchRequest(fetchRequest)
-        }
-        
-        var fetchResults: [AnyObject]?
-        var fetchError: NSError?
-        self.performBlockAndWait {
-            
-            do {
-                
-                fetchResults = try self.executeFetchRequest(fetchRequest)
-            }
-            catch {
-                
-                fetchError = error as NSError
-            }
-        }
-        if let fetchResults = fetchResults {
-            
-            return Select<NSDictionary>.ReturnType.fromResultObjects(fetchResults)
-        }
-        
-        CoreStore.handleError(
-            fetchError ?? NSError(coreStoreErrorCode: .UnknownError),
-            "Failed executing fetch request."
-        )
-        return nil
-    }
-}

CoreStore/Internal/NSManagedObjectContext+Setup.swift

@@ -1,127 +0,0 @@
-//
-//  NSManagedObjectContext+Setup.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - NSManagedObjectContext
-
-internal extension NSManagedObjectContext {
-    
-    // MARK: Internal
-    
-    internal weak var parentStack: DataStack? {
-        
-        get {
-            
-            if let parentContext = self.parentContext {
-                
-                return parentContext.parentStack
-            }
-            
-            return getAssociatedObjectForKey(&PropertyKeys.parentStack, inObject: self)
-        }
-        set {
-            
-            guard self.parentContext == nil else {
-                
-                return
-            }
-            
-            setAssociatedWeakObject(
-                newValue,
-                forKey: &PropertyKeys.parentStack,
-                inObject: self
-            )
-        }
-    }
-    
-    internal class func rootSavingContextForCoordinator(coordinator: NSPersistentStoreCoordinator) -> NSManagedObjectContext {
-        
-        let context = NSManagedObjectContext(concurrencyType: .PrivateQueueConcurrencyType)
-        context.persistentStoreCoordinator = coordinator
-        context.mergePolicy = NSMergeByPropertyObjectTrumpMergePolicy
-        context.undoManager = nil
-        context.setupForCoreStoreWithContextName("com.corestore.rootcontext")
-        
-        return context
-    }
-    
-    internal class func mainContextForRootContext(rootContext: NSManagedObjectContext) -> NSManagedObjectContext {
-        
-        let context = NSManagedObjectContext(concurrencyType: .MainQueueConcurrencyType)
-        context.parentContext = rootContext
-        context.mergePolicy = NSRollbackMergePolicy
-        context.undoManager = nil
-        context.setupForCoreStoreWithContextName("com.corestore.maincontext")
-        context.observerForDidSaveNotification = NotificationObserver(
-            notificationName: NSManagedObjectContextDidSaveNotification,
-            object: rootContext,
-            closure: { [weak context] (note) -> Void in
-                
-                context?.performBlock { () -> Void in
-                    
-                    let updatedObjects = (note.userInfo?[NSUpdatedObjectsKey] as? Set<NSManagedObject>) ?? []
-                    for object in updatedObjects {
-                        
-                        context?.objectWithID(object.objectID).willAccessValueForKey(nil)
-                    }
-                    context?.mergeChangesFromContextDidSaveNotification(note)
-                }
-            }
-        )
-        
-        return context
-    }
-    
-    
-    // MARK: Private
-    
-    private struct PropertyKeys {
-        
-        static var parentStack: Void?
-        static var observerForDidSaveNotification: Void?
-    }
-    
-    private var observerForDidSaveNotification: NotificationObserver? {
-        
-        get {
-            
-            return getAssociatedObjectForKey(
-                &PropertyKeys.observerForDidSaveNotification,
-                inObject: self
-            )
-        }
-        set {
-            
-            setAssociatedRetainedObject(
-                newValue,
-                forKey: &PropertyKeys.observerForDidSaveNotification,
-                inObject: self
-            )
-        }
-    }
-}

CoreStore/Internal/NSManagedObjectContext+Transaction.swift

@@ -1,189 +0,0 @@
-//
-//  NSManagedObjectContext+Transaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - NSManagedObjectContext
-
-internal extension NSManagedObjectContext {
-    
-    // MARK: Internal
-    
-    internal weak var parentTransaction: BaseDataTransaction? {
-        
-        get {
-            
-            return getAssociatedObjectForKey(
-                &PropertyKeys.parentTransaction,
-                inObject: self
-            )
-        }
-        set {
-            
-            setAssociatedWeakObject(
-                newValue,
-                forKey: &PropertyKeys.parentTransaction,
-                inObject: self
-            )
-        }
-    }
-    
-    internal func isRunningInAllowedQueue() -> Bool {
-        
-        guard let parentTransaction = self.parentTransaction else {
-            
-            return false
-        }
-        return parentTransaction.isRunningInAllowedQueue()
-    }
-    
-    internal func temporaryContextInTransactionWithConcurrencyType(concurrencyType: NSManagedObjectContextConcurrencyType) -> NSManagedObjectContext {
-        
-        let context = NSManagedObjectContext(concurrencyType: concurrencyType)
-        context.parentContext = self
-        context.parentStack = self.parentStack
-        context.setupForCoreStoreWithContextName("com.corestore.temporarycontext")
-        context.shouldCascadeSavesToParent = (self.parentStack?.rootSavingContext == self)
-        context.retainsRegisteredObjects = true
-        
-        return context
-    }
-    
-    internal func saveSynchronously() -> SaveResult {
-        
-        var result = SaveResult(hasChanges: false)
-        
-        self.performBlockAndWait { [unowned self] () -> Void in
-            
-            guard self.hasChanges else {
-                
-                return
-            }
-            
-            do {
-                
-                try self.save()
-            }
-            catch {
-                
-                let saveError = error as NSError
-                CoreStore.handleError(
-                    saveError,
-                    "Failed to save \(typeName(NSManagedObjectContext))."
-                )
-                result = SaveResult(saveError)
-                return
-            }
-            
-            if let parentContext = self.parentContext where self.shouldCascadeSavesToParent {
-                
-                switch parentContext.saveSynchronously() {
-                    
-                case .Success:
-                    result = SaveResult(hasChanges: true)
-                    
-                case .Failure(let error):
-                    result = SaveResult(error)
-                }
-            }
-            else {
-                
-                result = SaveResult(hasChanges: true)
-            }
-        }
-        
-        return result
-    }
-    
-    internal func saveAsynchronouslyWithCompletion(completion: ((result: SaveResult) -> Void) = { _ in }) {
-        
-        self.performBlock { () -> Void in
-            
-            guard self.hasChanges else {
-                
-                GCDQueue.Main.async {
-                    
-                    completion(result: SaveResult(hasChanges: false))
-                }
-                return
-            }
-            
-            do {
-                
-                try self.save()
-            }
-            catch {
-                
-                let saveError = error as NSError
-                CoreStore.handleError(
-                    saveError,
-                    "Failed to save \(typeName(NSManagedObjectContext))."
-                )
-                GCDQueue.Main.async {
-                    
-                    completion(result: SaveResult(saveError))
-                }
-                return
-            }
-            
-            if let parentContext = self.parentContext where self.shouldCascadeSavesToParent {
-                
-                parentContext.saveAsynchronouslyWithCompletion(completion)
-            }
-            else {
-                
-                GCDQueue.Main.async {
-                    
-                    completion(result: SaveResult(hasChanges: true))
-                }
-            }
-        }
-    }
-    
-    internal func refreshAllObjectsAsFaults() {
-        
-        if #available(iOS 8.3, OSX 10.11, *) {
-            
-            self.refreshAllObjects()
-        }
-        else {
-            
-            self.registeredObjects.forEach { self.refreshObject($0, mergeChanges: false) }
-        }
-    }
-    
-    
-    // MARK: Private
-    
-    private struct PropertyKeys {
-        
-        static var parentTransaction: Void?
-    }
-}

CoreStore/Internal/NSManagedObjectModel+Setup.swift

@@ -1,281 +0,0 @@
-//
-//  NSManagedObjectModel+Setup.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - NSManagedObjectModel
-
-internal extension NSManagedObjectModel {
-    
-    // MARK: Internal
-    
-    @nonobjc internal class func fromBundle(bundle: NSBundle, modelName: String, modelVersionHints: Set<String> = []) -> NSManagedObjectModel {
-        
-        guard let modelFilePath = bundle.pathForResource(modelName, ofType: "momd") else {
-            
-            fatalError("Could not find \"\(modelName).momd\" from the bundle. \(bundle)")
-        }
-        
-        let modelFileURL = NSURL(fileURLWithPath: modelFilePath)
-        let versionInfoPlistURL = modelFileURL.URLByAppendingPathComponent("VersionInfo.plist", isDirectory: false)
-        
-        guard let versionInfo = NSDictionary(contentsOfURL: versionInfoPlistURL),
-            let versionHashes = versionInfo["NSManagedObjectModel_VersionHashes"] as? [String: AnyObject] else {
-                
-                fatalError("Could not load \(typeName(NSManagedObjectModel)) metadata from path \"\(versionInfoPlistURL)\".")
-        }
-        
-        let modelVersions = Set(versionHashes.keys)
-        let currentModelVersion: String
-        if let plistModelVersion = versionInfo["NSManagedObjectModel_CurrentVersionName"] as? String where modelVersionHints.isEmpty || modelVersionHints.contains(plistModelVersion) {
-            
-            currentModelVersion = plistModelVersion
-        }
-        else if let resolvedVersion = modelVersions.intersect(modelVersionHints).first {
-            
-            CoreStore.log(
-                .Warning,
-                message: "The MigrationChain leaf versions do not include the model file's current version. Resolving to version \"\(resolvedVersion)\"."
-            )
-            currentModelVersion = resolvedVersion
-        }
-        else if let resolvedVersion = modelVersions.first ?? modelVersionHints.first {
-            
-            if !modelVersionHints.isEmpty {
-                
-                CoreStore.log(
-                    .Warning,
-                    message: "The MigrationChain leaf versions do not include any of the model file's embedded versions. Resolving to version \"\(resolvedVersion)\"."
-                )
-            }
-            currentModelVersion = resolvedVersion
-        }
-        else {
-            
-            fatalError("No model files were found in URL \"\(modelFileURL)\".")
-        }
-        
-        var modelVersionFileURL: NSURL?
-        for modelVersion in modelVersions {
-            
-            let fileURL = modelFileURL.URLByAppendingPathComponent("\(modelVersion).mom", isDirectory: false)
-            
-            if modelVersion == currentModelVersion {
-                
-                modelVersionFileURL = fileURL
-                continue
-            }
-            
-            precondition(
-                NSManagedObjectModel(contentsOfURL: fileURL) != nil,
-                "Could not find the \"\(modelVersion).mom\" version file for the model at URL \"\(modelFileURL)\"."
-            )
-        }
-        
-        if let modelVersionFileURL = modelVersionFileURL,
-            let rootModel = NSManagedObjectModel(contentsOfURL: modelVersionFileURL) {
-                
-                rootModel.modelVersionFileURL = modelVersionFileURL
-                rootModel.modelVersions = modelVersions
-                rootModel.currentModelVersion = currentModelVersion
-                return rootModel
-        }
-        
-        fatalError("Could not create an \(typeName(NSManagedObjectModel)) from the model at URL \"\(modelFileURL)\".")
-    }
-    
-    @nonobjc private(set) internal var currentModelVersion: String? {
-        
-        get {
-            
-            let value: NSString? = getAssociatedObjectForKey(
-                &PropertyKeys.currentModelVersion,
-                inObject: self
-            )
-            return value as? String
-        }
-        set {
-            
-            setAssociatedCopiedObject(
-                newValue == nil ? nil : (newValue! as NSString),
-                forKey: &PropertyKeys.currentModelVersion,
-                inObject: self
-            )
-        }
-    }
-    
-    @nonobjc private(set) internal var modelVersions: Set<String>? {
-        
-        get {
-            
-            let value: NSSet? = getAssociatedObjectForKey(
-                &PropertyKeys.modelVersions,
-                inObject: self
-            )
-            return value as? Set<String>
-        }
-        set {
-            
-            setAssociatedCopiedObject(
-                newValue == nil ? nil : (newValue! as NSSet),
-                forKey: &PropertyKeys.modelVersions,
-                inObject: self
-            )
-        }
-    }
-    
-    @nonobjc internal func entityNameForClass(entityClass: AnyClass) -> String {
-        
-        return self.entityNameMapping[NSStringFromClass(entityClass)]!
-    }
-    
-    @nonobjc internal func entityTypesMapping() -> [String: NSManagedObject.Type] {
-        
-        var mapping = [String: NSManagedObject.Type]()
-        self.entityNameMapping.forEach { (className, entityName) in
-            
-            mapping[entityName] = (NSClassFromString(className)! as! NSManagedObject.Type)
-        }
-        return mapping
-    }
-    
-    @nonobjc internal func mergedModels() -> [NSManagedObjectModel] {
-        
-        return self.modelVersions?.map { self[$0] }.flatMap { $0 == nil ? [] : [$0!] } ?? [self]
-    }
-    
-    @nonobjc internal subscript(modelVersion: String) -> NSManagedObjectModel? {
-        
-        if modelVersion == self.currentModelVersion {
-            
-            return self
-        }
-        
-        guard let modelFileURL = self.modelFileURL,
-            let modelVersions = self.modelVersions
-            where modelVersions.contains(modelVersion) else {
-                
-                return nil
-        }
-        
-        let versionModelFileURL = modelFileURL.URLByAppendingPathComponent("\(modelVersion).mom", isDirectory: false)
-        guard let model = NSManagedObjectModel(contentsOfURL: versionModelFileURL) else {
-            
-            return nil
-        }
-        
-        model.currentModelVersion = modelVersion
-        model.modelVersionFileURL = versionModelFileURL
-        model.modelVersions = modelVersions
-        return model
-    }
-    
-    @nonobjc internal subscript(metadata: [String: AnyObject]) -> NSManagedObjectModel? {
-        
-        guard let modelHashes = metadata[NSStoreModelVersionHashesKey] as? [String : NSData] else {
-            
-            return nil
-        }
-        for modelVersion in self.modelVersions ?? [] {
-            
-            if let versionModel = self[modelVersion] where modelHashes == versionModel.entityVersionHashesByName {
-                
-                return versionModel
-            }
-        }
-        return nil
-    }
-    
-    
-    // MARK: Private
-    
-    private var modelFileURL: NSURL? {
-        
-        get {
-            
-            return self.modelVersionFileURL?.URLByDeletingLastPathComponent
-        }
-    }
-    
-    private var modelVersionFileURL: NSURL? {
-        
-        get {
-            
-            let value: NSURL? = getAssociatedObjectForKey(
-                &PropertyKeys.modelVersionFileURL,
-                inObject: self
-            )
-            return value
-        }
-        set {
-            
-            setAssociatedCopiedObject(
-                newValue,
-                forKey: &PropertyKeys.modelVersionFileURL,
-                inObject: self
-            )
-        }
-    }
-    
-    private var entityNameMapping: [String: String] {
-        
-        get {
-            
-            if let mapping: NSDictionary = getAssociatedObjectForKey(&PropertyKeys.entityNameMapping, inObject: self) {
-                
-                return mapping as! [String: String]
-            }
-            
-            var mapping = [String: String]()
-            self.entities.forEach {
-                
-                guard let entityName = $0.name else {
-                    
-                    return
-                }
-                
-                let className = $0.managedObjectClassName
-                mapping[className] = entityName
-            }
-            setAssociatedCopiedObject(
-                mapping as NSDictionary,
-                forKey: &PropertyKeys.entityNameMapping,
-                inObject: self
-            )
-            return mapping
-        }
-    }
-    
-    private struct PropertyKeys {
-        
-        static var entityNameMapping: Void?
-        
-        static var modelVersionFileURL: Void?
-        static var modelVersions: Void?
-        static var currentModelVersion: Void?
-    }
-}

CoreStore/Logging/CoreStoreLogger.swift

@@ -1,105 +0,0 @@
-//
-//  CoreStoreLogger.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-// MARK: - LogLevel
-
-/**
- The `LogLevel` indicates the severity of a log message.
- */
-public enum LogLevel {
-    
-    case Trace
-    case Notice
-    case Warning
-    case Fatal
-}
-
-
-// MARK: - CoreStoreLogger
-
-/**
- Custom loggers should implement the `CoreStoreLogger` protocol and pass its instance to `CoreStore.logger`. Calls to `log(...)`, `handleError(...)`, and `assert(...)` are not tied to a specific queue/thread, so it is the implementer's job to handle thread-safety.
- */
-public protocol CoreStoreLogger {
-    
-    /**
-     Handles log messages sent by the `CoreStore` framework.
-     
-     :level: the severity of the log message
-     :message: the log message
-     :fileName: the source file name
-     :lineNumber: the source line number
-     :functionName: the source function name
-     */
-    func log(level level: LogLevel, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString)
-    
-    /**
-     Handles errors sent by the `CoreStore` framework.
-     
-     :error: the error
-     :message: the error message
-     :fileName: the source file name
-     :lineNumber: the source line number
-     :functionName: the source function name
-     */
-    func handleError(error error: NSError, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString)
-    
-    /**
-     Handles assertions made throughout the `CoreStore` framework.
-     
-     :condition: the assertion condition
-     :message: the assertion message
-     :fileName: the source file name
-     :lineNumber: the source line number
-     :functionName: the source function name
-     */
-    func assert(@autoclosure condition: () -> Bool, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString)
-}
-
-
-// MARK: - Utilities
-
-internal func typeName<T>(value: T) -> String {
-    
-    return "'\(String(reflecting: value.dynamicType))'"
-}
-
-internal func typeName<T>(value: T.Type) -> String {
-    
-    return "'\(value)'"
-}
-
-internal func typeName(value: AnyClass) -> String {
-    
-    return "'\(value)'"
-}
-
-internal func typeName(name: String?) -> String {
-    
-    return "<\(name ?? "unknown")>"
-}

CoreStore/Logging/DefaultLogger.swift

@@ -1,87 +0,0 @@
-//
-//  DefaultLogger.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-// MARK: - DefaultLogger
-
-/**
- The `DefaultLogger` is a basic implementation of the `CoreStoreLogger` protocol.
- 
- - The `log(...)` method calls `print(...)` to print the level, source file name, line number, function name, and the log message.
- - The `handleError(...)` method calls `print(...)` to print the source file name, line number, function name, and the error message.
- - The `assert(...)` method calls `assert(...)` on the arguments.
- */
-public final class DefaultLogger: CoreStoreLogger {
-    
-    public init() { }
-   
-    public func log(level level: LogLevel, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        #if DEBUG
-            let icon: String
-            let levelString: String
-            switch level {
-                
-            case .Trace:
-                icon = "🔹"
-                levelString = "Trace"
-                
-            case .Notice:
-                icon = "🔸"
-                levelString = "Notice"
-                
-            case .Warning:
-                icon = "⚠️"
-                levelString = "Warning"
-                
-            case .Fatal:
-                icon = "❗"
-                levelString = "Fatal"
-            }
-            Swift.print("\(icon) [CoreStore: \(levelString)] \((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ \(message)\n")
-        #endif
-    }
-    
-    public func handleError(error error: NSError, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        #if DEBUG
-            Swift.print("⚠️ [CoreStore: Error] \((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ \(message)\n    \(error)\n")
-        #endif
-    }
-    
-    public func assert(@autoclosure condition: () -> Bool, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        #if DEBUG
-            if condition() {
-                
-                return
-            }
-            Swift.print("❗ [CoreStore: Assertion Failure] \((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ \(message)\n")
-            Swift.fatalError()
-        #endif
-    }
-}

CoreStore/Migrating/CoreStore+Migration.swift

@@ -1,152 +0,0 @@
-//
-//  CoreStore+Migration.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - CoreStore
-
-public extension CoreStore {
-    
-    /**
-     Asynchronously adds to the `defaultStack` an SQLite store from the given SQLite file name. Note that using `addSQLiteStore(...)` instead of `addSQLiteStoreAndWait(...)` implies that the migrations are allowed and expected (thus the asynchronous `completion`.)
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS). A new SQLite file will be created if it does not exist. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to report failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - parameter completion: the closure to be executed on the main queue when the process completes, either due to success or failure. The closure's `PersistentStoreResult` argument indicates the result. This closure is NOT executed if an error is thrown, but will be executed with a `.Failure` result if an error occurs asynchronously.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public static func addSQLiteStore(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, resetStoreOnModelMismatch: Bool = false, completion: (PersistentStoreResult) -> Void) throws -> NSProgress? {
-        
-        return try self.defaultStack.addSQLiteStore(
-            fileName: fileName,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch,
-            completion: completion
-        )
-    }
-    
-    /**
-     Asynchronously adds to the `defaultStack` an SQLite store from the given SQLite file URL. Note that using `addSQLiteStore(...)` instead of `addSQLiteStoreAndWait(...)` implies that the migrations are allowed and expected (thus the asynchronous `completion`.)
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store. A new SQLite file will be created if it does not exist. If not specified, defaults to a file URL pointing to a "<Application name>.sqlite" file in the "Application Support" directory (or the "Caches" directory on tvOS). Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to report failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - parameter completion: the closure to be executed on the main queue when the process completes, either due to success or failure. The closure's `PersistentStoreResult` argument indicates the result. This closure is NOT executed if an error is thrown, but will be executed with a `.Failure` result if an error occurs asynchronously.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public static func addSQLiteStore(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle]? = NSBundle.allBundles(), resetStoreOnModelMismatch: Bool = false, completion: (PersistentStoreResult) -> Void) throws -> NSProgress? {
-        
-        return try self.defaultStack.addSQLiteStore(
-            fileURL: fileURL,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch,
-            completion: completion
-        )
-    }
-    
-    /**
-     Using the `defaultStack`, migrates an SQLite store with the specified filename to the `DataStack`'s managed object model version WITHOUT adding the migrated store to the data stack.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - parameter sourceBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public static func upgradeSQLiteStoreIfNeeded(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, completion: (MigrationResult) -> Void) throws -> NSProgress? {
-        
-        return try self.defaultStack.upgradeSQLiteStoreIfNeeded(
-            fileName: fileName,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            completion: completion
-        )
-    }
-    
-    /**
-     Using the `defaultStack`, migrates an SQLite store at the specified file URL and configuration name to the `DataStack`'s managed object model version. This method does NOT add the migrated store to the data stack.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - parameter sourceBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public static func upgradeSQLiteStoreIfNeeded(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, completion: (MigrationResult) -> Void) throws -> NSProgress? {
-        
-        return try self.defaultStack.upgradeSQLiteStoreIfNeeded(
-            fileURL: fileURL,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            completion: completion
-        )
-    }
-    
-    /**
-     Using the `defaultStack`, checks for the required migrations needed for the store with the specified filename and configuration to be migrated to the `DataStack`'s managed object model version. This method throws an error if the store does not exist, if inspection of the store failed, or no mapping model was found/inferred.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     :return: an array of `MigrationType`s indicating the chain of migrations required for the store; or `nil` if either inspection of the store failed, or no mapping model was found/inferred. `MigrationType` acts as a `Bool` and evaluates to `false` if no migration is required, and `true` if either a lightweight or custom migration is needed.
-     */
-    @warn_unused_result
-    public static func requiredMigrationsForSQLiteStore(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle] = NSBundle.allBundles() as [NSBundle]) throws -> [MigrationType] {
-        
-        return try self.defaultStack.requiredMigrationsForSQLiteStore(
-            fileName: fileName,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles
-        )
-    }
-    
-    /**
-     Using the `defaultStack`, checks if the store at the specified file URL and configuration needs to be migrated to the `DataStack`'s managed object model version.
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     :return: a `MigrationType` indicating the type of migration required for the store; or `nil` if either inspection of the store failed, or no mapping model was found/inferred. `MigrationType` acts as a `Bool` and evaluates to `false` if no migration is required, and `true` if either a lightweight or custom migration is needed.
-     */
-    @warn_unused_result
-    public static func requiredMigrationsForSQLiteStore(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle] = NSBundle.allBundles() as [NSBundle]) throws -> [MigrationType] {
-        
-        return try self.defaultStack.requiredMigrationsForSQLiteStore(
-            fileURL: fileURL,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles
-        )
-    }
-}

CoreStore/Migrating/DataStack+Migration.swift

@@ -1,635 +0,0 @@
-//
-//  DataStack+Migration.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - DataStack
-
-public extension DataStack {
-    
-    /**
-     Asynchronously adds an in-memory store to the stack.
-     
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`.
-     - parameter completion: the closure to be executed on the main queue when the process completes, either due to success or failure. The closure's `PersistentStoreResult` argument indicates the result.
-     */
-    public func addInMemoryStore(configuration configuration: String? = nil, completion: (PersistentStoreResult) -> Void) {
-        
-        self.coordinator.performBlock {
-            
-            do {
-                
-                let store = try self.coordinator.addPersistentStoreWithType(
-                    NSInMemoryStoreType,
-                    configuration: configuration,
-                    URL: nil,
-                    options: nil
-                )
-                self.updateMetadataForPersistentStore(store)
-                
-                GCDQueue.Main.async {
-                    
-                    completion(PersistentStoreResult(store))
-                }
-            }
-            catch {
-                
-                let storeError = error as NSError
-                CoreStore.handleError(
-                    storeError,
-                    "Failed to add in-memory \(typeName(NSPersistentStore)) to the stack."
-                )
-                
-                GCDQueue.Main.async {
-                    
-                    completion(PersistentStoreResult(storeError))
-                }
-            }
-        }
-    }
-    
-    /**
-     Asynchronously adds to the stack an SQLite store from the given SQLite file name. Note that using `addSQLiteStore(...)` instead of `addSQLiteStoreAndWait(...)` implies that the migrations are allowed and expected (thus the asynchronous `completion`.)
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS). A new SQLite file will be created if it does not exist. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to report failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - parameter completion: the closure to be executed on the main queue when the process completes, either due to success or failure. The closure's `PersistentStoreResult` argument indicates the result. This closure is NOT executed if an error is thrown, but will be executed with a `.Failure` result if an error occurs asynchronously.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public func addSQLiteStore(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, resetStoreOnModelMismatch: Bool = false, completion: (PersistentStoreResult) -> Void) throws -> NSProgress? {
-        
-        return try self.addSQLiteStore(
-            fileURL: defaultDirectory.URLByAppendingPathComponent(
-                fileName,
-                isDirectory: false
-            ),
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch,
-            completion: completion
-        )
-    }
-    
-    /**
-     Asynchronously adds to the stack an SQLite store from the given SQLite file URL. Note that using `addSQLiteStore(...)` instead of `addSQLiteStoreAndWait(...)` implies that the migrations are allowed and expected (thus the asynchronous `completion`.)
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store. A new SQLite file will be created if it does not exist. If not specified, defaults to a file URL pointing to a "<Application name>.sqlite" file in the "Application Support" directory (or the "Caches" directory on tvOS). Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to report failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - parameter completion: the closure to be executed on the main queue when the process completes, either due to success or failure. The closure's `PersistentStoreResult` argument indicates the result. This closure is NOT executed if an error is thrown, but will be executed with a `.Failure` result if an error occurs asynchronously.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public func addSQLiteStore(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle]? = NSBundle.allBundles(), resetStoreOnModelMismatch: Bool = false, completion: (PersistentStoreResult) -> Void) throws -> NSProgress? {
-        
-        CoreStore.assert(
-            fileURL.fileURL,
-            "The specified file URL for the SQLite store is invalid: \"\(fileURL)\""
-        )
-        
-        let coordinator = self.coordinator;
-        if let store = coordinator.persistentStoreForURL(fileURL) {
-            
-            guard store.type == NSSQLiteStoreType
-                && store.configurationName == (configuration ?? Into.defaultConfigurationName) else {
-                    
-                    let error = NSError(coreStoreErrorCode: .DifferentPersistentStoreExistsAtURL)
-                    CoreStore.handleError(
-                        error,
-                        "Failed to add SQLite \(typeName(NSPersistentStore)) at \"\(fileURL)\" because a different \(typeName(NSPersistentStore)) at that URL already exists."
-                    )
-                    throw error
-            }
-            
-            GCDQueue.Main.async {
-                
-                completion(PersistentStoreResult(store))
-            }
-            return nil
-        }
-        
-        let fileManager = NSFileManager.defaultManager()
-        _ = try? fileManager.createDirectoryAtURL(
-            fileURL.URLByDeletingLastPathComponent!,
-            withIntermediateDirectories: true,
-            attributes: nil
-        )
-        
-        do {
-            
-            let metadata = try NSPersistentStoreCoordinator.metadataForPersistentStoreOfType(
-                NSSQLiteStoreType,
-                URL: fileURL,
-                options: self.optionsForSQLiteStore()
-            )
-            
-            return self.upgradeSQLiteStoreIfNeeded(
-                fileURL: fileURL,
-                metadata: metadata,
-                configuration: configuration,
-                mappingModelBundles: mappingModelBundles,
-                completion: { (result) -> Void in
-                    
-                    if case .Failure(let error) = result {
-                        
-                        if resetStoreOnModelMismatch && error.isCoreDataMigrationError {
-                            
-                            fileManager.removeSQLiteStoreAtURL(fileURL)
-                            do {
-                                
-                                let store = try self.addSQLiteStoreAndWait(
-                                    fileURL: fileURL,
-                                    configuration: configuration,
-                                    resetStoreOnModelMismatch: false
-                                )
-                                
-                                GCDQueue.Main.async {
-                                    
-                                    completion(PersistentStoreResult(store))
-                                }
-                            }
-                            catch {
-                                
-                                completion(PersistentStoreResult(error as NSError))
-                            }
-                            return
-                        }
-                        
-                        completion(PersistentStoreResult(error))
-                        return
-                    }
-                    
-                    do {
-                        
-                        let store = try self.addSQLiteStoreAndWait(
-                            fileURL: fileURL,
-                            configuration: configuration,
-                            resetStoreOnModelMismatch: false
-                        )
-                        
-                        completion(PersistentStoreResult(store))
-                    }
-                    catch {
-                        
-                        completion(PersistentStoreResult(error as NSError))
-                    }
-                }
-            )
-        }
-        catch let error as NSError
-            where error.code == NSFileReadNoSuchFileError && error.domain == NSCocoaErrorDomain {
-                
-                let store = try self.addSQLiteStoreAndWait(
-                    fileURL: fileURL,
-                    configuration: configuration,
-                    resetStoreOnModelMismatch: false
-                )
-                
-                GCDQueue.Main.async {
-                    
-                    completion(PersistentStoreResult(store))
-                }
-                return nil
-        }
-        catch {
-            
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to load SQLite \(typeName(NSPersistentStore)) metadata."
-            )
-            throw error
-        }
-    }
-    
-    /**
-     Migrates an SQLite store with the specified filename to the `DataStack`'s managed object model version WITHOUT adding the migrated store to the data stack.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - parameter sourceBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public func upgradeSQLiteStoreIfNeeded(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, completion: (MigrationResult) -> Void) throws -> NSProgress? {
-        
-        return try self.upgradeSQLiteStoreIfNeeded(
-            fileURL: defaultDirectory.URLByAppendingPathComponent(
-                fileName,
-                isDirectory: false
-            ),
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            completion: completion
-        )
-    }
-    
-    /**
-     Migrates an SQLite store at the specified file URL and configuration name to the `DataStack`'s managed object model version. This method does NOT add the migrated store to the data stack.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - parameter sourceBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.mainBundle()`.
-     - returns: an `NSProgress` instance if a migration has started, or `nil` is no migrations are required
-     */
-    public func upgradeSQLiteStoreIfNeeded(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil, completion: (MigrationResult) -> Void) throws -> NSProgress? {
-        
-        let metadata: [String: AnyObject]
-        do {
-            
-            metadata = try NSPersistentStoreCoordinator.metadataForPersistentStoreOfType(
-                NSSQLiteStoreType,
-                URL: fileURL,
-                options: self.optionsForSQLiteStore()
-            )
-        }
-        catch {
-            
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to load SQLite \(typeName(NSPersistentStore)) metadata."
-            )
-            throw error
-        }
-        
-        return self.upgradeSQLiteStoreIfNeeded(
-            fileURL: fileURL,
-            metadata: metadata,
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles,
-            completion: completion
-        )
-    }
-    
-    /**
-     Checks for the required migrations needed for the store with the specified filename and configuration to be migrated to the `DataStack`'s managed object model version. This method throws an error if the store does not exist, if inspection of the store failed, or no mapping model was found/inferred.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     :return: an array of `MigrationType`s indicating the chain of migrations required for the store; or `nil` if either inspection of the store failed, or no mapping model was found/inferred. `MigrationType` acts as a `Bool` and evaluates to `false` if no migration is required, and `true` if either a lightweight or custom migration is needed.
-     */
-    @warn_unused_result
-    public func requiredMigrationsForSQLiteStore(fileName fileName: String, configuration: String? = nil, mappingModelBundles: [NSBundle] = NSBundle.allBundles() as [NSBundle]) throws -> [MigrationType] {
-        
-        return try requiredMigrationsForSQLiteStore(
-            fileURL: defaultDirectory.URLByAppendingPathComponent(
-                fileName,
-                isDirectory: false
-            ),
-            configuration: configuration,
-            mappingModelBundles: mappingModelBundles
-        )
-    }
-    
-    /**
-     Checks if the store at the specified file URL and configuration needs to be migrated to the `DataStack`'s managed object model version.
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil` which indicates the "Default" configuration.
-     - parameter mappingModelBundles: an optional array of bundles to search mapping model files from. If not set, defaults to the `NSBundle.allBundles()`.
-     :return: a `MigrationType` indicating the type of migration required for the store; or `nil` if either inspection of the store failed, or no mapping model was found/inferred. `MigrationType` acts as a `Bool` and evaluates to `false` if no migration is required, and `true` if either a lightweight or custom migration is needed.
-     */
-    @warn_unused_result
-    public func requiredMigrationsForSQLiteStore(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, mappingModelBundles: [NSBundle] = NSBundle.allBundles() as [NSBundle]) throws -> [MigrationType] {
-        
-        let metadata: [String : AnyObject]
-        do {
-            
-            metadata = try NSPersistentStoreCoordinator.metadataForPersistentStoreOfType(
-                NSSQLiteStoreType,
-                URL: fileURL,
-                options: self.optionsForSQLiteStore()
-            )
-        }
-        catch {
-            
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to load SQLite \(typeName(NSPersistentStore)) metadata."
-            )
-            throw error
-        }
-        
-        guard let migrationSteps = self.computeMigrationFromStoreMetadata(metadata, configuration: configuration, mappingModelBundles: mappingModelBundles) else {
-            
-            let error = NSError(coreStoreErrorCode: .MappingModelNotFound)
-            CoreStore.handleError(
-                error,
-                "Failed to find migration steps from the store at URL \"\(fileURL)\" to version model \"\(self.modelVersion)\"."
-            )
-            throw error
-        }
-        
-        return migrationSteps.map { $0.migrationType }
-    }
-    
-    
-    // MARK: Private
-    
-    private func upgradeSQLiteStoreIfNeeded(fileURL fileURL: NSURL, metadata: [String: AnyObject], configuration: String?, mappingModelBundles: [NSBundle]?, completion: (MigrationResult) -> Void) -> NSProgress? {
-        
-        guard let migrationSteps = self.computeMigrationFromStoreMetadata(metadata, configuration: configuration, mappingModelBundles: mappingModelBundles) else {
-            
-            CoreStore.handleError(
-                NSError(coreStoreErrorCode: .MappingModelNotFound),
-                "Failed to find migration steps from the store at URL \"\(fileURL)\" to version model \"\(model)\"."
-            )
-            
-            GCDQueue.Main.async {
-                
-                completion(MigrationResult(.MappingModelNotFound))
-            }
-            return nil
-        }
-        
-        let numberOfMigrations: Int64 = Int64(migrationSteps.count)
-        if numberOfMigrations == 0 {
-            
-            GCDQueue.Main.async {
-                
-                completion(MigrationResult([]))
-                return
-            }
-            return nil
-        }
-        
-        let migrationTypes = migrationSteps.map { $0.migrationType }
-        var migrationResult: MigrationResult?
-        var operations = [NSOperation]()
-        var cancelled = false
-        
-        let progress = NSProgress(parent: nil, userInfo: nil)
-        progress.totalUnitCount = numberOfMigrations
-        
-        // todo nsprogress crashing sometimes
-        for (sourceModel, destinationModel, mappingModel, _) in migrationSteps {
-            
-            progress.becomeCurrentWithPendingUnitCount(1)
-            
-            let childProgress = NSProgress(parent: progress, userInfo: nil)
-            childProgress.totalUnitCount = 100
-            
-            operations.append(
-                NSBlockOperation { [weak self] in
-                    
-                    guard let strongSelf = self where !cancelled else {
-                        
-                        return
-                    }
-                    
-                    autoreleasepool {
-                        
-                        do {
-                            
-                            try strongSelf.startMigrationForSQLiteStore(
-                                fileURL: fileURL,
-                                sourceModel: sourceModel,
-                                destinationModel: destinationModel,
-                                mappingModel: mappingModel,
-                                progress: childProgress
-                            )
-                        }
-                        catch {
-                            
-                            migrationResult = MigrationResult(error as NSError)
-                            cancelled = true
-                        }
-                    }
-                    
-                    GCDQueue.Main.async {
-                        
-                        withExtendedLifetime(childProgress) { (_: NSProgress) -> Void in }
-                        return
-                    }
-                }
-            )
-            
-            progress.resignCurrent()
-        }
-        
-        let migrationOperation = NSBlockOperation()
-        migrationOperation.qualityOfService = .Utility
-        operations.forEach { migrationOperation.addDependency($0) }
-        migrationOperation.addExecutionBlock { () -> Void in
-            
-            GCDQueue.Main.async {
-                
-                progress.setProgressHandler(nil)
-                completion(migrationResult ?? MigrationResult(migrationTypes))
-                return
-            }
-        }
-        
-        operations.append(migrationOperation)
-        
-        self.migrationQueue.addOperations(operations, waitUntilFinished: false)
-        
-        return progress
-    }
-    
-    private func computeMigrationFromStoreMetadata(metadata: [String: AnyObject], configuration: String? = nil, mappingModelBundles: [NSBundle]? = nil) -> [(sourceModel: NSManagedObjectModel, destinationModel: NSManagedObjectModel, mappingModel: NSMappingModel, migrationType: MigrationType)]? {
-        
-        let model = self.model
-        if model.isConfiguration(configuration, compatibleWithStoreMetadata: metadata) {
-            
-            return []
-        }
-        
-        guard let initialModel = model[metadata],
-            var currentVersion = initialModel.currentModelVersion else {
-                
-                return nil
-        }
-        
-        let migrationChain: MigrationChain = self.migrationChain.empty
-            ? [currentVersion: model.currentModelVersion!]
-            : self.migrationChain
-        
-        var migrationSteps = [(sourceModel: NSManagedObjectModel, destinationModel: NSManagedObjectModel, mappingModel: NSMappingModel, migrationType: MigrationType)]()
-        
-        while let nextVersion = migrationChain.nextVersionFrom(currentVersion),
-            let sourceModel = model[currentVersion],
-            let destinationModel = model[nextVersion] where sourceModel != model {
-                
-                if let mappingModel = NSMappingModel(
-                    fromBundles: mappingModelBundles,
-                    forSourceModel: sourceModel,
-                    destinationModel: destinationModel) {
-                        
-                        migrationSteps.append(
-                            (
-                                sourceModel: sourceModel,
-                                destinationModel: destinationModel,
-                                mappingModel: mappingModel,
-                                migrationType: .Heavyweight(
-                                    sourceVersion: currentVersion,
-                                    destinationVersion: nextVersion
-                                )
-                            )
-                        )
-                }
-                else {
-                    
-                    do {
-                        
-                        let mappingModel = try NSMappingModel.inferredMappingModelForSourceModel(
-                            sourceModel,
-                            destinationModel: destinationModel
-                        )
-                        
-                        migrationSteps.append(
-                            (
-                                sourceModel: sourceModel,
-                                destinationModel: destinationModel,
-                                mappingModel: mappingModel,
-                                migrationType: .Lightweight(
-                                    sourceVersion: currentVersion,
-                                    destinationVersion: nextVersion
-                                )
-                            )
-                        )
-                    }
-                    catch {
-                        
-                        return nil
-                    }
-                }
-                currentVersion = nextVersion
-        }
-        
-        if migrationSteps.last?.destinationModel == model {
-            
-            return migrationSteps
-        }
-        
-        return nil
-    }
-    
-    private func startMigrationForSQLiteStore(fileURL fileURL: NSURL, sourceModel: NSManagedObjectModel, destinationModel: NSManagedObjectModel, mappingModel: NSMappingModel, progress: NSProgress) throws {
-        
-        autoreleasepool {
-            
-            let journalUpdatingCoordinator = NSPersistentStoreCoordinator(managedObjectModel: sourceModel)
-            let store = try! journalUpdatingCoordinator.addPersistentStoreWithType(
-                NSSQLiteStoreType,
-                configuration: nil,
-                URL: fileURL,
-                options: [NSSQLitePragmasOption: ["journal_mode": "DELETE"]]
-            )
-            try! journalUpdatingCoordinator.removePersistentStore(store)
-        }
-        
-        let migrationManager = MigrationManager(
-            sourceModel: sourceModel,
-            destinationModel: destinationModel,
-            progress: progress
-        )
-        
-        let temporaryDirectoryURL = NSURL(fileURLWithPath: NSTemporaryDirectory(), isDirectory: true).URLByAppendingPathComponent(NSProcessInfo().globallyUniqueString)
-        
-        let fileManager = NSFileManager.defaultManager()
-        try! fileManager.createDirectoryAtURL(
-            temporaryDirectoryURL,
-            withIntermediateDirectories: true,
-            attributes: nil
-        )
-        
-        let temporaryFileURL = temporaryDirectoryURL.URLByAppendingPathComponent(fileURL.lastPathComponent!, isDirectory: false)
-        
-        do {
-            
-            try migrationManager.migrateStoreFromURL(
-                fileURL,
-                type: NSSQLiteStoreType,
-                options: nil,
-                withMappingModel: mappingModel,
-                toDestinationURL: temporaryFileURL,
-                destinationType: NSSQLiteStoreType,
-                destinationOptions: nil
-            )
-        }
-        catch {
-            
-            do {
-                
-                try fileManager.removeItemAtURL(temporaryDirectoryURL)
-            }
-            catch _ { }
-            
-            let sourceVersion = migrationManager.sourceModel.currentModelVersion ?? "???"
-            let destinationVersion = migrationManager.destinationModel.currentModelVersion ?? "???"
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to migrate from version model \"\(sourceVersion)\" to version model \"\(destinationVersion)\"."
-            )
-            
-            throw error
-        }
-        
-        do {
-            
-            try fileManager.replaceItemAtURL(
-                fileURL,
-                withItemAtURL: temporaryFileURL,
-                backupItemName: nil,
-                options: [],
-                resultingItemURL: nil
-            )
-            
-            progress.completedUnitCount = progress.totalUnitCount
-            
-            do {
-                
-                try fileManager.removeItemAtPath(fileURL.path! + "-shm")
-            }
-            catch _ { }
-        }
-        catch {
-            
-            do {
-                
-                try fileManager.removeItemAtURL(temporaryDirectoryURL)
-            }
-            catch _ { }
-            
-            let sourceVersion = migrationManager.sourceModel.currentModelVersion ?? "???"
-            let destinationVersion = migrationManager.destinationModel.currentModelVersion ?? "???"
-            CoreStore.handleError(
-                error as NSError,
-                "Failed to save store after migrating from version model \"\(sourceVersion)\" to version model \"\(destinationVersion)\"."
-            )
-            
-            throw error
-        }
-    }
-}

CoreStore/Migrating/MigrationResult.swift

@@ -1,109 +0,0 @@
-//
-//  MigrationResult.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-// MARK: - MigrationResult
-
-/**
- The `MigrationResult` indicates the result of a migration.
- The `MigrationResult` can be treated as a boolean:
- ```
- CoreStore.upgradeSQLiteStoreIfNeeded { transaction in
-     // ...
-     let result = transaction.commit()
-     if result {
-         // succeeded
-     }
-     else {
-         // failed
-     }
- }
- ```
- or as an `enum`, where the resulting associated object can also be inspected:
- ```
- CoreStore.beginAsynchronous { transaction in
-     // ...
-     let result = transaction.commit()
-     switch result {
-     case .Success(let hasChanges):
-         // hasChanges indicates if there were changes or not
-     case .Failure(let error):
-         // error is the NSError instance for the failure
-     }
- }
- ```
- */
-public enum MigrationResult {
-    
-    /**
-     `MigrationResult.Success` indicates either the migration succeeded, or there were no migrations needed. The associated value is an array of `MigrationType`s reflecting the migration steps completed.
-     */
-    case Success([MigrationType])
-    
-    /**
-     `SaveResult.Failure` indicates that the migration failed. The associated object for this value is the related `NSError` instance.
-     */
-    case Failure(NSError)
-    
-    
-    // MARK: Internal
-    
-    internal init(_ migrationTypes: [MigrationType]) {
-        
-        self = .Success(migrationTypes)
-    }
-    
-    internal init(_ error: NSError) {
-        
-        self = .Failure(error)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode) {
-        
-        self.init(errorCode, userInfo: nil)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode, userInfo: [NSObject: AnyObject]?) {
-        
-        self.init(NSError(coreStoreErrorCode: errorCode, userInfo: userInfo))
-    }
-}
-
-
-// MARK: - MigrationResult: BooleanType
-
-extension MigrationResult: BooleanType {
-    
-    public var boolValue: Bool {
-        
-        switch self {
-            
-        case .Success: return true
-        case .Failure: return false
-        }
-    }
-}

CoreStore/NSError+CoreStore.swift

@@ -1,102 +0,0 @@
-//
-//  NSError+CoreStore.swift
-//  CoreStore
-//
-//  Copyright © 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: - CoreStoreError
-
-/**
- The `NSError` error domain for `CoreStore`.
- */
-public let CoreStoreErrorDomain = "com.corestore.error"
-
-/**
- The `NSError` error codes for `CoreStoreErrorDomain`.
- */
-public enum CoreStoreErrorCode: Int {
-    
-    /**
-     A failure occured because of an unknown error.
-     */
-    case UnknownError
-    
-    /**
-     The `NSPersistentStore` could note be initialized because another store existed at the specified `NSURL`.
-     */
-    case DifferentPersistentStoreExistsAtURL
-    
-    /**
-     The `NSPersistentStore` specified could not be found.
-     */
-    case PersistentStoreNotFound
-    
-    /**
-     An `NSMappingModel` could not be found for a specific source and destination model versions.
-     */
-    case MappingModelNotFound
-}
-
-
-// MARK: - NSError
-
-public extension NSError {
-    
-    /**
-     If the error's domain is equal to `CoreStoreErrorDomain`, returns the associated `CoreStoreErrorCode`. For other domains, returns `nil`.
-     */
-    public var coreStoreErrorCode: CoreStoreErrorCode? {
-        
-        return (self.domain == CoreStoreErrorDomain
-            ? CoreStoreErrorCode(rawValue: self.code)
-            : nil)
-    }
-    
-    
-    // MARK: Internal
-    
-    internal convenience init(coreStoreErrorCode: CoreStoreErrorCode) {
-        
-        self.init(coreStoreErrorCode: coreStoreErrorCode, userInfo: nil)
-    }
-    
-    internal convenience init(coreStoreErrorCode: CoreStoreErrorCode, userInfo: [NSObject: AnyObject]?) {
-        
-        self.init(
-            domain: CoreStoreErrorDomain,
-            code: coreStoreErrorCode.rawValue,
-            userInfo: userInfo)
-    }
-    
-    internal var isCoreDataMigrationError: Bool {
-        
-        let code = self.code
-        return (code == NSPersistentStoreIncompatibleVersionHashError
-            || code == NSMigrationMissingSourceModelError
-            || code == NSMigrationError)
-            && self.domain == NSCocoaErrorDomain
-    }
-}

CoreStore/Observing/CoreStore+Observing.swift

@@ -1,150 +0,0 @@
-//
-//  CoreStore+Observing.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - CoreStore
-
-@available(OSX, unavailable)
-public extension CoreStore {
-    
-    /**
-     Using the `defaultStack`, creates a `ObjectMonitor` for the specified `NSManagedObject`. Multiple `ObjectObserver`s may then register themselves to be notified when changes are made to the `NSManagedObject`.
-     
-     - parameter object: the `NSManagedObject` to observe changes from
-     - returns: a `ObjectMonitor` that monitors changes to `object`
-     */
-    @warn_unused_result
-    public static func monitorObject<T: NSManagedObject>(object: T) -> ObjectMonitor<T> {
-        
-        return self.defaultStack.monitorObject(object)
-    }
-    
-    /**
-     Using the `defaultStack`, creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public static func monitorList<T: NSManagedObject>(from: From<T>, _ queryClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.defaultStack.monitorList(from, queryClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public static func monitorList<T: NSManagedObject>(from: From<T>, _ queryClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        return self.defaultStack.monitorList(from, queryClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public static func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: FetchClause...) {
-        
-        self.defaultStack.monitorList(createAsynchronously: createAsynchronously, from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public static func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: [FetchClause])  {
-        
-        self.defaultStack.monitorList(createAsynchronously: createAsynchronously, from, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public static func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.defaultStack.monitorSectionedList(from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public static func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        return self.defaultStack.monitorSectionedList(from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public static func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) {
-        
-        self.defaultStack.monitorSectionedList(createAsynchronously: createAsynchronously, from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Using the `defaultStack`, asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public static func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) {
-        
-        self.defaultStack.monitorSectionedList(createAsynchronously: createAsynchronously, from, sectionBy, fetchClauses)
-    }
-}

CoreStore/Observing/DataStack+Observing.swift

@@ -1,219 +0,0 @@
-//
-//  DataStack+Observing.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - DataStack
-
-@available(OSX, unavailable)
-public extension DataStack {
-    
-    /**
-     Creates a `ObjectMonitor` for the specified `NSManagedObject`. Multiple `ObjectObserver`s may then register themselves to be notified when changes are made to the `NSManagedObject`.
-     
-     - parameter object: the `NSManagedObject` to observe changes from
-     - returns: a `ObjectMonitor` that monitors changes to `object`
-     */
-    @warn_unused_result
-    public func monitorObject<T: NSManagedObject>(object: T) -> ObjectMonitor<T> {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to observe objects from \(typeName(self)) outside the main thread."
-        )
-        
-        return ObjectMonitor(
-            dataStack: self,
-            object: object
-        )
-    }
-    
-    /**
-     Creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorList<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.monitorList(from, fetchClauses)
-    }
-    
-    /**
-     Creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorList<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to observe objects from \(typeName(self)) outside the main thread."
-        )
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        return ListMonitor(
-            dataStack: self,
-            from: from,
-            sectionBy: nil,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: FetchClause...) {
-        
-        self.monitorList(createAsynchronously: createAsynchronously, from, fetchClauses)
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: [FetchClause])  {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to observe objects from \(typeName(self)) outside the main thread."
-        )
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        _ = ListMonitor(
-            dataStack: self,
-            from: from,
-            sectionBy: nil,
-            fetchClauses: fetchClauses,
-            createAsynchronously: createAsynchronously
-        )
-    }
-    
-    /**
-     Creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.monitorSectionedList(from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to observe objects from \(typeName(self)) outside the main thread."
-        )
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        return ListMonitor(
-            dataStack: self,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) {
-        
-        self.monitorSectionedList(createAsynchronously: createAsynchronously, from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to observe objects from \(typeName(self)) outside the main thread."
-        )
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        _ = ListMonitor(
-            dataStack: self,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses,
-            createAsynchronously: createAsynchronously
-        )
-    }
-}

CoreStore/Observing/ObjectMonitor.swift

@@ -1,330 +0,0 @@
-//
-//  ObjectMonitor.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - ObjectMonitor
-
-/**
- The `ObjectMonitor` monitors changes to a single `NSManagedObject` instance. Observers that implement the `ObjectObserver` protocol may then register themselves to the `ObjectMonitor`'s `addObserver(_:)` method:
- ```
- let monitor = CoreStore.monitorObject(object)
- monitor.addObserver(self)
- ```
- The created `ObjectMonitor` instance needs to be held on (retained) for as long as the object needs to be observed.
- 
- Observers registered via `addObserver(_:)` are not retained. `ObjectMonitor` only keeps a `weak` reference to all observers, thus keeping itself free from retain-cycles.
- */
-@available(OSX, unavailable)
-public final class ObjectMonitor<T: NSManagedObject> {
-    
-    /**
-     Returns the `NSManagedObject` instance being observed, or `nil` if the object was already deleted.
-     */
-    public var object: T? {
-        
-        return self.fetchedResultsController.fetchedObjects?.first as? T
-    }
-    
-    /**
-     Returns `true` if the `NSManagedObject` instance being observed still exists, or `false` if the object was already deleted.
-     */
-    public var isObjectDeleted: Bool {
-        
-        return self.object?.managedObjectContext == nil
-    }
-    
-    /**
-     Registers an `ObjectObserver` to be notified when changes to the receiver's `object` are made.
-     
-     To prevent retain-cycles, `ObjectMonitor` only keeps `weak` references to its observers.
-     
-     For thread safety, this method needs to be called from the main thread. An assertion failure will occur (on debug builds only) if called from any thread other than the main thread.
-     
-     Calling `addObserver(_:)` multiple times on the same observer is safe, as `ObjectMonitor` unregisters previous notifications to the observer before re-registering them.
-     
-     - parameter observer: an `ObjectObserver` to send change notifications to
-     */
-    public func addObserver<U: ObjectObserver where U.ObjectEntityType == T>(observer: U) {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to add an observer of type \(typeName(observer)) outside the main thread."
-        )
-        
-        self.removeObserver(observer)
-        
-        self.registerChangeNotification(
-            &self.willChangeObjectKey,
-            name: ObjectMonitorWillChangeObjectNotification,
-            toObserver: observer,
-            callback: { [weak observer] (monitor) -> Void in
-                
-                guard let object = monitor.object, let observer = observer else {
-                    
-                    return
-                }
-                observer.objectMonitor(monitor, willUpdateObject: object)
-            }
-        )
-        self.registerObjectNotification(
-            &self.didDeleteObjectKey,
-            name: ObjectMonitorDidDeleteObjectNotification,
-            toObserver: observer,
-            callback: { [weak observer] (monitor, object) -> Void in
-                
-                guard let observer = observer else {
-                    
-                    return
-                }
-                observer.objectMonitor(monitor, didDeleteObject: object)
-            }
-        )
-        self.registerObjectNotification(
-            &self.didUpdateObjectKey,
-            name: ObjectMonitorDidUpdateObjectNotification,
-            toObserver: observer,
-            callback: { [weak self, weak observer] (monitor, object) -> Void in
-                
-                guard let strongSelf = self, let observer = observer else {
-                    
-                    return
-                }
-                
-                let previousCommitedAttributes = strongSelf.lastCommittedAttributes
-                let currentCommitedAttributes = object.committedValuesForKeys(nil) as! [String: NSObject]
-                
-                var changedKeys = Set<String>()
-                for key in currentCommitedAttributes.keys {
-                    
-                    if previousCommitedAttributes[key] != currentCommitedAttributes[key] {
-                        
-                        changedKeys.insert(key)
-                    }
-                }
-                
-                strongSelf.lastCommittedAttributes = currentCommitedAttributes
-                observer.objectMonitor(
-                    monitor,
-                    didUpdateObject: object,
-                    changedPersistentKeys: changedKeys
-                )
-            }
-        )
-    }
-    
-    /**
-     Unregisters an `ObjectObserver` from receiving notifications for changes to the receiver's `object`.
-     
-     For thread safety, this method needs to be called from the main thread. An assertion failure will occur (on debug builds only) if called from any thread other than the main thread.
-     
-     - parameter observer: an `ObjectObserver` to unregister notifications to
-     */
-    public func removeObserver<U: ObjectObserver where U.ObjectEntityType == T>(observer: U) {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to remove an observer of type \(typeName(observer)) outside the main thread."
-        )
-        
-        let nilValue: AnyObject? = nil
-        setAssociatedRetainedObject(nilValue, forKey: &self.willChangeObjectKey, inObject: observer)
-        setAssociatedRetainedObject(nilValue, forKey: &self.didDeleteObjectKey, inObject: observer)
-        setAssociatedRetainedObject(nilValue, forKey: &self.didUpdateObjectKey, inObject: observer)
-    }
-    
-    
-    // MARK: Internal
-    
-    internal convenience init(dataStack: DataStack, object: T) {
-        
-        self.init(context: dataStack.mainContext, object: object)
-    }
-    
-    internal convenience init(unsafeTransaction: UnsafeDataTransaction, object: T) {
-        
-        self.init(context: unsafeTransaction.context, object: object)
-    }
-    
-    private init(context: NSManagedObjectContext, object: T) {
-        
-        let fetchRequest = NSFetchRequest()
-        fetchRequest.entity = object.entity
-        fetchRequest.fetchLimit = 0
-        fetchRequest.resultType = .ManagedObjectResultType
-        fetchRequest.sortDescriptors = []
-        fetchRequest.includesPendingChanges = false
-        fetchRequest.shouldRefreshRefetchedObjects = true
-        
-        let fetchedResultsController = CoreStoreFetchedResultsController<T>(
-            context: context,
-            fetchRequest: fetchRequest,
-            fetchClauses: [Where("SELF", isEqualTo: object.objectID)]
-        )
-        
-        let fetchedResultsControllerDelegate = FetchedResultsControllerDelegate()
-        
-        self.fetchedResultsController = fetchedResultsController
-        self.fetchedResultsControllerDelegate = fetchedResultsControllerDelegate
-        
-        fetchedResultsControllerDelegate.handler = self
-        fetchedResultsControllerDelegate.fetchedResultsController = fetchedResultsController
-        try! fetchedResultsController.performFetchFromSpecifiedStores()
-        
-        self.lastCommittedAttributes = (self.object?.committedValuesForKeys(nil) as? [String: NSObject]) ?? [:]
-    }
-    
-    deinit {
-        
-        self.fetchedResultsControllerDelegate.fetchedResultsController = nil
-    }
-    
-    
-    // MARK: Private
-    
-    private let fetchedResultsController: CoreStoreFetchedResultsController<T>
-    private let fetchedResultsControllerDelegate: FetchedResultsControllerDelegate
-    private var lastCommittedAttributes = [String: NSObject]()
-    
-    private var willChangeObjectKey: Void?
-    private var didDeleteObjectKey: Void?
-    private var didUpdateObjectKey: Void?
-    
-    private func registerChangeNotification(notificationKey: UnsafePointer<Void>, name: String, toObserver observer: AnyObject, callback: (monitor: ObjectMonitor<T>) -> Void) {
-        
-        setAssociatedRetainedObject(
-            NotificationObserver(
-                notificationName: name,
-                object: self,
-                closure: { [weak self] (note) -> Void in
-                    
-                    guard let strongSelf = self else {
-                        
-                        return
-                    }
-                    callback(monitor: strongSelf)
-                }
-            ),
-            forKey: notificationKey,
-            inObject: observer
-        )
-    }
-    
-    private func registerObjectNotification(notificationKey: UnsafePointer<Void>, name: String, toObserver observer: AnyObject, callback: (monitor: ObjectMonitor<T>, object: T) -> Void) {
-        
-        setAssociatedRetainedObject(
-            NotificationObserver(
-                notificationName: name,
-                object: self,
-                closure: { [weak self] (note) -> Void in
-                    
-                    guard let strongSelf = self,
-                        let userInfo = note.userInfo,
-                        let object = userInfo[UserInfoKeyObject] as? T else {
-                            
-                            return
-                    }
-                    callback(monitor: strongSelf, object: object)
-                }
-            ),
-            forKey: notificationKey,
-            inObject: observer
-        )
-    }
-}
-
-
-// MARK: - ObjectMonitor: Equatable
-
-@available(OSX, unavailable)
-public func ==<T: NSManagedObject>(lhs: ObjectMonitor<T>, rhs: ObjectMonitor<T>) -> Bool {
-    
-    return lhs === rhs
-}
-
-@available(OSX, unavailable)
-extension ObjectMonitor: Equatable { }
-
-
-// MARK: - ObjectMonitor: FetchedResultsControllerHandler
-
-@available(OSX, unavailable)
-extension ObjectMonitor: FetchedResultsControllerHandler {
-    
-    // MARK: FetchedResultsControllerHandler
-    
-    internal func controllerWillChangeContent(controller: NSFetchedResultsController) {
-        
-        NSNotificationCenter.defaultCenter().postNotificationName(
-            ObjectMonitorWillChangeObjectNotification,
-            object: self
-        )
-    }
-    
-    internal func controllerDidChangeContent(controller: NSFetchedResultsController) { }
-    
-    internal func controller(controller: NSFetchedResultsController, didChangeObject anObject: AnyObject, atIndexPath indexPath: NSIndexPath?, forChangeType type: NSFetchedResultsChangeType, newIndexPath: NSIndexPath?) {
-        
-        switch type {
-            
-        case .Delete:
-            NSNotificationCenter.defaultCenter().postNotificationName(
-                ObjectMonitorDidDeleteObjectNotification,
-                object: self,
-                userInfo: [UserInfoKeyObject: anObject]
-            )
-            
-        case .Update:
-            NSNotificationCenter.defaultCenter().postNotificationName(
-                ObjectMonitorDidUpdateObjectNotification,
-                object: self,
-                userInfo: [UserInfoKeyObject: anObject]
-            )
-            
-        default:
-            break
-        }
-    }
-    
-    internal func controller(controller: NSFetchedResultsController, didChangeSection sectionInfo: NSFetchedResultsSectionInfo, atIndex sectionIndex: Int, forChangeType type: NSFetchedResultsChangeType) { }
-    
-    internal func controller(controller: NSFetchedResultsController, sectionIndexTitleForSectionName sectionName: String?) -> String? {
-        
-        return sectionName
-    }
-}
-
-
-private let ObjectMonitorWillChangeObjectNotification = "ObjectMonitorWillChangeObjectNotification"
-private let ObjectMonitorDidDeleteObjectNotification = "ObjectMonitorDidDeleteObjectNotification"
-private let ObjectMonitorDidUpdateObjectNotification = "ObjectMonitorDidUpdateObjectNotification"
-
-private let UserInfoKeyObject = "UserInfoKeyObject"
-

CoreStore/Observing/SectionBy.swift

@@ -1,72 +0,0 @@
-//
-//  SectionBy.swift
-//  CoreStore
-//
-//  Copyright © 2015 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: - SectionBy
-
-/**
- The `SectionBy` clause indicates the key path to use to group the `ListMonitor` objects into sections. An optional closure can also be provided to transform the value into an appropriate section name:
- ```
- let monitor = CoreStore.monitorSectionedList(
-     From(MyPersonEntity),
-     SectionBy("age") { "Age \($0)" },
-     OrderBy(.Ascending("lastName"))
- )
- ```
- */
-@available(OSX, unavailable)
-public struct SectionBy {
-    
-    /**
-     Initializes a `SectionBy` clause with the key path to use to group `ListMonitor` objects into sections
-     
-     - parameter sectionKeyPath: the key path to use to group the objects into sections
-     */
-    public init(_ sectionKeyPath: KeyPath) {
-        
-        self.init(sectionKeyPath, { $0 })
-    }
-    
-    /**
-     Initializes a `SectionBy` clause with the key path to use to group `ListMonitor` objects into sections, and a closure to transform the value for the key path to an appropriate section name
-     
-     - parameter sectionKeyPath: the key path to use to group the objects into sections
-     - parameter sectionIndexTransformer: a closure to transform the value for the key path to an appropriate section name
-     */
-    public init(_ sectionKeyPath: KeyPath, _ sectionIndexTransformer: (sectionName: String?) -> String?) {
-        
-        self.sectionKeyPath = sectionKeyPath
-        self.sectionIndexTransformer = sectionIndexTransformer
-    }
-    
-    
-    // MARK: Internal
-    
-    internal let sectionKeyPath: KeyPath
-    internal let sectionIndexTransformer: (sectionName: KeyPath?) -> String?
-}

CoreStore/Observing/UnsafeDataTransaction+Observing.swift

@@ -1,198 +0,0 @@
-//
-//  UnsafeDataTransaction+Observing.swift
-//  CoreStore
-//
-//  Copyright © 2016 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - UnsafeDataTransaction
-
-@available(OSX, unavailable)
-public extension UnsafeDataTransaction {
-    
-    /**
-     Creates a `ObjectMonitor` for the specified `NSManagedObject`. Multiple `ObjectObserver`s may then register themselves to be notified when changes are made to the `NSManagedObject`.
-     
-     - parameter object: the `NSManagedObject` to observe changes from
-     - returns: a `ObjectMonitor` that monitors changes to `object`
-     */
-    @warn_unused_result
-    public func monitorObject<T: NSManagedObject>(object: T) -> ObjectMonitor<T> {
-        
-        return ObjectMonitor(
-            unsafeTransaction: self,
-            object: object
-        )
-    }
-    
-    /**
-     Creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorList<T: NSManagedObject>(from: From<T>, _ fetchClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.monitorList(from, fetchClauses)
-    }
-    
-    /**
-     Creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorList<T: NSManagedObject>(from: From<T>, _ fetchClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        return ListMonitor(
-            unsafeTransaction: self,
-            from: from,
-            sectionBy: nil,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: FetchClause...) {
-        
-        self.monitorList(createAsynchronously: createAsynchronously, from, fetchClauses)
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ fetchClauses: [FetchClause])  {
-        
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        _ = ListMonitor(
-            unsafeTransaction: self,
-            from: from,
-            sectionBy: nil,
-            fetchClauses: fetchClauses,
-            createAsynchronously: createAsynchronously
-        )
-    }
-    
-    /**
-     Creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) -> ListMonitor<T> {
-        
-        return self.monitorSectionedList(from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list.
-     
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - returns: a `ListMonitor` instance that monitors changes to the list
-     */
-    @warn_unused_result
-    public func monitorSectionedList<T: NSManagedObject>(from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) -> ListMonitor<T> {
-        
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        return ListMonitor(
-            unsafeTransaction: self,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses
-        )
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: FetchClause...) {
-        
-        self.monitorSectionedList(createAsynchronously: createAsynchronously, from, sectionBy, fetchClauses)
-    }
-    
-    /**
-     Asynchronously creates a `ListMonitor` for a sectioned list of `NSManagedObject`s that satisfy the specified fetch clauses. Multiple `ListObserver`s may then register themselves to be notified when changes are made to the list. Since `NSFetchedResultsController` greedily locks the persistent store on initial fetch, you may prefer this method instead of the synchronous counterpart to avoid deadlocks while background updates/saves are being executed.
-     
-     - parameter createAsynchronously: the closure that receives the created `ListMonitor` instance
-     - parameter from: a `From` clause indicating the entity type
-     - parameter sectionBy: a `SectionBy` clause indicating the keyPath for the attribute to use when sorting the list into sections.
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     */
-    public func monitorSectionedList<T: NSManagedObject>(createAsynchronously createAsynchronously: (ListMonitor<T>) -> Void, _ from: From<T>, _ sectionBy: SectionBy, _ fetchClauses: [FetchClause]) {
-        
-        CoreStore.assert(
-            fetchClauses.filter { $0 is OrderBy }.count > 0,
-            "A ListMonitor requires an OrderBy clause."
-        )
-        
-        _ = ListMonitor(
-            unsafeTransaction: self,
-            from: from,
-            sectionBy: sectionBy,
-            fetchClauses: fetchClauses,
-            createAsynchronously: createAsynchronously
-        )
-    }
-}

CoreStore/Saving and Processing/AsynchronousDataTransaction.swift

@@ -1,256 +0,0 @@
-//
-//  AsynchronousDataTransaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - AsynchronousDataTransaction
-
-/**
- The `AsynchronousDataTransaction` provides an interface for `NSManagedObject` creates, updates, and deletes. A transaction object should typically be only used from within a transaction block initiated from `DataStack.beginAsynchronous(_:)`, or from `CoreStore.beginAsynchronous(_:)`.
- */
-public final class AsynchronousDataTransaction: BaseDataTransaction {
-    
-    /**
-     Saves the transaction changes. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter completion: the block executed after the save completes. Success or failure is reported by the `SaveResult` argument of the block.
-     */
-    public func commit(completion: (result: SaveResult) -> Void = { _ in }) {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to commit a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to commit a \(typeName(self)) more than once."
-        )
-        
-        self.isCommitted = true
-        let group = GCDGroup()
-        group.enter()
-        self.context.saveAsynchronouslyWithCompletion { (result) -> Void in
-            
-            self.result = result
-            completion(result: result)
-            group.leave()
-        }
-        group.wait()
-    }
-    
-    /**
-     Begins a child transaction synchronously where NSManagedObject creates, updates, and deletes can be made. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     - returns: a `SaveResult` value indicating success or failure, or `nil` if the transaction was not comitted synchronously
-     */
-    public func beginSynchronous(closure: (transaction: SynchronousDataTransaction) -> Void) -> SaveResult? {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to begin a child transaction from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to begin a child transaction from an already committed \(typeName(self))."
-        )
-        
-        return SynchronousDataTransaction(
-            mainContext: self.context,
-            queue: self.childTransactionQueue,
-            closure: closure).performAndWait()
-    }
-    
-    
-    // MARK: BaseDataTransaction
-    
-    /**
-     Creates a new `NSManagedObject` with the specified entity type.
-     
-     - parameter into: the `Into` clause indicating the destination `NSManagedObject` entity type and the destination configuration
-     - returns: a new `NSManagedObject` instance of the specified entity type.
-     */
-    public override func create<T: NSManagedObject>(into: Into<T>) -> T {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to create an entity of type \(typeName(T)) from an already committed \(typeName(self))."
-        )
-        
-        return super.create(into)
-    }
-    
-    /**
-     Returns an editable proxy of a specified `NSManagedObject`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter object: the `NSManagedObject` type to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public override func edit<T: NSManagedObject>(object: T?) -> T? {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to update an entity of type \(typeName(object)) from an already committed \(typeName(self))."
-        )
-        
-        return super.edit(object)
-    }
-    
-    /**
-     Returns an editable proxy of the object with the specified `NSManagedObjectID`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter objectID: the `NSManagedObjectID` for the object to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public override func edit<T: NSManagedObject>(into: Into<T>, _ objectID: NSManagedObjectID) -> T? {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to update an entity of type \(typeName(T)) from an already committed \(typeName(self))."
-        )
-        
-        return super.edit(into, objectID)
-    }
-    
-    /**
-     Deletes a specified `NSManagedObject`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter object: the `NSManagedObject` type to be deleted
-     */
-    public override func delete(object: NSManagedObject?) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entity of type \(typeName(object)) from an already committed \(typeName(self))."
-        )
-        
-        super.delete(object)
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter object1: the `NSManagedObject` type to be deleted
-     - parameter object2: another `NSManagedObject` type to be deleted
-     - parameter objects: other `NSManagedObject`s type to be deleted
-     */
-    public override func delete(object1: NSManagedObject?, _ object2: NSManagedObject?, _ objects: NSManagedObject?...) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entities from an already committed \(typeName(self))."
-        )
-        
-        super.delete(([object1, object2] + objects).flatMap { $0 })
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter objects: the `NSManagedObject`s type to be deleted
-     */
-    public override func delete<S: SequenceType where S.Generator.Element: NSManagedObject>(objects: S) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entities from an already committed \(typeName(self))."
-        )
-        
-        super.delete(objects)
-    }
-    
-    /**
-     Rolls back the transaction by resetting the `NSManagedObjectContext`. After calling this method, all `NSManagedObjects` fetched within the transaction will become invalid. This method should not be used after the `commit()` method was already called once.
-     */
-    @available(*, deprecated=1.3.4, message="Resetting the context is inherently unsafe. This method will be removed in the near future. Use `beginUnsafe()` to create transactions with `undo` support.")
-    public func rollback() {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to rollback an already committed \(typeName(self))."
-        )
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to rollback a \(typeName(self)) outside its designated queue."
-        )
-        
-        self.context.reset()
-    }
-    
-    
-    // MARK: Internal
-    
-    internal init(mainContext: NSManagedObjectContext, queue: GCDQueue, closure: (transaction: AsynchronousDataTransaction) -> Void) {
-        
-        self.closure = closure
-        
-        super.init(mainContext: mainContext, queue: queue, supportsUndo: false, bypassesQueueing: false)
-    }
-    
-    internal func perform() {
-        
-        self.transactionQueue.async {
-            
-            self.closure(transaction: self)
-            if !self.isCommitted && self.hasChanges {
-                
-                CoreStore.log(
-                    .Warning,
-                    message: "The closure for the \(typeName(self)) completed without being committed. All changes made within the transaction were discarded."
-                )
-            }
-        }
-    }
-    
-    internal func performAndWait() -> SaveResult? {
-        
-        self.transactionQueue.sync {
-            
-            self.closure(transaction: self)
-            
-            if !self.isCommitted && self.hasChanges {
-                
-                CoreStore.log(
-                    .Warning,
-                    message: "The closure for the \(typeName(self)) completed without being committed. All changes made within the transaction were discarded."
-                )
-            }
-        }
-        return self.result
-    }
-    
-    
-    // MARK: Private
-    
-    private let closure: (transaction: AsynchronousDataTransaction) -> Void
-}

CoreStore/Saving and Processing/BaseDataTransaction.swift

@@ -1,482 +0,0 @@
-//
-//  BaseDataTransaction.swift
-//  CoreStore
-//
-//  Copyright © 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - BaseDataTransaction
-
-/**
- The `BaseDataTransaction` is an abstract interface for `NSManagedObject` creates, updates, and deletes. All `BaseDataTransaction` subclasses manage a private `NSManagedObjectContext` which are direct children of the `NSPersistentStoreCoordinator`'s root `NSManagedObjectContext`. This means that all updates are saved first to the persistent store, and then propagated up to the read-only `NSManagedObjectContext`.
- */
-public /*abstract*/ class BaseDataTransaction {
-    
-    // MARK: Object management
-    
-    /**
-     Indicates if the transaction has pending changes
-     */
-    public var hasChanges: Bool {
-        
-        return self.context.hasChanges
-    }
-    
-    /**
-     Creates a new `NSManagedObject` with the specified entity type.
-     
-     - parameter into: the `Into` clause indicating the destination `NSManagedObject` entity type and the destination configuration
-     - returns: a new `NSManagedObject` instance of the specified entity type.
-     */
-    public func create<T: NSManagedObject>(into: Into<T>) -> T {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to create an entity of type \(typeName(T)) outside its designated queue."
-        )
-        
-        let context = self.context
-        let entityClass = (into.entityClass as! NSManagedObject.Type)
-        if into.inferStoreIfPossible {
-            
-            switch context.parentStack!.persistentStoreForEntityClass(entityClass, configuration: nil, inferStoreIfPossible: true) {
-                
-            case (let persistentStore?, _):
-                let object = entityClass.createInContext(context) as! T
-                context.assignObject(object, toPersistentStore: persistentStore)
-                return object
-                
-            case (.None, true):
-                fatalError("Attempted to create an entity of type \(typeName(entityClass)) with ambiguous destination persistent store, but the configuration name was not specified.")
-                
-            default:
-                fatalError("Attempted to create an entity of type \(typeName(entityClass)), but a destination persistent store containing the entity type could not be found.")
-            }
-        }
-        else {
-            
-            switch context.parentStack!.persistentStoreForEntityClass(entityClass, configuration: into.configuration, inferStoreIfPossible: false) {
-                
-            case (let persistentStore?, _):
-                let object = entityClass.createInContext(context) as! T
-                context.assignObject(object, toPersistentStore: persistentStore)
-                return object
-                
-            default:
-                if let configuration = into.configuration {
-                    
-                    fatalError("Attempted to create an entity of type \(typeName(entityClass)) into the configuration \"\(configuration)\", which it doesn't belong to.")
-                }
-                else {
-                    
-                    fatalError("Attempted to create an entity of type \(typeName(entityClass)) into the default configuration, which it doesn't belong to.")
-                }
-            }
-        }
-    }
-    
-    /**
-     Returns an editable proxy of a specified `NSManagedObject`.
-     
-     - parameter object: the `NSManagedObject` type to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public func edit<T: NSManagedObject>(object: T?) -> T? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to update an entity of type \(typeName(object)) outside its designated queue."
-        )
-        guard let object = object else {
-            
-            return nil
-        }
-        return self.context.fetchExisting(object)
-    }
-    
-    /**
-     Returns an editable proxy of the object with the specified `NSManagedObjectID`.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter objectID: the `NSManagedObjectID` for the object to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public func edit<T: NSManagedObject>(into: Into<T>, _ objectID: NSManagedObjectID) -> T? {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to update an entity of type \(typeName(T)) outside its designated queue."
-        )
-        CoreStore.assert(
-            into.inferStoreIfPossible
-                || (into.configuration ?? Into.defaultConfigurationName) == objectID.persistentStore?.configurationName,
-            "Attempted to update an entity of type \(typeName(T)) but the specified persistent store do not match the `NSManagedObjectID`."
-        )
-        return self.fetchExisting(objectID) as? T
-    }
-    
-    /**
-     Deletes a specified `NSManagedObject`.
-     
-     - parameter object: the `NSManagedObject` to be deleted
-     */
-    public func delete(object: NSManagedObject?) {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to delete an entity outside its designated queue."
-        )
-        guard let object = object else {
-            
-            return
-        }
-        self.context.fetchExisting(object)?.deleteFromContext()
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter object1: the `NSManagedObject` to be deleted
-     - parameter object2: another `NSManagedObject` to be deleted
-     - parameter objects: other `NSManagedObject`s to be deleted
-     */
-    public func delete(object1: NSManagedObject?, _ object2: NSManagedObject?, _ objects: NSManagedObject?...) {
-        
-        self.delete(([object1, object2] + objects).flatMap { $0 })
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter objects: the `NSManagedObject`s to be deleted
-     */
-    public func delete<S: SequenceType where S.Generator.Element: NSManagedObject>(objects: S) {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to delete entities outside their designated queue."
-        )
-        
-        let context = self.context
-        objects.forEach { context.fetchExisting($0)?.deleteFromContext() }
-    }
-    
-    /**
-     Refreshes all registered objects `NSManagedObject`s in the transaction.
-     */
-    public func refreshAllObjectsAsFaults() {
-        
-        CoreStore.assert(
-            self.isRunningInAllowedQueue(),
-            "Attempted to refresh entities outside their designated queue."
-        )
-        
-        self.context.refreshAllObjectsAsFaults()
-    }
-    
-    
-    // MARK: Inspecting Pending Objects
-    
-    /**
-    Returns all pending `NSManagedObject`s that were inserted to the transaction. This method should not be called after the `commit()` method was called.
-    
-    - returns: a `Set` of pending `NSManagedObject`s that were inserted to the transaction.
-    */
-    public func insertedObjects() -> Set<NSManagedObject> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access inserted objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access inserted objects from an already committed \(typeName(self))."
-        )
-        
-        return self.context.insertedObjects
-    }
-    
-    /**
-     Returns all pending `NSManagedObject`s of the specified type that were inserted to the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObject`s of the specified type that were inserted to the transaction.
-     */
-    public func insertedObjects<T: NSManagedObject>(entity: T.Type) -> Set<T> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access inserted objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access inserted objects from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.insertedObjects.flatMap { $0 as? T })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s that were inserted to the transaction. This method should not be called after the `commit()` method was called.
-     
-     - returns: a `Set` of pending `NSManagedObjectID`s that were inserted to the transaction.
-     */
-    public func insertedObjectIDs() -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access inserted object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access inserted objects IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.insertedObjects.map { $0.objectID })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s of the specified type that were inserted to the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObjectID`s of the specified type that were inserted to the transaction.
-     */
-    public func insertedObjectIDs<T: NSManagedObject>(entity: T.Type) -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access inserted object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access inserted objects IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.insertedObjects.flatMap { $0 as? T }.map { $0.objectID })
-    }
-    
-    /**
-     Returns all pending `NSManagedObject`s that were updated in the transaction. This method should not be called after the `commit()` method was called.
-     
-     - returns: a `Set` of pending `NSManagedObject`s that were updated to the transaction.
-     */
-    public func updatedObjects() -> Set<NSManagedObject> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access updated objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access updated objects from an already committed \(typeName(self))."
-        )
-        
-        return self.context.updatedObjects
-    }
-    
-    /**
-     Returns all pending `NSManagedObject`s of the specified type that were updated in the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObject`s of the specified type that were updated in the transaction.
-     */
-    public func updatedObjects<T: NSManagedObject>(entity: T.Type) -> Set<T> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access updated objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access updated objects from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.updatedObjects.flatMap { $0 as? T })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s that were updated in the transaction. This method should not be called after the `commit()` method was called.
-     
-     - returns: a `Set` of pending `NSManagedObjectID`s that were updated in the transaction.
-     */
-    public func updatedObjectIDs() -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access updated object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access updated object IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.updatedObjects.map { $0.objectID })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s of the specified type that were updated in the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObjectID`s of the specified type that were updated in the transaction.
-     */
-    public func updatedObjectIDs<T: NSManagedObject>(entity: T.Type) -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access updated object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access updated object IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.updatedObjects.flatMap { $0 as? T }.map { $0.objectID })
-    }
-    
-    /**
-     Returns all pending `NSManagedObject`s that were deleted from the transaction. This method should not be called after the `commit()` method was called.
-     
-     - returns: a `Set` of pending `NSManagedObject`s that were deleted from the transaction.
-     */
-    public func deletedObjects() -> Set<NSManagedObject> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access deleted objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access deleted objects from an already committed \(typeName(self))."
-        )
-        
-        return self.context.deletedObjects
-    }
-    
-    /**
-     Returns all pending `NSManagedObject`s of the specified type that were deleted from the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObject`s of the specified type that were deleted from the transaction.
-     */
-    public func deletedObjects<T: NSManagedObject>(entity: T.Type) -> Set<T> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access deleted objects from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access deleted objects from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.deletedObjects.flatMap { $0 as? T })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s of the specified type that were deleted from the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObjectID`s of the specified type that were deleted from the transaction.
-     */
-    public func deletedObjectIDs() -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access deleted object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access deleted object IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.deletedObjects.map { $0.objectID })
-    }
-    
-    /**
-     Returns all pending `NSManagedObjectID`s of the specified type that were deleted from the transaction. This method should not be called after the `commit()` method was called.
-     
-     - parameter entity: the `NSManagedObject` subclass to filter
-     - returns: a `Set` of pending `NSManagedObjectID`s of the specified type that were deleted from the transaction.
-     */
-    public func deletedObjectIDs<T: NSManagedObject>(entity: T.Type) -> Set<NSManagedObjectID> {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to access deleted object IDs from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to access deleted object IDs from an already committed \(typeName(self))."
-        )
-        
-        return Set(self.context.deletedObjects.flatMap { $0 as? T }.map { $0.objectID })
-    }
-    
-    
-    // MARK: Internal
-    
-    internal let context: NSManagedObjectContext
-    internal let transactionQueue: GCDQueue
-    internal let childTransactionQueue: GCDQueue = .createSerial("com.corestore.datastack.childtransactionqueue")
-    internal let supportsUndo: Bool
-    internal let bypassesQueueing: Bool
-    
-    
-    internal var isCommitted = false
-    internal var result: SaveResult?
-    
-    internal init(mainContext: NSManagedObjectContext, queue: GCDQueue, supportsUndo: Bool, bypassesQueueing: Bool) {
-        
-        let context = mainContext.temporaryContextInTransactionWithConcurrencyType(
-            queue == .Main
-                ? .MainQueueConcurrencyType
-                : .PrivateQueueConcurrencyType
-        )
-        self.transactionQueue = queue
-        self.context = context
-        self.supportsUndo = supportsUndo
-        self.bypassesQueueing = bypassesQueueing
-        
-        context.parentTransaction = self
-        if !supportsUndo {
-            
-            context.undoManager = nil
-        }
-        else if context.undoManager == nil {
-            
-            context.undoManager = NSUndoManager()
-        }
-    }
-    
-    internal func isRunningInAllowedQueue() -> Bool {
-        
-        return self.bypassesQueueing || self.transactionQueue.isCurrentExecutionContext()
-    }
-}

CoreStore/Saving and Processing/CoreStore+Transaction.swift

@@ -1,80 +0,0 @@
-//
-//  CoreStore+Transaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-
-
-// MARK: - CoreStore
-
-public extension CoreStore {
-    
-    /**
-     Using the `defaultStack`, begins a transaction asynchronously where `NSManagedObject` creates, updates, and deletes can be made.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     */
-    public static func beginAsynchronous(closure: (transaction: AsynchronousDataTransaction) -> Void) {
-        
-        self.defaultStack.beginAsynchronous(closure)
-    }
-    
-    /**
-     Using the `defaultStack`, begins a transaction asynchronously where `NSManagedObject` creates, updates, and deletes can be made.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     - returns: a `SaveResult` value indicating success or failure, or `nil` if the transaction was not comitted synchronously
-     */
-    public static func beginSynchronous(closure: (transaction: SynchronousDataTransaction) -> Void) -> SaveResult? {
-        
-        return self.defaultStack.beginSynchronous(closure)
-    }
-    
-    /**
-     Using the `defaultStack`, begins a non-contiguous transaction where `NSManagedObject` creates, updates, and deletes can be made. This is useful for making temporary changes, such as partially filled forms. An unsafe transaction object should typically be only used from the main queue.
-     
-     - prameter supportsUndo: `undo()`, `redo()`, and `rollback()` methods are only available when this parameter is `true`, otherwise those method will raise an exception. Defaults to `false`. Note that turning on Undo support may heavily impact performance especially on iOS or watchOS where memory is limited.
-     - returns: a `UnsafeDataTransaction` instance where creates, updates, and deletes can be made.
-     */
-    @warn_unused_result
-    public static func beginUnsafe(supportsUndo supportsUndo: Bool = false) -> UnsafeDataTransaction {
-        
-        return self.defaultStack.beginUnsafe(supportsUndo: supportsUndo)
-    }
-    
-    /**
-     Refreshes all registered objects `NSManagedObject`s in the `DataStack`.
-     */
-    public static func refreshAllObjectsAsFaults() {
-        
-        self.defaultStack.refreshAllObjectsAsFaults()
-    }
-    
-    @available(*, deprecated=1.3.1, renamed="beginUnsafe")
-    @warn_unused_result
-    public static func beginDetached() -> UnsafeDataTransaction {
-        
-        return self.beginUnsafe()
-    }
-}

CoreStore/Saving and Processing/DataStack+Transaction.swift

@@ -1,102 +0,0 @@
-//
-//  DataStack+Transaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - DataStack
-
-public extension DataStack {
-    
-    /**
-     Begins a transaction asynchronously where `NSManagedObject` creates, updates, and deletes can be made.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     */
-    public func beginAsynchronous(closure: (transaction: AsynchronousDataTransaction) -> Void) {
-        
-        AsynchronousDataTransaction(
-            mainContext: self.rootSavingContext,
-            queue: self.childTransactionQueue,
-            closure: closure).perform()
-    }
-    
-    /**
-     Begins a transaction synchronously where `NSManagedObject` creates, updates, and deletes can be made.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     - returns: a `SaveResult` value indicating success or failure, or `nil` if the transaction was not comitted synchronously
-     */
-    public func beginSynchronous(closure: (transaction: SynchronousDataTransaction) -> Void) -> SaveResult? {
-        
-        return SynchronousDataTransaction(
-            mainContext: self.rootSavingContext,
-            queue: self.childTransactionQueue,
-            closure: closure).performAndWait()
-    }
-    
-    /**
-     Begins a non-contiguous transaction where `NSManagedObject` creates, updates, and deletes can be made. This is useful for making temporary changes, such as partially filled forms.
-     
-     - prameter supportsUndo: `undo()`, `redo()`, and `rollback()` methods are only available when this parameter is `true`, otherwise those method will raise an exception. Defaults to `false`. Note that turning on Undo support may heavily impact performance especially on iOS or watchOS where memory is limited.
-     - returns: a `UnsafeDataTransaction` instance where creates, updates, and deletes can be made.
-     */
-    @warn_unused_result
-    public func beginUnsafe(supportsUndo supportsUndo: Bool = false) -> UnsafeDataTransaction {
-        
-        return UnsafeDataTransaction(
-            mainContext: self.rootSavingContext,
-            queue: .createSerial(
-                "com.coreStore.dataStack.unsafeTransactionQueue",
-                targetQueue: .UserInitiated
-            ),
-            supportsUndo: supportsUndo
-        )
-    }
-    
-    /**
-     Refreshes all registered objects `NSManagedObject`s in the `DataStack`.
-     */
-    public func refreshAllObjectsAsFaults() {
-        
-        CoreStore.assert(
-            NSThread.isMainThread(),
-            "Attempted to refresh entities outside their designated queue."
-        )
-        
-        self.mainContext.refreshAllObjectsAsFaults()
-    }
-    
-    @available(*, deprecated=1.3.1, renamed="beginUnsafe")
-    @warn_unused_result
-    public func beginDetached() -> UnsafeDataTransaction {
-        
-        return self.beginUnsafe()
-    }
-}

CoreStore/Saving and Processing/SaveResult.swift

@@ -1,109 +0,0 @@
-//
-//  SaveResult.swift
-//  CoreStore
-//
-//  Copyright © 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
-
-
-// MARK: - SaveResult
-
-/**
- The `SaveResult` indicates the result of a `commit(...)` for a transaction.
- The `SaveResult` can be treated as a boolean:
- ```
- CoreStore.beginAsynchronous { transaction in
-     // ...
-     let result = transaction.commit()
-     if result {
-        // succeeded
-     }
-     else {
-        // failed
-     }
- }
- ```
- or as an `enum`, where the resulting associated object can also be inspected:
- ```
- CoreStore.beginAsynchronous { transaction in
-     // ...
-     let result = transaction.commit()
-     switch result {
-     case .Success(let hasChanges):
-        // hasChanges indicates if there were changes or not
-     case .Failure(let error):
-        // error is the NSError instance for the failure
-     }
- }
- ```
- */
-public enum SaveResult {
-    
-    /**
-     `SaveResult.Success` indicates that the `commit()` for the transaction succeeded, either because the save succeeded or because there were no changes to save. The associated value `hasChanges` indicates if there were saved changes or not.
-     */
-    case Success(hasChanges: Bool)
-    
-    /**
-     `SaveResult.Failure` indicates that the `commit()` for the transaction failed. The associated object for this value is the related `NSError` instance.
-     */
-    case Failure(NSError)
-    
-    
-    // MARK: Internal
-    
-    internal init(hasChanges: Bool) {
-        
-        self = .Success(hasChanges: hasChanges)
-    }
-    
-    internal init(_ error: NSError) {
-        
-        self = .Failure(error)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode) {
-        
-        self.init(errorCode, userInfo: nil)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode, userInfo: [NSObject: AnyObject]?) {
-        
-        self.init(NSError(coreStoreErrorCode: errorCode, userInfo: userInfo))
-    }
-}
-
-
-// MARK: - SaveResult: BooleanType
-
-extension SaveResult: BooleanType {
-    
-    public var boolValue: Bool {
-        
-        switch self {
-            
-        case .Success: return true
-        case .Failure: return false
-        }
-    }
-}

CoreStore/Saving and Processing/SynchronousDataTransaction.swift

@@ -1,242 +0,0 @@
-//
-//  SynchronousDataTransaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - SynchronousDataTransaction
-
-/**
- The `SynchronousDataTransaction` provides an interface for `NSManagedObject` creates, updates, and deletes. A transaction object should typically be only used from within a transaction block initiated from `DataStack.beginSynchronous(_:)`, or from `CoreStore.beginSynchronous(_:)`.
- */
-public final class SynchronousDataTransaction: BaseDataTransaction {
-    
-    /**
-     Saves the transaction changes and waits for completion synchronously. This method should not be used after the `commit()` method was already called once.
-     
-     - returns: a `SaveResult` containing the success or failure information
-     */
-    public func commitAndWait() -> SaveResult {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to commit a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to commit a \(typeName(self)) more than once."
-        )
-        
-        self.isCommitted = true
-        
-        let result = self.context.saveSynchronously()
-        self.result = result
-        return result
-    }
-    
-    /**
-     Begins a child transaction synchronously where `NSManagedObject` creates, updates, and deletes can be made. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter closure: the block where creates, updates, and deletes can be made to the transaction. Transaction blocks are executed serially in a background queue, and all changes are made from a concurrent `NSManagedObjectContext`.
-     - returns: a `SaveResult` value indicating success or failure, or `nil` if the transaction was not comitted synchronously
-     */
-    public func beginSynchronous(closure: (transaction: SynchronousDataTransaction) -> Void) -> SaveResult? {
-        
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to begin a child transaction from a \(typeName(self)) outside its designated queue."
-        )
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to begin a child transaction from an already committed \(typeName(self))."
-        )
-        
-        return SynchronousDataTransaction(
-            mainContext: self.context,
-            queue: self.childTransactionQueue,
-            closure: closure).performAndWait()
-    }
-    
-    
-    // MARK: BaseDataTransaction
-    
-    /**
-     Creates a new `NSManagedObject` with the specified entity type.
-     
-     - parameter into: the `Into` clause indicating the destination `NSManagedObject` entity type and the destination configuration
-     - returns: a new `NSManagedObject` instance of the specified entity type.
-     */
-    public override func create<T: NSManagedObject>(into: Into<T>) -> T {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to create an entity of type \(typeName(T)) from an already committed \(typeName(self))."
-        )
-        
-        return super.create(into)
-    }
-    
-    /**
-     Returns an editable proxy of a specified `NSManagedObject`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter object: the `NSManagedObject` type to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public override func edit<T: NSManagedObject>(object: T?) -> T? {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to update an entity of type \(typeName(object)) from an already committed \(typeName(self))."
-        )
-        
-        return super.edit(object)
-    }
-    
-    /**
-     Returns an editable proxy of the object with the specified `NSManagedObjectID`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter into: an `Into` clause specifying the entity type
-     - parameter objectID: the `NSManagedObjectID` for the object to be edited
-     - returns: an editable proxy for the specified `NSManagedObject`.
-     */
-    @warn_unused_result
-    public override func edit<T: NSManagedObject>(into: Into<T>, _ objectID: NSManagedObjectID) -> T? {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to update an entity of type \(typeName(T)) from an already committed \(typeName(self))."
-        )
-        
-        return super.edit(into, objectID)
-    }
-    
-    /**
-     Deletes a specified `NSManagedObject`. This method should not be used after the `commit()` method was already called once.
-     
-     - parameter object: the `NSManagedObject` type to be deleted
-     */
-    public override func delete(object: NSManagedObject?) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entity of type \(typeName(object)) from an already committed \(typeName(self))."
-        )
-        
-        super.delete(object)
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter object1: the `NSManagedObject` to be deleted
-     - parameter object2: another `NSManagedObject` to be deleted
-     - parameter objects: other `NSManagedObject`s to be deleted
-     */
-    public override func delete(object1: NSManagedObject?, _ object2: NSManagedObject?, _ objects: NSManagedObject?...) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entities from an already committed \(typeName(self))."
-        )
-        
-        super.delete(([object1, object2] + objects).flatMap { $0 })
-    }
-    
-    /**
-     Deletes the specified `NSManagedObject`s.
-     
-     - parameter objects: the `NSManagedObject`s to be deleted
-     */
-    public override func delete<S: SequenceType where S.Generator.Element: NSManagedObject>(objects: S) {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to delete an entities from an already committed \(typeName(self))."
-        )
-        
-        super.delete(objects)
-    }
-    
-    /**
-     Rolls back the transaction by resetting the `NSManagedObjectContext`. After calling this method, all `NSManagedObjects` fetched within the transaction will become invalid. This method should not be used after the `commit()` method was already called once.
-     */
-    @available(*, deprecated=1.3.4, message="Resetting the context is inherently unsafe. This method will be removed in the near future. Use `beginUnsafe()` to create transactions with `undo` support.")
-    public func rollback() {
-        
-        CoreStore.assert(
-            !self.isCommitted,
-            "Attempted to rollback an already committed \(typeName(self))."
-        )
-        CoreStore.assert(
-            self.transactionQueue.isCurrentExecutionContext(),
-            "Attempted to rollback a \(typeName(self)) outside its designated queue."
-        )
-        
-        self.context.reset()
-    }
-    
-    @available(*, deprecated=1.5.2, renamed="commitAndWait")
-    public func commit() {
-        
-        self.commitAndWait()
-    }
-    
-    
-    // MARK: Internal
-    
-    internal init(mainContext: NSManagedObjectContext, queue: GCDQueue, closure: (transaction: SynchronousDataTransaction) -> Void) {
-        
-        self.closure = closure
-        
-        super.init(mainContext: mainContext, queue: queue, supportsUndo: false, bypassesQueueing: false)
-    }
-    
-    internal func performAndWait() -> SaveResult? {
-        
-        self.transactionQueue.sync {
-            
-            self.closure(transaction: self)
-            
-            if !self.isCommitted && self.hasChanges {
-                
-                CoreStore.log(
-                    .Warning,
-                    message: "The closure for the \(typeName(self)) completed without being committed. All changes made within the transaction were discarded."
-                )
-            }
-        }
-        return self.result
-    }
-    
-    
-    // MARK: Private
-    
-    private let closure: (transaction: SynchronousDataTransaction) -> Void
-}

CoreStore/Saving and Processing/UnsafeDataTransaction.swift

@@ -1,148 +0,0 @@
-//
-//  UnsafeDataTransaction.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-@available(*, deprecated=1.3.1, renamed="UnsafeDataTransaction")
-public typealias DetachedDataTransaction = UnsafeDataTransaction
-
-
-// MARK: - UnsafeDataTransaction
-
-/**
- The `UnsafeDataTransaction` provides an interface for non-contiguous `NSManagedObject` creates, updates, and deletes. This is useful for making temporary changes, such as partially filled forms. An unsafe transaction object should typically be only used from the main queue.
- */
-public final class UnsafeDataTransaction: BaseDataTransaction {
-    
-    /**
-     Saves the transaction changes asynchronously. For a `UnsafeDataTransaction`, multiple commits are allowed, although it is the developer's responsibility to ensure a reasonable leeway to prevent blocking the main thread.
-     
-     - parameter completion: the block executed after the save completes. Success or failure is reported by the `SaveResult` argument of the block.
-     */
-    public func commit(completion: (result: SaveResult) -> Void) {
-        
-        self.context.saveAsynchronouslyWithCompletion { (result) -> Void in
-            
-            self.result = result
-            completion(result: result)
-        }
-    }
-    
-    /**
-     Saves the transaction changes and waits for completion synchronously. For a `UnsafeDataTransaction`, multiple commits are allowed, although it is the developer's responsibility to ensure a reasonable leeway to prevent blocking the main thread.
-     
-     - returns: a `SaveResult` containing the success or failure information
-     */
-    public func commitAndWait() -> SaveResult {
-        
-        let result = self.context.saveSynchronously()
-        self.result = result
-        return result
-    }
-    
-    /**
-     Rolls back the transaction.
-     */
-    public func rollback() {
-        
-        CoreStore.assert(
-            self.supportsUndo,
-            "Attempted to rollback a \(typeName(self)) with Undo support disabled."
-        )
-        self.context.rollback()
-    }
-    
-    /**
-     Undo's the last change made to the transaction.
-     */
-    public func undo() {
-        
-        CoreStore.assert(
-            self.supportsUndo,
-            "Attempted to undo a \(typeName(self)) with Undo support disabled."
-        )
-        self.context.undo()
-    }
-    
-    /**
-     Redo's the last undone change to the transaction.
-     */
-    public func redo() {
-        
-        CoreStore.assert(
-            self.supportsUndo,
-            "Attempted to redo a \(typeName(self)) with Undo support disabled."
-        )
-        self.context.redo()
-    }
-    
-    /**
-     Begins a child transaction where `NSManagedObject` creates, updates, and deletes can be made. This is useful for making temporary changes, such as partially filled forms.
-     
-     - prameter supportsUndo: `undo()`, `redo()`, and `rollback()` methods are only available when this parameter is `true`, otherwise those method will raise an exception. Defaults to `false`. Note that turning on Undo support may heavily impact performance especially on iOS or watchOS where memory is limited.
-     - returns: a `UnsafeDataTransaction` instance where creates, updates, and deletes can be made.
-     */
-    @warn_unused_result
-    public func beginUnsafe(supportsUndo supportsUndo: Bool = false) -> UnsafeDataTransaction {
-        
-        return UnsafeDataTransaction(
-            mainContext: self.context,
-            queue: self.transactionQueue,
-            supportsUndo: supportsUndo
-        )
-    }
-    
-    /**
-     Returns the `NSManagedObjectContext` for this unsafe transaction. Use only for cases where external frameworks need an `NSManagedObjectContext` instance to work with.
-     
-     Note that it is the developer's responsibility to ensure the following:
-     - that the `UnsafeDataTransaction` that owns this context should be strongly referenced and prevented from being deallocated during the context's lifetime
-     - that all saves will be done either through the `UnsafeDataTransaction`'s `commit(...)` method, or by calling `save()` manually on the context, its parent, and all other ancestor contexts if there are any.
-     */
-    public var internalContext: NSManagedObjectContext {
-        
-        return self.context
-    }
-    
-    @available(*, deprecated=1.3.1, renamed="beginUnsafe")
-    @warn_unused_result
-    public func beginDetached() -> UnsafeDataTransaction {
-        
-        return self.beginUnsafe()
-    }
-    
-    
-    // MARK: Internal
-    
-    internal init(mainContext: NSManagedObjectContext, queue: GCDQueue, supportsUndo: Bool) {
-        
-        super.init(mainContext: mainContext, queue: queue, supportsUndo: supportsUndo, bypassesQueueing: true)
-    }
-}

CoreStore/Setting Up/CoreStore+Setup.swift

@@ -1,105 +0,0 @@
-//
-//  CoreStore+Setup.swift
-//  CoreStore
-//
-//  Copyright © 2015 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-// MARK: - CoreStore
-
-public extension CoreStore {
-    
-    /**
-     Returns the `defaultStack`'s model version. The version string is the same as the name of the version-specific .xcdatamodeld file.
-     */
-    public static var modelVersion: String {
-        
-        return self.defaultStack.modelVersion
-    }
-    
-    /**
-     Returns the entity name-to-class type mapping from the `defaultStack`'s model.
-     */
-    public static var entityTypesByName: [String: NSManagedObject.Type] {
-        
-        return self.defaultStack.entityTypesByName
-    }
-    
-    /**
-     Returns the `NSEntityDescription` for the specified `NSManagedObject` subclass from `defaultStack`'s model.
-     */
-    public static func entityDescriptionForType(type: NSManagedObject.Type) -> NSEntityDescription? {
-        
-        return self.defaultStack.entityDescriptionForType(type)
-    }
-    
-    /**
-     Adds an in-memory store to the `defaultStack`.
-     
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`.
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public static func addInMemoryStoreAndWait(configuration configuration: String? = nil) throws -> NSPersistentStore {
-        
-        return try self.defaultStack.addInMemoryStoreAndWait(configuration: configuration)
-    }
-    
-    /**
-     Adds to the `defaultStack` an SQLite store from the given SQLite file name.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS). A new SQLite file will be created if it does not exist.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to nil.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to throw exceptions on failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public static func addSQLiteStoreAndWait(fileName fileName: String, configuration: String? = nil, resetStoreOnModelMismatch: Bool = false) throws -> NSPersistentStore {
-        
-        return try self.defaultStack.addSQLiteStoreAndWait(
-            fileName: fileName,
-            configuration: configuration,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch
-        )
-    }
-    
-    /**
-     Adds to the `defaultStack` an SQLite store from the given SQLite file URL.
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store. A new SQLite file will be created if it does not exist. If not specified, defaults to a file URL pointing to a "<Application name>.sqlite" file in the "Application Support" directory (or the "Caches" directory on tvOS).
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to nil.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to throw exceptions on failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public static func addSQLiteStoreAndWait(fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, resetStoreOnModelMismatch: Bool = false) throws -> NSPersistentStore {
-        
-        return try self.defaultStack.addSQLiteStoreAndWait(
-            fileURL: fileURL,
-            configuration: configuration,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch
-        )
-    }
-}

CoreStore/Setting Up/DataStack.swift

@@ -1,397 +0,0 @@
-//
-//  DataStack.swift
-//  CoreStore
-//
-//  Copyright © 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
-#if USE_FRAMEWORKS
-    import GCDKit
-#endif
-
-
-#if os(tvOS)
-    internal let deviceDirectorySearchPath = NSSearchPathDirectory.CachesDirectory
-#else
-    internal let deviceDirectorySearchPath = NSSearchPathDirectory.ApplicationSupportDirectory
-#endif
-
-internal let defaultDirectory = NSFileManager.defaultManager().URLsForDirectory(deviceDirectorySearchPath, inDomains: .UserDomainMask).first!
-
-internal let applicationName = (NSBundle.mainBundle().objectForInfoDictionaryKey("CFBundleName") as? String) ?? "CoreData"
-
-internal let defaultSQLiteStoreURL = defaultDirectory.URLByAppendingPathComponent(applicationName, isDirectory: false).URLByAppendingPathExtension("sqlite")
-
-
-// MARK: - DataStack
-
-/**
- The `DataStack` encapsulates the data model for the Core Data stack. Each `DataStack` can have multiple data stores, usually specified as a "Configuration" in the model editor. Behind the scenes, the DataStack manages its own `NSPersistentStoreCoordinator`, a root `NSManagedObjectContext` for disk saves, and a shared `NSManagedObjectContext` designed as a read-only model interface for `NSManagedObjects`.
- */
-public final class DataStack {
-    
-    /**
-     Initializes a `DataStack` from an `NSManagedObjectModel`.
-     
-     - parameter modelName: the name of the (.xcdatamodeld) model file. If not specified, the application name will be used.
-     - parameter bundle: an optional bundle to load models from. If not specified, the main bundle will be used.
-     - parameter migrationChain: the `MigrationChain` that indicates the sequence of model versions to be used as the order for progressive migrations. If not specified, will default to a non-migrating data stack.
-     */
-    public required init(modelName: String = applicationName, bundle: NSBundle = NSBundle.mainBundle(), migrationChain: MigrationChain = nil) {
-        
-        CoreStore.assert(
-            migrationChain.valid,
-            "Invalid migration chain passed to the \(typeName(DataStack)). Check that the model versions' order is correct and that no repetitions or ambiguities exist."
-        )
-        
-        let model = NSManagedObjectModel.fromBundle(
-            bundle,
-            modelName: modelName,
-            modelVersionHints: migrationChain.leafVersions
-        )
-        
-        self.coordinator = NSPersistentStoreCoordinator(managedObjectModel: model)
-        self.rootSavingContext = NSManagedObjectContext.rootSavingContextForCoordinator(self.coordinator)
-        self.mainContext = NSManagedObjectContext.mainContextForRootContext(self.rootSavingContext)
-        self.model = model
-        self.migrationChain = migrationChain
-        
-        self.rootSavingContext.parentStack = self
-    }
-    
-    /**
-     Returns the `DataStack`'s model version. The version string is the same as the name of the version-specific .xcdatamodeld file.
-     */
-    public var modelVersion: String {
-        
-        return self.model.currentModelVersion!
-    }
-    
-    /**
-     Returns the entity name-to-class type mapping from the `DataStack`'s model.
-     */
-    public var entityTypesByName: [String: NSManagedObject.Type] {
-        
-        return self.model.entityTypesMapping()
-    }
-    
-    /**
-     Returns the `NSEntityDescription` for the specified `NSManagedObject` subclass.
-     */
-    public func entityDescriptionForType(type: NSManagedObject.Type) -> NSEntityDescription? {
-        
-        return NSEntityDescription.entityForName(
-            self.model.entityNameForClass(type),
-            inManagedObjectContext: self.mainContext
-        )
-    }
-    
-    /**
-     Returns the `NSManagedObjectID` for the specified object URI if it exists in the persistent store.
-     */
-    public func objectIDForURIRepresentation(url: NSURL) -> NSManagedObjectID? {
-        
-        return self.coordinator.managedObjectIDForURIRepresentation(url)
-    }
-    
-    /**
-     Adds an in-memory store to the stack.
-     
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`.
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public func addInMemoryStoreAndWait(configuration configuration: String? = nil) throws -> NSPersistentStore {
-        
-        let coordinator = self.coordinator;
-        
-        var store: NSPersistentStore?
-        var storeError: NSError?
-        coordinator.performBlockAndWait {
-            
-            do {
-                
-                store = try coordinator.addPersistentStoreWithType(
-                    NSInMemoryStoreType,
-                    configuration: configuration,
-                    URL: nil,
-                    options: nil
-                )
-            }
-            catch {
-                
-                storeError = error as NSError
-            }
-        }
-        
-        if let store = store {
-            
-            self.updateMetadataForPersistentStore(store)
-            return store
-        }
-        
-        let error = storeError ?? NSError(coreStoreErrorCode: .UnknownError)
-        CoreStore.handleError(
-            error,
-            "Failed to add in-memory \(typeName(NSPersistentStore)) to the stack."
-        )
-        throw error
-    }
-    
-    /**
-     Adds to the stack an SQLite store from the given SQLite file name.
-     
-     - parameter fileName: the local filename for the SQLite persistent store in the "Application Support" directory (or the "Caches" directory on tvOS). A new SQLite file will be created if it does not exist. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileName` explicitly for each of them.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to throw exceptions on failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public func addSQLiteStoreAndWait(fileName fileName: String, configuration: String? = nil, resetStoreOnModelMismatch: Bool = false) throws -> NSPersistentStore {
-        
-        return try self.addSQLiteStoreAndWait(
-            fileURL: defaultDirectory.URLByAppendingPathComponent(
-                fileName,
-                isDirectory: false
-            ),
-            configuration: configuration,
-            resetStoreOnModelMismatch: resetStoreOnModelMismatch
-        )
-    }
-    
-    /**
-     Adds to the stack an SQLite store from the given SQLite file URL.
-     
-     - parameter fileURL: the local file URL for the SQLite persistent store. A new SQLite file will be created if it does not exist. If not specified, defaults to a file URL pointing to a "<Application name>.sqlite" file in the "Application Support" directory (or the "Caches" directory on tvOS). Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter configuration: an optional configuration name from the model file. If not specified, defaults to `nil`, the "Default" configuration. Note that if you have multiple configurations, you will need to specify a different `fileURL` explicitly for each of them.
-     - parameter resetStoreOnModelMismatch: Set to true to delete the store on model mismatch; or set to false to throw exceptions on failure instead. Typically should only be set to true when debugging, or if the persistent store can be recreated easily. If not specified, defaults to false.
-     - returns: the `NSPersistentStore` added to the stack.
-     */
-    public func addSQLiteStoreAndWait(fileURL fileURL: NSURL = defaultSQLiteStoreURL, configuration: String? = nil, resetStoreOnModelMismatch: Bool = false) throws -> NSPersistentStore {
-        
-        CoreStore.assert(
-            fileURL.fileURL,
-            "The specified file URL for the SQLite store is invalid: \"\(fileURL)\""
-        )
-        
-        let coordinator = self.coordinator;
-        if let store = coordinator.persistentStoreForURL(fileURL) {
-            
-            guard store.type == NSSQLiteStoreType
-                && store.configurationName == (configuration ?? Into.defaultConfigurationName) else {
-                    
-                    let error = NSError(coreStoreErrorCode: .DifferentPersistentStoreExistsAtURL)
-                    CoreStore.handleError(
-                        error,
-                        "Failed to add SQLite \(typeName(NSPersistentStore)) at \"\(fileURL)\" because a different \(typeName(NSPersistentStore)) at that URL already exists."
-                    )
-                    
-                    throw error
-            }
-            
-            return store
-        }
-        
-        let fileManager = NSFileManager.defaultManager()
-        _ = try? fileManager.createDirectoryAtURL(
-            fileURL.URLByDeletingLastPathComponent!,
-            withIntermediateDirectories: true,
-            attributes: nil
-        )
-        
-        var store: NSPersistentStore?
-        var storeError: NSError?
-        let options = self.optionsForSQLiteStore()
-        coordinator.performBlockAndWait {
-            
-            do {
-                
-                store = try coordinator.addPersistentStoreWithType(
-                    NSSQLiteStoreType,
-                    configuration: configuration,
-                    URL: fileURL,
-                    options: options
-                )
-            }
-            catch {
-                
-                storeError = error as NSError
-            }
-        }
-        
-        if let store = store {
-            
-            self.updateMetadataForPersistentStore(store)
-            return store
-        }
-        
-        if let error = storeError
-            where (resetStoreOnModelMismatch && error.isCoreDataMigrationError) {
-                
-                fileManager.removeSQLiteStoreAtURL(fileURL)
-                
-                var store: NSPersistentStore?
-                coordinator.performBlockAndWait {
-                    
-                    do {
-                        
-                        store = try coordinator.addPersistentStoreWithType(
-                            NSSQLiteStoreType,
-                            configuration: configuration,
-                            URL: fileURL,
-                            options: [NSSQLitePragmasOption: ["journal_mode": "WAL"]]
-                        )
-                    }
-                    catch {
-                        
-                        storeError = error as NSError
-                    }
-                }
-                
-                if let store = store {
-                    
-                    self.updateMetadataForPersistentStore(store)
-                    return store
-                }
-        }
-        
-        let error = storeError ?? NSError(coreStoreErrorCode: .UnknownError)
-        CoreStore.handleError(
-            error,
-            "Failed to add SQLite \(typeName(NSPersistentStore)) at \"\(fileURL)\"."
-        )
-        throw error
-    }
-    
-    
-    // MARK: Internal
-    
-    internal let coordinator: NSPersistentStoreCoordinator
-    internal let rootSavingContext: NSManagedObjectContext
-    internal let mainContext: NSManagedObjectContext
-    internal let model: NSManagedObjectModel
-    internal let migrationChain: MigrationChain
-    internal let childTransactionQueue: GCDQueue = .createSerial("com.coreStore.dataStack.childTransactionQueue")
-    internal let migrationQueue: NSOperationQueue = {
-        
-        let migrationQueue = NSOperationQueue()
-        migrationQueue.maxConcurrentOperationCount = 1
-        migrationQueue.name = "com.coreStore.migrationOperationQueue"
-        migrationQueue.qualityOfService = .Utility
-        migrationQueue.underlyingQueue = dispatch_queue_create("com.coreStore.migrationQueue", DISPATCH_QUEUE_SERIAL)
-        return migrationQueue
-    }()
-    
-    internal func optionsForSQLiteStore() -> [String: AnyObject] {
-        
-        return [NSSQLitePragmasOption: ["journal_mode": "WAL"]]
-    }
-    
-    internal func entityNameForEntityClass(entityClass: AnyClass) -> String? {
-        
-        return self.model.entityNameForClass(entityClass)
-    }
-    
-    internal func persistentStoresForEntityClass(entityClass: AnyClass) -> [NSPersistentStore]? {
-        
-        var returnValue: [NSPersistentStore]? = nil
-        self.storeMetadataUpdateQueue.barrierSync {
-            
-            returnValue = self.entityConfigurationsMapping[NSStringFromClass(entityClass)]?.map {
-                
-                return self.configurationStoreMapping[$0]!
-            } ?? []
-        }
-        return returnValue
-    }
-    
-    internal func persistentStoreForEntityClass(entityClass: AnyClass, configuration: String?, inferStoreIfPossible: Bool) -> (store: NSPersistentStore?, isAmbiguous: Bool) {
-        
-        var returnValue: (store: NSPersistentStore?, isAmbiguous: Bool) = (store: nil, isAmbiguous: false)
-        self.storeMetadataUpdateQueue.barrierSync {
-            
-            let configurationsForEntity = self.entityConfigurationsMapping[NSStringFromClass(entityClass)] ?? []
-            if let configuration = configuration {
-                
-                if configurationsForEntity.contains(configuration) {
-                    
-                    returnValue = (store: self.configurationStoreMapping[configuration], isAmbiguous: false)
-                    return
-                }
-                else if !inferStoreIfPossible {
-                    
-                    return
-                }
-            }
-            
-            switch configurationsForEntity.count {
-                
-            case 0:
-                return
-                
-            case 1 where inferStoreIfPossible:
-                returnValue = (store: self.configurationStoreMapping[configurationsForEntity.first!], isAmbiguous: false)
-                
-            default:
-                returnValue = (store: nil, isAmbiguous: true)
-            }
-        }
-        return returnValue
-    }
-    
-    internal func updateMetadataForPersistentStore(persistentStore: NSPersistentStore) {
-        
-        self.storeMetadataUpdateQueue.barrierAsync {
-            
-            let configurationName = persistentStore.configurationName
-            self.configurationStoreMapping[configurationName] = persistentStore
-            for entityDescription in (self.coordinator.managedObjectModel.entitiesForConfiguration(configurationName) ?? []) {
-                
-                let managedObjectClassName = entityDescription.managedObjectClassName
-                CoreStore.assert(
-                    NSClassFromString(managedObjectClassName) != nil,
-                    "The class \(typeName(managedObjectClassName)) for the entity \(typeName(entityDescription.name)) does not exist. Check if the subclass type and module name are properly configured."
-                )
-                
-                if self.entityConfigurationsMapping[managedObjectClassName] == nil {
-                    
-                    self.entityConfigurationsMapping[managedObjectClassName] = []
-                }
-                self.entityConfigurationsMapping[managedObjectClassName]?.insert(configurationName)
-            }
-        }
-    }
-    
-    
-    // MARK: Private
-    
-    private let storeMetadataUpdateQueue = GCDQueue.createConcurrent("com.coreStore.persistentStoreBarrierQueue")
-    private var configurationStoreMapping = [String: NSPersistentStore]()
-    private var entityConfigurationsMapping = [String: Set<String>]()
-    
-    deinit {
-        
-        for store in self.coordinator.persistentStores {
-            
-            _ = try? self.coordinator.removePersistentStore(store)
-        }
-    }
-}

CoreStore/Setting Up/PersistentStoreResult.swift

@@ -1,106 +0,0 @@
-//
-//  PersistentStoreResult.swift
-//  CoreStore
-//
-//  Copyright © 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: - PersistentStoreResult
-
-/**
- The `PersistentStoreResult` indicates the result of an asynchronous initialization of a persistent store.
- The `PersistentStoreResult` can be treated as a boolean:
- ```
- try! CoreStore.addSQLiteStore(completion: { (result: PersistentStoreResult) -> Void in
-     if result {
-        // succeeded
-     }
-     else {
-        // failed
-     }
- })
- ```
- or as an `enum`, where the resulting associated object can also be inspected:
- ```
- try! CoreStore.addSQLiteStore(completion: { (result: PersistentStoreResult) -> Void in
-     switch result {
-     case .Success(let persistentStore):
-        // persistentStore is the related NSPersistentStore instance
-     case .Failure(let error):
-        // error is the NSError instance for the failure
-     }
- })
- ```
- */
-public enum PersistentStoreResult {
-    
-    /**
-     `PersistentStoreResult.Success` indicates that the persistent store process succeeded. The associated object for this `enum` value is the related `NSPersistentStore` instance.
-     */
-    case Success(NSPersistentStore)
-    
-    /**
-     `PersistentStoreResult.Failure` indicates that the persistent store process failed. The associated object for this value is the related `NSError` instance.
-     */
-    case Failure(NSError)
-    
-    
-    // MARK: Internal
-    
-    internal init(_ store: NSPersistentStore) {
-        
-        self = .Success(store)
-    }
-    
-    internal init(_ error: NSError) {
-        
-        self = .Failure(error)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode) {
-        
-        self.init(errorCode, userInfo: nil)
-    }
-    
-    internal init(_ errorCode: CoreStoreErrorCode, userInfo: [NSObject: AnyObject]?) {
-        
-        self.init(NSError(coreStoreErrorCode: errorCode, userInfo: userInfo))
-    }
-}
-
-
-// MARK: - PersistentStoreResult: BooleanType
-
-extension PersistentStoreResult: BooleanType {
-    
-    public var boolValue: Bool {
-        
-        switch self {
-            
-        case .Success: return true
-        case .Failure: return false
-        }
-    }
-}

CoreStoreDemo/CoreStoreDemo.xcodeproj/project.xcworkspace/xcshareddata/CoreStoreDemo.xccheckout

@@ -1,53 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>IDESourceControlProjectFavoriteDictionaryKey</key>
-	<false/>
-	<key>IDESourceControlProjectIdentifier</key>
-	<string>B6855E48-4B19-4321-B1C7-CB2706E12777</string>
-	<key>IDESourceControlProjectName</key>
-	<string>CoreStoreDemo</string>
-	<key>IDESourceControlProjectOriginsDictionary</key>
-	<dict>
-		<key>4B60F1BCB491FF717C56441AE7783C74F417BE48</key>
-		<string>github.com:JohnEstropia/CoreStore.git</string>
-		<key>8B2E522D57154DFA93A06982C36315ECBEA4FA97</key>
-		<string>github.com:JohnEstropia/GCDKit.git</string>
-	</dict>
-	<key>IDESourceControlProjectPath</key>
-	<string>CoreStoreDemo/CoreStoreDemo.xcodeproj</string>
-	<key>IDESourceControlProjectRelativeInstallPathDictionary</key>
-	<dict>
-		<key>4B60F1BCB491FF717C56441AE7783C74F417BE48</key>
-		<string>../../..</string>
-		<key>8B2E522D57154DFA93A06982C36315ECBEA4FA97</key>
-		<string>../../..Libraries/GCDKit</string>
-	</dict>
-	<key>IDESourceControlProjectURL</key>
-	<string>github.com:JohnEstropia/CoreStore.git</string>
-	<key>IDESourceControlProjectVersion</key>
-	<integer>111</integer>
-	<key>IDESourceControlProjectWCCIdentifier</key>
-	<string>4B60F1BCB491FF717C56441AE7783C74F417BE48</string>
-	<key>IDESourceControlProjectWCConfigurations</key>
-	<array>
-		<dict>
-			<key>IDESourceControlRepositoryExtensionIdentifierKey</key>
-			<string>public.vcs.git</string>
-			<key>IDESourceControlWCCIdentifierKey</key>
-			<string>4B60F1BCB491FF717C56441AE7783C74F417BE48</string>
-			<key>IDESourceControlWCCName</key>
-			<string>CoreStore</string>
-		</dict>
-		<dict>
-			<key>IDESourceControlRepositoryExtensionIdentifierKey</key>
-			<string>public.vcs.git</string>
-			<key>IDESourceControlWCCIdentifierKey</key>
-			<string>8B2E522D57154DFA93A06982C36315ECBEA4FA97</string>
-			<key>IDESourceControlWCCName</key>
-			<string>GCDKit</string>
-		</dict>
-	</array>
-</dict>
-</plist>

CoreStoreDemo/CoreStoreDemo.xcodeproj/project.xcworkspace/xcshareddata/CoreStoreDemo.xcscmblueprint

@@ -1,30 +0,0 @@
-{
-  "DVTSourceControlWorkspaceBlueprintPrimaryRemoteRepositoryKey" : "4B60F1BCB491FF717C56441AE7783C74F417BE48",
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyRepositoryLocationsKey" : {
-
-  },
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyStatesKey" : {
-    "8B2E522D57154DFA93A06982C36315ECBEA4FA97" : 0,
-    "4B60F1BCB491FF717C56441AE7783C74F417BE48" : 0
-  },
-  "DVTSourceControlWorkspaceBlueprintIdentifierKey" : "B6855E48-4B19-4321-B1C7-CB2706E12777",
-  "DVTSourceControlWorkspaceBlueprintWorkingCopyPathsKey" : {
-    "8B2E522D57154DFA93A06982C36315ECBEA4FA97" : "CoreStoreLibraries\/GCDKit",
-    "4B60F1BCB491FF717C56441AE7783C74F417BE48" : "CoreStore"
-  },
-  "DVTSourceControlWorkspaceBlueprintNameKey" : "CoreStoreDemo",
-  "DVTSourceControlWorkspaceBlueprintVersion" : 203,
-  "DVTSourceControlWorkspaceBlueprintRelativePathToProjectKey" : "CoreStoreDemo\/CoreStoreDemo.xcodeproj",
-  "DVTSourceControlWorkspaceBlueprintRemoteRepositoriesKey" : [
-    {
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "github.com:JohnEstropia\/CoreStore.git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "4B60F1BCB491FF717C56441AE7783C74F417BE48"
-    },
-    {
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryURLKey" : "github.com:JohnEstropia\/GCDKit.git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositorySystemKey" : "com.apple.dt.Xcode.sourcecontrol.Git",
-      "DVTSourceControlWorkspaceBlueprintRemoteRepositoryIdentifierKey" : "8B2E522D57154DFA93A06982C36315ECBEA4FA97"
-    }
-  ]
-}

CoreStoreDemo/CoreStoreDemo.xcodeproj/project.xcworkspace/xcshareddata/HardcoreDataDemo.xccheckout

@@ -1,53 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-	<key>IDESourceControlProjectFavoriteDictionaryKey</key>
-	<false/>
-	<key>IDESourceControlProjectIdentifier</key>
-	<string>7C5E31AC-5DD0-43DA-A5C6-AF73B4532D86</string>
-	<key>IDESourceControlProjectName</key>
-	<string>project</string>
-	<key>IDESourceControlProjectOriginsDictionary</key>
-	<dict>
-		<key>4B60F1BCB491FF717C56441AE7783C74F417BE48</key>
-		<string>github.com:JohnEstropia/HardcoreData.git</string>
-		<key>8B2E522D57154DFA93A06982C36315ECBEA4FA97</key>
-		<string>github.com:JohnEstropia/GCDKit.git</string>
-	</dict>
-	<key>IDESourceControlProjectPath</key>
-	<string>HardcoreDataDemo/HardcoreDataDemo.xcodeproj/project.xcworkspace</string>
-	<key>IDESourceControlProjectRelativeInstallPathDictionary</key>
-	<dict>
-		<key>4B60F1BCB491FF717C56441AE7783C74F417BE48</key>
-		<string>../../..</string>
-		<key>8B2E522D57154DFA93A06982C36315ECBEA4FA97</key>
-		<string>../../..Libraries/GCDKit</string>
-	</dict>
-	<key>IDESourceControlProjectURL</key>
-	<string>github.com:JohnEstropia/HardcoreData.git</string>
-	<key>IDESourceControlProjectVersion</key>
-	<integer>111</integer>
-	<key>IDESourceControlProjectWCCIdentifier</key>
-	<string>4B60F1BCB491FF717C56441AE7783C74F417BE48</string>
-	<key>IDESourceControlProjectWCConfigurations</key>
-	<array>
-		<dict>
-			<key>IDESourceControlRepositoryExtensionIdentifierKey</key>
-			<string>public.vcs.git</string>
-			<key>IDESourceControlWCCIdentifierKey</key>
-			<string>8B2E522D57154DFA93A06982C36315ECBEA4FA97</string>
-			<key>IDESourceControlWCCName</key>
-			<string>GCDKit</string>
-		</dict>
-		<dict>
-			<key>IDESourceControlRepositoryExtensionIdentifierKey</key>
-			<string>public.vcs.git</string>
-			<key>IDESourceControlWCCIdentifierKey</key>
-			<string>4B60F1BCB491FF717C56441AE7783C74F417BE48</string>
-			<key>IDESourceControlWCCName</key>
-			<string>HardcoreData</string>
-		</dict>
-	</array>
-</dict>
-</plist>

CoreStoreDemo/CoreStoreDemo/Base.lproj/LaunchScreen.xib

@@ -1,41 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="no"?>
-<document type="com.apple.InterfaceBuilder3.CocoaTouch.XIB" version="3.0" toolsVersion="7706" systemVersion="14D136" targetRuntime="iOS.CocoaTouch" propertyAccessControl="none" useAutolayout="YES" launchScreen="YES" useTraitCollections="YES">
-    <dependencies>
-        <plugIn identifier="com.apple.InterfaceBuilder.IBCocoaTouchPlugin" version="7703"/>
-        <capability name="Constraints with non-1.0 multipliers" minToolsVersion="5.1"/>
-    </dependencies>
-    <objects>
-        <placeholder placeholderIdentifier="IBFilesOwner" id="-1" userLabel="File's Owner"/>
-        <placeholder placeholderIdentifier="IBFirstResponder" id="-2" customClass="UIResponder"/>
-        <view contentMode="scaleToFill" id="iN0-l3-epB">
-            <rect key="frame" x="0.0" y="0.0" width="480" height="480"/>
-            <autoresizingMask key="autoresizingMask" widthSizable="YES" heightSizable="YES"/>
-            <subviews>
-                <label opaque="NO" clipsSubviews="YES" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" text="  Copyright (c) 2015 John Rommel Estropia. All rights reserved." textAlignment="center" lineBreakMode="tailTruncation" baselineAdjustment="alignBaselines" minimumFontSize="9" translatesAutoresizingMaskIntoConstraints="NO" id="8ie-xW-0ye">
-                    <rect key="frame" x="20" y="439" width="441" height="21"/>
-                    <fontDescription key="fontDescription" type="system" pointSize="17"/>
-                    <color key="textColor" red="0.92549019607843142" green="0.94117647058823528" blue="0.94509803921568625" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
-                    <nil key="highlightedColor"/>
-                </label>
-                <label opaque="NO" clipsSubviews="YES" userInteractionEnabled="NO" contentMode="left" horizontalHuggingPriority="251" verticalHuggingPriority="251" misplaced="YES" text="CoreStore" textAlignment="center" lineBreakMode="middleTruncation" baselineAdjustment="alignBaselines" minimumFontSize="18" translatesAutoresizingMaskIntoConstraints="NO" id="kId-c2-rCX">
-                    <rect key="frame" x="20" y="140" width="441" height="43"/>
-                    <fontDescription key="fontDescription" name="HelveticaNeue-UltraLight" family="Helvetica Neue" pointSize="50"/>
-                    <color key="textColor" red="0.92549019607843142" green="0.94117647058823528" blue="0.94509803921568625" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
-                    <nil key="highlightedColor"/>
-                </label>
-            </subviews>
-            <color key="backgroundColor" red="0.20392156862745098" green="0.28627450980392155" blue="0.36862745098039218" alpha="1" colorSpace="custom" customColorSpace="sRGB"/>
-            <constraints>
-                <constraint firstItem="kId-c2-rCX" firstAttribute="centerY" secondItem="iN0-l3-epB" secondAttribute="bottom" multiplier="1/3" constant="1" id="5cJ-9S-tgC"/>
-                <constraint firstAttribute="centerX" secondItem="kId-c2-rCX" secondAttribute="centerX" id="Koa-jz-hwk"/>
-                <constraint firstAttribute="bottom" secondItem="8ie-xW-0ye" secondAttribute="bottom" constant="20" id="Kzo-t9-V3l"/>
-                <constraint firstItem="8ie-xW-0ye" firstAttribute="leading" secondItem="iN0-l3-epB" secondAttribute="leading" constant="20" symbolic="YES" id="MfP-vx-nX0"/>
-                <constraint firstAttribute="centerX" secondItem="8ie-xW-0ye" secondAttribute="centerX" id="ZEH-qu-HZ9"/>
-                <constraint firstItem="kId-c2-rCX" firstAttribute="leading" secondItem="iN0-l3-epB" secondAttribute="leading" constant="20" symbolic="YES" id="fvb-Df-36g"/>
-            </constraints>
-            <nil key="simulatedStatusBarMetrics"/>
-            <freeformSimulatedSizeMetrics key="simulatedDestinationMetrics"/>
-            <point key="canvasLocation" x="548" y="455"/>
-        </view>
-    </objects>
-</document>

CoreStoreDemo/CoreStoreDemo/CoreStoreDemo.xcdatamodeld/CoreStoreDemo.xcdatamodel/contents

@@ -1,37 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<model userDefinedModelVersionIdentifier="" type="com.apple.IDECoreDataModeler.DataModel" documentVersion="1.0" lastSavedToolsVersion="7701" systemVersion="14D136" minimumToolsVersion="Automatic" macOSVersion="Automatic" iOSVersion="Automatic">
-    <entity name="Palette" representedClassName="CoreStoreDemo.Palette">
-        <attribute name="brightness" optional="YES" attributeType="Float" defaultValueString="0.0" syncable="YES"/>
-        <attribute name="colorName" optional="YES" transient="YES" attributeType="String" syncable="YES"/>
-        <attribute name="hue" optional="YES" attributeType="Integer 32" defaultValueString="0.0" syncable="YES"/>
-        <attribute name="saturation" optional="YES" attributeType="Float" defaultValueString="0.0" syncable="YES"/>
-        <userInfo/>
-    </entity>
-    <entity name="Place" representedClassName="CoreStoreDemo.Place" syncable="YES">
-        <attribute name="latitude" optional="YES" attributeType="Double" defaultValueString="0.0" syncable="YES"/>
-        <attribute name="longitude" optional="YES" attributeType="Double" defaultValueString="0.0" syncable="YES"/>
-        <attribute name="subtitle" optional="YES" attributeType="String" syncable="YES"/>
-        <attribute name="title" optional="YES" attributeType="String" syncable="YES"/>
-    </entity>
-    <entity name="TimeZone" representedClassName="CoreStoreDemo.TimeZone" syncable="YES">
-        <attribute name="abbreviation" optional="YES" attributeType="String" syncable="YES"/>
-        <attribute name="daylightSavingTimeOffset" optional="YES" attributeType="Double" defaultValueString="0.0" syncable="YES"/>
-        <attribute name="hasDaylightSavingTime" optional="YES" attributeType="Boolean" syncable="YES"/>
-        <attribute name="name" optional="YES" attributeType="String" syncable="YES"/>
-        <attribute name="secondsFromGMT" optional="YES" attributeType="Integer 32" defaultValueString="0.0" syncable="YES"/>
-    </entity>
-    <configuration name="FetchingAndQueryingDemo">
-        <memberEntity name="TimeZone"/>
-    </configuration>
-    <configuration name="ObservingDemo">
-        <memberEntity name="Palette"/>
-    </configuration>
-    <configuration name="TransactionsDemo">
-        <memberEntity name="Place"/>
-    </configuration>
-    <elements>
-        <element name="Palette" positionX="261" positionY="189" width="128" height="105"/>
-        <element name="Place" positionX="261" positionY="225" width="128" height="105"/>
-        <element name="TimeZone" positionX="297" positionY="270" width="128" height="120"/>
-    </elements>
-</model>

CoreStoreDemo/CoreStoreDemo/Fetching and Querying Demo/FetchingAndQueryingDemoViewController.swift

@@ -1,290 +0,0 @@
-//
-//  FetchingAndQueryingDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/06/12.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-
-
-private struct Static {
-    
-    static let timeZonesStack: DataStack = {
-        
-        let dataStack = DataStack()
-        try! dataStack.addSQLiteStoreAndWait(
-            fileName: "TimeZoneDemo.sqlite",
-            configuration: "FetchingAndQueryingDemo",
-            resetStoreOnModelMismatch: true
-        )
-    
-        dataStack.beginSynchronous { (transaction) -> Void in
-            
-            transaction.deleteAll(From(TimeZone))
-            
-            for name in NSTimeZone.knownTimeZoneNames() {
-                
-                let rawTimeZone = NSTimeZone(name: name)!
-                let cachedTimeZone = transaction.create(Into(TimeZone))
-                
-                cachedTimeZone.name = rawTimeZone.name
-                cachedTimeZone.abbreviation = rawTimeZone.abbreviation ?? ""
-                cachedTimeZone.secondsFromGMT = Int32(rawTimeZone.secondsFromGMT)
-                cachedTimeZone.hasDaylightSavingTime = rawTimeZone.daylightSavingTime
-                cachedTimeZone.daylightSavingTimeOffset = rawTimeZone.daylightSavingTimeOffset
-            }
-            
-            transaction.commitAndWait()
-        }
-        
-        return dataStack
-    }()
-}
-
-
-// MARK: - FetchingAndQueryingDemoViewController
-
-class FetchingAndQueryingDemoViewController: UIViewController, UITableViewDataSource, UITableViewDelegate {
-    
-    // MARK: UIViewController
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        if self.didAppearOnce {
-            
-            return
-        }
-        
-        self.didAppearOnce = true
-        
-        let alert = UIAlertController(
-            title: "Fetch and Query Demo",
-            message: "This demo shows how to execute fetches and queries.\n\nEach menu item executes and displays a preconfigured fetch/query.",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-    }
-    
-    override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) {
-        
-        super.prepareForSegue(segue, sender: sender)
-        
-        if let indexPath = sender as? NSIndexPath {
-            
-            switch segue.destinationViewController {
-                
-            case let controller as FetchingResultsViewController:
-                let item = self.fetchingItems[indexPath.row]
-                controller.setTimeZones(item.fetch(), title: item.title)
-                
-            case let controller as QueryingResultsViewController:
-                let item = self.queryingItems[indexPath.row]
-                controller.setValue(item.query(), title: item.title)
-                
-            default:
-                break
-            }
-        }
-    }
-    
-    
-    // MARK: UITableViewDataSource
-    
-    func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
-        switch self.segmentedControl?.selectedSegmentIndex {
-            
-        case .Some(Section.Fetching.rawValue):
-            return self.fetchingItems.count
-            
-        case .Some(Section.Querying.rawValue):
-            return self.queryingItems.count
-            
-        default:
-            return 0
-        }
-    }
-    
-    func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
-        
-        let cell = tableView.dequeueReusableCellWithIdentifier("UITableViewCell")!
-        
-        switch self.segmentedControl?.selectedSegmentIndex {
-            
-        case .Some(Section.Fetching.rawValue):
-            cell.textLabel?.text = self.fetchingItems[indexPath.row].title
-            
-        case .Some(Section.Querying.rawValue):
-            cell.textLabel?.text = self.queryingItems[indexPath.row].title
-            
-        default:
-            cell.textLabel?.text = nil
-        }
-        
-        return cell
-    }
-    
-    
-    // MARK: UITableViewDelegate
-    
-    func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
-        
-        tableView.deselectRowAtIndexPath(indexPath, animated: true)
-        
-        switch self.segmentedControl?.selectedSegmentIndex {
-            
-        case .Some(Section.Fetching.rawValue):
-            self.performSegueWithIdentifier("FetchingResultsViewController", sender: indexPath)
-            
-        case .Some(Section.Querying.rawValue):
-            self.performSegueWithIdentifier("QueryingResultsViewController", sender: indexPath)
-            
-        default:
-            break
-        }
-    }
-    
-    
-    // MARK: Private
-    
-    private enum Section: Int {
-        
-        case Fetching
-        case Querying
-    }
-    
-    private let fetchingItems = [
-        (
-            title: "All Time Zones",
-            fetch: { () -> [TimeZone] in
-                
-                return Static.timeZonesStack.fetchAll(
-                    From(TimeZone),
-                    OrderBy(.Ascending("name"))
-                )!
-            }
-        ),
-        (
-            title: "Time Zones in Asia",
-            fetch: { () -> [TimeZone] in
-                
-                return Static.timeZonesStack.fetchAll(
-                    From(TimeZone),
-                    Where("%K BEGINSWITH[c] %@", "name", "Asia"),
-                    OrderBy(.Ascending("secondsFromGMT"))
-                )!
-            }
-        ),
-        (
-            title: "Time Zones in America and Europe",
-            fetch: { () -> [TimeZone] in
-                
-                return Static.timeZonesStack.fetchAll(
-                    From(TimeZone),
-                    Where("%K BEGINSWITH[c] %@", "name", "America")
-                        || Where("%K BEGINSWITH[c] %@", "name", "Europe"),
-                    OrderBy(.Ascending("secondsFromGMT"))
-                )!
-            }
-        ),
-        (
-            title: "All Time Zones Except America",
-            fetch: { () -> [TimeZone] in
-                
-                return Static.timeZonesStack.fetchAll(
-                    From(TimeZone),
-                    !Where("%K BEGINSWITH[c] %@", "name", "America"),
-                    OrderBy(.Ascending("secondsFromGMT"))
-                    )!
-            }
-        ),
-        (
-            title: "Time Zones with Summer Time",
-            fetch: { () -> [TimeZone] in
-                
-                return Static.timeZonesStack.fetchAll(
-                    From(TimeZone),
-                    Where("hasDaylightSavingTime", isEqualTo: true),
-                    OrderBy(.Ascending("name"))
-                )!
-            }
-        )
-    ]
-    
-    private let queryingItems = [
-        (
-            title: "Number of Time Zones",
-            query: { () -> AnyObject in
-                
-                return Static.timeZonesStack.queryValue(
-                    From(TimeZone),
-                    Select<NSNumber>(.Count("name"))
-                )!
-            }
-        ),
-        (
-            title: "Abbreviation For Tokyo's Time Zone",
-            query: { () -> AnyObject in
-                
-                return Static.timeZonesStack.queryValue(
-                    From(TimeZone),
-                    Select<String>("abbreviation"),
-                    Where("%K ENDSWITH[c] %@", "name", "Tokyo")
-                )!
-            }
-        ),
-        (
-            title: "All Abbreviations",
-            query: { () -> AnyObject in
-                
-                return Static.timeZonesStack.queryAttributes(
-                    From(TimeZone),
-                    Select<NSDictionary>("name", "abbreviation"),
-                    OrderBy(.Ascending("name"))
-                )!
-            }
-        ),
-        (
-            title: "Number of Countries per Time Zone",
-            query: { () -> AnyObject in
-                
-                return Static.timeZonesStack.queryAttributes(
-                    From(TimeZone),
-                    Select<NSDictionary>(.Count("abbreviation"), "abbreviation"),
-                    GroupBy("abbreviation"),
-                    OrderBy(.Ascending("secondsFromGMT"), .Ascending("name"))
-                )!
-            }
-        ),
-        (
-            title: "Number of Countries with Summer Time",
-            query: { () -> AnyObject in
-                
-                return Static.timeZonesStack.queryAttributes(
-                    From(TimeZone),
-                    Select<NSDictionary>(
-                        .Count("hasDaylightSavingTime", As: "numberOfCountries"),
-                        "hasDaylightSavingTime"
-                    ),
-                    GroupBy("hasDaylightSavingTime"),
-                    OrderBy(.Descending("hasDaylightSavingTime"))
-                )!
-            }
-        )
-    ]
-    
-    var didAppearOnce = false
-    
-    @IBOutlet dynamic weak var segmentedControl: UISegmentedControl?
-    @IBOutlet dynamic weak var tableView: UITableView?
-    
-    @IBAction dynamic func segmentedControlValueChanged(sender: AnyObject?) {
-        
-        self.tableView?.reloadData()
-    }
-}

CoreStoreDemo/CoreStoreDemo/Images.xcassets/AppIcon.appiconset/Contents.json

@@ -1,38 +0,0 @@
-{
-  "images" : [
-    {
-      "idiom" : "iphone",
-      "size" : "29x29",
-      "scale" : "2x"
-    },
-    {
-      "idiom" : "iphone",
-      "size" : "29x29",
-      "scale" : "3x"
-    },
-    {
-      "idiom" : "iphone",
-      "size" : "40x40",
-      "scale" : "2x"
-    },
-    {
-      "idiom" : "iphone",
-      "size" : "40x40",
-      "scale" : "3x"
-    },
-    {
-      "idiom" : "iphone",
-      "size" : "60x60",
-      "scale" : "2x"
-    },
-    {
-      "idiom" : "iphone",
-      "size" : "60x60",
-      "scale" : "3x"
-    }
-  ],
-  "info" : {
-    "version" : 1,
-    "author" : "xcode"
-  }
-}

CoreStoreDemo/CoreStoreDemo/List and Object Observers Demo/ListObserverDemoViewController.swift

@@ -1,304 +0,0 @@
-//
-//  ListObserverDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/05/02.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-
-
-private struct Static {
-    
-    enum Filter: String {
-        
-        case All = "All Colors"
-        case Light = "Light Colors"
-        case Dark = "Dark Colors"
-        
-        func next() -> Filter {
-            
-            switch self {
-                
-            case All: return .Light
-            case Light: return .Dark
-            case Dark: return .All
-            }
-        }
-        
-        func whereClause() -> Where {
-            
-            switch self {
-                
-            case .All: return Where(true)
-            case .Light: return Where("brightness >= 0.9")
-            case .Dark: return Where("brightness <= 0.4")
-            }
-        }
-    }
-    
-    static var filter = Filter.All {
-        
-        didSet {
-            
-            self.palettes.refetch(self.filter.whereClause())
-        }
-    }
-    
-    static let palettes: ListMonitor<Palette> = {
-        
-        try! CoreStore.addSQLiteStoreAndWait(
-            fileName: "ColorsDemo.sqlite",
-            configuration: "ObservingDemo",
-            resetStoreOnModelMismatch: true
-        )
-        
-        return CoreStore.monitorSectionedList(
-            From(Palette),
-            SectionBy("colorName"),
-            OrderBy(.Ascending("hue"))
-        )
-    }()
-}
-
-
-// MARK: - ListObserverDemoViewController
-
-class ListObserverDemoViewController: UITableViewController, ListSectionObserver {
-    
-    // MARK: NSObject
-    
-    deinit {
-        
-        Static.palettes.removeObserver(self)
-    }
-    
-    
-    // MARK: UIViewController
-
-    override func viewDidLoad() {
-        
-        super.viewDidLoad()
-        
-        let navigationItem = self.navigationItem
-        navigationItem.leftBarButtonItems = [
-            self.editButtonItem(),
-            UIBarButtonItem(
-                barButtonSystemItem: .Trash,
-                target: self,
-                action: "resetBarButtonItemTouched:"
-            )
-        ]
-        
-        let filterBarButton = UIBarButtonItem(
-            title: Static.filter.rawValue,
-            style: .Plain,
-            target: self,
-            action: "filterBarButtonItemTouched:"
-        )
-        navigationItem.rightBarButtonItems = [
-            UIBarButtonItem(
-                barButtonSystemItem: .Add,
-                target: self,
-                action: "addBarButtonItemTouched:"
-            ),
-            filterBarButton
-        ]
-        self.filterBarButton = filterBarButton
-        
-        Static.palettes.addObserver(self)
-        
-        self.setTableEnabled(!Static.palettes.isPendingRefetch)
-    }
-    
-    override func prepareForSegue(segue: UIStoryboardSegue, sender: AnyObject?) {
-        
-        super.prepareForSegue(segue, sender: sender)
-        
-        switch (segue.identifier, segue.destinationViewController, sender) {
-            
-        case (.Some("ObjectObserverDemoViewController"), let destinationViewController as ObjectObserverDemoViewController, let palette as Palette):
-            destinationViewController.palette = palette
-            
-        default:
-            break
-        }
-    }
-    
-    
-    // MARK: UITableViewDataSource
-    
-    override func numberOfSectionsInTableView(tableView: UITableView) -> Int {
-        
-        return Static.palettes.numberOfSections()
-    }
-
-    override func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
-        
-        return Static.palettes.numberOfObjectsInSection(section)
-    }
-    
-    override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
-        
-        let cell = tableView.dequeueReusableCellWithIdentifier("PaletteTableViewCell") as! PaletteTableViewCell
-        
-        let palette = Static.palettes[indexPath]
-        cell.colorView?.backgroundColor = palette.color
-        cell.label?.text = palette.colorText
-        
-        return cell
-    }
-    
-    
-    // MARK: UITableViewDelegate
-    
-    override func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
-        
-        tableView.deselectRowAtIndexPath(indexPath, animated: true)
-        
-        self.performSegueWithIdentifier(
-            "ObjectObserverDemoViewController",
-            sender: Static.palettes[indexPath]
-        )
-    }
-    
-    override func tableView(tableView: UITableView, commitEditingStyle editingStyle: UITableViewCellEditingStyle, forRowAtIndexPath indexPath: NSIndexPath) {
-        
-        switch editingStyle {
-            
-        case .Delete:
-            let palette = Static.palettes[indexPath]
-            CoreStore.beginAsynchronous{ (transaction) -> Void in
-                
-                transaction.delete(palette)
-                transaction.commit { (result) -> Void in }
-            }
-            
-        default:
-            break
-        }
-    }
-    
-    override func tableView(tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
-        
-        return Static.palettes.sectionInfoAtIndex(section).name
-    }
-    
-    
-    // MARK: ListObserver
-    
-    func listMonitorWillChange(monitor: ListMonitor<Palette>) {
-        
-        self.tableView.beginUpdates()
-    }
-    
-    func listMonitorDidChange(monitor: ListMonitor<Palette>) {
-        
-        self.tableView.endUpdates()
-    }
-    
-    func listMonitorWillRefetch(monitor: ListMonitor<Palette>) {
-        
-        self.setTableEnabled(false)
-    }
-    
-    func listMonitorDidRefetch(monitor: ListMonitor<Palette>) {
-        
-        self.filterBarButton?.title = Static.filter.rawValue
-        self.tableView.reloadData()
-        self.setTableEnabled(true)
-    }
-    
-    
-    // MARK: ListObjectObserver
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didInsertObject object: Palette, toIndexPath indexPath: NSIndexPath) {
-        
-        self.tableView.insertRowsAtIndexPaths([indexPath], withRowAnimation: .Automatic)
-    }
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didDeleteObject object: Palette, fromIndexPath indexPath: NSIndexPath) {
-        
-        self.tableView.deleteRowsAtIndexPaths([indexPath], withRowAnimation: .Automatic)
-    }
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didUpdateObject object: Palette, atIndexPath indexPath: NSIndexPath) {
-        
-        if let cell = self.tableView.cellForRowAtIndexPath(indexPath) as? PaletteTableViewCell {
-            
-            let palette = Static.palettes[indexPath]
-            cell.colorView?.backgroundColor = palette.color
-            cell.label?.text = palette.colorText
-        }
-    }
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didMoveObject object: Palette, fromIndexPath: NSIndexPath, toIndexPath: NSIndexPath) {
-        
-        self.tableView.deleteRowsAtIndexPaths([fromIndexPath], withRowAnimation: .Automatic)
-        self.tableView.insertRowsAtIndexPaths([toIndexPath], withRowAnimation: .Automatic)
-    }
-    
-    
-    // MARK: ListSectionObserver
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didInsertSection sectionInfo: NSFetchedResultsSectionInfo, toSectionIndex sectionIndex: Int) {
-        
-        self.tableView.insertSections(NSIndexSet(index: sectionIndex), withRowAnimation: .Automatic)
-    }
-    
-    func listMonitor(monitor: ListMonitor<Palette>, didDeleteSection sectionInfo: NSFetchedResultsSectionInfo, fromSectionIndex sectionIndex: Int) {
-        
-        self.tableView.deleteSections(NSIndexSet(index: sectionIndex), withRowAnimation: .Automatic)
-    }
-    
-    
-    // MARK: Private
-    
-    private var filterBarButton: UIBarButtonItem?
-    
-    @IBAction private dynamic func resetBarButtonItemTouched(sender: AnyObject?) {
-        
-        CoreStore.beginAsynchronous { (transaction) -> Void in
-            
-            transaction.deleteAll(From(Palette))
-            transaction.commit()
-        }
-    }
-    
-    @IBAction private dynamic func filterBarButtonItemTouched(sender: AnyObject?) {
-        
-        Static.filter = Static.filter.next()
-    }
-    
-    @IBAction private dynamic func addBarButtonItemTouched(sender: AnyObject?) {
-        
-        CoreStore.beginAsynchronous { (transaction) -> Void in
-            
-            let palette = transaction.create(Into(Palette))
-            palette.setInitialValues()
-            
-            transaction.commit()
-        }
-    }
-    
-    private func setTableEnabled(enabled: Bool) {
-        
-        UIView.animateWithDuration(
-            0.2,
-            delay: 0,
-            options: .BeginFromCurrentState,
-            animations: { () -> Void in
-                
-                if let tableView = self.tableView {
-                    
-                    tableView.alpha = enabled ? 1.0 : 0.5
-                    tableView.userInteractionEnabled = enabled
-                }
-            },
-            completion: nil
-        )
-    }
-}
-

CoreStoreDemo/CoreStoreDemo/List and Object Observers Demo/ObjectObserverDemoViewController.swift

@@ -1,192 +0,0 @@
-//
-//  ObjectObserverDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/05/06.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-
-
-// MARK: - ObjectObserverDemoViewController
-
-class ObjectObserverDemoViewController: UIViewController, ObjectObserver {
-    
-    var palette: Palette? {
-        
-        get {
-            
-            return self.monitor?.object
-        }
-        set {
-            
-            guard self.monitor?.object != newValue else {
-                
-                return
-            }
-            
-            if let palette = newValue {
-                
-                self.monitor = CoreStore.monitorObject(palette)
-            }
-            else {
-                
-                self.monitor = nil
-            }
-        }
-    }
-    
-    // MARK: NSObject
-    
-    deinit {
-        
-        self.monitor?.removeObserver(self)
-    }
-    
-
-    // MARK: UIViewController
-    
-    required init?(coder aDecoder: NSCoder) {
-        
-        if let palette = CoreStore.fetchOne(From(Palette), OrderBy(.Ascending("hue"))) {
-            
-            self.monitor = CoreStore.monitorObject(palette)
-        }
-        else {
-            
-            CoreStore.beginSynchronous { (transaction) -> Void in
-                
-                let palette = transaction.create(Into(Palette))
-                palette.setInitialValues()
-                
-                transaction.commitAndWait()
-            }
-            
-            let palette = CoreStore.fetchOne(From(Palette), OrderBy(.Ascending("hue")))!
-            self.monitor = CoreStore.monitorObject(palette)
-        }
-        
-        super.init(coder: aDecoder)
-    }
-    
-    override func viewDidLoad() {
-        
-        super.viewDidLoad()
-        self.monitor?.addObserver(self)
-        
-        if let palette = self.monitor?.object {
-            
-            self.reloadPaletteInfo(palette, changedKeys: nil)
-        }
-    }
-    
-    
-    // MARK: ObjectObserver
-    
-    func objectMonitor(monitor: ObjectMonitor<Palette>, didUpdateObject object: Palette, changedPersistentKeys: Set<KeyPath>) {
-        
-        self.reloadPaletteInfo(object, changedKeys: changedPersistentKeys)
-    }
-    
-    func objectMonitor(monitor: ObjectMonitor<Palette>, didDeleteObject object: Palette) {
-        
-        self.navigationItem.rightBarButtonItem?.enabled = false
-        
-        self.colorNameLabel?.alpha = 0.3
-        self.colorView?.alpha = 0.3
-        
-        self.hsbLabel?.text = "Deleted"
-        self.hsbLabel?.textColor = UIColor.redColor()
-        
-        self.hueSlider?.enabled = false
-        self.saturationSlider?.enabled = false
-        self.brightnessSlider?.enabled = false
-    }
-
-    
-    // MARK: Private
-    
-    var monitor: ObjectMonitor<Palette>?
-    
-    @IBOutlet weak var colorNameLabel: UILabel?
-    @IBOutlet weak var colorView: UIView?
-    @IBOutlet weak var hsbLabel: UILabel?
-    @IBOutlet weak var dateLabel: UILabel?
-    @IBOutlet weak var hueSlider: UISlider?
-    @IBOutlet weak var saturationSlider: UISlider?
-    @IBOutlet weak var brightnessSlider: UISlider?
-    
-    @IBAction dynamic func hueSliderValueDidChange(sender: AnyObject?) {
-        
-        let hue = self.hueSlider?.value ?? 0
-        CoreStore.beginAsynchronous { [weak self] (transaction) -> Void in
-            
-            if let palette = transaction.edit(self?.monitor?.object) {
-                
-                palette.hue = Int32(hue)
-                transaction.commit()
-            }
-        }
-    }
-    
-    @IBAction dynamic func saturationSliderValueDidChange(sender: AnyObject?) {
-        
-        let saturation = self.saturationSlider?.value ?? 0
-        CoreStore.beginAsynchronous { [weak self] (transaction) -> Void in
-            
-            if let palette = transaction.edit(self?.monitor?.object) {
-                
-                palette.saturation = saturation
-                transaction.commit()
-            }
-        }
-    }
-    
-    @IBAction dynamic func brightnessSliderValueDidChange(sender: AnyObject?) {
-        
-        let brightness = self.brightnessSlider?.value ?? 0
-        CoreStore.beginAsynchronous { [weak self] (transaction) -> Void in
-            
-            if let palette = transaction.edit(self?.monitor?.object) {
-                
-                palette.brightness = brightness
-                transaction.commit()
-            }
-        }
-    }
-    
-    @IBAction dynamic func deleteBarButtonTapped(sender: AnyObject?) {
-        
-        CoreStore.beginAsynchronous { [weak self] (transaction) -> Void in
-            
-            transaction.delete(self?.monitor?.object)
-            transaction.commit()
-        }
-    }
-    
-    func reloadPaletteInfo(palette: Palette, changedKeys: Set<String>?) {
-        
-        self.colorNameLabel?.text = palette.colorName
-        
-        let color = palette.color
-        self.colorNameLabel?.textColor = color
-        self.colorView?.backgroundColor = color
-        
-        self.hsbLabel?.text = palette.colorText
-        
-        if changedKeys == nil || changedKeys?.contains("hue") == true {
-            
-            self.hueSlider?.value = Float(palette.hue)
-        }
-        if changedKeys == nil || changedKeys?.contains("saturation") == true {
-            
-            self.saturationSlider?.value = palette.saturation
-        }
-        if changedKeys == nil || changedKeys?.contains("brightness") == true {
-            
-            self.brightnessSlider?.value = palette.brightness
-        }
-    }
-}

CoreStoreDemo/CoreStoreDemo/List and Object Observers Demo/ObserversViewController.swift

@@ -1,30 +0,0 @@
-//
-//  ObserversViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/05/24.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-
-
-// MARK: - ObserversViewController
-
-class ObserversViewController: UIViewController {
-    
-    // MARK: UIViewController
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        let alert = UIAlertController(
-            title: "Observers Demo",
-            message: "This demo shows how to observe changes to a list of objects. The top and bottom view controllers both observe a single shared \"ListMonitor\" instance.\n\nTap on a row to see how to observe changes made to a single object using a \"ObjectMonitor\".",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-    }
-}

CoreStoreDemo/CoreStoreDemo/Loggers Demo/CustomLoggerViewController.swift

@@ -1,129 +0,0 @@
-//
-//  CustomLoggerViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/06/05.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-import GCDKit
-
-
-// MARK: - CustomLoggerViewController
-
-class CustomLoggerViewController: UIViewController, CoreStoreLogger {
-    
-    // MARK: NSObject
-    
-    deinit {
-        
-        CoreStore.logger = DefaultLogger()
-    }
-    
-    let dataStack = DataStack()
-    
-    // MARK: UIViewController
-
-    override func viewDidLoad() {
-        
-        super.viewDidLoad()
-        
-        try! self.dataStack.addSQLiteStoreAndWait(fileName: "emptyStore.sqlite")
-        CoreStore.logger = self
-    }
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        let alert = UIAlertController(
-            title: "Logger Demo",
-            message: "This demo shows how to plug-in any logging framework to CoreStore.\n\nThe view controller implements CoreStoreLogger and appends all logs to the text view.",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-    }
-
-    
-    // MARK: CoreStoreLogger
-    
-    func log(level level: LogLevel, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        GCDQueue.Main.async { [weak self] in
-            
-            let levelString: String
-            switch level {
-                
-            case .Trace: levelString = "Trace"
-            case .Notice: levelString = "Notice"
-            case .Warning: levelString = "Warning"
-            case .Fatal: levelString = "Fatal"
-            }
-            self?.textView?.insertText("\((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ [Log:\(levelString)] \(message)\n\n")
-        }
-    }
-    
-    func handleError(error error: NSError, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        GCDQueue.Main.async { [weak self] in
-            
-            self?.textView?.insertText("\((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ [Error] \(message): \(error)\n\n")
-        }
-    }
-    
-    func assert(@autoclosure condition: () -> Bool, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        if condition() {
-            
-            return
-        }
-        
-        GCDQueue.Main.async { [weak self] in
-            
-            self?.textView?.insertText("\((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ [Assert] \(message)\n\n")
-        }
-    }
-    
-    @noreturn func fatalError(message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
-        
-        Swift.fatalError("\((fileName.stringValue as NSString).lastPathComponent):\(lineNumber) \(functionName)\n  ↪︎ [Abort] \(message)")
-    }
-    
-    
-    // MARK: Private
-    
-    @IBOutlet dynamic weak var textView: UITextView?
-    @IBOutlet dynamic weak var segmentedControl: UISegmentedControl?
-    
-    @IBAction dynamic func segmentedControlValueChanged(sender: AnyObject?) {
-        
-        switch self.segmentedControl?.selectedSegmentIndex {
-            
-        case .Some(0):
-            self.dataStack.beginAsynchronous { (transaction) -> Void in
-                
-                transaction.create(Into(Palette))
-            }
-            
-        case .Some(1):
-            do {
-                
-                try self.dataStack.addSQLiteStoreAndWait(fileName: "emptyStore.sqlite", configuration: "invalidStore")
-            }
-            catch _ { }
-            
-        case .Some(2):
-            self.dataStack.beginAsynchronous { (transaction) -> Void in
-                
-                transaction.commit()
-                transaction.commit()
-            }
-            
-        default:
-            return
-        }
-    }
-}

CoreStoreDemo/CoreStoreDemo/MIgrations Demo/MigrationsDemoViewController.swift

@@ -1,388 +0,0 @@
-//
-//  MigrationsDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/06/21.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-
-
-// MARK: - MigrationsDemoViewController
-
-class MigrationsDemoViewController: UIViewController {
-    
-    // MARK: UIViewController
-    
-    override func viewDidLoad() {
-        
-        super.viewDidLoad()
-        
-        if let segmentedControl = self.segmentedControl {
-            
-            for (index, model) in self.models.enumerate() {
-                
-                segmentedControl.setTitle(
-                    model.label,
-                    forSegmentAtIndex: index
-                )
-            }
-        }
-        self.setDataStack(nil, model: nil, scrollToSelection: false)
-    }
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        let alert = UIAlertController(
-            title: "Migrations Demo",
-            message: "This demo shows how to run progressive migrations and how to support multiple model versions in a single project.\n\nThe persistent store contains 10000 organisms, which gain/lose properties when the migration evolves/devolves them.\n\nYou can use the \"mutate\" button to change an organism's properties then migrate to a different model to see how its value gets affected.",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-        
-        
-        let modelMetadata = withExtendedLifetime(DataStack(modelName: "MigrationDemo")) {
-            (dataStack: DataStack) -> ModelMetadata in
-            
-            let models = self.models
-            do {
-                
-                let migrations = try dataStack.requiredMigrationsForSQLiteStore(
-                    fileName: "MigrationDemo.sqlite"
-                )
-                
-                let storeVersion = migrations.first?.sourceVersion ?? dataStack.modelVersion
-                for model in models {
-                    
-                    if model.version == storeVersion {
-                        
-                        return model
-                    }
-                }
-            }
-            catch _ { }
-            
-            return models.first!
-        }
-        
-        self.selectModelVersion(modelMetadata)
-    }
-    
-    
-    // MARK: Private
-    
-    private typealias ModelMetadata = (label: String, version: String, entityType: AnyClass, migrationChain: MigrationChain)
-    
-    private let models: [ModelMetadata] = [
-        (
-            label: "Model V1",
-            version: "MigrationDemo",
-            entityType: OrganismV1.self,
-            migrationChain: ["MigrationDemoV3", "MigrationDemoV2", "MigrationDemo"]
-        ),
-        (
-            label: "Model V2",
-            version: "MigrationDemoV2",
-            entityType: OrganismV2.self,
-            migrationChain: [
-                "MigrationDemo": "MigrationDemoV2",
-                "MigrationDemoV3": "MigrationDemoV2"
-            ]
-        ),
-        (
-            label: "Model V3",
-            version: "MigrationDemoV3",
-            entityType: OrganismV3.self,
-            migrationChain: ["MigrationDemo", "MigrationDemoV2", "MigrationDemoV3"]
-        )
-    ]
-    
-    private var _listMonitor: ListMonitor<NSManagedObject>?
-    private var listMonitor: ListMonitor<NSManagedObject>? {
-        
-        return self._listMonitor
-    }
-    
-    private var _dataStack: DataStack?
-    private var dataStack: DataStack? {
-        
-        return self._dataStack
-    }
-    
-    private var _lastSelectedIndexPath: NSIndexPath?
-    private var lastSelectedIndexPath: NSIndexPath? {
-        
-        return self._lastSelectedIndexPath
-    }
-    
-    private func setSelectedIndexPath(indexPath: NSIndexPath, scrollToSelection: Bool) {
-        
-        self._lastSelectedIndexPath = indexPath
-        self.updateDisplay(reloadData: false, scrollToSelection: scrollToSelection, animated: true)
-    }
-    
-    @IBOutlet private dynamic weak var headerContainer: UIView?
-    @IBOutlet private dynamic weak var titleLabel: UILabel?
-    @IBOutlet private dynamic weak var organismLabel: UILabel?
-    @IBOutlet private dynamic weak var segmentedControl: UISegmentedControl?
-    @IBOutlet private dynamic weak var progressView: UIProgressView?
-    @IBOutlet private dynamic weak var tableView: UITableView?
-    
-    @IBAction private dynamic func segmentedControlValueChanged(sender: AnyObject?) {
-        
-        guard let index = self.segmentedControl?.selectedSegmentIndex else {
-            
-            return
-        }
-        
-        self.selectModelVersion(self.models[index])
-    }
-    
-    private func selectModelVersion(model: ModelMetadata) {
-        
-        if self.dataStack?.modelVersion == model.version {
-            
-            return
-        }
-        
-        self.setDataStack(nil, model: nil, scrollToSelection: false) // explicitly trigger NSPersistentStore cleanup by deallocating the stack
-        
-        let dataStack = DataStack(
-            modelName: "MigrationDemo",
-            migrationChain: model.migrationChain
-        )
-        
-        self.setEnabled(false)
-        let progress = try! dataStack.addSQLiteStore(
-            fileName: "MigrationDemo.sqlite",
-            completion: { [weak self] (result) -> Void in
-                
-                guard let strongSelf = self else {
-                    
-                    return
-                }
-                
-                guard case .Success = result else {
-                    
-                    strongSelf.setEnabled(true)
-                    return
-                }
-                
-                strongSelf.setDataStack(dataStack, model: model, scrollToSelection: true)
-                
-                let count = dataStack.queryValue(From(model.entityType), Select<Int>(.Count("dna")))
-                if count > 0 {
-                    
-                    strongSelf.setEnabled(true)
-                }
-                else {
-                    
-                    dataStack.beginAsynchronous { (transaction) -> Void in
-                        
-                        for i: Int64 in 1 ..< 10000 {
-                            
-                            let organism = transaction.create(Into(model.entityType)) as! OrganismProtocol
-                            organism.dna = i
-                            organism.mutate()
-                        }
-                        
-                        transaction.commit { result -> Void in
-                            
-                            self?.setEnabled(true)
-                        }
-                    }
-                }
-            }
-        )
-        
-        if let progress = progress {
-            
-            progress.setProgressHandler { [weak self] (progress) -> Void in
-                
-                self?.reloadTableHeaderWithProgress(progress)
-            }
-        }
-    }
-    
-    private func setEnabled(enabled: Bool) {
-        
-        UIView.animateWithDuration(
-            0.2,
-            delay: 0,
-            options: .BeginFromCurrentState,
-            animations: { () -> Void in
-                
-                let navigationItem = self.navigationItem
-                navigationItem.leftBarButtonItem?.enabled = enabled
-                navigationItem.rightBarButtonItem?.enabled = enabled
-                navigationItem.hidesBackButton = !enabled
-                
-                self.segmentedControl?.enabled = enabled
-                
-                if let tableView = self.tableView {
-                    
-                    tableView.alpha = enabled ? 1.0 : 0.5
-                    tableView.userInteractionEnabled = enabled
-                }
-            },
-            completion: nil
-        )
-    }
-    
-    private func setDataStack(dataStack: DataStack?, model: ModelMetadata?, scrollToSelection: Bool) {
-        
-        if let dataStack = dataStack, let model = model {
-            
-            self.segmentedControl?.selectedSegmentIndex = self.models.map { $0.version }.indexOf(model.version)!
-            
-            self._dataStack = dataStack
-            let listMonitor = dataStack.monitorList(From(model.entityType), OrderBy(.Descending("dna")))
-            listMonitor.addObserver(self)
-            self._listMonitor = listMonitor
-            
-            if self.lastSelectedIndexPath == nil  {
-                
-                if listMonitor.numberOfObjectsInSection(0) > 0 {
-                    
-                    self.setSelectedIndexPath(NSIndexPath(forRow: 0, inSection: 0), scrollToSelection: true)
-                }
-            }
-        }
-        else {
-           
-            self.segmentedControl?.selectedSegmentIndex = UISegmentedControlNoSegment
-            self._dataStack = nil
-            self._listMonitor = nil
-        }
-        
-        self.updateDisplay(reloadData: true, scrollToSelection: scrollToSelection, animated: false)
-    }
-    
-    private func reloadTableHeaderWithProgress(progress: NSProgress) {
-        
-        self.progressView?.setProgress(Float(progress.fractionCompleted), animated: true)
-        self.titleLabel?.text = "Migrating: \(progress.localizedDescription)"
-        self.organismLabel?.text = "Progressive step \(progress.localizedAdditionalDescription)"
-    }
-    
-    private func updateDisplay(reloadData reloadData: Bool, scrollToSelection: Bool, animated: Bool) {
-        
-        var lines = [String]()
-        var organismType = ""
-        if let indexPath = self.lastSelectedIndexPath, let organism = self.listMonitor?[indexPath] {
-            
-            for property in organism.entity.properties {
-                
-                let value: AnyObject = organism.valueForKey(property.name) ?? NSNull()
-                lines.append("\(property.name): \(value)")
-            }
-            organismType = organism.entity.managedObjectClassName
-        }
-        
-        self.titleLabel?.text = organismType
-        self.organismLabel?.text = lines.joinWithSeparator("\n")
-        self.progressView?.progress = 0
-        
-        self.headerContainer?.setNeedsLayout()
-        
-        guard let tableView = self.tableView else {
-            
-            return
-        }
-        
-        if reloadData {
-            
-            tableView.reloadData()
-        }
-        
-        tableView.layoutIfNeeded()
-        
-        if let indexPath = self.lastSelectedIndexPath where indexPath.row < tableView.numberOfRowsInSection(0) {
-            
-            tableView.selectRowAtIndexPath(indexPath,
-                animated: scrollToSelection && animated,
-                scrollPosition: scrollToSelection ? .Middle : .None
-            )
-        }
-    }
-}
-
-
-// MARK: - MigrationsDemoViewController: ListObserver
-
-extension MigrationsDemoViewController: ListObserver {
-    
-    // MARK: ListObserver
-    
-    func listMonitorWillChange(monitor: ListMonitor<NSManagedObject>) { }
-    
-    func listMonitorDidChange(monitor: ListMonitor<NSManagedObject>) {
-        
-        if self.lastSelectedIndexPath == nil && self.listMonitor?.numberOfObjectsInSection(0) > 0 {
-            
-            self.tableView?.reloadData()
-            self.setSelectedIndexPath(NSIndexPath(forRow: 0, inSection: 0), scrollToSelection: false)
-        }
-        else {
-            
-            self.updateDisplay(reloadData: true, scrollToSelection: true, animated: true)
-        }
-    }
-}
-
-
-// MARK: - MigrationsDemoViewController: UITableViewDataSource, UITableViewDelegate
-
-extension MigrationsDemoViewController: UITableViewDataSource, UITableViewDelegate {
-    
-    // MARK: UITableViewDataSource
-    
-    @objc dynamic func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
-        
-        return self.listMonitor?.numberOfObjectsInSection(0) ?? 0
-    }
-    
-    @objc dynamic func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
-        
-        let cell = tableView.dequeueReusableCellWithIdentifier("OrganismTableViewCell", forIndexPath: indexPath) as! OrganismTableViewCell
-        
-        let dna = (self.listMonitor?[indexPath] as? OrganismProtocol)?.dna.description ?? ""
-        cell.dnaLabel?.text = "DNA: \(dna)"
-        cell.mutateButtonHandler = { [weak self] _ -> Void in
-            
-            guard let strongSelf = self,
-                let dataStack = strongSelf.dataStack,
-                let organism = strongSelf.listMonitor?[indexPath] else {
-                    
-                    return
-            }
-            
-            strongSelf.setSelectedIndexPath(indexPath, scrollToSelection: false)
-            strongSelf.setEnabled(false)
-            dataStack.beginAsynchronous { (transaction) -> Void in
-                
-                let organism = transaction.edit(organism) as! OrganismProtocol
-                organism.mutate()
-                
-                transaction.commit { _ -> Void in
-                    
-                    self?.setEnabled(true)
-                }
-            }
-        }
-        return cell
-    }
-    
-    
-    // MARK: UITableViewDelegate
-    
-    @objc dynamic func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
-        
-        self.setSelectedIndexPath(indexPath, scrollToSelection: false)
-    }
-}

CoreStoreDemo/CoreStoreDemo/MIgrations Demo/OrganismV2ToV3MigrationPolicy.swift

@@ -1,23 +0,0 @@
-//
-//  OrganismV2ToV3MigrationPolicy.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/06/27.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import CoreData
-
-class OrganismV2ToV3MigrationPolicy: NSEntityMigrationPolicy {
-    
-    override func createDestinationInstancesForSourceInstance(sInstance: NSManagedObject, entityMapping mapping: NSEntityMapping, manager: NSMigrationManager) throws {
-        
-        try super.createDestinationInstancesForSourceInstance(sInstance, entityMapping: mapping, manager: manager)
-        
-        for dInstance in manager.destinationInstancesForEntityMappingNamed(mapping.name, sourceInstances: [sInstance]) {
-            
-            dInstance.setValue(false, forKey: "hasVertebrae")
-            dInstance.setValue(sInstance.valueForKey("numberOfFlippers"), forKey: "numberOfLimbs")
-        }
-    }
-}

CoreStoreDemo/CoreStoreDemo/MigrationDemo.xcdatamodeld/MigrationDemo.xcdatamodel/contents

@@ -1,11 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<model userDefinedModelVersionIdentifier="" type="com.apple.IDECoreDataModeler.DataModel" documentVersion="1.0" lastSavedToolsVersion="7701" systemVersion="14E46" minimumToolsVersion="Xcode 4.3">
-    <entity name="Organism" representedClassName="CoreStoreDemo.OrganismV1" syncable="YES">
-        <attribute name="dna" optional="YES" attributeType="Integer 64" syncable="YES"/>
-        <attribute name="hasHead" optional="YES" attributeType="Boolean" syncable="YES"/>
-        <attribute name="hasTail" optional="YES" attributeType="Boolean" syncable="YES"/>
-    </entity>
-    <elements>
-        <element name="Organism" positionX="-36" positionY="9" width="128" height="90"/>
-    </elements>
-</model>

CoreStoreDemo/CoreStoreDemo/MigrationDemo.xcdatamodeld/MigrationDemoV2.xcdatamodel/contents

@@ -1,12 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<model userDefinedModelVersionIdentifier="" type="com.apple.IDECoreDataModeler.DataModel" documentVersion="1.0" lastSavedToolsVersion="7701" systemVersion="14E46" minimumToolsVersion="Xcode 4.3">
-    <entity name="Organism" representedClassName="CoreStoreDemo.OrganismV2" syncable="YES">
-        <attribute name="dna" optional="YES" attributeType="Integer 64" syncable="YES"/>
-        <attribute name="hasHead" attributeType="Boolean" syncable="YES"/>
-        <attribute name="hasTail" attributeType="Boolean" syncable="YES"/>
-        <attribute name="numberOfFlippers" attributeType="Integer 32" defaultValueString="0" syncable="YES"/>
-    </entity>
-    <elements>
-        <element name="Organism" positionX="-36" positionY="9" width="128" height="105"/>
-    </elements>
-</model>

CoreStoreDemo/CoreStoreDemo/MigrationDemo.xcdatamodeld/MigrationDemoV3.xcdatamodel/contents

@@ -1,13 +0,0 @@
-<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
-<model userDefinedModelVersionIdentifier="" type="com.apple.IDECoreDataModeler.DataModel" documentVersion="1.0" lastSavedToolsVersion="7701" systemVersion="14E46" minimumToolsVersion="Xcode 4.3">
-    <entity name="Organism" representedClassName="CoreStoreDemo.OrganismV3" syncable="YES">
-        <attribute name="dna" optional="YES" attributeType="Integer 64" syncable="YES"/>
-        <attribute name="hasHead" attributeType="Boolean" syncable="YES"/>
-        <attribute name="hasTail" attributeType="Boolean" syncable="YES"/>
-        <attribute name="hasVertebrae" attributeType="Boolean" syncable="YES"/>
-        <attribute name="numberOfLimbs" attributeType="Integer 32" defaultValueString="0" syncable="YES"/>
-    </entity>
-    <elements>
-        <element name="Organism" positionX="-36" positionY="9" width="128" height="120"/>
-    </elements>
-</model>

CoreStoreDemo/CoreStoreDemo/Stack Setup Demo/StackSetupDemoViewController.swift

@@ -1,189 +0,0 @@
-//
-//  StackSetupDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/05/24.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreStore
-
-
-private struct Static {
-    
-    static let maleConfiguration = "MaleAccounts"
-    static let femaleConfiguration = "FemaleAccounts"
-    
-    static let facebookStack: DataStack = {
-        
-        let dataStack = DataStack(modelName: "StackSetupDemo")
-        try! dataStack.addSQLiteStoreAndWait(
-            fileName: "AccountsDemo_FB_Male.sqlite",
-            configuration: maleConfiguration,
-            resetStoreOnModelMismatch: true
-        )
-        try! dataStack.addSQLiteStoreAndWait(
-            fileName: "AccountsDemo_FB_Female.sqlite",
-            configuration: femaleConfiguration,
-            resetStoreOnModelMismatch: true
-        )
-        
-        dataStack.beginSynchronous { (transaction) -> Void in
-            
-            transaction.deleteAll(From(UserAccount))
-            
-            let account1 = transaction.create(Into<MaleAccount>(maleConfiguration))
-            account1.accountType = "Facebook"
-            account1.name = "John Smith HCD"
-            account1.friends = 42
-            
-            let account2 = transaction.create(Into<FemaleAccount>(femaleConfiguration))
-            account2.accountType = "Facebook"
-            account2.name = "Jane Doe HCD"
-            account2.friends = 314
-            
-            transaction.commitAndWait()
-        }
-        
-        return dataStack
-    }()
-    
-    static let twitterStack: DataStack = {
-        
-        let dataStack = DataStack(modelName: "StackSetupDemo")
-        try! dataStack.addSQLiteStoreAndWait(
-            fileName: "AccountsDemo_TW_Male.sqlite",
-            configuration: maleConfiguration,
-            resetStoreOnModelMismatch: true
-        )
-        try! dataStack.addSQLiteStoreAndWait(
-            fileName: "AccountsDemo_TW_Female.sqlite",
-            configuration: femaleConfiguration,
-            resetStoreOnModelMismatch: true
-        )
-        
-        dataStack.beginSynchronous { (transaction) -> Void in
-            
-            transaction.deleteAll(From(UserAccount))
-            
-            let account1 = transaction.create(Into<MaleAccount>(maleConfiguration))
-            account1.accountType = "Twitter"
-            account1.name = "#johnsmith_hcd"
-            account1.friends = 7
-            
-            let account2 = transaction.create(Into<FemaleAccount>(femaleConfiguration))
-            account2.accountType = "Twitter"
-            account2.name = "#janedoe_hcd"
-            account2.friends = 100
-            
-            transaction.commitAndWait()
-        }
-        
-        return dataStack
-    }()
-}
-
-
-
-
-// MARK: - StackSetupDemoViewController
-
-class StackSetupDemoViewController: UITableViewController {
-    
-    let accounts = [
-        Static.facebookStack.fetchAll(From(UserAccount)) ?? [],
-        Static.twitterStack.fetchAll(From(UserAccount)) ?? []
-    ]
-    
-    
-    // MARK: UIViewController
-    
-    override func viewWillAppear(animated: Bool) {
-        
-        super.viewWillAppear(animated)
-        
-        self.tableView.reloadData()
-        
-        let indexPath = NSIndexPath(forRow: 0, inSection: 0)
-        self.tableView.selectRowAtIndexPath(indexPath, animated: false, scrollPosition: .None)
-        self.updateDetailsWithAccount(self.accounts[indexPath.section][indexPath.row])
-    }
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        let alert = UIAlertController(
-            title: "Setup Demo",
-            message: "This demo shows how to initialize 2 DataStacks with 2 configurations each, for a total of 4 SQLite files, each with 1 instance of a \"UserAccount\" entity.",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-    }
-    
-    
-    // MARK: UITableViewDataSource
-    
-    override func numberOfSectionsInTableView(tableView: UITableView) -> Int {
-        
-        return self.accounts.count
-    }
-    
-    override func tableView(tableView: UITableView, numberOfRowsInSection section: Int) -> Int {
-        
-        return self.accounts[section].count
-    }
-    
-    override func tableView(tableView: UITableView, cellForRowAtIndexPath indexPath: NSIndexPath) -> UITableViewCell {
-        
-        let cell = tableView.dequeueReusableCellWithIdentifier("UITableViewCell")!
-        
-        let account = self.accounts[indexPath.section][indexPath.row]
-        cell.textLabel?.text = account.name
-        cell.detailTextLabel?.text = "\(account.friends) friends"
-        
-        return cell
-    }
-    
-    
-    // MARK: UITableViewDelegate
-    
-    override func tableView(tableView: UITableView, didSelectRowAtIndexPath indexPath: NSIndexPath) {
-        
-        let account = self.accounts[indexPath.section][indexPath.row]
-        self.updateDetailsWithAccount(account)
-    }
-    
-    override func tableView(tableView: UITableView, titleForHeaderInSection section: Int) -> String? {
-        
-        switch section {
-            
-        case 0:
-            let count = self.accounts[section].count
-            return "Facebook Accounts (\(count) users)"
-            
-        case 1:
-            let count = self.accounts[section].count
-            return "Twitter Accounts (\(count) users)"
-            
-        default:
-            return nil
-        }
-    }
-    
-    
-    // MARK: Private
-    
-    @IBOutlet private dynamic weak var accountTypeLabel: UILabel?
-    @IBOutlet private dynamic weak var nameLabel: UILabel?
-    @IBOutlet private dynamic weak var friendsLabel: UILabel?
-    
-    private func updateDetailsWithAccount(account: UserAccount) {
-        
-        self.accountTypeLabel?.text = account.accountType
-        self.nameLabel?.text = account.name
-        self.friendsLabel?.text = "\(account.friends) friends"
-    }
-}

CoreStoreDemo/CoreStoreDemo/Transactions Demo/TransactionsDemoViewController.swift

@@ -1,209 +0,0 @@
-//
-//  TransactionsDemoViewController.swift
-//  CoreStoreDemo
-//
-//  Created by John Rommel Estropia on 2015/05/24.
-//  Copyright © 2015 John Rommel Estropia. All rights reserved.
-//
-
-import UIKit
-import CoreLocation
-import MapKit
-import AddressBookUI
-import CoreStore
-import GCDKit
-
-
-private struct Static {
-    
-    static let placeController: ObjectMonitor<Place> = {
-        
-        try! CoreStore.addSQLiteStoreAndWait(
-            fileName: "PlaceDemo.sqlite",
-            configuration: "TransactionsDemo",
-            resetStoreOnModelMismatch: true
-        )
-        
-        var place = CoreStore.fetchOne(From(Place))
-        if place == nil {
-            
-            CoreStore.beginSynchronous { (transaction) -> Void in
-                
-                let place = transaction.create(Into(Place))
-                place.setInitialValues()
-                
-                transaction.commitAndWait()
-            }
-            place = CoreStore.fetchOne(From(Place))
-        }
-        
-        return CoreStore.monitorObject(place!)
-    }()
-}
-
-
-// MARK: - TransactionsDemoViewController
-
-class TransactionsDemoViewController: UIViewController, MKMapViewDelegate, ObjectObserver {
-    
-    // MARK: NSObject
-    
-    deinit {
-        
-        Static.placeController.removeObserver(self)
-    }
-    
-    
-    // MARK: UIViewController
-    
-    override func viewDidLoad() {
-        
-        super.viewDidLoad()
-        
-        let longPressGesture = UILongPressGestureRecognizer(target: self, action: "longPressGestureRecognized:")
-        self.mapView?.addGestureRecognizer(longPressGesture)
-        
-        Static.placeController.addObserver(self)
-        
-        self.navigationItem.rightBarButtonItem = UIBarButtonItem(
-            barButtonSystemItem: .Refresh,
-            target: self,
-            action: "refreshButtonTapped:"
-        )
-    }
-    
-    override func viewDidAppear(animated: Bool) {
-        
-        super.viewDidAppear(animated)
-        
-        let alert = UIAlertController(
-            title: "Transactions Demo",
-            message: "This demo shows how to use the 3 types of transactions to save updates: synchronous, asynchronous, and unsafe.\n\nTap and hold on the map to change the pin location.",
-            preferredStyle: .Alert
-        )
-        alert.addAction(UIAlertAction(title: "OK", style: .Cancel, handler: nil))
-        self.presentViewController(alert, animated: true, completion: nil)
-    }
-    
-    override func viewWillAppear(animated: Bool) {
-        
-        super.viewWillAppear(animated)
-        
-        if let mapView = self.mapView, let place = Static.placeController.object {
-            
-            mapView.addAnnotation(place)
-            mapView.setCenterCoordinate(place.coordinate, animated: false)
-            mapView.selectAnnotation(place, animated: false)
-        }
-    }
-    
-    
-    // MARK: MKMapViewDelegate
-    
-    func mapView(mapView: MKMapView, viewForAnnotation annotation: MKAnnotation) -> MKAnnotationView? {
-        
-        let identifier = "MKAnnotationView"
-        var annotationView: MKPinAnnotationView! = mapView.dequeueReusableAnnotationViewWithIdentifier(identifier) as? MKPinAnnotationView
-        if annotationView == nil {
-            
-            annotationView = MKPinAnnotationView(annotation: annotation, reuseIdentifier: identifier)
-            annotationView.enabled = true
-            annotationView.canShowCallout = true
-            annotationView.animatesDrop = true
-        }
-        else {
-            
-            annotationView.annotation = annotation
-        }
-        
-        return annotationView
-    }
-    
-    
-    // MARK: ObjectObserver
-    
-    func objectMonitor(monitor: ObjectMonitor<Place>, willUpdateObject object: Place) {
-        
-        // none
-    }
-    
-    func objectMonitor(monitor: ObjectMonitor<Place>, didUpdateObject object: Place, changedPersistentKeys: Set<KeyPath>) {
-        
-        if let mapView = self.mapView {
-            
-            mapView.removeAnnotations(mapView.annotations ?? [])
-            mapView.addAnnotation(object)
-            mapView.setCenterCoordinate(object.coordinate, animated: true)
-            mapView.selectAnnotation(object, animated: true)
-            
-            if changedPersistentKeys.contains("latitude") || changedPersistentKeys.contains("longitude") {
-                
-                self.geocodePlace(object)
-            }
-        }
-    }
-    
-    func objectMonitor(monitor: ObjectMonitor<Place>, didDeleteObject object: Place) {
-        
-        // none
-    }
-
-    
-    // MARK: Private
-    
-    var geocoder: CLGeocoder?
-    
-    @IBOutlet weak var mapView: MKMapView?
-    
-    @IBAction dynamic func longPressGestureRecognized(sender: AnyObject?) {
-        
-        if let mapView = self.mapView, let gesture = sender as? UILongPressGestureRecognizer where gesture.state == .Began {
-            
-            let coordinate = mapView.convertPoint(
-                gesture.locationInView(mapView),
-                toCoordinateFromView: mapView
-            )
-            CoreStore.beginAsynchronous { (transaction) -> Void in
-                
-                let place = transaction.edit(Static.placeController.object)
-                place?.coordinate = coordinate
-                transaction.commit { (_) -> Void in }
-            }
-        }
-    }
-    
-    @IBAction dynamic func refreshButtonTapped(sender: AnyObject?) {
-        
-        CoreStore.beginSynchronous { (transaction) -> Void in
-            
-            let place = transaction.edit(Static.placeController.object)
-            place?.setInitialValues()
-            transaction.commitAndWait()
-        }
-    }
-    
-    func geocodePlace(place: Place) {
-        
-        let transaction = CoreStore.beginUnsafe()
-        
-        self.geocoder?.cancelGeocode()
-        
-        let geocoder = CLGeocoder()
-        self.geocoder = geocoder
-        geocoder.reverseGeocodeLocation(
-            CLLocation(latitude: place.latitude, longitude: place.longitude),
-            completionHandler: { [weak self] (placemarks, error) -> Void in
-                
-                if let placemark = placemarks?.first, let addressDictionary = placemark.addressDictionary {
-                    
-                    let place = transaction.edit(Static.placeController.object)
-                    place?.title = placemark.name
-                    place?.subtitle = ABCreateStringWithAddressDictionary(addressDictionary, true)
-                    transaction.commit { (_) -> Void in }
-                }
-                
-                self?.geocoder = nil
-            }
-        )
-    }
-}

CoreStoreTests/BaseTestCase.swift

@@ -0,0 +1,233 @@
+//
+//  BaseTestCase.swift
+//  CoreStore
+//
+//  Copyright © 2018 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 XCTest
+
+@testable
+import CoreStore
+
+
+// MARK: - BaseTestCase
+
+class BaseTestCase: XCTestCase {
+    
+    // MARK: Internal
+    
+    @nonobjc
+    func prepareStack(configurations: [ModelConfiguration] = [nil], _ closure: (_ dataStack: DataStack) throws -> Void) {
+        
+        let stack = DataStack(
+            xcodeModelName: "Model",
+            bundle: Bundle(for: Self.self)
+        )
+        do {
+            
+            try configurations.forEach {
+                
+                try stack.addStorageAndWait(
+                    SQLiteStore(
+                        fileURL: SQLiteStore.defaultRootDirectory
+                            .appendingPathComponent(UUID().uuidString)
+                            .appendingPathComponent("\(Self.self)_\(($0 ?? "-null-")).sqlite"),
+                        configuration: $0,
+                        localStorageOptions: .recreateStoreOnModelMismatch
+                    )
+                )
+            }
+            try closure(stack)
+        }
+        catch let error as NSError {
+            
+            XCTFail(error.coreStoreDumpString)
+        }
+        self.addTeardownBlock {
+            stack.unsafeRemoveAllPersistentStoresAndWait()
+        }
+    }
+    
+    @nonobjc
+    func expectLogger<T>(_ expectations: [TestLogger.Expectation], closure: () throws -> T) rethrows -> T {
+        
+        CoreStoreDefaults.logger = TestLogger(self.prepareLoggerExpectations(expectations))
+        defer {
+            
+            self.checkExpectationsImmediately()
+            CoreStoreDefaults.logger = TestLogger([:])
+        }
+        return try closure()
+    }
+    
+    @nonobjc
+    func expectLogger(_ expectations: [TestLogger.Expectation: XCTestExpectation]) {
+        
+        CoreStoreDefaults.logger = TestLogger(expectations)
+    }
+
+    @nonobjc
+    func expectError<T>(code: CoreStoreErrorCode, closure: () throws -> T) {
+
+        CoreStoreDefaults.logger = TestLogger(self.prepareLoggerExpectations([.logError]))
+        defer {
+
+            self.checkExpectationsImmediately()
+            CoreStoreDefaults.logger = TestLogger([:])
+        }
+        do {
+
+            _ = try closure()
+        }
+        catch let error as CoreStoreError {
+
+            if error.errorCode == code.rawValue {
+
+                return
+            }
+            XCTFail("Expected error code \(code) different from actual error: \((error as NSError).coreStoreDumpString)")
+        }
+        catch {
+
+            XCTFail("Error not wrapped as \(Internals.typeName(CoreStoreError.self)): \((error as NSError).coreStoreDumpString)")
+        }
+    }
+    
+    @nonobjc
+    func prepareLoggerExpectations(_ expectations: [TestLogger.Expectation]) -> [TestLogger.Expectation: XCTestExpectation] {
+        
+        var testExpectations: [TestLogger.Expectation: XCTestExpectation] = [:]
+        for expectation in expectations {
+            
+            testExpectations[expectation] = self.expectation(description: "Logger Expectation: \(expectation)")
+        }
+        return testExpectations
+    }
+    
+    @nonobjc
+    func checkExpectationsImmediately() {
+        
+        self.waitForExpectations(timeout: 0, handler: { _ in })
+    }
+    
+    @nonobjc
+    func waitAndCheckExpectations() {
+        
+        self.waitForExpectations(timeout: 10, handler: {_ in })
+    }
+    
+    // MARK: XCTestCase
+    
+    override func setUp() {
+        
+        super.setUp()
+        self.deleteStores()
+        CoreStoreDefaults.logger = TestLogger([:])
+    }
+    
+    override func tearDown() {
+        
+        CoreStoreDefaults.logger = DefaultLogger()
+        self.deleteStores()
+        super.tearDown()
+    }
+    
+    
+    // MARK: Private
+    
+    private func deleteStores() {
+        
+        _ = try? FileManager.default.removeItem(at: SQLiteStore.defaultRootDirectory)
+    }
+}
+
+
+// MARK: - TestLogger
+
+class TestLogger: CoreStoreLogger {
+    
+    enum Expectation {
+        
+        case logWarning
+        case logFatal
+        case logError
+        case assertionFailure
+        case fatalError
+    }
+    
+    init(_ expectations: [Expectation: XCTestExpectation]) {
+        
+        self.expectations = expectations
+    }
+    
+    
+    // MARK: CoreStoreLogger
+    
+    var enableObjectConcurrencyDebugging: Bool = true
+    
+    func log(level: LogLevel, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
+        
+        switch level {
+            
+        case .warning:  self.fulfill(.logWarning)
+        case .fatal:    self.fulfill(.logFatal)
+        default:        break
+        }
+    }
+    
+    func log(error: CoreStoreError, message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
+        
+        self.fulfill(.logError)
+    }
+    
+    func assert(_ condition: @autoclosure () -> Bool, message: @autoclosure () -> String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
+        
+        if condition() {
+            
+            return
+        }
+        self.fulfill(.assertionFailure)
+    }
+    
+    func abort(_ message: String, fileName: StaticString, lineNumber: Int, functionName: StaticString) {
+        
+        self.fulfill(.fatalError)
+    }
+    
+    
+    // MARK: Private
+    
+    private var expectations: [Expectation: XCTestExpectation]
+    
+    private func fulfill(_ expectation: Expectation) {
+        
+        if let instance = self.expectations[expectation] {
+            
+            instance.fulfill()
+            self.expectations[expectation] = nil
+        }
+        else {
+            
+            XCTFail("Unexpected Logger Action: \(expectation)")
+        }
+    }
+}

CoreStoreTests/BaseTestDataTestCase.swift

@@ -0,0 +1,94 @@
+//
+//  BaseTestDataTestCase.swift
+//  CoreStore
+//
+//  Copyright © 2018 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
+
+@testable
+import CoreStore
+
+
+// MARK: - BaseTestDataTestCase
+
+class BaseTestDataTestCase: BaseTestCase {
+    
+    @nonobjc
+    let dateFormatter: DateFormatter = Internals.with {
+        
+        let formatter = DateFormatter()
+        formatter.locale = Locale(identifier: "en_US_POSIX")
+        formatter.timeZone = TimeZone(identifier: "UTC")
+        formatter.calendar = Calendar(identifier: Calendar.Identifier.gregorian)
+        formatter.dateFormat = "yyyy'-'MM'-'dd'T'HH':'mm':'ssZ"
+        return formatter
+    }
+    
+    @nonobjc
+    func prepareTestDataForStack(_ stack: DataStack, configurations: [ModelConfiguration] = [nil]) {
+        
+        try! stack.perform(
+            synchronous: { (transaction) in
+                
+                for (configurationIndex, configuration) in configurations.enumerated() {
+                    
+                    let configurationOrdinal = configurationIndex + 1
+                    if configuration == nil || configuration == "Config1" {
+                        
+                        for idIndex in 1 ... 5 {
+                            
+                            let object = transaction.create(Into<TestEntity1>(configuration))
+                            object.testEntityID = NSNumber(value: (configurationOrdinal * 100) + idIndex)
+                            
+                            object.testNumber = NSNumber(value: idIndex)
+                            object.testDate = self.dateFormatter.date(from: "2000-\(configurationOrdinal)-\(idIndex)T00:00:00Z")
+                            object.testBoolean = NSNumber(value: (idIndex % 2) == 1)
+                            object.testDecimal = NSDecimalNumber(string: "\(idIndex)")
+                            
+                            let string = "\(configuration ?? "nil"):TestEntity1:\(idIndex)"
+                            object.testString = string
+                            object.testData = (string as NSString).data(using: String.Encoding.utf8.rawValue)
+                        }
+                    }
+                    if configuration == nil || configuration == "Config2" {
+                        
+                        for idIndex in 1 ... 5 {
+                            
+                            let object = transaction.create(Into<TestEntity2>(configuration))
+                            object.testEntityID = NSNumber(value: (configurationOrdinal * 200) + idIndex)
+                            
+                            object.testNumber = NSNumber(value: idIndex)
+                            object.testDate = self.dateFormatter.date(from: "2000-\(configurationOrdinal)-\(idIndex)T00:00:00Z")
+                            object.testBoolean = NSNumber(value: (idIndex % 2) == 1)
+                            object.testDecimal = NSDecimalNumber(string: "\(idIndex)")
+                            
+                            let string = "\(configuration ?? "nil"):TestEntity2:\(idIndex)"
+                            object.testString = string
+                            object.testData = (string as NSString).data(using: String.Encoding.utf8.rawValue)
+                        }
+                    }
+                }
+            }
+        )
+    }
+}

CoreStoreTests/BridgingTests.h

@@ -0,0 +1,30 @@
+//
+//  BridgingTests.h
+//  CoreStore
+//
+//  Copyright © 2018 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 <XCTest/XCTest.h>
+
+@interface BridgingTests : XCTestCase
+
+@end

CoreStoreTests/BridgingTests.m

@@ -0,0 +1,269 @@
+//
+//  BridgingTests.m
+//  CoreStore
+//
+//  Copyright © 2018 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 "BridgingTests.h"
+#import <CoreStore/CoreStore.h>
+#import <CoreStore/CoreStore-Swift.h>
+#import "CoreStoreTests-Swift.h"
+
+@import CoreData;
+
+#pragma clang diagnostic push
+#pragma clang diagnostic ignored "-Wdeprecated-declarations"
+
+
+// MARK: - BridgingTests
+
+@implementation BridgingTests
+
+- (void)test_ThatFlags_HaveCorrectValues {
+    
+    XCTAssertEqual(CSLocalStorageOptionsNone, 0);
+    XCTAssertEqual(CSLocalStorageOptionsRecreateStoreOnModelMismatch, 1);
+    XCTAssertEqual(CSLocalStorageOptionsPreventProgressiveMigration, 2);
+    XCTAssertEqual(CSLocalStorageOptionsAllowSynchronousLightweightMigration, 4);
+}
+
+- (void)test_ThatKeyPaths_AreCorrect {
+    
+    XCTAssertEqualObjects(CSKeyPath(TestEntity1, testNumber), @"testNumber");
+    XCTAssertEqualObjects(CSKeyPath(TestEntity1, testString), @"testString");
+    XCTAssertEqualObjects(CSKeyPathOperator(count, TestEntity1, testString), @"@count.testString");
+    XCTAssertEqualObjects(CSKeyPathOperator(max, TestEntity1, testNumber), @"@max.testNumber");
+}
+
+- (void)test_ThatFromClauses_BridgeCorrectly {
+    
+    {
+        CSFrom *from = CSFromClass([TestEntity1 class]);
+        XCTAssertEqualObjects(from.entityClass, [TestEntity1 class]);
+        XCTAssertNil(from.configurations);
+    }
+    {
+        CSFrom *from = CSFromClass([TestEntity1 class], [NSNull null]);
+        XCTAssertEqualObjects(from.entityClass, [TestEntity1 class]);
+        
+        NSArray *configurations = @[[NSNull null]];
+        XCTAssertEqualObjects(from.configurations, configurations);
+    }
+    {
+        CSFrom *from = CSFromClass([TestEntity1 class], @"Config1");
+        XCTAssertEqualObjects(from.entityClass, [TestEntity1 class]);
+        
+        NSArray *configurations = @[@"Config1"];
+        XCTAssertEqualObjects(from.configurations, configurations);
+    }
+    {
+        CSFrom *from = CSFromClass([TestEntity1 class], @[[NSNull null], @"Config2"]);
+        XCTAssertEqualObjects(from.entityClass, [TestEntity1 class]);
+        
+        NSArray *configurations = @[[NSNull null], @"Config2"];
+        XCTAssertEqualObjects(from.configurations, configurations);
+    }
+}
+
+- (void)test_ThatWhereClauses_BridgeCorrectly {
+    
+    {
+        CSWhere *where = CSWhereFormat(@"%K == %@", @"key", @"value");
+        NSPredicate *predicate = [NSPredicate predicateWithFormat:@"%K == %@", @"key", @"value"];
+        XCTAssertEqualObjects(where.predicate, predicate);
+    }
+    {
+        CSWhere *where = CSWhereValue(YES);
+        NSPredicate *predicate = [NSPredicate predicateWithValue:YES];
+        XCTAssertEqualObjects(where.predicate, predicate);
+    }
+    {
+        CSWhere *where = CSWherePredicate([NSPredicate predicateWithFormat:@"%K == %@", @"key", @"value"]);
+        NSPredicate *predicate = [NSPredicate predicateWithFormat:@"%K == %@", @"key", @"value"];
+        XCTAssertEqualObjects(where.predicate, predicate);
+    }
+}
+
+- (void)test_ThatOrderByClauses_BridgeCorrectly {
+    
+    {
+        CSOrderBy *orderBy = CSOrderByKey(CSSortAscending(@"key"));
+        XCTAssertEqualObjects(orderBy.sortDescriptors, @[[NSSortDescriptor sortDescriptorWithKey:@"key" ascending:YES]]);
+    }
+    {
+        CSOrderBy *orderBy = CSOrderByKey(CSSortDescending(@"key"));
+        XCTAssertEqualObjects(orderBy.sortDescriptors, @[[NSSortDescriptor sortDescriptorWithKey:@"key" ascending:NO]]);
+    }
+    {
+        CSOrderBy *orderBy = CSOrderByKeys(CSSortAscending(@"key1"), CSSortDescending(@"key2"), nil);
+        NSArray *sortDescriptors = @[[NSSortDescriptor sortDescriptorWithKey:@"key1" ascending:YES],
+                                     [NSSortDescriptor sortDescriptorWithKey:@"key2" ascending:NO]];
+        XCTAssertEqualObjects(orderBy.sortDescriptors, sortDescriptors);
+    }
+}
+
+- (void)test_ThatGroupByClauses_BridgeCorrectly {
+    
+    {
+        CSGroupBy *groupBy = CSGroupByKeyPath(@"key");
+        XCTAssertEqualObjects(groupBy.keyPaths, @[@"key"]);
+    }
+    {
+        CSGroupBy *groupBy = CSGroupByKeyPaths(@[@"key1", @"key2"]);
+        
+        NSArray *keyPaths = @[@"key1", @"key2"];
+        XCTAssertEqualObjects(groupBy.keyPaths, keyPaths);
+    }
+}
+
+- (void)test_ThatTweakClauses_BridgeCorrectly {
+    
+    CSTweak *tweak = CSTweakRequest(^(NSFetchRequest * _Nonnull fetchRequest) {
+        
+        fetchRequest.fetchLimit = 100;
+    });
+    NSFetchRequest *request = [NSFetchRequest new];
+    tweak.block(request);
+    XCTAssertEqual(request.fetchLimit, 100);
+}
+
+- (void)test_ThatIntoClauses_BridgeCorrectly {
+    
+    {
+        CSInto *into = CSIntoClass([TestEntity1 class]);
+        XCTAssertEqualObjects(into.entityClass, [TestEntity1 class]);
+    }
+    {
+        CSInto *into = CSIntoClass([TestEntity1 class], [NSNull null]);
+        XCTAssertEqualObjects(into.entityClass, [TestEntity1 class]);
+        XCTAssertNil(into.configuration);
+    }
+    {
+        CSInto *into = CSIntoClass([TestEntity1 class], @"Config1");
+        XCTAssertEqualObjects(into.entityClass, [TestEntity1 class]);
+        XCTAssertEqualObjects(into.configuration, @"Config1");
+    }
+}
+
+- (void)test_ThatDataStacks_BridgeCorrectly {
+    
+    CSDataStack *dataStack = [[CSDataStack alloc]
+                              initWithXcodeModelName:@"Model"
+                              bundle:[NSBundle bundleForClass:[self class]]
+                              versionChain:nil];
+    XCTAssertNotNil(dataStack);
+    
+    NSError *memoryError;
+    CSInMemoryStore *memoryStorage = [dataStack
+                                      addInMemoryStorageAndWait:[CSInMemoryStore new]
+                                      error:&memoryError];
+    XCTAssertNotNil(memoryStorage);
+    XCTAssertEqualObjects([[memoryStorage class] storeType], [CSInMemoryStore storeType]);
+    XCTAssertEqualObjects([[memoryStorage class] storeType], NSInMemoryStoreType);
+    XCTAssertNil(memoryStorage.configuration);
+    XCTAssertNil(memoryStorage.storeOptions);
+    XCTAssertNil(memoryError);
+    
+    NSError *sqliteError;
+    CSSQLiteStore *sqliteStorage = [dataStack
+                                    addSQLiteStorageAndWait:[CSSQLiteStore new]
+                                    error:&sqliteError];
+    XCTAssertNotNil(sqliteStorage);
+    XCTAssertEqualObjects([[sqliteStorage class] storeType], [CSSQLiteStore storeType]);
+    XCTAssertEqualObjects([[sqliteStorage class] storeType], NSSQLiteStoreType);
+    XCTAssertNil(sqliteStorage.configuration);
+    NSDictionary *storeOptions;
+    if (@available(iOS 11.0, macOS 10.13, tvOS 11.0, *)) {
+        
+        storeOptions = @{ NSSQLitePragmasOption: @{ @"journal_mode": @"WAL" },
+                          NSBinaryStoreInsecureDecodingCompatibilityOption: @YES };
+    }
+    else {
+        
+        storeOptions = @{ NSSQLitePragmasOption: @{ @"journal_mode": @"WAL" }};
+    }
+    XCTAssertEqualObjects(sqliteStorage.storeOptions, storeOptions);
+    XCTAssertNil(sqliteError);
+}
+
+- (void)test_ThatTransactions_BridgeCorrectly {
+
+    CSDataStack *dataStack = [[CSDataStack alloc]
+                              initWithXcodeModelName:@"Model"
+                              bundle:[NSBundle bundleForClass:[self class]]
+                              versionChain:nil];
+    XCTAssertNotNil(dataStack);
+
+    [dataStack
+     addInMemoryStorageAndWait:[CSInMemoryStore new]
+     error:nil];
+    
+    {
+        CSUnsafeDataTransaction *transaction = [dataStack beginUnsafe];
+        XCTAssertNotNil(transaction);
+        XCTAssert([transaction isKindOfClass:[CSUnsafeDataTransaction class]]);
+        NSError *error;
+        BOOL result = [transaction commitAndWaitWithError:&error];
+        XCTAssertTrue(result);
+        XCTAssertNil(error);
+    }
+    {
+        XCTestExpectation *expectation = [self expectationWithDescription:@"sync"];
+        NSError *error;
+        BOOL result =
+        [dataStack
+         beginSynchronous:^(CSSynchronousDataTransaction * _Nonnull transaction) {
+
+            XCTAssertNotNil(transaction);
+            XCTAssert([transaction isKindOfClass:[CSSynchronousDataTransaction class]]);
+            NSError *error;
+            XCTAssertTrue([transaction commitAndWaitWithError:&error]);
+            XCTAssertNil(error);
+            [expectation fulfill];
+        }
+         error:&error];
+        XCTAssertTrue(result);
+        XCTAssertNil(error);
+    }
+    {
+        XCTestExpectation *expectation = [self expectationWithDescription:@"async"];
+        [dataStack beginAsynchronous:^(CSAsynchronousDataTransaction * _Nonnull transaction) {
+            
+            XCTAssertNotNil(transaction);
+            XCTAssert([transaction isKindOfClass:[CSAsynchronousDataTransaction class]]);
+            [transaction
+             commitWithSuccess:^{
+                 
+                 [expectation fulfill];
+             }
+             failure:^(CSError *error){
+                 
+                 XCTFail();
+             }];
+        }];
+    }
+    [self waitForExpectationsWithTimeout:10 handler:nil];
+}
+
+@end
+
+#pragma clang diagnostic pop

CoreStoreTests/ConvenienceTests.swift

@@ -0,0 +1,91 @@
+//
+//  ConvenienceTests.swift
+//  CoreStore
+//
+//  Copyright © 2018 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.
+//
+
+@testable
+import CoreStore
+
+
+// MARK: - ConvenienceTests
+
+@available(macOS 10.12, *)
+class ConvenienceTests: BaseTestCase {
+    
+    @objc
+    dynamic func test_ThatDataStacks_CanCreateFetchedResultsControllers() {
+
+        self.prepareStack { (stack) in
+            
+            let controller = stack.createFetchedResultsController(
+                From<TestEntity1>(),
+                SectionBy(#keyPath(TestEntity1.testString)),
+                Where<TestEntity1>("%@ > %d", #keyPath(TestEntity1.testEntityID), 100),
+                OrderBy<TestEntity1>(.ascending(#keyPath(TestEntity1.testString))),
+                Tweak { $0.fetchLimit = 10 }
+            )
+            XCTAssertEqual(controller.managedObjectContext, stack.mainContext)
+            XCTAssertEqual(controller.fetchRequest.entity?.managedObjectClassName, NSStringFromClass(TestEntity1.self))
+            XCTAssertEqual(controller.sectionNameKeyPath, #keyPath(TestEntity1.testString))
+            XCTAssertEqual(
+                controller.fetchRequest.sortDescriptors!,
+                OrderBy<TestEntity1>(.ascending(#keyPath(TestEntity1.testString))).sortDescriptors
+            )
+            XCTAssertEqual(
+                controller.fetchRequest.predicate,
+                Where<TestEntity1>("%@ > %d", #keyPath(TestEntity1.testEntityID), 100).predicate
+            )
+            XCTAssertEqual(controller.fetchRequest.fetchLimit, 10)
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatUnsafeDataTransactions_CanCreateFetchedResultsControllers() {
+        
+        self.prepareStack { (stack) in
+            
+            withExtendedLifetime(stack.beginUnsafe()) { (transaction: UnsafeDataTransaction) in
+                
+                let controller = transaction.createFetchedResultsController(
+                    From<TestEntity1>(),
+                    SectionBy(#keyPath(TestEntity1.testString)),
+                    Where<TestEntity1>("%@ > %d", #keyPath(TestEntity1.testEntityID), 100),
+                    OrderBy<TestEntity1>(.ascending(#keyPath(TestEntity1.testString))),
+                    Tweak { $0.fetchLimit = 10 }
+                )
+                XCTAssertEqual(controller.managedObjectContext, transaction.context)
+                XCTAssertEqual(controller.fetchRequest.entity?.managedObjectClassName, NSStringFromClass(TestEntity1.self))
+                XCTAssertEqual(controller.sectionNameKeyPath, #keyPath(TestEntity1.testString))
+                XCTAssertEqual(
+                    controller.fetchRequest.sortDescriptors!,
+                    OrderBy<TestEntity1>(.ascending(#keyPath(TestEntity1.testString))).sortDescriptors
+                )
+                XCTAssertEqual(
+                    controller.fetchRequest.predicate,
+                    Where<TestEntity1>("%@ > %d", #keyPath(TestEntity1.testEntityID), 100).predicate
+                )
+                XCTAssertEqual(controller.fetchRequest.fetchLimit, 10)
+            }
+        }
+    }
+}

CoreStoreTests/CoreStoreTests-Bridging-Header.h

@@ -0,0 +1,5 @@
+//
+//  Use this file to import your target's public headers that you would like to expose to Swift.
+//
+
+#import "BridgingTests.h"

CoreStoreTests/CoreStoreTests.swift

@@ -1,389 +0,0 @@
-//
-//  CoreStoreTests.swift
-//  CoreStoreTests
-//
-//  Copyright © 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 XCTest
-
-@testable
-import CoreStore
-
-class CoreStoreTests: XCTestCase {
-    
-    override func setUp() {
-        
-        super.setUp()
-        self.deleteStores()
-    }
-    
-    override func tearDown() {
-        
-        self.deleteStores()
-        super.tearDown()
-    }
-    
-    func testMigrationChains() {
-        
-        let emptyChain: MigrationChain = nil
-        XCTAssertTrue(emptyChain.valid, "emptyChain.valid")
-        XCTAssertTrue(emptyChain.empty, "emptyChain.empty")
-        
-        let normalChain: MigrationChain = "version1"
-        XCTAssertTrue(normalChain.valid, "normalChain.valid")
-        XCTAssertTrue(normalChain.empty, "normalChain.empty")
-        
-        let linearChain: MigrationChain = ["version1", "version2", "version3", "version4"]
-        XCTAssertTrue(linearChain.valid, "linearChain.valid")
-        XCTAssertFalse(linearChain.empty, "linearChain.empty")
-        
-        let treeChain: MigrationChain = [
-            "version1": "version4",
-            "version2": "version3",
-            "version3": "version4"
-        ]
-        XCTAssertTrue(treeChain.valid, "treeChain.valid")
-        XCTAssertFalse(treeChain.empty, "treeChain.empty")
-
-        // The cases below will trigger assertion failures internally
-        
-//        let linearLoopChain: MigrationChain = ["version1", "version2", "version1", "version3", "version4"]
-//        XCTAssertFalse(linearLoopChain.valid, "linearLoopChain.valid")
-//        
-//        let treeAmbiguousChain: MigrationChain = [
-//            "version1": "version4",
-//            "version2": "version3",
-//            "version1": "version2",
-//            "version3": "version4"
-//        ]
-//        XCTAssertFalse(treeAmbiguousChain.valid, "treeAmbiguousChain.valid")
-    }
-    
-    func testExample() {
-        
-        let stack = DataStack(modelName: "Model", bundle: NSBundle(forClass: self.dynamicType))
-        CoreStore.defaultStack = stack
-        XCTAssert(CoreStore.defaultStack === stack, "CoreStore.defaultStack === stack")
-        
-        do {
-            
-            try stack.addSQLiteStoreAndWait(fileName: "ConfigStore1.sqlite", configuration: "Config1", resetStoreOnModelMismatch: true)
-        }
-        catch let error as NSError {
-            
-            XCTFail(error.description)
-        }
-        
-        do {
-            
-            try stack.addSQLiteStoreAndWait(fileName: "ConfigStore2.sqlite", configuration: "Config2", resetStoreOnModelMismatch: true)
-        }
-        catch let error as NSError {
-            
-            XCTFail(error.description)
-        }
-        
-        let unsafeTransaction = CoreStore.beginUnsafe()
-        
-        let createExpectation = self.expectationWithDescription("Entity creation")
-        CoreStore.beginAsynchronous { (transaction) -> Void in
-        
-            let obj1 = transaction.create(Into(TestEntity1))
-            obj1.testEntityID = 1
-            obj1.testString = "lololol"
-            obj1.testNumber = 42
-            obj1.testDate = NSDate()
-            
-            let count = transaction.queryValue(
-                From<TestEntity1>(),
-                Select<Int>(.Count("testNumber"))
-            )
-            XCTAssertTrue(count == 0, "count == 0 (actual: \(count))") // counts only objects in store
-            
-            let obj2 = transaction.create(Into<TestEntity2>())
-            obj2.testEntityID = 2
-            obj2.testString = "hahaha"
-            obj2.testNumber = 100
-            obj2.testDate = NSDate()
-            
-            let obj3 = transaction.create(Into<TestEntity2>("Config2"))
-            obj3.testEntityID = 3
-            obj3.testString = "hahaha"
-            obj3.testNumber = 90
-            obj3.testDate = NSDate()
-            
-            let obj4 = transaction.create(Into(TestEntity2.self, "Config2"))
-            obj4.testEntityID = 5
-            obj4.testString = "hohoho"
-            obj4.testNumber = 80
-            obj4.testDate = NSDate()
-            
-        
-            transaction.beginSynchronous { (transaction) -> Void in
-                
-                let obj4 = transaction.create(Into<TestEntity2>())
-                obj4.testEntityID = 4
-                obj4.testString = "hehehehe"
-                obj4.testNumber = 80
-                obj4.testDate = NSDate()
-                
-                let objs4test = transaction.fetchOne(
-                    From<TestEntity2>("Config2"),
-                    Where("testEntityID", isEqualTo: 4),
-                    Tweak { (fetchRequest) -> Void in
-                        
-                        fetchRequest.includesPendingChanges = true
-                    }
-                )
-                XCTAssertNotNil(objs4test, "objs4test != nil")
-                
-                let objs5test = transaction.fetchOne(
-                    From(TestEntity2),
-                    Where("testEntityID", isEqualTo: 4),
-                    Tweak { (fetchRequest) -> Void in
-                        
-                        fetchRequest.includesPendingChanges = false
-                    }
-                )
-                XCTAssertNil(objs5test, "objs5test == nil")
-                
-                // Dont commit1
-            }
-            
-            transaction.commit { (result) -> Void in
-                
-                let objs4test = CoreStore.fetchOne(
-                    From(TestEntity2),
-                    Where("testEntityID", isEqualTo: 4),
-                    Tweak { (fetchRequest) -> Void in
-                        
-                        fetchRequest.includesPendingChanges = false
-                    }
-                )
-                XCTAssertNil(objs4test, "objs4test == nil")
-                
-                let objs5test = unsafeTransaction.fetchCount(From(TestEntity2))
-                XCTAssertTrue(objs5test == 3, "objs5test == 3")
-                
-                XCTAssertTrue(NSThread.isMainThread(), "NSThread.isMainThread()")
-                switch result {
-                    
-                case .Success(let hasChanges):
-                    XCTAssertTrue(hasChanges, "hasChanges == true")
-                    createExpectation.fulfill()
-                    
-                case .Failure(let error):
-                    XCTFail(error.description)
-                }
-            }
-        }
-        
-        let queryExpectation = self.expectationWithDescription("Query creation")
-        CoreStore.beginAsynchronous { (transaction) -> Void in
-            
-            let obj1 = transaction.fetchOne(From(TestEntity1))
-            XCTAssertNotNil(obj1, "obj1 != nil")
-            
-            var orderBy = OrderBy(.Ascending("testEntityID"))
-            orderBy += OrderBy(.Descending("testString"))
-            let objs2 = transaction.fetchAll(
-                From(TestEntity2),
-                Where("testNumber", isEqualTo: 100) || Where("%K == %@", "testNumber", 90),
-                orderBy,
-                Tweak { (fetchRequest) -> Void in
-                    
-                    fetchRequest.includesPendingChanges = true
-                }
-            )
-            XCTAssertNotNil(objs2, "objs2 != nil")
-            XCTAssertTrue(objs2?.count == 2, "objs2?.count == 2")
-            
-            transaction.commit { (result) -> Void in
-                
-                let counts = CoreStore.queryAttributes(
-                    From(TestEntity2),
-                    Select("testString", .Count("testString", As: "count")),
-                    GroupBy("testString")
-                )
-                print(counts)
-                
-                XCTAssertTrue(NSThread.isMainThread(), "NSThread.isMainThread()")
-                switch result {
-                    
-                case .Success(let hasChanges):
-                    XCTAssertFalse(hasChanges, "hasChanges == false")
-                    queryExpectation.fulfill()
-                    
-                case .Failure(let error):
-                    XCTFail(error.description)
-                }
-            }
-        }
-        
-        self.waitForExpectationsWithTimeout(100, handler: nil)
-        
-        let max1 = CoreStore.queryValue(
-            From(TestEntity2),
-            Select<Int>(.Maximum("testNumber"))
-        )
-        XCTAssertTrue(max1 == 100, "max == 100 (actual: \(max1))")
-        
-        let max2 = CoreStore.queryValue(
-            From(TestEntity2),
-            Select<NSNumber>(.Maximum("testNumber")),
-            Where("%K > %@", "testEntityID", 2)
-        )
-        XCTAssertTrue(max2 == 90, "max == 90 (actual: \(max2))")
-        
-        CoreStore.beginSynchronous { (transaction) -> Void in
-            
-            let numberOfDeletedObjects1 = transaction.deleteAll(From(TestEntity1))
-            XCTAssertTrue(numberOfDeletedObjects1 == 1, "numberOfDeletedObjects1 == 1 (actual: \(numberOfDeletedObjects1))")
-            
-            let numberOfDeletedObjects2 = transaction.deleteAll(
-                From(TestEntity2),
-                Where("%K > %@", "testEntityID", 2)
-            )
-            XCTAssertTrue(numberOfDeletedObjects2 == 2, "numberOfDeletedObjects2 == 2 (actual: \(numberOfDeletedObjects2))")
-            
-            transaction.commitAndWait()
-        }
-        
-        CoreStore.beginSynchronous({ (transaction) -> Void in
-            
-            if let obj = CoreStore.fetchOne(From(TestEntity2)) {
-                
-                let oldID = obj.testEntityID
-                obj.testEntityID = 0
-                obj.testEntityID = oldID
-            }
-            
-            transaction.commitAndWait()
-        })
-        
-        let objs1 = CoreStore.fetchAll(From(TestEntity1))
-        XCTAssertNotNil(objs1, "objs1 != nil")
-        XCTAssertTrue(objs1?.count == 0, "objs1?.count == 0")
-        
-        let objs2 = CoreStore.fetchAll(From(TestEntity2))
-        XCTAssertNotNil(objs2, "objs2 != nil")
-        XCTAssertTrue(objs2?.count == 1, "objs2?.count == 1")
-        
-        let unsafeExpectation = self.expectationWithDescription("Query creation")
-        
-        let obj5 = unsafeTransaction.create(Into<TestEntity1>("Config1"))
-        obj5.testEntityID = 5
-        obj5.testString = "hihihi"
-        obj5.testNumber = 70
-        obj5.testDate = NSDate()
-        XCTAssert(unsafeTransaction === obj5.unsafeDataTransaction, "unsafeTransaction === obj5.unsafeDataTransaction")
-        
-        unsafeTransaction.commit { (result) -> Void in
-            
-            XCTAssertTrue(NSThread.isMainThread(), "NSThread.isMainThread()")
-            switch result {
-                
-            case .Success(let hasChanges):
-                XCTAssertTrue(hasChanges, "hasChanges == true")
-                
-                CoreStore.beginSynchronous { (transaction) -> Void in
-                    
-                    let obj5Copy1 = transaction.edit(obj5)
-                    XCTAssertTrue(obj5.objectID == obj5Copy1?.objectID, "obj5.objectID == obj5Copy1?.objectID")
-                    XCTAssertFalse(obj5 == obj5Copy1, "obj5 == obj5Copy1")
-                    XCTAssertNil(obj5Copy1?.unsafeDataTransaction)
-                    
-                    let obj5Copy2 = transaction.edit(Into(TestEntity1), obj5.objectID)
-                    XCTAssertTrue(obj5.objectID == obj5Copy2?.objectID, "obj5.objectID == obj5Copy2?.objectID")
-                    XCTAssertFalse(obj5 == obj5Copy2, "obj5 == obj5Copy2")
-                }
-                
-                let count: Int? = CoreStore.queryValue(
-                    From(TestEntity1),
-                    Select(.Count("testNumber"))
-                )
-                XCTAssertTrue(count == 1, "count == 1 (actual: \(count))")
-                
-                let obj6 = unsafeTransaction.create(Into<TestEntity1>())
-                obj6.testEntityID = 6
-                obj6.testString = "huehuehue"
-                obj6.testNumber = 130
-                obj6.testDate = NSDate()
-                XCTAssert(unsafeTransaction === obj6.unsafeDataTransaction, "unsafeTransaction === obj6.unsafeDataTransaction")
-                
-                unsafeTransaction.commit { (result) -> Void in
-                    
-                    XCTAssertTrue(NSThread.isMainThread(), "NSThread.isMainThread()")
-                    switch result {
-                        
-                    case .Success(let hasChanges):
-                        XCTAssertTrue(hasChanges, "hasChanges == true")
-                        
-                        let count = CoreStore.queryValue(
-                            From(TestEntity1),
-                            Select<Int>(.Count("testNumber"))
-                        )
-                        XCTAssertTrue(count == 2, "count == 2 (actual: \(count))")
-                        
-                        
-                        CoreStore.beginSynchronous { (transaction) -> Void in
-                            
-                            let obj6 = transaction.edit(obj6)
-                            let obj5 = transaction.edit(obj5)
-                            transaction.delete(obj5, obj6)
-                            
-                            transaction.commitAndWait()
-                        }
-                        
-                        let count2 = CoreStore.queryValue(
-                            From(TestEntity1),
-                            Select<Int>(.Count("testNumber"))
-                        )
-                        XCTAssertTrue(count2 == 0, "count == 0 (actual: \(count2))")
-                        
-                        unsafeExpectation.fulfill()
-                        
-                    case .Failure(let error):
-                        XCTFail(error.description)
-                    }
-                }
-                
-            case .Failure(let error):
-                XCTFail(error.description)
-            }
-        }
-        
-        self.waitForExpectationsWithTimeout(100, handler: nil)
-    }
-    
-    private func deleteStores() {
-        
-        do {
-            
-            let fileManager = NSFileManager.defaultManager()
-            try fileManager.removeItemAtURL(
-                fileManager.URLsForDirectory(deviceDirectorySearchPath, inDomains: .UserDomainMask).first!
-            )
-        }
-        catch _ { }
-    }
-}

CoreStoreTests/DynamicModelTests.swift

@@ -0,0 +1,548 @@
+//
+//  DynamicModelTests.swift
+//  CoreStore
+//
+//  Copyright © 2018 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 XCTest
+
+@testable
+import CoreStore
+
+#if os(macOS)
+    typealias Color = NSColor
+
+#else
+    typealias Color = UIColor
+
+#endif
+
+class Animal: CoreStoreObject {
+
+    @Field.Stored("species")
+    var species: String = "Swift"
+
+    @Field.Coded("color", coder: FieldCoders.NSCoding.self)
+    var color: Color? = .blue
+
+    @Field.Relationship("master")
+    var master: Person?
+}
+
+class Dog: Animal {
+    
+    static let commonNicknames = ["Spot", "Benjie", "Max", "Milo"]
+
+    @Field.Stored(
+        "nickname",
+        dynamicInitialValue: {
+            commonNicknames.randomElement()!
+        }
+    )
+    var nickname: String
+
+    @Field.Stored("age")
+    var age: Int = 1
+
+    @Field.Relationship("friends")
+    var friends: [Dog]
+
+    @Field.Relationship("friendedBy", inverse: \.$friends)
+    var friendedBy: Set<Dog>
+}
+
+struct CustomType {
+    var string = "customString"
+}
+
+enum Job: String, CaseIterable {
+
+    case unemployed
+    case engineer
+    case doctor
+    case lawyer
+
+    init?(data: Data) {
+
+        guard
+            let rawValue = String(data: data, encoding: .utf8),
+            let value = Self.init(rawValue: rawValue)
+            else {
+
+            return nil
+        }
+        self = value
+    }
+
+    func toData() -> Data {
+
+        return Data(self.rawValue.utf8)
+    }
+}
+
+class Person: CoreStoreObject {
+
+    @Field.Stored(
+        "title",
+        customSetter: { (object, field, newValue) in
+            field.primitiveValue = newValue
+            object.$displayName.primitiveValue = nil
+        }
+    )
+    var title: String = "Mr."
+
+    @Field.Stored(
+        "name",
+        customSetter: { (object, field, newValue) in
+            field.primitiveValue = newValue
+            object.$displayName.primitiveValue = nil
+        }
+    )
+    var name: String = ""
+
+    @Field.Virtual(
+        "displayName",
+        customGetter: Person.getDisplayName(_:_:),
+        affectedByKeyPaths: Person.keyPathsAffectingDisplayName()
+    )
+    var displayName: String?
+
+    @Field.Virtual(
+        "customType",
+        customGetter: { (object, field) in
+
+            if let value = field.primitiveValue {
+
+                return value
+            }
+            let value = CustomType()
+            field.primitiveValue = value
+            return value
+        }
+    )
+    var customField: CustomType
+
+    @Field.Coded(
+        "job",
+        coder: (
+            encode: { $0.toData() },
+            decode: { $0.flatMap(Job.init(data:)) ?? .unemployed }
+        ),
+        dynamicInitialValue: {
+            Job.allCases.randomElement()!
+        }
+    )
+    var job: Job
+
+    @Field.Relationship("spouse")
+    var spouse: Person?
+
+    @Field.Relationship("pets", inverse: \.$master)
+    var pets: Set<Animal>
+
+    @Field.Relationship("_spouseInverse", inverse: \.$spouse)
+    private var spouseInverse: Person?
+    
+    private static func getDisplayName(_ object: ObjectProxy<Person>, _ field: ObjectProxy<Person>.FieldProxy<String?>) -> String? {
+
+        if let value = field.primitiveValue {
+
+            return value
+        }
+        let title = object.$title.value
+        let name = object.$name.value
+        let value = "\(title) \(name)"
+        field.primitiveValue = value
+        return value
+    }
+    
+    private static func keyPathsAffectingDisplayName() -> Set<String> {
+        
+        return [
+            String(keyPath: \Person.$title),
+            String(keyPath: \Person.$name)
+        ]
+    }
+}
+
+
+// MARK: - DynamicModelTests
+
+class DynamicModelTests: BaseTestDataTestCase {
+    
+    @objc
+    dynamic func test_ThatDynamicModels_CanBeDeclaredCorrectly() {
+        
+        let dataStack = DataStack(
+            CoreStoreSchema(
+                modelVersion: "V1",
+                entities: [
+                    Entity<Animal>("Animal"),
+                    Entity<Dog>("Dog"),
+                    Entity<Person>("Person")
+                ],
+                versionLock: [
+                    "Animal": [0x1b59d511019695cf, 0xdeb97e86c5eff179, 0x1cfd80745646cb3, 0x4ff99416175b5b9a],
+                    "Dog": [0xad6de93adc5565d, 0x7897e51253eba5a3, 0xd12b9ce0b13600f3, 0x5a4827cd794cd15e],
+                    "Person": [0xf3e6ba6016bbedc6, 0x50dedf64f0eba490, 0xa32088a0ee83468d, 0xb72d1d0b37bd0992]
+                ]
+            )
+        )
+        self.prepareStack(dataStack, configurations: [nil]) { (stack) in
+            
+            let k1 = String(keyPath: \Animal.$species)
+            XCTAssertEqual(k1, "species")
+
+            let k2 = String(keyPath: \Dog.$species)
+            XCTAssertEqual(k2, "species")
+            
+            let k3 = String(keyPath: \Dog.$nickname)
+            XCTAssertEqual(k3, "nickname")
+            
+            let updateDone = self.expectation(description: "update-done")
+            let fetchDone = self.expectation(description: "fetch-done")
+            let willSetPriorObserverDone = self.expectation(description: "willSet-observe-prior-done")
+            let willSetNotPriorObserverDone = self.expectation(description: "willSet-observe-notPrior-done")
+            let didSetObserverDone = self.expectation(description: "didSet-observe-done")
+            stack.perform(
+                asynchronous: { (transaction) in
+                    
+                    let animal = transaction.create(Into<Animal>())
+                    XCTAssertEqual(animal.species, "Swift")
+                    XCTAssertTrue(type(of: animal.species) == String.self)
+                    XCTAssertEqual(animal.color, Color.blue)
+                    
+                    animal.species = "Sparrow"
+                    XCTAssertEqual(animal.species, "Sparrow")
+                    
+                    animal.color = .yellow
+                    XCTAssertEqual(animal.color, Color.yellow)
+
+                    for property in Animal.metaProperties(includeSuperclasses: true) {
+
+                        switch property.keyPath {
+
+                        case String(keyPath: \Animal.$species):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Stored<String>)
+
+                        case String(keyPath: \Animal.$master):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Relationship<Person?>)
+
+                        case String(keyPath: \Animal.$color):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Coded<Color?>)
+
+                        default:
+                            XCTFail("Unknown KeyPath: \"\(property.keyPath)\"")
+                        }
+                    }
+                    
+                    let dog = transaction.create(Into<Dog>())
+                    XCTAssertEqual(dog.species, "Swift")
+                    XCTAssertEqual(dog.age, 1)
+                    XCTAssertTrue(Dog.commonNicknames.contains(dog.nickname))
+
+                    for property in Dog.metaProperties(includeSuperclasses: true) {
+
+                        switch property.keyPath {
+
+                        case String(keyPath: \Dog.$species):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Stored<String>)
+
+                        case String(keyPath: \Dog.$master):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Relationship<Person?>)
+
+                        case String(keyPath: \Dog.$color):
+                            XCTAssertTrue(property is FieldContainer<Animal>.Coded<Color?>)
+
+                        case String(keyPath: \Dog.$nickname):
+                            XCTAssertTrue(property is FieldContainer<Dog>.Stored<String>)
+
+                        case String(keyPath: \Dog.$age):
+                            XCTAssertTrue(property is FieldContainer<Dog>.Stored<Int>)
+
+                        case String(keyPath: \Dog.$friends):
+                            XCTAssertTrue(property is FieldContainer<Dog>.Relationship<[Dog]>)
+
+                        case String(keyPath: \Dog.$friendedBy):
+                            XCTAssertTrue(property is FieldContainer<Dog>.Relationship<Set<Dog>>)
+
+                        default:
+                            XCTFail("Unknown KeyPath: \"\(property.keyPath)\"")
+                        }
+                    }
+
+//                    #if swift(>=5.1)
+//
+//                    let dogKeyPathBuilder = Dog.keyPathBuilder()
+//                    XCTAssertEqual(dogKeyPathBuilder.species.keyPathString, "SELF.species")
+//                    XCTAssertEqual(dogKeyPathBuilder.master.title.keyPathString, "SELF.master.title")
+//                    let a = dogKeyPathBuilder.master
+//                    let b = dogKeyPathBuilder.master.spouse
+//                    let c = dogKeyPathBuilder.master.spouse.pets
+//                    let d = dogKeyPathBuilder.master.spouse.pets.color
+//                    XCTAssertEqual(dogKeyPathBuilder.master.spouse.pets.color.keyPathString, "SELF.master.spouse.pets.color")
+//
+//                    #endif
+
+                    let didSetObserver = dog.observe(\.$species, options: [.new, .old]) { (object, change) in
+
+                        XCTAssertEqual(object, dog)
+                        XCTAssertEqual(change.kind, .setting)
+                        XCTAssertEqual(change.newValue, "Dog")
+                        XCTAssertEqual(change.oldValue, "Swift")
+                        XCTAssertFalse(change.isPrior)
+                        XCTAssertEqual(object.species, "Dog")
+                        didSetObserverDone.fulfill()
+                    }
+                    let willSetObserver = dog.observe(\.$species, options: [.new, .old, .prior]) { (object, change) in
+
+                        XCTAssertEqual(object, dog)
+                        XCTAssertEqual(change.kind, .setting)
+                        XCTAssertEqual(change.oldValue, "Swift")
+
+                        if change.isPrior {
+
+                            XCTAssertNil(change.newValue)
+                            XCTAssertEqual(object.species, "Swift")
+                            willSetPriorObserverDone.fulfill()
+                        }
+                        else {
+
+                            XCTAssertEqual(change.newValue, "Dog")
+                            XCTAssertEqual(object.species, "Dog")
+                            willSetNotPriorObserverDone.fulfill()
+                        }
+                    }
+                    
+                    dog.species = "Dog"
+                    XCTAssertEqual(dog.species, "Dog")
+
+                    didSetObserver.invalidate()
+                    willSetObserver.invalidate()
+                    
+                    dog.nickname = "Spot"
+                    XCTAssertEqual(dog.nickname, "Spot")
+                    
+                    let person = transaction.create(Into<Person>())
+                    XCTAssertTrue(person.pets.isEmpty)
+                    XCTAssertEqual(person.customField.string, "customString")
+                    let initialJob = person.job
+                    XCTAssertTrue(Job.allCases.contains(initialJob))
+                    
+                    XCTAssertEqual(
+                        person.rawObject!
+                            .runtimeType()
+                            .keyPathsForValuesAffectingValue(forKey: "displayName"),
+                        ["title", "name"]
+                    )
+                    
+                    person.name = "Joe"
+                    
+                    XCTAssertEqual(person.rawObject!.value(forKey: "name") as! String?, "Joe")
+                    XCTAssertEqual(person.rawObject!.value(forKey: "displayName") as! String?, "Mr. Joe")
+                    
+                    person.rawObject!.setValue("AAAA", forKey: "displayName")
+                    XCTAssertEqual(person.rawObject!.value(forKey: "displayName") as! String?, "AAAA")
+                    
+                    person.name = "John"
+                    XCTAssertEqual(person.name, "John")
+                    XCTAssertEqual(person.displayName, "Mr. John") // Custom getter
+                    
+                    let personSnapshot1 = person.asSnapshot(in: transaction)!
+                    XCTAssertEqual(person.name, personSnapshot1.$name)
+                    XCTAssertEqual(person.title, personSnapshot1.$title)
+                    XCTAssertEqual(person.displayName, personSnapshot1.$displayName)
+                    XCTAssertEqual(person.job, personSnapshot1.$job)
+                    
+                    person.title = "Sir"
+                    XCTAssertEqual(person.displayName, "Sir John")
+                    
+                    XCTAssertEqual(personSnapshot1.$name, "John")
+                    XCTAssertEqual(personSnapshot1.$title, "Mr.")
+                    XCTAssertEqual(personSnapshot1.$displayName, "Mr. John")
+
+                    person.customField.string = "newCustomString"
+                    XCTAssertEqual(person.customField.string, "newCustomString")
+
+                    person.job = .engineer
+                    XCTAssertEqual(person.job, .engineer)
+                    
+                    let personSnapshot2 = person.asSnapshot(in: transaction)!
+                    XCTAssertEqual(person.name, personSnapshot2.$name)
+                    XCTAssertEqual(person.title, personSnapshot2.$title)
+                    XCTAssertEqual(person.displayName, personSnapshot2.$displayName)
+                    XCTAssertEqual(person.job, personSnapshot2.$job)
+
+                    var personSnapshot3 = personSnapshot2
+                    personSnapshot3.$name = "James"
+                    XCTAssertEqual(personSnapshot1.$name, "John")
+                    XCTAssertEqual(personSnapshot1.$displayName, "Mr. John")
+                    XCTAssertEqual(personSnapshot1.$job, initialJob)
+                    XCTAssertEqual(personSnapshot2.$name, "John")
+                    XCTAssertEqual(personSnapshot2.$displayName, "Sir John")
+                    XCTAssertEqual(personSnapshot2.$job, .engineer)
+                    XCTAssertEqual(personSnapshot3.$name, "James")
+                    XCTAssertEqual(personSnapshot3.$displayName, "Sir John")
+                    XCTAssertEqual(personSnapshot3.$job, .engineer)
+                    
+
+                    
+                    person.pets.insert(dog)
+                    XCTAssertEqual(person.pets.count, 1)
+                    XCTAssertEqual(person.pets.first, dog)
+                    XCTAssertEqual(person.pets.first?.master, person)
+                    XCTAssertEqual(dog.master, person)
+                    XCTAssertEqual(dog.master?.pets.first, dog)
+                },
+                success: { _ in
+
+                    let person = try! stack.fetchOne(From<Person>())
+                    XCTAssertNotNil(person)
+
+                    let personPublisher = person!.asPublisher(in: stack)
+                    XCTAssertEqual(personPublisher.$name, "John")
+                    XCTAssertEqual(personPublisher.$displayName, "Sir John")
+                    XCTAssertEqual(personPublisher.$job, .engineer)
+
+                    updateDone.fulfill()
+                },
+                failure: { _ in
+                    
+                    XCTFail()
+                }
+            )
+            stack.perform(
+                asynchronous: { (transaction) in
+                    
+                    let p1 = Where<Animal>({ $0.$species == "Sparrow" })
+                    XCTAssertEqual(p1.predicate, NSPredicate(format: "%K == %@", "species", "Sparrow"))
+                    
+                    let bird = try transaction.fetchOne(From<Animal>(), p1)
+                    XCTAssertNotNil(bird)
+                    XCTAssertEqual(bird!.species, "Sparrow")
+                    XCTAssertEqual(bird!.color, Color.yellow)
+                    
+                    let p2 = Where<Dog>({ $0.$nickname == "Spot" })
+                    XCTAssertEqual(p2.predicate, NSPredicate(format: "%K == %@", "nickname", "Spot"))
+                    
+                    let dog = try transaction.fetchOne(From<Dog>().where(\.$nickname == "Spot"))
+                    XCTAssertNotNil(dog)
+                    XCTAssertEqual(dog!.nickname, "Spot")
+                    XCTAssertEqual(dog!.species, "Dog")
+                    
+                    let person = try transaction.fetchOne(From<Person>())
+                    XCTAssertNotNil(person)
+                    XCTAssertEqual(person!.name, "John")
+                    XCTAssertEqual(person!.title, "Sir")
+                    XCTAssertEqual(person!.displayName, "Sir John")
+                    XCTAssertEqual(person!.customField.string, "customString")
+                    XCTAssertEqual(person!.job, .engineer)
+                    XCTAssertEqual(person!.pets.first, dog)
+                    
+                    let p3 = Where<Dog>({ $0.$age == 10 })
+                    XCTAssertEqual(p3.predicate, NSPredicate(format: "%K == %d", "age", 10))
+
+                    let totalAge = try transaction.queryValue(
+                        From<Dog>().select(Int.self, .sum(\.$age))
+                    )
+                    XCTAssertEqual(totalAge, 1)
+                    
+                    _ = try transaction.fetchAll(
+                        From<Dog>()
+                            .where(\Animal.$species == "Dog" && \Dog.$age == 10)
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>()
+                            .where(\Dog.$age == 10 && \Animal.$species == "Dog")
+                            .orderBy(.ascending({ $0.$species }))
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>(),
+                        Where<Dog>({ $0.$age > 10 && $0.$age <= 15 })
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>(),
+                        Where<Dog>({ $0.$species == "Dog" && $0.$age == 10 })
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>(),
+                        Where<Dog>({ $0.$age == 10 && $0.$species == "Dog" })
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>(),
+                        Where<Dog>({ $0.$age > 10 && $0.$age <= 15 })
+                    )
+                    _ = try transaction.fetchAll(
+                        From<Dog>(),
+                        (\Dog.$age > 10 && \Dog.$age <= 15)
+                    )
+                },
+                success: { _ in
+            
+                    fetchDone.fulfill()
+                },
+                failure: { _ in
+                    
+                    XCTFail()
+                }
+            )
+        }
+        
+        self.waitForExpectations(timeout: 10, handler: { _ in })
+        
+        self.addTeardownBlock {
+            dataStack.unsafeRemoveAllPersistentStoresAndWait()
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatDynamicModelKeyPaths_CanBeCreated() {
+        
+        XCTAssertEqual(String(keyPath: \Animal.$species), "species")
+        XCTAssertEqual(String(keyPath: \Dog.$species), "species")
+    }
+    
+    @nonobjc
+    func prepareStack(_ dataStack: DataStack, configurations: [ModelConfiguration] = [nil], _ closure: (_ dataStack: DataStack) -> Void) {
+        
+        do {
+            
+            try configurations.forEach { (configuration) in
+                
+                try dataStack.addStorageAndWait(
+                    SQLiteStore(
+                        fileURL: SQLiteStore.defaultRootDirectory
+                            .appendingPathComponent(UUID().uuidString)
+                            .appendingPathComponent("\(Self.self)_\((configuration ?? "-null-")).sqlite"),
+                        configuration: configuration,
+                        localStorageOptions: .recreateStoreOnModelMismatch
+                    )
+                )
+            }
+        }
+        catch let error as NSError {
+            
+            XCTFail(error.coreStoreDumpString)
+        }
+        closure(dataStack)
+    }
+}

CoreStoreTests/ErrorTests.swift

@@ -0,0 +1,175 @@
+//
+//  ErrorTests.swift
+//  CoreStore
+//
+//  Copyright © 2018 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 XCTest
+
+@testable
+import CoreStore
+
+
+// MARK: - ErrorTests
+
+@available(*, deprecated, message: "CoreStore Objective-C API will be removed soon.")
+final class ErrorTests: XCTestCase {
+
+    @objc
+    dynamic func test_ThatUnknownErrors_BridgeCorrectly() {
+        
+        let error = CoreStoreError.unknown
+        XCTAssertEqual((error as NSError).domain, CoreStoreErrorDomain)
+        XCTAssertEqual((error as NSError).code, CoreStoreErrorCode.unknownError.rawValue)
+        
+        let userInfo: NSDictionary = [:]
+        
+        let objcError = error.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError.bridgeToSwift)
+        XCTAssertEqual(objcError.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError.code, CoreStoreErrorCode.unknownError.rawValue)
+        XCTAssertEqual(objcError.userInfo as NSDictionary, userInfo)
+        
+        let objcError2 = objcError.bridgeToSwift.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError2.bridgeToSwift)
+        XCTAssertEqual(objcError2.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError2.code, CoreStoreErrorCode.unknownError.rawValue)
+        XCTAssertEqual(objcError2.userInfo as NSDictionary, userInfo)
+    }
+    
+    @objc
+    dynamic func test_ThatDifferentStorageExistsAtURLErrors_BridgeCorrectly() {
+        
+        let dummyURL = URL(string: "file:///test1/test2.sqlite")!
+        
+        let error = CoreStoreError.differentStorageExistsAtURL(existingPersistentStoreURL: dummyURL)
+        XCTAssertEqual((error as NSError).domain, CoreStoreErrorDomain)
+        XCTAssertEqual((error as NSError).code, CoreStoreErrorCode.differentStorageExistsAtURL.rawValue)
+        
+        let userInfo: NSDictionary = [
+            "existingPersistentStoreURL": dummyURL
+        ]
+        let objcError = error.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError.bridgeToSwift)
+        XCTAssertEqual(objcError.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError.code, CoreStoreErrorCode.differentStorageExistsAtURL.rawValue)
+        XCTAssertEqual(objcError.userInfo as NSDictionary, userInfo)
+        
+        let objcError2 = objcError.bridgeToSwift.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError2.bridgeToSwift)
+        XCTAssertEqual(objcError2.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError2.code, CoreStoreErrorCode.differentStorageExistsAtURL.rawValue)
+        XCTAssertEqual(objcError2.userInfo as NSDictionary, userInfo)
+    }
+    
+    @objc
+    dynamic func test_ThatMappingModelNotFoundErrors_BridgeCorrectly() {
+        
+        let dummyURL = URL(string: "file:///test1/test2.sqlite")!
+        
+        let schemaHistory = SchemaHistory(
+            XcodeDataModelSchema.from(
+                modelName: "Model",
+                bundle: Bundle(for: Self.self)
+            )
+        )
+        let version = "1.0.0"
+        
+        let error = CoreStoreError.mappingModelNotFound(localStoreURL: dummyURL, targetModel: schemaHistory.rawModel, targetModelVersion: version)
+        XCTAssertEqual((error as NSError).domain, CoreStoreErrorDomain)
+        XCTAssertEqual((error as NSError).code, CoreStoreErrorCode.mappingModelNotFound.rawValue)
+        
+        let userInfo: NSDictionary = [
+            "localStoreURL": dummyURL,
+            "targetModel": schemaHistory.rawModel,
+            "targetModelVersion": version
+        ]
+        let objcError = error.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError.bridgeToSwift)
+        XCTAssertEqual(objcError.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError.code, CoreStoreErrorCode.mappingModelNotFound.rawValue)
+        XCTAssertEqual(objcError.userInfo as NSDictionary, userInfo)
+        
+        let objcError2 = objcError.bridgeToSwift.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError2.bridgeToSwift)
+        XCTAssertEqual(objcError2.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError2.code, CoreStoreErrorCode.mappingModelNotFound.rawValue)
+        XCTAssertEqual(objcError2.userInfo as NSDictionary, userInfo)
+    }
+    
+    @objc
+    dynamic func test_ThatProgressiveMigrationRequiredErrors_BridgeCorrectly() {
+        
+        let dummyURL = URL(string: "file:///test1/test2.sqlite")!
+        
+        let error = CoreStoreError.progressiveMigrationRequired(localStoreURL: dummyURL)
+        XCTAssertEqual((error as NSError).domain, CoreStoreErrorDomain)
+        XCTAssertEqual((error as NSError).code, CoreStoreErrorCode.progressiveMigrationRequired.rawValue)
+        
+        let userInfo: NSDictionary = [
+            "localStoreURL": dummyURL
+        ]
+        let objcError = error.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError.bridgeToSwift)
+        XCTAssertEqual(objcError.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError.code, CoreStoreErrorCode.progressiveMigrationRequired.rawValue)
+        XCTAssertEqual(objcError.userInfo as NSDictionary, userInfo)
+        
+        let objcError2 = objcError.bridgeToSwift.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError2.bridgeToSwift)
+        XCTAssertEqual(objcError2.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError2.code, CoreStoreErrorCode.progressiveMigrationRequired.rawValue)
+        XCTAssertEqual(objcError2.userInfo as NSDictionary, userInfo)
+    }
+    
+    @objc
+    dynamic func test_ThatInternalErrorErrors_BridgeCorrectly() {
+        
+        let internalError = NSError(
+            domain: "com.dummy",
+            code: 123,
+            userInfo: [
+                "key1": "value1",
+                "key2": 2,
+                "key3": Date()
+            ]
+        )
+        let error = CoreStoreError(internalError)
+        XCTAssertEqual((error as NSError).domain, CoreStoreErrorDomain)
+        XCTAssertEqual((error as NSError).code, CoreStoreErrorCode.internalError.rawValue)
+        
+        let userInfo: NSDictionary = [
+            "NSError": internalError
+        ]
+        let objcError = error.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError.bridgeToSwift)
+        XCTAssertEqual(objcError.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError.code, CoreStoreErrorCode.internalError.rawValue)
+        XCTAssertEqual(objcError.userInfo as NSDictionary, userInfo)
+        
+        let objcError2 = objcError.bridgeToSwift.bridgeToObjectiveC
+        XCTAssertEqual(error, objcError2.bridgeToSwift)
+        XCTAssertEqual(objcError2.domain, CoreStoreErrorDomain)
+        XCTAssertEqual(objcError2.code, CoreStoreErrorCode.internalError.rawValue)
+        XCTAssertEqual(objcError2.userInfo as NSDictionary, userInfo)
+    }
+}

CoreStoreTests/FromTests.swift

@@ -0,0 +1,418 @@
+//
+//  FromTests.swift
+//  CoreStore
+//
+//  Copyright © 2018 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 XCTest
+
+@testable
+import CoreStore
+
+
+//MARK: - FromTests
+
+final class FromTests: BaseTestCase {
+    
+    @objc
+    dynamic func test_ThatFromClauses_ConfigureCorrectly() {
+        
+        do {
+            
+            let from = From<NSManagedObject>()
+            XCTAssert(from.entityClass === NSManagedObject.self)
+            XCTAssertNil(from.configurations)
+        }
+        do {
+            
+            let from = From<TestEntity1>()
+            XCTAssert(from.entityClass === TestEntity1.self)
+            XCTAssertNil(from.configurations)
+        }
+        do {
+            
+            let from = From<TestEntity1>("Config1")
+            XCTAssert(from.entityClass === TestEntity1.self)
+            XCTAssertEqual(from.configurations?.count, 1)
+            XCTAssertEqual(from.configurations?[0], "Config1")
+        }
+        do {
+            
+            let from = From<TestEntity1>(nil, "Config1")
+            XCTAssert(from.entityClass === TestEntity1.self)
+            XCTAssertEqual(from.configurations?.count, 2)
+            XCTAssertEqual(from.configurations?[0], nil)
+            XCTAssertEqual(from.configurations?[1], "Config1")
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatFromClauses_ApplyToFetchRequestsCorrectlyForDefaultConfigurations() {
+        
+        self.prepareStack { (dataStack) in
+            
+            do {
+                
+                let from = From<TestEntity1>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["PF_DEFAULT_CONFIGURATION_NAME"])
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatFromClauses_ApplyToFetchRequestsCorrectlyForSingleConfigurations() {
+        
+        self.prepareStack(configurations: ["Config1"]) { (dataStack) in
+            
+            do {
+                
+                let from = From<TestEntity1>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config1"])
+            }
+            do {
+
+                let from = From<TestEntity1>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config1"])
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatFromClauses_ApplyToFetchRequestsCorrectlyForDefaultAndCustomConfigurations() {
+        
+        self.prepareStack(configurations: [nil, "Config1"]) { (dataStack) in
+            
+            do {
+                
+                let from = From<TestEntity1>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(Set(affectedConfigurations), ["PF_DEFAULT_CONFIGURATION_NAME", "Config1"] as Set)
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config1"])
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["PF_DEFAULT_CONFIGURATION_NAME"])
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatFromClauses_ApplyToFetchRequestsCorrectlyForMultipleConfigurations() {
+        
+        self.prepareStack(configurations: ["Config1", "Config2"]) { (dataStack) in
+            
+            do {
+                
+                let from = From<TestEntity1>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config1"])
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config1"])
+            }
+            do {
+                
+                let from = From<TestEntity1>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>()
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config2"])
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config1")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                self.expectError(code: .persistentStoreNotFound) {
+                    
+                    try from.applyToFetchRequest(request, context: dataStack.mainContext)
+                }
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertTrue(affectedConfigurations.isEmpty)
+            }
+            do {
+                
+                let from = From<TestEntity2>("Config2")
+                
+                let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+                let storesFound: Void? = try? from.applyToFetchRequest(request, context: dataStack.mainContext)
+                XCTAssertNotNil(storesFound)
+                XCTAssertNotNil(request.entity)
+                XCTAssertNotNil(request.safeAffectedStores())
+                
+                XCTAssert(from.entityClass == NSClassFromString(request.entity!.managedObjectClassName))
+                
+                let affectedConfigurations = request.safeAffectedStores()?.map { $0.configurationName } ?? []
+                XCTAssertEqual(affectedConfigurations, ["Config2"])
+            }
+        }
+    }
+}

CoreStoreTests/GroupByTests.swift

@@ -0,0 +1,81 @@
+//
+//  GroupByTests.swift
+//  CoreStore
+//
+//  Copyright © 2018 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 XCTest
+
+@testable
+import CoreStore
+
+
+//MARK: - GroupByTests
+
+final class GroupByTests: BaseTestCase {
+    
+    @objc
+    dynamic func test_ThatGroupByClauses_ConfigureCorrectly() {
+        
+        do {
+            
+            let groupBy = GroupBy<NSManagedObject>()
+            XCTAssertEqual(groupBy, GroupBy([] as [String]))
+            XCTAssertNotEqual(groupBy, GroupBy("key"))
+            XCTAssertTrue(groupBy.keyPaths.isEmpty)
+        }
+        do {
+            
+            let groupBy = GroupBy<NSManagedObject>("key1")
+            XCTAssertEqual(groupBy, GroupBy("key1"))
+            XCTAssertEqual(groupBy, GroupBy(["key1"]))
+            XCTAssertNotEqual(groupBy, GroupBy("key2"))
+            XCTAssertEqual(groupBy.keyPaths, ["key1"])
+        }
+        do {
+            
+            let groupBy = GroupBy<NSManagedObject>("key1", "key2")
+            XCTAssertEqual(groupBy, GroupBy("key1", "key2"))
+            XCTAssertEqual(groupBy, GroupBy(["key1", "key2"]))
+            XCTAssertNotEqual(groupBy, GroupBy("key2", "key1"))
+            XCTAssertEqual(groupBy.keyPaths, ["key1", "key2"])
+        }
+    }
+    
+    @objc
+    dynamic func test_ThatGroupByClauses_ApplyToFetchRequestsCorrectly() {
+        
+        self.prepareStack { (dataStack) in
+            
+            let groupBy = GroupBy<NSManagedObject>(#keyPath(TestEntity1.testString))
+            
+            let request = Internals.CoreStoreFetchRequest<NSFetchRequestResult>()
+            try From<TestEntity1>().applyToFetchRequest(request, context: dataStack.mainContext)
+            groupBy.applyToFetchRequest(request)
+            
+            XCTAssertNotNil(request.propertiesToGroupBy)
+            
+            let attributes = (request.propertiesToGroupBy ?? []) as! [NSAttributeDescription]
+            XCTAssertEqual(attributes.map { $0.name }, groupBy.keyPaths)
+        }
+    }
+}

CoreStoreTests/Info.plist

@@ -15,7 +15,7 @@
 	<key>CFBundlePackageType</key>
 	<string>BNDL</string>
 	<key>CFBundleShortVersionString</key>
-	<string>1.0</string>
+	<string>6.2.1</string>
 	<key>CFBundleSignature</key>
 	<string>????</string>
 	<key>CFBundleVersion</key>