module documentation
distutils.errors Provides exceptions used by the Distutils modules. Note that Distutils modules may raise standard exceptions; in particular, SystemExit is usually raised for errors that are obviously the end-user's fault (eg. bad command-line arguments). This module is safe to use in "from ... import *" mode; it only exports symbols whose names start with "Distutils" and end with "Error".
Exception |
|
Some compile/link operation failed. |
Exception |
|
Failure to compile one or more C/C++ source files. |
Exception |
|
Raised by fancy_getopt in response to getopt.error -- ie. an error in the command line usage. |
Exception |
|
Byte compile error. |
Exception |
|
Some command class (or possibly distribution class, if anyone feels a need to subclass Distribution) is found not to be holding up its end of the bargain, ie. implementing some part of the "command "interface. |
Exception |
|
The root of all Distutils evil. |
Exception |
|
Any problems executing an external program (such as the C compiler, when compiling C files). |
Exception |
|
Any problems in the filesystem: expected file not found, etc. Typically this is for problems that we detect before OSError could be raised. |
Exception |
|
The option table provided to 'fancy_getopt()' is bogus. |
Exception |
|
Internal inconsistencies or impossibilities (obviously, this should never be seen if the code is working!). |
Exception |
|
Unable to load an expected module, or to find an expected class within some module (in particular, command modules and classes). |
Exception |
|
Syntactic/semantic errors in command options, such as use of mutually conflicting options, or inconsistent options, badly-spelled values, etc. No distinction is made between option values originating in the setup script, the command line, config files, or what-have-you -- but if we *know* something originated in the setup script, we'll raise DistutilsSetupError instead. |
Exception |
|
We don't know how to do something on the current platform (but we do know how to do it on some platform) -- eg. trying to compile C files on a platform not supported by a CCompiler subclass. |
Exception |
|
For errors that can be definitely blamed on the setup script, such as invalid keyword arguments to 'setup()'. |
Exception |
|
Syntax error in a file list template. |
Exception |
|
Failure to create a static library from one or more C/C++ object files. |
Exception |
|
Failure to link one or more C/C++ object files into an executable or shared library file. |
Exception |
|
Failure to preprocess one or more C/C++ files. |
Exception |
|
Attempt to process an unknown file type. |