Gömülü İstisnalar

Python’da tüm istisnalar(exceptions) BaseException sınıfından türeyen bir sınıfın örnekleri olmalıdır. Belirli bir sınıftan bahseden except cümlesine sahip bir try deyiminde, bu cümle aynı zamanda o sınıftan türetilen istisna sınıflarını da ele alır (ancak onun türetildiği istisna sınıflarını değil). Alt sınıflandırma yoluyla ilişkili olmayan iki istisna sınıfı, aynı ada sahip olsalar bile asla eşdeğer değildir.

The built-in exceptions listed in this chapter can be generated by the interpreter or built-in functions. Except where mentioned, they have an “associated value” indicating the detailed cause of the error. This may be a string or a tuple of several items of information (e.g., an error code and a string explaining the code). The associated value is usually passed as arguments to the exception class’s constructor.

Kullanıcı kodu gömülü istisnaları oluşturabilir. Bu, bir istisna işleyicileri test etmek veya yorumlayıcının aynı istisnayı ortaya çıkardığı duruma “benzer” bir hata durumunu bildirmek için kullanılabilir; ancak kullanıcı kodunun uygun olmayan bir hata oluşturmasını engelleyecek hiçbir şey olmadığına dikkat edin.

Gömülü istisna sınıfları yeni istisnalar tanımlamak için alt sınıflara ayrılabilir; programcıların yeni istisnaları BaseException sınıfından değil, Exception sınıfından veya onun alt sınıflarından birinden türetmeleri önerilir. İstisnaların tanımlanmasıyla ilgili daha fazla bilgi Python Öğreticisi’nde Kullanıcı Tanımlı İstisnalar başlığı altında mevcuttur.

İstisna bağlamı

İstisna nesnelerindeki üç öznitelik, istisnanın ortaya çıktığı bağlam hakkında bilgi sağlar:

BaseException.__context__

BaseException.__cause__

BaseException.__suppress_context__

Başka bir istisna zaten işlenirken yeni bir istisna yükseltirken, yeni istisnanın __context__ niteliği otomatik olarak işlenen istisnaya ayarlanır. Bir except veya finally cümlesi veya bir with deyimi kullanıldığında bir istisna ele alınabilir.

Bu örtük istisna bağlamı(implicit exception context), from ile raise: kullanılarak açık bir neden ile desteklenebilir:

raise new_exc from original_exc

Bu from ifadesini takip eden ifade bir istisna veya None olmalıdır. Ortaya çıkan istisna üzerinde __cause__ olarak ayarlanacaktır. __cause__ ayarı aynı zamanda __suppress_context__ niteliğini de örtük(implicit) olarak True olarak ayarlar, böylece raise new_exc from None kullanımı görüntüleme amacıyla eski istisnayı yenisiyle değiştirirken (örneğin KeyError ifadesini AttributeError ifadesine dönüştürmek), hata ayıklama sırasında iç gözlem için eski istisnayı __context__ içinde kullanılabilir bırakır.

Varsayılan geri izleme görüntüleme kodu(default traceback display code), istisnanın geri izlemesine ek olarak bu zincirleme istisnaları da gösterir. __cause__ içinde açıkça zincirlenmiş bir istisna mevcut olduğunda her zaman gösterilir. __context__ içindeki dolaylı zincirleme istisna yalnızca __cause__ None ve __suppress_context__ false ise gösterilir.

Her iki durumda da, istisnanın kendisi her zaman zincirleme istisnalardan sonra gösterilir, böylece geri izlemenin(traceback) son satırı her zaman oluşturulan son istisnayı gösterir.

Gömülü istisnalardan miras alma

Kullanıcı kodu, bir istisna türünden miras alan alt sınıflar oluşturabilir. Tabanların args niteliğini işleme biçimleri arasındaki olası çakışmaların yanı sıra olası bellek düzeni uyumsuzluklarından kaçınmak için bir seferde yalnızca bir istisna türünün alt sınıfının oluşturulması önerilir.

CPython uygulama ayrıntısı: Çoğu gömülü istisna, verimlilik için C dilinde uygulanmıştır, bkz: Objects/exceptions.c. Bazılarının özel bellek düzenleri vardır, bu da birden fazla istisna türünden miras alan bir alt sınıf oluşturmayı imkansız kılar. Bir türün bellek düzeni bir uygulama detayıdır ve Python sürümleri arasında değişebilir, bu da gelecekte yeni çakışmalara yol açabilir. Bu nedenle, birden fazla istisna türünün alt sınıfını oluşturmaktan tamamen kaçınmanız önerilir.

Temel sınıflar

Aşağıdaki istisnalar çoğunlukla diğer istisnalar için temel sınıflar olarak kullanılır.

exception BaseException

Tüm gömülü istisnalar için temel sınıf. Kullanıcı tanımlı sınıflar tarafından doğrudan miras alınması amaçlanmamıştır (bunun için Exception kullanın). Bu sınıfın bir örneği üzerinde str() çağrılırsa, örneğin argüman(lar)ının gösterimi veya argüman yoksa boş dize döndürülür.

args

