From 955fd97dfb8311dd72327242d465ad0d0a8c6126 Mon Sep 17 00:00:00 2001
From: Cees-Jan Kiewiet <ceesjank@gmail.com>
Date: Sat, 17 Jun 2017 20:20:46 +0200
Subject: [PATCH 1/5] List tags from repository

---
 examples/user-repositories-tags-async.php     | 29 ++++++++
 .../Command/Repository/TagsCommand.php        | 32 +++++++++
 .../Handler/Repository/TagsHandler.php        | 50 ++++++++++++++
 src/Resource/Async/Repository.php             |  8 +++
 src/Resource/Async/Repository/EmptyTag.php    |  9 +++
 src/Resource/Async/Repository/Tag.php         | 13 ++++
 src/Resource/Repository/EmptyTag.php          | 40 +++++++++++
 src/Resource/Repository/Tag.php               | 68 +++++++++++++++++++
 src/Resource/Repository/TagInterface.php      | 30 ++++++++
 src/Resource/Sync/Repository/EmptyTag.php     |  9 +++
 src/Resource/Sync/Repository/Tag.php          | 17 +++++
 .../Handler/Repository/TagsHandlerTest.php    | 39 +++++++++++
 .../Async/Repository/EmptyTagTest.php         | 19 ++++++
 tests/Resource/Async/Repository/TagTest.php   | 25 +++++++
 .../Resource/Sync/Repository/EmptyTagTest.php | 19 ++++++
 tests/Resource/Sync/Repository/TagTest.php    | 25 +++++++
 yaml/repository-tag.yml                       |  9 +++
 17 files changed, 441 insertions(+)
 create mode 100644 examples/user-repositories-tags-async.php
 create mode 100644 src/CommandBus/Command/Repository/TagsCommand.php
 create mode 100644 src/CommandBus/Handler/Repository/TagsHandler.php
 create mode 100644 src/Resource/Async/Repository/EmptyTag.php
 create mode 100644 src/Resource/Async/Repository/Tag.php
 create mode 100644 src/Resource/Repository/EmptyTag.php
 create mode 100644 src/Resource/Repository/Tag.php
 create mode 100644 src/Resource/Repository/TagInterface.php
 create mode 100644 src/Resource/Sync/Repository/EmptyTag.php
 create mode 100644 src/Resource/Sync/Repository/Tag.php
 create mode 100644 tests/CommandBus/Handler/Repository/TagsHandlerTest.php
 create mode 100644 tests/Resource/Async/Repository/EmptyTagTest.php
 create mode 100644 tests/Resource/Async/Repository/TagTest.php
 create mode 100644 tests/Resource/Sync/Repository/EmptyTagTest.php
 create mode 100644 tests/Resource/Sync/Repository/TagTest.php
 create mode 100644 yaml/repository-tag.yml

diff --git a/examples/user-repositories-tags-async.php b/examples/user-repositories-tags-async.php
new file mode 100644
index 0000000000..45bc8f3ee2
--- /dev/null
+++ b/examples/user-repositories-tags-async.php
@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+use ApiClients\Client\Github\AsyncClient;
+use ApiClients\Client\Github\Resource\Async\Repository;
+use ApiClients\Client\Github\Resource\Async\User;
+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->user($argv[1] ?? 'php-api-clients')->then(function (User $user) use ($argv) {
+    resource_pretty_print($user);
+
+    return $user->repository($argv[2] ?? 'github');
+})->then(function (Repository $repository) {
+    resource_pretty_print($repository, 1, true);
+    $repository->tags()->subscribe(function ($tag) {
+        resource_pretty_print($tag, 2, true);
+    }, function ($error) {
+        echo (string)$error;
+    });
+})->done(null, 'display_throwable');
+
+$loop->run();
+
+displayState($client->getRateLimitState());
diff --git a/src/CommandBus/Command/Repository/TagsCommand.php b/src/CommandBus/Command/Repository/TagsCommand.php
new file mode 100644
index 0000000000..368077771c
--- /dev/null
+++ b/src/CommandBus/Command/Repository/TagsCommand.php
@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Command\Repository;
+
+use WyriHaximus\Tactician\CommandHandler\Annotations\Handler;
+
+/**
+ * @Handler("ApiClients\Client\Github\CommandBus\Handler\Repository\TagsHandler")
+ */
+final class TagsCommand
+{
+    /**
+     * @var string
+     */
+    private $fullName;
+
+    /**
+     * @param string $fullName
+     */
+    public function __construct(string $fullName)
+    {
+        $this->fullName = $fullName;
+    }
+
+    /**
+     * @return string
+     */
+    public function getFullName(): string
+    {
+        return $this->fullName;
+    }
+}
diff --git a/src/CommandBus/Handler/Repository/TagsHandler.php b/src/CommandBus/Handler/Repository/TagsHandler.php
new file mode 100644
index 0000000000..ab2bc669a2
--- /dev/null
+++ b/src/CommandBus/Handler/Repository/TagsHandler.php
@@ -0,0 +1,50 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Handler\Repository;
+
+use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
+use ApiClients\Client\Github\Resource\Repository\TagInterface;
+use ApiClients\Client\Github\Service\IteratePagesService;
+use ApiClients\Foundation\Hydrator\Hydrator;
+use React\Promise\PromiseInterface;
+use function ApiClients\Tools\Rx\observableFromArray;
+use function React\Promise\resolve;
+
+final class TagsHandler
+{
+    /**
+     * @var IteratePagesService
+     */
+    private $iteratePagesService;
+
+    /**
+     * @var Hydrator
+     */
+    private $hydrator;
+
+    /**
+     * @param IteratePagesService $iteratePagesService
+     * @param Hydrator            $hydrator
+     */
+    public function __construct(IteratePagesService $iteratePagesService, Hydrator $hydrator)
+    {
+        $this->iteratePagesService = $iteratePagesService;
+        $this->hydrator = $hydrator;
+    }
+
+    /**
+     * @param  TagsCommand      $command
+     * @return PromiseInterface
+     */
+    public function handle(TagsCommand $command): PromiseInterface
+    {
+        return resolve(
+            $this->iteratePagesService->iterate('repos/' . $command->getFullName() . '/tags')
+                ->flatMap(function ($labels) {
+                    return observableFromArray($labels);
+                })->map(function ($label) {
+                    return $this->hydrator->hydrate(TagInterface::HYDRATE_CLASS, $label);
+                })
+        );
+    }
+}
diff --git a/src/Resource/Async/Repository.php b/src/Resource/Async/Repository.php
index a1c2746390..4951a2acb5 100644
--- a/src/Resource/Async/Repository.php
+++ b/src/Resource/Async/Repository.php
@@ -9,6 +9,7 @@
 use ApiClients\Client\Github\CommandBus\Command\Repository\CommunityHealthCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\ContentsCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\LabelsCommand;
