Günlükler, raporlar, yapılandırma, dışa aktarmalar: er ya da geç her komut dosyası dosya sistemine dokunur. Python dosya işlemenin başlaması kolaydır, ancak kodunuzun güvenilir olup olmadığına veya verileri sessizce yok edip etmeyeceğine karar verecek birkaç ayrıntı vardır.

Bu kılavuz, güvenli alışkanlıklara odaklanarak metin dosyalarını, CSV, JSON’u, ikili verileri ve yolları kapsar. Bu örnekleri Python 3.13’te geçici bir klasörde çalıştırdık ve gösterilen çıktı bu çalıştırmadan geliyor.

Dosyaları open() ve ile açın

Yerleşik open() işlevi bir dosya nesnesi döndürür. Bir with blok içinde kullanın:

with open("notes.txt", "w", encoding="utf-8") as file:
    file.write("first line\n")
    file.write("second line\n")

print(file.closed)

# True

Blok sona erdiğinde Python, içinde bir hata oluşsa bile dosyayı kapatır. with olmadan, close()‘yi kendiniz aramanız gerekir ve bir istisna bu satırı atlayabilir. Bir dosyayı kapatıldıktan sonra kullanmak bir hataya neden olur:

file.read()

# ValueError: I/O operation on closed file.

Dosya modları

open()‘in ikinci argümanı ne yapmayı planladığınızı söylüyor:

İkili veriler için "rb" veya "wb"‘te olduğu gibi b ekleyin. Metin varsayılandır ve açıkça t olarak da yazılabilir.

Yaz ve ekle

write() satır sonu eklemez, bu nedenle \n‘yi kendiniz ekleyin. Ekleme zaten orada olanı korur:

with open("notes.txt", "a", encoding="utf-8") as file:
    file.write("third line\n")

Bunu, hiçbir uyarı olmadan üç satırımızı bir satırla değiştiren mod "w" ile karşılaştırın:

with open("notes.txt", "w", encoding="utf-8") as file:
    file.write("replaced\n")

# notes.txt now contains only: replaced

Bir şeyin üzerine yazmamanız gerektiğinde "x" kullanın. notes.txt zaten mevcut olduğundan testimizde FileExistsError değerini yükseltti.

Bir dosyayı okuma

Okumanın birkaç yolu vardır ve doğru seçim dosyanın boyutuna bağlıdır:

with open("notes.txt", encoding="utf-8") as file:
    print(repr(file.read()))

# 'first line\nsecond line\n'

with open("notes.txt", encoding="utf-8") as file:
    for line in file:
        print(line.strip())

# first line
# second line
# third line

Ham dizede tutulan \n karakterlerine dikkat edin. strip() onları kaldırır. Bir dosya nesnesi aynı zamanda konumunu da hatırlar, böylece okuma kaldığı yerden devam eder:

with open("notes.txt", encoding="utf-8") as file:
    print(file.readline().strip())
    print(file.readlines())

# first line
# ['second line\n', 'third line\n']

Dosya üzerinde döngü yapmak, büyük günlükler ve dışa aktarmalar için temel tekniktir. Her seferinde bir satır okur, böylece çok gigabaytlık bir dosyanın belleğe sığması gerekmez.

Dosya hatalarını işleme

Dosyalar eksik, kilitli veya okunamaz durumda olabilir; bu nedenle aşağıdakileri planlayın:

try:
    with open("missing.txt", encoding="utf-8") as file:
        data = file.read()
except FileNotFoundError as error:
    print(error)

# [Errno 2] No such file or directory: 'missing.txt'

Dosya, kontrol ile açma arasında kaybolabileceğinden, ilk önce exists() ile kontrol etmek yerine dosyayı açmayı ve hatayı yakalamayı deneyin. Python istisna yönetimi kılavuzumuz bu yaklaşımı kapsamaktadır.

CSV dosyaları

Alıntılanan değerler virgül içerebileceğinden CSV satırlarını kendiniz virgülle bölmeyin. Standart csv modülü bu kuralları yönetir. DictWriter ve DictReader en okunabilir seçeneklerdir:

import csv

with open("orders.csv", "w", newline="", encoding="utf-8") as file:
    writer = csv.DictWriter(file, fieldnames=["id", "customer", "total"])
    writer.writeheader()
    writer.writerow({"id": 1, "customer": "Asha", "total": 1200})
    writer.writerow({"id": 2, "customer": "Ben", "total": 300})

with open("orders.csv", newline="", encoding="utf-8") as file:
    rows = list(csv.DictReader(file))

print(rows[0])
print(sum(int(r["total"]) for r in rows))

# {'id': '1', 'customer': 'Asha', 'total': '1200'}
# 1500

İki ayrıntı önemlidir. Windows’ta boş satırları önlemek için, belgelerin önerdiği gibi CSV dosyalarını açarken newline=""‘i iletin. Ve her değer bir dize olarak, çift sayılar olarak geri gelir; bu nedenle toplamda int()‘e ihtiyacımız vardı. Yoğun veri işleri için pandalar gibi bir kütüphane daha uygun olabilir.

JSON dosyaları

