`papyri.gen:find_canonical`

Signature

def find_canonical(qa: str, aliases: list[str]) → str | None

Given the fully qualified name and a lit of aliases, try to find the canonical one.

The canonical name is usually:

short (less depth in number of modules)
does not contain special chars like <, > for locals
none of the part start with _.
if there are many names that have the same depth and are shorted than the qa, we bail.

We might want to be careful with dunders.

If we can't find a canonical, there are many, or are identical to the fqa, return None.