Summary  
This chapter explains how to use `**kwargs` to let a function accept any number of named arguments as a dictionary, and shows how to iterate over those key–value pairs for tasks such as printing or conditional filtering.  

General domain of usage  
Data processing

Em programação, existe uma sintaxe especial para passar qualquer quantidade de parâmetros nomeados para uma função, conhecida como `**kwargs`.

`**kwargs` permite que uma função aceite qualquer número de argumentos nomeados e os trate como um dicionário.

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

# Example function call
example_function(name='John', age=25, city='New York')

Neste exemplo, `**kwargs` recebe argumentos nomeados e imprime suas chaves e valores.



O método `.items()` é utilizado para obter uma lista de pares chave-valor de um dicionário em Python. Cada elemento dessa lista é representado como uma tupla (chave, valor).

Nota

Você também pode usar `**kwargs` para filtrar dados com base em uma condição. Por exemplo, mantendo apenas as entradas cujo valor atinge um determinado limite:


def filter_by_value(threshold, **kwargs):
    result = {}
    for key, value in kwargs.items():
        if value >= threshold:
            result[key] = value
    return result

print(filter_by_value(50, apple=30, banana=60, cherry=80))

Aqui, `result` é construído verificando cada par chave-valor e adicionando apenas aqueles que atendem à condição.

import unittest

def _dynamic_test(test_case, condition, success_message, failure_message):
    if condition:
        test_case._testMethodName = success_message
        test_case.assertTrue(True, success_message)
    else:
        test_case._testMethodName = failure_message
        test_case.fail(failure_message)

class TestFilterProductsByBudget(unittest.TestCase):
    def test_products_within_budget(self):
        import user_code
        """Checks that only affordable products are returned."""
        try:
            result = user_code.filter_products_by_budget(100, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)
            expected_output = "Available products within budget: {'mouse': 50, 'keyboard': 90}"
            condition = result == expected_output
            failure_message = f"For input `(100, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly filters products within budget.", failure_message)
    
    def test_no_affordable_products(self):
        import user_code
        """Checks that the function returns a message when no products are within budget."""
        try:
            result = user_code.filter_products_by_budget(10, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)
            expected_output = "No products available within the budget."
            condition = result == expected_output
            failure_message = f"For input `(10, laptop=1200, smartphone=800, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly returns a message when no products are affordable.", failure_message)
    
    def test_all_products_affordable(self):
        import user_code
        """Checks that all products are returned if all are within budget."""
        try:
            result = user_code.filter_products_by_budget(500, mouse=50, keyboard=90, headphones=150)
            expected_output = "Available products within budget: {'mouse': 50, 'keyboard': 90, 'headphones': 150}"
            condition = result == expected_output
            failure_message = f"For input `(500, mouse=50, keyboard=90, headphones=150)`, expected `{expected_output}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `filter_products_by_budget` is not defined."
        
        _dynamic_test(self, condition, "The function correctly returns all products when all are affordable.", failure_message)

if __name__ == '__main__':
    unittest.main()

test_main.py

Obtenha uma compreensão sólida de como as funções estruturam a programação em Python. Domine a definição e chamada de funções, o uso de argumentos, o tratamento de valores de retorno e a criação de código flexível e eficiente utilizando recursão e expressões lambda.

Explore o que são funções e por que são essenciais em Python. Aprenda a criar funções, definir argumentos, manipular valores de retorno e utilizar funções embutidas de forma eficaz.

Aprenda como funcionam os argumentos posicionais e opcionais em Python. Desenvolva funções adaptáveis que lidam com diferentes entradas e aumentam a flexibilidade do seu código.

Compreensão de como trabalhar com argumentos arbitrários e nomeados para lidar com tamanhos de entrada variáveis.
Aprendizado sobre como essas técnicas tornam suas funções mais dinâmicas e organizadas.

Descubra como os valores de retorno representam a saída de uma função. Aprenda a retornar valores únicos ou múltiplos, utilizar None e explorar geradores para um controle de fluxo de dados mais avançado.

Desbloqueie conceitos avançados de funções com recursão e funções lambda. Entenda como a recursão resolve problemas repetitivos e como as expressões lambda criam funções concisas em uma única linha.

Argumentos de Palavra-Chave Arbitrários

Solução