There is very little difference between the two types. In fact, even the core Python developers agreed that there is no real difference and removed IOError
in Python 3 (it is now an alias for OSError
). See PEP 3151 - Reworking the OS and IO exception hierarchy:
While some of these distinctions can be explained by implementation considerations, they are often not very logical at a higher level. The line separating OSError
and IOError
, for example, is often blurry. Consider the following:
>>> os.remove("fff")
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
OSError: [Errno 2] No such file or directory: 'fff'
>>> open("fff")
Traceback (most recent call last):
File "<stdin>", line 1, in <module>
IOError: [Errno 2] No such file or directory: 'fff'
Yes, that's two different exception types with the exact same error message.
For your own code, stick to throwing OSError
. For existing functions, check the documentation (it should detail what you need to catch), but you can safely catch both:
try:
# ...
except (IOError, OSError):
# handle error
Quoting the PEP again:
In fact, it is hard to think of any situation where OSError
should be caught but not IOError
, or the reverse.
EnvironmentError
,IOError
,WindowsError
,VMSError
,socket.error
,select.error
andmmap.error
have been merged intoOSError
. E.g. just throwOSError
and forget aboutIOError
.shutil.copyfile()
oros.access()
would raise IOError or OSError (always have to look it up)