utils.page_initializer

Ensures pages are correctly initialized with all required references.

Used by orchestrators after creating pages to validate they're ready for use.

Design principles:

• Fail fast (errors at initialization, not at URL generation)
• Clear error messages (tell developer exactly what's wrong)
• Single responsibility (just validation, not creation)
• Lightweight (minimal logic, mostly checks)

Usage:

# In an orchestrator
def __init__(self, site):
    self.initializer = PageInitializer(site)

def create_my_page(self):
    page = Page(...)
    page.output_path = compute_path(...)
    self.initializer.ensure_initialized(page)  # Validate!
    return page