Function generate_stable_atom_name_from_component_id

preswald/utils.py:236–260

Convert a stable component ID into a corresponding atom name. Normalizes the suffix and replaces hyphens with underscores. Example: component_id='text-abc123ef' → '_auto_atom_abc123ef' Args: component_id (str): A previously generated component ID. prefix (s

(
    component_id: str, prefix: str = "_auto_atom"
)

def generate_stable_atom_name_from_component_id(
    component_id: str, prefix: str = "_auto_atom"
) -> str:
    """
    Convert a stable component ID into a corresponding atom name.
    Normalizes the suffix and replaces hyphens with underscores.

    Example:
        component_id='text-abc123ef' → '_auto_atom_abc123ef'

    Args:
        component_id (str): A previously generated component ID.
        prefix (str): Optional prefix for the atom name.

    Returns:
        str: A deterministic, underscore-safe atom name.
    """
    if component_id and "-" in component_id:
        hash_part = component_id.rsplit("-", 1)[-1]
        return f"{prefix}_{hash_part}"

    logger.warning(
        f"[generate_stable_atom_name_from_component_id] Unexpected component_id format {component_id=}"
    )
    return generate_stable_id(prefix)


def export_app_to_pdf(all_components: list[dict], output_path: str):