2017 © Pedro Peláez
 

library typed-collection

Type-safe collections based on Laravel Collections

image

gamez/typed-collection

Type-safe collections based on Laravel Collections

  • Tuesday, November 7, 2017
  • by jeromegamez
  • Repository
  • 1 Watchers
  • 6 Stars
  • 1,028 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 3 Versions
  • 3 % Grown

The README.md

Type-safe PHP collections based on Laravel Collections

Latest Stable Version Total Downloads Tests Sponsor, (*1)

[!NOTE]
Laravel 11 added the ensure() collection method that verifies that all elements of a collection are of a given type or list of types. However, this verification does not prevent items of different types to be added at a later time., (*2)

[!NOTE]
If you use Laravel collections combined with Larastan/PHPStan, you won't need this library and can just™ annotate your collection classes directly., (*3)

Installation

The package can be installed with Composer:, (*4)

$ composer require gamez/typed-collection

Usage

class Person
{
    public $name;

    public function __construct($name)
    {
        $this->name = $name;
    }
}

$taylor = new Person('Taylor');
$jeffrey = new Person('Jeffrey');

Typed Collections

use Gamez\Illuminate\Support\TypedCollection;

/**
 * @extends TypedCollection<array-key, Person> 
 */
class People extends TypedCollection
{
    protected static array $allowedTypes = [Person::class];
}

$people = People::make([$taylor, $jeffrey])
    ->each(function (Person $person) {
        printf("This is %s.\n", $person->name);
    });
/* Output:
This is Taylor.
This is Jeffrey.
*/

try {
    People::make('Not a person');
} catch (InvalidArgumentException $e) {
    echo $e->getMessage().PHP_EOL;
}
/* Output:
Output: A People collection only accepts items of the following type(s): Person.
*/

Lazy Typed Collections

use Gamez\Illuminate\Support\LazyTypedCollection;

/**
 * @extends LazyTypedCollection<array-key, Person> 
 */
class LazyPeople extends LazyTypedCollection
{
    protected static array $allowedTypes = [Person::class];
}

$lazyPeople = LazyPeople::make([$taylor, $jeffrey])
    ->each(function (Person $person) {
        printf("This is %s.\n", $person->name);
    });
/* Output:
This is Lazy Taylor.
This is Lazy Jeffrey.
*/

try {
    LazyPeople::make('Nope!');
} catch (InvalidArgumentException $e) {
    echo $e->getMessage().PHP_EOL;
}
/* Output:
Output: A People collection only accepts objects of the following type(s): Person.
*/

Mixed collections

/**
 * @extends LazyTypedCollection<array-key, int|string|Person> 
 */
class MixedTypeCollection extends TypedCollection
{
    protected static array $allowedTypes = ['int', 'string', Person::class];
}

Supported types

Supported types are class strings, like Person::class, or types recognized by the get_debug_type() function, int, float, string, bool, and array., (*5)

Helper functions

The typedCollect() helper function enables you to dynamically create typed collections on the fly:, (*6)

$dateTimes = typedCollect([new DateTime(), new DateTime()], DateTimeInterface::class);

For further information on how to use Laravel Collections, have a look at the official documentation., (*7)

The Versions

07/11 2017

dev-master

9999999-dev https://github.com/jeromegamez/typed-collection

Type-safe collections based on Laravel Collections

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel collection typed typesafe type-safe

17/10 2017

2.0

2.0.0.0 https://github.com/jeromegamez/typed-collection

Type-safe collections based on Laravel Collections

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel collection typed typesafe type-safe

31/08 2017

1.0

1.0.0.0 https://github.com/jeromegamez/typed-collection

Type-safe collections based on Laravel Collections

  Sources   Download

MIT

The Requires

 

The Development Requires

laravel collection typed typesafe type-safe