Continue moving around where exceptions are

Author: adamtheturtle

src/vws/exceptions/base_exceptions.py

@@ -1,3 +1,8 @@
+"""
+Base exceptions for errors returned by Vuforia Web Services or the Vuforia
+Cloud Recognition Web API.
+"""
+
 from requests import Response
 
 
@@ -24,15 +29,18 @@ def response(self) -> Response:
 
 class VWSException(Exception):
     """
-    Base class for Vuforia Web Service errors.
+    Base class for Vuforia Web Services errors.
+
+    These errors are defined at
+    https://library.vuforia.com/articles/Solution/How-To-Use-the-Vuforia-Web-Services-API#How-To-Interperete-VWS-API-Result-Codes.
     """
 
     def __init__(self, response: Response) -> None:
         """
         Args:
             response: The response to a request to Vuforia.
         """
-        super().__init__(response.text)
+        super().__init__()
         self._response = response
 
     @property

src/vws/exceptions/cloud_reco_exceptions.py

@@ -1,3 +1,8 @@
+"""
+Exceptions which match errors raised by the Vuforia Cloud Recognition Web APIs.
+"""
+
+
 from vws.exceptions.base_exceptions import CloudRecoException
 
 

src/vws/exceptions/custom_exceptions.py

@@ -1,3 +1,9 @@
+"""
+Exceptions which do not map to errors at
+https://library.vuforia.com/articles/Solution/How-To-Use-the-Vuforia-Web-Services-API#How-To-Interperete-VWS-API-Result-Codes
+or simple errors given by the cloud recognition service.
+"""
+
 import requests
 
 

tests/test_exceptions.py

@@ -14,30 +14,33 @@
 from mock_vws.states import States
 
 from vws import VWS, CloudRecoService
-from vws.exceptions import (
+from vws.exceptions.base_exceptions import CloudRecoException, VWSException
+from vws.exceptions.cloud_reco_exceptions import (
+    MatchProcessing,
+    MaxNumResultsOutOfRange,
+)
+from vws.exceptions.custom_exceptions import (
+    ConnectionErrorPossiblyImageTooLarge,
+    TargetProcessingTimeout,
+    UnknownVWSErrorPossiblyBadName,
+)
+from vws.exceptions.vws_exceptions import (
     AuthenticationFailure,
     BadImage,
-    CloudRecoException,
-    ConnectionErrorPossiblyImageTooLarge,
     DateRangeError,
     Fail,
     ImageTooLarge,
-    MatchProcessing,
-    MaxNumResultsOutOfRange,
     MetadataTooLarge,
     ProjectHasNoAPIAccess,
     ProjectInactive,
     ProjectSuspended,
     RequestQuotaReached,
     RequestTimeTooSkewed,
     TargetNameExist,
-    TargetProcessingTimeout,
     TargetQuotaReached,
     TargetStatusNotSuccess,
     TargetStatusProcessing,
     UnknownTarget,
-    UnknownVWSErrorPossiblyBadName,
-    VWSException,
 )
 
 
@@ -368,7 +371,6 @@ def test_vwsexception_inheritance() -> None:
         TargetStatusNotSuccess,
         TargetStatusProcessing,
         UnknownTarget,
-        UnknownVWSErrorPossiblyBadName,
     ]
     for subclass in subclasses:
         assert issubclass(subclass, VWSException)

tests/test_query.py

@@ -10,9 +10,9 @@
 from mock_vws.database import VuforiaDatabase
 
 from vws import VWS, CloudRecoService
-from vws.exceptions import (
+from vws.exceptions.cloud_reco_exceptions import MaxNumResultsOutOfRange
+from vws.exceptions.custom_exceptions import (
     ConnectionErrorPossiblyImageTooLarge,
-    MaxNumResultsOutOfRange,
 )
 from vws.include_target_data import CloudRecoIncludeTargetData
 

tests/test_vws.py

@@ -15,7 +15,7 @@
 from mock_vws.database import VuforiaDatabase
 
 from vws import VWS, CloudRecoService
-from vws.exceptions import TargetProcessingTimeout
+from vws.exceptions.custom_exceptions import TargetProcessingTimeout
 from vws.reports import (
     DatabaseSummaryReport,
     TargetRecord,