Resource: Meta

examples/meta-async.php

@@ -0,0 +1,18 @@
+<?php
+
+use ApiClients\Client\Github\AsyncClient;
+use ApiClients\Client\Github\Resource\MetaInterface;
+use ApiClients\Client\Github\Resource\OrganizationInterface;
+use React\EventLoop\Factory;
+use function ApiClients\Foundation\resource_pretty_print;
+
+require dirname(__DIR__) . DIRECTORY_SEPARATOR . 'vendor/autoload.php';
+
+$loop = Factory::create();
+$client = AsyncClient::create($loop, require 'resolve_token.php');
+
+$client->meta()->then(function (MetaInterface $meta) {
+    resource_pretty_print($meta);
+}, 'display_throwable');
+
+$loop->run();

src/AsyncClient.php

@@ -51,6 +51,11 @@ private function __construct(ClientInterface $client)
         $this->client = $client;
     }
 
+    public function meta(): PromiseInterface
+    {
+        return $this->client->handle(new Command\MetaCommand());
+    }
+
     public function user(string $user): PromiseInterface
     {
         return $this->client->handle(new Command\UserCommand($user));

src/AsyncClientInterface.php

@@ -11,6 +11,8 @@
 
 interface AsyncClientInterface
 {
+    public function meta(): PromiseInterface;
+
     public function user(string $user): PromiseInterface;
 
     public function whoami(): PromiseInterface;

src/CommandBus/Command/MetaCommand.php

@@ -0,0 +1,12 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Command;
+
+use WyriHaximus\Tactician\CommandHandler\Annotations\Handler;
+
+/**
+ * @Handler("ApiClients\Client\Github\CommandBus\Handler\MetaHandler")
+ */
+final class MetaCommand
+{
+}

src/CommandBus/Handler/MetaHandler.php

@@ -0,0 +1,34 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Handler;
+
+use ApiClients\Client\Github\CommandBus\Command\MetaCommand;
+use ApiClients\Client\Github\Resource\MetaInterface;
+use ApiClients\Tools\Services\Client\FetchAndHydrateService;
+use React\Promise\PromiseInterface;
+
+final class MetaHandler
+{
+    /**
+     * @var FetchAndHydrateService
+     */
+    private $service;
+
+    /**
+     * MetaHandler constructor.
+     * @param FetchAndHydrateService $service
+     */
+    public function __construct(FetchAndHydrateService $service)
+    {
+        $this->service = $service;
+    }
+
+    /**
+     * @param MetaCommand $command
+     * @return PromiseInterface
+     */
+    public function handle(MetaCommand $command): PromiseInterface
+    {
+        return $this->service->fetch('meta', '', MetaInterface::HYDRATE_CLASS);
+    }
+}

src/Resource/Async/EmptyMeta.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async;
+
+use ApiClients\Client\Github\Resource\EmptyMeta as BaseEmptyMeta;
+
+class EmptyMeta extends BaseEmptyMeta
+{
+}

src/Resource/Async/Meta.php

@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async;
+
+use ApiClients\Client\Github\Resource\Meta as BaseMeta;
+
+class Meta extends BaseMeta
+{
+    public function refresh() : Meta
+    {
+        throw new \Exception('TODO: create refresh method!');
+    }
+}

src/Resource/EmptyMeta.php

@@ -0,0 +1,56 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+
+abstract class EmptyMeta implements MetaInterface, EmptyResourceInterface
+{
+    /**
+     * @return bool
+     */
+    public function verifiablePasswordAuthentication() : bool
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function githubServicesSha() : string
+    {
+        return null;
+    }
+
+    /**
+     * @return array
+     */
+    public function hooks() : array
+    {
+        return null;
+    }
+
+    /**
+     * @return array
+     */
+    public function git() : array
+    {
+        return null;
+    }
+
+    /**
+     * @return array
+     */
+    public function pages() : array
+    {
+        return null;
+    }
+
+    /**
+     * @return array
+     */
+    public function importer() : array
+    {
+        return null;
+    }
+}

src/Resource/Meta.php

@@ -0,0 +1,90 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource;
+
+use ApiClients\Foundation\Hydrator\Annotations\EmptyResource;
+use ApiClients\Foundation\Resource\AbstractResource;
+
+/**
+ * @EmptyResource("EmptyMeta")
+ */
+abstract class Meta extends AbstractResource implements MetaInterface
+{
+    /**
+     * @var bool
+     */
+    protected $verifiable_password_authentication;
+
+    /**
+     * @var string
+     */
+    protected $github_services_sha;
+
+    /**
+     * @var array
+     */
+    protected $hooks;
+
+    /**
+     * @var array
+     */
+    protected $git;
+
+    /**
+     * @var array
+     */
+    protected $pages;
+
+    /**
+     * @var array
+     */
+    protected $importer;
+
+    /**
+     * @return bool
+     */
+    public function verifiablePasswordAuthentication() : bool
+    {
+        return $this->verifiable_password_authentication;
+    }
+
+    /**
+     * @return string
+     */
+    public function githubServicesSha() : string
+    {
+        return $this->github_services_sha;
+    }
+
+    /**
+     * @return array
+     */
+    public function hooks() : array
+    {
+        return $this->hooks;
+    }
+
+    /**
+     * @return array
+     */
+    public function git() : array
+    {
+        return $this->git;
+    }
+
+    /**
+     * @return array
+     */
+    public function pages() : array
+    {
+        return $this->pages;
+    }
+
+    /**
+     * @return array
+     */
+    public function importer() : array
+    {
+        return $this->importer;
+    }
+}

src/Resource/MetaInterface.php

@@ -0,0 +1,40 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource;
+
+use ApiClients\Foundation\Resource\ResourceInterface;
+
+interface MetaInterface extends ResourceInterface
+{
+    const HYDRATE_CLASS = 'Meta';
+
+    /**
+     * @return bool
+     */
+    public function verifiablePasswordAuthentication() : bool;
+
+    /**
+     * @return string
+     */
+    public function githubServicesSha() : string;
+
+    /**
+     * @return array
+     */
+    public function hooks() : array;
+
+    /**
+     * @return array
+     */
+    public function git() : array;
+
+    /**
+     * @return array
+     */
+    public function pages() : array;
+
+    /**
+     * @return array
+     */
+    public function importer() : array;
+}

src/Resource/Sync/EmptyMeta.php

@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync;
+
+use ApiClients\Client\Github\Resource\EmptyMeta as BaseEmptyMeta;
+
+class EmptyMeta extends BaseEmptyMeta
+{
+}

src/Resource/Sync/Meta.php

@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync;
+
+use ApiClients\Foundation\Hydrator\CommandBus\Command\BuildAsyncFromSyncCommand;
+use ApiClients\Client\Github\Resource\Meta as BaseMeta;
+use ApiClients\Client\Github\Resource\MetaInterface;
+
+class Meta extends BaseMeta
+{
+    public function refresh() : Meta
+    {
+        return $this->wait($this->handleCommand(
+            new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this)
+        )->then(function (MetaInterface $meta) {
+            return $meta->refresh();
+        }));
+    }
+}

tests/CommandBus/Handler/MetaHandlerTest.php

@@ -0,0 +1,25 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Github\CommandBus\Handler;
+
+use ApiClients\Client\Github\CommandBus\Command\MetaCommand;
+use ApiClients\Client\Github\CommandBus\Handler\MetaHandler;
+use ApiClients\Client\Github\Resource\MetaInterface;
+use ApiClients\Tools\Services\Client\FetchAndHydrateService;
+use ApiClients\Tools\TestUtilities\TestCase;
+use function React\Promise\resolve;
+
+final class MetaHandlerTest extends TestCase
+{
+    public function testCommand()
+    {
+        $meta = $this->prophesize(MetaInterface::class)->reveal();
+
+        $service = $this->prophesize(FetchAndHydrateService::class);
+        $service->fetch('meta', '', MetaInterface::HYDRATE_CLASS)->shouldBeCalled()->willReturn(resolve($meta));
+
+        $handler = new MetaHandler($service->reveal());
+
+        self::assertSame($meta, $this->await($handler->handle(new MetaCommand())));
+    }
+}

tests/Resource/Async/EmptyMetaTest.php

@@ -0,0 +1,18 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async;
+
+use ApiClients\Tools\ResourceTestUtilities\AbstractEmptyResourceTest;
+use ApiClients\Client\Github\Resource\Async\EmptyMeta;
+
+final class EmptyMetaTest extends AbstractEmptyResourceTest
+{
+    public function getSyncAsync() : string
+    {
+        return 'Async';
+    }
+    public function getClass() : string
+    {
+        return EmptyMeta::class;
+    }
+}

tests/Resource/Async/MetaTest.php

@@ -0,0 +1,23 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async;
+
+use ApiClients\Tools\ResourceTestUtilities\AbstractResourceTest;
+use ApiClients\Client\Github\ApiSettings;
+use ApiClients\Client\Github\Resource\Meta;
+
+class MetaTest extends AbstractResourceTest
+{
+    public function getSyncAsync() : string
+    {
+        return 'Async';
+    }
+    public function getClass() : string
+    {
+        return Meta::class;
+    }
+    public function getNamespace() : string
+    {
+        return Apisettings::NAMESPACE;
+    }
+}