İstisna kurucusuna verilen argümanlar demeti. Bazı gömülü istisnalar (OSError gibi) belirli sayıda argüman bekler ve bu ikilinin elemanlarına özel bir anlam atarken, diğerleri genellikle yalnızca bir hata mesajı veren tek bir dizeyle çağrılır.

with_traceback(tb)

Bu yöntem tb öğesini istisna için yeni geri izleme olarak ayarlar ve istisna nesnesini döndürür. Daha çok PEP 3134 istisna zincirleme özellikleri kullanıma sunulmadan önce kullanılıyordu. Aşağıdaki örnek, bir SomeException örneğini geri izlemeyi koruyarak nasıl bir OtherException örneğine dönüştürebileceğimizi göstermektedir. Bir kez oluşturulduğunda, geçerli kare, orijinal SomeException ın geri izlemesinde olduğu gibi, OtherException ın geri izlemesine itilir, eğer arayan kişiye yayılmasına izin verseydik:

try:
    ...
except SomeException:
    tb = sys.exception().__traceback__
    raise OtherException(...).with_traceback(tb)

__traceback__

Bu istisna ile ilişkili traceback nesnesini tutan yazılabilir bir alan. Ayrıca bakınız: The raise statement.

add_note(note)

İstisna dizesinden sonra standart geri dönüşte görünen istisna notlarına note dizesini ekleyin. Eğer note bir string değilse bir TypeError oluşur.

Added in version 3.11.

__notes__

Bu istisnanın add_note() ile eklenen notlarının bir listesi. Bu nitelik add_note() çağrıldığında oluşturulur.

Added in version 3.11.

exception Exception

Tüm gömülü, sistemden çıkmayan istisnalar(non-system-exiting exceptions) bu sınıftan türetilir. Kullanıcı tanımlı tüm istisnalar da bu sınıftan türetilmelidir.

exception ArithmeticError

Çeşitli aritmetik hatalar için oluşturulan gömülü istisnalar için temel sınıf: OverflowError, ZeroDivisionError, FloatingPointError.

exception BufferError

Bu buffer ile ilgili bir işlem gerçekleştirilemediğinde oluşturulur.

exception LookupError

Bir eşleme veya dizide kullanılan bir anahtar veya dizin geçersiz olduğunda ortaya çıkan istisnalar için temel sınıf: IndexError, KeyError. Bu doğrudan codecs.lookup() tarafından oluşturulabilir.

Somut istisnalar (Concrete exceptions)

Aşağıdaki istisnalar genellikle ortaya çıkan istisnalardır.

exception AssertionError

Bir assert ifadesi başarısız(fail) olduğunda ortaya çıkar.

exception AttributeError

Bir öznitelik referansı (bkz. Attribute references) veya ataması başarısız olduğunda ortaya çıkar. (Bir nesne öznitelik referanslarını veya öznitelik atamalarını hiç desteklemiyorsa, TypeError yükseltilir)

name ve obj öznitelikleri, kurucuya(constructor) yalnızca anahtar kelime argümanları kullanılarak ayarlanabilir. Ayarlandıklarında, sırasıyla erişilmeye çalışılan özniteliğin adını ve söz konusu öznitelik için erişilen nesneyi temsil ederler.

3.10 sürümünde değişti: name ve obj nitelikleri eklendi.

exception EOFError

input() fonksiyonu herhangi bir veri okumadan dosya sonu koşuluna (end-of-file EOF) ulaştığında ortaya çıkar. (Not: io.IOBase.read() ve io.IOBase.readline() yöntemleri EOF’ye ulaştıklarında boş bir dize döndürürler)

exception FloatingPointError

Şu anda kullanılmıyor.

exception GeneratorExit

Bir generator veya coroutine kapatıldığında ortaya çıkar; bkz generator.close() ve coroutine.close(). Teknik olarak bir hata olmadığı için Exception yerine doğrudan BaseException dan miras alınır.

exception ImportError

Bir import deyimi bir modülü yüklemeye çalışırken sorun yaşadığında ortaya çıkar. Ayrıca from ... import içindeki “from list” bulunamayan bir isme sahip olduğunda da oluşur.

İsteğe bağlı name ve path anahtar sözcük, bağımsız değişkenleri ilgili öznitelikleri ayarlar:

name

İçe aktarılmaya çalışılan modülün adı.

path

İstisnayı tetikleyen herhangi bir dosyanın yolu.

3.3 sürümünde değişti: name ve path nitelikleri eklendi.

exception ModuleNotFoundError

Bir modül bulunamadığında import tarafından ortaya çıkarılan ImportError alt sınıfı. Ayrıca sys.modules içinde None bulunduğunda da ortaya çıkar.

Added in version 3.6.

exception IndexError

Bir dizi alt simgesi aralık dışında olduğunda yükseltilir. (Dilim indeksleri(slice indices) sessizce izin verilen aralığa düşecek şekilde kırpılır; bir indeks bir tamsayı değilse, TypeError oluşur.).

exception KeyError

Bir eşleme(mapping) sözlük(dictionary) anahtarı mevcut anahtarlar kümesinde bulunamadığında ortaya çıkar.

