पाठ्यक्रम 250 में से पाठ 46 · फ़ाइलें, त्रुटियाँ और मॉड्यूल
फ़ाइलें, त्रुटियाँ और मॉड्यूल

कॉन्फ़िगरेशन और secrets

असली प्रोग्रामों को ऐसी सेटिंग चाहिए होती हैं जो कोड में नहीं रहनी चाहिए: API कुंजियाँ, डेटाबेस URL, एक debug फ़्लैग। उन्हें बाहर रखने के दो कारण हैं। पहला, सोर्स कोड में रखे secrets लीक होते हैं: जैसे ही आप git में कोई API कुंजी commit करते हैं, वह हमेशा के लिए इतिहास में रहती है, और किसी सार्वजनिक repo में 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 में लोड करती हैं। अंदर से वे ठीक यही पंक्तियाँ पार्स करती हैं। इस अभ्यास में आप वह पार्सर ख़ुद लिखेंगे, साथ में एक helper जो किसी secret को छिपा (redact) देता है ताकि उसे लॉग में print करना सुरक्षित हो।

सुनहरा नियम: secrets एनवायरनमेंट से पढ़ें, उन्हें छिपाकर लॉग करें, और उन्हें कभी कोड में सीधे न लिखें।

आपकी बारी

तीन helper बनाएँ। (1) load_env(text) एक .env फ़ाइल की सामग्री को dict में पार्स करता है। ख़ाली पंक्तियाँ और टिप्पणी वाली पंक्तियाँ (# से शुरू होने वाली) छोड़ दें। हर बची पंक्ति को पहले = पर split करें। ख़ाली जगह strip करें, और अगर मान के चारों ओर quotes का एक जोड़ा हो तो उसे हटाएँ। कोई पंक्ति तभी रखें जब कुंजी एक मान्य एनवायरनमेंट नाम हो: पूरी तरह बड़े अक्षरों में, और एक मान्य Python identifier (अक्षर, अंक और अंडरस्कोर, अंक से शुरू नहीं)। (2) get_setting(env, key, default=None) मौजूद होने पर env[key] लौटाता है, नहीं तो default। (3) redact(value) लॉग करने के लिए सुरक्षित एक स्ट्रिंग लौटाता है जो सिर्फ़ आख़िरी 4 अक्षर दिखाती है, जैसे redact("sk-abc123") का नतीजा "****c123" है; 4 या कम अक्षरों वाले मान "****" बन जाते हैं।

इस पाठ में कोई समस्या दिखी? बताएँ · इस पाठ के बारे में पूछें

यह अभ्यास जल्द खुलेगा

इससे पहले वाला पाठ पूरा करें और यह खुल जाएगा। पूरा कोर्स मुफ़्त है, कोई खाता नहीं चाहिए, और आप यह पाठ अभी पढ़ सकते हैं।