goodbye ObjectiveC

Sources/CSListMonitor.swift

@@ -29,503 +29,201 @@ import CoreData
 
 // MARK: - CSListMonitor
 
-/**
- The `CSListMonitor` serves as the Objective-C bridging type for `ListMonitor<T>`.
- 
- - SeeAlso: `ListMonitor`
- */
+@available(*, unavailable, message: "CoreStore Objective-C is now obsoleted in preparation for Swift concurrency.")
 @objc
 public final class CSListMonitor: NSObject {
     
     // MARK: Public (Accessors)
     
-    /**
-     Returns the object at the given index within the first section. This subscript indexer is typically used for `CSListMonitor`s created without section groupings.
-     
-     - parameter index: the index of the object. Using an index above the valid range will raise an exception.
-     - returns: the `NSManagedObject` at the specified index
-     */
     @objc
     public subscript(index: Int) -> Any {
-        
-        return self.bridgeToSwift[index]
+
+        fatalError()
     }
-    
-    /**
-     Returns the object at the given index, or `nil` if out of bounds. This indexer is typically used for `CSListMonitor`s created without section groupings.
-     
-     - parameter index: the index for the object. Using an index above the valid range will return `nil`.
-     - returns: the `NSManagedObject` at the specified index, or `nil` if out of bounds
-     */
+
     @objc
     public func objectAtSafeIndex(_ index: Int) -> Any? {
-        
-        return self.bridgeToSwift[safeIndex: index]
+
+        fatalError()
     }
-    
-    /**
-     Returns the object at the given `sectionIndex` and `itemIndex`. This indexer is typically used for `CSListMonitor`s created as sectioned lists.
-     
-     - parameter sectionIndex: the section index for the object. Using a `sectionIndex` with an invalid range will raise an exception.
-     - parameter itemIndex: the index for the object within the section. Using an `itemIndex` with an invalid range will raise an exception.
-     - returns: the `NSManagedObject` at the specified section and item index
-     */
+
     @objc
     public func objectAtSectionIndex(_ sectionIndex: Int, itemIndex: Int) -> Any {
-        
-        return self.bridgeToSwift[sectionIndex, itemIndex]
-    }    /**
-     Returns the object at the given section and item index, or `nil` if out of bounds. This indexer is typically used for `CSListMonitor`s created as sectioned lists.
-     
-     - parameter sectionIndex: the section index for the object. Using a `sectionIndex` with an invalid range will return `nil`.
-     - parameter itemIndex: the index for the object within the section. Using an `itemIndex` with an invalid range will return `nil`.
-     - returns: the `NSManagedObject` at the specified section and item index, or `nil` if out of bounds
-     */
+
+        fatalError()
+    }
+
     @objc
     public func objectAtSafeSectionIndex(_ sectionIndex: Int, safeItemIndex itemIndex: Int) -> Any? {
-        
-        return self.bridgeToSwift[safeSectionIndex: sectionIndex, safeItemIndex: itemIndex]
+
+        fatalError()
     }
-    
-    /**
-     Returns the object at the given `NSIndexPath`. This subscript indexer is typically used for `CSListMonitor`s created as sectioned lists.
-     
-     - parameter indexPath: the `NSIndexPath` for the object. Using an `indexPath` with an invalid range will raise an exception.
-     - returns: the `NSManagedObject` at the specified index path
-     */
+
     @objc
     public func objectAtIndexPath(_ indexPath: IndexPath) -> Any {
-        
-        return self.bridgeToSwift[indexPath]
+
+        fatalError()
     }
-    
-    /**
-     Returns the object at the given `NSIndexPath`, or `nil` if out of bounds. This subscript indexer is typically used for `CSListMonitor`s created as sectioned lists.
-     
-     - parameter indexPath: the `NSIndexPath` for the object. Using an `indexPath` with an invalid range will return `nil`.
-     - returns: the `NSManagedObject` at the specified index path, or `nil` if out of bounds
-     */
+
     @objc
     public func objectAtSafeIndexPath(_ indexPath: IndexPath) -> Any? {
-        
-        return self.bridgeToSwift[safeIndexPath: indexPath]
+
+        fatalError()
     }