+use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
 use ApiClients\Client\Github\Resource\Repository as BaseRepository;
 use React\Promise\PromiseInterface;
 use Rx\Observable;
@@ -67,4 +68,11 @@ public function communityHealth(): PromiseInterface
             new CommunityHealthCommand($this->fullName())
         );
     }
+
+    public function tags(): ObservableInterface
+    {
+        return unwrapObservableFromPromise($this->handleCommand(
+            new TagsCommand($this->fullName())
+        ));
+    }
 }
diff --git a/src/Resource/Async/Repository/EmptyTag.php b/src/Resource/Async/Repository/EmptyTag.php
new file mode 100644
index 0000000000..f4f368ccaa
--- /dev/null
+++ b/src/Resource/Async/Repository/EmptyTag.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\EmptyTag as BaseEmptyTag;
+
+class EmptyTag extends BaseEmptyTag
+{
+}
diff --git a/src/Resource/Async/Repository/Tag.php b/src/Resource/Async/Repository/Tag.php
new file mode 100644
index 0000000000..12f434e9cf
--- /dev/null
+++ b/src/Resource/Async/Repository/Tag.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\Tag as BaseTag;
+
+class Tag extends BaseTag
+{
+    public function refresh(): Tag
+    {
+        throw new \Exception('TODO: create refresh method!');
+    }
+}
diff --git a/src/Resource/Repository/EmptyTag.php b/src/Resource/Repository/EmptyTag.php
new file mode 100644
index 0000000000..4a7cf7b32d
--- /dev/null
+++ b/src/Resource/Repository/EmptyTag.php
@@ -0,0 +1,40 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+
+abstract class EmptyTag implements TagInterface, EmptyResourceInterface
+{
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return Tree
+     */
+    public function commit(): Tree
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function zipballUrl(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function tarballUrl(): string
+    {
+        return null;
+    }
+}
diff --git a/src/Resource/Repository/Tag.php b/src/Resource/Repository/Tag.php
new file mode 100644
index 0000000000..af9d731616
--- /dev/null
+++ b/src/Resource/Repository/Tag.php
@@ -0,0 +1,68 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Hydrator\Annotation\EmptyResource;
+use ApiClients\Foundation\Hydrator\Annotation\Nested;
+use ApiClients\Foundation\Resource\AbstractResource;
+
+/**
+ * @Nested(
+ *     commit="Tree"
+ * )
+ * @EmptyResource("Repository\EmptyTag")
+ */
+abstract class Tag extends AbstractResource implements TagInterface
+{
+    /**
+     * @var string
+     */
+    protected $name;
+
+    /**
+     * @var Tree
+     */
+    protected $commit;
+
+    /**
+     * @var string
+     */
+    protected $zipball_url;
+
+    /**
+     * @var string
+     */
+    protected $tarball_url;
+
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return Tree
+     */
+    public function commit(): Tree
+    {
+        return $this->commit;
+    }
+
+    /**
+     * @return string
+     */
+    public function zipballUrl(): string
+    {
+        return $this->zipball_url;
+    }
+
+    /**
+     * @return string
+     */
+    public function tarballUrl(): string
+    {
+        return $this->tarball_url;
+    }
+}
diff --git a/src/Resource/Repository/TagInterface.php b/src/Resource/Repository/TagInterface.php
new file mode 100644
index 0000000000..4a4db387b9
--- /dev/null
+++ b/src/Resource/Repository/TagInterface.php
@@ -0,0 +1,30 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Resource\ResourceInterface;
+
+interface TagInterface extends ResourceInterface
+{
+    const HYDRATE_CLASS = 'Repository\\Tag';
+
+    /**
+     * @return string
+     */
+    public function name(): string;
+
+    /**
+     * @return Tree
+     */
+    public function commit(): Tree;
+
+    /**
+     * @return string
+     */
+    public function zipballUrl(): string;
+
+    /**
+     * @return string
+     */
+    public function tarballUrl(): string;
+}
diff --git a/src/Resource/Sync/Repository/EmptyTag.php b/src/Resource/Sync/Repository/EmptyTag.php
new file mode 100644
index 0000000000..b528563ce7
--- /dev/null
+++ b/src/Resource/Sync/Repository/EmptyTag.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\EmptyTag as BaseEmptyTag;
+
+class EmptyTag extends BaseEmptyTag
+{
+}
diff --git a/src/Resource/Sync/Repository/Tag.php b/src/Resource/Sync/Repository/Tag.php
new file mode 100644
index 0000000000..53e0e66f95
--- /dev/null
+++ b/src/Resource/Sync/Repository/Tag.php
@@ -0,0 +1,17 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\Tag as BaseTag;
+use ApiClients\Client\Github\Resource\Repository\TagInterface;
+use ApiClients\Foundation\Hydrator\CommandBus\Command\BuildAsyncFromSyncCommand;
+
+class Tag extends BaseTag
+{
+    public function refresh(): Tag
+    {
+        return $this->wait($this->handleCommand(new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this))->then(function (TagInterface $tag) {
+            return $tag->refresh();
+        }));
+    }
+}
diff --git a/tests/CommandBus/Handler/Repository/TagsHandlerTest.php b/tests/CommandBus/Handler/Repository/TagsHandlerTest.php
new file mode 100644
index 0000000000..b69c09c20d
--- /dev/null
+++ b/tests/CommandBus/Handler/Repository/TagsHandlerTest.php
@@ -0,0 +1,39 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Github\CommandBus\Handler\Repository;
+
+use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
+use ApiClients\Client\Github\CommandBus\Handler\Repository\TagsHandler;
+use ApiClients\Client\Github\Resource\Async\Repository\Tag;
+use ApiClients\Client\Github\Resource\Repository\TagInterface;
+use ApiClients\Client\Github\Service\IteratePagesService;
+use ApiClients\Foundation\Hydrator\Hydrator;
+use ApiClients\Tools\TestUtilities\TestCase;
+use Rx\Observable;
+use Rx\React\Promise;
+
+final class TagsHandlerTest extends TestCase
+{
+    public function testCommand()
+    {
+        $tagArray = [
+            'foo' => 'bar',
+        ];
+        $tag = $this->prophesize(Tag::class)->reveal();
+
+        $command = new TagsCommand('api-clients/github');
+
+        $iteratePagesService = $this->prophesize(IteratePagesService::class);
+        $iteratePagesService->iterate('repos/api-clients/github/tags')->shouldBeCalled()->willReturn(Observable::fromArray([[$tagArray]]));
+
+        $hydrator = $this->prophesize(Hydrator::class);
+        $hydrator->hydrate(TagInterface::HYDRATE_CLASS, $tagArray)->shouldBeCalled()->wilLReturn($tag);
+
+        $tagsHandler = new TagsHandler(
+            $iteratePagesService->reveal(),
+            $hydrator->reveal()
+        );
+
+        self::assertSame($tag, $this->await(Promise::fromObservable($this->await($tagsHandler->handle($command)))));
+    }
+}
diff --git a/tests/Resource/Async/Repository/EmptyTagTest.php b/tests/Resource/Async/Repository/EmptyTagTest.php
new file mode 100644
index 0000000000..05b0220cec
--- /dev/null
+++ b/tests/Resource/Async/Repository/EmptyTagTest.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Async\Repository\EmptyTag;
+use ApiClients\Tools\ResourceTestUtilities\AbstractEmptyResourceTest;
+
+final class EmptyTagTest extends AbstractEmptyResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Async';
+    }
+
+    public function getClass(): string
+    {
+        return EmptyTag::class;
+    }
+}
diff --git a/tests/Resource/Async/Repository/TagTest.php b/tests/Resource/Async/Repository/TagTest.php
new file mode 100644
index 0000000000..1856e87d2b
--- /dev/null
+++ b/tests/Resource/Async/Repository/TagTest.php
@@ -0,0 +1,25 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\ApiSettings;
+use ApiClients\Client\Github\Resource\Repository\Tag;
+use ApiClients\Tools\ResourceTestUtilities\AbstractResourceTest;
+
+class TagTest extends AbstractResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Async';
+    }
+
+    public function getClass(): string
+    {
+        return Tag::class;
+    }
+
+    public function getNamespace(): string
+    {
+        return ApiSettings::NAMESPACE;
+    }
+}
diff --git a/tests/Resource/Sync/Repository/EmptyTagTest.php b/tests/Resource/Sync/Repository/EmptyTagTest.php
new file mode 100644
index 0000000000..83c15ee410
--- /dev/null
+++ b/tests/Resource/Sync/Repository/EmptyTagTest.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Sync\Repository\EmptyTag;
+use ApiClients\Tools\ResourceTestUtilities\AbstractEmptyResourceTest;
+
+final class EmptyTagTest extends AbstractEmptyResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Sync';
+    }
+
+    public function getClass(): string
+    {
+        return EmptyTag::class;
+    }
+}
diff --git a/tests/Resource/Sync/Repository/TagTest.php b/tests/Resource/Sync/Repository/TagTest.php
new file mode 100644
index 0000000000..73d4fa624f
--- /dev/null
+++ b/tests/Resource/Sync/Repository/TagTest.php
@@ -0,0 +1,25 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\ApiSettings;
+use ApiClients\Client\Github\Resource\Repository\Tag;
+use ApiClients\Tools\ResourceTestUtilities\AbstractResourceTest;
+
+class TagTest extends AbstractResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Sync';
+    }
+
+    public function getClass(): string
+    {
+        return Tag::class;
+    }
+
+    public function getNamespace(): string
+    {
+        return ApiSettings::NAMESPACE;
+    }
+}
diff --git a/yaml/repository-tag.yml b/yaml/repository-tag.yml
new file mode 100644
index 0000000000..1c238e88b1
--- /dev/null
+++ b/yaml/repository-tag.yml
@@ -0,0 +1,9 @@
+class: Repository\Tag
+properties:
+  name: string
+  commit:
+    type: Tree
+    annotations:
+      nested: Tree
+  zipball_url: string
+  tarball_url: string

