Bench v2

[roxblnfk]

What

This pull request introduces a comprehensive set of new DTOs (Data Transfer Objects) and reporting classes to enhance the benchmarking subsystem. It refactors the benchmark configuration to support more granular control over warmup, iteration, and call counts, and adds detailed result and diagnostic structures for reporting benchmark outcomes and issues. The changes improve the accuracy, flexibility, and clarity of benchmark results and diagnostics.

Benchmark Configuration Refactor

• The BenchWith constructor now supports separate configuration for warmup, calls, and iterations, replacing the previous iterations and revolutions fields. Input validation is improved for these parameters.

Benchmark Result and Data Structures

• Added new DTOs: BenchResult, CaseResult, CaseSet, IterationSet, and Line to represent benchmark results, case aggregations, iteration details, and ranking lines. These structures enable detailed and organized reporting of benchmark execution and outcomes. [1] [2] [3] [4] [5]

Diagnostic and Reporting System

• Introduced a base abstract Report class and multiple specialized report types (e.g., HighVariance, BimodalBehavior, TooManyOutliers, NoisyEnvironment, etc.) to classify and describe benchmark anomalies, warnings, and errors. Each report includes severity, reason, and advice fields for actionable feedback. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12]

• Added the Severity enum to classify report levels as Notice, Warning, or Danger.

Minor Code Improvements

• Updated usages of microtime(true) to use the fully-qualified \microtime(true) for consistency. [1] [2]
• Cleaned up unused imports in Application.php. was changed

See commit history for details.

Checklist

• Part of Expose Benching functionality #92
• Tested
  • Tested manually
  • Unit tests added
• Documentation