Summary  
This chapter shows how to define a function that uses both positional arbitrary arguments (*args) and keyword arbitrary arguments (**kwargs) to flexibly accept any number of inputs and optional settings, then process and printing the results.  

General domain of usage  
Billing and invoicing

Considere uma função que calcula o custo total de vários itens, permitindo que você passe qualquer quantidade de preços e configurações opcionais por palavra-chave, como descontos ou impostos.

def calculate_total_cost(*prices, **settings):
    subtotal = sum(prices)
    discount = settings.get("discount", 0)
    tax = settings.get("tax", 0)
    
    discount_amount = subtotal * (discount / 100)
    taxed_amount = (subtotal - discount_amount) * (1 + tax / 100)
    
    print(f"Subtotal: ${subtotal:.2f}")
    
    if discount > 0:
        print(f"Discount: {discount}% (-${discount_amount:.2f})")
    else:
        print("No discount applied.")
    
    if tax > 0:
        print(f"Tax: {tax}% (+${taxed_amount - (subtotal - discount_amount):.2f})")
    
    print(f"Final total: ${taxed_amount:.2f}")
    print()

# Examples of using the function
calculate_total_cost(1000, 250, 50)
calculate_total_cost(1200, 800, discount=10)
calculate_total_cost(500, 750, 250, discount=5, tax=8)

## Regras para Combinar Argumentos Arbitrários

### Argumentos Posicionais Arbitrários (`*args`)

`*args` coleta todos os **argumentos posicionais** extras em uma tupla.
Neste exemplo, a função pode receber qualquer quantidade de preços de itens sem precisar defini-los explicitamente.

**Por exemplo**:

```python
calculate_total_cost(500, 250, 100)
```

Aqui, `*prices` se torna `(500, 250, 100)`.



### Argumentos Arbitrários Nomeados (`**kwargs`)

`**kwargs` coleta todos os **argumentos nomeados (keyword)** em um dicionário.
Isso permite que a função aceite configurações nomeadas adicionais, como `discount` ou `tax`, mesmo que não tenham sido predefinidas.

**Por exemplo**:

```python
calculate_total_cost(1000, 500, discount=10, tax=5)
```

Aqui, `**settings` se torna `{'discount': 10, 'tax': 5}`.



### Combinando Ambos

É possível usar tanto `*args` quanto `**kwargs` na mesma função para obter **flexibilidade máxima** — permitindo lidar com qualquer quantidade de valores posicionais e qualquer combinação de configurações nomeadas.

Sempre coloque `*args` antes de `**kwargs` na assinatura da função – inverter a ordem resultará em um `SyntaxError`.

Nota

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 TestGenerateReport(unittest.TestCase):
    def test_pass_with_label(self):
        import user_code
        try:
            result = user_code.generate_report(80, 90, 70, label="Math", passing_score=75)
            expected = "Math | Average: 80.00 | Status: Pass"
            condition = result == expected
            failure_message = f"Expected `{expected}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `generate_report` is not defined."
        _dynamic_test(self, condition, "The function correctly returns a passing report with a label.", failure_message)

    def test_fail_without_label(self):
        import user_code
        try:
            result = user_code.generate_report(50, 60, 40, passing_score=65)
            expected = "Report | Average: 50.00 | Status: Fail"
            condition = result == expected
            failure_message = f"Expected `{expected}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `generate_report` is not defined."
        _dynamic_test(self, condition, "The function correctly returns a failing report without a label.", failure_message)

    def test_no_passing_score(self):
        import user_code
        try:
            result = user_code.generate_report(95, 88, 92, label="Science")
            expected = "Science | Average: 91.67"
            condition = result == expected
            failure_message = f"Expected `{expected}`, but got `{result}`."
        except AttributeError:
            condition = False
            failure_message = "The function `generate_report` is not defined."
        _dynamic_test(self, condition, "The function correctly omits status when no passing score is provided.", failure_message)

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

test_code.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.

Combinação de Argumentos Arbitrários Posicionais e Nomeados

Regras para Combinar Argumentos Arbitrários

Argumentos Posicionais Arbitrários (`*args`)

Argumentos Arbitrários Nomeados (`**kwargs`)

Combinando Ambos

Solução