المنهج الدراسي الدرس 46 من 250 · الملفات، الأخطاء والوحدات
الملفات، الأخطاء والوحدات

الإعدادات والأسرار

تحتاج البرامج الحقيقية إلى إعدادات يجب ألا تعيش في الكود: مفاتيح API، وعناوين قواعد البيانات، وعلامة التصحيح. هناك سببان لإبقائها خارجه. أولاً، الأسرار في الكود المصدري تتسرّب: في اللحظة التي تُودِع فيها مفتاح API في git، يبقى في السجل إلى الأبد، والدفع إلى مستودع عام يسلّمه للعالم. ثانياً، يجب أن يعمل الكود نفسه في أماكن مختلفة (حاسوبك المحمول، خادم) بإعدادات مختلفة.

الإجابة القياسية هي متغيرات البيئة: قيم مسمى يمررها نظام التشغيل إلى عمليتك. يقرأها Python من os.environ، والتي تعمل مثل dict:

import os
key = os.environ["API_KEY"]              # raises KeyError if missing
debug = os.environ.get("DEBUG", "off")   # a safe default instead

في مرحلة التطوير، تحتفظ بهذه في ملف .env file الذي لا never commit (أنت تضيف .env إلى .gitignore). هي مجرد KEY=value lines:

API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on
تقوم مكتبات

مثل python-dotenv بتحميل ذلك الملف في os.environ من أجلك. تقوم هذه المكتبات في الخلفية بتحليل هذه الأسطر بالضبط. في هذا التمرين ستكتب ذلك الـ parser بنفسك، بالإضافة إلى مساعد يقوم بـ redacts سر بحيث يكون آمناً للطباعة في log.

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

دورك

قم ببناء ثلاث دوال مساعدة. (1) تقوم load_env(text) بتحليل محتويات ملف .env إلى dict. تخطَّ الأسطر الفارغة وأسطر التعليقات (التي تبدأ بـ #). قم بتقسيم كل سطر متبقٍ عند أول =. قم بإزالة المسافات البيضاء، وأزل زوجا واحدا من علامات التنصيص المحيطة بالقيمة إذا وجدت. احتفظ بالسطر فقط إذا كان المفتاح اسما بيئة صالحا: أحرف كبيرة بالكامل، ومعرف Python صالح (أحرف، أرقام، وشرطات سفلية، ولا يبدأ برقم). (2) تعيد get_setting(env, key, default=None) قيمة env[key] إذا كانت موجودة، وإلا تعيد default. (3) تعيد redact(value) سلسلة نصية آمنة للتسجيل تظهر آخر 4 أحرف فقط، مثلا redact("sk-abc123") هي "****c123"؛ القيم التي تتكون من 4 أحرف أو أقل تصبح "****".

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.