From 5c2d409b904bb700377e57417871ec176a7b969e Mon Sep 17 00:00:00 2001
From: Cees-Jan Kiewiet <ceesjank@gmail.com>
Date: Sun, 18 Jun 2017 00:57:23 +0200
Subject: [PATCH 2/5] Line length

---
 src/Resource/Sync/Repository/Tag.php                   | 10 +++++++---
 .../CommandBus/Handler/Repository/TagsHandlerTest.php  |  4 +++-
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/src/Resource/Sync/Repository/Tag.php b/src/Resource/Sync/Repository/Tag.php
index 53e0e66f95..7bccb4aee7 100644
--- a/src/Resource/Sync/Repository/Tag.php
+++ b/src/Resource/Sync/Repository/Tag.php
@@ -10,8 +10,12 @@ class Tag extends BaseTag
 {
     public function refresh(): Tag
     {
-        return $this->wait($this->handleCommand(new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this))->then(function (TagInterface $tag) {
-            return $tag->refresh();
-        }));
+        return $this->wait(
+            $this->handleCommand(
+                new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this)
+            )->then(function (TagInterface $tag) {
+                return $tag->refresh();
+            })
+        );
     }
 }
diff --git a/tests/CommandBus/Handler/Repository/TagsHandlerTest.php b/tests/CommandBus/Handler/Repository/TagsHandlerTest.php
index b69c09c20d..24a5746fcc 100644
--- a/tests/CommandBus/Handler/Repository/TagsHandlerTest.php
+++ b/tests/CommandBus/Handler/Repository/TagsHandlerTest.php
@@ -24,7 +24,9 @@ public function testCommand()
         $command = new TagsCommand('api-clients/github');
 
         $iteratePagesService = $this->prophesize(IteratePagesService::class);
