ConfigParser Kullanımı

Daha önce programlarınızın dosyalarını incelediyseniz, .ini,.cfg uzantılı dosyalar olduğunu görmüşsünüzdür. Bu dosyalar, programlara ait birtakım veriler içerirler. Programların yapılandırma dosyaları diyebiliriz. Örneğin, Python IDLE arayüzünü kendinize göre değiştirdiğinizde, bu değişimi bir sonraki açılışta tekrar hatırlamak için bu tercihlerinizi Belgeler\.idlerc dizini altında .cfg dosyaları içerisinde saklar. Böylece IDLE açıldığında bu dosyalara bakarak arayüzü oluşturur. İçeriği şuna benzerdir

[benim_temam] arkaplan = #000000 onplan = #04ad54 font_boyut = 15 [benim_temam_2] arkaplan = #00ff00 onplan = #04adff font_boyut = 12

Bizler de bir program yazarken verilerimizi böyle basit dosyalarda saklamak isteyebiliriz. Ancak dikkat edin, bu tür dosyalara genelde yapılandırma ayarları kaydedilir, kritik bilgiler içeren veriler değil. O yüzden, programımıza ait yapılandırma verilerini bu dosyalarda saklayabiliriz.

Python herzaman ki gibi bizleri düşünmüş ve bunu yapabilmemiz için bizlere bir modül sunmuş. ConfigParser. Bu modülü kullanarak yapılandırma dosyalarını okuyabilir, düzenleyebilir, veya sözlük yapılarını kullanarak yeni bir yapılandırma dosyası oluşturabilirsiniz.

ConfigParser modülü, hem Python2 hem de Python3 de kullanılabilen bir modüldür. Aralarında bazı ufak tefek farklılıklar var, ancak çok da göze batmıyor.

İlk olarak ConfigParser modülü Python2 de ConfigParser, Python3 de configparser olarak isimlendirilmiş. Kullandığınız Python versiyonuna göre uygun olanı import ederek kullanabilirsiniz. Biz burada Python3 baz alarak örneklerimizi yapacağız. Öyleyse, artık başlayalım

İlk olarak bir tane dosya oluşturalım ve içerisine şunları ekleyelim. Bu dosya, bizim parse edeceğimiz dosya olacaktır.


[tema1] foreground = #FFFFFF background = #000000 font_size = 15 font_color = #00FF00 [tema2] foreground = #000000 background = #FFFFFF font_size = 21 font_color = #00CCFF

[tema1] ve [tema2] , yapılandırma dosyamızın bölümleridir(sections). Bunların altında bulunan değerlere ulaşmak için bölüm adlarını kullanacağız, böylece karışıklık olmamış olur. Örneğin tema1 ve tema2 de de bulunan foreground değerine ulaşmak için önce ilgili bölüme, sonra değere  ulaşacağız.

Şimdi dosyamızı ayar.ini olarak kaydedelim. İstediğiniz uzantıda da kaydedebilirsiniz, ancak bu dosyanın bir yapılandırma dosyası olduğun belirtmek her zaman daha iyidir. Şimdi, bu dosyayı python ile nasıl açacağımızı ve nasıl parse edeceğimizi görelim


import configparser # Python2 için ConfigParser olarak import etmelisiniz. parser = configparser.ConfigParser() parser.read("ayar.ini") # eğer ayar.ini dosyanız program ile aynı dizinde değilse # bulunduğu dizini yazmalısınız, aksi takdirde açılmayacaktır. print("Ayar.ini dosyasında bulunan bölümler") bolumler = parser.sections() for i in bolumler: print(i) print("\ntema1 içerisindeki veriler ve değerleri") for i in parser["tema1"]: print("\t{} = {}".format(i,parser["tema1"][i])) print("\ntema2 içerisindeki veriler ve değerleri") for i in parser["tema2"]: print("\t{} = {}".format(i,parser["tema2"][i]))

Eğer daha önce Python'da sözlükleri kullandıysanız yukarıdaki kod size çok tanıdık gelecektir. Çünkü, parse ettiğimiz veriler aynen sözlük yapısı gibi tutulur.

Gördüğünüz gibi, parse etmek ve bunlara erişmek oldukça kolay. Peki bu değerleri nasıl değiştireceğiz ve kaydedeceğiz? Yukarıdaki örneğimizi tekrar düzenleyelim

import configparser # Python2 için ConfigParser olarak import etmelisiniz. parser = configparser.ConfigParser() parser.read("ayar.ini") # eğer ayar.ini dosyanız program ile aynı dizinde değilse # bulunduğu dizini yazmalısınız, aksi takdirde açılmayacaktır. #tema1'deki foreground'ın değerini değiştiriyoruz parser.set("tema1","foreground","#FF00FF") #şimdi kaydedeceğiz with open("ayar.ini","w") as dosya: parser.write(dosya) #artık değişiklik tamamlandı

Bir yapılandırma dosyasından verileri uygun formatta okumak isteyebilirsiniz. Çünkü normal olarak okuduğunuzda bir string olarak okursunuz, istediğiniz formata kendiniz çevirmeniz gerekir. Ancak get metotlarını kullanarak okuyacağımız veriyi bize istediğimiz formatta vermesini isteyebiliriz. Örneğin okuyacağınız değer sayıysa, bunu string olarak alıp int tipine dönüştürmek yerine direkt olarak int tipinde elde edebilirsiniz.

Bunu yapmanın iki yolu var. Örneğimizle görelim


import configparser # Python2 için ConfigParser olarak import etmelisiniz. parser = configparser.ConfigParser() parser.read("ayar.ini") # birinci yol tema1 = parser["tema1"] deger = tema1.getint("font_size") print(deger) # ikinci yol deger = parser["tema1"].getint("font_size") print(deger)

Diğer metotlar

getfloat: virgüllü sayı olarak okumayı sağlar
getboolean: mantıksal ifade olarak okumayı sağlar(True veya False)
getint: tamsayı olarak okumayı sağlar

Şimdiye kadar hep dosyadan okuma üzerine gördük. Şimdi de program içerisinde oluşturdumuz yapılandırma ayarlarını nasıl dosyaya kaydedebileceğimizi göreceğiz. Bir yapılandırma dosyası içeriği oluşturmak için sözlük yapılarını kullanacağız. Ve daha sonra bu sözlüğü dosyamıza kaydedeceğiz


import configparser # Python2 için ConfigParser olarak import etmelisiniz. parser = configparser.ConfigParser() parser["ayar1"] = {"id":0, "kullanıcı":"root", "dizin":"/root", "derece":10.0, "yetki":True} parser["ayar2"] = {"id":1, "kullanıcı":"coderistan", "dizin":"/home/coderistan", "derece":5.0, "yetki":False} with open("kullanici.ini","w") as dosya: parser.write(dosya)
Program çalışıp işini bitirdikten sonra, programın bulunduğu dizinde kullanici.ini dosyası olacak ve içeriği şu şekilde olacaktır.

[ayar1] id = 0 kullanıcı = root dizin = /root derece = 10.0 yetki = True [ayar2] id = 1 kullanıcı = coderistan dizin = /home/coderistan derece = 5.0 yetki = False

Şimdiye gördüğümüz herşey, import ederken yazımı hariç, Python3 ve Python2 de aynıdır. Yine de bir sorun yaşarsanız lütfen yorum olarak belirtin.

Yazımızın sonuna geldik, bir başka yazıda buluşmak dileğiyle :)