Perform a nullability audit

BlocksKit/Core/NSArray+BlocksKit.h

@@ -7,6 +7,8 @@
 #import <Foundation/Foundation.h>
 #import <CoreGraphics/CGBase.h> // for CGFloat
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSArray.
 
  Both inspired by and resembling Smalltalk syntax, these utilities
@@ -55,7 +57,7 @@
  @return Returns the object, if found, or `nil`.
  @see bk_select:
  */
-- (id)bk_match:(BOOL (^)(id obj))block;
+- (nullable id)bk_match:(BOOL (^)(id obj))block;
 
 /** Loops through an array to find the objects matching the block.
 
@@ -117,7 +119,7 @@
  @param block A block that takes the current sum and the next object to return the new sum.
  @return An accumulated value.
  */
-- (id)bk_reduce:(id)initial withBlock:(id (^)(id sum, id obj))block;
+- (nullable id)bk_reduce:(nullable id)initial withBlock:(__nullable id (^)(__nullable id sum, id obj))block;
 
 /**
  Sometimes we just want to loop an objects list and reduce one property, where
@@ -219,3 +221,5 @@
 - (BOOL)bk_corresponds:(NSArray *)list withBlock:(BOOL (^)(id obj1, id obj2))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSDictionary+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extension for NSDictionary.
 
  Both inspired by and resembling Smalltalk syntax, this utility
@@ -49,7 +51,7 @@
  @param block A BOOL-returning code block for a key/value pair.
  @return The value of the first pair found;
  */
-- (id)bk_match:(BOOL (^)(id key, id obj))block;
+- (nullable id)bk_match:(BOOL (^)(id key, id obj))block;
 
 /** Loops through a dictionary to find the key/value pairs matching the block.
 
@@ -109,3 +111,5 @@
 - (BOOL)bk_all:(BOOL (^)(id key, id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSIndexSet+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSIndexSet.
 
  Both inspired by and resembling Smalltalk syntax, these utilities
@@ -118,3 +120,5 @@
 - (BOOL)bk_none:(BOOL (^)(NSUInteger index))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSInvocation+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** BlocksKit extensions for NSInvocation. */
 @interface NSInvocation (BlocksKit)
 
@@ -32,3 +34,5 @@
 + (NSInvocation *)bk_invocationWithTarget:(id)target block:(void (^)(id target))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMapTable+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 @interface NSMapTable (BlocksKit)
 
 /** Loops through the maptable and executes the given block using each item.
@@ -22,7 +24,7 @@
  @param block A BOOL-returning code block for a key/value pair.
  @return The value of the first pair found;
  */
-- (id)bk_match:(BOOL (^)(id key, id obj))block;
+- (nullable id)bk_match:(BOOL (^)(id key, id obj))block;
 
 /** Loops through a maptable to find the key/value pairs matching the block.
 
@@ -105,3 +107,5 @@
 - (void)bk_performMap:(id (^)(id key, id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMutableArray+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSMutableArray.
 
  These utilities expound upon the BlocksKit additions to the immutable
@@ -49,3 +51,5 @@
 - (void)bk_performMap:(id (^)(id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMutableDictionary+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSMutableDictionary.
 
  These utilities expound upon the BlocksKit additions to the immutable
@@ -45,3 +47,5 @@
 - (void)bk_performMap:(id (^)(id key, id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMutableIndexSet+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSMutableIndexSet.
 
  These utilities expound upon the BlocksKit additions to the immutable
@@ -41,3 +43,5 @@
 
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMutableOrderedSet+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSMutableOrderedSet.
 
  These utilities expound upon the BlocksKit additions to the immutable
@@ -49,3 +51,5 @@
 - (void)bk_performMap:(id (^)(id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSMutableSet+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSMutableSet.
 
  These utilities expound upon the BlocksKit additions to the immutable
@@ -49,3 +51,5 @@
 - (void)bk_performMap:(id (^)(id obj))block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSObject+BKAssociatedObjects.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Objective-C wrapper for 10.6+ associated object API.
 
  In Mac OS X Snow Leopard and iOS 3.0, Apple introduced an addition to the
@@ -37,15 +39,15 @@
  @param value Any object.
  @param key A unique key pointer.
  */
-- (void)bk_associateValue:(id)value withKey:(const void *)key;
+- (void)bk_associateValue:(nullable id)value withKey:(const void *)key;
 
 /** Strongly associates an object with the receiving class.
 
  @see associateValue:withKey:
  @param value Any object.
  @param key A unique key pointer.
  */
-+ (void)bk_associateValue:(id)value withKey:(const void *)key;
++ (void)bk_associateValue:(nullable id)value withKey:(const void *)key;
 
 /** Strongly, thread-safely associates an object with the reciever.
 
@@ -61,15 +63,15 @@
  @param value Any object.
  @param key A unique key pointer.
  */
-- (void)bk_atomicallyAssociateValue:(id)value withKey:(const void *)key;
+- (void)bk_atomicallyAssociateValue:(nullable id)value withKey:(const void *)key;
 
 /** Strongly, thread-safely associates an object with the receiving class.
 
  @see associateValue:withKey:
  @param value Any object.
  @param key A unique key pointer.
  */
