feat: Add support for (sub)domain routing

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::handler));
+    // Other routes...
+    bp
+}
+```

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

@@ -0,0 +1,18 @@
+```rust title="src/dynamic/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("{sub}.pavex.dev").nest(sub_bp());
+    bp
+}
+
+fn sub_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other routes...
+    bp
+}
+```

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

@@ -0,0 +1,13 @@
+```rust title="src/fallback/blueprint.rs" hl_lines="9"
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.domain("pavex.dev").nest(website_bp());
+    bp.domain("api.pavex.dev").prefix("/v1").nest(api_bp());
+    // If no domain matches, serve a 404 page.
+    bp.fallback(f!(super::unknown_domain));
+    bp
+}
+```

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

@@ -0,0 +1,28 @@
+```rust title="src/intro/blueprint.rs" hl_lines="8 10"
+use pavex::blueprint::router::GET;
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    // Serve the website from the root domain...
+    bp.domain("pavex.dev").nest(website_bp());
+    // ...while reserving a subdomain for the REST API.
+    bp.domain("api.pavex.dev").prefix("/v1").nest(api_bp());
+    bp
+}
+
+fn website_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other web pages...
+    bp
+}
+
+fn api_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/users", f!(super::users));
+    // Other API routes...
+    bp
+}
+```

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

@@ -0,0 +1,18 @@
+```rust title="src/multi/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("{user_id}.{tenant_id}.pavex.dev").nest(user_bp());
+    bp
+}
+
+fn user_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other routes...
+    bp
+}
+```

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

@@ -0,0 +1,18 @@
+```rust title="src/static_/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("pavex.dev").nest(pavex_bp());
+    bp
+}
+
+fn pavex_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other routes...
+    bp
+}
+```

doc_examples/guide/routing/domain_guards/project/.gitignore

@@ -0,0 +1,2 @@
+/target
+Cargo.lock

doc_examples/guide/routing/domain_guards/project/Cargo.toml

@@ -0,0 +1,13 @@
+[package]
+name = "domain_guards"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]
+pavex = { path = "../../../../../libs/pavex" }
+pavex_cli_client = { path = "../../../../../libs/pavex_cli_client" }
+serde = { version = "1", features = ["derive"] }
+cargo_px_env = "0.1"
+
+[workspace]
+members = [".", "server_sdk"]

doc_examples/guide/routing/domain_guards/project/server_sdk/Cargo.toml

@@ -0,0 +1,8 @@
+[package]
+name = "domain_guards_server_sdk"
+version = "0.1.0"
+edition = "2021"
+
+[package.metadata.px.generate]
+generator_type = "cargo_workspace_binary"
+generator_name = "domain_guards"

doc_examples/guide/routing/domain_guards/project/server_sdk/src/lib.rs

@@ -0,0 +1 @@
+

doc_examples/guide/routing/domain_guards/project/src/blueprint.rs

@@ -0,0 +1,12 @@
+use pavex::blueprint::Blueprint;
+
+pub fn blueprint() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.nest(crate::intro::bp());
+    bp.prefix("/static").nest(crate::static_::bp());
+    bp.prefix("/dynamic").nest(crate::dynamic::bp());
+    bp.prefix("/multi").nest(crate::multi::bp());
+    bp.prefix("/catch_all").nest(crate::catch_all::bp());
+    bp.prefix("/fallback").nest(crate::fallback::bp());
+    bp
+}

doc_examples/guide/routing/domain_guards/project/src/catch_all/blueprint.rs

@@ -0,0 +1,16 @@
+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::handler));
+    // Other routes...
+    bp
+}

doc_examples/guide/routing/domain_guards/project/src/catch_all/mod.rs

@@ -0,0 +1,5 @@
+pub use blueprint::bp;
+pub use routes::*;
+
+mod blueprint;
+mod routes;

doc_examples/guide/routing/domain_guards/project/src/catch_all/routes.rs

@@ -0,0 +1,5 @@
+use pavex::http::StatusCode;
+
+pub fn handler() -> StatusCode {
+    StatusCode::OK
+}

doc_examples/guide/routing/domain_guards/project/src/dynamic/blueprint.rs

@@ -0,0 +1,16 @@
+use pavex::blueprint::router::GET;
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.domain("{sub}.pavex.dev").nest(sub_bp());
+    bp
+}
+
+fn sub_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other routes...
+    bp
+}

doc_examples/guide/routing/domain_guards/project/src/dynamic/mod.rs

@@ -0,0 +1,5 @@
+pub use blueprint::bp;
+pub use routes::*;
+
+mod blueprint;
+mod routes;

doc_examples/guide/routing/domain_guards/project/src/dynamic/routes.rs

@@ -0,0 +1,5 @@
+use pavex::http::StatusCode;
+
+pub fn index() -> StatusCode {
+    StatusCode::OK
+}

doc_examples/guide/routing/domain_guards/project/src/fallback/blueprint.rs

@@ -0,0 +1,25 @@
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.domain("pavex.dev").nest(website_bp());
+    bp.domain("api.pavex.dev").prefix("/v1").nest(api_bp());
+    // If no domain matches, serve a 404 page.
+    bp.fallback(f!(super::unknown_domain));
+    bp
+}
+
+fn website_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(pavex::blueprint::router::GET, "/", f!(super::index));
+    // Other web pages...
+    bp
+}
+
+fn api_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(pavex::blueprint::router::GET, "/users", f!(super::users));
+    // Other API routes...
+    bp
+}

doc_examples/guide/routing/domain_guards/project/src/fallback/mod.rs

@@ -0,0 +1,5 @@
+pub use blueprint::bp;
+pub use routes::*;
+
+mod blueprint;
+mod routes;

doc_examples/guide/routing/domain_guards/project/src/fallback/routes.rs

@@ -0,0 +1,13 @@
+use pavex::http::StatusCode;
+
+pub fn index() -> StatusCode {
+    StatusCode::OK
+}
+
+pub fn unknown_domain() -> StatusCode {
+    StatusCode::NOT_FOUND
+}
+
+pub fn users() -> StatusCode {
+    StatusCode::OK
+}

doc_examples/guide/routing/domain_guards/project/src/intro/blueprint.rs

@@ -0,0 +1,26 @@
+use pavex::blueprint::router::GET;
+use pavex::blueprint::Blueprint;
+use pavex::f;
+
+pub fn bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    // Serve the website from the root domain...
+    bp.domain("pavex.dev").nest(website_bp());
+    // ...while reserving a subdomain for the REST API.
+    bp.domain("api.pavex.dev").prefix("/v1").nest(api_bp());
+    bp
+}
+
+fn website_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/", f!(super::index));
+    // Other web pages...
+    bp
+}
+
+fn api_bp() -> Blueprint {
+    let mut bp = Blueprint::new();
+    bp.route(GET, "/users", f!(super::users));
+    // Other API routes...
+    bp
+}