fet: add Stream::putContents()

Author: kbond

src/Stream.php

@@ -120,6 +120,20 @@ public function contents(?int $length = null, int $offset = -1): string
         return $contents;
     }
 
+    /**
+     * @see \file_put_contents()
+     *
+     * @param resource|null $context
+     */
+    public function putContents(string $filename, int $flags = 0, $context = null): self
+    {
+        if (false === @\file_put_contents($filename, $this->get(), $flags, $context)) {
+            throw new \RuntimeException(\sprintf('Unable to dump contents of stream to "%s".', $filename));
+        }
+
+        return $this;
+    }
+
     /**
      * @see \rewind()
      */

tests/StreamTest.php

@@ -191,4 +191,21 @@ public function is_open_closed(): void
         $this->assertFalse($stream->isOpen());
         $this->assertTrue($stream->isClosed());
     }
+
+    /**
+     * @test
+     */
+    public function put_contents(): void
+    {
+        $file = Stream::tempFile()->uri();
+
+        \file_put_contents($file, '');
+
+        $this->assertFileExists($file);
+        $this->assertSame('', \file_get_contents($file));
+
+        Stream::wrap('content')->putContents($file);
+
+        $this->assertSame('content', \file_get_contents($file));
+    }
 }