الـ **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 يجمع arguments الكلمات المفتاحية في dictionary: لا حاجة إلى تحويل، فهي already كذلك
الاسم kwargs اصطلاحي - يمكنك استخدام أي اسم بعد **
استخدمه عندما تريد تواقيع دوال مرنة
مفيد جدًا للتعامل مع المعلمات الاختيارية أو إعدادات settings

التحدي

سهل

في هذا التحدي، ستنفّذ نظامًا لإنشاء الأشخاص مع تغطية شاملة للاختبارات.

تحتاج إلى تعديل ملف only person_creator.py، باتباع تعليقات TODO التي ترشدك خلال عملية التنفيذ. يحتوي الملف على بنية فئة لإنشاء كائنات الأشخاص وإدارتها مع خصائص متنوعة.

REQUIRED OUTPUT FORMAT: [Your translated content here]

جرّب بنفسك

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