exception KeyboardInterrupt

Kullanıcı kesme(interrupt) tuşuna bastığında oluşur (normalde Control-C veya Delete). Yürütme sırasında düzenli olarak kesme kontrolü yapılır. İstisna, Exception kodunu yakalayan kod tarafından yanlışlıkla yakalanmamak ve böylece yorumlayıcının çıkmasını önlemek için BaseException kodundan miras alır.

Not

Bir KeyboardInterrupt yakalamak özel dikkat gerektirir. Tahmin edilemeyen noktalarda yükseltilebildiğinden, bazı durumlarda çalışan programı tutarsız bir durumda bırakabilir. Genellikle en iyisi KeyboardInterrupt ın programı mümkün olduğunca çabuk sonlandırmasına izin vermek veya tamamen yükseltilmesinden kaçınmaktır. (Bkz. Note on Signal Handlers and Exceptions.)

exception MemoryError

Bir işlemin belleği tükendiğinde ancak durum hala kurtarılabildiğinde (bazı nesneleri silerek) yükseltilir. İlişkili değer, ne tür bir (dahili) işlemin belleğinin tükendiğini gösteren bir dizedir. Altta yatan bellek yönetim mimarisi (C’nin malloc() fonksiyonu) nedeniyle, yorumlayıcının bu durumdan her zaman tamamen kurtulamayabileceğini unutmayın; yine de bir istisna yükseltir, böylece kaçan bir programın neden olması durumunda bir yığın geri dönüşü yazdırılabilir.

exception NameError

Yerel veya genel bir ad bulunamadığında oluşur. Bu yalnızca niteliksiz adlar için geçerlidir. İlişkili değer, bulunamayan adı içeren bir hata mesajıdır.

name özniteliği, yapıcıya yalnızca bir anahtar sözcük argümanı kullanılarak ayarlanabilir. Ayarlandığında, erişilmeye çalışılan değişkenin adını temsil eder.

3.10 sürümünde değişti: name niteliği eklendi.

exception NotImplementedError

Bu istisna RuntimeError’dan türetilmiştir. Kullanıcı tanımlı temel sınıflarda, soyut yöntemler, türetilmiş sınıfların yöntemi geçersiz kılmasını gerektirdiğinde veya sınıf geliştirilirken gerçek uygulamanın hala eklenmesi gerektiğini belirtmek için bu istisnayı yükseltmelidir.

Not

Bu, bir operatörün veya yöntemin hiç desteklenmemesi gerektiğini belirtmek için kullanılmamalıdır - bu durumda, ya operatörü / yöntemi tanımlanmamış bırakın ya da bir alt sınıfsa None. olarak ayarlayın.

Not

NotImplementedError and NotImplemented are not interchangeable, even though they have similar names and purposes. See NotImplemented for details on when to use it.

exception OSError([arg])

exception OSError(errno, strerror[, filename[, winerror[, filename2]]])

Bu istisna, bir sistem işlevi “dosya bulunamadı” veya “disk dolu” gibi G/Ç hataları da dahil olmak üzere sistemle ilgili bir hata döndürdüğünde ortaya çıkar (illegal argüman bağımsız değişken türleri veya diğer tesadüfi hatalar için değil).

Kurucunun(constructor) ikinci formu, aşağıda açıklanan ilgili nitelikleri ayarlar. Öznitelikler belirtilmezse varsayılan olarak None olur. Geriye dönük uyumluluk için, üç argüman geçilirse, args niteliği yalnızca ilk iki kurucu argümanının 2’li bir çiftini(tuple) içerir.

Kurucu genellikle aşağıda OS istisnaları bölümünde açıklandığı gibi OSError alt sınıfını döndürür. Belirli alt sınıf son errno değerine bağlıdır. Bu davranış yalnızca OSError doğrudan veya bir takma ad aracılığıyla oluşturulurken ortaya çıkar ve alt sınıf oluşturulurken miras alınmaz.

errno

C değişkeni errno dan alınan sayısal bir hata kodu.

winerror

Windows altında, bu size yerel Windows hata kodunu verir. O halde errno niteliği bu yerel hata kodunun POSIX terimleriyle yaklaşık bir çevirisidir.

Windows altında, winerror kurucu bağımsız değişkeni bir tamsayı ise, errno özniteliği Windows hata kodundan belirlenir ve errno bağımsız değişkeni yok sayılır. Diğer platformlarda, winerror argümanı yok sayılır ve winerror niteliği mevcut değildir.

strerror

İşletim sistemi tarafından sağlanan ilgili hata mesajı. POSIX altında perror() ve Windows altında FormatMessage() C işlevleri tarafından biçimlendirilir.

filename

filename2

Bir dosya sistemi yolu içeren istisnalar için (örneğin open() veya os.unlink()), filename fonksiyona aktarılan dosya adıdır. İki dosya sistemi yolu içeren fonksiyonlar için (os.rename() gibi), filename2 fonksiyona aktarılan ikinci dosya adına karşılık gelir.

3.3 sürümünde değişti: EnvironmentError, IOError, WindowsError, socket.error, select.error ve mmap.error, OSError ile birleştirilmiştir ve kurucu bir alt sınıf döndürebilir.

