Added literal type

[norberttech]

Resolves: #1729

Change Log

---

Added

• literal type to types library

Fixed

Changed

Removed

Deprecated

Security

[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.799mb +0.05%  | 416.757ms +0.07% | ±0.79% +66.52% |
| ExcelExtractorBench   | bench_extract_10k_ods  | 1    | 3   | 65.510mb +0.00% | 1.043s -1.15%    | ±0.16% -84.85% |
| ExcelExtractorBench   | bench_extract_10k_xlsx | 1    | 3   | 67.555mb +0.00% | 1.687s +1.05%    | ±0.62% +14.49% |
| JsonExtractorBench    | bench_extract_10k      | 1    | 3   | 5.083mb +0.04%  | 1.175s +2.17%    | ±0.86% -11.47% |
| ParquetExtractorBench | bench_extract_10k      | 1    | 3   | 86.353mb +0.00% | 919.485ms +1.20% | ±0.25% -30.74% |
| TextExtractorBench    | bench_extract_10k      | 1    | 3   | 4.530mb +0.05%  | 38.596ms +0.46%  | ±0.56% -65.75% |
| XmlExtractorBench     | bench_extract_10k      | 1    | 3   | 4.525mb +0.05%  | 607.885ms +1.24% | ±1.35% -49.87% |
+-----------------------+------------------------+------+-----+-----------------+------------------+----------------+

Transformers

+---------------------------------+--------------------------+------+-----+------------------+-----------------+-----------------+
| benchmark                       | subject                  | revs | its | mem_peak         | mode            | rstdev          |
+---------------------------------+--------------------------+------+-----+------------------+-----------------+-----------------+
| RenameEachEntryTransformerBench | bench_transform_10k_rows | 1    | 3   | 18.529mb +0.01%  | 72.854ms +1.11% | ±1.28% +385.89% |
| RenameEntryTransformerBench     | bench_transform_10k_rows | 1    | 3   | 123.267mb +0.00% | 65.201ms +1.21% | ±0.61% +25.32%  |
+---------------------------------+--------------------------+------+-----+------------------+-----------------+-----------------+

Loaders

+--------------------+----------------+------+-----+------------------+------------------+-----------------+
| benchmark          | subject        | revs | its | mem_peak         | mode             | rstdev          |
+--------------------+----------------+------+-----+------------------+------------------+-----------------+
| CSVLoaderBench     | bench_load_10k | 1    | 3   | 62.459mb +0.00%  | 86.785ms +1.90%  | ±1.32% +10.70%  |
| JsonLoaderBench    | bench_load_10k | 1    | 3   | 79.760mb +0.00%  | 100.702ms +0.69% | ±2.51% +108.59% |
| ParquetLoaderBench | bench_load_10k | 1    | 3   | 166.236mb +0.00% | 20.535s +0.19%   | ±0.22% +147.31% |
| TextLoaderBench    | bench_load_10k | 1    | 3   | 17.836mb +0.01%  | 31.316ms +2.01%  | ±3.44% +588.68% |
+--------------------+----------------+------+-----+------------------+------------------+-----------------+

Building Blocks

+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+
| benchmark         | subject                    | revs | its | mem_peak         | mode             | rstdev          |
+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+
| TypeDetectorBench | bench_type_detector        | 1    | 3   | 42.102mb +0.01%  | 427.789ms +0.08% | ±0.45% -34.96%  |
| TypeDetectorBench | bench_type_detector        | 1    | 3   | 11.479mb +0.02%  | 85.663ms +0.89%  | ±0.19% -82.55%  |
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 101.808mb +0.00% | 650.058ms +0.76% | ±0.39% -65.72%  |
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 53.159mb +0.00%  | 329.379ms +0.07% | ±0.40% -48.77%  |
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 14.409mb +0.02%  | 70.097ms +1.17%  | ±0.77% +123.05% |
| RowsBench         | bench_chunk_10_on_10k      | 2    | 3   | 93.420mb +0.00%  | 3.677ms +11.54%  | ±0.71% -72.63%  |
| RowsBench         | bench_diff_left_1k_on_10k  | 2    | 3   | 110.791mb +0.00% | 241.007ms +1.21% | ±0.59% +85.39%  |
| RowsBench         | bench_diff_right_1k_on_10k | 2    | 3   | 93.511mb +0.00%  | 24.572ms +1.57%  | ±0.76% -24.46%  |
| RowsBench         | bench_drop_1k_on_10k       | 2    | 3   | 94.295mb +0.00%  | 1.541ms +3.74%   | ±3.05% +29.39%  |
| RowsBench         | bench_drop_right_1k_on_10k | 2    | 3   | 94.295mb +0.00%  | 1.681ms +19.90%  | ±1.09% -50.46%  |
| RowsBench         | bench_entries_on_10k       | 2    | 3   | 92.456mb +0.00%  | 3.430ms +3.64%   | ±1.72% -20.55%  |
| RowsBench         | bench_filter_on_10k        | 2    | 3   | 92.985mb +0.00%  | 15.537ms +1.55%  | ±1.12% -24.99%  |
| RowsBench         | bench_find_on_10k          | 2    | 3   | 92.985mb +0.00%  | 15.873ms +3.99%  | ±1.10% +111.74% |
| RowsBench         | bench_find_one_on_10k      | 10   | 3   | 91.673mb +0.00%  | 2.000μs +5.60%   | ±0.00% -100.00% |
| RowsBench         | bench_first_on_10k         | 10   | 3   | 91.673mb +0.00%  | 0.400μs 0.00%    | ±0.00% 0.00%    |
| RowsBench         | bench_flat_map_on_1k       | 2    | 3   | 100.734mb +0.00% | 14.082ms -0.68%  | ±0.37% -59.11%  |
| RowsBench         | bench_map_on_10k           | 2    | 3   | 130.161mb +0.00% | 66.892ms +2.62%  | ±1.70% +98.84%  |
| RowsBench         | bench_merge_1k_on_10k      | 2    | 3   | 93.504mb +0.00%  | 1.617ms +41.10%  | ±1.61% -48.00%  |
| RowsBench         | bench_partition_by_on_10k  | 2    | 3   | 96.873mb +0.00%  | 63.960ms +3.37%  | ±2.74% +187.96% |
| RowsBench         | bench_remove_on_10k        | 2    | 3   | 94.557mb +0.00%  | 3.815ms +11.39%  | ±1.88% +181.99% |
| RowsBench         | bench_sort_asc_on_1k       | 2    | 3   | 92.036mb +0.00%  | 39.790ms -2.03%  | ±0.60% -48.68%  |
| RowsBench         | bench_sort_by_on_1k        | 2    | 3   | 92.036mb +0.00%  | 39.913ms -0.38%  | ±1.10% +333.50% |
| RowsBench         | bench_sort_desc_on_1k      | 2    | 3   | 92.036mb +0.00%  | 40.405ms +0.65%  | ±3.12% +519.44% |
| RowsBench         | bench_sort_entries_on_1k   | 2    | 3   | 94.116mb +0.00%  | 8.172ms +1.41%   | ±0.60% -63.77%  |
| RowsBench         | bench_sort_on_1k           | 2    | 3   | 91.866mb +0.00%  | 29.660ms +0.08%  | ±2.09% +0.23%   |
| RowsBench         | bench_take_1k_on_10k       | 10   | 3   | 91.673mb +0.00%  | 14.510μs -0.62%  | ±3.05% +81.51%  |
| RowsBench         | bench_take_right_1k_on_10k | 10   | 3   | 91.673mb +0.00%  | 17.296μs +11.52% | ±2.36% -17.26%  |
| RowsBench         | bench_unique_on_1k         | 2    | 3   | 110.792mb +0.00% | 240.663ms -1.03% | ±0.24% -26.78%  |
+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+

[codecov]

Codecov Report

Attention: Patch coverage is 0% with 35 lines in your changes missing coverage. Please review.

Project coverage is 81.78%. Comparing base (52096ec) to head (c2ac037).
Report is 3 commits behind head on 1.x.

✅ All tests successful. No failed tests found.

Additional details and impacted files

@@            Coverage Diff             @@
##              1.x    #1731      +/-   ##
==========================================
- Coverage   81.93%   81.78%   -0.15%     
==========================================
  Files         712      713       +1     
  Lines       19343    19378      +35     
==========================================
+ Hits        15848    15849       +1     
- Misses       3495     3529      +34     

Components	Coverage Δ
etl	88.39% <ø> (ø)
cli	84.42% <ø> (ø)
lib-array-dot	94.53% <ø> (ø)
lib-azure-sdk	62.56% <ø> (ø)
lib-doctrine-dbal-bulk	93.49% <ø> (ø)
lib-filesystem	78.02% <ø> (ø)
lib-types	53.45% <0.00%> (-1.37%)	⬇️
lib-parquet	84.37% <ø> (ø)
lib-parquet-viewer	82.02% <ø> (ø)
lib-snappy	91.16% <ø> (+0.46%)	⬆️
bridge-filesystem-async-aws	90.38% <ø> (ø)
bridge-filesystem-azure	89.92% <ø> (ø)
bridge-monolog-http	98.11% <ø> (ø)
symfony-http-foundation	74.41% <ø> (ø)
adapter-chartjs	86.45% <ø> (ø)
adapter-csv	90.37% <ø> (ø)
adapter-doctrine	89.95% <ø> (ø)
adapter-elasticsearch	97.19% <ø> (ø)
adapter-google-sheet	83.87% <ø> (ø)
adapter-http	59.15% <ø> (ø)
adapter-json	90.62% <ø> (ø)
adapter-logger	53.84% <ø> (ø)
adapter-meilisearch	97.75% <ø> (ø)
adapter-parquet	78.64% <ø> (ø)
adapter-text	84.44% <ø> (ø)
adapter-xml	83.15% <ø> (ø)

🚀 New features to boost your workflow:

• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.