-    
-    /**
-     Checks if the `CSListMonitor` has at least one object in any section.
-     
-     - returns: `YES` if at least one object in any section exists, `NO` otherwise
-     */
+
     @objc
     public func hasObjects() -> Bool {
-        
-        return self.bridgeToSwift.hasObjects()
+
+        fatalError()
     }
-    
-    /**
-     Checks if the `CSListMonitor` has at least one object the specified section.
-     
-     - parameter section: the section index. Using an index outside the valid range will return `NO`.
-     - returns: `YES` if at least one object in the specified section exists, `NO` otherwise
-     */
+
     @objc
     public func hasObjectsInSection(_ section: Int) -> Bool {
-        
-        return self.bridgeToSwift.hasObjects(in: section)
+
+        fatalError()
     }
-    
-    /**
-     Returns all objects in all sections
-     
-     - returns: all objects in all sections
-     */
+
     @objc
     public func objectsInAllSections() -> [NSManagedObject] {
-        
-        return self.bridgeToSwift.objectsInAllSections()
+
+        fatalError()
     }
-    
-    /**
-     Returns all objects in the specified section
-     
-     - parameter section: the section index. Using an index outside the valid range will raise an exception.
-     - returns: all objects in the specified section
-     */
+
     @objc
     public func objectsInSection(_ section: Int) -> [NSManagedObject] {
-        
-        return self.bridgeToSwift.objects(in: section)
+
+        fatalError()
     }
-    
-    /**
-     Returns all objects in the specified section, or `nil` if out of bounds.
-     
-     - parameter section: the section index. Using an index outside the valid range will return `nil`.
-     - returns: all objects in the specified section, or `nil` if out of bounds
-     */
+
     @objc
     public func objectsInSafeSection(safeSectionIndex section: Int) -> [NSManagedObject]? {
-        
-        return self.bridgeToSwift.objects(safelyIn: section)
+
+        fatalError()
     }
 
-    /**
-     Returns the number of sections
-     
-     - returns: the number of sections
-     */
     @objc
     public func numberOfSections() -> Int {
-        
-        return self.bridgeToSwift.numberOfSections()
-    }
-    
-    /**
-     Returns the number of objects in all sections
-     
-     - returns: the number of objects in all sections
-     */
-    @objc
-    public func numberOfObjects() -> Int {
-        
-        return self.bridgeToSwift.numberOfObjects()
+
+        fatalError()
+    }
+
+    @objc
+    public func numberOfObjects() -> Int {
+
+        fatalError()
     }
 
-    /**
-     Returns the number of objects in the specified section
-     
-     - parameter section: the section index. Using an index outside the valid range will raise an exception.
-     - returns: the number of objects in the specified section
-     */
     @objc
     public func numberOfObjectsInSection(_ section: Int) -> Int {
-        
-        return self.bridgeToSwift.numberOfObjects(in: section)
+
+        fatalError()
     }
-    
-    /**
-     Returns the number of objects in the specified section, or `nil` if out of bounds.
-     
-     - parameter section: the section index. Using an index outside the valid range will return `nil`.
-     - returns: the number of objects in the specified section, or `nil` if out of bounds
-     */
+
     @objc
     public func numberOfObjectsInSafeSection(safeSectionIndex section: Int) -> NSNumber? {
-        
-        return self.bridgeToSwift
-            .numberOfObjects(safelyIn: section)
-            .flatMap { NSNumber(value: $0) }
+
+        fatalError()
     }
-    
-    /**
-     Returns the `NSFetchedResultsSectionInfo` for the specified section
-     
-     - parameter section: the section index. Using an index outside the valid range will raise an exception.
-     - returns: the `NSFetchedResultsSectionInfo` for the specified section
-     */
+
     @objc
     public func sectionInfoAtIndex(_ section: Int) -> NSFetchedResultsSectionInfo {
-        
-        return self.bridgeToSwift.sectionInfo(at: section)
+
+        fatalError()
     }
