feat: Add support for (sub)domain routing

Author: LukeMathWalker

doc_examples/guide/cookies/request_cookies/project/src/blueprint.rs

@@ -5,8 +5,10 @@ use pavex::f;
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
     CookieKit::new().register(&mut bp);
-    bp.singleton(f!(<pavex::cookie::ProcessorConfig as std::default::Default>::default));
-    bp.nest_at("/core", crate::core::blueprint());
-    bp.nest_at("/multiple", crate::multiple::blueprint());
+    bp.singleton(f!(
+        <pavex::cookie::ProcessorConfig as std::default::Default>::default
+    ));
+    bp.prefix("/core").nest(crate::core::blueprint());
+    bp.prefix("/multiple").nest(crate::multiple::blueprint());
     bp
 }

doc_examples/guide/cookies/response_cookies/project/src/blueprint.rs

@@ -8,7 +8,7 @@ pub fn blueprint() -> Blueprint {
     bp.singleton(f!(
         <pavex::cookie::ProcessorConfig as std::default::Default>::default
     ));
-    bp.nest_at("/core", crate::core::blueprint());
-    bp.nest_at("/delete", crate::delete::blueprint());
+    bp.prefix("/core").nest(crate::core::blueprint());
+    bp.prefix("/delete").nest(crate::delete::blueprint());
     bp
 }

doc_examples/guide/errors/error_handlers/project/src/blueprint.rs

@@ -2,7 +2,7 @@ use pavex::blueprint::Blueprint;
 
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
-    bp.nest_at("/core", crate::core::blueprint());
-    bp.nest_at("/universal", crate::universal::blueprint());
+    bp.prefix("/core").nest(crate::core::blueprint());
+    bp.prefix("/universal").nest(crate::universal::blueprint());
     bp
 }

doc_examples/guide/middleware/order/project/src/blueprint.rs

@@ -3,13 +3,16 @@ use pavex::blueprint::Blueprint;
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
     bp.nest(crate::core::blueprint());
-    bp.nest_at("/pre_only", crate::pre_only::blueprint());
-    bp.nest_at("/post_only", crate::post_only::blueprint());
-    bp.nest_at("/wrap_only", crate::wrap_only::blueprint());
-    bp.nest_at("/pre_and_post", crate::pre_and_post::blueprint());
-    bp.nest_at("/post_and_wrap", crate::post_and_wrap::blueprint());
-    bp.nest_at("/pre_and_wrap", crate::pre_and_wrap::blueprint());
-    bp.nest_at("/order1", crate::order1::blueprint());
-    bp.nest_at("/order2", crate::order2::blueprint());
+    bp.prefix("/pre_only").nest(crate::pre_only::blueprint());
+    bp.prefix("/post_only").nest(crate::post_only::blueprint());
+    bp.prefix("/wrap_only").nest(crate::wrap_only::blueprint());
+    bp.prefix("/pre_and_post")
+        .nest(crate::pre_and_post::blueprint());
+    bp.prefix("/post_and_wrap")
+        .nest(crate::post_and_wrap::blueprint());
+    bp.prefix("/pre_and_wrap")
+        .nest(crate::pre_and_wrap::blueprint());
+    bp.prefix("/order1").nest(crate::order1::blueprint());
+    bp.prefix("/order2").nest(crate::order2::blueprint());
     bp
 }

doc_examples/guide/middleware/post/project/src/blueprint.rs

@@ -9,6 +9,6 @@ pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
     bp.request_scoped(f!(self::root_span));
     bp.nest(crate::core::blueprint());
-    bp.nest_at("/fallible", crate::fallible::blueprint());
+    bp.prefix("/fallible").nest(crate::fallible::blueprint());
     bp
 }

doc_examples/guide/middleware/pre/project/src/blueprint.rs

@@ -3,6 +3,6 @@ use pavex::blueprint::Blueprint;
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
     bp.nest(crate::core::blueprint());
-    bp.nest_at("/fallible", crate::fallible::blueprint());
+    bp.prefix("/fallible").nest(crate::fallible::blueprint());
     bp
 }

doc_examples/guide/request_data/route_params/project-route_params_registration.snap

@@ -5,7 +5,7 @@ use pavex::f;
 
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
-    bp.route(GET, "/users/:id" /* (1)! */, f!(super::handler));
+    bp.route(GET, "/users/{id}" /* (1)! */, f!(super::handler));
     bp
 }
 ```

doc_examples/guide/request_data/route_params/project/src/raw_route_params/blueprint.rs

@@ -4,6 +4,6 @@ use pavex::f;
 
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
-    bp.route(GET, "/room/:id", f!(super::handler));
+    bp.route(GET, "/room/{id}", f!(super::handler));
     bp
 }

doc_examples/guide/request_data/route_params/project/src/route_params/blueprint.rs

@@ -4,6 +4,6 @@ use pavex::f;
 
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
-    bp.route(GET, "/users/:id" /* (1)! */, f!(super::handler));
+    bp.route(GET, "/users/{id}" /* (1)! */, f!(super::handler));
     bp
 }

doc_examples/guide/routing/domain_guards/project-catch_all.snap

@@ -0,0 +1,18 @@
+```rust title="src/catch_all/blueprint.rs" hl_lines="7"
+use pavex::blueprint::router::GET;
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.domain("{*any}.pavex.dev").nest(sub_bp());
+    bp
+}
+
+fn sub_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other routes...
+    bp
+}
+```