-+ (void)bk_atomicallyAssociateValue:(id)value withKey:(const void *)key;
++ (void)bk_atomicallyAssociateValue:(nullable id)value withKey:(const void *)key;
 
 /** Associates a copy of an object with the reciever.
 
@@ -82,15 +84,15 @@
  @param value Any object, pointer, or value.
  @param key A unique key pointer.
  */
-- (void)bk_associateCopyOfValue:(id)value withKey:(const void *)key;
+- (void)bk_associateCopyOfValue:(nullable id)value withKey:(const void *)key;
 
 /** Associates a copy of an object with the receiving class.
 
  @see associateCopyOfValue:withKey:
  @param value Any object, pointer, or value.
  @param key A unique key pointer.
  */
-+ (void)bk_associateCopyOfValue:(id)value withKey:(const void *)key;
++ (void)bk_associateCopyOfValue:(nullable id)value withKey:(const void *)key;
 
 /** Thread-safely associates a copy of an object with the reciever.
 
@@ -104,15 +106,15 @@
  @param value Any object, pointer, or value.
  @param key A unique key pointer.
  */
-- (void)bk_atomicallyAssociateCopyOfValue:(id)value withKey:(const void *)key;
+- (void)bk_atomicallyAssociateCopyOfValue:(nullable id)value withKey:(const void *)key;
 
 /** Thread-safely associates a copy of an object with the receiving class.
 
  @see associateCopyOfValue:withKey:
  @param value Any object, pointer, or value.
  @param key A unique key pointer.
  */
-+ (void)bk_atomicallyAssociateCopyOfValue:(id)value withKey:(const void *)key;
++ (void)bk_atomicallyAssociateCopyOfValue:(nullable id)value withKey:(const void *)key;
 
 /** Weakly associates an object with the reciever.
 
@@ -123,30 +125,30 @@
  @param value Any object.
  @param key A unique key pointer.
  */
-- (void)bk_weaklyAssociateValue:(__autoreleasing id)value withKey:(const void *)key;
+- (void)bk_weaklyAssociateValue:(nullable __autoreleasing id)value withKey:(const void *)key;
 
 /** Weakly associates an object with the receiving class.
 
  @see weaklyAssociateValue:withKey:
  @param value Any object.
  @param key A unique key pointer.
  */
-+ (void)bk_weaklyAssociateValue:(__autoreleasing id)value withKey:(const void *)key;
++ (void)bk_weaklyAssociateValue:(nullable __autoreleasing id)value withKey:(const void *)key;
 
 /** Returns the associated value for a key on the reciever.
 
  @param key A unique key pointer.
  @return The object associated with the key, or `nil` if not found.
  */
-- (id)bk_associatedValueForKey:(const void *)key;
+- (nullable id)bk_associatedValueForKey:(const void *)key;
 
 /** Returns the associated value for a key on the receiving class.
 
  @see associatedValueForKey:
  @param key A unique key pointer.
  @return The object associated with the key, or `nil` if not found.
  */
-+ (id)bk_associatedValueForKey:(const void *)key;
++ (nullable id)bk_associatedValueForKey:(const void *)key;
 
 /** Returns the reciever to a clean state by removing all
  associated objects, releasing them if necessary. */
@@ -157,3 +159,5 @@
 + (void)bk_removeAllAssociatedObjects;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSObject+BKBlockExecution.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block execution on *any* object.
 
  This category overhauls the `performSelector:` utilities on
@@ -119,3 +121,5 @@
 + (void)bk_cancelBlock:(id <NSObject, NSCopying>)block;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSObject+BKBlockObservation.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Blocks wrapper for key-value observation.
 
  In Mac OS X Panther, Apple introduced an API called "key-value
@@ -136,3 +138,5 @@
 - (void)bk_removeAllBlockObservers;
 
 @end
+
+NS_ASSUME_NONNULL_END

BlocksKit/Core/NSOrderedSet+BlocksKit.h

@@ -6,6 +6,8 @@
 #import "BKDefines.h"
 #import <Foundation/Foundation.h>
 
+NS_ASSUME_NONNULL_BEGIN
+
 /** Block extensions for NSOrderedSet.
 
  Both inspired by and resembling Smalltalk syntax, these utilities allow for
@@ -52,7 +54,7 @@
  @return Returns the object, if found, or `nil`.
  @see bk_select:
  */
-- (id)bk_match:(BOOL (^)(id obj))block;
+- (nullable id)bk_match:(BOOL (^)(id obj))block;
 
 /** Loops through an ordered set to find the objects matching the block.
 
@@ -109,7 +111,7 @@
  @param block A block that takes the current sum and the next object to return the new sum.
  @return An accumulated value.
  */
-- (id)bk_reduce:(id)initial withBlock:(id (^)(id sum, id obj))block;
+- (nullable id)bk_reduce:(nullable id)initial withBlock:(__nullable id (^)(__nullable id sum, id obj))block;
 
 /** Loops through an ordered set to find whether any object matches the block.
 
@@ -167,3 +169,5 @@
  */
 - (BOOL)bk_corresponds:(NSOrderedSet *)list withBlock:(BOOL (^)(id obj1, id obj2))block;
 @end
+
+NS_ASSUME_NONNULL_END