Issue 78 iteration

app/Coding/Iteration.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace App\Coding;
+
+use Carbon\Carbon;
+
+class Iteration extends Base
+{
+    public function create($token, $projectName, $data)
+    {
+        $response = $this->client->request('POST', 'https://e.coding.net/open-api', [
+            'headers' => [
+                'Accept' => 'application/json',
+                'Authorization' => "token ${token}",
+                'Content-Type' => 'application/json'
+            ],
+            'json' => array_merge([
+                'Action' => 'CreateIteration',
+                'ProjectName' => $projectName,
+            ], $data),
+        ]);
+        $result = json_decode($response->getBody(), true);
+        return $result['Response']['Iteration'];
+    }
+
+    public static function generateName(Carbon $startAt, Carbon $endAt): string
+    {
+        $endFormat = $startAt->year == $endAt->year ? 'm/d' : 'Y/m/d';
+        return $startAt->format('Y/m/d') . '-' . $endAt->format($endFormat) . ' 迭代';
+    }
+}

app/Coding/Project.php

@@ -2,8 +2,6 @@
 
 namespace App\Coding;
 
-use Exception;
-
 class Project extends Base
 {
     public function getIssueTypes($token, $projectName)
@@ -14,10 +12,10 @@ public function getIssueTypes($token, $projectName)
                 'Authorization' => "token ${token}",
                 'Content-Type' => 'application/json'
             ],
-            'json' => array_merge([
+            'json' => [
                 'Action' => 'DescribeProjectIssueTypeList',
                 'ProjectName' => $projectName,
-            ]),
+            ],
         ]);
         $result = json_decode($response->getBody(), true);
         return $result['Response']['IssueTypes'];

app/Commands/IterationCreateCommand.php

@@ -0,0 +1,64 @@
+<?php
+
+namespace App\Commands;
+
+use App\Coding\Iteration;
+use Carbon\Carbon;
+use LaravelZero\Framework\Commands\Command;
+
+class IterationCreateCommand extends Command
+{
+    use WithCoding;
+
+    /**
+     * The signature of the command.
+     *
+     * @var string
+     */
+    protected $signature = 'iteration:create
+        {--start_at= : 开始时间，格式：2021-10-20}
+        {--end_at= : 结束时间，格式：2021-10-30}
+        {--name= : 标题}
+        {--goal= : 目标}
+        {--assignee= : 处理人 ID}
+        {--coding_token= : CODING 令牌}
+        {--coding_team_domain= : CODING 团队域名，如 xxx.coding.net 即填写 xxx}
+        {--coding_project_uri= : CODING 项目标识，如 xxx.coding.net/p/yyy 即填写 yyy}
+    ';
+
+    /**
+     * The description of the command.
+     *
+     * @var string
+     */
+    protected $description = '创建迭代';
+
+    /**
+     * Execute the console command.
+     *
+     */
+    public function handle(Iteration $iteration): int
+    {
+        $this->setCodingApi();
+
+        $data = [];
+        $startAt = Carbon::parse($this->option('start_at') ?? $this->ask('开始时间：', Carbon::today()->toDateString()));
+        $data['StartAt'] = $startAt->toDateString();
+        $endAt = Carbon::parse($this->option('end_at') ?? $this->ask(
+            '结束时间：',
+            Carbon::today()->addDays(14)->toDateString()
+        ));
+        $data['EndAt'] = $endAt->toDateString();
+        $data['Name'] = $this->option('name') ?? $this->ask('标题：', Iteration::generateName($startAt, $endAt));
+        $data['Goal'] = $this->option('goal');
+        $data['Assignee'] = $this->option('assignee');
+
+        $result = $iteration->create($this->codingToken, $this->codingProjectUri, $data);
+
+        $this->info('创建成功');
+        $this->info("https://{$this->codingTeamDomain}.coding.net/p/{$this->codingProjectUri}" .
+            "/iterations/${result['Code']}/issues");
+
+        return 0;
+    }
+}

composer.json

@@ -26,6 +26,7 @@
         "laravel-fans/confluence": "^0.1.1",
         "laravel-zero/framework": "^8.8",
         "league/html-to-markdown": "^5.0",
