Coverage for src/ezcompiler/shared/exceptions/__init__.py: 100.00%

1# /////////////////////////////////////////////////////////////// 

2# EXCEPTIONS PACKAGE - Specialized exception hierarchy 

3# Project: ezcompiler 

4# /////////////////////////////////////////////////////////////// 

5 

6""" 

7Exceptions package - Specialized exceptions organized by module functionality. 

8 

9This package provides fine-grained exceptions for different layers and utilities 

10of the EzCompiler project, enabling precise error handling. 

11 

12Structure: 

13- services: Service layer exceptions (compiler, template, uploader services) 

14- utils: Utility layer exceptions 

15 - file_exceptions: File and directory operation errors 

16 - compiler_exceptions: Compiler operation errors 

17 - uploader_exceptions: Upload operation errors 

18 - validation_exceptions: Validation errors 

19 - zip_exceptions: ZIP archive errors 

20 - config_exceptions: Configuration errors 

21 - template_exceptions: Template processing errors 

22""" 

23 

24from __future__ import annotations 

25 

26# /////////////////////////////////////////////////////////////// 

27# IMPORTS - Exception modules from services 

28# /////////////////////////////////////////////////////////////// 

29from . import services 

30from .services import ( 

31 CompilationError, 

32 CompilerServiceError, 

33 ConfigurationError, 

34 ReleaseError, 

35 TemplateError, 

36 TemplateServiceError, 

37 UpdaterError, 

38 UploadError, 

39 UploaderServiceError, 

40 VersionError, 

41) 

42 

43# /////////////////////////////////////////////////////////////// 

44# IMPORTS - Exception modules from utils 

45# /////////////////////////////////////////////////////////////// 

46from .utils import ( 

47 _base, 

48 _compiler_exceptions, 

49 _config_exceptions, 

50 _file_exceptions, 

51 _template_exceptions, 

52 _uploader_exceptions, 

53 _validation_exceptions, 

54 _zip_exceptions, 

55) 

56 

57# /////////////////////////////////////////////////////////////// 

58# RE-EXPORTS - Base exception for backward compatibility 

59# /////////////////////////////////////////////////////////////// 

60from .utils._base import EzCompilerError 

61from .utils._config_exceptions import ConfigError 

62from .utils._installer_exceptions import ( 

63 InstallerBuildError, 

64 InstallerConfigError, 

65 InstallerError, 

66 InstallerTypeError, 

67 IsccNotFoundError, 

68) 

69from .utils._release_exceptions import ( 

70 BundleBuildError, 

71 ReleaseConfigError, 

72 ReleaserTypeError, 

73 SigningKeyError, 

74) 

75from .utils._updater_exceptions import ( 

76 UpdaterConfigError, 

77 UpdaterGenerationError, 

78) 

79from .utils._zip_exceptions import ZipError 

80 

81# /////////////////////////////////////////////////////////////// 

82# PUBLIC API - Exception modules 

83# /////////////////////////////////////////////////////////////// 

84 

85__all__ = [ 

86 # Exception modules 

87 "services", 

88 "_base", 

89 "_compiler_exceptions", 

90 "_config_exceptions", 

91 "_file_exceptions", 

92 "_uploader_exceptions", 

93 "_template_exceptions", 

94 "_validation_exceptions", 

95 "_zip_exceptions", 

96 # Base exception (re-exported for convenience) 

97 "EzCompilerError", 

98 # Service exceptions (re-exported for convenience) 

99 "CompilerServiceError", 

100 "CompilationError", 

101 "ConfigurationError", 

102 "TemplateServiceError", 

103 "TemplateError", 

104 "VersionError", 

105 "UploaderServiceError", 

106 "UploadError", 

107 # Release exceptions 

108 "ReleaseError", 

109 "ReleaserTypeError", 

110 "BundleBuildError", 

111 "SigningKeyError", 

112 "ReleaseConfigError", 

113 # Installer exceptions 

114 "InstallerError", 

115 "InstallerTypeError", 

116 "IsccNotFoundError", 

117 "InstallerBuildError", 

118 "InstallerConfigError", 

119 # Updater exceptions 

120 "UpdaterError", 

121 "UpdaterConfigError", 

122 "UpdaterGenerationError", 

123 # Util exceptions promoted for interface layer use 

124 "ConfigError", 

125 "ZipError", 

126]