Refactoring — Explained with Examples

Refactoring is the disciplined process of restructuring existing computer code without altering its external behavior. Its purpose is to improve non-functional attributes: readability, maintainability, extensibility, and performance. Refactoring is not bug fixing — bugs are behavior changes.

Martin Fowler’s book Refactoring: Improving the Design of Existing Code cataloged over 70 refactoring techniques with step-by-step instructions. Common refactorings include Extract Method, Rename Variable, Move Field, Replace Conditional with Polymorphism, and Inline Function. Each refactoring should be small and behavior-preserving, validated by running tests after each step. Refactoring is a core practice of Extreme Programming and key to managing Technical Debt.

Real-world analogy. Refactoring is like reorganizing your garage. You don’t change the size of the garage or buy a new car. You just put tools on labeled hooks, group paint cans together, and install shelves. Everything is still in the garage, but it’s now easier to find what you need and add new items.

Example (Refactoring: before vs after):

# Before
def total(items):
    t = 0
    for i in items:
        t += i.price * i.qty
    return t

# After (Extract Method)
def line_total(item):
    return item.price * item.qty

def total(items):
    return sum(line_total(i) for i in items)

Related terms: Technical Debt, Extreme Programming, TDD, Agile, Clean Code

Related tutorial: Refactoring Patterns