Add new exception and update interfaces

Author: Andreas Frömer

CHANGELOG.md

@@ -2,6 +2,20 @@
 
 ## [Unreleased] - TBA
 ### Added
+### Changed
+### Removed
+
+## [0.2.0] - TBA
+### Added
+- Added `LinkInterface::getLineNumber(): int`
+- Added `PackageInterface::getRequire(string $name): LinkInterface`
+- Added `ContractsExceptionInterface`
+- Added `LinkNotFoundException`
+### Changed
+### Removed
+
+## [0.1.0]
+### Added
 - Added `LinkInterface`
 - Added `PackageInterface`
 - Added `RepositoryInterface`

src/Exception/ContractsExceptionInterface.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ComposerUnused\Contracts\Exception;
+
+use Throwable;
+
+interface ContractsExceptionInterface extends Throwable
+{
+}

src/Exception/LinkNotFoundException.php

@@ -0,0 +1,15 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ComposerUnused\Contracts\Exception;
+
+use RuntimeException;
+
+final class LinkNotFoundException extends RuntimeException implements ContractsExceptionInterface
+{
+    public static function fromMissingLink(string $name): self
+    {
+        return new self(sprintf('Link with name "%s" is not required', $name));
+    }
+}

src/LinkInterface.php

@@ -7,4 +7,9 @@
 interface LinkInterface
 {
     public function getTarget(): string;
+
+    /**
+     * Returns the line number of the target from composer.json
+     */
+    public function getLineNumber(): int;
 }

src/PackageInterface.php

@@ -4,6 +4,8 @@
 
 namespace ComposerUnused\Contracts;
 
+use ComposerUnused\Contracts\Exception\LinkNotFoundException;
+
 interface PackageInterface
 {
     /**
@@ -22,4 +24,9 @@ public function getRequires(): array;
      * @return array<string>
      */
     public function getSuggests(): array;
+
+    /**
+     * @throws LinkNotFoundException
+     */
+    public function getRequire(string $name): LinkInterface;
 }