Support fetching commit statuses for branches

spec/V4/Object/Repository/Factory/Status/ExternalServiceFactorySpec.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status;
+
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\ExternalServiceFactory;
+use PhpSpec\ObjectBehavior;
+
+class ExternalServiceFactorySpec extends ObjectBehavior
+{
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(ExternalServiceFactory::class);
+    }
+}

spec/V4/Object/Repository/Factory/Status/StatusCreatorFactorySpec.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status;
+
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\StatusCreatorFactory;
+use PhpSpec\ObjectBehavior;
+
+class StatusCreatorFactorySpec extends ObjectBehavior
+{
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(StatusCreatorFactory::class);
+    }
+}

spec/V4/Object/Repository/Factory/StatusFactorySpec.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Object\Repository\Factory;
+
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\ExternalServiceFactory;
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\StatusCreatorFactory;
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\StatusFactory;
+use PhpSpec\ObjectBehavior;
+
+class StatusFactorySpec extends ObjectBehavior
+{
+    public function let(StatusCreatorFactory $statusCreatorFactory, ExternalServiceFactory $externalServiceFactory)
+    {
+        $this->beConstructedWith($statusCreatorFactory, $externalServiceFactory);
+    }
+
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(StatusFactory::class);
+    }
+}

spec/V4/Object/Repository/Response/BranchStatusCollectionSpec.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Object\Repository\Response;
+
+use DevboardLib\Git\Branch\BranchName;
+use DevboardLib\GitHub\GitHubStatus;
+use DevboardLib\GitHubApi\V4\Object\Repository\Response\BranchStatusCollection;
+use PhpSpec\ObjectBehavior;
+
+class BranchStatusCollectionSpec extends ObjectBehavior
+{
+    public function let(BranchName $branchName, GitHubStatus $status1)
+    {
+        $this->beConstructedWith($branchName, [$status1]);
+    }
+
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(BranchStatusCollection::class);
+    }
+}

spec/V4/Object/Repository/StatusObjectApiSpec.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Object\Repository;
+
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\StatusFactory;
+use DevboardLib\GitHubApi\V4\Object\Repository\StatusObjectApi;
+use DevboardLib\GitHubApi\V4\Raw\Repository\StatusApi;
+use PhpSpec\ObjectBehavior;
+
+class StatusObjectApiSpec extends ObjectBehavior
+{
+    public function let(StatusApi $branchApi, StatusFactory $statusFactory)
+    {
+        $this->beConstructedWith($branchApi, $statusFactory);
+    }
+
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(StatusObjectApi::class);
+    }
+}

spec/V4/Raw/Repository/StatusApiSpec.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace spec\DevboardLib\GitHubApi\V4\Raw\Repository;
+
+use DevboardLib\GitHubApi\V3\GitHubClientFactory;
+use DevboardLib\GitHubApi\V4\Raw\Repository\StatusApi;
+use PhpSpec\ObjectBehavior;
+
+class StatusApiSpec extends ObjectBehavior
+{
+    public function let(GitHubClientFactory $clientFactory)
+    {
+        $this->beConstructedWith($clientFactory);
+    }
+
+    public function it_is_initializable()
+    {
+        $this->shouldHaveType(StatusApi::class);
+    }
+}

src/V4/Object/Repository/Factory/Status/ExternalServiceFactory.php

