Merge pull request #1 from php-api-clients/feature-astronomy

Feature: Astronomy

Author: WyriHaximus

examples/astronomy-async.php

@@ -0,0 +1,17 @@
+<?php
+
+use ApiClients\Client\WeatherUnderground\AsyncClient;
+use ApiClients\Client\WeatherUnderground\Resource\AstronomyInterface;
+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->astronomy('Broek_op_Langedijk')->done(function (AstronomyInterface $astronomy) {
+    resource_pretty_print($astronomy);
+});
+
+$loop->run();

examples/astronomy.php

@@ -0,0 +1,10 @@
+<?php
+
+use ApiClients\Client\WeatherUnderground\Client;
+use function ApiClients\Foundation\resource_pretty_print;
+
+require dirname(__DIR__) . DIRECTORY_SEPARATOR . 'vendor/autoload.php';
+
+$client = new Client(require 'resolve_token.php');
+
+resource_pretty_print($client->astronomy('Broek_op_Langedijk'));

src/AsyncClient.php

@@ -46,4 +46,9 @@ public function conditions(string $location): PromiseInterface
     {
         return $this->client->handle(new Command\ConditionsCommand($location));
     }
+
+    public function astronomy(string $location): PromiseInterface
+    {
+        return $this->client->handle(new Command\AstronomyCommand($location));
+    }
 }

src/Client.php

@@ -2,6 +2,7 @@
 
 namespace ApiClients\Client\WeatherUnderground;
 
+use ApiClients\Client\WeatherUnderground\Resource\AstronomyInterface;
 use ApiClients\Client\WeatherUnderground\Resource\ConditionInterface;
 use ApiClients\Client\WeatherUnderground\Resource\UserInterface;
 use React\EventLoop\Factory;
@@ -26,6 +27,14 @@ public function __construct(string $token)
         $this->client = AsyncClient::create($this->loop, $token);
     }
 
+    public function astronomy(string $location): AstronomyInterface
+    {
+        return await(
+            $this->client->astronomy($location),
+            $this->loop
+        );
+    }
+
     public function conditions(string $location): ConditionInterface
     {
         return await(

src/CommandBus/Command/AstronomyCommand.php

@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\WeatherUnderground\CommandBus\Command;
+
+use WyriHaximus\Tactician\CommandHandler\Annotations\Handler;
+
+/**
+ * @Handler("ApiClients\Client\WeatherUnderground\CommandBus\Handler\AstronomyHandler")
+ */
+final class AstronomyCommand
+{
+    /**
+     * @var string
+     */
+    private $location;
+
+    /**
+     * @param string $location
+     */
+    public function __construct(string $location = '')
+    {
+        $this->location = $location;
+    }
+
+    /**
+     * @return string
+     */
+    public function getLocation(): string
+    {
+        return $this->location;
+    }
+}

src/CommandBus/Handler/AstronomyHandler.php

@@ -0,0 +1,40 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\WeatherUnderground\CommandBus\Handler;
+
+use ApiClients\Client\WeatherUnderground\CommandBus\Command\AstronomyCommand;
+use ApiClients\Client\WeatherUnderground\Resource\AstronomyInterface;
+use ApiClients\Client\WeatherUnderground\Resource\ConditionInterface;
+use ApiClients\Tools\Services\Client\FetchAndHydrateService;
+use React\Promise\PromiseInterface;
+
+final class AstronomyHandler
+{
+    /**
+     * @var FetchAndHydrateService
+     */
+    private $service;
+
+    /**
+     * @param FetchAndHydrateService $service
+     */
+    public function __construct(FetchAndHydrateService $service)
+    {
+        $this->service = $service;
+    }
+
+    /**
+     * Fetch the given repository and hydrate it
+     *
+     * @param AstronomyCommand $command
+     * @return PromiseInterface
+     */
+    public function handle(AstronomyCommand $command): PromiseInterface
+    {
+        return $this->service->fetch(
+            'astronomy/q/' . $command->getLocation() . '.json',
+            '',
+            AstronomyInterface::HYDRATE_CLASS
+        );
+    }
+}

src/Resource/Astronomy.php

@@ -0,0 +1,57 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\WeatherUnderground\Resource;
+
+use ApiClients\Foundation\Hydrator\Annotations\EmptyResource;
+use ApiClients\Foundation\Hydrator\Annotations\Nested;
+use ApiClients\Foundation\Resource\AbstractResource;
+
+/**
+ * @Nested(
+ *     response="Response",
+ *     moon_phase="Astronomy\MoonPhase",
+ *     sun_phase="Astronomy\SunPhase"
+ * )
+ * @EmptyResource("EmptyAstronomy")
+ */
+abstract class Astronomy extends AbstractResource implements AstronomyInterface
+{
+    /**
+     * @var Response
+     */
+    protected $response;
+
+    /**
+     * @var Astronomy\MoonPhase
+     */
+    protected $moon_phase;
+
+    /**
+     * @var Astronomy\SunPhase
+     */
+    protected $sun_phase;
+
+    /**
+     * @return Response
+     */
+    public function response() : Response
+    {
+        return $this->response;
+    }
+
+    /**
+     * @return Astronomy\MoonPhase
+     */
+    public function moonPhase() : Astronomy\MoonPhase
+    {
+        return $this->moon_phase;
+    }
+
+    /**
+     * @return Astronomy\SunPhase
+     */
+    public function sunPhase() : Astronomy\SunPhase
+    {
+        return $this->sun_phase;
+    }
+}

src/Resource/Astronomy/EmptyMoonPhase.php

@@ -0,0 +1,80 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\WeatherUnderground\Resource\Astronomy;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+
+abstract class EmptyMoonPhase implements MoonPhaseInterface, EmptyResourceInterface
+{
+    /**
+     * @return string
+     */
+    public function percentIlluminated() : string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function ageOfMoon() : string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function phaseofMoon() : string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function hemisphere() : string
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function currentTime() : Time
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function sunrise() : Time
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function sunset() : Time
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function moonrise() : Time
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function moonset() : Time
+    {
+        return null;
+    }
+}

src/Resource/Astronomy/EmptySunPhase.php

@@ -0,0 +1,24 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\WeatherUnderground\Resource\Astronomy;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+
+abstract class EmptySunPhase implements SunPhaseInterface, EmptyResourceInterface
+{
+    /**
+     * @return Time
+     */
+    public function sunrise() : Time
+    {
+        return null;
+    }
+
+    /**
+     * @return Time
+     */
+    public function sunset() : Time
+    {
+        return null;
+    }
+}