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