Настройка дефолтных значений аргументов

Как обработать изменяемый объект в качестве значения по умолчанию?

def add_item(item, lst=[]):
    lst.append(item)
    return lst

print(add_item(1))   # [1]
print(add_item(2))   # [1, 2]  (ожидалось [2])

Рекомендуемый приём - использовать None как sentinel и создавать новый изменяемый объект внутри функции.

def add_item(item, lst=None):
    if lst is None:
        lst = []
    lst.append(item)
    return lst

print(add_item(1))   # [1]
print(add_item(2))   # [2]

Теперь каждый вызов без аргумента lst создаёт новый список. Аналогом может быть использование фабричной функции, например lambda, но она недопустима непосредственно в сигнатуре - применяется в декораторах или dataclasses.field.

Как отличить отсутствие аргумента от явной передачи None?

Иногда требуется различать две ситуации: аргумент не передан, либо передан со значением None. Для этого применяют специальный объект-синглтон:

_MISSING = object()

def process(data=_MISSING):
    if data is _MISSING:
        print('Аргумент не передан')
    else:
        print(f'Получено: {data}')

process()          # Аргумент не передан
process(None)      # Получено: None
process(42)        # Получено: 42

Этот подход позволяет обрабатывать None как корректное значение, не путая его с пропущенным аргументом.

Как задать значение по умолчанию, вычисляемое при каждом вызове?

Иногда значение по умолчанию должно зависеть от времени или контекста вызова. Непосредственно в сигнатуре это невозможно, поэтому используют фабричную функцию, вызываемую внутри тела:

import datetime

def log_event(message, timestamp=None):
    if timestamp is None:
        timestamp = datetime.datetime.now()
    print(f'[{timestamp}] {message}')

log_event('start')   # [2025-03-19 12:34:56] start

Для более элегантного синтаксиса (например, в классах данных) применяется dataclasses.field с default_factory.

from dataclasses import dataclass, field
import datetime

@dataclass
class Event:
    message: str
    timestamp: datetime.datetime = field(default_factory=datetime.datetime.now)

При создании экземпляра без timestamp вызывается datetime.now() для каждого объекта отдельно.

Как зафиксировать часть аргументов с помощью functools.partial?

Библиотека functools предоставляет partial для создания новой функции с предустановленными значениями некоторых аргументов.

from functools import partial

def power(base, exponent):
    return base ** exponent

square = partial(power, exponent=2)
cube = partial(power, exponent=3)

print(square(5))   # 25
print(cube(2))     # 8

Этот приём удобен, когда одна функция часто вызывается с одинаковыми значениями отдельных параметров.

Как использовать значения по умолчанию в декораторах?

Декораторы могут добавлять аргументы со значениями по умолчанию к оборачиваемой функции. Например, таймер с опциональным единицами измерения:

import time
from functools import wraps

def timer(unit='seconds'):
    def decorator(func):
        @wraps(func)
        def wrapper(*args, **kwargs):
            start = time.time()
            result = func(*args, **kwargs)
            elapsed = time.time() - start
            if unit == 'milliseconds':
                elapsed *= 1000
            print(f'{func.__name__} заняла {elapsed:.4f} {unit}')
            return result
        return wrapper
    return decorator

Параметр unit имеет значение по умолчанию 'seconds', которое можно переопределить при применении декоратора.