Merge pull request #6 from packagist/t/jobs-api

Jobs: add show call

Author: Seldaek

Diff for: README.md

@@ -38,8 +38,9 @@ Full documentation can be found in the [Private Packagist documentation](https:/
 
 ##### Trigger a full synchronization
 ```php
-$client->organization()->sync();
+$jobs = $client->organization()->sync();
 ```
+Returns an array of created jobs. One for every synchronization.
 
 #### Customer
 
@@ -116,6 +117,14 @@ $packages = $client->packages()->all($filters);
 ```
 Returns an array of packages.
 
+#### Job
+
+##### Show a job
+```php
+$job = $client->jobs()->show($jobId);
+```
+Returns the job.
+
 ## License
 
 `private-packagist/api-client` is licensed under the MIT License

Diff for: src/Api/Jobs.php

@@ -0,0 +1,11 @@
+<?php
+
+namespace PrivatePackagist\ApiClient\Api;
+
+class Jobs extends AbstractApi
+{
+    public function show($jobId)
+    {
+        return $this->get(sprintf('/jobs/%s', $jobId));
+    }
+}

Diff for: src/Client.php

@@ -58,6 +58,11 @@ public function packages()
         return new Api\Packages($this, $this->responseMediator);
     }
 
+    public function jobs()
+    {
+        return new Api\Jobs($this, $this->responseMediator);
+    }
+
     public function getHttpClient()
     {
         return $this->getHttpClientBuilder()->getHttpClient();

Diff for: tests/Api/JobsTest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace PrivatePackagist\ApiClient\Api;
+
+class JobsTest extends ApiTestCase
+{
+    public function testShow()
+    {
+        $expected = [];
+        $jobId = '46bf13150a86fece079ca979cb8ef57c78773faa';
+
+        /** @var Jobs&\PHPUnit_Framework_MockObject_MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with($this->equalTo('/jobs/' . $jobId))
+            ->will($this->returnValue($expected));
+
+        $this->assertSame($expected, $api->show($jobId));
+    }
+
+    protected function getApiClass()
+    {
+        return Jobs::class;
+    }
+}