Function _coerce_entity

src/ifcedit/ifcedit/coerce.py:131–142

Resolve a step ID string like '123' or '#123' to an entity instance.

(value_str: str | int, lookup_file: ifcopenshell.file | None)

def _coerce_entity(value_str: str | int, lookup_file: ifcopenshell.file | None) -> ifcopenshell.entity_instance:
    """Resolve a step ID string like '123' or '#123' to an entity instance."""
    if lookup_file is None:
        raise ValueError("Cannot resolve entity reference without an IFC model")
    if isinstance(value_str, int):
        entity_id = value_str
    else:
        entity_id = int(value_str.strip().lstrip("#"))
    try:
        return lookup_file.by_id(entity_id)
    except RuntimeError:
        raise ValueError(f"Entity #{entity_id} not found in model")


def _coerce_entity_list(value_str: str, lookup_file: ifcopenshell.file | None) -> list[ifcopenshell.entity_instance]: