feat: #34 get iteration

Author: shaunthegeek

src/Iteration.php

@@ -17,4 +17,14 @@ public function create(array $data)
         $response = $this->core->request('CreateIteration', $data);
         return $response['Iteration'];
     }
+
+    public function get(array $data)
+    {
+        $this->validate($data, [
+            'ProjectName' => 'string|required',
+            'IterationCode' => 'integer|required',
+        ]);
+        $response = $this->core->request('DescribeIteration', $data);
+        return $response['Iteration'];
+    }
 }

tests/Unit/IterationTest.php

@@ -102,4 +102,24 @@ public function testCreateFailedBefore()
         $this->expectExceptionMessage('The end at must be a date after start at.');
         $iteration->create($data);
     }
+
+    public function testGet()
+    {
+        $response = json_decode(
+            file_get_contents($this->dataPath('DescribeIterationResponse.json')),
+            true
+        )['Response'];
+        $data = [
+            'ProjectName' => $this->projectName,
+            'IterationCode' => $this->faker->randomNumber(),
+        ];
+        $this->coreMock->shouldReceive('request')->times(1)->withArgs([
+            'DescribeIteration',
+            $data
+        ])->andReturn($response);
+
+        $iteration = new Iteration($this->token, $this->coreMock);
+        $result = $iteration->get($data);
+        $this->assertEquals($response['Iteration'], $result);
+    }
 }

tests/data/DescribeIterationResponse.json

@@ -0,0 +1,24 @@
+{
+   "Response" : {
+      "Iteration" : {
+         "Assignee" : 0,
+         "Code" : 10,
+         "CompletedCount" : 0,
+         "CompletedPercent" : 0,
+         "Completer" : 0,
+         "CreatedAt" : 1640672501000,
+         "Creator" : 183478,
+         "Deleter" : 0,
+         "EndAt" : -28800000,
+         "Goal" : "",
+         "Name" : "sprint 1",
+         "ProcessingCount" : 0,
+         "StartAt" : -28800000,
+         "Starter" : 0,
+         "Status" : "WAIT_PROCESS",
+         "UpdatedAt" : 1640672501000,
+         "WaitProcessCount" : 0
+      },
+      "RequestId" : "78bb5b45-acc9-7ccc-edfc-a802f473b169"
+   }
+}