BookMacster 1.16.3

Author: jerrykrinock

.DS_Store

@@ -0,0 +1,30 @@
+#import <Cocoa/Cocoa.h>
+
+/*
+ @brief    A subclass of NSWindow instance methods which behave appropriately
+in case a process is launched as or is transformed to a background or
+ UI element type (currentType != SSYProcessTyperTypeForeground),
+ 
+ This class was added in BookMacster 1.16.1.
+ */
+@interface SSYBackgroundAwareWindow : NSWindow {
+}
+
+/*
+ @brief    Override which returns NO if the the current process is not a
+ foreground process (currentType != SSYProcessTyperTypeForeground), otherwise
+ invokes super
+ */
+- (BOOL)canBecomeMainWindow ;
+
+/*
+ @brief    Override which returns NO if the the current process is not a
+ foreground process (currentType != SSYProcessTyperTypeForeground), otherwise
+ invokes super
+ */
+- (BOOL)canBecomeKeyWindow ;
+
+
+
+
+@end

SSYBackgroundAwareWindow.h

@@ -0,0 +1,99 @@
+#import "SSYBackgroundAwareWindow.h"
+#import "SSYProcessTyper.h"
+
+@implementation SSYBackgroundAwareWindow
+
+- (BOOL)keepHidden {
+    return ([SSYProcessTyper currentType] != SSYProcessTyperTypeForeground) ;
+}
+
+- (BOOL)canBecomeKeyWindow {
+    if ([self keepHidden]) {
+        return NO ;
+    }
+    return [super canBecomeKeyWindow] ;
+}
+
+- (BOOL)canBecomeMainWindow {
+    if ([self keepHidden]) {
+        return NO ;
+    }
+    return [super canBecomeMainWindow] ;
+}
+
+#if 0
+#warning Experimenting with More Windowlessness
+// I found it not necessary to override these methods, so I didn't.
+// But maybe I didn't find all the corner cases.  Someday, I might?
+
+/*
+ @brief    Override which becomes a no-op if the the current process is not a
+ foreground process (currentType != SSYProcessTyperTypeForeground), otherwise
+ invokes super
+ */
+- (void)displayIfNeeded {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super displayIfNeeded] ;
+}
+
+- (void)display {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super display] ;
+}
+
+- (void)orderFrontRegardless {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super orderFrontRegardless] ;
+}
+
+- (void)orderFront:(id)sender {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super display] ;
+}
+
+- (void)orderBack:(id)sender {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super orderFront:sender] ;
+}
+
+- (void)makeMainWindow {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super makeMainWindow] ;
+}
+
+- (void)makeKeyWindow {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super makeKeyWindow] ;
+}
+
+- (void)makeKeyAndOrderFront:(id)sender {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super makeKeyAndOrderFront:sender] ;
+}
+
+- (void)orderWindow:(NSWindowOrderingMode)orderingMode relativeTo:(NSInteger)otherWindowNumber {
+	if ([self keepHidden]) {
+		return ;
+	}
+	[super orderWindow:orderingMode relativeTo:otherWindowNumber] ;
+}
+
+#endif
+
+@end

SSYBackgroundAwareWindow.m

@@ -1,6 +1,7 @@
 #import "SSYHintableWindow.h"
 #import "SSYHintArrow.h"
 
+
 @implementation SSYHintableWindow
 
 - (void)sendEvent:(NSEvent *)event {
@@ -9,73 +10,4 @@ - (void)sendEvent:(NSEvent *)event {
 }
 
 
-#if 0
-#warning Experimenting : Windowless
-
-- (void)displayIfNeeded {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super displayIfNeeded] ;
-}
-
-
-- (void)display {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super display] ;
-}
-
-- (void)orderFrontRegardless {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super orderFrontRegardless] ;
-}
-
-- (void)orderFront:(id)sender {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super display] ;
-}
-
-- (void)orderBack:(id)sender {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super orderFront:sender] ;
-}
-
-- (void)makeMainWindow {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super makeMainWindow] ;
-}
-
-- (void)makeKeyWindow {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super makeKeyWindow] ;
-}
-
-- (void)makeKeyAndOrderFront:(id)sender {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super makeKeyAndOrderFront:sender] ;
-}
-
-- (void)orderWindow:(NSWindowOrderingMode)orderingMode relativeTo:(NSInteger)otherWindowNumber {
-	if (WINDOWLESS) {
-		return ;
-	}
-	[super orderWindow:orderingMode relativeTo:otherWindowNumber] ;
-}
-
-#endif
-
 @end

