Add Sequence::keyBy() to produce lookup maps keyed by a given selector

[thekid]

This pull request add a keyBy() method to the Seequence class.

Example

useutil\data\Sequence;
$users= [
['tenant' => 'example', 'jwt' => 'ey123...', 'valid' => '2027-01-01'],
['tenant' => 'platform', 'jwt' => 'ey345...', 'valid' => '2026-12-14'],
];
// Before$claims= Sequence::of($users)->toMap(fn($user) => yield$user['tenant'] => $user);
// After$claims= Sequence::of($users)->keyBy('tenant');
// Both return the following:// [// 'example' => ['tenant' => 'example', ...],// 'platform' => ['tenant' => 'example', ...],// ]

Overloads

• keyBy('tenant') - uses the tenant field as keys and the docunents as associated values
• keyBy(['tenant' => 'jwt']) will use the tenant field as keys and the jwt key as values
• keyBy(fn($c) => [$c['tenant'] => $c['jwt']]) - same as above but shows the full flexibility
• keyBy(function($c) { yield $c['tenant'] => $c['jwt']; }) - also works with generators

See also

• Add keyBy() to key the documents by the given key mongodb#69 (comment)
• https://laravel.com/docs/13.x/collections#method-keyby
• https://www.geeksforgeeks.org/javascript/lodash-_-keyby-method/
• https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.sequences/associate-by.html

[thekid]

Released in https://github.com/xp-forge/sequence/releases/tag/v10.5.0