Module

health.validators.output

Output validator - checks generated pages and assets.

Migrated from Site._validate_build_health() with improvements.

Provides observability stats for output validation performance tracking.

View source
1 Class

Classes

OutputValidator
Validates build output quality. Checks: - Page sizes (detect suspiciously small pages) - Asset pre…
4

Validates build output quality.

Checks:

  • Page sizes (detect suspiciously small pages)
  • Asset presence (CSS/JS files)
  • Output directory structure

Implements HasStats protocol for observability.

Inherits from BaseValidator

Attributes

Name Type Description
last_stats ValidatorStats | None

Methods 1

validate
Run output validation checks. Collects stats on: - Total HTML files checked - …
2 list[CheckResult] 
def validate(self, site: Site, build_context: Any = None) -> list[CheckResult]

Run output validation checks.

Collects stats on:

  • Total HTML files checked
  • Files validated
  • Sub-timings for page size, asset, and directory checks
Parameters 2
site Site

Site instance to validate
build_context Any

Optional BuildContext (unused)
Returns

list[CheckResult] —

List of CheckResult objects

Internal Methods 3
_check_page_sizes
Check if any pages are suspiciously small.
1 list[CheckResult] 
def _check_page_sizes(self, site: Site) -> list[CheckResult]

Check if any pages are suspiciously small.

Parameters 1
site Site
Returns

list[CheckResult]

_check_assets
Check if theme assets are present in output.
1 list[CheckResult] 
def _check_assets(self, site: Site) -> list[CheckResult]

Check if theme assets are present in output.

Parameters 1
site Site
Returns

list[CheckResult]

_check_output_directory
Check output directory structure.
1 list[CheckResult] 
def _check_output_directory(self, site: Site) -> list[CheckResult]

Check output directory structure.

Parameters 1
site Site
Returns

list[CheckResult]