ديكورات

في الكود المُقدم، يتم إنشاء فئة بإسم FileNode والتي تمثل عقدة لملف. عند إنشاء كائن FileNode، يتم تمرير اسم الملف إليها كمُعلمة. الهدف من هذا الكود هو تعيين قيم لبعض الخصائص الأخرى في الكائن FileNode بناءً على الاسم الذي تم تمريره.

مشكلتك الرئيسية هي أنه عند تعيين قيمة لخاصية filename، لا يتم تحديث قيمة الخاصية extension كما توقعت. السبب في ذلك يعود إلى شيء يُعرف بمشكلة الخصائص المُعرفة باستخدام الطريقة @property في بايثون.

عند استخدام الزخرفة @property، يتم تعريف الخصائص باستخدام الدوال التالية: @property، @{property_name}.setter، و @{property_name}.deleter، والتي تتبع نمط getter و setter و deleter. ولكن في حالتك، هناك خطأ في تعريف الخصائص.

في الحالة الحالية، عندما تقوم بتعيين قيمة لخاصية filename، يتم استدعاء الميثود filename.setter، والتي تعيّن القيمة للمتغير _extension بدلاً من extension، وهذا يتجاهل السلسلة التي تم تمريرها للخصائص. بالإضافة إلى ذلك، لا يتم استخدام الميثود extension.setter عند تعيين قيمة للخاصية extension، لأنه لم يتم تعريفها بشكل صحيح كخاصية قابلة للتعيين.

لحل هذه المشكلة، يمكنك إعادة تنظيم التعريفات كما يلي:

pythonCopy code
class FileNode(object):
    def __init__(self, filename):
        self._filename = filename
        self.show = ""
        self.episode = ""
        self.sequence = ""
        self.shot = ""
        self.task = ""
        self.version = ""
        self._extension = ""
        self.isValid = False

    @property
    def filename(self):
        return self._filename

    @filename.setter
    def filename(self, value):
        self._filename = value
        fl, ex = os.path.splitext(value)
        self.extension = "candles"  # تعيين قيمة الامتداد بشكل مباشر هنا

    @property
    def extension(self):
        return self._extension

    @extension.setter
    def extension(self, value):
        self._extension = value

بهذه الطريقة، يتم تعريف الخصائص filename و extension بشكل صحيح ويمكن تعيينها بشكل مناسب داخل الميثودات المناسبة.

بالطبع، سأوفّر لك المزيد من المعلومات حول المشكلة وكيفية حلها.

عند استخدام الديكورات @property في بايثون، يتم تحويل الوظائف إلى خواص تعمل بنفس طريقة الوظائف، ولكن بدون الحاجة لاستدعائها بواسطة القوسين. لكن يجب أن يتم التأكد من استخدام الأسماء المناسبة للمتغيرات داخل الكلاس.

في حالتك، كان هناك تلاعب غير صحيح بأسماء المتغيرات، حيث أنك استخدمت _extension بدلاً من extension داخل setter لـ filename، وهذا يعني أنه لم يتم تعيين قيمة extension بشكل صحيح عند تعيين filename.

بتنظيم التعريفات كما أوضحت سابقًا، يمكنك الآن تعيين قيمة لـ filename بنجاح، مما يؤدي إلى تحديث قيمة extension وفقًا للمنطق المحدد داخل الميثود filename.setter. هذا يجعل الكود يعمل كما هو متوقع، حيث يمكنك الآن تعيين قيمة لـ extension بنجاح وسيتم تحديثها بدقة.

إذا كنت ترغب في المزيد من المعلومات حول كيفية استخدام الديكورات في بايثون أو حول كيفية التعامل مع الخصائص، فأنا هنا لمساعدتك.

في عالم البرمجة، يعد البرمجة كائنية التوجه (Object-Oriented Programming – OOP) من المفاهيم الرئيسية التي ساهمت في تشكيل وتطوير البرمجة الحديثة. تعتبر لغة البرمجة بايثون Python واحدة من اللغات التي تدعم بنية البرمجة كائنية التوجه بشكل كامل وفعال. دعني أقدم لك نظرة شاملة حول مفاهيم البرمجة كائنية التوجه وكيف يتم تحقيقها في بايثون.

تبني البرمجة كائنية التوجه فلسفة تفرض التفكير في البرمجة على أنها مجموعة من الكائنات، حيث يتم تعريف الكائنات بواسطة الأصناف (Classes). الكائن هو تمثيل لشيء معين في العالم الواقع، والأصناف تحدد هيكل وسلوك هذه الكائنات. في بايثون، يمكن تعريف الأصناف باستخدام كلمة “class”، وتقوم الأصناف بتجميع البيانات (السمات) والوظائف (الطرق) المرتبطة بالكائن.

على سبيل المثال، لنقم بإنشاء فئة بسيطة تمثل سيارة في بايثون:

