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.