-        $iteratePagesService->iterate('repos/api-clients/github/tags')->shouldBeCalled()->willReturn(Observable::fromArray([[$tagArray]]));
+        $iteratePagesService->iterate('repos/api-clients/github/tags')
+            ->shouldBeCalled()
+            ->willReturn(Observable::fromArray([[$tagArray]]));
 
         $hydrator = $this->prophesize(Hydrator::class);
         $hydrator->hydrate(TagInterface::HYDRATE_CLASS, $tagArray)->shouldBeCalled()->wilLReturn($tag);

From 334cdc5c6b34b2b5ef8b10df8525b2c3e95ff681 Mon Sep 17 00:00:00 2001
From: Cees-Jan Kiewiet <ceesjank@gmail.com>
Date: Sun, 18 Jun 2017 01:18:29 +0200
Subject: [PATCH 3/5] Release resource

---
 examples/user-repositories-releases-async.php |  29 ++++
 .../Command/Repository/ReleasesCommand.php    |  32 ++++
 .../Handler/Repository/ReleasesHandler.php    |  52 ++++++
 src/Resource/Async/Repository.php             |   8 +
 .../Async/Repository/EmptyRelease.php         |   9 +
 src/Resource/Async/Repository/Release.php     |  13 ++
 src/Resource/Repository/EmptyRelease.php      |  97 +++++++++++
 src/Resource/Repository/Release.php           | 160 ++++++++++++++++++
 src/Resource/Repository/ReleaseInterface.php  |  66 ++++++++
 src/Resource/Sync/Repository/EmptyRelease.php |   9 +
 src/Resource/Sync/Repository/Release.php      |  19 +++
 .../Async/Repository/EmptyReleaseTest.php     |  19 +++
 .../Resource/Async/Repository/ReleaseTest.php |  25 +++
 .../Sync/Repository/EmptyReleaseTest.php      |  19 +++
 .../Resource/Sync/Repository/ReleaseTest.php  |  25 +++
 yaml/repository-release.yml                   |  16 ++
 16 files changed, 598 insertions(+)
 create mode 100644 examples/user-repositories-releases-async.php
 create mode 100644 src/CommandBus/Command/Repository/ReleasesCommand.php
 create mode 100644 src/CommandBus/Handler/Repository/ReleasesHandler.php
 create mode 100644 src/Resource/Async/Repository/EmptyRelease.php
 create mode 100644 src/Resource/Async/Repository/Release.php
 create mode 100644 src/Resource/Repository/EmptyRelease.php
 create mode 100644 src/Resource/Repository/Release.php
 create mode 100644 src/Resource/Repository/ReleaseInterface.php
 create mode 100644 src/Resource/Sync/Repository/EmptyRelease.php
 create mode 100644 src/Resource/Sync/Repository/Release.php
 create mode 100644 tests/Resource/Async/Repository/EmptyReleaseTest.php
 create mode 100644 tests/Resource/Async/Repository/ReleaseTest.php
 create mode 100644 tests/Resource/Sync/Repository/EmptyReleaseTest.php
 create mode 100644 tests/Resource/Sync/Repository/ReleaseTest.php
 create mode 100644 yaml/repository-release.yml

diff --git a/examples/user-repositories-releases-async.php b/examples/user-repositories-releases-async.php
new file mode 100644
index 0000000000..e9839d24ad
--- /dev/null
+++ b/examples/user-repositories-releases-async.php
@@ -0,0 +1,29 @@
+<?php declare(strict_types=1);
+use ApiClients\Client\Github\AsyncClient;
+use ApiClients\Client\Github\Resource\Async\Repository;
+use ApiClients\Client\Github\Resource\Async\User;
+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->user($argv[1] ?? 'php-api-clients')->then(function (User $user) use ($argv) {
+    resource_pretty_print($user);
+
+    return $user->repository($argv[2] ?? 'github');
+})->then(function (Repository $repository) {
+    resource_pretty_print($repository, 1, true);
+    $repository->releases()->subscribe(function ($release) {
+        resource_pretty_print($release, 2, true);
+    }, function ($error) {
+        echo (string)$error;
+    });
+})->done(null, 'display_throwable');
+
+$loop->run();
+
+displayState($client->getRateLimitState());
diff --git a/src/CommandBus/Command/Repository/ReleasesCommand.php b/src/CommandBus/Command/Repository/ReleasesCommand.php
new file mode 100644
index 0000000000..8ffc828295
--- /dev/null
+++ b/src/CommandBus/Command/Repository/ReleasesCommand.php
@@ -0,0 +1,32 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Command\Repository;
+
+use WyriHaximus\Tactician\CommandHandler\Annotations\Handler;
+
+/**
+ * @Handler("ApiClients\Client\Github\CommandBus\Handler\Repository\ReleasesHandler")
+ */
+final class ReleasesCommand
+{
+    /**
+     * @var string
+     */
+    private $fullName;
+
+    /**
+     * @param string $fullName
+     */
+    public function __construct(string $fullName)
+    {
+        $this->fullName = $fullName;
+    }
+
+    /**
+     * @return string
+     */
+    public function getFullName(): string
+    {
+        return $this->fullName;
+    }
+}
diff --git a/src/CommandBus/Handler/Repository/ReleasesHandler.php b/src/CommandBus/Handler/Repository/ReleasesHandler.php
new file mode 100644
index 0000000000..17cd815237
--- /dev/null
+++ b/src/CommandBus/Handler/Repository/ReleasesHandler.php
@@ -0,0 +1,52 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\CommandBus\Handler\Repository;
+
+use ApiClients\Client\Github\CommandBus\Command\Repository\ReleasesCommand;
+use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
+use ApiClients\Client\Github\Resource\Repository\ReleaseInterface;
+use ApiClients\Client\Github\Resource\Repository\TagInterface;
+use ApiClients\Client\Github\Service\IteratePagesService;
+use ApiClients\Foundation\Hydrator\Hydrator;
+use React\Promise\PromiseInterface;
+use function ApiClients\Tools\Rx\observableFromArray;
+use function React\Promise\resolve;
+
+final class ReleasesHandler
+{
+    /**
+     * @var IteratePagesService
+     */
+    private $iteratePagesService;
+
+    /**
+     * @var Hydrator
+     */
+    private $hydrator;
+
+    /**
+     * @param IteratePagesService $iteratePagesService
+     * @param Hydrator            $hydrator
+     */
+    public function __construct(IteratePagesService $iteratePagesService, Hydrator $hydrator)
+    {
+        $this->iteratePagesService = $iteratePagesService;
+        $this->hydrator = $hydrator;
+    }
+
+    /**
+     * @param  TagsCommand      $command
+     * @return PromiseInterface
+     */
+    public function handle(ReleasesCommand $command): PromiseInterface
+    {
+        return resolve(
+            $this->iteratePagesService->iterate('repos/' . $command->getFullName() . '/releases')
+                ->flatMap(function ($labels) {
+                    return observableFromArray($labels);
+                })->map(function ($label) {
+                    return $this->hydrator->hydrate(ReleaseInterface::HYDRATE_CLASS, $label);
+                })
+        );
+    }
+}
diff --git a/src/Resource/Async/Repository.php b/src/Resource/Async/Repository.php
index 4951a2acb5..af1a229b57 100644
--- a/src/Resource/Async/Repository.php
+++ b/src/Resource/Async/Repository.php
@@ -9,6 +9,7 @@
 use ApiClients\Client\Github\CommandBus\Command\Repository\CommunityHealthCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\ContentsCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\LabelsCommand;
