1 """distutils.errors
2
3 Provides exceptions used by the Distutils modules. Note that Distutils
4 modules may raise standard exceptions; in particular, SystemExit is
5 usually raised for errors that are obviously the end-user's fault
6 (eg. bad command-line arguments).
7
8 This module is safe to use in "from ... import *" mode; it only exports
9 symbols whose names start with "Distutils" and end with "Error"."""
10
11 class ESC[4;38;5;81mDistutilsError (ESC[4;38;5;149mException):
12 """The root of all Distutils evil."""
13 pass
14
15 class ESC[4;38;5;81mDistutilsModuleError (ESC[4;38;5;149mDistutilsError):
16 """Unable to load an expected module, or to find an expected class
17 within some module (in particular, command modules and classes)."""
18 pass
19
20 class ESC[4;38;5;81mDistutilsClassError (ESC[4;38;5;149mDistutilsError):
21 """Some command class (or possibly distribution class, if anyone
22 feels a need to subclass Distribution) is found not to be holding
23 up its end of the bargain, ie. implementing some part of the
24 "command "interface."""
25 pass
26
27 class ESC[4;38;5;81mDistutilsGetoptError (ESC[4;38;5;149mDistutilsError):
28 """The option table provided to 'fancy_getopt()' is bogus."""
29 pass
30
31 class ESC[4;38;5;81mDistutilsArgError (ESC[4;38;5;149mDistutilsError):
32 """Raised by fancy_getopt in response to getopt.error -- ie. an
33 error in the command line usage."""
34 pass
35
36 class ESC[4;38;5;81mDistutilsFileError (ESC[4;38;5;149mDistutilsError):
37 """Any problems in the filesystem: expected file not found, etc.
38 Typically this is for problems that we detect before OSError
39 could be raised."""
40 pass
41
42 class ESC[4;38;5;81mDistutilsOptionError (ESC[4;38;5;149mDistutilsError):
43 """Syntactic/semantic errors in command options, such as use of
44 mutually conflicting options, or inconsistent options,
45 badly-spelled values, etc. No distinction is made between option
46 values originating in the setup script, the command line, config
47 files, or what-have-you -- but if we *know* something originated in
48 the setup script, we'll raise DistutilsSetupError instead."""
49 pass
50
51 class ESC[4;38;5;81mDistutilsSetupError (ESC[4;38;5;149mDistutilsError):
52 """For errors that can be definitely blamed on the setup script,
53 such as invalid keyword arguments to 'setup()'."""
54 pass
55
56 class ESC[4;38;5;81mDistutilsPlatformError (ESC[4;38;5;149mDistutilsError):
57 """We don't know how to do something on the current platform (but
58 we do know how to do it on some platform) -- eg. trying to compile
59 C files on a platform not supported by a CCompiler subclass."""
60 pass
61
62 class ESC[4;38;5;81mDistutilsExecError (ESC[4;38;5;149mDistutilsError):
63 """Any problems executing an external program (such as the C
64 compiler, when compiling C files)."""
65 pass
66
67 class ESC[4;38;5;81mDistutilsInternalError (ESC[4;38;5;149mDistutilsError):
68 """Internal inconsistencies or impossibilities (obviously, this
69 should never be seen if the code is working!)."""
70 pass
71
72 class ESC[4;38;5;81mDistutilsTemplateError (ESC[4;38;5;149mDistutilsError):
73 """Syntax error in a file list template."""
74
75 class ESC[4;38;5;81mDistutilsByteCompileError(ESC[4;38;5;149mDistutilsError):
76 """Byte compile error."""
77
78 # Exception classes used by the CCompiler implementation classes
79 class ESC[4;38;5;81mCCompilerError (ESC[4;38;5;149mException):
80 """Some compile/link operation failed."""
81
82 class ESC[4;38;5;81mPreprocessError (ESC[4;38;5;149mCCompilerError):
83 """Failure to preprocess one or more C/C++ files."""
84
85 class ESC[4;38;5;81mCompileError (ESC[4;38;5;149mCCompilerError):
86 """Failure to compile one or more C/C++ source files."""
87
88 class ESC[4;38;5;81mLibError (ESC[4;38;5;149mCCompilerError):
89 """Failure to create a static library from one or more C/C++ object
90 files."""
91
92 class ESC[4;38;5;81mLinkError (ESC[4;38;5;149mCCompilerError):
93 """Failure to link one or more C/C++ object files into an executable
94 or shared library file."""
95
96 class ESC[4;38;5;81mUnknownFileError (ESC[4;38;5;149mCCompilerError):
97 """Attempt to process an unknown file type."""