-    
-    /**
-     Returns the `NSFetchedResultsSectionInfo` for the specified section, or `nil` if out of bounds.
-     
-     - parameter section: the section index. Using an index outside the valid range will return `nil`.
-     - returns: the `NSFetchedResultsSectionInfo` for the specified section, or `nil` if the section index is out of bounds.
-     */
+
     @objc
     public func sectionInfoAtSafeSectionIndex(safeSectionIndex section: Int) -> NSFetchedResultsSectionInfo? {
-        
-        return self.bridgeToSwift.sectionInfo(safelyAt: section)
+
+        fatalError()
     }
-    
-    /**
-     Returns the `NSFetchedResultsSectionInfo`s for all sections
-     
-     - returns: the `NSFetchedResultsSectionInfo`s for all sections
-     */
+
     @objc
     public func sections() -> [NSFetchedResultsSectionInfo] {
-        
-        return self.bridgeToSwift.sections()
+
+        fatalError()
     }
-    
-    /**
-     Returns the target section for a specified "Section Index" title and index.
-     
-     - parameter title: the title of the Section Index
-     - parameter index: the index of the Section Index
-     - returns: the target section for the specified "Section Index" title and index.
-     */
+
     @objc
     public func targetSectionForSectionIndexTitle(title: String, index: Int) -> Int {
-        
-        return self.bridgeToSwift.targetSection(forSectionIndexTitle: title, at: index)
+
+        fatalError()
     }
-    
-    /**
-     Returns the section index titles for all sections
-     
-     - returns: the section index titles for all sections
-     */
+
     @objc
     public func sectionIndexTitles() -> [String] {
-        
-        return self.bridgeToSwift.sectionIndexTitles()
+
+        fatalError()
     }
-    
-    /**
-     Returns the index of the `NSManagedObject` if it exists in the `CSListMonitor`'s fetched objects, or `nil` if not found.
-     
-     - parameter object: the `NSManagedObject` to search the index of
-     - returns: the index of the `NSManagedObject` if it exists in the `CSListMonitor`'s fetched objects, or `nil` if not found.
-     */
+
     @objc
     public func indexOf(_ object: NSManagedObject) -> NSNumber? {
-        
-        return self.bridgeToSwift
-            .index(of: object)
-            .flatMap { NSNumber(value: $0) }
+
+        fatalError()
     }
-    
-    /**
-     Returns the `NSIndexPath` of the `NSManagedObject` if it exists in the `CSListMonitor`'s fetched objects, or `nil` if not found.
-     
-     - parameter object: the `NSManagedObject` to search the index of
-     - returns: the `NSIndexPath` of the `NSManagedObject` if it exists in the `ListMonitor`'s fetched objects, or `nil` if not found.
-     */
+
     @objc
     public func indexPathOf(_ object: NSManagedObject) -> IndexPath? {
-        
-        return self.bridgeToSwift.indexPath(of: object)
+
+        fatalError()
     }
     
     
     // MARK: Public (Observers)
-    
-    /**
-     Registers a `CSListObserver` to be notified when changes to the receiver's list occur.
-     
-     To prevent retain-cycles, `CSListMonitor` 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 `-addListObserver:` multiple times on the same observer is safe, as `CSListMonitor` unregisters previous notifications to the observer before re-registering them.
-     
-     - parameter observer: a `CSListObserver` to send change notifications to
-     */
+
     @objc
     public func addListObserver(_ observer: CSListObserver) {
-        
-        let swift = self.bridgeToSwift
-        swift.unregisterObserver(observer)
-        swift.registerObserver(
-            observer,
-            willChange: { (observer, monitor) in
-                
-                observer.listMonitorWillChange?(monitor.bridgeToObjectiveC)
-            },
-            didChange: { (observer, monitor) in
-                
-                observer.listMonitorDidChange?(monitor.bridgeToObjectiveC)
-            },
-            willRefetch: { (observer, monitor) in
-                
-                observer.listMonitorWillRefetch?(monitor.bridgeToObjectiveC)
-            },
-            didRefetch: { (observer, monitor) in
-                
-                observer.listMonitorDidRefetch?(monitor.bridgeToObjectiveC)
-            }
-        )
+
+        fatalError()
     }
