feat: Add support to include all pointers with PFQuery.includeAll (#1734)

Author: dplewis

Parse/Parse/Internal/Query/State/PFMutableQueryState.h

@@ -69,6 +69,7 @@
 
 - (void)includeKey:(NSString *)key;
 - (void)includeKeys:(NSArray<NSString *> *)keys;
+- (void)includeAll;
 
 ///--------------------------------------
 #pragma mark - Excludes

Parse/Parse/Internal/Query/State/PFMutableQueryState.m

@@ -166,6 +166,10 @@ - (void)includeKeys:(NSArray<NSString *> *)keys {
     }
 }
 
+- (void)includeAll {
+    [self includeKey:@"*"];
+}
+
 ///--------------------------------------
 #pragma mark - Excludes
 ///--------------------------------------

Parse/Parse/Source/PFQuery.h

@@ -107,6 +107,13 @@ typedef void (^PFQueryArrayResultBlock)(NSArray<PFGenericObject> *_Nullable obje
  */
 - (instancetype)includeKeys:(NSArray<NSString *> *)keys;
 
+/**
+ Make the query include  all `PFObject`s that have a reference.
+
+ @return The same instance of `PFQuery` as the receiver. This allows method chaining.
+ */
+- (instancetype)includeAll;
+
 /**
  Make the query restrict the fields of the returned `PFObject`s to exclude the provided key.
 

Parse/Parse/Source/PFQuery.m

@@ -426,6 +426,12 @@ - (instancetype)includeKeys:(NSArray<NSString *> *)keys {
     return self;
 }
 
+- (instancetype)includeAll {
+    [self checkIfCommandIsRunning];
+    [self.state includeAll];
+    return self;
+}
+
 ///--------------------------------------
 #pragma mark - Exclude
 ///--------------------------------------

Parse/Tests/Unit/QueryStateUnitTests.m

@@ -215,6 +215,14 @@ - (void)testIncludeMultipleKeys {
     XCTAssertEqualObjects(state.includedKeys, includedKeys);
 }
 
+- (void)testIncludeAll {
+    PFMutableQueryState *state = [[PFMutableQueryState alloc] initWithParseClassName:@"Yarr"];
+    [state includeAll];
+
+    NSSet *includedKeys = PF_SET(@"*");
+    XCTAssertEqualObjects(state.includedKeys, includedKeys);
+}
+
 - (void)testExcludeKeys {
     PFMutableQueryState *state = [[PFMutableQueryState alloc] initWithParseClassName:@"Yarr"];
     [state excludeKey:@"a"];