diff options
| author | Brett Cannon <brett@python.org> | 2013-06-12 20:59:46 (GMT) |
|---|---|---|
| committer | Brett Cannon <brett@python.org> | 2013-06-12 20:59:46 (GMT) |
| commit | b1611e2772af2c6eb73a6b3d04b3dbb43308fa6c (patch) | |
| tree | 7cd26cc5f09f341a69572c40f16638053ae86d08 /Doc/library/exceptions.rst | |
| parent | 638ce0779b4dceea39c2f77346aeab9824e48548 (diff) | |
| download | cpython-b1611e2772af2c6eb73a6b3d04b3dbb43308fa6c.zip cpython-b1611e2772af2c6eb73a6b3d04b3dbb43308fa6c.tar.gz cpython-b1611e2772af2c6eb73a6b3d04b3dbb43308fa6c.tar.bz2 | |
Issue #15767: Introduce ModuleNotFoundError, a subclass of
ImportError.
The exception is raised by import when a module could not be found.
Technically this is defined as no viable loader could be found for the
specified module. This includes ``from ... import`` statements so that
the module usage is consistent for all situations where import
couldn't find what was requested.
This should allow for the common idiom of::
try:
import something
except ImportError:
pass
to be updated to using ModuleNotFoundError and not accidentally mask
ImportError messages that should propagate (e.g. issues with a
loader).
This work was driven by the fact that the ``from ... import``
statement needed to be able to tell the difference between an
ImportError that simply couldn't find a module (and thus silence the
exception so that ceval can raise it) and an ImportError that
represented an actual problem.
Diffstat (limited to 'Doc/library/exceptions.rst')
| -rw-r--r-- | Doc/library/exceptions.rst | 13 |
1 files changed, 11 insertions, 2 deletions
diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst index ece035d..933667c 100644 --- a/Doc/library/exceptions.rst +++ b/Doc/library/exceptions.rst @@ -169,8 +169,8 @@ The following exceptions are the exceptions that are usually raised. .. exception:: ImportError - Raised when an :keyword:`import` statement fails to find the module definition - or when a ``from ... import`` fails to find a name that is to be imported. + Raised when the :keyword:`import` statement has troubles trying to load a + module. The :attr:`name` and :attr:`path` attributes can be set using keyword-only arguments to the constructor. When set they represent the name of the module @@ -180,6 +180,15 @@ The following exceptions are the exceptions that are usually raised. .. versionchanged:: 3.3 Added the :attr:`name` and :attr:`path` attributes. +.. exception:: ModuleNotFoundError + + A subclass of :exc:`ImportError` which is raised by :keyword:`import` when a + module could not be located. This includes ``from ... import`` statements as + the specific attribute being requested cannot be known a priori to be a module + or some other type of object. + + .. versionadded:: 3.4 + .. exception:: IndexError |