3.4 sürümünde değişti: filename özniteliği artık filesystem encoding and error handler ile kodlanan veya kodu çözülen ad yerine işleve aktarılan orijinal dosya adıdır. Ayrıca, filename2 kurucu argümanı ve niteliği eklenmiştir.

exception OverflowError

Raised when the result of an arithmetic operation is too large to be represented. This cannot occur for integers (which would rather raise MemoryError than give up). However, for historical reasons, OverflowError is sometimes raised for integers that are outside a required range. Because of the lack of standardization of floating-point exception handling in C, most floating-point operations are not checked.

exception RecursionError

Bu istisna RuntimeError öğesinden türetilmiştir. Yorumlayıcı maksimum özyineleme derinliğinin(recursion depth) (bkz. sys.getrecursionlimit()) aşıldığını tespit ettiğinde ortaya çıkar.

Added in version 3.5: Önceden, düz bir RuntimeError oluşturulurdu.

exception ReferenceError

Bu istisna, weakref.proxy() fonksiyonu tarafından oluşturulan bir zayıf referans proxy’si(weak reference proxy), çöp toplandıktan(garbage collect) sonra referansın bir niteliğine erişmek için kullanıldığında ortaya çıkar. Zayıf referanslar hakkında daha fazla bilgi için weakref modülüne bakın.

exception RuntimeError

Diğer kategorilerden herhangi birine girmeyen bir hata tespit edildiğinde oluşturulur. İlişkili değer, tam olarak neyin yanlış gittiğini gösteren bir dizedir.

exception StopIteration

Yerleşik işlev next() ve bir iterator ün __next__() yöntemi tarafından yineleyici tarafından üretilen başka öğe olmadığını bildirmek için yükseltilir.

value

İstisna nesnesinin tek bir value özelliği vardır; bu özellik istisna oluşturulurken argüman olarak verilir ve varsayılan olarak None değerini alır.

Bir generator veya coroutine fonksiyonu döndüğünde, yeni bir StopIteration örneği oluşturulur ve fonksiyon tarafından döndürülen değer, istisnanın yapıcısı için value parametresi olarak kullanılır.

Bir generator(işleyici) kodu doğrudan veya dolaylı olarak StopIteration değerini oluşturunca, RuntimeError değerine dönüştürülür (yeni istisnanın nedeni olarak StopIteration değeri korunur).

3.3 sürümünde değişti: value niteliği ve generator işlevlerin bir değer döndürmek için bunu kullanabilmesi özelliği eklendi.

3.5 sürümünde değişti: RuntimeError dönüşümü from __future__ import generator_stop aracılığıyla tanıtıldı, bkz PEP 479.

3.7 sürümünde değişti: Varsayılan olarak tüm kodlar için PEP 479 özelliğini etkinleştirin: bir generator’da ortaya çıkan StopIteration hatası bir RuntimeError hatasına dönüştürülür.

exception StopAsyncIteration

Yinelemeyi durdurmak için bir asynchronous iterator nesnesinin __anext__() yöntemi tarafından oluşturulmalıdır.

Added in version 3.5.

exception SyntaxError(message, details)

Ayrıştırıcı bir sözdizimi hatasıyla karşılaştığında ortaya çıkar. Bu, bir import deyiminde, yerleşik compile(), exec() veya eval() işlevlerine yapılan bir çağrıda veya ilk kod veya standart girdi okunurken (etkileşimli olarak da) meydana gelebilir.

İstisna örneğinin str() öğesi yalnızca hata mesajını döndürür. Details, üyeleri ayrı nitelikler olarak da kullanılabilen bir tuple’dır.

filename

Sözdizimi hatasının oluştuğu dosyanın adı.

lineno

Hatanın dosyadaki hangi satır numarasında meydana geldiği. Bu 1 indekslidir: dosyadaki ilk satırın lineno değeri 1’dir.

offset

Hatanın meydana geldiği satırdaki sütun. Bu 1 indekslidir: satırdaki ilk karakter 1 offset değerine sahiptir.

text

Hataya dahil olan kaynak kod metni.

end_lineno

Hatanın meydana geldiği dosyadaki satır numarası. Bu, 1 indekslidir: Dosyanın ilk satırının lineno değeri 1’dir.

end_offset

Hatanın meydana geldiği son satırdaki sütun numarası. Bu, 1 indekslidir: Satırdaki ilk karakterin offset değeri 1’dir.

f-string alanlarındaki hatalar için mesajın önüne “f-string: “ ile başlar ve ofsetler, değiştirme ifadesinden oluşturulan bir metindeki ofsetlerdir. Örneğin, f’Bad {a b} field’ derlendiğinde şu args özniteliği elde edilir: (‘f-string: …’, (‘’, 1, 2, ‘(a b)n’, 1, 5)).

3.10 sürümünde değişti: end_lineno ve end_offset nitelikleri eklendi.

exception IndentationError

Yanlış girintileme ile ilgili sözdizimi hataları için temel sınıf. Bu, SyntaxError alt sınıfıdır.