pythonCopy code
class Car:
    def __init__(self, make, model, year):
        self.make = make
        self.model = model
        self.year = year
        self.odometer_reading = 0

    def get_full_description(self):
        return f"{self.year} {self.make} {self.model}"

    def read_odometer(self):
        return f"The car has {self.odometer_reading} miles on it."

    def update_odometer(self, mileage):
        if mileage >= self.odometer_reading:
            self.odometer_reading = mileage
        else:
            print("You can't roll back the odometer!")

    def increment_odometer(self, miles):
        self.odometer_reading += miles

في هذا المثال، تم إنشاء فئة تسمى “Car”، والتي تحتوي على بعض الخصائص مثل الصانع، الطراز، والسنة. كما يوجد أيضًا بعض الوظائف مثل “get_full_description” التي تعيد وصفًا كاملاً للسيارة، و”read_odometer” التي تعيد قراءة عداد المسافات.

عند استخدام هذه الفئة، يمكنك إنشاء كائن من نوع “Car” واستخدام الوظائف والخصائص المعرفة فيها. على سبيل المثال:

pythonCopy code
my_car = Car("Toyota", "Camry", 2022)
print(my_car.get_full_description())  # Output: 2022 Toyota Camry

my_car.update_odometer(1000)
my_car.increment_odometer(150)
print(my_car.read_odometer())  # Output: The car has 1150 miles on it.

هذا مثال بسيط على كيفية استخدام البرمجة كائنية التوجه في بايثون. تمثل الأصناف والكائنات فعالية وسهولة في تنظيم الشيفرة وفهمها، وهي مناسبة لتطوير تطبيقات معقدة وضخمة.

بالطبع، دعونا نستكمل رحلتنا في عالم البرمجة كائنية التوجه في لغة بايثون، حيث سنستعرض بعض المفاهيم الأخرى المهمة.

التوريث (Inheritance):

التوريث هو مفهوم يسمح للفئة بالاستفادة من الخصائص والوظائف المعرفة في فئة أخرى. يمكن لفئة جديدة أن تكون توسعة لفئة موجودة، وهذا يسهم في إعادة استخدام الشيفرة وتنظيمها. على سبيل المثال:

pythonCopy code
class ElectricCar(Car):
    def __init__(self, make, model, year, battery_capacity):
        super().__init__(make, model, year)
        self.battery_capacity = battery_capacity

    def describe_battery(self):
        return f"The car has a {self.battery_capacity}-kWh battery."

هنا، تم إنشاء فئة جديدة “ElectricCar” تورث من الفئة “Car”. يتم استخدام super() للوصول إلى الوظائف في الفئة الأم. يمكنك إضافة وظائف إضافية للفئة الفرعية دون الحاجة إلى إعادة تعريف الوظائف الموروثة.

التكوينات (Encapsulation):

تعني فكرة إخفاء تفاصيل تنفيذ الفئة وتقديم واجهة برمجية واضحة للمستخدم. يتم تحقيق ذلك بوضع البيانات في الفئة وتعريف وظائف للوصول والتحديث. في بايثون، يُستخدم مصطلحي “private” و “protected” لتحديد مدى إمكانية الوصول إلى السمات والوظائف.

pythonCopy code
class Car:
    def __init__(self, make, model, year):
        self._make = make  # Protected attribute
        self.__model = model  # Private attribute
        self.year = year

    def get_make(self):
        return self._make

    def set_model(self, model):
        self.__model = model

    def get_model(self):
        return self.__model

التعامل مع الاستثناءات (Exception Handling):

في بيئة البرمجة كائنية التوجه، يمكن أن تحدث استثناءات عند حدوث أخطاء. من خلال استخدام كتل التجربة والاستثناء، يمكنك التعامل بشكل فعال مع هذه الحالات وتقديم رسائل خطأ مناسبة.

pythonCopy code
try:
    my_car.update_odometer(-100)  # Trying to set negative mileage
except ValueError as e:
    print(f"Error: {e}")

هنا، تم وضع الكود الذي يمكن أن يثير استثناء داخل كتلة try، وعند حدوث استثناء، يتم التعامل معه داخل كتلة except.

الديكورات (Decorators):

تُستخدم الديكورات لتعديل وظيفة معينة أو توسيع سلوكها. في بايثون، يمكن استخدام الديكورات لتوسيع الوظائف أو تحسينها بسهولة.

pythonCopy code
def log_function_call(func):
    def wrapper(*args, **kwargs):
        print(f"Calling function: {func.__name__}")
        result = func(*args, **kwargs)
        print(f"Function {func.__name__} executed successfully.")
        return result
    return wrapper

@log_function_call
def add_numbers(a, b):
    return a + b

هنا، تم إنشاء ديكورات باستخدام الدالة “log_function_call”، وتم استخدام الديكورات لتوسيع سلوك الدالة “add_numbers”.

البرمجة كائنية التوجه في تطوير البرمجيات:

في تطوير البرمجيات الحديث، تعتبر البرمجة كائنية التوجه أحد المنهجيات الهامة. تساعد هذه الطريقة في تنظيم الشيفرة، وتقليل التشابك والتباعد بين الأجزاء المختلفة من البرنامج، مما يجعلها سهلة الصيانة وفهمها.