cunningsoft / generic-list
This library provides the tools needed to create custom iterables without the need to repeat all the boilerplate code.
Requires
- php: ^7.3
Requires (Dev)
- doctrine/coding-standard: ^6.0
- infection/infection: ^0.14.0
- phpstan/phpstan-phpunit: ^0.11
- phpstan/phpstan-shim: ^0.11
- phpstan/phpstan-strict-rules: ^0.11
- phpunit/phpunit: ^8.3
This package is auto-updated.
Last update: 2024-10-07 04:53:36 UTC
README
This library provides the tools needed to create custom iterables without the need to repeat all the boilerplate code.
Installation
Install the library via composer:
php composer.phar require cunningsoft/generic-list
Usage
Unsorted Lists
Create a custom list class (for example for Users):
<?php declare(strict_types=1); namespace MyApp; use ArrayIterator; use Cunningsoft\GenericList\ListConstructor; use Cunningsoft\GenericList\ListType; final class UserList implements ListType { use UnsortedListConstructor; public function getIterator(): ArrayIterator { return $this->list->getIterator(); } protected function getElementType(): string { return User::class; } }
Add common functionality by passing the method call down to the generic list:
public function isEmpty(): self { return $this->list->isEmpty(); }
Add functionality to customize the list to the specific needs:
public function filterOnlyActive(): self { return new self($this->list->filter(static function (User $user): bool { return $user->isActive(); }); }
Now you can use it like this:
$users = new UserList([$userA, $userB, $userC]); if ($users->filterOnlyActive()->isEmpty()) { echo 'No active users!'; }
Sorted Lists
Sorted lists work the same way as unsorted lists, but they use the SortedListConstructor
trait instead and because of that you have to provide a sorting function.
<?php declare(strict_types=1); namespace MyApp; use ArrayIterator; use Cunningsoft\GenericList\ListConstructor; use Cunningsoft\GenericList\ListType; final class SortedByAgeUserList implements ListType { use SortedListConstructor; public function getIterator(): ArrayIterator { return $this->list->getIterator(); } protected function getElementType(): string { return User::class; } protected function getSortFunction(): callable { return static function (User $userA, User $userB): int { return $userA->getAge() <=> $userB->getAge(); }; } }
Now you can use this class in the same way as described above for the unsorted list, but by passing this type of object around you can be sure that it is always in the intended ordered state.
FAQ
Q: Why not simply use arrays?
A: You get type safety and can assign custom behaviour to each list.
Q: Why not simply extend the GenericList
, UnsortedGenericList
or SortedGenericList
?
A: This would create a huge inheritance tree, without any real benefit. This way for every list the exposed behaviour is exactly what it needed for every use case.
Contact
GitHub: https://github.com/dmecke
Twitter: @danielmecke