Аргумент — это значение, которое ты передаёшь в функцию. Параметр — имя, под которым функция это значение принимает. Одно и то же значение можно передать по позиции или по имени.

Позиционный аргумент стоит на своём месте: первый попадает в первый параметр, второй — во второй. Именованный аргумент ты передаёшь явно, имя=значение. Имя важнее порядка, поэтому именованные можно ставить в любом порядке после позиционных.

def greet(name, city):
    return f"{name} из {city}"

greet("Аня", "Казань")          # по позиции
greet(city="Казань", name="Аня")  # по имени

Позиционные всегда идут раньше именованных. greet(name="Аня", "Казань") — ошибка: после имени снова идёт голое значение.

Слеш / и звёздочка в списке параметров задают, как* аргумент можно передать.

До / параметры только позиционные (positional-only). По имени их вызвать нельзя. Так устроены многие встроенные функции: len, abs.
Между / и * параметры обычные: и по позиции, и по имени.
После * параметры только именованные (keyword-only). Их нужно писать как имя=значение, даже если они стоят на «правильном» месте.

def clip(value, /, low, high, *, digits=2):
    return round(min(max(value, low), high), digits)

clip(3.14159, 0, 1, digits=3)

Здесь value нельзя назвать: clip(value=3.14, ...) упадёт. digits нельзя передать позицией: clip(3.14, 0, 1, 3) тоже упадёт. low и high принимают оба способа.

*args собирает лишние позиционные аргументы в кортеж (неизменяемый набор значений). Имя args — привычка, работает любая звёздочка перед именем.

**kwargs собирает лишние именованные аргументы в словарь: ключ — имя, значение — то, что передали. Имя kwargs тоже привычка.

def log(level, *args, **kwargs):
    print(level, args, kwargs)

log("info", "старт", user="Аня")
# info ('старт',) {'user': 'Аня'}

Порядок в заголовке такой: параметры до / (только позиция), потом обычные, потом args или голая , потом параметры только по имени, потом *kwargs. Голая ничего не собирает, она только отделяет то, что дальше можно передать лишь по имени.

Звёздочка работает и при вызове. распаковывает список или кортеж в позиционные аргументы, * — словарь в именованные.

pair = ["Аня", "Казань"]
greet(*pair)

opts = {"city": "Казань", "name": "Аня"}
greet(**opts)

У параметра может быть значение по умолчанию: digits=2. Тогда аргумент можно не передавать. Параметры со значением по умолчанию стоят после обязательных. Значение по умолчанию создаётся один раз, при определении функции, поэтому туда не кладут изменяемый объект вроде списка: все вызовы получат один и тот же список.

Основы Python

Хешируемость

Аргументы

Методы