Added withValue on Entry to simplify converting entry values through map

[norberttech]

Change Log

Added

• Entry::withValue(mixed $value) : self

Fixed

Changed

Removed

Deprecated

Security

---

Description

[github-actions]

Flow PHP - Benchmarks

^{_{Results of the benchmarks from this PR are compared with the results from 1.x branch.}}

Extractors

+-----------------------+-------------------+------+-----+------------------+------------------+-----------------+
| benchmark             | subject           | revs | its | mem_peak         | mode             | rstdev          |
+-----------------------+-------------------+------+-----+------------------+------------------+-----------------+
| CSVExtractorBench     | bench_extract_10k | 1    | 3   | 4.640mb +0.05%   | 519.046ms -0.62% | ±2.16% -24.24%  |
| JsonExtractorBench    | bench_extract_10k | 1    | 3   | 4.736mb +0.08%   | 1.085s -0.84%    | ±1.98% +39.11%  |
| ParquetExtractorBench | bench_extract_10k | 1    | 3   | 102.369mb +0.00% | 943.726ms -0.31% | ±1.05% -48.88%  |
| TextExtractorBench    | bench_extract_10k | 1    | 3   | 4.368mb +0.03%   | 33.235ms -0.97%  | ±0.38% -64.51%  |
| XmlExtractorBench     | bench_extract_10k | 1    | 3   | 4.349mb +0.03%   | 680.755ms +3.61% | ±2.92% +491.09% |
+-----------------------+-------------------+------+-----+------------------+------------------+-----------------+

Transformers

+-----------------------------+--------------------------+------+-----+------------------+-----------------+---------------+
| benchmark                   | subject                  | revs | its | mem_peak         | mode            | rstdev        |
+-----------------------------+--------------------------+------+-----+------------------+-----------------+---------------+
| RenameEntryTransformerBench | bench_transform_10k_rows | 1    | 3   | 116.643mb +0.00% | 59.637ms -1.53% | ±2.10% -9.67% |
+-----------------------------+--------------------------+------+-----+------------------+-----------------+---------------+

Loaders

+--------------------+----------------+------+-----+------------------+------------------+-----------------+
| benchmark          | subject        | revs | its | mem_peak         | mode             | rstdev          |
+--------------------+----------------+------+-----+------------------+------------------+-----------------+
| CSVLoaderBench     | bench_load_10k | 1    | 3   | 54.837mb +0.00%  | 140.894ms -0.53% | ±2.20% +196.71% |
| JsonLoaderBench    | bench_load_10k | 1    | 3   | 90.471mb +0.00%  | 117.048ms -0.13% | ±1.03% -14.55%  |
| ParquetLoaderBench | bench_load_10k | 1    | 3   | 255.240mb +0.00% | 21.644s -1.42%   | ±0.33% -80.81%  |
| TextLoaderBench    | bench_load_10k | 1    | 3   | 17.559mb +0.01%  | 44.198ms +0.08%  | ±0.60% -66.60%  |
+--------------------+----------------+------+-----+------------------+------------------+-----------------+

Building Blocks

