Tip: Watch out for mutable default arguments in Python

Isabelle Viktoria Maciohsek · Python, Function · Feb 27, 2022

Default arguments in Python are evaluated only once. The evaluation happens when the function is defined, instead of every time the function is called. This can inadvertently create hidden shared state, if you use a mutable default argument and mutate it at some point. This means that the mutated argument is now the default for all future calls to the function as well.

Take the following code as an example. Every call to the function shares the same list. So, the second time it's called, the function doesn't start out with an empty list. Instead, the default argument is the list containing the value from the previous call.

def append(n, l = []):
  l.append(n)
  return l

append(0) # [0]
append(1) # [0, 1]

If you absolutely need to use a mutable object as the default value in a function, you can set the default value of the argument to None instead. Then, checking in the function body if it is None, you can set it to the mutable value you want without side effects.

def append(n, l = None):
  if l is None:
    l = []
  l.append(n)
  return l

append(0) # [0]
append(1) # [1]

Would you like to help us improve 30 seconds of code?Take a quick survey

Recommended snippets & collections

  • Tips & Tricks

    Snippet collection

    A collection of quick tips and tricks to level up your coding skills one step at a time.

  • Unfold list

    Python, Function

    Builds a list, using an iterator function and an initial seed value.

  • Compose functions

    Python, Function

    Performs right-to-left function composition.

  • Performs left-to-right function composition.