+use ApiClients\Client\Github\CommandBus\Command\Repository\ReleasesCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
 use ApiClients\Client\Github\Resource\Repository as BaseRepository;
 use React\Promise\PromiseInterface;
@@ -75,4 +76,11 @@ public function tags(): ObservableInterface
             new TagsCommand($this->fullName())
         ));
     }
+
+    public function releases(): ObservableInterface
+    {
+        return unwrapObservableFromPromise($this->handleCommand(
+            new ReleasesCommand($this->fullName())
+        ));
+    }
 }
diff --git a/src/Resource/Async/Repository/EmptyRelease.php b/src/Resource/Async/Repository/EmptyRelease.php
new file mode 100644
index 0000000000..c6c8686c2a
--- /dev/null
+++ b/src/Resource/Async/Repository/EmptyRelease.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\EmptyRelease as BaseEmptyRelease;
+
+class EmptyRelease extends BaseEmptyRelease
+{
+}
diff --git a/src/Resource/Async/Repository/Release.php b/src/Resource/Async/Repository/Release.php
new file mode 100644
index 0000000000..9818081fb9
--- /dev/null
+++ b/src/Resource/Async/Repository/Release.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\Release as BaseRelease;
+
+class Release extends BaseRelease
+{
+    public function refresh(): Release
+    {
+        throw new \Exception('TODO: create refresh method!');
+    }
+}
diff --git a/src/Resource/Repository/EmptyRelease.php b/src/Resource/Repository/EmptyRelease.php
new file mode 100644
index 0000000000..f89e59c152
--- /dev/null
+++ b/src/Resource/Repository/EmptyRelease.php
@@ -0,0 +1,97 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+use DateTimeInterface;
+
+abstract class EmptyRelease implements ReleaseInterface, EmptyResourceInterface
+{
+    /**
+     * @return int
+     */
+    public function id(): int
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function tagName(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function targetCommitish(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function body(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return bool
+     */
+    public function draft(): bool
+    {
+        return null;
+    }
+
+    /**
+     * @return bool
+     */
+    public function prerelease(): bool
+    {
+        return null;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface
+    {
+        return null;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface
+    {
+        return null;
+    }
+
+    /**
+     * @return User
+     */
+    public function author(): User
+    {
+        return null;
+    }
+
+    /**
+     * @return array
+     */
+    public function assets(): array
+    {
+        return null;
+    }
+}
diff --git a/src/Resource/Repository/Release.php b/src/Resource/Repository/Release.php
new file mode 100644
index 0000000000..7bb4380a58
--- /dev/null
+++ b/src/Resource/Repository/Release.php
@@ -0,0 +1,160 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Hydrator\Annotation\EmptyResource;
+use ApiClients\Foundation\Hydrator\Annotation\Nested;
+use ApiClients\Foundation\Resource\AbstractResource;
+use DateTimeInterface;
+
+/**
+ * @Nested(
+ *     author="User"
+ * )
+ * @EmptyResource("Repository\EmptyRelease")
+ */
+abstract class Release extends AbstractResource implements ReleaseInterface
+{
+    /**
+     * @var int
+     */
+    protected $id;
+
+    /**
+     * @var string
+     */
+    protected $tag_name;
+
+    /**
+     * @var string
+     */
+    protected $target_commitish;
+
+    /**
+     * @var string
+     */
+    protected $name;
+
+    /**
+     * @var string
+     */
+    protected $body;
+
+    /**
+     * @var bool
+     */
+    protected $draft;
+
+    /**
+     * @var bool
+     */
+    protected $prerelease;
+
+    /**
+     * @var DateTimeInterface
+     */
+    protected $created_at;
+
+    /**
+     * @var DateTimeInterface
+     */
+    protected $updated_at;
+
+    /**
+     * @var User
+     */
+    protected $author;
+
+    /**
+     * @var array
+     */
+    protected $assets;
+
+    /**
+     * @return int
+     */
+    public function id(): int
+    {
+        return $this->id;
+    }
+
+    /**
+     * @return string
+     */
+    public function tagName(): string
+    {
+        return $this->tag_name;
+    }
+
+    /**
+     * @return string
+     */
+    public function targetCommitish(): string
+    {
+        return $this->target_commitish;
+    }
+
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return string
+     */
+    public function body(): string
+    {
+        return $this->body;
+    }
+
+    /**
+     * @return bool
+     */
+    public function draft(): bool
+    {
+        return $this->draft;
+    }
+
+    /**
+     * @return bool
+     */
+    public function prerelease(): bool
+    {
+        return $this->prerelease;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface
+    {
+        return $this->created_at;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface
+    {
+        return $this->updated_at;
+    }
+
+    /**
+     * @return User
+     */
+    public function author(): User
+    {
+        return $this->author;
+    }
+
+    /**
+     * @return array
+     */
+    public function assets(): array
+    {
+        return $this->assets;
+    }
+}
diff --git a/src/Resource/Repository/ReleaseInterface.php b/src/Resource/Repository/ReleaseInterface.php
new file mode 100644
index 0000000000..4cd3e72eaa
--- /dev/null
+++ b/src/Resource/Repository/ReleaseInterface.php
@@ -0,0 +1,66 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository;
+
+use ApiClients\Foundation\Resource\ResourceInterface;
+use DateTimeInterface;
+
+interface ReleaseInterface extends ResourceInterface
+{
+    const HYDRATE_CLASS = 'Repository\\Release';
+
+    /**
+     * @return int
+     */
+    public function id(): int;
+
+    /**
+     * @return string
+     */
+    public function tagName(): string;
+
+    /**
+     * @return string
+     */
+    public function targetCommitish(): string;
+
+    /**
+     * @return string
+     */
+    public function name(): string;
+
+    /**
+     * @return string
+     */
+    public function body(): string;
+
+    /**
+     * @return bool
+     */
+    public function draft(): bool;
+
+    /**
+     * @return bool
+     */
+    public function prerelease(): bool;
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface;
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface;
+
+    /**
+     * @return User
+     */
+    public function author(): User;
+
+    /**
+     * @return array
+     */
+    public function assets(): array;
+}
diff --git a/src/Resource/Sync/Repository/EmptyRelease.php b/src/Resource/Sync/Repository/EmptyRelease.php
new file mode 100644
index 0000000000..e89298d7d0
--- /dev/null
+++ b/src/Resource/Sync/Repository/EmptyRelease.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\EmptyRelease as BaseEmptyRelease;
+
+class EmptyRelease extends BaseEmptyRelease
+{
+}
diff --git a/src/Resource/Sync/Repository/Release.php b/src/Resource/Sync/Repository/Release.php
new file mode 100644
index 0000000000..6cbb11f424
--- /dev/null
+++ b/src/Resource/Sync/Repository/Release.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Repository\Release as BaseRelease;
+use ApiClients\Client\Github\Resource\Repository\ReleaseInterface;
+use ApiClients\Foundation\Hydrator\CommandBus\Command\BuildAsyncFromSyncCommand;
+
+class Release extends BaseRelease
+{
+    public function refresh(): Release
+    {
+        return $this->wait($this->handleCommand(
+            new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this)
+        )->then(function (ReleaseInterface $release) {
+            return $release->refresh();
+        }));
+    }
+}
diff --git a/tests/Resource/Async/Repository/EmptyReleaseTest.php b/tests/Resource/Async/Repository/EmptyReleaseTest.php
new file mode 100644
index 0000000000..1f6f1fffcc
--- /dev/null
+++ b/tests/Resource/Async/Repository/EmptyReleaseTest.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\Resource\Async\Repository\EmptyRelease;
+use ApiClients\Tools\ResourceTestUtilities\AbstractEmptyResourceTest;
+
+final class EmptyReleaseTest extends AbstractEmptyResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Async';
+    }
+
+    public function getClass(): string
+    {
+        return EmptyRelease::class;
+    }
+}
diff --git a/tests/Resource/Async/Repository/ReleaseTest.php b/tests/Resource/Async/Repository/ReleaseTest.php
new file mode 100644
index 0000000000..4dc8852ed7
--- /dev/null
+++ b/tests/Resource/Async/Repository/ReleaseTest.php
@@ -0,0 +1,25 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Async\Repository;
+
+use ApiClients\Client\Github\ApiSettings;
+use ApiClients\Client\Github\Resource\Repository\Release;
+use ApiClients\Tools\ResourceTestUtilities\AbstractResourceTest;
+
+class ReleaseTest extends AbstractResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Async';
+    }
+
+    public function getClass(): string
+    {
+        return Release::class;
+    }
+
+    public function getNamespace(): string
+    {
+        return ApiSettings::NAMESPACE;
+    }
+}
diff --git a/tests/Resource/Sync/Repository/EmptyReleaseTest.php b/tests/Resource/Sync/Repository/EmptyReleaseTest.php
new file mode 100644
index 0000000000..fa4d5ad809
--- /dev/null
+++ b/tests/Resource/Sync/Repository/EmptyReleaseTest.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\Resource\Sync\Repository\EmptyRelease;
+use ApiClients\Tools\ResourceTestUtilities\AbstractEmptyResourceTest;
+
+final class EmptyReleaseTest extends AbstractEmptyResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Sync';
+    }
+
+    public function getClass(): string
+    {
+        return EmptyRelease::class;
+    }
+}
diff --git a/tests/Resource/Sync/Repository/ReleaseTest.php b/tests/Resource/Sync/Repository/ReleaseTest.php
new file mode 100644
index 0000000000..004024eae7
--- /dev/null
+++ b/tests/Resource/Sync/Repository/ReleaseTest.php
@@ -0,0 +1,25 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Tests\Client\Github\Resource\Sync\Repository;
+
+use ApiClients\Client\Github\ApiSettings;
+use ApiClients\Client\Github\Resource\Repository\Release;
+use ApiClients\Tools\ResourceTestUtilities\AbstractResourceTest;
+
+class ReleaseTest extends AbstractResourceTest
+{
+    public function getSyncAsync(): string
+    {
+        return 'Sync';
+    }
+
+    public function getClass(): string
+    {
+        return Release::class;
+    }
+
+    public function getNamespace(): string
+    {
+        return ApiSettings::NAMESPACE;
+    }
+}
diff --git a/yaml/repository-release.yml b/yaml/repository-release.yml
new file mode 100644
index 0000000000..4cd4113beb
--- /dev/null
+++ b/yaml/repository-release.yml
@@ -0,0 +1,16 @@
+class: Repository\Release
+properties:
+  id: int
+  tag_name: string
+  target_commitish: string
+  name: string
+  body: string
+  draft: bool
+  prerelease: bool
+  created_at: DateTimeInterface
+  updated_at: DateTimeInterface
+  author:
+    type: User
+    annotations:
+      nested: User
+  assets: array

