1999-03-22 10:52:19 -04:00
|
|
|
"""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 safe to use in "from ... import *" mode; it only exports
|
|
|
|
symbols whose names start with "Distutils" and end with "Error"."""
|
|
|
|
|
|
|
|
# created 1999/03/03, Greg Ward
|
|
|
|
|
2000-03-01 21:49:45 -04:00
|
|
|
__revision__ = "$Id$"
|
1999-03-22 10:52:19 -04:00
|
|
|
|
1999-07-09 23:01:44 -03:00
|
|
|
import types
|
1999-03-22 10:52:19 -04:00
|
|
|
|
1999-07-09 23:01:44 -03:00
|
|
|
if type (RuntimeError) is types.ClassType:
|
1999-03-22 10:52:19 -04:00
|
|
|
|
|
|
|
class DistutilsError (Exception):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""The root of all Distutils evil."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsModuleError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""Unable to load an expected module, or to find an expected class
|
|
|
|
within some module (in particular, command modules and classes)."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsClassError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""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."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsGetoptError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""The option table provided to 'fancy_getopt()' is bogus."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsArgError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""Raised by fancy_getopt in response to getopt.error -- ie. an
|
|
|
|
error in the command line usage."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsFileError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""Any problems in the filesystem: expected file not found, etc.
|
|
|
|
Typically this is for problems that we detect before IOError or
|
|
|
|
OSError could be raised."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
|
|
|
class DistutilsOptionError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""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."""
|
1999-03-22 10:52:19 -04:00
|
|
|
pass
|
|
|
|
|
2000-04-15 19:15:07 -03:00
|
|
|
class DistutilsSetupError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""For errors that can be definitely blamed on the setup script,
|
|
|
|
such as invalid keyword arguments to 'setup()'."""
|
1999-08-14 20:43:45 -03:00
|
|
|
pass
|
|
|
|
|
1999-07-09 23:01:44 -03:00
|
|
|
class DistutilsPlatformError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""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."""
|
1999-07-09 23:01:44 -03:00
|
|
|
pass
|
|
|
|
|
1999-08-14 20:43:45 -03:00
|
|
|
class DistutilsExecError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""Any problems executing an external program (such as the C
|
|
|
|
compiler, when compiling C files)."""
|
1999-08-14 20:43:45 -03:00
|
|
|
pass
|
|
|
|
|
2000-03-30 22:57:31 -04:00
|
|
|
class DistutilsInternalError (DistutilsError):
|
2000-04-15 19:23:47 -03:00
|
|
|
"""Internal inconsistencies or impossibilities (obviously, this
|
|
|
|
should never be seen if the code is working!)."""
|
2000-03-30 22:57:31 -04:00
|
|
|
pass
|
|
|
|
|
1999-03-22 10:52:19 -04:00
|
|
|
# String-based exceptions
|
|
|
|
else:
|
|
|
|
DistutilsError = 'DistutilsError'
|
|
|
|
DistutilsModuleError = 'DistutilsModuleError'
|
|
|
|
DistutilsClassError = 'DistutilsClassError'
|
|
|
|
DistutilsGetoptError = 'DistutilsGetoptError'
|
|
|
|
DistutilsArgError = 'DistutilsArgError'
|
|
|
|
DistutilsFileError = 'DistutilsFileError'
|
|
|
|
DistutilsOptionError = 'DistutilsOptionError'
|
1999-07-09 23:01:44 -03:00
|
|
|
DistutilsPlatformError = 'DistutilsPlatformError'
|
1999-08-14 20:43:45 -03:00
|
|
|
DistutilsExecError = 'DistutilsExecError'
|
2000-03-30 22:57:31 -04:00
|
|
|
DistutilsInternalError = 'DistutilsInternalError'
|
1999-08-14 20:43:45 -03:00
|
|
|
|
1999-07-09 23:01:44 -03:00
|
|
|
del types
|