Agora Metin2 1
Agora Metin2
berzahx 1
berzahx
Aliyldrim 1
Aliyldrim
-ECD- 1
-ECD-
Reklam vermek için turkmmo@gmail.com

Python'da Dosya Kontrolü: os.path, pathlib ve try/except Yöntemleri

  • Konuyu başlatan Konuyu başlatan Agora Metin2
  • Başlangıç tarihi Başlangıç tarihi
  • Cevaplar Cevaplar 0
  • Görüntüleme Görüntüleme 13
image3b57beb29d949ebf.jpg


Hızlı Çözüm

Bir dosyanın sistemde mevcut olup olmadığını anlamanın en kestirme yolu, standart kütüphanede bulunan os.path.isfile() fonksiyonunu kullanmaktır. Eğer belirtilen yol gerçek bir dosyaya çıkıyorsa True, aksi takdirde False değerini alır. Belirtilen yol bulunamadığında herhangi bir hata üretmez.

Python:
import os

# Örneğin bulacak bir şeyi olsun diye bir dosya oluştur.
with open("notes.txt", "w") as f:
    f.write("hello\n")

print(os.path.isfile("notes.txt"))    # True
print(os.path.isfile("missing.txt"))  # False

C:\Users\Ada\notes.txt veya /home/ada/notes.txt gibi tam (mutlak) bir yol belirtmediğiniz sürece, Python yolları programın o an çalıştığı dizini (current working directory) referans alarak değerlendirir.

Aşağıda bu işlemin farklı yöntemleri, aralarındaki temel farklar ve bazı durumlarda neden kontrol yapmamanız gerektiği detaylandırılmıştır.

os.path.exists, isfile ve isdir Fonksiyonları

os.path modülü, farklı ihtiyaçlara cevap veren üç benzer kontrol mekanizması sunar:

FonksiyonŞu durumda True döner
os.path.exists(p)var olan herhangi bir şey: bir dosya, bir dizin ya da çalışan bir sembolik bağlantı
os.path.isfile(p)var olan normal bir dosya
os.path.isdir(p)var olan bir dizin

Bu fonksiyonlar arasındaki asıl fark, hedef yol bir dizin (klasör) olduğunda belirginleşir:

Python:
import os

os.makedirs("reports", exist_ok=True)
with open("reports/summary.txt", "w") as f:
    f.write("all good\n")

for path in ["reports", "reports/summary.txt", "reports/old.txt"]:
    print(path, os.path.exists(path), os.path.isfile(path), os.path.isdir(path))

Kodu çalıştırdığınızda elde edeceğiniz sonuç:

Kod:
reports True False True
reports/summary.txt True True False
reports/old.txt False False False

Örneğin reports bir klasör olsa bile os.path.exists("reports") ifadesi True döner. Ancak niyetiniz bu yolu bir dosya gibi açıp okumaksa, exists kullanmak hatalıdır; çünkü kontrolü geçen bir klasör, open("reports") komutuyla açılmaya çalışıldığında hata verecektir (Windows'ta PermissionError, Linux ve macOS'ta IsADirectoryError). Bu nedenle, hedefiniz dosyaysa isfile, klasörse isdir kullanmalısınız.

os.path fonksiyonları hakkında bilinmesi gereken iki önemli nokta:

• Sembolik bağlantılar (symlinks) takip edilir. Gerçek bir dosyayı işaret eden bağlantılar dosya olarak kabul edilirken, hedefi silinmiş bozuk bağlantılar tüm kontrollerden False alır.
• Python'un ilgili klasöre erişim yetkisi yoksa, sistem PermissionError fırlatmak yerine False döndürür. Dolayısıyla False cevabı, dosyanın kesinlikle yok olduğu anlamına gelmez; "erişilemedi veya bulunamadı" anlamına gelir.

pathlib Modülü ile Kontrol

Güncel Python projelerinde, nesne yönelimli bir yaklaşım sunan pathlib API'si daha sık tercih edilmektedir. Path nesneleri üzerinden benzer kontrolleri metodlar aracılığıyla yapabilirsiniz:

Python:
from pathlib import Path

folder = Path("reports")
folder.mkdir(exist_ok=True)

summary = folder / "summary.txt"
summary.write_text("all good\n")

print(summary.exists())    # True
print(summary.is_file())   # True
print(summary.is_dir())    # False
print(folder.is_dir())     # True
print((folder / "old.txt").exists())  # False

Path.exists(), Path.is_file() ve Path.is_dir() metodları, os.path fonksiyonlarıyla aynı mantıkla çalışır. Ayrıca / operatörü sayesinde yol parçalarını işletim sisteminden bağımsız şekilde birleştirebilirsiniz; böylece folder / "summary.txt" kullanımı tüm platformlarda sorunsuz çalışır.

Hangi kütüphaneyi seçmelisiniz? Eğer projenizin genelinde Path nesnelerini kullanıyorsanız pathlib ile devam edin. Ancak standart string ifadeler ve os modülüyle çalışıyorsanız os.path.isfile kullanımı da tamamen doğrudur. Her iki yöntem de aynı sonuçları üretir.

Önce Kontrol Etmenin Riskleri ve Yarış Durumu

Dosya kontrolü yapmanın temel amacı genellikle hemen ardından o dosyayı açmaktır:

Python:
import os

if os.path.isfile("config.txt"):
    with open("config.txt") as f:      # dosya bu arada silinmiş olabilir
        settings = f.read()
else:
    settings = ""

