ה־**kwarg

חלק מהיחידה תכנות מונחה עצמים במסלול ה-Python של Coddy. שיעור 43 מתוך 64.

**kwargs הוא קיצור של "ארגומנטים עם שמות". הוא מאפשר לפונקציה לקבל כל מספר של ארגומנטים בעלי שם (כמו צמדי key=value) בלי להגדיר את כולם מראש.

איך זה עובד:

*args → אוסף ארגומנטים מיקומיים נוספים לתוך טאפל
**kwargs → אוסף ארגומנטים נוספים של מילות מפתח לתוך מילון

דוגמה פשוטה

נתחיל עם הדוגמה הפשוטה ביותר האפשרית:

def greet(**kwargs):
    print(kwargs)

greet(name="Alice", age=25, country="Australia")

פלט:

{'name': 'Alice', 'age': 25, 'country': 'Australia'}

כפי שאפשר לראות, **kwargs אוסף אוטומטית את כל הארגומנטים בעלי שמות המפתח למילון.

שימוש במילון

מכיוון ש־kwargs הוא כבר מילון, אפשר לעבור עליו ישירות:

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

print_info(name="Bob", age=30, job="Teacher")

פלט:

Information received:
name: Bob
age: 30
job: Teacher

שילוב פרמטרים רגילים עם **kwargs

אפשר לשלב פרמטרים רגילים עם **kwargs:

def create_profile(name, **details):
    print(f"Creating profile for: {name}")
    print("Additional details:")
    for key, value in details.items():
        print(f"  {key}: {value}")

create_profile("Sarah", age=28, city="London", hobby="Reading")

פלט:

Creating profile for: Sarah
Additional details:
  age: 28
  city: London
  hobby: Reading

**kwargs ריקים

אם לא מועברים ארגומנטים בעלי שם, kwargs תהיה מילון ריק:

def show_data(**kwargs):
    if kwargs:
        print("Data:", kwargs)
    else:
        print("No data provided")

show_data()  # ללא ארגומנטים
show_data(item="apple")  # עם ארגומנטים

פלט:

No data provided
Data: {'item': 'apple'}

דוגמה מהעולם האמיתי: מחלקה עם **kwargs

כך אפשר להשתמש ב־**kwargs במחלקה:

class Person:
    def __init__(self, name, **kwargs):
        self.name = name
        self.details = kwargs
    
    def show_info(self):
        print(f"Name: {self.name}")
        for key, value in self.details.items():
            print(f"{key}: {value}")

person = Person("Alice", age=25, city="New York", job="Engineer")
person.show_info()

פלט:

Name: Alice
age: 25
city: New York
job: Engineer

פירוק מילונים

אפשר גם לפרוק מילונים בעת קריאה לפונקציות:

def display_settings(**kwargs):
    for setting, value in kwargs.items():
        print(f"{setting} = {value}")

settings = {"debug": True, "verbose": False, "timeout": 30}
display_settings(**settings)  # פורס את המילון

פלט:

debug = True
verbose = False
timeout = 30

נקודות עיקריות:

**kwargs אוסף ארגומנטים של מילות מפתח למילון: אין צורך בהמרה, הוא כבר כזה
השם kwargs הוא שם מקובל — אפשר להשתמש בכל שם אחרי **
השתמשו בו כשרוצים חתימות פונקציה גמישות
מצוין לטיפול בפרמטרים אופציונליים או בהגדרות תצורה

אתגר

קל

באתגר הזה, תממשו מערכת ליצירת אנשים עם כיסוי מקיף של בדיקות.

עליכם לערוך רק את הקובץ person_creator.py, בהתאם להערות TODO שמנחות את המימוש שלכם. הקובץ מכיל מבנה של מחלקה ליצירה ולניהול של אובייקטים המייצגים אנשים, עם מגוון מאפיינים.

נסו בעצמכם

from person_creator import create_person

# מטפל מקיף במקרי בדיקה
test_case = input()

if test_case == "basic_test":
    create_person(name="John", age=25, occupation="Engineer")
    # פלט:
    # Person created with properties:
    # name: John
    # age: 25
    # occupation: Engineer

elif test_case == "empty_test":
    create_person()
    # פלט:
    # Person created with properties:
    # (אין פלט נוסף מכיוון שאין מאפיינים)

elif test_case == "many_properties":
    create_person(name="Alice", age=30, occupation="Doctor", city="New York", 
                 country="USA", hobby="Reading", email="alice@example.com")
    # פלט:
    # Person created with properties:
    # name: Alice
    # age: 30
    # occupation: Doctor
    # city: New York
    # country: USA
    # hobby: Reading
    # email: alice@example.com

elif test_case == "special_characters":
    create_person(name="Bob", email="bob@example.com", phone="123-456-7890")
    # פלט:
    # Person created with properties:
    # name: Bob
    # email: bob@example.com
    # phone: 123-456-7890

elif test_case == "numeric_keys":
    create_person(name="Charlie", age=35, height=175, weight=70)
    # פלט:
    # Person created with properties:
    # name: Charlie
    # age: 35
    # height: 175
    # weight: 70

elif test_case == "boolean_values":
    create_person(name="David", is_student=True, is_employed=False)
    # פלט:
    # Person created with properties:
    # name: David
    # is_student: True
    # is_employed: False

elif test_case == "nested_structures":
    create_person(name="Eve", hobbies=["Reading", "Swimming", "Coding"], 
                 address={"city": "Boston", "state": "MA", "zip": "02108"})
    # פלט:
    # Person created with properties:
    # name: Eve
    # hobbies: ['Reading', 'Swimming', 'Coding']
    # address: {'city': 'Boston', 'state': 'MA', 'zip': '02108'}

elif test_case == "unicode_characters":
    create_person(name="José", city="São Paulo", country="Brasil")
    # פלט:
    # Person created with properties:
    # name: José
    # city: São Paulo
    # country: Brasil