From c1fe30ff58d6f92100e5a0723106179ec3907590 Mon Sep 17 00:00:00 2001
From: Cees-Jan Kiewiet <ceesjank@gmail.com>
Date: Sun, 18 Jun 2017 12:55:30 +0200
Subject: [PATCH 4/5] Removed unused use

---
 src/CommandBus/Handler/Repository/ReleasesHandler.php | 1 -
 1 file changed, 1 deletion(-)

diff --git a/src/CommandBus/Handler/Repository/ReleasesHandler.php b/src/CommandBus/Handler/Repository/ReleasesHandler.php
index 17cd815237..835634c7bf 100644
--- a/src/CommandBus/Handler/Repository/ReleasesHandler.php
+++ b/src/CommandBus/Handler/Repository/ReleasesHandler.php
@@ -5,7 +5,6 @@
 use ApiClients\Client\Github\CommandBus\Command\Repository\ReleasesCommand;
 use ApiClients\Client\Github\CommandBus\Command\Repository\TagsCommand;
 use ApiClients\Client\Github\Resource\Repository\ReleaseInterface;
-use ApiClients\Client\Github\Resource\Repository\TagInterface;
 use ApiClients\Client\Github\Service\IteratePagesService;
 use ApiClients\Foundation\Hydrator\Hydrator;
 use React\Promise\PromiseInterface;