@@ -0,0 +1,60 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status;
+
+use DevboardLib\GitHub\External\ExternalService;
+use DevboardLib\GitHub\External\Service\CodeCoverage\CodeCovIo;
+use DevboardLib\GitHub\External\Service\CodeCoverage\CoverallsIo;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\AppVeyor;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\CircleCi;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\CodeClimate;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\FabbotIo;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\Shippable;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\StyleCi;
+use DevboardLib\GitHub\External\Service\ContinuousIntegration\TravisCi;
+use DevboardLib\GitHub\External\Service\UnknownService;
+use DevboardLib\GitHub\Status\StatusContext;
+
+class ExternalServiceFactory
+{
+    private static $regex = ['|^ci/circleci|' => CircleCi::class, '|^codecov|' => CodeCovIo::class];
+
+    private static $text = [
+        'coverage/coveralls'                     => CoverallsIo::class,
+        'continuous-integration/travis-ci/pr'    => TravisCi::class,
+        'continuous-integration/travis-ci/push'  => TravisCi::class,
+        'continuous-integration/travis-ci'       => TravisCi::class,
+        'continuous-integration/appveyor/branch' => AppVeyor::class,
+        'continuous-integration/appveyor/pr'     => AppVeyor::class,
+        'fabbot.io'                              => FabbotIo::class,
+        'continuous-integration/styleci/push'    => StyleCi::class,
+        'codeclimate'                            => CodeClimate::class,
+        // @TODO: is this really OK?
+        'default'   => FabbotIo::class,
+        'Shippable' => Shippable::class,
+    ];
+
+    public function create(StatusContext $context): ExternalService
+    {
+        foreach (self::$text as $pattern => $class) {
+            if ($pattern === $context->getValue()) {
+                return new $class($context);
+            }
+        }
+
+        foreach (self::$regex as $pattern => $class) {
+            if (preg_match($pattern, $context->getValue())) {
+                return new $class($context);
+            }
+        }
+
+        return new UnknownService($context);
+    }
+
+    public function createFromString(string $name): ExternalService
+    {
+        return $this->create(new StatusContext($name));
+    }
+}

src/V4/Object/Repository/Factory/Status/StatusCreatorFactory.php

@@ -0,0 +1,25 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status;
+
+use DevboardLib\GitHub\Account\AccountAvatarUrl;
+use DevboardLib\GitHub\Account\AccountId;
+use DevboardLib\GitHub\Account\AccountLogin;
+use DevboardLib\GitHub\Account\AccountType;
+use DevboardLib\GitHub\Status\StatusCreator;
+
+class StatusCreatorFactory
+{
+    public function create(array $data): StatusCreator
+    {
+        return new StatusCreator(
+            new AccountId((int) $data['id']),
+            new AccountLogin($data['login']),
+            new AccountType($data['__typename']),
+            new AccountAvatarUrl($data['avatarUrl']),
+            $data['isSiteAdmin']
+        );
+    }
+}

src/V4/Object/Repository/Factory/StatusFactory.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Object\Repository\Factory;
+
+use DateTime;
+use DevboardLib\GitHub\GitHubStatus;
+use DevboardLib\GitHub\Status\StatusContext;
+use DevboardLib\GitHub\Status\StatusDescription;
+use DevboardLib\GitHub\Status\StatusId;
+use DevboardLib\GitHub\Status\StatusState;
+use DevboardLib\GitHub\Status\StatusTargetUrl;
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\ExternalServiceFactory;
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\Status\StatusCreatorFactory;
+
+class StatusFactory
+{
+    /** @var StatusCreatorFactory */
+    private $statusCreatorFactory;
+
+    /** @var ExternalServiceFactory */
+    private $externalServiceFactory;
+
+    public function __construct(
+        StatusCreatorFactory $statusCreatorFactory, ExternalServiceFactory $externalServiceFactory
+    ) {
+        $this->statusCreatorFactory   = $statusCreatorFactory;
+        $this->externalServiceFactory = $externalServiceFactory;
+    }
+
+    public function create(array $data): GitHubStatus
+    {
+        $context = new StatusContext($data['context']);
+
+        return new GitHubStatus(
+            new StatusId((int) $data['id']),
+            StatusState::create(strtolower($data['state'])),
+            new StatusDescription($data['description']),
+            new StatusTargetUrl($data['targetUrl']),
+            $context,
+            $this->externalServiceFactory->create($context),
+            $this->statusCreatorFactory->create($data['creator']),
+            new DateTime($data['createdAt']),
+            new DateTime($data['createdAt'])
+        );
+    }
+}