exception TabError

Girintileme tutarsız sekme ve boşluk kullanımı içerdiğinde ortaya çıkar. Bu, IndentationError öğesinin bir alt sınıfıdır.

exception SystemError

Yorumlayıcı dahili bir hata bulduğunda, ancak durum tüm umutlarını yitirmesine neden olacak kadar ciddi görünmediğinde yükseltilir. İlişkili değer, neyin yanlış gittiğini gösteren bir dizedir (düşük seviye terimlerle).

Bunu Python yorumlayıcınızın yazarına veya geliştiricisine bildirmelisiniz. Python yorumlayıcısının sürümünü (sys.version; etkileşimli bir Python oturumunun başlangıcında da yazdırılır), tam hata mesajını (istisnanın ilişkili değeri) ve mümkünse hatayı tetikleyen programın kaynağını bildirdiğinizden emin olun.

exception SystemExit

Bu istisna sys.exit() işlevi tarafından ortaya çıkartılır. Yanlışlıkla Exception kodunu yakalayan kod tarafından yakalanmaması için Exception yerine BaseException kodundan miras alır. Bu, istisnanın düzgün bir şekilde yayılmasını ve yorumlayıcının çıkmasına neden olmasını sağlar. İşlenmediğinde, Python yorumlayıcısı çıkar; herhangi bir yığın geri dönüşü yazdırılmaz. Kurucu, sys.exit() öğesine aktarılan isteğe bağlı argümanın aynısını kabul eder. Değer bir tamsayı ise, sistem çıkış durumunu belirtir (C’nin exit() fonksiyonuna aktarılır); None ise, çıkış durumu sıfırdır; başka bir türe sahipse (string gibi), nesnenin değeri yazdırılır ve çıkış durumu birdir.

Bir sys.exit() çağrısı bir istisnaya çevrilir, böylece temizleme işleyicileri(clean-up handlers) (try deyimlerinin finally cümleleri) çalıştırılabilir ve böylece bir hata ayıklayıcı kontrolü kaybetme riski olmadan bir betiği çalıştırabilir. Hemen çıkmak kesinlikle gerekliyse os._exit() fonksiyonu kullanılabilir (örneğin, os.fork() çağrısından sonra alt süreçte).

code

Yapıcıya aktarılan çıkış durumu veya hata mesajı. (Varsayılan değer None.)

exception TypeError

Bir işlem veya fonksiyon uygun olmayan türdeki bir nesneye uygulandığında oluşur. İlişkili değer, tür uyuşmazlığı hakkında ayrıntılar veren bir dizedir.

Bu istisna, bir nesne üzerinde denenen bir işlemin desteklenmediğini ve desteklenmesinin amaçlanmadığını belirtmek için kullanıcı kodu tarafından oluşur. Bir nesnenin belirli bir işlemi desteklemesi gerekiyorsa ancak henüz bir uygulama sağlamamışsa, NotImplementedError oluşması gereken uygun istisnadır.

Yanlış türde argümanlar geçirmek (örneğin bir int beklenirken bir list geçirmek) bir TypeError ile sonuçlanmalıdır, ancak yanlış değere sahip argümanlar geçirmek (örneğin beklenen sınırların dışında bir sayı) bir ValueError ile sonuçlanmalıdır.

exception UnboundLocalError

Bir işlev veya yöntemde yerel(local) bir değişkene referans yapıldığında, ancak bu değişkene herhangi bir değer bağlanmadığında ortaya çıkar. Bu, NameError alt sınıfıdır.

exception UnicodeError

Unicode ile ilgili bir kodlama veya kod çözme hatası oluştuğunda ortaya çıkar. Bu, ValueError alt sınıfıdır.

UnicodeError kodlama(encoding) veya kod çözme(decoding) hatasını tanımlayan özniteliklere sahiptir. Örneğin, err.object[err.start:err.end] codec’in başarısız olduğu belirli geçersiz girdiyi verir.

encoding

Hataya neden olan kodlamanın adı.

reason

Belirli kodek hatasını açıklayan bir dize.

object

Kodek’in kodlamaya veya kodunu çözmeye çalıştığı nesne.

start

object içindeki geçersiz verilerin ilk indeksi.

end

object içindeki son geçersiz veriden sonraki dizin.

exception UnicodeEncodeError

Kodlama sırasında Unicode ile ilgili bir hata oluştuğunda ortaya çıkar. Bu UnicodeError alt sınıfıdır.

exception UnicodeDecodeError

Kod çözme sırasında Unicode ile ilgili bir hata oluştuğunda ortaya çıkar. Bu UnicodeError alt sınıfıdır.

exception UnicodeTranslateError

Çeviri sırasında Unicode ile ilgili bir hata oluştuğunda ortaya çıkar. Bu UnicodeError alt sınıfıdır.

exception ValueError

Bir işlem veya fonksiyon doğru türde ancak uygun olmayan bir değere sahip bir argüman aldığında ve durum IndexError gibi daha kesin bir istisna ile tanımlanmadığında ortaya çıkar.

exception ZeroDivisionError

