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

Tarkastellaan funktiota, joka laskee useiden tuotteiden kokonaiskustannuksen ja mahdollistaa minkä tahansa määrän hintoja sekä valinnaisia avainsana-asetuksia, kuten alennuksia tai veroja.

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)

## Säännöt mielivaltaisten argumenttien yhdistämiseen

### Paikalliset mielivaltaiset argumentit (`*args`)

`*args` kerää kaikki ylimääräiset **paikalliset argumentit** tupleen.
Tässä esimerkissä funktio voi ottaa minkä tahansa määrän tuotehintoja ilman, että niitä tarvitsee määritellä erikseen.

**Esimerkiksi**:

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

Tässä `*prices` on `(500, 250, 100)`.



### Avainsanalliset mielivaltaiset argumentit (`**kwargs`)

`**kwargs` kerää kaikki **nimetyt (avainsana) argumentit** sanakirjaan.
Tämän avulla funktio voi ottaa vastaan ylimääräisiä nimettyjä asetuksia, kuten `discount` tai `tax`, vaikka niitä ei olisi ennalta määritelty.

**Esimerkiksi**:

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

Tässä `**settings` on `{'discount': 10, 'tax': 5}`.



### Molempien yhdistäminen

Voit käyttää sekä `*args` että `**kwargs` samassa funktiossa saavuttaaksesi **maksimaalisen joustavuuden** – mahdollistaen minkä tahansa määrän paikallisia arvoja ja minkä tahansa yhdistelmän nimettyjä asetuksia.

Aseta aina `*args` ennen `**kwargs` funktioallekirjoituksessa – järjestyksen vaihtaminen aiheuttaa `SyntaxError`-virheen.

Huomio

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

Hanki vankka ymmärrys siitä, miten funktiot muovaavat Python-ohjelmointia. Hallitse funktioiden määrittely ja kutsuminen, argumenttien käsittely, palautusarvojen hallinta sekä joustavan ja tehokkaan koodin luominen rekursion ja lambda-lausekkeiden avulla.

Tutustu funktioiden määritelmään ja niiden merkitykseen Pythonissa. Opiskele funktioiden luomista, argumenttien määrittelyä, paluuarvojen käsittelyä sekä sisäänrakennettujen funktioiden tehokasta käyttöä.

Opi, miten paikalliset ja valinnaiset argumentit toimivat Pythonissa. Rakenna mukautuvia funktioita, jotka käsittelevät erilaisia syötteitä ja parantavat koodin joustavuutta.

Ymmärrys mielivaltaisten ja avainsana-argumenttien käytöstä vaihtelevan syötteen käsittelemiseksi. Näiden tekniikoiden avulla funktioista tulee dynaamisempia ja järjestelmällisempiä.

Opi, miten palautusarvot kuvaavat funktion tuottamaa tulosta. Palauta yksi tai useampi arvo, käytä None-arvoa ja tutustu generaattoreihin edistyneemmän tietovirran hallinnan saavuttamiseksi.

Opi edistyneitä funktiokäsitteitä rekurssion ja lambda-funktioiden avulla. Rekurssio mahdollistaa toistuvien ongelmien ratkaisun, kun taas lambda-lausekkeet luovat tiiviitä, yhdellä rivillä määriteltäviä funktioita.

Paikallisten ja avainsanallisten mielivaltaisten argumenttien yhdistelmä

Säännöt mielivaltaisten argumenttien yhdistämiseen

Paikalliset mielivaltaiset argumentit (`*args`)

Avainsanalliset mielivaltaiset argumentit (`**kwargs`)

Molempien yhdistäminen

Ratkaisu