Python ile kayıt (log) dosyaları

Son uğraştığım ufak programda Python'un logging modülünü kullanarak kayıt işlemleri yapıyorum. Kısaca nasıl yapıldığını açıklayayım dedim.

Python ile logging modülü kullanmak için gereken ilk iş, logging modülünü içe aktarıp, getLogger ile yeni bir kayıt tutucu oluşturmak. Bunun nasıl yapıldığını görmek için, aşağıdaki örnek python kodunu inceleyelim.

import logging

# "benim-program-ana-modul" adında yeni bir kayıtçı al
ana_modul_kayitci = logging.getLogger("benim-program-ana-modul")
# bu kayıtçı debug seviyesinde kayıt yapsın.
ana_modul_kayitci.setLevel(logging.DEBUG)

Daha sonra, bu kayıtçı için en az 1 tane handler (bundan sonra işleyici olarak bahsedilecek) eklememiz gerekiyor. Bu işleyicilerin çoğu logging.handlers içersinde bulunurken, aşağıda kullandığım iki tanesi, doğrudan logging modülü içerisinde tanımlanmış. Daha önce belirttiğim gibi sadece bir tane işleyici yetecektir, ben örnek oluşturması için, iki tanesini aşağıdaki python kodundan belirttim.

# logging modulünde tanımlanmış dosyaya kaydedici.
# argüman olarak kayıt dosyasının yolu.
dosya = logging.FileHandler("benim-program-ana-modul.log")

# logging modülünde tanımlanmış standart çıktıya kaydedici
standard_cikti = logging.StreamHandler()

Böylece, elimizde iki adet işleyici var (logging.StreamHandler ve logging.FileHandler). Bu işleyicilerin görevi, kayıt tutulmasını istediğiniz bilgileri gerekli şekillerde kullanmak. Örneğin yukarıdaki örnekte, bir işleyicinin görevi, kayıt altına alınan bilgileri ekrana basmak (logging.StreamHandler), bir diğerinin görevi ise, kayıt altına alınan bilgileri dosyaya kaydetmek (logging.FileHandler). Bunlar gibi daha birkaç çeşit çekirdek python modüllerinde tanımlanmış kayıt işleyiciler var. Şimdi bunlara çıktı formatı ekleyelim. Bunun için logging.Formatter kullanacağız. İkisine ayrı ayrı çıktı formatı eklenebilir, Örnekte tek bir format oluşturup, iki işleyici için de bunu kullanacağım.

# Örn: 2011-09-28 11:45:58,394 - hebele [CRITICAL]: kayıtçı hazır
log_format = logging.Formatter('%(asctime)s - %(name)s [%(levelname)s]: %(message)s')

dosya.setFormatter(log_format)
standart_cikti.setFormatter(log_format)

Böylece kayıt işleyicilerimiz için kayıt formatı belirledik. Bu formatı kişisel zevklerinize ve ihtiyaçlarınıza göre düzenleyebilirsiniz. Şimdi tek ihtiyacımız bu işleyicileri kayıt tutucumuza eklemek, böylece kayıt dosyası oluşturmaya hazır hale geleceğiz.

ana_modul_kayitci.addHandler(dosya)
ana_modul_kayitci.addHandler(standart_cikti)

# artık kayıt tutmaya hazırız.

ana_modul_kayitci.info("kayıt tutucu hazır") # bilgi mesajı
ana_modul_kayitci.warning("Kendine mukayyet ol!") # uyarı mesajı
ana_modul_kayitci.critical("Elektirikler kesildi!") # Kritik bilgi
ana_modul_kayitci.error("Elim kapıya sıkıştı.") # Hata mesajı
ana_modul_kayitci.debug("Nefes aldım.") # hata ayıklama mesajı
ana_modul_kayitci.debug("Nefes verdim.") # hata ayıklama mesajı
ana_modul_kayitci.debug("Tekrar nefes aldım.") # hata ayıklama mesajı

Böylece python'da logging modülünü kullanarak kayıt işlemi yapmış olduk. Kolay Gelsin.