Müfredat 250 dersinden 46. · Dosyalar, Hatalar ve Modüller
Dosyalar, Hatalar ve Modüller

Yapılandırma ve sırlar

Gerçek programların kodda olmaması gereken ayarlara ihtiyacı vardır: API anahtarları, veritabanı URL'leri, bir hata ayıklama bayrağı. Onları dışarıda tutmanın iki nedeni var. Birincisi, kaynak koddaki sırlar sızar: bir API anahtarını git'e commit ettiğin anda o sonsuza kadar geçmiştedir, ve genel bir depoya göndermek onu dünyaya verir. İkincisi, aynı kod farklı yerlerde (dizüstün, bir sunucu) farklı ayarlarla çalışmalıdır.

Standart cevap ortam değişkenleridir: işletim sisteminin sürecine verdiği adlandırılmış değerler. Python onları bir sözlük gibi davranan os.environ'dan okur:

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

Geliştirmede bunları asla commit etmediğin bir .env dosyasında tutarsın (.env'i .gitignore'a eklersin). Yalnızca KEY=value satırlarıdır:

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

python-dotenv gibi kütüphaneler o dosyayı senin için os.environ'a yükler. Arka planda tam olarak bu satırları ayrıştırırlar. Bu alıştırmada o ayrıştırıcıyı kendin yazacaksın, artı bir sırrı bir günlüğe yazdırmak güvenli olsun diye maskeleyen bir yardımcı.

Altın kural: sırları ortamdan oku, maskelenmiş olarak günlüğe yaz, ve asla koda gömme.

Senin sıran

Üç yardımcı fonksiyon oluştur. (1) load_env(text), bir .env dosyasının içeriğini bir dict içine ayrıştırır. Boş satırları ve yorum satırlarını (# ile başlayan) atla. Kalan her satırı ilk = karakterinden böl. Boşlukları temizle ve değerde varsa bir çift çevreleyen tırnağı temizle. Sadece anahtar geçerli bir ortam adı ise satırı tut: tamamen büyük harf ve geçerli bir Python tanımlayıcısı (harf, rakam ve alt çizgi, rakamla başlamayan). (2) get_setting(env, key, default=None), varsa env[key] döndürür, yoksa default döndürür. (3) redact(value), sadece son 4 karakteri gösteren güvenli bir log dizisi döndürür, örneğin redact("sk-abc123"), "****c123" olur; 4 karakter veya daha az olan değerler "****" olur.

Bu derste bir sorun mu fark ettin? Bildir · Bu ders hakkında soru sor

Bu alıştırma yakında açılacak

Bu dersi bitirince bu ders açılacak. Kursun tamamı ücretsiz, hesap gerekmiyor ve bu dersi hemen şimdi okuyabilirsin.