From fe0e6f298434e4e6341f13b80612d70eb61fdc01 Mon Sep 17 00:00:00 2001
From: Cees-Jan Kiewiet <ceesjank@gmail.com>
Date: Sun, 18 Jun 2017 12:59:42 +0200
Subject: [PATCH 5/5] Release asset resource

---
 .../Async/Repository/Release/Asset.php        |  13 ++
 .../Async/Repository/Release/EmptyAsset.php   |   9 +
 src/Resource/Repository/Release.php           |   6 +-
 src/Resource/Repository/Release/Asset.php     | 173 ++++++++++++++++++
 .../Repository/Release/AssetInterface.php     |  71 +++++++
 .../Repository/Release/EmptyAsset.php         | 105 +++++++++++
 .../Sync/Repository/Release/Asset.php         |  19 ++
 .../Sync/Repository/Release/EmptyAsset.php    |   9 +
 yaml/repository-release-asset.yml             |  17 ++
 yaml/repository-release.yml                   |   5 +-
 10 files changed, 425 insertions(+), 2 deletions(-)
 create mode 100644 src/Resource/Async/Repository/Release/Asset.php
 create mode 100644 src/Resource/Async/Repository/Release/EmptyAsset.php
 create mode 100644 src/Resource/Repository/Release/Asset.php
 create mode 100644 src/Resource/Repository/Release/AssetInterface.php
 create mode 100644 src/Resource/Repository/Release/EmptyAsset.php
 create mode 100644 src/Resource/Sync/Repository/Release/Asset.php
 create mode 100644 src/Resource/Sync/Repository/Release/EmptyAsset.php
 create mode 100644 yaml/repository-release-asset.yml

diff --git a/src/Resource/Async/Repository/Release/Asset.php b/src/Resource/Async/Repository/Release/Asset.php
new file mode 100644
index 0000000000..52ba32b579
--- /dev/null
+++ b/src/Resource/Async/Repository/Release/Asset.php
@@ -0,0 +1,13 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository\Release;
+
+use ApiClients\Client\Github\Resource\Repository\Release\Asset as BaseAsset;
+
+class Asset extends BaseAsset
+{
+    public function refresh(): Asset
+    {
+        throw new \Exception('TODO: create refresh method!');
+    }
+}
diff --git a/src/Resource/Async/Repository/Release/EmptyAsset.php b/src/Resource/Async/Repository/Release/EmptyAsset.php
new file mode 100644
index 0000000000..8aa6ed8e54
--- /dev/null
+++ b/src/Resource/Async/Repository/Release/EmptyAsset.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Async\Repository\Release;
+
+use ApiClients\Client\Github\Resource\Repository\Release\EmptyAsset as BaseEmptyAsset;
+
+class EmptyAsset extends BaseEmptyAsset
+{
+}
diff --git a/src/Resource/Repository/Release.php b/src/Resource/Repository/Release.php
index 7bb4380a58..41a64a0fbd 100644
--- a/src/Resource/Repository/Release.php
+++ b/src/Resource/Repository/Release.php
@@ -2,12 +2,16 @@
 
 namespace ApiClients\Client\Github\Resource\Repository;
 
+use ApiClients\Foundation\Hydrator\Annotation\Collection;
 use ApiClients\Foundation\Hydrator\Annotation\EmptyResource;
 use ApiClients\Foundation\Hydrator\Annotation\Nested;
 use ApiClients\Foundation\Resource\AbstractResource;
 use DateTimeInterface;
 
 /**
+ * @Collection(
+ *     assets="Repository\Release\Asset"
+ * )
  * @Nested(
  *     author="User"
  * )
@@ -66,7 +70,7 @@ abstract class Release extends AbstractResource implements ReleaseInterface
     protected $author;
 
     /**
-     * @var array
+     * @var Repository\Release\Asset
      */
     protected $assets;
 
