Po tej lekcji będziesz potrafić:

• definiować parametry opcjonalne z bezpiecznymi wartościami domyślnymi.
• wywoływać tę samą funkcję z pominiętymi wartościami domyślnymi lub z jawnymi nadpisaniami.
• używać argumentów nazwanych, aby wywołania z wieloma parametrami były czytelniejsze.
• poprawnie porządkować parametry wymagane i parametry z wartością domyślną w sygnaturze funkcji.

Argument domyślny nadaje parametrowi wartość, gdy wywołujący pominie ten argument:

def format_status(service, status="unknown"):
    return f"{service}: {status}"

format_status("worker") używa "unknown", a format_status("worker", "healthy") nadpisuje tę wartość.

Parametry bez wartości domyślnych muszą występować przed parametrami z wartościami domyślnymi:

def create_job(name, retries=3):
    ...

Python pozwala też wywołującym przekazywać argumenty według nazwy:

create_job(name="backup", retries=5)

Argumenty nazwane czynią wywołania czytelniejszymi, gdy kilka wartości ma podobne typy lub gdy trzeba nadpisać tylko jedno ustawienie opcjonalne. Ich kolejność może różnić się od kolejności parametrów, o ile każda nazwa jest poprawna i żaden argument nie zostanie podany dwa razy.

Testy funkcji mogą sprawdzać zachowanie domyślne, wywołując funkcję z mniejszą liczbą argumentów. Obecny runner zadań funkcyjnych wywołuje funkcje pozycyjnie, dlatego ta lekcja ćwiczy składnię wywołań z argumentami nazwanymi w skoncentrowanych zadaniach z kodem, a rzeczywiste testy funkcji sprawdzają jej zachowanie.

Zaawansowane tematy, takie jak *args, **kwargs, parametry wyłącznie nazwane (keyword-only) i pułapki zmiennych wartości domyślnych, należą do późniejszej jednostki „Funkcje w szczegółach”.

1. Użycie wartości domyślnej, gdy wartość została pominięta

def cache_label(service, ttl=300):
    return f"{service}: {ttl}s"

print(cache_label("api"))

Wynik:

api: 300s

Wywołujący podaje tylko wymagany argument.

2. Nadpisanie wartości domyślnej

def retry_label(job, retries=3):
    return f"{job}: {retries} retries"

print(retry_label("sync", 5))

Wynik:

sync: 5 retries

Drugi argument zastępuje wartość domyślną.

3. Argumenty nazwane dla czytelności

def build_window(name, width=800, height=600):
    return f"{name}: {width}x{height}"

print(build_window(name="Dashboard", height=720, width=1280))

Wynik:

Dashboard: 1280x720

Argumenty nazwane można podawać w innej kolejności.

4. Parametry wymagane na początku

def create_alert(message, level="info", channel="console"):
    return f"[{level}] {channel}: {message}"

print(create_alert("Queue delayed", channel="slack"))

Wynik:

[info] slack: Queue delayed

Nadpisany jest tylko kanał; poziom zachowuje wartość domyślną.

1. Nie umieszczaj parametru wymaganego po parametrze z wartością domyślną.
2. Nie podawaj tego samego argumentu jednocześnie pozycyjnie i jako nazwanego.
3. Nie popełniaj literówek w argumencie nazwanym; musi zgadzać się z nazwą parametru.
4. Nie używaj mylącej wartości domyślnej, która niespodziewanie zmienia znaczenie funkcji.