src/V4/Object/Repository/Response/BranchStatusCollection.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Object\Repository\Response;
+
+use DevboardLib\Git\Branch\BranchName;
+use DevboardLib\GitHub\GitHubStatus;
+use Webmozart\Assert\Assert;
+
+class BranchStatusCollection
+{
+    /** @var BranchName */
+    private $branchName;
+
+    /** @var array */
+    private $statuses;
+
+    public function __construct(BranchName $branchName, array $statuses)
+    {
+        Assert::allIsInstanceOf($statuses, GitHubStatus::class);
+
+        $this->branchName = $branchName;
+        $this->statuses   = $statuses;
+    }
+
+    public function getBranchName(): BranchName
+    {
+        return $this->branchName;
+    }
+
+    public function getStatuses(): array
+    {
+        return $this->statuses;
+    }
+}

src/V4/Object/Repository/StatusObjectApi.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Object\Repository;
+
+use DevboardLib\Git\Branch\BranchName;
+use DevboardLib\GitHub\Installation\InstallationId;
+use DevboardLib\GitHub\Repo\RepoFullName;
+use DevboardLib\GitHub\User\UserId;
+use DevboardLib\GitHubApi\V4\Object\Repository\Factory\StatusFactory;
+use DevboardLib\GitHubApi\V4\Object\Repository\Response\BranchStatusCollection;
+use DevboardLib\GitHubApi\V4\Raw\Repository\StatusApi;
+
+class StatusObjectApi
+{
+    /**
+     * @var StatusApi
+     */
+    private $branchApi;
+
+    /**
+     * @var StatusFactory
+     */
+    private $statusFactory;
+
+    public function __construct(StatusApi $branchApi, StatusFactory $statusFactory)
+    {
+        $this->branchApi     = $branchApi;
+        $this->statusFactory = $statusFactory;
+    }
+
+    /** @return array|BranchStatusCollection[] */
+    public function getBranches(RepoFullName $repoFullName, InstallationId $installationId, UserId $githubUserId): array
+    {
+        $data = $this->branchApi->getBranches($repoFullName, $installationId, $githubUserId);
+
+        $results = [];
+
+        foreach ($data['data']['repository']['refs']['edges'] as $edge) {
+            $branchName = new BranchName($edge['node']['name']);
+            $statuses   = [];
+
+            if (null !== $edge['node']['target']['status']) {
+                foreach ($edge['node']['target']['status']['contexts'] as $context) {
+                    $statuses[] = $this->statusFactory->create($context);
+                }
+            }
+            $results[] = new BranchStatusCollection($branchName, $statuses);
+        }
+
+        return $results;
+    }
+}

src/V4/Raw/Repository/StatusApi.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace DevboardLib\GitHubApi\V4\Raw\Repository;
+
+use DevboardLib\GitHub\Installation\InstallationId;
+use DevboardLib\GitHub\Repo\RepoFullName;
+use DevboardLib\GitHub\User\UserId;
+use DevboardLib\GitHubApi\V3\GitHubClientFactory;
+
+class StatusApi
+{
+    /** @var GitHubClientFactory */
+    private $clientFactory;
+
+    public function __construct(GitHubClientFactory $clientFactory)
+    {
+        $this->clientFactory = $clientFactory;
+    }
+
+    public function getBranches(RepoFullName $repoFullName, InstallationId $installationId, UserId $githubUserId): array
+    {
+        $query = file_get_contents(__DIR__.'/branch_statuses.graphql');
+
+        $variables = [
+            'owner' => $repoFullName->getOwner()->getValue(),
+            'name'  => $repoFullName->getRepoName()->getValue(),
+        ];
+        $client = $this->clientFactory->createAppAndUserAuthenticatedClient($installationId, $githubUserId);
+
+        $data = $client->graphql()->execute($query, $variables);
+
+        return $data;
+    }
+}