Add allCandidates() and discoveries() methods

Author: evansims

src/Contracts/Implementations/Psr18/ClientsContract.php

@@ -18,6 +18,11 @@ interface ClientsContract extends ImplementationContract
      */
     public static function add(CandidateEntity $candidate): void;
 
+    /**
+     * Return all potential candidates, including those that cannot be instantiated automatically.
+     */
+    public static function allCandidates(): CandidatesCollection;
+
     /**
      * Return the candidates collection.
      */
@@ -28,6 +33,13 @@ public static function candidates(): CandidatesCollection;
      */
     public static function discover(): ?ClientInterface;
 
+    /**
+     * Returns an array with all discovered implementations.
+     *
+     * @return CandidateEntity[]
+     */
+    public static function discoveries(): array;
+
     /**
      * Prefer a package over all others.
      *

src/Implementations/Psr18/Clients.php

@@ -13,16 +13,32 @@
 
 final class Clients extends Implementation implements ClientsContract
 {
-    private static ?CandidatesCollection $candidates                     = null;
-    private static ?ClientInterface $singleton                           = null;
-    private static ?ClientInterface $using                               = null;
+    private static ?CandidatesCollection $candidates         = null;
+    private static ?CandidatesCollection $extendedCandidates = null;
+    private static ?ClientInterface      $singleton          = null;
+    private static ?ClientInterface      $using              = null;
 
     public static function add(CandidateEntity $candidate): void
     {
         parent::add($candidate);
         self::use(null);
     }
 
+    /**
+     * @psalm-suppress MixedInferredReturnType,MixedReturnStatement
+     */
+    public static function allCandidates(): CandidatesCollection
+    {
+        if (null !== self::$extendedCandidates) {
+            return self::$extendedCandidates;
+        }
+
+        self::$extendedCandidates = CandidatesCollection::create();
+        self::$extendedCandidates->set(self::candidates());
+
+        return self::$extendedCandidates;
+    }
+
     /**
      * @psalm-suppress MixedInferredReturnType,MixedReturnStatement
      */
@@ -129,6 +145,11 @@ public static function discover(): ?ClientInterface
         return Discover::httpClient();
     }
 
+    public static function discoveries(): array
+    {
+        return Discover::httpClients();
+    }
+
     public static function prefer(string $package): void
     {
         self::$candidates ??= CandidatesCollection::create();