diff --git a/src/Resource/Repository/Release/Asset.php b/src/Resource/Repository/Release/Asset.php
new file mode 100644
index 0000000000..c9a84a5154
--- /dev/null
+++ b/src/Resource/Repository/Release/Asset.php
@@ -0,0 +1,173 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository\Release;
+
+use ApiClients\Foundation\Hydrator\Annotation\EmptyResource;
+use ApiClients\Foundation\Hydrator\Annotation\Nested;
+use ApiClients\Foundation\Resource\AbstractResource;
+use DateTimeInterface;
+
+/**
+ * @Nested(
+ *     uploader="User"
+ * )
+ * @EmptyResource("Repository\Release\EmptyAsset")
+ */
+abstract class Asset extends AbstractResource implements AssetInterface
+{
+    /**
+     * @var string
+     */
+    protected $url;
+
+    /**
+     * @var string
+     */
+    protected $browser_download_url;
+
+    /**
+     * @var int
+     */
+    protected $id;
+
+    /**
+     * @var string
+     */
+    protected $name;
+
+    /**
+     * @var string
+     */
+    protected $label;
+
+    /**
+     * @var string
+     */
+    protected $state;
+
+    /**
+     * @var string
+     */
+    protected $content_type;
+
+    /**
+     * @var int
+     */
+    protected $size;
+
+    /**
+     * @var int
+     */
+    protected $download_count;
+
+    /**
+     * @var DateTimeInterface
+     */
+    protected $created_at;
+
+    /**
+     * @var DateTimeInterface
+     */
+    protected $updated_at;
+
+    /**
+     * @var User
+     */
+    protected $uploader;
+
+    /**
+     * @return string
+     */
+    public function url(): string
+    {
+        return $this->url;
+    }
+
+    /**
+     * @return string
+     */
+    public function browserDownloadUrl(): string
+    {
+        return $this->browser_download_url;
+    }
+
+    /**
+     * @return int
+     */
+    public function id(): int
+    {
+        return $this->id;
+    }
+
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return $this->name;
+    }
+
+    /**
+     * @return string
+     */
+    public function label(): string
+    {
+        return $this->label;
+    }
+
+    /**
+     * @return string
+     */
+    public function state(): string
+    {
+        return $this->state;
+    }
+
+    /**
+     * @return string
+     */
+    public function contentType(): string
+    {
+        return $this->content_type;
+    }
+
+    /**
+     * @return int
+     */
+    public function size(): int
+    {
+        return $this->size;
+    }
+
+    /**
+     * @return int
+     */
+    public function downloadCount(): int
+    {
+        return $this->download_count;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface
+    {
+        return $this->created_at;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface
+    {
+        return $this->updated_at;
+    }
+
+    /**
+     * @return User
+     */
+    public function uploader(): User
+    {
+        return $this->uploader;
+    }
+}
diff --git a/src/Resource/Repository/Release/AssetInterface.php b/src/Resource/Repository/Release/AssetInterface.php
new file mode 100644
index 0000000000..243c3e5a47
--- /dev/null
+++ b/src/Resource/Repository/Release/AssetInterface.php
@@ -0,0 +1,71 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository\Release;
+
+use ApiClients\Foundation\Resource\ResourceInterface;
+use DateTimeInterface;
+
+interface AssetInterface extends ResourceInterface
+{
+    const HYDRATE_CLASS = 'Repository\\Release\\Asset';
+
+    /**
+     * @return string
+     */
+    public function url(): string;
+
+    /**
+     * @return string
+     */
+    public function browserDownloadUrl(): string;
+
+    /**
+     * @return int
+     */
+    public function id(): int;
+
+    /**
+     * @return string
+     */
+    public function name(): string;
+
+    /**
+     * @return string
+     */
+    public function label(): string;
+
+    /**
+     * @return string
+     */
+    public function state(): string;
+
+    /**
+     * @return string
+     */
+    public function contentType(): string;
+
+    /**
+     * @return int
+     */
+    public function size(): int;
+
+    /**
+     * @return int
+     */
+    public function downloadCount(): int;
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface;
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface;
+
+    /**
+     * @return User
+     */
+    public function uploader(): User;
+}
diff --git a/src/Resource/Repository/Release/EmptyAsset.php b/src/Resource/Repository/Release/EmptyAsset.php
new file mode 100644
index 0000000000..40ced7c2a0
--- /dev/null
+++ b/src/Resource/Repository/Release/EmptyAsset.php
@@ -0,0 +1,105 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Repository\Release;
+
+use ApiClients\Foundation\Resource\EmptyResourceInterface;
+use DateTimeInterface;
+
+abstract class EmptyAsset implements AssetInterface, EmptyResourceInterface
+{
+    /**
+     * @return string
+     */
+    public function url(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function browserDownloadUrl(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return int
+     */
+    public function id(): int
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function name(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function label(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function state(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return string
+     */
+    public function contentType(): string
+    {
+        return null;
+    }
+
+    /**
+     * @return int
+     */
+    public function size(): int
+    {
+        return null;
+    }
+
+    /**
+     * @return int
+     */
+    public function downloadCount(): int
+    {
+        return null;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function createdAt(): DateTimeInterface
+    {
+        return null;
+    }
+
+    /**
+     * @return DateTimeInterface
+     */
+    public function updatedAt(): DateTimeInterface
+    {
+        return null;
+    }
+
+    /**
+     * @return User
+     */
+    public function uploader(): User
+    {
+        return null;
+    }
+}
diff --git a/src/Resource/Sync/Repository/Release/Asset.php b/src/Resource/Sync/Repository/Release/Asset.php
new file mode 100644
index 0000000000..e20a964503
--- /dev/null
+++ b/src/Resource/Sync/Repository/Release/Asset.php
@@ -0,0 +1,19 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository\Release;
+
+use ApiClients\Client\Github\Resource\Repository\Release\Asset as BaseAsset;
+use ApiClients\Client\Github\Resource\Repository\Release\AssetInterface;
+use ApiClients\Foundation\Hydrator\CommandBus\Command\BuildAsyncFromSyncCommand;
+
+class Asset extends BaseAsset
+{
+    public function refresh(): Asset
+    {
+        return $this->wait($this->handleCommand(
+            new BuildAsyncFromSyncCommand(self::HYDRATE_CLASS, $this)
+        )->then(function (AssetInterface $asset) {
+            return $asset->refresh();
+        }));
+    }
+}
diff --git a/src/Resource/Sync/Repository/Release/EmptyAsset.php b/src/Resource/Sync/Repository/Release/EmptyAsset.php
new file mode 100644
index 0000000000..677ded1a3b
--- /dev/null
+++ b/src/Resource/Sync/Repository/Release/EmptyAsset.php
@@ -0,0 +1,9 @@
+<?php declare(strict_types=1);
+
+namespace ApiClients\Client\Github\Resource\Sync\Repository\Release;
+
+use ApiClients\Client\Github\Resource\Repository\Release\EmptyAsset as BaseEmptyAsset;
+
+class EmptyAsset extends BaseEmptyAsset
+{
+}
diff --git a/yaml/repository-release-asset.yml b/yaml/repository-release-asset.yml
new file mode 100644
index 0000000000..bc0722e17d
--- /dev/null
+++ b/yaml/repository-release-asset.yml
@@ -0,0 +1,17 @@
+class: Repository\Release\Asset
+properties:
+  url: string
+  browser_download_url: string
+  id: int
+  name: string
+  label: string
+  state: string
+  content_type: string
+  size: int
+  download_count: int
+  created_at: DateTimeInterface
+  updated_at: DateTimeInterface
+  uploader:
+    type: User
+    annotations:
+      nested: User
\ No newline at end of file
diff --git a/yaml/repository-release.yml b/yaml/repository-release.yml
index 4cd4113beb..6c9904d4aa 100644
--- a/yaml/repository-release.yml
+++ b/yaml/repository-release.yml
@@ -13,4 +13,7 @@ properties:
     type: User
     annotations:
       nested: User
-  assets: array
+  assets:
+    type: array
+    annotations:
+      collection: Repository\Release\Asset