SSYHintableWindow.m

@@ -187,7 +187,7 @@ - (NSManagedObject*)freshObject {
 
 	NSManagedObject* object = [NSEntityDescription insertNewObjectForEntityForName:[self entityName]
 															inManagedObjectContext:moc] ;	
-    // Added in BookMacster 1.15.7 to try and find a rare bug
+    // Added in BookMacster 1.16 to try and find a rare bug
     if (![[NSThread currentThread] isMainThread]) {
         NSLog(@"Internal Error 523-0024 %@\n%@",
               [self entityName],

SSYMojo.m

@@ -276,7 +276,13 @@ + (BOOL)migrateIfNeededStoreAtUrl:(NSURL*)url
             [document setFileURL:url] ;
         }
 #endif
-        
+#if MAC_OS_X_VERSION_MAX_ALLOWED > 1060
+        if ([document isInViewingMode]) {
+            [newStoreOptions setObject:[NSNumber numberWithBool:YES]
+                                forKey:NSReadOnlyPersistentStoreOption] ;
+        }
+#endif
+             
         // Do the migration, creating a new file at destempUrl.
 		// Because the Core Data Model Versioning and Data Migration Programming Guide
 		// indicates that this method reads the whole store into memory, and this

SSYPersistentDocumentMultiMigrator.m

@@ -7,6 +7,10 @@
  SDK.  So I did it the correct way now.  For defensive programming,,
  the three values here match the values of the corresponding
  kProcessTransformToForegroundApplication and friends.
+ 
+ I don't know what is the difference between the types "Background" and
+ "UIElement".  I never user the former, only the latter.  I have not been able
+ to find any explanation in Apple documemtation.
  */
 enum SSYProcessTyperType_enum {
 	SSYProcessTyperTypeForeground = 1,
@@ -15,14 +19,13 @@ enum SSYProcessTyperType_enum {
 } ;
 typedef enum SSYProcessTyperType_enum SSYProcessTyperType ;
 
+
 @interface SSYProcessTyper : NSObject {
 
 }
 
 + (SSYProcessTyperType)currentType ;
 
-+ (void)transformToType:(SSYProcessTyperType)type ;
-
 + (void)transformToForeground:(id)sender ;
 
 #if (MAC_OS_X_VERSION_MAX_ALLOWED > 1060)

SSYProcessTyper.h

@@ -1,6 +1,5 @@
 #import "SSYProcessTyper.h"
 
-
 @implementation SSYProcessTyper
 
 /*
@@ -99,7 +98,8 @@ + (void)transformToType:(SSYProcessTyperType)type {
             return ;
         }
     }
-	
+    
+    // Actual Subtance
     ProcessSerialNumber psn = { 0, kCurrentProcess } ;
     OSStatus err ;
     err = TransformProcessType(&psn, [self appleTypeForType:type]) ;

SSYProcessTyper.m

@@ -14,4 +14,26 @@ extern NSString* const SSYSearchFieldDidCancelNotification ;
 	SEL m_cancelButtonAction ;
 }
 
+/*!
+ @brief     Prepends a new string to the receiver's recentSearches array, 
+ deleting any earlier copies
+ 
+ @details   NSSearchField is supposed to "automatically" add new search strings
+ to its recentSearches.  In my experience, it works about 5% of the time and
+ I can't figure out why or not.  This method works 100% of the time.  Invoke
+ it during the action method ("search:", or whatever) of your search field.
+ 
+ This method was added to fix that unreliable behavior in BookMacster 1.16
+ 
+ @param    newString  The new string to be prepended.  OK if it is nil, or
+ empty, or if it matches the current first item in the receiver's recentSearches
+ array.  In these cases, this method has no effect.  The latter case is now for 
+ efficiency, because does a lot of work whenever anything is done to affect
+ the little menu inside of an NSSearchField, including the fact that it makes
+ a copy of its menu from its template.  Originally, it was because I was not
+ aware of this behavior and the more this method had no effect, the less I saw
+ the effect of a bug which was caused by my lack of awareness.
+ */
+- (void)appendToRecentSearches:(NSString*)newString ;
+
 @end

SSYSearchField.h

@@ -39,4 +39,22 @@ - (IBAction)cancelAction:(id)sender {
 									withObject:sender] ;
 }
 
+- (void)appendToRecentSearches:(NSString*)newString {
+    if ([newString length] > 0) {
+        NSMutableArray* recentSearches = [[self recentSearches] mutableCopy] ;
+
+        // In case newString is a re-do of an earlier search,
+        [recentSearches removeObject:newString] ;
+        // Now add newString at the top
+        [recentSearches insertObject:newString
+                             atIndex:0] ;
+
+        if (![[self recentSearches] isEqualToArray:recentSearches]) {
+            [self setRecentSearches:recentSearches] ;
+        }
+        
+        [recentSearches release] ;
+    }
+}
+
 @end

SSYSearchField.m

@@ -44,6 +44,7 @@ typedef enum SSYTaskerErrorCodes_enum SSYTaskerErrorCodes ;
  */
 @interface SSYTasker : NSObject {
     NSObject <SSYTaskerProgressDelegate> * __weak m_delegate ;
+    FILE * restrict m_heartbeatTo ;
 }
 
 @property NSObject <SSYTaskerProgressDelegate> * __weak delegate ;
@@ -57,6 +58,10 @@ typedef enum SSYTaskerErrorCodes_enum SSYTaskerErrorCodes ;
  @param    launchPath  The command to run.  See -[NSTask setLaunchPath:].
  @param    arguments  The arguments passed to the command.  See
  -[NSTask setArguments:].  May be nil.
+ @param    heartbeatTo  Handle to a file to which the ASCII character "H"
+ will be written once every few seconds, if no stdout or stderr has been
+ written in the last few seconds.  Typically, you will pass either stdout
+ or stderr, or NULL if you don't want any heartbeat.
  @param    stdinData  Data to be passed to the command's stdin.  May be nil.
  
  @result   The exit status from running the command, or if a higher level error
@@ -65,6 +70,7 @@ typedef enum SSYTaskerErrorCodes_enum SSYTaskerErrorCodes ;
  */
 - (NSInteger)runCommand:(NSString*)launchPath
               arguments:(NSArray*)arguments
+            heartbeatTo:(FILE* restrict)heartbeatTo
               stdinData:(NSData*)stdinData
               workingIn:(NSString*)workingDirectory ;
 

SSYTasker.h

@@ -9,6 +9,12 @@
 
 NSInteger SSYTaskerMetaErrorCode = 444000 ;
 
+@interface SSYTasker ()
+
+@property (assign) FILE * restrict heartbeatTo ;
+
+@end
+
 @implementation NSFileHandle (CSFileHandleExtensions)
 
 - (NSData*)availableDataError_p:(NSError**)error_p {
@@ -156,12 +162,16 @@ - (void)taskTerminatedNote:(NSNotification*)note {
 }
 
 - (void)kickFromTimer:(NSTimer*)timer {
-    fprintf(stderr, "t") ;
+    FILE * restrict heartbeatTo = [self heartbeatTo] ;
+    if (heartbeatTo != NULL) {
+        fprintf(heartbeatTo, "H") ;
+    }
     [SSYRunLoopTickler tickle] ;
 }
 
 - (NSInteger)runCommand:(NSString*)launchPath
               arguments:(NSArray*)arguments
+            heartbeatTo:(FILE *restrict)heartbeatTo
               stdinData:(NSData*)stdinData
               workingIn:(NSString*)workingDirectory {
     NSInteger errorCode = 0 ;
@@ -171,6 +181,8 @@ - (NSInteger)runCommand:(NSString*)launchPath
     [self setStdoutData:nil] ;
     [self setStderrData:nil] ;
     [self setError:nil] ;
+
+    [self setHeartbeatTo:heartbeatTo] ;
 
     // Create task with given parameters
     NSTask *task = [[NSTask alloc] init] ;