Python 강좌 / 가변 인수와 언패킹: *args·**kwargs

*args는 추가 위치 인수를 튜플로 모으고 **kwargs는 추가 키워드 인수를 딕셔너리로 모읍니다. 호출할 때의 *·**는 반대로 모음의 값을 풀어 전달하며, 두 사용 위치를 구분해야 합니다.

수집과 펼치기의 방향

함수 정의의 별표는 인수를 모으고 호출의 별표는 항목을 펼칩니다. args와 kwargs는 관례적 이름이며 별표 문법이 실제 역할을 정합니다. 고정된 입력이 명확한 함수까지 모두 가변 인수로 만들면 허용하는 항목과 오류를 알아보기 어려워질 수 있습니다.

관련 동작과 지원 조건은 가변 인수와 언패킹: *args·**kwargs 관련 공식 문서에서 확인할 수 있습니다.

전체 예제와 실행 결과

별도의 실습 폴더에서 아래 파일을 UTF-8로 저장합니다. 가상환경을 선택한 터미널에서 python varargs.py 명령으로 실행합니다. macOS·Ubuntu에서 가상환경을 사용하지 않는 경우 명령 이름을 python3으로 바꿉니다.

varargs.py 파일의 전체 내용입니다.

def total(*amounts, fee=0):
    return sum(amounts) + fee

def describe(**fields):
    return ", ".join(f"{key}={value}" for key, value in sorted(fields.items()))

values = [3500, 8000, 2500]
print(total(*values, fee=500))
options = {"category": "food", "currency": "KRW"}
print(describe(**options))

예상 결과는 다음과 같습니다.

14500
category=food, currency=KRW

중복 키와 잘못된 펼치기

**로 넘기는 키는 문자열이어야 하고 대상 함수가 받는 이름과 맞아야 합니다. f(amount=1, **{"amount": 2})처럼 같은 인수를 두 번 전달하면 TypeError가 발생합니다. 딕셔너리를 합치는 동작과 함수 호출의 중복 인수 규칙은 같지 않습니다.

문자열에 *를 쓰면 문자 하나씩 펼쳐집니다. total(*"123")은 숫자 123 하나를 보내는 코드가 아닙니다. 인수 개수가 많거나 뜻이 불분명하면 명시적인 리스트 매개변수 하나를 받는 설계가 더 적절할 수 있습니다.

인터페이스를 넓히기 전에 확인할 것

가변 키워드 인수를 받는다고 검증하지 않은 옵션을 외부 API나 SQL에 그대로 넘기지 않습니다. 허용 목록과 필수 필드를 확인한 뒤 전달하세요. 단순 편의 때문에 오타를 조용히 수용하면 문제를 찾기 어려워집니다.

1. values에 0을 추가해 합계가 같은지 확인합니다.
2. fee를 지정하지 않으면 기본값 0이 적용되는지 확인합니다.
3. describe에 같은 이름의 키워드를 두 번 전달하려고 해 실패 원인을 확인합니다.