1pub use ::aws_smithy_runtime_api::client::endpoint::EndpointFuture;
3pub use ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver;
4pub use ::aws_smithy_types::endpoint::Endpoint;
5
6#[cfg(test)]
7mod test {
8
9 #[test]
11 fn test_1() {
12 let params = crate::config::endpoint::Params::builder()
13 .region("aws-global".to_string())
14 .use_fips(false)
15 .use_dual_stack(false)
16 .build()
17 .expect("invalid params");
18 let resolver = crate::config::endpoint::DefaultResolver::new();
19 let endpoint = resolver.resolve_endpoint(¶ms);
20 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.amazonaws.com");
21 assert_eq!(
22 endpoint,
23 ::aws_smithy_types::endpoint::Endpoint::builder()
24 .url("https://chime.us-east-1.amazonaws.com")
25 .property(
26 "authSchemes",
27 vec![{
28 let mut out = ::std::collections::HashMap::<String, ::aws_smithy_types::Document>::new();
29 out.insert("name".to_string(), "sigv4".to_string().into());
30 out.insert("signingName".to_string(), "chime".to_string().into());
31 out.insert("signingRegion".to_string(), "us-east-1".to_string().into());
32 out
33 }
34 .into()]
35 )
36 .build()
37 );
38 }
39
40 #[test]
42 fn test_2() {
43 let params = crate::config::endpoint::Params::builder()
44 .region("us-east-1".to_string())
45 .use_fips(true)
46 .use_dual_stack(true)
47 .build()
48 .expect("invalid params");
49 let resolver = crate::config::endpoint::DefaultResolver::new();
50 let endpoint = resolver.resolve_endpoint(¶ms);
51 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-east-1.api.aws");
52 assert_eq!(
53 endpoint,
54 ::aws_smithy_types::endpoint::Endpoint::builder()
55 .url("https://chime-fips.us-east-1.api.aws")
56 .build()
57 );
58 }
59
60 #[test]
62 fn test_3() {
63 let params = crate::config::endpoint::Params::builder()
64 .region("us-east-1".to_string())
65 .use_fips(true)
66 .use_dual_stack(false)
67 .build()
68 .expect("invalid params");
69 let resolver = crate::config::endpoint::DefaultResolver::new();
70 let endpoint = resolver.resolve_endpoint(¶ms);
71 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-east-1.amazonaws.com");
72 assert_eq!(
73 endpoint,
74 ::aws_smithy_types::endpoint::Endpoint::builder()
75 .url("https://chime-fips.us-east-1.amazonaws.com")
76 .build()
77 );
78 }
79
80 #[test]
82 fn test_4() {
83 let params = crate::config::endpoint::Params::builder()
84 .region("us-east-1".to_string())
85 .use_fips(false)
86 .use_dual_stack(true)
87 .build()
88 .expect("invalid params");
89 let resolver = crate::config::endpoint::DefaultResolver::new();
90 let endpoint = resolver.resolve_endpoint(¶ms);
91 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.api.aws");
92 assert_eq!(
93 endpoint,
94 ::aws_smithy_types::endpoint::Endpoint::builder()
95 .url("https://chime.us-east-1.api.aws")
96 .build()
97 );
98 }
99
100 #[test]
102 fn test_5() {
103 let params = crate::config::endpoint::Params::builder()
104 .region("us-east-1".to_string())
105 .use_fips(false)
106 .use_dual_stack(false)
107 .build()
108 .expect("invalid params");
109 let resolver = crate::config::endpoint::DefaultResolver::new();
110 let endpoint = resolver.resolve_endpoint(¶ms);
111 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-east-1.amazonaws.com");
112 assert_eq!(
113 endpoint,
114 ::aws_smithy_types::endpoint::Endpoint::builder()
115 .url("https://chime.us-east-1.amazonaws.com")
116 .property(
117 "authSchemes",
118 vec![{
119 let mut out = ::std::collections::HashMap::<String, ::aws_smithy_types::Document>::new();
120 out.insert("name".to_string(), "sigv4".to_string().into());
121 out.insert("signingName".to_string(), "chime".to_string().into());
122 out.insert("signingRegion".to_string(), "us-east-1".to_string().into());
123 out
124 }
125 .into()]
126 )
127 .build()
128 );
129 }
130
131 #[test]
133 fn test_6() {
134 let params = crate::config::endpoint::Params::builder()
135 .region("cn-north-1".to_string())
136 .use_fips(true)
137 .use_dual_stack(true)
138 .build()
139 .expect("invalid params");
140 let resolver = crate::config::endpoint::DefaultResolver::new();
141 let endpoint = resolver.resolve_endpoint(¶ms);
142 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.cn-north-1.api.amazonwebservices.com.cn");
143 assert_eq!(
144 endpoint,
145 ::aws_smithy_types::endpoint::Endpoint::builder()
146 .url("https://chime-fips.cn-north-1.api.amazonwebservices.com.cn")
147 .build()
148 );
149 }
150
151 #[test]
153 fn test_7() {
154 let params = crate::config::endpoint::Params::builder()
155 .region("cn-north-1".to_string())
156 .use_fips(true)
157 .use_dual_stack(false)
158 .build()
159 .expect("invalid params");
160 let resolver = crate::config::endpoint::DefaultResolver::new();
161 let endpoint = resolver.resolve_endpoint(¶ms);
162 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.cn-north-1.amazonaws.com.cn");
163 assert_eq!(
164 endpoint,
165 ::aws_smithy_types::endpoint::Endpoint::builder()
166 .url("https://chime-fips.cn-north-1.amazonaws.com.cn")
167 .build()
168 );
169 }
170
171 #[test]
173 fn test_8() {
174 let params = crate::config::endpoint::Params::builder()
175 .region("cn-north-1".to_string())
176 .use_fips(false)
177 .use_dual_stack(true)
178 .build()
179 .expect("invalid params");
180 let resolver = crate::config::endpoint::DefaultResolver::new();
181 let endpoint = resolver.resolve_endpoint(¶ms);
182 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.cn-north-1.api.amazonwebservices.com.cn");
183 assert_eq!(
184 endpoint,
185 ::aws_smithy_types::endpoint::Endpoint::builder()
186 .url("https://chime.cn-north-1.api.amazonwebservices.com.cn")
187 .build()
188 );
189 }
190
191 #[test]
193 fn test_9() {
194 let params = crate::config::endpoint::Params::builder()
195 .region("cn-north-1".to_string())
196 .use_fips(false)
197 .use_dual_stack(false)
198 .build()
199 .expect("invalid params");
200 let resolver = crate::config::endpoint::DefaultResolver::new();
201 let endpoint = resolver.resolve_endpoint(¶ms);
202 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.cn-north-1.amazonaws.com.cn");
203 assert_eq!(
204 endpoint,
205 ::aws_smithy_types::endpoint::Endpoint::builder()
206 .url("https://chime.cn-north-1.amazonaws.com.cn")
207 .build()
208 );
209 }
210
211 #[test]
213 fn test_10() {
214 let params = crate::config::endpoint::Params::builder()
215 .region("us-gov-east-1".to_string())
216 .use_fips(true)
217 .use_dual_stack(true)
218 .build()
219 .expect("invalid params");
220 let resolver = crate::config::endpoint::DefaultResolver::new();
221 let endpoint = resolver.resolve_endpoint(¶ms);
222 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-gov-east-1.api.aws");
223 assert_eq!(
224 endpoint,
225 ::aws_smithy_types::endpoint::Endpoint::builder()
226 .url("https://chime-fips.us-gov-east-1.api.aws")
227 .build()
228 );
229 }
230
231 #[test]
233 fn test_11() {
234 let params = crate::config::endpoint::Params::builder()
235 .region("us-gov-east-1".to_string())
236 .use_fips(true)
237 .use_dual_stack(false)
238 .build()
239 .expect("invalid params");
240 let resolver = crate::config::endpoint::DefaultResolver::new();
241 let endpoint = resolver.resolve_endpoint(¶ms);
242 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-gov-east-1.amazonaws.com");
243 assert_eq!(
244 endpoint,
245 ::aws_smithy_types::endpoint::Endpoint::builder()
246 .url("https://chime-fips.us-gov-east-1.amazonaws.com")
247 .build()
248 );
249 }
250
251 #[test]
253 fn test_12() {
254 let params = crate::config::endpoint::Params::builder()
255 .region("us-gov-east-1".to_string())
256 .use_fips(false)
257 .use_dual_stack(true)
258 .build()
259 .expect("invalid params");
260 let resolver = crate::config::endpoint::DefaultResolver::new();
261 let endpoint = resolver.resolve_endpoint(¶ms);
262 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-gov-east-1.api.aws");
263 assert_eq!(
264 endpoint,
265 ::aws_smithy_types::endpoint::Endpoint::builder()
266 .url("https://chime.us-gov-east-1.api.aws")
267 .build()
268 );
269 }
270
271 #[test]
273 fn test_13() {
274 let params = crate::config::endpoint::Params::builder()
275 .region("us-gov-east-1".to_string())
276 .use_fips(false)
277 .use_dual_stack(false)
278 .build()
279 .expect("invalid params");
280 let resolver = crate::config::endpoint::DefaultResolver::new();
281 let endpoint = resolver.resolve_endpoint(¶ms);
282 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-gov-east-1.amazonaws.com");
283 assert_eq!(
284 endpoint,
285 ::aws_smithy_types::endpoint::Endpoint::builder()
286 .url("https://chime.us-gov-east-1.amazonaws.com")
287 .build()
288 );
289 }
290
291 #[test]
293 fn test_14() {
294 let params = crate::config::endpoint::Params::builder()
295 .region("us-iso-east-1".to_string())
296 .use_fips(true)
297 .use_dual_stack(false)
298 .build()
299 .expect("invalid params");
300 let resolver = crate::config::endpoint::DefaultResolver::new();
301 let endpoint = resolver.resolve_endpoint(¶ms);
302 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-iso-east-1.c2s.ic.gov");
303 assert_eq!(
304 endpoint,
305 ::aws_smithy_types::endpoint::Endpoint::builder()
306 .url("https://chime-fips.us-iso-east-1.c2s.ic.gov")
307 .build()
308 );
309 }
310
311 #[test]
313 fn test_15() {
314 let params = crate::config::endpoint::Params::builder()
315 .region("us-iso-east-1".to_string())
316 .use_fips(false)
317 .use_dual_stack(false)
318 .build()
319 .expect("invalid params");
320 let resolver = crate::config::endpoint::DefaultResolver::new();
321 let endpoint = resolver.resolve_endpoint(¶ms);
322 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-iso-east-1.c2s.ic.gov");
323 assert_eq!(
324 endpoint,
325 ::aws_smithy_types::endpoint::Endpoint::builder()
326 .url("https://chime.us-iso-east-1.c2s.ic.gov")
327 .build()
328 );
329 }
330
331 #[test]
333 fn test_16() {
334 let params = crate::config::endpoint::Params::builder()
335 .region("us-isob-east-1".to_string())
336 .use_fips(true)
337 .use_dual_stack(false)
338 .build()
339 .expect("invalid params");
340 let resolver = crate::config::endpoint::DefaultResolver::new();
341 let endpoint = resolver.resolve_endpoint(¶ms);
342 let endpoint = endpoint.expect("Expected valid endpoint: https://chime-fips.us-isob-east-1.sc2s.sgov.gov");
343 assert_eq!(
344 endpoint,
345 ::aws_smithy_types::endpoint::Endpoint::builder()
346 .url("https://chime-fips.us-isob-east-1.sc2s.sgov.gov")
347 .build()
348 );
349 }
350
351 #[test]
353 fn test_17() {
354 let params = crate::config::endpoint::Params::builder()
355 .region("us-isob-east-1".to_string())
356 .use_fips(false)
357 .use_dual_stack(false)
358 .build()
359 .expect("invalid params");
360 let resolver = crate::config::endpoint::DefaultResolver::new();
361 let endpoint = resolver.resolve_endpoint(¶ms);
362 let endpoint = endpoint.expect("Expected valid endpoint: https://chime.us-isob-east-1.sc2s.sgov.gov");
363 assert_eq!(
364 endpoint,
365 ::aws_smithy_types::endpoint::Endpoint::builder()
366 .url("https://chime.us-isob-east-1.sc2s.sgov.gov")
367 .build()
368 );
369 }
370
371 #[test]
373 fn test_18() {
374 let params = crate::config::endpoint::Params::builder()
375 .region("us-east-1".to_string())
376 .use_fips(false)
377 .use_dual_stack(false)
378 .endpoint("https://example.com".to_string())
379 .build()
380 .expect("invalid params");
381 let resolver = crate::config::endpoint::DefaultResolver::new();
382 let endpoint = resolver.resolve_endpoint(¶ms);
383 let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
384 assert_eq!(
385 endpoint,
386 ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
387 );
388 }
389
390 #[test]
392 fn test_19() {
393 let params = crate::config::endpoint::Params::builder()
394 .use_fips(false)
395 .use_dual_stack(false)
396 .endpoint("https://example.com".to_string())
397 .build()
398 .expect("invalid params");
399 let resolver = crate::config::endpoint::DefaultResolver::new();
400 let endpoint = resolver.resolve_endpoint(¶ms);
401 let endpoint = endpoint.expect("Expected valid endpoint: https://example.com");
402 assert_eq!(
403 endpoint,
404 ::aws_smithy_types::endpoint::Endpoint::builder().url("https://example.com").build()
405 );
406 }
407
408 #[test]
410 fn test_20() {
411 let params = crate::config::endpoint::Params::builder()
412 .region("us-east-1".to_string())
413 .use_fips(true)
414 .use_dual_stack(false)
415 .endpoint("https://example.com".to_string())
416 .build()
417 .expect("invalid params");
418 let resolver = crate::config::endpoint::DefaultResolver::new();
419 let endpoint = resolver.resolve_endpoint(¶ms);
420 let error = endpoint.expect_err("expected error: Invalid Configuration: FIPS and custom endpoint are not supported [For custom endpoint with fips enabled and dualstack disabled]");
421 assert_eq!(format!("{}", error), "Invalid Configuration: FIPS and custom endpoint are not supported")
422 }
423
424 #[test]
426 fn test_21() {
427 let params = crate::config::endpoint::Params::builder()
428 .region("us-east-1".to_string())
429 .use_fips(false)
430 .use_dual_stack(true)
431 .endpoint("https://example.com".to_string())
432 .build()
433 .expect("invalid params");
434 let resolver = crate::config::endpoint::DefaultResolver::new();
435 let endpoint = resolver.resolve_endpoint(¶ms);
436 let error = endpoint.expect_err("expected error: Invalid Configuration: Dualstack and custom endpoint are not supported [For custom endpoint with fips disabled and dualstack enabled]");
437 assert_eq!(
438 format!("{}", error),
439 "Invalid Configuration: Dualstack and custom endpoint are not supported"
440 )
441 }
442
443 #[test]
445 fn test_22() {
446 let params = crate::config::endpoint::Params::builder().build().expect("invalid params");
447 let resolver = crate::config::endpoint::DefaultResolver::new();
448 let endpoint = resolver.resolve_endpoint(¶ms);
449 let error = endpoint.expect_err("expected error: Invalid Configuration: Missing Region [Missing region]");
450 assert_eq!(format!("{}", error), "Invalid Configuration: Missing Region")
451 }
452}
453
454pub trait ResolveEndpoint: ::std::marker::Send + ::std::marker::Sync + ::std::fmt::Debug {
456 fn resolve_endpoint<'a>(&'a self, params: &'a crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a>;
458
459 fn into_shared_resolver(self) -> ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver
463 where
464 Self: Sized + 'static,
465 {
466 ::aws_smithy_runtime_api::client::endpoint::SharedEndpointResolver::new(DowncastParams(self))
467 }
468}
469
470#[derive(Debug)]
471struct DowncastParams<T>(T);
472impl<T> ::aws_smithy_runtime_api::client::endpoint::ResolveEndpoint for DowncastParams<T>
473where
474 T: ResolveEndpoint,
475{
476 fn resolve_endpoint<'a>(
477 &'a self,
478 params: &'a ::aws_smithy_runtime_api::client::endpoint::EndpointResolverParams,
479 ) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'a> {
480 let ep = match params.get::<crate::config::endpoint::Params>() {
481 Some(params) => self.0.resolve_endpoint(params),
482 None => ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(Err("params of expected type was not present".into())),
483 };
484 ep
485 }
486}
487
488#[derive(Debug, Default)]
490pub struct DefaultResolver {
491 partition_resolver: crate::endpoint_lib::partition::PartitionResolver,
492}
493
494impl DefaultResolver {
495 pub fn new() -> Self {
497 Self {
498 partition_resolver: crate::endpoint_lib::DEFAULT_PARTITION_RESOLVER.clone(),
499 }
500 }
501
502 fn resolve_endpoint(
503 &self,
504 params: &crate::config::endpoint::Params,
505 ) -> ::std::result::Result<::aws_smithy_types::endpoint::Endpoint, ::aws_smithy_runtime_api::box_error::BoxError> {
506 let mut diagnostic_collector = crate::endpoint_lib::diagnostic::DiagnosticCollector::new();
507 Ok(
508 crate::config::endpoint::internals::resolve_endpoint(params, &mut diagnostic_collector, &self.partition_resolver)
509 .map_err(|err| err.with_source(diagnostic_collector.take_last_error()))?,
510 )
511 }
512}
513
514impl crate::config::endpoint::ResolveEndpoint for DefaultResolver {
515 fn resolve_endpoint(&self, params: &crate::config::endpoint::Params) -> ::aws_smithy_runtime_api::client::endpoint::EndpointFuture<'_> {
516 ::aws_smithy_runtime_api::client::endpoint::EndpointFuture::ready(self.resolve_endpoint(params))
517 }
518}
519
520#[non_exhaustive]
521#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::fmt::Debug)]
522pub struct Params {
524 pub(crate) region: ::std::option::Option<::std::string::String>,
526 pub(crate) use_dual_stack: bool,
528 pub(crate) use_fips: bool,
530 pub(crate) endpoint: ::std::option::Option<::std::string::String>,
532}
533impl Params {
534 pub fn builder() -> crate::config::endpoint::ParamsBuilder {
536 crate::config::endpoint::ParamsBuilder::default()
537 }
538 pub fn region(&self) -> ::std::option::Option<&str> {
540 self.region.as_deref()
541 }
542 pub fn use_dual_stack(&self) -> ::std::option::Option<bool> {
544 Some(self.use_dual_stack)
545 }
546 pub fn use_fips(&self) -> ::std::option::Option<bool> {
548 Some(self.use_fips)
549 }
550 pub fn endpoint(&self) -> ::std::option::Option<&str> {
552 self.endpoint.as_deref()
553 }
554}
555
556#[derive(::std::clone::Clone, ::std::cmp::PartialEq, ::std::default::Default, ::std::fmt::Debug)]
558pub struct ParamsBuilder {
559 region: ::std::option::Option<::std::string::String>,
560 use_dual_stack: ::std::option::Option<bool>,
561 use_fips: ::std::option::Option<bool>,
562 endpoint: ::std::option::Option<::std::string::String>,
563}
564impl ParamsBuilder {
565 pub fn build(self) -> ::std::result::Result<crate::config::endpoint::Params, crate::config::endpoint::InvalidParams> {
567 if let Some(region) = &self.region {
568 if !crate::endpoint_lib::host::is_valid_host_label(
569 region.as_ref() as &str,
570 true,
571 &mut crate::endpoint_lib::diagnostic::DiagnosticCollector::new(),
572 ) {
573 return Err(crate::config::endpoint::InvalidParams::invalid_value(
574 "region",
575 "must be a valid host label",
576 ));
577 }
578 };
579 Ok(
580 #[allow(clippy::unnecessary_lazy_evaluations)]
581 crate::config::endpoint::Params {
582 region: self.region,
583 use_dual_stack: self
584 .use_dual_stack
585 .or_else(|| Some(false))
586 .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_dual_stack"))?,
587 use_fips: self
588 .use_fips
589 .or_else(|| Some(false))
590 .ok_or_else(|| crate::config::endpoint::InvalidParams::missing("use_fips"))?,
591 endpoint: self.endpoint,
592 },
593 )
594 }
595 pub fn region(mut self, value: impl Into<::std::string::String>) -> Self {
599 self.region = Some(value.into());
600 self
601 }
602
603 pub fn set_region(mut self, param: Option<::std::string::String>) -> Self {
607 self.region = param;
608 self
609 }
610 pub fn use_dual_stack(mut self, value: impl Into<bool>) -> Self {
615 self.use_dual_stack = Some(value.into());
616 self
617 }
618
619 pub fn set_use_dual_stack(mut self, param: Option<bool>) -> Self {
624 self.use_dual_stack = param;
625 self
626 }
627 pub fn use_fips(mut self, value: impl Into<bool>) -> Self {
632 self.use_fips = Some(value.into());
633 self
634 }
635
636 pub fn set_use_fips(mut self, param: Option<bool>) -> Self {
641 self.use_fips = param;
642 self
643 }
644 pub fn endpoint(mut self, value: impl Into<::std::string::String>) -> Self {
648 self.endpoint = Some(value.into());
649 self
650 }
651
652 pub fn set_endpoint(mut self, param: Option<::std::string::String>) -> Self {
656 self.endpoint = param;
657 self
658 }
659}
660
661#[derive(Debug)]
663pub struct InvalidParams {
664 field: std::borrow::Cow<'static, str>,
665 kind: InvalidParamsErrorKind,
666}
667
668#[derive(Debug)]
670enum InvalidParamsErrorKind {
671 MissingField,
672 InvalidValue { message: &'static str },
673}
674
675impl InvalidParams {
676 #[allow(dead_code)]
677 fn missing(field: &'static str) -> Self {
678 Self {
679 field: field.into(),
680 kind: InvalidParamsErrorKind::MissingField,
681 }
682 }
683
684 #[allow(dead_code)]
685 fn invalid_value(field: &'static str, message: &'static str) -> Self {
686 Self {
687 field: field.into(),
688 kind: InvalidParamsErrorKind::InvalidValue { message },
689 }
690 }
691}
692
693impl std::fmt::Display for InvalidParams {
694 fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
695 match self.kind {
696 InvalidParamsErrorKind::MissingField => write!(f, "a required field was missing: `{}`", self.field),
697 InvalidParamsErrorKind::InvalidValue { message } => write!(f, "invalid value for field: `{}` - {}", self.field, message),
698 }
699 }
700}
701
702impl std::error::Error for InvalidParams {}
703
704mod internals;