Unify types test suite

[norberttech]

Change Log

Added

• Types Library architecture documnetation

Fixed

Changed

• Unified types test suite
• Moved Type interface to Flow\Types namespace

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.777mb +0.01%  | 415.584ms -4.71% | ±0.20% -84.61%  |
| ExcelExtractorBench   | bench_extract_10k_ods  | 1    | 3   | 65.488mb +0.00% | 1.052s -0.16%    | ±0.85% +265.91% |
| ExcelExtractorBench   | bench_extract_10k_xlsx | 1    | 3   | 67.534mb +0.00% | 1.674s -1.73%    | ±0.64% +20.11%  |
| JsonExtractorBench    | bench_extract_10k      | 1    | 3   | 5.021mb +0.01%  | 1.270s -2.11%    | ±0.53% +33.09%  |
| ParquetExtractorBench | bench_extract_10k      | 1    | 3   | 86.323mb +0.00% | 934.528ms -0.27% | ±0.43% +23.75%  |
| TextExtractorBench    | bench_extract_10k      | 1    | 3   | 4.501mb +0.01%  | 38.547ms +0.04%  | ±0.44% -13.09%  |
| XmlExtractorBench     | bench_extract_10k      | 1    | 3   | 4.496mb +0.01%  | 604.379ms -1.13% | ±0.69% -48.01%  |
+-----------------------+------------------------+------+-----+-----------------+------------------+-----------------+

Transformers

+---------------------------------+--------------------------+------+-----+------------------+-----------------+----------------+
| benchmark                       | subject                  | revs | its | mem_peak         | mode            | rstdev         |
+---------------------------------+--------------------------+------+-----+------------------+-----------------+----------------+
| RenameEntryTransformerBench     | bench_transform_10k_rows | 1    | 3   | 123.237mb +0.00% | 66.104ms -5.19% | ±1.35% +10.88% |
| RenameEachEntryTransformerBench | bench_transform_10k_rows | 1    | 3   | 18.499mb +0.00%  | 74.406ms +0.74% | ±0.87% +86.58% |
+---------------------------------+--------------------------+------+-----+------------------+-----------------+----------------+

Loaders

+--------------------+----------------+------+-----+------------------+-----------------+-----------------+
| benchmark          | subject        | revs | its | mem_peak         | mode            | rstdev          |
+--------------------+----------------+------+-----+------------------+-----------------+-----------------+
| CSVLoaderBench     | bench_load_10k | 1    | 3   | 62.437mb +0.00%  | 85.914ms -3.67% | ±1.10% -40.42%  |
| JsonLoaderBench    | bench_load_10k | 1    | 3   | 79.709mb +0.00%  | 96.569ms -2.43% | ±0.68% -61.93%  |
| ParquetLoaderBench | bench_load_10k | 1    | 3   | 166.213mb +0.00% | 21.413s +3.60%  | ±0.07% -81.99%  |
| TextLoaderBench    | bench_load_10k | 1    | 3   | 17.807mb +0.00%  | 31.309ms -2.74% | ±1.54% +109.37% |
+--------------------+----------------+------+-----+------------------+-----------------+-----------------+

Building Blocks

