سرفصل‌ها درس 46 از 250 · فایل‌ها، خطاها و ماژول‌ها
فایل‌ها، خطاها و ماژول‌ها

پیکربندی و رازها

برنامه‌های واقعی تنظیماتی لازم دارند که نباید در کد باشند: کلیدهای API، نشانی‌های پایگاه داده، یک پرچم debug. دو دلیل برای بیرون نگه‌داشتنشان. اول، رازها در کد منبع نشت می‌کنند: همان لحظه که یک کلید API را در git commit کنید، برای همیشه در تاریخچه است، و push به یک مخزن عمومی آن را به دنیا می‌دهد. دوم، همان کد باید در جاهای مختلف (لپ‌تاپتان، یک سرور) با تنظیمات مختلف اجرا شود.

پاسخ استاندارد متغیرهای محیطی است: مقدارهای نام‌داری که سیستم‌عامل به فرایند شما می‌دهد. 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 نگه می‌دارید که هرگز commit نمی‌کنید (.env را به .gitignore اضافه می‌کنید). فقط خط‌های KEY=value است:

API_KEY=sk-abc123
# a comment
MODEL=claude-opus-5-5
DEBUG=on

کتابخانه‌هایی مانند python-dotenv آن فایل را برایتان در os.environ بار می‌کنند. در پشت صحنه دقیقاً همین خط‌ها را تجزیه می‌کنند. در این تمرین آن تجزیه‌گر را خودتان می‌نویسید، به‌علاوهٔ کمکی‌ای که یک راز را پنهان می‌کند تا چاپش در یک گزارش امن باشد.

قاعدهٔ طلایی: رازها را از محیط بخوانید، آن‌ها را پنهان‌شده گزارش کنید، و هرگز در کد سخت‌کد نکنید.

نوبت شما

سه کمکی بسازید. (1) load_env(text) محتوای یک فایل .env را به یک dict تجزیه می‌کند. خط‌های خالی و خط‌های توضیح (که با # شروع می‌شوند) را رد کنید. هر خط باقی‌مانده را روی نخستین = split کنید. فاصله‌ها را strip کنید، و اگر یک جفت نقل‌قول دور مقدار هست آن را بردارید. یک خط را فقط اگر کلید نام محیطی معتبری باشد نگه دارید: همه حروف بزرگ، و یک شناسهٔ معتبر Python (حرف، رقم و زیرخط، که با رقم شروع نشود). (2) get_setting(env, key, default=None) اگر env[key] باشد آن را برمی‌گرداند، وگرنه default. (3) redact(value) رشته‌ای امن برای گزارش برمی‌گرداند که فقط 4 نویسهٔ آخر را نشان می‌دهد، مثلاً redact("sk-abc123") برابر "****c123" است؛ مقدارهای 4 نویسه یا کمتر "****" می‌شوند.

مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید

این تمرین به‌زودی باز می‌شود

درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و می‌توانید همین الان این درس را بخوانید.