| """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"."""
|
|
|
|
|
| class DistutilsError(Exception):
|
| """The root of all Distutils evil."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsModuleError(DistutilsError):
|
| """Unable to load an expected module, or to find an expected class
|
| within some module (in particular, command modules and classes)."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsClassError(DistutilsError):
|
| """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."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsGetoptError(DistutilsError):
|
| """The option table provided to 'fancy_getopt()' is bogus."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsArgError(DistutilsError):
|
| """Raised by fancy_getopt in response to getopt.error -- ie. an
|
| error in the command line usage."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsFileError(DistutilsError):
|
| """Any problems in the filesystem: expected file not found, etc.
|
| Typically this is for problems that we detect before OSError
|
| could be raised."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsOptionError(DistutilsError):
|
| """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."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsSetupError(DistutilsError):
|
| """For errors that can be definitely blamed on the setup script,
|
| such as invalid keyword arguments to 'setup()'."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsPlatformError(DistutilsError):
|
| """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."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsExecError(DistutilsError):
|
| """Any problems executing an external program (such as the C
|
| compiler, when compiling C files)."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsInternalError(DistutilsError):
|
| """Internal inconsistencies or impossibilities (obviously, this
|
| should never be seen if the code is working!)."""
|
|
|
| pass
|
|
|
|
|
| class DistutilsTemplateError(DistutilsError):
|
| """Syntax error in a file list template."""
|
|
|
|
|
| class DistutilsByteCompileError(DistutilsError):
|
| """Byte compile error."""
|
|
|
|
|
|
|
| class CCompilerError(Exception):
|
| """Some compile/link operation failed."""
|
|
|
|
|
| class PreprocessError(CCompilerError):
|
| """Failure to preprocess one or more C/C++ files."""
|
|
|
|
|
| class CompileError(CCompilerError):
|
| """Failure to compile one or more C/C++ source files."""
|
|
|
|
|
| class LibError(CCompilerError):
|
| """Failure to create a static library from one or more C/C++ object
|
| files."""
|
|
|
|
|
| class LinkError(CCompilerError):
|
| """Failure to link one or more C/C++ object files into an executable
|
| or shared library file."""
|
|
|
|
|
| class UnknownFileError(CCompilerError):
|
| """Attempt to process an unknown file type."""
|
|
|
