الإعدادات والأسرار
تحتاج البرامج الحقيقية إلى إعدادات يجب ألا تعيش في الكود: مفاتيح 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 أحرف أو أقل تصبح "****".
سيفتح هذا التمرين قريبا
أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.
يقوم هذا المتصفح بحظر ملفات تعريف الارتباط لـ learn.floati.life، لذا لا يمكن فتح الدروس التي أنهيتها هنا بالترتيب. اسمح بملفات تعريف الارتباط لهذا الموقع وأعد التحميل.