`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.