Bir bölme veya modulo işleminin ikinci bağımsız değişkeni sıfır olduğunda ortaya çıkar. İlişkili değer, işlenenlerin ve işlemin türünü belirten bir dizedir.

Aşağıdaki istisnalar önceki sürümlerle uyumluluk için tutulur; Python 3.3’ten başlayarak, OSError takma adlarıdır.

exception EnvironmentError

exception IOError

exception WindowsError

Yalnızca Windows’ta kullanılabilir.

İşletim sistemi istisnaları(ES exceptions)

Aşağıdaki istisnalar OSError alt sınıflarıdır, sistem hata koduna bağlı olarak ortaya çıkarlar.

exception BlockingIOError

Bir işlem, bloklanmayan işlem(non-blocking operation) için ayarlanmış bir nesne (örn. soket) üzerinde bloklandığında ortaya çıkar. errno EAGAIN, EALREADY, EWOULDBLOCK ve EINPROGRESS değerlerine karşılık gelir.

OSError özelliğine ek olarak, BlockingIOError bir özelliğe daha sahip olabilir:

characters_written

“Bu öznitelik, io modülünden gelen arabellekli I/O sınıflarını kullanırken, akışa yazılmadan önce engellendiğinde yazılan karakterlerin sayısını içeren bir tamsayı içerir.”

exception ChildProcessError

Bir alt süreç(child process) üzerindeki bir işlem başarısız olduğunda yükseltilir. Karşılığı errno ECHILD.

exception ConnectionError

Bağlantı ile ilgili konular için bir temel sınıf.

Alt sınıflar BrokenPipeError, ConnectionAbortedError, ConnectionRefusedError ve ConnectionResetError.

exception BrokenPipeError

ConnectionError alt sınıfı, diğer ucu kapatılmış bir pipe’ın üzerine yazmaya çalışıldığında veya yazmaya kapatılmış bir soket üzerine yazmaya çalışıldığında ortaya çıkar. errno EPIPE ve ESHUTDOWN değerlerine karşılık gelir.

exception ConnectionAbortedError

Bir bağlantı girişimi eş(peer) tarafından iptal edildiğinde ortaya çıkan ConnectionError alt sınıfı. Karşılığı errno ECONNABORTED.

exception ConnectionRefusedError

Bir bağlantı girişimi eş(peer) tarafından reddedildiğinde ortaya çıkan ConnectionError alt sınıfı. Karşılığı errno ECONNREFUSED.

exception ConnectionResetError

Bir bağlantı eş(peer) tarafından sıfırlandığında ortaya çıkan ConnectionError alt sınıfı. Karşılığı errno ECONNRESET.

exception FileExistsError

Zaten var olan bir dosya veya dizin oluşturulmaya çalışıldığında ortaya çıkar. Karşılığı errno EEXIST.

exception FileNotFoundError

Bir dosya veya dizin isteğinde(request) ancak mevcut olmadığında ortaya çıakr. Karşılığı errno ENOENT.

exception InterruptedError

Bir sistem çağrısı gelen bir sinyal tarafından kesintiye uğradığında ortaya çıkar. Karşılığı errno EINTR.

3.5 sürümünde değişti: Python, bir sistem çağrısı bir sinyal tarafından kesildiğinde, artık sinyal işleyicisi bir istisna yükseltmediği sürece (PEP 475 için gerekçeye bakın), InterruptedError istisnası yükseltmek yerine sistem çağrılarını tekrar deniyor.

exception IsADirectoryError

Bir dizin üzerinde bir dosya işlemi (örneğin os.remove()) istendiğinde ortaya çıkar. Karşılığı errno EISDIR.

exception NotADirectoryError

Dizin olmayan bir şey üzerinde bir dizin işlemi (örneğin os.listdir()) istendiğinde ortaya çıakr. Çoğu POSIX platformunda, bir işlem dizin olmayan bir dosyayı bir dizinmiş gibi açmaya veya geçmeye çalışırsa da ortaya çıkabilir. Karşılığı errno ENOTDIR.

exception PermissionError

Yeterli erişim hakları (örneğin dosya sistemi izinleri) olmadan bir işlem çalıştırılmaya çalışıldığında ortaya çıkar. errno EACCES, EPERM ve ENOTCAPABLE değerlerine karşılık gelir.

3.11.1 sürümünde değişti: WASI’nin ENOTCAPABLE ifadesi artık PermissionError ile eşleştirilmiştir.

exception ProcessLookupError

Belirli bir süreç mevcut olmadığında ortaya çıkar. Karşılığı errno ESRCH.

exception TimeoutError

Bir sistem işlevi sistem düzeyinde zaman aşımına uğradığında ortaya çıkar. Karşılığı errno ETIMEDOUT.

Added in version 3.3: Yukarıdaki tüm OSError alt sınıfları eklendi.

Ayrıca bakınız

PEP 3151 - İşletim sistemi ve IO istisna hiyerarşisinin yeniden düzenlenmesi

Uyarılar

Aşağıdaki istisnalar uyarı kategorileri olarak kullanılır; daha fazla ayrıntı için Warning Categories belgesine bakın.

exception Warning