+-------------------------+----------------------------+------+-----+------------------+------------------+------------------+
| benchmark               | subject                    | revs | its | mem_peak         | mode             | rstdev           |
+-------------------------+----------------------------+------+-----+------------------+------------------+------------------+
| RowsBench               | bench_chunk_10_on_10k      | 2    | 3   | 87.392mb +0.00%  | 3.553ms -3.19%   | ±1.60% +113.02%  |
| RowsBench               | bench_diff_left_1k_on_10k  | 2    | 3   | 102.995mb +0.00% | 187.719ms +0.62% | ±0.20% -58.25%   |
| RowsBench               | bench_diff_right_1k_on_10k | 2    | 3   | 85.715mb +0.00%  | 18.942ms +1.01%  | ±0.38% -10.89%   |
| RowsBench               | bench_drop_1k_on_10k       | 2    | 3   | 88.632mb +0.00%  | 1.988ms -2.88%   | ±3.27% +197.91%  |
| RowsBench               | bench_drop_right_1k_on_10k | 2    | 3   | 88.632mb +0.00%  | 2.161ms -1.05%   | ±2.14% -40.95%   |
| RowsBench               | bench_entries_on_10k       | 2    | 3   | 85.744mb +0.00%  | 2.909ms -10.69%  | ±2.42% -35.74%   |
| RowsBench               | bench_filter_on_10k        | 2    | 3   | 86.273mb +0.00%  | 15.140ms -21.63% | ±1.19% -37.27%   |
| RowsBench               | bench_find_on_10k          | 2    | 3   | 86.273mb +0.00%  | 15.365ms -21.92% | ±2.18% +112.44%  |
| RowsBench               | bench_find_one_on_10k      | 10   | 3   | 84.176mb +0.00%  | 1.806μs -4.64%   | ±2.57% +1.82%    |
| RowsBench               | bench_first_on_10k         | 10   | 3   | 84.176mb +0.00%  | 0.400μs 0.00%    | ±0.00% 0.00%     |
| RowsBench               | bench_flat_map_on_1k       | 2    | 3   | 93.527mb +0.00%  | 13.101ms -2.75%  | ±0.33% -82.35%   |
| RowsBench               | bench_map_on_10k           | 2    | 3   | 122.897mb +0.00% | 63.853ms -0.04%  | ±0.91% +21.98%   |
| RowsBench               | bench_merge_1k_on_10k      | 2    | 3   | 86.792mb +0.00%  | 1.732ms +4.67%   | ±2.03% -13.36%   |
| RowsBench               | bench_partition_by_on_10k  | 2    | 3   | 90.144mb +0.00%  | 64.354ms -0.24%  | ±0.74% +54.87%   |
| RowsBench               | bench_remove_on_10k        | 2    | 3   | 88.894mb +0.00%  | 4.564ms +4.52%   | ±3.62% +154.07%  |
| RowsBench               | bench_sort_asc_on_1k       | 2    | 3   | 84.326mb +0.00%  | 39.543ms -1.42%  | ±1.61% +45.67%   |
| RowsBench               | bench_sort_by_on_1k        | 2    | 3   | 84.326mb +0.00%  | 40.560ms +1.61%  | ±1.86% -23.19%   |
| RowsBench               | bench_sort_desc_on_1k      | 2    | 3   | 84.326mb +0.00%  | 40.031ms -5.35%  | ±0.87% -62.15%   |
| RowsBench               | bench_sort_entries_on_1k   | 2    | 3   | 86.618mb +0.00%  | 7.591ms +0.74%   | ±1.41% -23.39%   |
| RowsBench               | bench_sort_on_1k           | 2    | 3   | 84.176mb +0.00%  | 29.325ms -1.62%  | ±1.48% -25.54%   |
| RowsBench               | bench_take_1k_on_10k       | 10   | 3   | 84.176mb +0.00%  | 14.020μs -2.27%  | ±1.22% -59.46%   |
| RowsBench               | bench_take_right_1k_on_10k | 10   | 3   | 84.176mb +0.00%  | 16.080μs +0.23%  | ±1.05% -48.28%   |
| RowsBench               | bench_unique_on_1k         | 2    | 3   | 102.996mb +0.00% | 189.490ms -0.82% | ±2.27% +175.75%  |
| TypeDetectorBench       | bench_type_detector        | 1    | 3   | 53.218mb +0.00%  | 392.364ms -0.34% | ±1.61% +227.27%  |
| TypeDetectorBench       | bench_type_detector        | 1    | 3   | 13.484mb +0.00%  | 79.335ms -1.48%  | ±1.27% -0.61%    |
| NativeEntryFactoryBench | bench_entry_factory        | 1    | 3   | 107.480mb +0.00% | 483.780ms -0.54% | ±1.20% -18.70%   |
| NativeEntryFactoryBench | bench_entry_factory        | 1    | 3   | 55.838mb +0.01%  | 242.233ms +2.74% | ±3.23% +1446.49% |
| NativeEntryFactoryBench | bench_entry_factory        | 1    | 3   | 14.676mb +0.03%  | 54.040ms +3.22%  | ±0.60% -69.64%   |
+-------------------------+----------------------------+------+-----+------------------+------------------+------------------+