]>
Commit | Line | Data |
---|---|---|
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 | # This module should be kept compatible with Python 1.5.2. | |
12 | ||
13 | __revision__ = "$Id$" | |
14 | ||
15 | class DistutilsError (Exception): | |
16 | """The root of all Distutils evil.""" | |
17 | pass | |
18 | ||
19 | class DistutilsModuleError (DistutilsError): | |
20 | """Unable to load an expected module, or to find an expected class | |
21 | within some module (in particular, command modules and classes).""" | |
22 | pass | |
23 | ||
24 | class DistutilsClassError (DistutilsError): | |
25 | """Some command class (or possibly distribution class, if anyone | |
26 | feels a need to subclass Distribution) is found not to be holding | |
27 | up its end of the bargain, ie. implementing some part of the | |
28 | "command "interface.""" | |
29 | pass | |
30 | ||
31 | class DistutilsGetoptError (DistutilsError): | |
32 | """The option table provided to 'fancy_getopt()' is bogus.""" | |
33 | pass | |
34 | ||
35 | class DistutilsArgError (DistutilsError): | |
36 | """Raised by fancy_getopt in response to getopt.error -- ie. an | |
37 | error in the command line usage.""" | |
38 | pass | |
39 | ||
40 | class DistutilsFileError (DistutilsError): | |
41 | """Any problems in the filesystem: expected file not found, etc. | |
42 | Typically this is for problems that we detect before IOError or | |
43 | OSError could be raised.""" | |
44 | pass | |
45 | ||
46 | class DistutilsOptionError (DistutilsError): | |
47 | """Syntactic/semantic errors in command options, such as use of | |
48 | mutually conflicting options, or inconsistent options, | |
49 | badly-spelled values, etc. No distinction is made between option | |
50 | values originating in the setup script, the command line, config | |
51 | files, or what-have-you -- but if we *know* something originated in | |
52 | the setup script, we'll raise DistutilsSetupError instead.""" | |
53 | pass | |
54 | ||
55 | class DistutilsSetupError (DistutilsError): | |
56 | """For errors that can be definitely blamed on the setup script, | |
57 | such as invalid keyword arguments to 'setup()'.""" | |
58 | pass | |
59 | ||
60 | class DistutilsPlatformError (DistutilsError): | |
61 | """We don't know how to do something on the current platform (but | |
62 | we do know how to do it on some platform) -- eg. trying to compile | |
63 | C files on a platform not supported by a CCompiler subclass.""" | |
64 | pass | |
65 | ||
66 | class DistutilsExecError (DistutilsError): | |
67 | """Any problems executing an external program (such as the C | |
68 | compiler, when compiling C files).""" | |
69 | pass | |
70 | ||
71 | class DistutilsInternalError (DistutilsError): | |
72 | """Internal inconsistencies or impossibilities (obviously, this | |
73 | should never be seen if the code is working!).""" | |
74 | pass | |
75 | ||
76 | class DistutilsTemplateError (DistutilsError): | |
77 | """Syntax error in a file list template.""" | |
78 | ||
79 | ||
80 | # Exception classes used by the CCompiler implementation classes | |
81 | class CCompilerError (Exception): | |
82 | """Some compile/link operation failed.""" | |
83 | ||
84 | class PreprocessError (CCompilerError): | |
85 | """Failure to preprocess one or more C/C++ files.""" | |
86 | ||
87 | class CompileError (CCompilerError): | |
88 | """Failure to compile one or more C/C++ source files.""" | |
89 | ||
90 | class LibError (CCompilerError): | |
91 | """Failure to create a static library from one or more C/C++ object | |
92 | files.""" | |
93 | ||
94 | class LinkError (CCompilerError): | |
95 | """Failure to link one or more C/C++ object files into an executable | |
96 | or shared library file.""" | |
97 | ||
98 | class UnknownFileError (CCompilerError): | |
99 | """Attempt to process an unknown file type.""" |