Ancak burada teknik bir risk vardır. isfile() ile open() işlemleri arasındaki o çok kısa sürede, başka bir kullanıcı, bir program veya farklı bir thread dosyayı silebilir ya da ismini değiştirebilir. Bu durumda kontrol True dönse bile, açma işlemi başarısız olur ve programınız FileNotFoundError ile çöker. Bu duruma "yarış durumu" (race condition) veya "kontrol zamanı ile kullanım zamanı arasındaki fark" (time of check to time of use) denir. Bu sorun kişisel bilgisayarlarda nadir olsa da, birçok sürecin aynı dizini kullandığı sunucularda sıkça yaşanır.

En sağlıklı çözüm, ön kontrolü atlayıp işlemi doğrudan open() fonksiyonuna bırakmak ve olası hataları except bloğunda karşılamaktır:

Python:
def read_settings(path):
    try:
        with open(path) as f:
            return f.read().strip()
    except FileNotFoundError:
        return "(no settings file, using defaults)"

with open("config.txt", "w") as f:
    f.write("theme=dark\n")

print(read_settings("config.txt"))
print(read_settings("other.txt"))

Kodu çalıştırdığınızda sonuç:

Kod:
theme=dark
(no settings file, using defaults)

Bu yaklaşımla iki ayrı işlem tek bir işleme iner ve yarış durumu ortadan kalkar. Python topluluğunda bu yöntem EAFP ("easier to ask forgiveness than permission" - izin istemektense af dilemek daha kolaydır) olarak adlandırılır. Bunun zıttı olan "önce kontrol et" yaklaşımı ise LBYL ("look before you leap" - atlamadan önce bak) olarak bilinir. Dosya işlemlerinde EAFP'nin tercih edilme nedeni, dosyanın durumunu kesin olarak yalnızca işletim sisteminin bilebilmesidir.

Yalnızca FileNotFoundError değil, IsADirectoryError (Windows'ta PermissionError) veya yetki sorunları nedeniyle PermissionError da alınabilir. Bu hataların tamamı OSError sınıfının alt dallarıdır. Bu yüzden except OSError: kullanarak tüm "açılamadı" senaryolarını tek seferde yakalayabilirsiniz.

Sadece Kontrol Yapmanın Doğru Olduğu Durumlar

Ön kontrol yapmak her zaman hatalı değildir. Eğer amacınız sadece bir bilgi edinmekse ve hemen ardından dosya üzerinde bir işlem gerçekleştirmeyecekseniz bu yöntem doğrudur:

• Kullanıcıya bilgi mesajı göstermek ("3 adet kayıtlı dosya bulundu" gibi)
• Uzun sürecek bir işlemden önce kullanıcının girdiği yolun geçerliliğini doğrulamak
• Daha önce tamamlanmış bir işlemi tekrar etmemek için kontrol yapmak

Özetle: Bir dosyayı açacaksanız, okuyacaksanız, yazacaksanız veya silecekseniz bunu try bloğu içinde yapın. Sadece dosyanın orada olup olmadığını bilmek istiyorsanız isfile() veya Path.is_file() yeterlidir.

Dosyayı Sadece Yoksa Oluşturmak

Bazen "dosyayı oluştur ama eğer zaten varsa üzerine yazma" ihtiyacı doğar. Bunu klasik kontrol yöntemiyle yapmak yine aynı yarış durumunu yaratır:

Python:
if not os.path.exists("report.txt"):
    with open("report.txt", "w") as f:   # başka bir süreç dosyayı önce oluşturabilir
        f.write("new report\n")

Bunun yerine "x" (exclusive creation) modu kullanılabilir. Bu mod, kontrol ve oluşturma işlemini tek adımda gerçekleştirir. Dosya zaten mevcutsa FileExistsError fırlatır:

Python:
import os

if os.path.exists("report.txt"):
    os.remove("report.txt")   # demo için temiz bir klasörle başla

for attempt in [1, 2]:
    try:
        with open("report.txt", "x") as f:
            f.write("first version\n")
        print(f"attempt {attempt}: created report.txt")
    except FileExistsError:
        print(f"attempt {attempt}: report.txt already exists, left it alone")

Kodu çalıştırdığınızda sonuç:

Kod:
attempt 1: created report.txt
attempt 2: report.txt already exists, left it alone

Klasör oluşturma işlemleri için ise os.makedirs(path, exist_ok=True) veya Path(path).mkdir(parents=True, exist_ok=True) kullanılabilir. Bu komutlar, dizin zaten mevcutsa hata vermez ve eksik üst dizinleri de otomatik olarak oluşturur; dolayısıyla öncesinde isdir() kontrolü yapmaya gerek kalmaz.

Sık Yapılan Hatalar

• Dosya kontrolü için exists() kullanmak: Bu yöntem, aynı isimli bir klasör olduğunda da True döner. Bunun yerine isfile() veya Path.is_file() tercih edilmelidir.
• Göreli yolların başlangıç noktasını karıştırmak: "data.txt" gibi bir yol, programın çalıştırıldığı dizinde aranır; bu her zaman betiğin bulunduğu klasör olmayabilir. Betiğin yanındaki bir dosyaya erişmek için yolu Path(__file__).parent üzerinden tanımlayın.
• Açma işleminden önce kontrol yapmak: Dosya bu iki işlem arasında değişebilir. Doğrudan try bloğunda açıp FileNotFoundError hatasını yönetin.
• Çok geniş kapsamlı hata yakalama: open() işlemini except Exception: ile çevrelemek, koddaki yazım hatalarını veya mantık bug'larını da gizleyebilir. Sadece FileNotFoundError veya OSError gibi spesifik hataları yakalayın.
 

Şu an konuyu görüntüleyenler (Toplam : 0, Üye: 0, Misafir: 0)

Geri
Üst