feat: Add fromFile static constructor.

docs/pages/api.rst

@@ -28,6 +28,15 @@ Create a collection from a callable.
 
     $collection = Collection::fromCallable($callback);
 
+fromFile
+~~~~~~~~~~~~
+
+Create a collection from a file.
+
+.. code-block:: php
+
+    Collection::fromFile('http://loripsum.net/api');
+
 fromIterable
 ~~~~~~~~~~~~
 

docs/pages/usage.rst

@@ -894,3 +894,20 @@ Collatz conjecture
         );
 
     print_r($c->all()); // [25, 76, 38, 19, 58, 29, 88, 44, 22, 11, 34, 17, 52, 26, 13, 40, 20, 10, 5, 16, 8, 4, 2, 1]
+
+Read a file
+~~~~~~~~~~~
+
+.. code-block:: php
+
+    <?php
+
+    declare(strict_types=1);
+
+    include 'vendor/autoload.php';
+
+    use loophp\collection\Collection;
+
+    $c = Collection::fromFile('/path/to/file')
+        ->lines()
+        ->count();

spec/loophp/collection/CollectionSpec.php

@@ -146,6 +146,16 @@ static function ($carry, $key, $value) {
             );
     }
 
+    public function it_can_be_constructed_from_a_file(): void
+    {
+        $this::fromFile(__DIR__ . '/../../fixtures/sample.txt')
+            ->shouldIterateAs([
+                'a',
+                'b',
+                'c',
+            ]);
+    }
+
     public function it_can_be_constructed_from_a_stream(): void
     {
         $string = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit.';

src/Collection.php

@@ -440,6 +440,16 @@ static function (callable $callable, array $parameters): Generator {
         );
     }
 
+    public static function fromFile(string $filepath): Collection
+    {
+        return new self(
+            static function (string $filepath): Generator {
+                return yield from new ResourceIterator(fopen($filepath, 'rb'));
+            },
+            $filepath
+        );
+    }
+
     public static function fromIterable(iterable $iterable): Collection
     {
         return new self(