Add Group method to Face resource

Author: darmen

src/Resources/Face.php

@@ -174,4 +174,22 @@ public function findSimilarInFaceIdsArray(string $faceId, array $faceIds, int $m
             ])
         );
     }
+
+    /**
+     * Divide candidate faces into groups based on face similarity.
+     *
+     * @param array $faceIds Array of candidate faceId created by Face - Detect
+     * @return array
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function group(array $faceIds): array
+    {
+        return $this->decodeJsonResponse(
+            $this->httpClient->post('group', [
+                'json' => [
+                    'faceIds' => $faceIds
+                ]
+            ])
+        );
+    }
 }

tests/Resources/FaceTest.php

@@ -122,7 +122,7 @@ public function testFindSimilarInLargeFaceListWithDefaultParameters()
                 'largeFaceListId' => 'any_large_face_list_id',
                 'maxNumOfCandidatesReturned' => 20,
                 'mode' => 'matchPerson',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInLargeFaceList('any_face_id', 'any_large_face_list_id');
@@ -139,7 +139,7 @@ public function testFindSimilarInLargeFaceList()
                 'largeFaceListId' => 'any_large_face_list_id',
                 'maxNumOfCandidatesReturned' => 10,
                 'mode' => 'matchFace',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInLargeFaceList('any_face_id', 'any_large_face_list_id', 10, 'matchFace');
@@ -156,7 +156,7 @@ public function testFindSimilarInFaceListWithDefaultParameters()
                 'faceListId' => 'any_face_list_id',
                 'maxNumOfCandidatesReturned' => 20,
                 'mode' => 'matchPerson',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInFaceList('any_face_id', 'any_face_list_id');
@@ -173,7 +173,7 @@ public function testFindSimilarInFaceList()
                 'faceListId' => 'any_face_list_id',
                 'maxNumOfCandidatesReturned' => 10,
                 'mode' => 'matchFace',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInFaceList('any_face_id', 'any_face_list_id', 10, 'matchFace');
@@ -190,7 +190,7 @@ public function testFindSimilarInFaceIdsArrayWithDefaultParameters()
                 'faceIds' => ['any_face_id1', 'any_face_id2'],
                 'maxNumOfCandidatesReturned' => 20,
                 'mode' => 'matchPerson',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInFaceIdsArray('any_face_id', ['any_face_id1', 'any_face_id2']);
@@ -207,9 +207,23 @@ public function testFindSimilarInFaceIdsArray()
                 'faceIds' => ['any_face_id1', 'any_face_id2'],
                 'maxNumOfCandidatesReturned' => 10,
                 'mode' => 'matchFace',
-            ])
+            ], true)
             ->willRespond($this->emptyJsonResponse());
 
         $this->sut->findSimilarInFaceIdsArray('any_face_id', ['any_face_id1', 'any_face_id2'], 10, 'matchFace');
     }
+
+    public function testGroup()
+    {
+        $this->guzzler
+            ->expects($this->once())
+            ->post('group')
+            ->withHeader('Content-Type', 'application/json')
+            ->withJson([
+                'faceIds' => ['any_face_id1', 'any_face_id2'],
+            ], true)
+            ->willRespond($this->emptyJsonResponse());
+
+        $this->sut->group(['any_face_id1', 'any_face_id2']);
+    }
 }