from __future__ import annotations

from .. import h, messages as m, t


def exampleIDs(doc: t.SpecT) -> None:
    """
    Checks that every example in the document has an ID.
    """
    if not doc.md.complainAbout["missing-example-ids"]:
        return
    for el in h.findAll(".example:not([id])", doc):
        m.lint(f"Example needs ID:\n{h.outerHTML(el)[0:100]}", el=el)