Uyarı kategorileri için temel sınıf.

exception UserWarning

Kullanıcı kodu tarafından oluşturulan uyarılar için temel sınıf.

exception DeprecationWarning

Kullanımdan kaldırılan özelliklerle ilgili uyarılar diğer Python geliştiricilerine yönelik olduğunda bu uyarılar için temel sınıf.

__main__ modülü (PEP 565) dışında varsayılan uyarı filtreleri tarafından yok sayılır. Python Geliştirme Modu etkinleştirildiğinde bu uyarı gösterilir.

Kullanımdan kaldırma politikası PEP 387 bölümünde açıklanmaktadır.

exception PendingDeprecationWarning

Eski olan ve gelecekte kullanımdan kaldırılması beklenen, ancak şu anda kullanımdan kaldırılmayan özelliklerle ilgili uyarılar için temel sınıf.

Bu sınıf nadiren kullanılır çünkü yaklaşan olası bir kullanımdan kaldırma hakkında bir uyarı yayınlamak alışılmadık bir durumdur ve DeprecationWarning zaten aktif olan kullanımdan kaldırmalar için tercih edilir.

Varsayılan uyarı filtreleri tarafından yok sayılır. Python Geliştirme Modu etkinleştirildiğinde bu uyarı gösterilir.

Kullanımdan kaldırma politikası PEP 387 bölümünde açıklanmaktadır.

exception SyntaxWarning

Şüpheli sözdizimiyle ilgili uyarılar için temel sınıf.

exception RuntimeWarning

Şüpheli çalışma zamanı davranışları hakkındaki uyarılar için temel sınıf.

exception FutureWarning

Kullanımdan kaldırılan özelliklerle ilgili uyarılar Python’da yazılmış uygulamaların son kullanıcılarına yönelik olduğunda bu uyarılar için temel sınıf.

exception ImportWarning

Modül içe aktarmalarındaki olası hatalar hakkında uyarılar için temel sınıf.

Varsayılan uyarı filtreleri tarafından yok sayılır. Python Geliştirme Modu etkinleştirildiğinde bu uyarı gösterilir.

exception UnicodeWarning

Unicode ile ilgili uyarılar için temel sınıf.

exception EncodingWarning

Kodlamalarla ilgili uyarılar için temel sınıf.

Ayrıntılar için Opt-in EncodingWarning sayfasına bakın.

Added in version 3.10.

exception BytesWarning

bytes ve bytearray ile ilgili uyarılar için temel sınıf.

exception ResourceWarning

Kaynak kullanımıyla ilgili uyarılar için temel sınıf.

Varsayılan uyarı filtreleri tarafından yok sayılır. Python Geliştirme Modu etkinleştirildiğinde bu uyarı gösterilir.

Added in version 3.2.

İstisna grupları

Aşağıdakiler, birden fazla ilgisiz istisnayı yükseltmek gerektiğinde kullanılır. Bunlar istisna hiyerarşisinin bir parçasıdır, bu nedenle diğer tüm istisnalar gibi except ile ele alınabilirler. Ayrıca, içerdikleri istisnaların türlerine göre alt gruplarını eşleştiren except* tarafından tanınırlar.

exception ExceptionGroup(msg, excs)

exception BaseExceptionGroup(msg, excs)

Bu istisna türlerinin her ikisi de istisnaları excs dizisine sarar. msg parametresi bir string olmalıdır. İki sınıf arasındaki fark, BaseExceptionGroup, BaseException’ı genişletir ve herhangi bir istisnayı sarabilirken, ExceptionGroup, Exception’ı genişletir ve yalnızca Exception’ın alt sınıflarını sarabilir. Bu tasarım sayesinde except Exception bir ExceptionGroup u yakalar ancak BaseExceptionGroup u yakalayamaz.

İçerdiği tüm istisnalar Exception örneğiyse, BaseExceptionGroup yapıcısı bir BaseExceptionGroup yerine bir ExceptionGroup döndürür, böylece seçimi otomatik hale getirmek için kullanılabilir. Öte yandan, ExceptionGroup kurucusu, içerdiği herhangi bir istisna bir Exception alt sınıfı değilse bir TypeError yükseltir.

message

Kurucunun msg argümanı. Bu salt okunur bir niteliktir.

exceptions

Yapıcıya verilen excs dizisindeki istisnaların bir demeti(tuple). Bu salt okunur bir özniteliktir.

subgroup(condition)

Yalnızca geçerli gruptaki condition ile eşleşen istisnaları içeren bir istisna grubu veya sonuç boşsa None döndürür.

Koşul, bir istisnayı kabul eden ve alt grupta olması gerekenler için true döndüren bir fonksiyon olabileceği gibi, bir except cümlesinde kullanılan kontrolün aynısını kullanarak bir eşleşme olup olmadığını kontrol etmek için kullanılan bir istisna türü veya istisna türleri demeti(tuple) de olabilir.

Mevcut istisna içindeki iç içe geçme yapısı sonuçta korunur, ayrıca message, __traceback__, __cause__, __context__ ve __notes__ alanlarının değerleri de korunur. Boş iç içe gruplar sonuçtan çıkarılır.

