Add allCandidates() and discoveries() methods

Author: evansims

src/Contracts/Implementations/Psr17/FactoriesContract.php

@@ -17,11 +17,23 @@ interface FactoriesContract 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.
      */
     public static function candidates(): CandidatesCollection;
 
+    /**
+     * Returns an array with all discovered implementations.
+     *
+     * @return CandidateEntity[]
+     */
+    public static function discoveries(): array;
+
     /**
      * Prefer a package over all others.
      *

src/Implementations/Psr17/RequestFactories.php

@@ -13,9 +13,10 @@
 
 final class RequestFactories extends Implementation implements RequestFactoriesContract
 {
-    private static ?CandidatesCollection $candidates                    = null;
-    private static ?RequestFactoryInterface $singleton                  = null;
-    private static ?RequestFactoryInterface $using                      = null;
+    private static ?CandidatesCollection    $candidates         = null;
+    private static ?CandidatesCollection    $extendedCandidates = null;
+    private static ?RequestFactoryInterface $singleton          = null;
+    private static ?RequestFactoryInterface $using              = null;
 
     public static function add(CandidateEntity $candidate): void
     {
@@ -24,6 +25,21 @@ public static function add(CandidateEntity $candidate): void
         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
      */
@@ -122,6 +138,11 @@ public static function discover(): ?RequestFactoryInterface
         return Discover::httpRequestFactory();
     }
 
+    public static function discoveries(): array
+    {
+        return Discover::httpRequestFactories();
+    }
+
     public static function prefer(string $package): void
     {
         self::$candidates ??= CandidatesCollection::create();

src/Implementations/Psr17/ResponseFactories.php

@@ -13,16 +13,33 @@
 
 final class ResponseFactories extends Implementation implements ResponseFactoriesContract
 {
-    private static ?CandidatesCollection $candidates                     = null;
-    private static ?ResponseFactoryInterface $singleton                  = null;
-    private static ?ResponseFactoryInterface $using                      = null;
+    private static ?CandidatesCollection     $candidates         = null;
+    private static ?CandidatesCollection     $extendedCandidates = null;
+    private static ?ResponseFactoryInterface $singleton          = null;
+    private static ?ResponseFactoryInterface $using              = null;
 
     public static function add(CandidateEntity $candidate): void
     {
+        self::$candidates ??= CandidatesCollection::create();
         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
      */
@@ -121,6 +138,11 @@ public static function discover(): ?ResponseFactoryInterface
         return Discover::httpResponseFactory();
     }
 
+    public static function discoveries(): array
+    {
+        return Discover::httpResponseFactories();
+    }
+
     public static function prefer(string $package): void
     {
         self::$candidates ??= CandidatesCollection::create();

src/Implementations/Psr17/StreamFactories.php

@@ -13,16 +13,33 @@
 
 final class StreamFactories extends Implementation implements StreamFactoriesContract
 {
-    private static ?CandidatesCollection $candidates                   = null;
-    private static ?StreamFactoryInterface $singleton                  = null;
-    private static ?StreamFactoryInterface $using                      = null;
+    private static ?CandidatesCollection   $candidates         = null;
+    private static ?CandidatesCollection   $extendedCandidates = null;
+    private static ?StreamFactoryInterface $singleton          = null;
+    private static ?StreamFactoryInterface $using              = null;
 
     public static function add(CandidateEntity $candidate): void
     {
+        self::$candidates ??= CandidatesCollection::create();
         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
      */
@@ -121,6 +138,11 @@ public static function discover(): ?StreamFactoryInterface
         return Discover::httpStreamFactory();
     }
 
+    public static function discoveries(): array
+    {
+        return Discover::httpStreamFactories();
+    }
+
     public static function prefer(string $package): void
     {
         self::$candidates ??= CandidatesCollection::create();