Mercurial > cpython-lru_cache-weakref

annotate Lib/distutils/errors.py @ 74135:9c19df6c8ea0 3.2

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
News entry for Issue12798
author Senthil Kumaran <senthil@uthcode.com>
date Fri, 23 Dec 2011 11:11:21 +0800
parents 3e26c9033306
children 7d69d04522e3
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
1 """distutils.errors
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
2
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
3 Provides exceptions used by the Distutils modules. Note that Distutils
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
4 modules may raise standard exceptions; in particular, SystemExit is
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
5 usually raised for errors that are obviously the end-user's fault
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
6 (eg. bad command-line arguments).
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
7
26207
ffec67409140 Fix docstring typo; remove 'created' line
Andrew M. Kuchling <amk@amk.ca>
parents: 13750
diff changeset
8 This module is safe to use in "from ... import *" mode; it only exports
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
9 symbols whose names start with "Distutils" and end with "Error"."""
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
10
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
11 class DistutilsError (Exception):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
12 """The root of all Distutils evil."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
13 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
14
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
15 class DistutilsModuleError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
16 """Unable to load an expected module, or to find an expected class
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
17 within some module (in particular, command modules and classes)."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
18 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
19
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
20 class DistutilsClassError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
21 """Some command class (or possibly distribution class, if anyone
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
22 feels a need to subclass Distribution) is found not to be holding
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
23 up its end of the bargain, ie. implementing some part of the
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
24 "command "interface."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
25 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
26
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
27 class DistutilsGetoptError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
28 """The option table provided to 'fancy_getopt()' is bogus."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
29 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
30
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
31 class DistutilsArgError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
32 """Raised by fancy_getopt in response to getopt.error -- ie. an
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
33 error in the command line usage."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
34 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
35
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
36 class DistutilsFileError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
37 """Any problems in the filesystem: expected file not found, etc.
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
38 Typically this is for problems that we detect before IOError or
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
39 OSError could be raised."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
40 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
41
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
42 class DistutilsOptionError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
43 """Syntactic/semantic errors in command options, such as use of
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
44 mutually conflicting options, or inconsistent options,
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
45 badly-spelled values, etc. No distinction is made between option
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
46 values originating in the setup script, the command line, config
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
47 files, or what-have-you -- but if we *know* something originated in
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
48 the setup script, we'll raise DistutilsSetupError instead."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
49 pass
10435
324450ea5450 First checkin of real Distutils code.
Greg Ward <gward@python.net>
parents:
diff changeset
50
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
51 class DistutilsSetupError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
52 """For errors that can be definitely blamed on the setup script,
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
53 such as invalid keyword arguments to 'setup()'."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
54 pass
11193
89961b6813ac Added DistutilsExecError, DistutilsValueError.
Greg Ward <gward@python.net>
parents: 11115
diff changeset
55
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
56 class DistutilsPlatformError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
57 """We don't know how to do something on the current platform (but
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
58 we do know how to do it on some platform) -- eg. trying to compile
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
59 C files on a platform not supported by a CCompiler subclass."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
60 pass
11115
dcc09228a3d2 Don't pollute importer's namespace with type objects from types modules.
Greg Ward <gward@python.net>
parents: 10435
diff changeset
61
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
62 class DistutilsExecError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
63 """Any problems executing an external program (such as the C
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
64 compiler, when compiling C files)."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
65 pass
11193
89961b6813ac Added DistutilsExecError, DistutilsValueError.
Greg Ward <gward@python.net>
parents: 11115
diff changeset
66
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
67 class DistutilsInternalError (DistutilsError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
68 """Internal inconsistencies or impossibilities (obviously, this
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
69 should never be seen if the code is working!)."""
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
70 pass
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
71
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
72 class DistutilsTemplateError (DistutilsError):
13750
dfdb911cbec2 Added DistutilsTemplateError.
Greg Ward <gward@python.net>
parents: 13012
diff changeset
73 """Syntax error in a file list template."""
dfdb911cbec2 Added DistutilsTemplateError.
Greg Ward <gward@python.net>
parents: 13012
diff changeset
74
56741
a3cb812d80f9 Merged revisions 75704 via svnmerge from
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 43026
diff changeset
75 class DistutilsByteCompileError(DistutilsError):
a3cb812d80f9 Merged revisions 75704 via svnmerge from
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 43026
diff changeset
76 """Byte compile error."""
12157
be2f003d47cc Added DistutilsInternalError.
Greg Ward <gward@python.net>
parents: 11897
diff changeset
77
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
78 # Exception classes used by the CCompiler implementation classes
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
79 class CCompilerError (Exception):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
80 """Some compile/link operation failed."""
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
81
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
82 class PreprocessError (CCompilerError):
13012
9076efac8420 Added PreprocessError and UnknownFileError (both used by CCompiler).
Greg Ward <gward@python.net>
parents: 12791
diff changeset
83 """Failure to preprocess one or more C/C++ files."""
9076efac8420 Added PreprocessError and UnknownFileError (both used by CCompiler).
Greg Ward <gward@python.net>
parents: 12791
diff changeset
84
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
85 class CompileError (CCompilerError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
86 """Failure to compile one or more C/C++ source files."""
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
87
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
88 class LibError (CCompilerError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
89 """Failure to create a static library from one or more C/C++ object
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
90 files."""
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
91
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
92 class LinkError (CCompilerError):
12791
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
93 """Failure to link one or more C/C++ object files into an executable
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
94 or shared library file."""
937f9859c9de Moved the CCompiler exceptions here, to avoid having to import ccompiler.py
Greg Ward <gward@python.net>
parents: 12408
diff changeset
95
63136
29a3eda89995 reverted distutils its 3.1 state. All new work is now happening in disutils2, and distutils is now feature-frozen.
Tarek Ziadé <ziade.tarek@gmail.com>
parents: 56933
diff changeset
96 class UnknownFileError (CCompilerError):
13012
9076efac8420 Added PreprocessError and UnknownFileError (both used by CCompiler).
Greg Ward <gward@python.net>
parents: 12791
diff changeset
97 """Attempt to process an unknown file type."""