Course contentsShow
← Python
Lesson 146 of 1,0603. Functions and ModularizationFree lesson

Handling Arbitrary Keyword Arguments

You will learn to use the **kwargs syntax to capture undefined sets of named arguments into a dictionary for dynamic handling.

Mastering Arbitrary Keyword Arguments

In this lesson, you will learn how to use the **kwargs syntax to capture any number of named arguments into a dictionary, allowing your functions to handle flexible, undefined sets of data.

Beyond Fixed Parameters

Up until now, you have defined functions where every parameter has a specific name, like def greet(name, age):. However, sometimes you might want to create a function that accepts extra information without knowing exactly what that information will be ahead of time. This is where **kwargs (short for "keyword arguments") comes into play.

By adding **kwargs as a parameter in your function definition, Python takes any "extra" keyword arguments you provide and packages them neatly into a dictionary.

A Practical Illustration

Imagine you are building a profile creator. You know everyone has a name, but users might want to add extra details like a hobby, a favorite color, or a job title. Instead of defining a parameter for every possible hobby or job, you can use **kwargs:

def create_profile(name, **kwargs):
    print(f"Profile for: {name}")
    for key, value in kwargs.items():
        print(f"{key}: {value}")

# You can now pass as many extra keywords as you like
create_profile("Alice", hobby="Painting", location="New York")
create_profile("Bob", job="Engineer", favorite_color="Blue", pets=2)

In the examples above, name is a standard positional argument, but hobby, location, job, and others are captured by **kwargs. Inside the function, kwargs acts just like a regular dictionary. You can loop through it, check for specific keys using .get(), or count how many extra details were provided.

The double asterisk (**) is the magic part—it tells Python, "Take all the extra keyword arguments that don't match my regular parameters and shove them into a dictionary named kwargs." This makes your code incredibly flexible, as you don't need to update your function definition every time you decide to support a new piece of user data.

Key Takeaway: Use **kwargs in a function parameter list to collect any number of undefined keyword arguments into a dictionary, making your functions capable of handling dynamic sets of named data.