+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+
| benchmark         | subject                    | revs | its | mem_peak         | mode             | rstdev          |
+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 101.786mb +0.00% | 650.434ms +0.84% | ±0.43% -69.57%  |
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 53.137mb +0.00%  | 327.511ms -0.01% | ±1.78% +174.59% |
| EntryFactoryBench | bench_entry_factory        | 1    | 3   | 14.387mb +0.00%  | 69.930ms -1.58%  | ±1.08% -11.87%  |
| RowsBench         | bench_chunk_10_on_10k      | 2    | 3   | 93.391mb +0.00%  | 4.337ms +21.91%  | ±1.41% -44.41%  |
| RowsBench         | bench_diff_left_1k_on_10k  | 2    | 3   | 110.760mb +0.00% | 238.734ms -1.82% | ±0.24% -81.82%  |
| RowsBench         | bench_diff_right_1k_on_10k | 2    | 3   | 93.480mb +0.00%  | 24.518ms +1.19%  | ±0.32% -80.26%  |
| RowsBench         | bench_drop_1k_on_10k       | 2    | 3   | 94.266mb +0.00%  | 1.927ms +8.71%   | ±3.51% +172.75% |
| RowsBench         | bench_drop_right_1k_on_10k | 2    | 3   | 94.266mb +0.00%  | 2.190ms +44.34%  | ±1.34% -41.53%  |
| RowsBench         | bench_entries_on_10k       | 2    | 3   | 92.426mb +0.00%  | 3.894ms +9.07%   | ±1.92% +21.87%  |
| RowsBench         | bench_filter_on_10k        | 2    | 3   | 92.955mb +0.00%  | 16.006ms -1.34%  | ±3.27% +7.03%   |
| RowsBench         | bench_find_on_10k          | 2    | 3   | 92.955mb +0.00%  | 15.904ms -1.03%  | ±0.52% -59.90%  |
| RowsBench         | bench_find_one_on_10k      | 10   | 3   | 91.644mb +0.00%  | 2.006μs +5.25%   | ±2.32% -4.92%   |
| RowsBench         | bench_first_on_10k         | 10   | 3   | 91.644mb +0.00%  | 0.400μs 0.00%    | ±0.00% 0.00%    |
| RowsBench         | bench_flat_map_on_1k       | 2    | 3   | 100.705mb +0.00% | 15.593ms +10.25% | ±3.50% +311.69% |
| RowsBench         | bench_map_on_10k           | 2    | 3   | 130.132mb +0.00% | 70.265ms +1.08%  | ±1.18% -53.75%  |
| RowsBench         | bench_merge_1k_on_10k      | 2    | 3   | 93.475mb +0.00%  | 1.872ms +37.43%  | ±2.88% +38.06%  |
| RowsBench         | bench_partition_by_on_10k  | 2    | 3   | 96.843mb +0.00%  | 63.535ms +2.16%  | ±0.68% -45.62%  |
| RowsBench         | bench_remove_on_10k        | 2    | 3   | 94.528mb +0.00%  | 4.472ms +7.99%   | ±2.71% -3.35%   |
| RowsBench         | bench_sort_asc_on_1k       | 2    | 3   | 92.005mb +0.00%  | 43.295ms +8.07%  | ±0.76% +85.81%  |
| RowsBench         | bench_sort_by_on_1k        | 2    | 3   | 92.006mb +0.00%  | 42.462ms +2.52%  | ±1.08% +20.94%  |
| RowsBench         | bench_sort_desc_on_1k      | 2    | 3   | 92.005mb +0.00%  | 42.831ms +2.88%  | ±2.18% +117.74% |
| RowsBench         | bench_sort_entries_on_1k   | 2    | 3   | 94.087mb +0.00%  | 9.025ms +4.36%   | ±1.24% +38.88%  |
| RowsBench         | bench_sort_on_1k           | 2    | 3   | 91.837mb +0.00%  | 31.691ms +4.43%  | ±0.74% -49.53%  |
| RowsBench         | bench_take_1k_on_10k       | 10   | 3   | 91.644mb +0.00%  | 14.688μs -17.29% | ±0.64% -53.85%  |
| RowsBench         | bench_take_right_1k_on_10k | 10   | 3   | 91.644mb +0.00%  | 17.320μs -26.97% | ±0.99% +7.75%   |
| RowsBench         | bench_unique_on_1k         | 2    | 3   | 110.761mb +0.00% | 244.241ms -1.00% | ±0.53% -23.71%  |
| TypeDetectorBench | bench_type_detector        | 1    | 3   | 42.072mb +0.00%  | 430.577ms +0.43% | ±0.76% +163.10% |
| TypeDetectorBench | bench_type_detector        | 1    | 3   | 11.450mb +0.00%  | 86.546ms +0.49%  | ±0.22% -72.33%  |
+-------------------+----------------------------+------+-----+------------------+------------------+-----------------+

[codecov]

Codecov Report

Attention: Patch coverage is 50.00000% with 1 line in your changes missing coverage. Please review.

Project coverage is 82.04%. Comparing base (ee344a1) to head (705399a).
Report is 2 commits behind head on 1.x.

✅ All tests successful. No failed tests found.

Additional details and impacted files

@@           Coverage Diff           @@
##              1.x    #1680   +/-   ##
=======================================
  Coverage   82.04%   82.04%           
=======================================
  Files         704      704           
  Lines       19083    19085    +2     
=======================================
+ Hits        15657    15659    +2     
  Misses       3426     3426           

Components	Coverage Δ
etl	88.35% <ø> (ø)
cli	84.42% <ø> (ø)
lib-array-dot	94.53% <ø> (ø)
lib-azure-sdk	62.56% <ø> (ø)
lib-doctrine-dbal-bulk	90.11% <ø> (ø)
lib-filesystem	78.02% <ø> (ø)
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	96.38% <ø> (ø)
symfony-http-foundation	74.41% <ø> (ø)
adapter-chartjs	86.45% <ø> (ø)
adapter-csv	90.18% <ø> (ø)
adapter-doctrine	89.69% <ø> (ø)
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.