feat: #30 api create folder

Author: shaunthegeek

app/Coding.php

@@ -201,4 +201,33 @@ public function updateWikiTitle(string $token, string $projectName, int $id, str
         $result = json_decode($response->getBody(), true);
         return $result['Response']['Data']['Title'] == $title;
     }
+
+    /**
+     * 创建网盘目录，不可重名，如已存在，仍然正常返回 id
+     *
+     * @param string $token
+     * @param string $projectName
+     * @param string $folderName
+     * @param int $parentId
+     * @return int
+     * @throws \GuzzleHttp\Exception\GuzzleException
+     */
+    public function createFolder(string $token, string $projectName, string $folderName, int $parentId): int
+    {
+        $response = $this->client->request('POST', 'https://e.coding.net/open-api', [
+            'headers' => [
+                'Accept' => 'application/json',
+                'Authorization' => "token ${token}",
+                'Content-Type' => 'application/json'
+            ],
+            'json' => [
+                'Action' => 'CreateFolder',
+                'ProjectName' => $projectName,
+                'FolderName' => $folderName,
+                'ParentId' => $parentId,
+            ],
+        ]);
+        $result = json_decode($response->getBody(), true);
+        return $result['Response']['Data']['Id'];
+    }
 }

tests/Unit/CodingTest.php

@@ -276,4 +276,41 @@ public function testUpdateWikiTitle()
         $result = $coding->updateWikiTitle($codingToken, $codingProjectUri, $id, $title);
         $this->assertTrue($result);
     }
+
+    public function testCreateFolder()
+    {
+        $responseBody = file_get_contents($this->dataDir . 'coding/CreateFolderResponse.json');
+        $codingToken = $this->faker->md5;
+        $codingProjectUri = $this->faker->slug;
+        $folderName = 'foo';
+        $parentId = $this->faker->randomNumber();
+
+        $clientMock = $this->getMockBuilder(Client::class)->getMock();
+        $clientMock->expects($this->exactly(2))
+            ->method('request')
+            ->with(
+                'POST',
+                'https://e.coding.net/open-api',
+                [
+                    'headers' => [
+                        'Accept' => 'application/json',
+                        'Authorization' => "token ${codingToken}",
+                        'Content-Type' => 'application/json'
+                    ],
+                    'json' => [
+                        'Action' => 'CreateFolder',
+                        'ProjectName' => $codingProjectUri,
+                        'FolderName' => $folderName,
+                        'ParentId' => $parentId,
+                    ],
+                ]
+            )
+            ->willReturn(new Response(200, [], $responseBody));
+        $coding = new Coding($clientMock);
+        $result = $coding->createFolder($codingToken, $codingProjectUri, $folderName, $parentId);
+        $this->assertTrue(is_numeric($result));
+
+        $result = $coding->createFolder($codingToken, $codingProjectUri, $folderName, $parentId);
+        $this->assertTrue(is_numeric($result));
+    }
 }

tests/data/coding/CreateFolderResponse.json

@@ -0,0 +1,9 @@
+{
+  "Response" : {
+    "Data" : {
+      "FolderName" : "foo",
+      "Id" : 24515861
+    },
+    "RequestId" : "b43bdea4-0602-4266-e451-dfcc671c91f7"
+  }
+}