Merge pull request #31 from packagist/t/dependents-endpoints

Package: add endpoints to fetch dependents

Author: wissem

README.md

@@ -266,6 +266,13 @@ $subrepositoryName = 'subrepository';
 $client->subrepositories()->packages()->remove($subrepositoryName, 'acme-website/package');
 ```
 
+##### List all dependents of a subrepository package
+```php
+$subrepositoryName = 'subrepository';
+$client->subrepositories()->packages()->listDependents($subrepositoryName, 'acme-website/package');
+```
+Returns a list of packages.
+
 ##### List a subrepositories's authentication tokens
 ```php
 $subrepositoryName = 'subrepository';
@@ -431,6 +438,12 @@ Returns a new job.
 $client->packages()->remove('acme-website/package');
 ```
 
+##### List all dependents of a package
+```php
+$client->packages()->listDependents('acme-website/package');
+```
+Returns a list of packages.
+
 ##### List all customers with access to a package
 ```php
 $client->packages()->listCustomers('acme-website/package');

src/Api/Packages.php

@@ -103,4 +103,9 @@ public function listCustomers($packageName)
     {
         return $this->get(sprintf('/packages/%s/customers/', $packageName));
     }
+
+    public function listDependents($packageName)
+    {
+        return $this->get(sprintf('/packages/%s/dependents/', $packageName));
+    }
 }

src/Api/Subrepositories/Packages.php

@@ -56,4 +56,9 @@ public function remove($subrepositoryName, $packageName)
     {
         return $this->delete(sprintf('/subrepositories/%s/packages/%s/', $subrepositoryName, $packageName));
     }
+
+    public function listDependents($subrepositoryName, $packageName)
+    {
+        return $this->get(sprintf('/subrepositories/%s/packages/%s/dependents/', $subrepositoryName, $packageName));
+    }
 }

tests/Api/PackagesTest.php

@@ -207,6 +207,26 @@ public function testListPackages()
         $this->assertSame($expected, $api->listCustomers('composer/composer'));
     }
 
+    public function testListDependents()
+    {
+        $packageName = 'acme-website/core-package';
+        $expected = [
+            [
+                'id' => 1,
+                'name' => 'acme-website/package',
+            ],
+        ];
+
+        /** @var Packages&\PHPUnit_Framework_MockObject_MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with($this->equalTo('/packages/acme-website/core-package/dependents/'))
+            ->willReturn($expected);
+
+        $this->assertSame($expected, $api->listDependents($packageName));
+    }
+
     protected function getApiClass()
     {
         return Packages::class;

tests/Api/Subrepositories/PackagesTest.php

@@ -191,6 +191,27 @@ public function testRemove()
         $this->assertSame($expected, $api->remove($subrepositoryName, 'acme-website/package'));
     }
 
+    public function testListDependents()
+    {
+        $subrepositoryName = 'subrepository';
+        $packageName = 'acme-website/core-package';
+        $expected = [
+            [
+                'id' => 1,
+                'name' => 'acme-website/package',
+            ],
+        ];
+
+        /** @var Packages&\PHPUnit_Framework_MockObject_MockObject $api */
+        $api = $this->getApiMock();
+        $api->expects($this->once())
+            ->method('get')
+            ->with($this->equalTo('/subrepositories/subrepository/packages/acme-website/core-package/dependents/'))
+            ->willReturn($expected);
+
+        $this->assertSame($expected, $api->listDependents($subrepositoryName, $packageName));
+    }
+
     protected function getApiClass()
     {
         return Packages::class;