الدروس ولعبة التعلّم

الملفات وCSV وJSON

ابنِ حاسوب رحلة لمنطاد أرصاد جوية: كتابة آمنة للملفات، وحساس مباشر يُسجَّل في ملف CSV، وإعدادات بصيغة JSON، وكود يتحمّل أخطاء القرص.

الدورة

الملفات وCSV وJSON دورة برمجة متوسطة في سبعة دروس. يعمل كل درس على Raspberry Pi Zero 2 W من المعرض مع حساس BME280 على I2C، وهو حاسوب الرحلة لمنطاد Skylark 3 عالي الارتفاع (يطير Zero لأن وزنه 11 غراماً فقط). يذكر الفهرس Pi 4، لكن الـ Pi الوحيد في المعرض المزوّد بـ BME280 هو Zero، لذا تعمل الدورة عليه. تُفحص كل خطوة مقابل ما يطبعه الـ Pi.

  1. قراءة الملفات: with open وread وreadlines والرمز المخفي \n، وحلقة تتخطى الأسطر الفارغة والتعليقات، ومحلل key: value يحافظ على النقطتين داخل 09:30، والبايتات في الأسفل مع "rb".
  2. الكتابة بأمان: "w" التي تمسح الملف، و"a" التي تضيف في النهاية، وprint(..., file=f)، وحفظ ذرّي باستخدام os.replace يحافظ على آخر نسخة سليمة عبر انقطاع كهرباء مزيّف.
  3. CSV داخلاً وخارجاً: رحلة مسجّلة تُقرأ بـ DictReader، وضغط جوي يتحول إلى ارتفاع (حتى 26 كم، والستراتوسفير تسخن)، وحساس BME280 الحي يُسجَّل بـ csv.writer، وترويسة تُكتب مرة واحدة، وفواصل وعلامات اقتباس داخل القيم.
  4. إعداد JSON:‏ json.load، والقيم الافتراضية تُملأ باستخدام dict وupdate، وتحقق يُبلغ عن كل المشكلات دفعة واحدة، وحفظ آمن باستخدام indent وsort_keys، وما يتغيّر في JSON أثناء العملية (المفاتيح الرقمية تعود كنصوص).
  5. المسارات والمجلدات: مجلد العمل /home/pi، ومجلدات مؤرخة بـ makedirs، وأسماء سجلات مرقّمة لا تُستبدل أبداً، وpathlib، وos.walk مع الأحجام.
  6. أخطاء القرص: ملف إعدادات مفقود، وملف إعدادات اقتُطع أثناء الحفظ ونُقل جانباً بامتداد .bad، وFileExistsError وIsADirectoryError، وصفوف CSV تالفة تُحسب بـ try وelse وfinally، وعائلة OSError عبر errno.
  7. المشروع: أداة سجل حساس: الختام.

الخاتمة

The project is the tool Skylark's team runs before launch, typed to in the Serial Monitor. It loads config.json over its defaults, makes its folder, and answers help, log N (N live readings into a new numbered CSV, one every interval_s seconds), list (each log with its rows and size) and summary (every log read back, bad rows skipped and counted, the result saved as summary.json atomically). The last step cools the BME280 to 2 C and the logger raises the alarm set in config.json. Then comes an honest datasheet note: a BME280 reads pressure only down to 300 hPa, about 9 km.

ما يفعله محرك Pi بشكل مختلف

يعمل Pi على MicroPython 1.29 مع مكتبة قياسية على نمط CPython:

  • تُكتب تبويباتك في /home/pi عند بدء «تشغيل». تبقى الملفات التي يكتبها البرنامج حتى ينتهي، وتبدأ التشغيلة التالية من تبويباتك مرة أخرى.
  • os وos.path وpathlib وglob وcsv وjson تعمل كما في CPython. نمط الفتح "x" غير موجود، ووقت تعديل الملف لا يتغير عند الكتابة عليه.
  • لا يستطيع القاموس الحرفي تفكيك قاموس آخر ({**a, **b})، لذا تُدمج القيم الافتراضية باستخدام dict(a) وupdate(b)، وهو ما يعمل في كل مكان.
  • قارئ json يقبل فاصلة بعد العنصر الأخير، وهو ما يرفضه CPython، وأخطاؤه تقول دائماً السطر 1، العمود 1.
  • القاموس لا يحتفظ بترتيب خاص به، لذا تمر الجداول على sorted(...) ويثبّت DictWriter ترتيب الأعمدة باستخدام fieldnames.
  • str.zfill is missing; f"{n:03d}" pads numbers on both engines.