Package org.ek9lang.cli.coverage

package org.ek9lang.cli.coverage

HTML coverage report generation components using functional interfaces.

This package provides focused, single-responsibility classes for generating HTML coverage reports, following patterns from compiler phases 1-6.

Design Philosophy

Each component implements a functional interface (Function, BiFunction, Supplier) enabling:

• Single responsibility - one class, one job
• Easy testing - each component can be unit tested in isolation
• Composition - components can be combined via constructor injection
• Immutability - no shared mutable state

Available Components

Section Generators (return HTML strings)

• StatusBannerHtml - Pass/fail status banner
• AttentionSectionHtml - Modules below threshold
• MetricsSectionHtml - Code quality metrics
• ModuleTreeHtml - Hierarchical module listing
• ModuleRowHtml - Single module row
• FunctionRowsHtml - Function coverage rows
• SourceLinesHtml - Line-by-line source view
• ComplexityBadgeHtml - Complexity indicator

Data Collection

• SourceFileCoverageCollector - Collects coverage data

Model Records

See org.ek9lang.cli.coverage.model for data transfer records.

Future Work

These components are ready to be wired into the existing CoverageOutputFormatter.HtmlCoverageFormatter to replace its inline methods, further reducing the class size from ~1,800 lines.

See Also:

• CoverageOutputFormatter
• CoverageHtmlResources

Related Packages

Package	Description
org.ek9lang.cli	A-1 - Start here for the main command-line entry use of the compiler.
org.ek9lang.cli.coverage.model	Model records for HTML coverage report generation.

Class	Description
AttentionSectionHtml	Generates the attention required section showing modules below coverage threshold.
BranchBadgeGenerator	Generates HTML badge for branch coverage indicators.
ComplexityBadgeHtml	Generates HTML for a complexity badge with tooltip showing code quality metrics.
CoverageConstants	Constants for coverage report generation.
CoverageLinks	Centralized utility for building coverage report links.
CoveredProbesSupplier	Supplies all covered probes as a unified ProbeData stream.
FailingModuleFilter	Filters modules below coverage threshold and sorts by coverage (worst first).
FunctionRowsHtml	Generates HTML rows for covered and uncovered functions in a module.
MetricsSectionHtml	Generates the code quality metrics section using dial charts.
ModuleGrouper	Groups modules by their top-level package name.
ModuleGroupStatsCalculator	Calculates aggregate statistics for a group of modules.
ModuleInfoCollector	Collects ModuleInfo for all modules from CoverageRuntime.
ModuleNameExtractor	Extracts module name from EK9 source file.
ModuleRowHtml	Generates HTML for a single module row in the coverage module tree.
ModuleTreeHtml	Generates the module tree HTML showing hierarchical grouping of modules.
ProbeProcessor	Processes coverage probes into file-based coverage maps.
ReturnWithInitDetector	Detects if a source line is a return declaration with initialization.
SeverityDeterminer	Determines severity level based on coverage percentage.
SeverityDeterminer.Severity	Severity levels for coverage status.
SeverityStyling	Maps severity level to CSS class and icon.
SeverityStyling.Styling	Visual styling for a severity level.
SignatureCoverageResolver	Resolves coverage for lines within function signatures.
SourceFileCoverageCollector	Collects coverage data from CoverageRuntime and scans source files.
SourceFileInfoBuilder	Builds SourceFileInfo objects from coverage data.
SourceFilesByModuleGrouper	Groups source files by their module name.
SourceFileScanner	Scans file system for EK9 source files.
SourceLinesHtml	Generates HTML for line-by-line source code view with coverage highlighting.
StatusBannerHtml	Generates the status banner HTML showing pass/fail state based on coverage threshold.
UncoveredProbesSupplier	Supplies all uncovered probes as a unified ProbeData stream.