overloads_consistency error

Overlapping @overload signatures

Within a group of @overload functions for the same name, every overload must be distinguishable. This rule uses a structural heuristic: two overloads are considered overlapping when they have the same parameter count AND identical parameter names in the same order.

A diagnostic is emitted for the later overload in each conflicting pair, pointing at its name span.

How to handle it

Every rule is on by default — strict is the default, not a cage. You can dial overloads_consistency down per-file or per-path from your editor or pyproject.toml, or fix the code so it type-checks. See the Type System rules and the complete diagnostic reference.

Canonical URL: https://www.basilisk-python.dev/errors/overloads_consistency