Koşul(condition), üst düzey ve iç içe geçmiş istisna grupları dahil olmak üzere, iç içe geçmiş istisna grubundaki tüm istisnalar için kontrol edilir. Koşul böyle bir istisna grubu için doğruysa, sonuca tam olarak dahil edilir.

split(condition)

subgroup() gibi, ancak (match, rest) çiftini döndürür; burada match subgroup(condition) ve rest kalan eşleşmeyen kısımdır.

derive(excs)

Aynı message ile bir istisna grubu döndürür, ancak istisnaları excs içine sarar.

This method is used by subgroup() and split(), which are used in various contexts to break up an exception group. A subclass needs to override it in order to make subgroup() and split() return instances of the subclass rather than ExceptionGroup.

subgroup() ve split(), __traceback__, __cause__, __context__ ve __notes__ alanlarını orijinal istisna grubundan derive() tarafından döndürülene kopyalar, böylece bu alanların derive() tarafından güncellenmesi gerekmez.

>>> class MyGroup(ExceptionGroup):
...     def derive(self, excs):
...         return MyGroup(self.message, excs)
...
>>> e = MyGroup("eg", [ValueError(1), TypeError(2)])
>>> e.add_note("a note")
>>> e.__context__ = Exception("context")
>>> e.__cause__ = Exception("cause")
>>> try:
...    raise e
... except Exception as e:
...    exc = e
...
>>> match, rest = exc.split(ValueError)
>>> exc, exc.__context__, exc.__cause__, exc.__notes__
(MyGroup('eg', [ValueError(1), TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])
>>> match, match.__context__, match.__cause__, match.__notes__
(MyGroup('eg', [ValueError(1)]), Exception('context'), Exception('cause'), ['a note'])
>>> rest, rest.__context__, rest.__cause__, rest.__notes__
(MyGroup('eg', [TypeError(2)]), Exception('context'), Exception('cause'), ['a note'])
>>> exc.__traceback__ is match.__traceback__ is rest.__traceback__
True

BaseExceptionGroup öğesinin __new__() öğesini tanımladığına dikkat edin, bu nedenle farklı bir kurucu imzasına ihtiyaç duyan alt sınıfların __init__() yerine bunu geçersiz kılmaları gerekir. Örneğin, aşağıda bir exit_code kabul eden ve grubun mesajını bundan oluşturan bir istisna grubu alt sınıfı tanımlanmaktadır:

class Errors(ExceptionGroup):
   def __new__(cls, errors, exit_code):
      self = super().__new__(Errors, f"exit code: {exit_code}", errors)
      self.exit_code = exit_code
      return self

   def derive(self, excs):
      return Errors(excs, self.exit_code)

Tıpkı ExceptionGroup gibi, BaseExceptionGroup alt sınıfı olan Exception alt sınıfı da yalnızca Exception örneklerini sarabilir.

Added in version 3.11.

İstisna hiyerarşisi

Gömülü istisnalar için sınıf hiyerarşisi şöyledir:

BaseException
 ├── BaseExceptionGroup
 ├── GeneratorExit
 ├── KeyboardInterrupt
 ├── SystemExit
 └── Exception
      ├── ArithmeticError
      │    ├── FloatingPointError
      │    ├── OverflowError
      │    └── ZeroDivisionError
      ├── AssertionError
      ├── AttributeError
      ├── BufferError
      ├── EOFError
      ├── ExceptionGroup [BaseExceptionGroup]
      ├── ImportError
      │    └── ModuleNotFoundError
      ├── LookupError
      │    ├── IndexError
      │    └── KeyError
      ├── MemoryError
      ├── NameError
      │    └── UnboundLocalError
      ├── OSError
      │    ├── BlockingIOError
      │    ├── ChildProcessError
      │    ├── ConnectionError
      │    │    ├── BrokenPipeError
      │    │    ├── ConnectionAbortedError
      │    │    ├── ConnectionRefusedError
      │    │    └── ConnectionResetError
      │    ├── FileExistsError
      │    ├── FileNotFoundError
      │    ├── InterruptedError
      │    ├── IsADirectoryError
      │    ├── NotADirectoryError
      │    ├── PermissionError
      │    ├── ProcessLookupError
      │    └── TimeoutError
      ├── ReferenceError
      ├── RuntimeError
      │    ├── NotImplementedError
      │    └── RecursionError
      ├── StopAsyncIteration
      ├── StopIteration
      ├── SyntaxError
      │    └── IndentationError
      │         └── TabError
      ├── SystemError
      ├── TypeError
      ├── ValueError
      │    └── UnicodeError
      │         ├── UnicodeDecodeError
      │         ├── UnicodeEncodeError
      │         └── UnicodeTranslateError
      └── Warning
           ├── BytesWarning
           ├── DeprecationWarning
           ├── EncodingWarning
           ├── FutureWarning
           ├── ImportWarning
           ├── PendingDeprecationWarning
           ├── ResourceWarning
           ├── RuntimeWarning
           ├── SyntaxWarning
           ├── UnicodeWarning
           └── UserWarning