+        "nesbot/carbon": "^2.53",
         "sinkcup/laravel-filesystem-cos-updated": "^4.0"
     },
     "require-dev": {

tests/Feature/IterationCreateCommandTest.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace Tests\Feature;
+
+use App\Coding\Iteration;
+use Carbon\Carbon;
+use Tests\TestCase;
+
+class IterationCreateCommandTest extends TestCase
+{
+    private string $teamDomain;
+    private string $projectUri;
+
+    protected function setUp(): void
+    {
+        parent::setUp();
+        $codingToken = $this->faker->md5;
+        config(['coding.token' => $codingToken]);
+        $this->teamDomain = $this->faker->domainWord;
+        config(['coding.team_domain' => $this->teamDomain]);
+        $this->projectUri = $this->faker->slug;
+        config(['coding.project_uri' => $this->projectUri]);
+    }
+
+    public function testCreateSuccess()
+    {
+        $mock = \Mockery::mock(Iteration::class, [])->makePartial();
+        $this->instance(Iteration::class, $mock);
+
+        $mock->shouldReceive('create')->times(1)->andReturn(json_decode(
+            file_get_contents($this->dataDir . 'coding/' . 'CreateIterationResponse.json'),
+            true
+        )['Response']['Iteration']);
+
+        $startAt = $this->faker->date();
+        $endAt = Carbon::parse($startAt)->addDays($this->faker->randomNumber())->toDateString();
+        $this->artisan('iteration:create', [
+                '--goal' => $this->faker->text(),
+                '--assignee' => $this->faker->randomNumber(),
+            ])
+            ->expectsQuestion('开始时间：', $startAt)
+            ->expectsQuestion('结束时间：', $endAt)
+            ->expectsQuestion('标题：', $startAt . '~' . $endAt . ' 迭代')
+            ->expectsOutput('创建成功')
+            ->expectsOutput("https://$this->teamDomain.coding.net/p/$this->projectUri/iterations/2746/issues")
+            ->assertExitCode(0);
+    }
+}

tests/Feature/WikiImportCommandTest.php

@@ -17,7 +17,7 @@ protected function setUp(): void
     {
         parent::setUp();
         $this->createWikiResponse = json_decode(
-            file_get_contents($this->dataDir . 'coding/createWikiResponse.json'),
+            file_get_contents($this->dataDir . 'coding/CreateWikiResponse.json'),
             true
         )['Response']['Data'];
     }

tests/Unit/CodingIterationTest.php

@@ -0,0 +1,59 @@
+<?php
+
+namespace Tests\Unit;
+
+use App\Coding\Issue;
+use App\Coding\Iteration;
+use Carbon\Carbon;
+use GuzzleHttp\Client;
+use GuzzleHttp\Psr7\Response;
+use Tests\TestCase;
+
+class CodingIterationTest extends TestCase
+{
+    public function testCreateSuccess()
+    {
+        $responseBody = file_get_contents($this->dataDir . 'coding/CreateIterationResponse.json');
+        $codingToken = $this->faker->md5;
+        $codingProjectUri = $this->faker->slug;
+        $data = [
+            'Name' => $this->faker->title,
+        ];
+
+        $clientMock = $this->getMockBuilder(Client::class)->getMock();
+        $clientMock->expects($this->once())
+            ->method('request')
+            ->with(
+                'POST',
+                'https://e.coding.net/open-api',
+                [
+                    'headers' => [
+                        'Accept' => 'application/json',
+                        'Authorization' => "token ${codingToken}",
+                        'Content-Type' => 'application/json'
+                    ],
+                    'json' => array_merge([
+                        'Action' => 'CreateIteration',
+                        'ProjectName' => $codingProjectUri,
+                    ], $data)
+                ]
+            )
+            ->willReturn(new Response(200, [], $responseBody));
+        $coding = new Iteration($clientMock);
+        $result = $coding->create($codingToken, $codingProjectUri, $data);
+        $this->assertEquals(json_decode($responseBody, true)['Response']['Iteration'], $result);
+    }
+
+    public function testGenerateName()
+    {
+        $startAt = Carbon::parse('2021-10-20');
+        $endAt = Carbon::parse('2021-10-30');
+        $result = Iteration::generateName($startAt, $endAt);
+        $this->assertEquals("2021/10/20-10/30 迭代", $result);
+
+        $startAt = Carbon::parse('2021-12-27');
+        $endAt = Carbon::parse('2022-01-07');
+        $result = Iteration::generateName($startAt, $endAt);
+        $this->assertEquals("2021/12/27-2022/01/07 迭代", $result);
+    }
+}

tests/Unit/CodingWikiTest.php

@@ -39,7 +39,7 @@ protected function setUp(): void
 
     public function testCreateWiki()
     {
-        $responseBody = file_get_contents($this->dataDir . 'coding/createWikiResponse.json');
+        $responseBody = file_get_contents($this->dataDir . 'coding/CreateWikiResponse.json');
         $codingToken = $this->faker->md5;
         $codingProjectUri = $this->faker->slug;
         $article = [
@@ -74,7 +74,7 @@ public function testCreateWiki()
 
     public function testCreateUploadToken()
     {
-        $responseBody = file_get_contents($this->dataDir . 'coding/createUploadTokenResponse.json');
+        $responseBody = file_get_contents($this->dataDir . 'coding/CreateUploadTokenResponse.json');
         $codingToken = $this->faker->md5;
         $codingProjectUri = $this->faker->slug;
         $fileName = $this->faker->word;

tests/data/coding/CreateIterationResponse.json

@@ -0,0 +1,24 @@
+{
+   "Response" : {
+      "Iteration" : {
+         "Assignee" : 0,
+         "Code" : 2746,
+         "CompletedCount" : 0,
+         "CompletedPercent" : 0,
+         "Completer" : 0,
+         "CreatedAt" : 1634697259529,
+         "Creator" : 183478,
+         "Deleter" : 0,
+         "EndAt" : -28800000,
+         "Goal" : "",
+         "Name" : "it by cli",
+         "ProcessingCount" : 0,
+         "StartAt" : -28800000,
+         "Starter" : 0,
+         "Status" : "WAIT_PROCESS",
+         "UpdatedAt" : 1634697259529,
+         "WaitProcessCount" : 0
+      },
+      "RequestId" : "58777aa6-e6e4-155a-c99f-415a33615ca6"
+   }
+}