التسلسل

طريقان إلى نفس الفكرة

الأساسيات المطلوبة

المفاهيم الأساسية

التسلسل (Serialization) هو تحويل بنية بيانات أو كائن موجود في ذاكرة البرنامج إلى تسلسل من البايتات أو نص يمكن تخزينه أو نقله. فك التسلسل (Deserialization) هو العملية العكسية: إعادة بناء الكائن الأصلي من تلك البايتات.

الرسم 18: رحلة التسلسل كاملة: ذهابًا (serialize) وعودة (deserialize)، الهدف أن يكون OBJ2 مطابقًا تمامًا لـOBJ‏.

أربع صيغ، أربعة أمثلة أصلية

1JSON: إعدادات لعبة بسيطة

import json

settings = {"player_name": "نورة", "volume": 75, "difficulty": "صعب"}

with open("settings.json", "w", encoding="utf-8") as f:
    json.dump(settings, f, ensure_ascii=False, indent=2)

with open("settings.json", "r", encoding="utf-8") as f:
    loaded = json.load(f)

print(loaded["difficulty"])   # صعب — نفس القيمة بالضبط

2Pickle: حفظ كائن مخصّص (ملف حفظ لعبة)

import pickle

class GameSave:
    """يمثّل تقدّم لاعب داخل لعبة."""
    def __init__(self, level, score, inventory):
        self.level = level
        self.score = score
        self.inventory = inventory

    def serialize(self, filename):
        with open(filename, "wb") as f:
            pickle.dump(self, f)

    @classmethod
    def deserialize(cls, filename):
        with open(filename, "rb") as f:
            return pickle.load(f)


save = GameSave(level=7, score=3200, inventory=["درع", "مفتاح ذهبي"])
save.serialize("save1.pkl")

restored = GameSave.deserialize("save1.pkl")
print(restored.level, restored.inventory)   # 7 ['درع', 'مفتاح ذهبي']

لاحظ أن pickle.load() لم يحتَج منك أن تخبره أي صنف يُعيد بناءه، لأن Pickle يخزّن مع البيانات نفسها مرجعًا لاسم الصنف ووحدته بالإضافة إلى لقطة من __dict__ الكائن، فيستورد الصنف تلقائيًا عند الاستعادة ويُعيد بناء كائن جديد بنفس الحالة بالضبط. هذا بالضبط مصدر الخطر الأمني المذكور أعلاه: استعادة بيانات Pickle تعني تنفيذ كود استيراد وبناء كائنات بثقة كاملة بما تحتويه.

3CSV إلى JSON: تحويل جدول نتائج

import csv
import json

## scores.csv يحتوي: name,points\nسارة,88\nعمر,95
with open("scores.csv", "r", encoding="utf-8") as csv_file:
    reader = csv.DictReader(csv_file)
    rows = list(reader)

with open("scores.json", "w", encoding="utf-8") as json_file:
    json.dump(rows, json_file, ensure_ascii=False, indent=2)
## النتيجة: [{"name": "سارة", "points": "88"}, {"name": "عمر", "points": "95"}]

4XML: قراءة قائمة مخزون بسيطة

import xml.etree.ElementTree as ET

## inventory.xml:
## <inventory>
##   <item name="سيف" quantity="2"/>
##   <item name="ترس" quantity="1"/>
## </inventory>

tree = ET.parse("inventory.xml")
root = tree.getroot()
for item in root.findall("item"):
    print(item.get("name"), "->", item.get("quantity"))

مثال محلول

خرافة مقابل حقيقة

أين تُستخدم هذه الفكرة فعليًا؟

جرّب بنفسك

بطاقات مراجعة سريعة

اختبر فهمك