Add shortcut for parsing a valid open stream

Author: veewee

src/ResourceStream.php

@@ -31,6 +31,22 @@ public function __construct(
         $this->unwrap();
     }
 
+    /**
+     * @param mixed $resource
+     *
+     * @psalm-assert resource $resource
+     *
+     * @throws RuntimeException
+     */
+    public static function parse(mixed $resource): self
+    {
+        if (!is_resource($resource)) {
+            throw ResourceStreamException::noResource();
+        }
+
+        return new self($resource);
+    }
+
     public function __destruct()
     {
         if (!$this->keepAlive) {

tests/Unit/ResourceStreamTest.php

@@ -24,6 +24,22 @@ public function it_detects_closed_streams_during_construction(): void
         new ResourceStream($f);
     }
 
+    #[Test]
+    public function it_can_parse_a_valid_stream(): void
+    {
+        $f = fopen('php://memory', 'r');
+        $resourceStream = ResourceStream::parse($f);
+
+        self::assertSame($f, $resourceStream->unwrap());
+    }
+
+    #[Test]
+    public function it_can_parse_a_mixed_value_to_be_a_stream(): void
+    {
+        $this->expectException(ResourceStreamException::class);
+        ResourceStream::parse('no-stream');
+    }
+
     #[Test]
     public function it_can_unwrap_a_stream(): void
     {