DEV Community

Cover image for Understanding Python's *args and **kwargs
Developer Service
Developer Service

Posted on • Originally published at developer-service.blog

Understanding Python's *args and **kwargs

Python is renowned for its simplicity and flexibility, which often comes from its ability to handle functions with variable numbers of arguments.

Two special symbols, *args and **kwargs, play a pivotal role in this flexibility.

In this article, we'll explore what these symbols mean, how to use them, and why they're so powerful.


The Basics of *args

The *args parameter allows a function to accept any number of positional arguments.

The asterisk (*) is a signal to Python that all positional arguments should be collected into a tuple.

Example of *args in Action

def greet(*args):
    for name in args:
        print(f"Hello, {name}!")

greet('Alice', 'Bob', 'Charlie')

Enter fullscreen mode Exit fullscreen mode

Output:

Hello, Alice!
Hello, Bob!
Hello, Charlie!

Enter fullscreen mode Exit fullscreen mode

Explanation:

  • The function greet accepts any number of positional arguments.
  • Inside the function, args is a tuple containing all the arguments passed.
  • We iterate over args to print a greeting for each name.

When I first learned about *args, it felt like unlocking a new level in a video game. So much simpler to define a function.


Diving into **kwargs

Similarly, **kwargs allows a function to accept any number of keyword arguments.

The double asterisks (**) tell Python to collect all keyword arguments into a dictionary.

Example of **kwargs in Action

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

display_info(name='Alice', age=30, city='New York')

Enter fullscreen mode Exit fullscreen mode

Output:

name: Alice
age: 30
city: New York

Enter fullscreen mode Exit fullscreen mode

Explanation:

  • The function display_info accepts any number of keyword arguments.
  • Inside the function, kwargs is a dictionary containing all the keyword arguments.
  • We iterate over kwargs.items() to print each key-value pair.

Using **kwargs has been a lifesaver when dealing with functions that require a flexible set of named parameters. It keeps my code clean and organized.


Combining *args and **kwargs

You can use both *args and **kwargs in the same function to accept all types of arguments.

Example of Combined Usage

def make_sentence(*args, **kwargs):
    sentence = ' '.join(args)
    for key, value in kwargs.items():
        sentence += f" {key} {value}"
    print(sentence)

make_sentence('I', 'love', 'Python', exclamation='!', emoji='😊')

Enter fullscreen mode Exit fullscreen mode

Output:

I love Python exclamation ! emoji 😊

Enter fullscreen mode Exit fullscreen mode

Explanation:

  • args collects positional arguments into a tuple.
  • *kwargs collects keyword arguments into a dictionary.
  • We build a sentence by joining positional arguments and appending keyword arguments.

Mixing *args and **kwargs feels like cooking with all the right ingredientsβ€”you can adjust the recipe as you like without breaking the dish.


The Order of Parameters

When using *args and **kwargs, the order in which you place them in the function definition matters:

  1. Regular positional arguments
  2. args
  3. Keyword arguments (those without default values)
  4. Keyword arguments with default values
  5. *kwargs

Correct Order Example

def func(a, b, *args, **kwargs):
    pass

Enter fullscreen mode Exit fullscreen mode

Incorrect Order Example

def func(*args, a, b, **kwargs):
    pass  # This will raise a SyntaxError

Enter fullscreen mode Exit fullscreen mode

I've tripped over this ordering more times than I'd like to admit. Double-checking the parameter order saves a lot of debugging time!


Unpacking Arguments with * and **

The asterisks are not only useful in function definitions but also when calling functions.

They can unpack sequences and dictionaries into arguments.

Example of Unpacking

def add(a, b, c):
    return a + b + c

numbers = (1, 2, 3)
print(add(*numbers))  # Unpacks the tuple into a, b, c

details = {'a': 4, 'b': 5, 'c': 6}
print(add(**details))  # Unpacks the dict into a, b, c

Enter fullscreen mode Exit fullscreen mode

Output:

6
15

Enter fullscreen mode Exit fullscreen mode

Explanation:

  • numbers unpacks the tuple into positional arguments.
  • *details unpacks the dictionary into keyword arguments.

This feature made my code so much cleaner, especially when dealing with data that naturally comes in lists or dictionaries.


Practical Uses

Flexible Function Interfaces

When you want a function to handle varying numbers of inputs without changing the function signature.

def calculate_sum(*numbers):
    return sum(numbers)

Enter fullscreen mode Exit fullscreen mode

Decorators and Wrappers

When writing decorators, you often don't know the number of arguments the wrapped function will receive.

def my_decorator(func):
    def wrapper(*args, **kwargs):
        print("Before the function call.")
        result = func(*args, **kwargs)
        print("After the function call.")
        return result
    return wrapper

Enter fullscreen mode Exit fullscreen mode

Decorators are one of my favorite features in Python, and *args and **kwargs make them possible.


Common Mistakes to Avoid

Misplacing Parameters: Ensure that *args and **kwargs are placed correctly in the function signature.

Overusing: While *args and **kwargs are powerful, overusing them can make your code hard to understand.

Forgetting the Asterisks: Remember that args and kwargs are just conventions. The asterisks (*, **) are what make them special.

def func(args):  # This won't collect multiple arguments
    pass

Enter fullscreen mode Exit fullscreen mode

Balance is key. While it's tempting to use *args and **kwargs everywhere, sometimes explicit parameters are clearer.


Conclusion

Understanding *args and **kwargs opens up a world of possibilities in Python programming.

They provide the flexibility to write functions that can handle an arbitrary number of arguments, making your code more dynamic and adaptable.

Mastering *args and **kwargs was a turning point in my Python journey.

It made coding more enjoyable and my programs more robust. If you haven't explored these features yet, I highly recommend diving in!

Top comments (2)

Collapse
 
sreno77 profile image
Scott Reno

Good info that you explained clearly. Thanks for sharing!

Collapse
 
devasservice profile image
Developer Service

Thank you for reading!