Механизм передачи параметров в Python

Расширенные примеры приёма аргументов

1. Использование inspect для динамического анализа сигнатуры функции

import inspect

def sample(a, b=10, *args, **kwargs):
    pass

sig = inspect.signature(sample)
for name, param in sig.parameters.items():
    print(f'{name}: kind={param.kind.name}, default={param.default}')

a: kind=POSITIONAL_OR_KEYWORD, default=inspect._empty
b: kind=POSITIONAL_OR_KEYWORD, default=10
args: kind=VAR_POSITIONAL, default=inspect._empty
kwargs: kind=VAR_KEYWORD, default=inspect._empty

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

2. Передача аргументов из словаря с частичным перекрытием

def func(a, b, c, d=0):
    return a + b + c + d

base = {'a': 1, 'b': 2, 'c': 3}
extra = {'d': 10}
print(func(**base, **extra))
# print(func(**base, **{'a': 100}))  # TypeError: got multiple values for argument 'a'

16

Важно избегать дублирования ключей - Python выдаст ошибку.

3. *args в декораторе для передачи аргументов обёрнутой функции

def debug(func):
    def wrapper(*args, **kwargs):
        print(f'Вызов {func.__name__} с args={args}, kwargs={kwargs}')
        return func(*args, **kwargs)
    return wrapper

@debug
def add(x, y):
    return x + y

print(add(3, 4))
print(add(x=10, y=20))

Вызов add с args=(3, 4), kwargs={}
7
Вызов add с args=(), kwargs={'x': 10, 'y': 20}
30

4. Частичное применение с 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))
print(cube(2))

25
8

partial фиксирует часть аргументов, создавая новую функцию с меньшей арностью.

5. Распаковка строк и итераторов при вызове

def concatenate(*strings):
    return ''.join(strings)

letters = 'abc'
print(concatenate(*letters))

# Работа с любым итератором:
nums = range(1, 5)
print(concatenate(*map(str, nums)))

abc
1234

6. Использование только именованных аргументов для улучшения читаемости API

def connect_db(*, host='localhost', port=5432, user, password):
    return f'Соединение с {host}:{port} пользователь {user}'

# connect_db('localhost', 'admin')  # TypeError
print(connect_db(user='admin', password='secret'))
print(connect_db(host='example.com', user='admin', password='123'))

Соединение с localhost:5432 пользователь admin
Соединение с example.com:5432 пользователь admin

Такой подход делает код самодокументируемым и предотвращает ошибки из-за путаницы позиций.

7. Позиционно-ключевые параметры с / и * вместе

def complex_func(a, b, /, c, d, *, e, f):
    return (a, b, c, d, e, f)

# a и b - только позиционные; c и d - обычные; e и f - только именованные
print(complex_func(1, 2, 3, d=4, e=5, f=6))
# print(complex_func(a=1, b=2, 3, d=4, e=5, f=6))  # SyntaxError: positional argument follows keyword argument
# print(complex_func(1, 2, 3, 4, 5, 6))  # TypeError: missing required keyword-only arguments

(1, 2, 3, 4, 5, 6)

Комбинация этих символов даёт тонкий контроль над интерфейсом функции.