venv/lib/python3.11/site-packages/setuptools/_distutils/errors.py

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