Module

health.validators.performance

Performance validator - checks build performance (basic checks only).

Validates:

  • Detects slow pages (> 1 second render)
  • Warns if build is unusually slow
  • Reports basic throughput metrics

Classes

PerformanceValidator
Validates build performance (basic checks only). Checks: - Build time is reasonable for page count…
4

Validates build performance (basic checks only).

Checks:

  • Build time is reasonable for page count
  • No individual pages are very slow
  • Basic throughput metrics

Skips:

  • Memory profiling (complex)
  • Parallel efficiency analysis (advanced)
  • Build time regression detection (needs history)
Inherits from BaseValidator

Methods 1

validate
Run performance validation checks.
2 list[CheckResult]
def validate(self, site: Site, build_context: BuildContext | Any | None = None) -> list[CheckResult]

Run performance validation checks.

Parameters 2
site Site
build_context BuildContext | Any | None
Returns

list[CheckResult]

Internal Methods 3
_check_build_time
Check if overall build time is reasonable.
2 list[CheckResult]
def _check_build_time(self, site: Site, build_stats: dict[str, Any]) -> list[CheckResult]

Check if overall build time is reasonable.

Parameters 2
site Site
build_stats dict[str, Any]
Returns

list[CheckResult]

_check_throughput
Check pages per second throughput.
2 list[CheckResult]
def _check_throughput(self, site: Site, build_stats: dict[str, Any]) -> list[CheckResult]

Check pages per second throughput.

Parameters 2
site Site
build_stats dict[str, Any]
Returns

list[CheckResult]

_check_slow_pages
Check for individual slow pages.
2 list[CheckResult]
def _check_slow_pages(self, site: Site, build_stats: dict[str, Any]) -> list[CheckResult]

Check for individual slow pages.

Parameters 2
site Site
build_stats dict[str, Any]
Returns

list[CheckResult]