Add EndpointResolutionError

Author: alextwoods

packages/smithy-aws-core/src/smithy_aws_core/endpoints/standard_regional.py

@@ -6,7 +6,7 @@
 import smithy_core
 from smithy_core import URI
 from smithy_http.aio.interfaces import EndpointResolver
-from smithy_http.endpoints import Endpoint
+from smithy_http.endpoints import Endpoint, EndpointResolutionError
 
 
 @dataclass(kw_only=True)
@@ -35,7 +35,7 @@ async def resolve_endpoint(self, params: RegionalEndpointParameters) -> Endpoint
 
             # This will end up getting wrapped in the client.
             if parsed.hostname is None:
-                raise ValueError(
+                raise EndpointResolutionError(
                     f"Unable to parse hostname from provided URI: {params.sdk_endpoint}"
                 )
 
@@ -56,6 +56,6 @@ async def resolve_endpoint(self, params: RegionalEndpointParameters) -> Endpoint
 
             return Endpoint(uri=URI(host=hostname))
 
-        raise ValueError(
+        raise EndpointResolutionError(
             "Unable to resolve endpoint - either endpoint_url or region are required."
         )

packages/smithy-http/src/smithy_http/aio/endpoints.py

@@ -5,7 +5,7 @@
 from smithy_core import URI
 
 from .. import interfaces as http_interfaces
-from ..endpoints import Endpoint, StaticEndpointParams
+from ..endpoints import Endpoint, StaticEndpointParams, EndpointResolutionError
 from . import interfaces as http_aio_interfaces
 
 
@@ -18,7 +18,9 @@ async def resolve_endpoint(
         self, params: StaticEndpointParams
     ) -> http_interfaces.Endpoint:
         if params.uri is None:
-            raise ValueError("Unable to resolve endpoint: endpoint_uri is required")
+            raise EndpointResolutionError(
+                "Unable to resolve endpoint: endpoint_uri is required"
+            )
 
         # If it's not a string, it's already a parsed URI so just pass it along.
         if not isinstance(params.uri, str):
@@ -30,7 +32,7 @@ async def resolve_endpoint(
 
         # This will end up getting wrapped in the client.
         if parsed.hostname is None:
-            raise ValueError(
+            raise EndpointResolutionError(
                 f"Unable to parse hostname from provided URI: {params.uri}"
             )
 

packages/smithy-http/src/smithy_http/endpoints.py

@@ -2,6 +2,7 @@
 #  SPDX-License-Identifier: Apache-2.0
 from dataclasses import dataclass, field
 
+from smithy_core import SmithyException
 from smithy_core.interfaces import URI
 
 from . import Fields, interfaces
@@ -13,6 +14,10 @@ class Endpoint(interfaces.Endpoint):
     headers: interfaces.Fields = field(default_factory=Fields)
 
 
+class EndpointResolutionError(SmithyException):
+    """Exception type for all exceptions raised by endpoint resolution."""
+
+
 @dataclass
 class StaticEndpointParams:
     """Static endpoint params.