Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/koriym/koriym.loop
Converts iterable data sets (e.g., database results, CSV files) into an entity list generator with loop context (isFirst, isLast, index, iteration)
https://github.com/koriym/koriym.loop
entity generator php
Last synced: 19 days ago
JSON representation
Converts iterable data sets (e.g., database results, CSV files) into an entity list generator with loop context (isFirst, isLast, index, iteration)
- Host: GitHub
- URL: https://github.com/koriym/koriym.loop
- Owner: koriym
- License: mit
- Created: 2022-03-10T01:09:59.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2024-06-09T04:44:22.000Z (5 months ago)
- Last Synced: 2024-10-11T08:14:17.526Z (about 1 month ago)
- Topics: entity, generator, php
- Language: PHP
- Homepage: https://packagist.org/packages/koriym/loop
- Size: 65.4 KB
- Stars: 7
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Koriym.Loop
[](https://codecov.io/gh/koriym/Koriym.Loop)
[](https://shepherd.dev/github/koriym/Koriym.Loop)
Koriym.Loop is a PHP library that converts various iterable data sets, such as database result sets, CSV files, or any other iterable structures, into an entity list generator. This makes it easy to use in views by providing looping information such as isFirst, isLast, index, and iteration, similar to the loop processing found in template engines like Twig.
## Installation
```bash
composer require koriym/loop
```
## Usage
## Basic Example
The following example demonstrates how to use Koriym.Loop with a simple User class and a result set:
```php
class User
{
public function __construct(
public readonly int $id,
public readonly string $name
){}
}
// Database result sets or csv content
$resultSet = [
['id' => 1, 'name' => 'ray'],
['id' => 2, 'name' => 'bear'],
['id' => 3, 'name' => 'alps'],
];
/** @var Generator $users */
$users = (new LoopGen)($resultSet, User::class);
foreach ($users as $user) {
echo $user->name;
}
```
### Loop information
Loop information can be accessed from the array keys, providing details such as whether the current item is the first or last in the list:
```php
/** @var Loop $loop */
foreach ($users as $loop => $user) {
echo match(true) {
$loop->isFirst && $loop->isLast => "
- {$user->name}
$loop->isFirst => "
- {$user->name}",
$loop->isLast => " - {$user->name}
default => "
};
}
```
### Loop Properties
| property | type | Description |
| --------- | ---- | ---------------------- |
| isFirst | bool | Is first on the list? |
| isLast | bool | Is last on the list? |
| index | int | Loop count of 0 origin |
| iteration | int | Loop count of 1 origin |
## Injection
Dependent instances can be injected into the entity by specifying them as the third argument.
Specify the key as the name of the parameter and the value as the instance.
```php
$dependencies = [
$varName => $insntance,
'dateTime' => new DateTime(), // DateTime instance is injected
];
$users = (new LoopGen)($resultSet, User::class, $dependencies);
```
## Iterator Support
Koriym.Loop supports iterators as well as arrays. Here's an example using a CSV iterator:
```php
class Row
{
public function __construct(
public readonly int $id,
public readonly string $name
){}
}
// Retrieve contents of csv file as list
$csvIterator = new ogrrd\CsvIterator\CsvIterator($csvFilePath);
/** @var list $csvRowList */
$csvRowList = (new LoopGen)($csvIterator, Row::class);
foreach ($csvRowList as $loop => $row) {
if ($loop->isFirst) {
continue; // Skip header
}
echo $row->name;
}
```
This library provides a flexible and convenient way to handle looping through result sets and other iterable data structures in PHP, with additional context information about the loop's state.