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

Considera una función que calcula el costo total de múltiples artículos, permitiendo pasar cualquier cantidad de precios y configuraciones opcionales mediante palabras clave, como descuentos o impuestos.

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)

## Reglas para combinar argumentos arbitrarios

### Argumentos arbitrarios posicionales (`*args`)

`*args` recopila todos los **argumentos posicionales** adicionales en una tupla.
En este ejemplo, la función puede recibir cualquier cantidad de precios de artículos sin necesidad de definirlos explícitamente.

**Por ejemplo**:

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

Aquí, `*prices` se convierte en `(500, 250, 100)`.



### Argumentos arbitrarios por palabra clave (`**kwargs`)

`**kwargs` recopila todos los **argumentos nombrados (por palabra clave)** en un diccionario.
Esto permite que la función acepte configuraciones adicionales nombradas como `discount` o `tax`, incluso si no fueron predefinidas.

**Por ejemplo**:

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

Aquí, `**settings` se convierte en `{'discount': 10, 'tax': 5}`.



### Combinación de ambos

Se pueden usar tanto `*args` como `**kwargs` en la misma función para lograr **máxima flexibilidad**, permitiendo manejar cualquier cantidad de valores posicionales y cualquier combinación de configuraciones nombradas.

Siempre coloca `*args` antes de `**kwargs` en la firma de la función; invertir el orden resultará en un `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

Adquiera una comprensión sólida de cómo las funciones estructuran la programación en Python. Domine la definición y llamada de funciones, el manejo de argumentos, la gestión de valores de retorno y la creación de código flexible y eficiente mediante recursión y expresiones lambda.

Explora qué son las funciones y por qué son esenciales en Python. Aprende a crear funciones, definir argumentos, manejar valores de retorno y utilizar funciones integradas de manera efectiva.

Aprende cómo funcionan los argumentos posicionales y opcionales en Python. Crea funciones adaptables que gestionen diferentes entradas y mejoren la flexibilidad en tu código.

Comprender cómo trabajar con argumentos arbitrarios y de palabras clave para manejar tamaños de entrada variables. Aprender cómo estas técnicas hacen que las funciones sean más dinámicas y organizadas.

Descubra cómo los valores de retorno representan la salida de una función. Aprenda a retornar valores únicos o múltiples, utilizar None y explorar generadores para un control de flujo de datos más avanzado.

Descubra conceptos avanzados de funciones con recursión y funciones lambda. Aprenda cómo la recursión resuelve problemas repetitivos y cómo las expresiones lambda crean funciones concisas de una sola línea.

Combinación de Argumentos Arbitrarios Posicionales y de Palabras Clave

Reglas para combinar argumentos arbitrarios

Argumentos arbitrarios posicionales (`*args`)

Argumentos arbitrarios por palabra clave (`**kwargs`)

Combinación de ambos

Solución