-    
-    /**
-     Registers a `CSListObjectObserver` to be notified when changes to the receiver's list occur.
-     
-     To prevent retain-cycles, `CSListMonitor` 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 `-addListObjectObserver:` multiple times on the same observer is safe, as `ListMonitor` unregisters previous notifications to the observer before re-registering them.
-     
-     - parameter observer: a `CSListObjectObserver` to send change notifications to
-     */
+
     public func addListObjectObserver(_ observer: CSListObjectObserver) {
-        
-        let swift = self.bridgeToSwift
-        swift.unregisterObserver(observer)
-        swift.registerObserver(
-            observer,
-            willChange: { (observer, monitor) in
-                
-                observer.listMonitorWillChange?(monitor.bridgeToObjectiveC)
-            },
-            didChange: { (observer, monitor) in
-                
-                observer.listMonitorDidChange?(monitor.bridgeToObjectiveC)
-            },
-            willRefetch: { (observer, monitor) in
-                
-                observer.listMonitorWillRefetch?(monitor.bridgeToObjectiveC)
-            },
-            didRefetch: { (observer, monitor) in
-                
-                observer.listMonitorDidRefetch?(monitor.bridgeToObjectiveC)
-            }
-        )
-        swift.registerObserver(
-            observer,
-            didInsertObject: { (observer, monitor, object, toIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didInsertObject: object, toIndexPath: toIndexPath)
-            },
-            didDeleteObject: { (observer, monitor, object, fromIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didDeleteObject: object, fromIndexPath: fromIndexPath)
-            },
-            didUpdateObject: { (observer, monitor, object, atIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didUpdateObject: object, atIndexPath: atIndexPath)
-            },
-            didMoveObject: { (observer, monitor, object, fromIndexPath, toIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didMoveObject: object, fromIndexPath: fromIndexPath, toIndexPath: toIndexPath)
-            }
-        )
+
+        fatalError()
     }
-    
-    /**
-     Registers a `CSListSectionObserver` to be notified when changes to the receiver's list occur.
-     
-     To prevent retain-cycles, `CSListMonitor` 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 `-addListSectionObserver:` multiple times on the same observer is safe, as `ListMonitor` unregisters previous notifications to the observer before re-registering them.
-     
-     - parameter observer: a `CSListSectionObserver` to send change notifications to
-     */
+
     @objc
     public func addListSectionObserver(_ observer: CSListSectionObserver) {
-        
-        let swift = self.bridgeToSwift
-        swift.unregisterObserver(observer)
-        swift.registerObserver(
-            observer,
-            willChange: { (observer, monitor) in
-                
-                observer.listMonitorWillChange?(monitor.bridgeToObjectiveC)
-            },
-            didChange: { (observer, monitor) in
-                
-                observer.listMonitorDidChange?(monitor.bridgeToObjectiveC)
-            },
-            willRefetch: { (observer, monitor) in
-                
-                observer.listMonitorWillRefetch?(monitor.bridgeToObjectiveC)
-            },
-            didRefetch: { (observer, monitor) in
-                
-                observer.listMonitorDidRefetch?(monitor.bridgeToObjectiveC)
-            }
-        )
-        swift.registerObserver(
-            observer,
-            didInsertObject: { (observer, monitor, object, toIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didInsertObject: object, toIndexPath: toIndexPath)
-            },
-            didDeleteObject: { (observer, monitor, object, fromIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didDeleteObject: object, fromIndexPath: fromIndexPath)
-            },
-            didUpdateObject: { (observer, monitor, object, atIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didUpdateObject: object, atIndexPath: atIndexPath)
-            },
-            didMoveObject: { (observer, monitor, object, fromIndexPath, toIndexPath) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didMoveObject: object, fromIndexPath: fromIndexPath, toIndexPath: toIndexPath)
-            }
-        )
-        swift.registerObserver(
-            observer,
-            didInsertSection: { (observer, monitor, sectionInfo, toIndex) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didInsertSection: sectionInfo, toSectionIndex: toIndex)
-            },
-            didDeleteSection: { (observer, monitor, sectionInfo, fromIndex) in
-                
-                observer.listMonitor?(monitor.bridgeToObjectiveC, didDeleteSection: sectionInfo, fromSectionIndex: fromIndex)
-            }
-        )
+
+        fatalError()
     }
