Commit

d55856d

Suppose a timeout can be an integer or None. That does not make the argument optional. None means no timeout, but callers must make that choice explicitly. Those are two separate API decisions. - The union controls accepted values - A default controls whether callers can leave it out.
python
def required(timeout: int | None) -> None: 
    pass

def omittable(timeout: int | None = None) -> None: 
    pass

required(None)  # 0K: explicitly supplied 
omittable()      # OK: uses the default 
required()       # TYPE ERROR: missing argument

commit d55856d