convention-single-abstraction

Single Level of Abstraction (SLA) is a code design principle ensuring a function operates at one abstraction level. It improves readability and maintainability by preventing high-level control flow from mixing with low-level implementation details.

Refactor a function to maintain a single abstraction level by extracting low-level implementation details into dedicated, well-named helper functions. This preserves high-level intent and keeps related responsibilities together within the main routine.

Mixing high-level flow with low-level details increases cognitive load, making software harder to read and maintain. Enforcing a single abstraction level within every function reduces this complexity and clarifies the code's intent.

Apply the single level of abstraction principle when implementing complex routines. It prevents mixing high-level control flow with low-level implementation details, ensuring your modules remain readable and maintainable.

The best way to enforce consistent abstraction levels across modules is to apply the SLA principle throughout your codebase. Extract low-level logic into helpers to keep function bodies operating at a single, cohesive abstraction level.