-    
-    /**
-     Unregisters a `CSListObserver` from receiving notifications for changes to the receiver's list.
-     
-     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: a `CSListObserver` to unregister notifications to
-     */
+
     @objc
     public func removeListObserver(_ observer: CSListObserver) {
-        
-        self.bridgeToSwift.unregisterObserver(observer)
+
+        fatalError()
     }
 
     
     // MARK: Public (Refetching)
-    
-    /**
-     Returns `YES` if a call to `-refetch:` was made to the `CSListMonitor` and is currently waiting for the fetching to complete. Returns `NO` otherwise.
-     */
+
     @objc
     public var isPendingRefetch: Bool {
-        
-        return self.bridgeToSwift.isPendingRefetch
+
+        fatalError()
     }
-    
-    /**
-     Asks the `CSListMonitor` to refetch its objects using the specified series of `CSFetchClause`s. Note that this method does not execute the fetch immediately; the actual fetching will happen after the `NSFetchedResultsController`'s last `controllerDidChangeContent(_:)` notification completes.
-     
-     `refetch(...)` broadcasts `listMonitorWillRefetch(...)` to its observers immediately, and then `listMonitorDidRefetch(...)` after the new fetch request completes.
-     
-     - parameter fetchClauses: a series of `FetchClause` instances for fetching the object list. Accepts `Where`, `OrderBy`, and `Tweak` clauses.
-     - Important: Starting CoreStore 4.0, all `CSFetchClause`s required by the `CSListMonitor` should be provided in the arguments list of `refetch(...)`.
-     */
+
     @objc
     public func refetch(_ fetchClauses: [CSFetchClause]) {
-        
-        self.bridgeToSwift.refetch { (fetchRequest) in
-            
-            fetchClauses.forEach { $0.applyToFetchRequest(fetchRequest) }
-        }
+
+        fatalError()
     }
     
     
     // MARK: NSObject
     
     public override var hash: Int {
-        
-        return self.bridgeToSwift.hashValue
+
+        fatalError()
     }
     
     public override func isEqual(_ object: Any?) -> Bool {
-        
-        guard let object = object as? CSListMonitor else {
-            
-            return false
-        }
-        return self.bridgeToSwift == object.bridgeToSwift
+
+        fatalError()
     }
     
     public override var description: String {
-        
-        return "(\(String(reflecting: Self.self))) \(self.bridgeToSwift.coreStoreDumpString)"
+
+        fatalError()
     }
     
     
@@ -536,33 +234,21 @@ public final class CSListMonitor: NSObject {
     
     @nonobjc
     public required init<T: NSManagedObject>(_ swiftValue: ListMonitor<T>) {
-        
-        self.bridgeToSwift = swiftValue.downcast()
-        super.init()
+
+        fatalError()
     }
 }
 
 
 // MARK: - ListMonitor
 
+@available(*, unavailable, message: "CoreStore Objective-C is now obsoleted in preparation for Swift concurrency.")
 extension ListMonitor where ListMonitor.ObjectType: NSManagedObject {
     
     // MARK: CoreStoreSwiftType
     
     public var bridgeToObjectiveC: CSListMonitor {
-        
-        return CSListMonitor(self)
-    }
-    
-    
-    // MARK: FilePrivate
-    
-    fileprivate func downcast() -> ListMonitor<NSManagedObject> {
-        
-        func noWarnUnsafeBitCast<T, U>(_ x: T, to type: U.Type) -> U {
-            
-            return unsafeBitCast(x, to: type)
-        }
-        return noWarnUnsafeBitCast(self, to: ListMonitor<NSManagedObject>.self)
+
+        fatalError()
     }
 }