JSON, yapılandırma ve API verileri için olağan formattır. Python sözlükleriyle düzgün bir şekilde eşleşir ve şunları listeler:

import json

config = {"debug": True, "retries": 3, "hosts": ["a", "b"]}

with open("config.json", "w", encoding="utf-8") as file:
    json.dump(config, file, indent=2)

with open("config.json", encoding="utf-8") as file:
    print(json.load(file)["retries"])

# 3

Adlandırmayı unutmayın: dump ve load dosyalarla, dumps ve loads ise dizelerle çalışır. Tarih gibi türler doğrudan saklanamaz, bu nedenle önce bunları dizelere dönüştürmeniz gerekir.

Pathlib’i kullanarak yollarla çalışma

Yolların dizelerle birbirine yapıştırılması, işletim sistemlerinde kesintiye neden olur. Standart pathlib modülü ayırıcıları sizin için yönetir ve kullanışlı kısayollar sunar:

from pathlib import Path

path = Path("data") / "reports" / "summary.txt"
path.parent.mkdir(parents=True, exist_ok=True)
path.write_text("all good\n", encoding="utf-8")

print(path.read_text(encoding="utf-8").strip())   # all good
print(path.suffix, path.stem, path.exists())      # .txt summary True
print(sorted(p.name for p in Path(".").glob("*.csv")))
# ['orders.csv']

Sonuncusu yaygın bir baş ağrısını çözer. Göreli yollar, betiğin bulunduğu yerden değil, betiği çalıştırdığınız yerden çözümlenir; bu nedenle, Path(__file__).parent‘den yol oluşturmak birçok “dosya bulunamadı” sürprizini önler.

İkili dosyalar

Resimler, PDF’ler ve ZIP dosyaları metin değildir. Bunları b ile açın ve hiçbir kodlama olmadan bytes okuyup yazarsınız:

with open("pixel.bin", "wb") as file:
    file.write(bytes([255, 0, 128]))

with open("pixel.bin", "rb") as file:
    print(file.read())

# b'\xff\x00\x80'

Daha güvenli yazar

Bir program önemli bir dosyayı yazmanın yarısında çökerse, bozuk bir sonuçla karşı karşıya kalabilirsiniz. Yaygın olarak uygulanan bir düzeltme, önce geçici bir dosyaya yazıp ardından dosyayı yerine koymaktır:

temp = Path("settings.tmp")
temp.write_text("new", encoding="utf-8")
temp.replace("settings.txt")

print(Path("settings.txt").read_text(), temp.exists())

# new False

replace() hedefin üzerine yazar. Aynı dosya sisteminde yeniden adlandırma genellikle atomiktir, bu nedenle okuyucular yarım yazılmış bir karışım yerine eski dosyayı veya yeni dosyayı görür.

Pratik bir örnek: bir günlüğü özetleme

Bu kısa senaryo birkaç fikri bir araya getiriyor. Günlüğü her seferinde bir satır okur, dolayısıyla boyutu önemli değildir, her düzeyi Counter kullanarak sayar ve yeni bir dosyaya bir özet yazar:

from collections import Counter

counts = Counter()
with open("app.log", encoding="utf-8") as file:
    for line in file:
        counts[line.split()[0]] += 1

with open("summary.txt", "w", encoding="utf-8") as out:
    for level, total in counts.most_common():
        out.write(f"{level}: {total}\n")

# summary.txt
# ERROR: 2
# INFO: 2
# WARN: 1

Örnek günlüğümüzün beş satırı vardı. Boş bir satır line.split()[0]‘i böler, bu nedenle gerçek komut dosyaları önce boş satırları atlamalıdır.

Yaygın hatalar

• "a"‘ü kastederken "w"‘yi kullanmak. Hiçbir şey yazmasanız bile mevcut verileriniz anında açılır.
• Kodlamanın atlanması. Varsayılan, sisteme göre değişir; dolayısıyla Linux’ta çalışan bir komut dosyası, Windows’ta vurgulu metin veya emoji ile başarısız olabilir.
• Büyük dosyalarda read()‘yi çağırmak. Bu, belleği tüketebilir, bu nedenle bunun yerine satırlar üzerinden döngü yapın.
• CSV değerlerinde int()‘yi unutmak. "10" + "20", "1020" değerini verir.
• CSV için newline=""‘yi dışarıda bırakıyoruz. Windows’ta beklenmedik boş satırlarla karşılaşabilirsiniz.
• Dosya kodu test edilmiyor. Testlerin hiçbir zaman gerçek dosyalara dokunmaması için pytest’in tmp_path fikstürünü kullanın. pytest eğitimimize bakın.

Son sözler

Birkaç alışkanlık burada hemen hemen her şeyi kapsıyor: with‘i kullanın, kodlamayı ayarlayın, "w" hakkında iki kez düşünün ve zor kısımları csv, json ve pathlib‘in yapmasına izin verin. Alıştırma yapmak için CSV okuyan, bir sütunu toplayan ve JSON özetini yeni bir klasöre kaydeden küçük bir komut dosyası yazın.

Sık sorulan sorular

Öğrenmeye devam et