Do not integrate the ToC in the left sidebar on the documentation web…

…site. We adjusted the allowed width for pavex errors accordingly.

doc_examples/guide/dependency_injection/user_middleware/project/src/authentication.rs

@@ -1,16 +1,14 @@
-use std::future::IntoFuture;
-
-use pavex::middleware::Next;
+use pavex::middleware::Processing;
 use pavex::response::Response;
 
 use crate::user::User;
 
-pub async fn reject_anonymous<C>(user: &User, next: Next<C>) -> Response
-    where
-        C: IntoFuture<Output=Response>,
+pub fn reject_anonymous(user: &User) -> Processing
 {
     if let User::Anonymous = user {
-        return Response::unauthorized();
+        let r = Response::unauthorized();
+        Processing::EarlyReturn(r)
+    } else {
+        Processing::Continue
     }
-    next.into_future().await
 }

doc_examples/guide/dependency_injection/user_middleware/project/src/blueprint.rs

@@ -5,7 +5,7 @@ use pavex::f;
 pub fn blueprint() -> Blueprint {
     let mut bp = Blueprint::new();
     bp.constructor(f!(crate::User::extract), Lifecycle::RequestScoped);
-    bp.wrap(f!(crate::authentication::reject_anonymous));
+    bp.pre_process(f!(crate::authentication::reject_anonymous));
     bp.route(GET, "/greet", f!(crate::routes::greet));
     bp
 }

doc_examples/quickstart/05-error.snap

@@ -1,19 +1,20 @@
 ERROR: 
-  × I can't invoke your request handler, `app::routes::greet::get`, because it needs an instance
-  │ of `app::user_agent::UserAgent` as input, but I can't find a constructor for that type.
+  × I can't invoke your request handler, `app::routes::greet::get`, because
+  │ it needs an instance of `app::user_agent::UserAgent` as input, but I can't
+  │ find a constructor for that type.
   │
   │     ╭─[app/src/routes/mod.rs:8:1]
   │   8 │     bp.route(GET, "/api/ping", f!(self::ping::get));
   │   9 │     bp.route(GET, "/api/greet/:name", f!(self::greet::get));
   │     ·                                       ──────────┬─────────
-  [31m│[0m     ·                                                 [35;1m╰── The request handler was registered here[0m
+  [31m│[0m     ·       [35;1mThe request handler was registered here ──╯[0m
   │  10 │ }
   │     ╰────
   │     ╭─[app/src/routes/greet.rs:10:1]
   │  10 │ 
   │  11 │ pub fn get(params: PathParams<GreetParams>, user_agent: UserAgent) -> Response {
   │     ·                                             ──────────┬──────────
-  [31m│[0m     ·               [35;1mI don't know how to construct an instance of this input parameter[0m
+  [31m│[0m     ·        [35;1mI don't know how to construct an instance of this input parameter[0m
   │  12 │     if let UserAgent::Unknown = user_agent {
   │     ╰────
   │   help: Register a constructor for `app::user_agent::UserAgent`

doc_examples/quickstart/07-error.snap

@@ -1,13 +1,13 @@
 ERROR: 
-  [31m×[0m You registered a constructor that returns a `Result`, but you did not register an error
-  [31m│[0m handler for it. If I don't have an error handler, I don't know what to do with the error when
-  [31m│[0m the constructor fails!
+  [31m×[0m You registered a constructor that returns a `Result`, but you did not
+  [31m│[0m register an error handler for it. If I don't have an error handler, I
+  [31m│[0m don't know what to do with the error when the constructor fails!
   │
   │     ╭─[app/src/blueprint.rs:12:1]
   │  12 │     configuration::register(&mut bp);
   │  13 │     bp.request_scoped(f!(crate::user_agent::UserAgent::extract));
   │     ·                       ────────────────────┬────────────────────
-  [31m│[0m     ·                                           [35;1m╰── The fallible constructor was registered here[0m
+  [31m│[0m     ·                [35;1mThe fallible constructor was registered here[0m
   │  14 │ 
   │     ╰────
   │   help: Add an error handler via `.error_handler`

doc_examples/tutorial_generator/src/main.rs

@@ -413,7 +413,7 @@ impl ScriptRunner {
     ) -> Result<ScriptOutcome, anyhow::Error> {
         let mut options = ScriptOptions::new();
         let env_vars = HashMap::from([
-            ("PAVEX_TTY_WIDTH".to_string(), "100".to_string()),
+            ("PAVEX_TTY_WIDTH".to_string(), "80".to_string()),
             ("PAVEX_COLOR".to_string(), "always".to_string()),
             ("CARGO_TARGET_DIR".to_string(), self.target_dir.to_string()),
         ]);

docs/overview/why_pavex.md

@@ -18,25 +18,8 @@ Rust is a great language, but it has a large surface area: it's easy to feel lik
 Pavex aims to **lower the barrier of entry**: you'll only need **an understanding of Rust core concepts to get up and running**.
 When things go wrong, we'll be there to help you: Pavex's transpiler will provide **detailed error messages** to help you understand what went wrong and how to fix it.
 
-```
-ERROR:
-× I can't invoke your wrapping middleware, `timeout`, because it needs an instance of
-│ `TimeoutConfig` as input, but I can't find a constructor for that type.
-│
-│     ╭─[src/blueprint.rs:18:1]
-│  18 │
-│  19 │     bp.wrap(f!(crate::timeout));
-│     ·             ────────┬────────
-│     ·                     ╰── The wrapping middleware was registered here
-│  20 │
-│     ╰────
-│    ╭─[src/load_shedding.rs:5:1]
-│  5 │
-│  6 │ pub async fn timeout<T>(next: Next<T>, timeout_config: TimeoutConfig) -> Response
-│    ·                                                        ──────┬──────
-│    ·                I don't know how to construct an instance of this input parameter
-│    ╰────
-│   help: Register a constructor for `TimeoutConfig`
+```ansi-color
+--8<-- "doc_examples/quickstart/07-error.snap"
 ```
 
 ## Safe

mkdocs.yml

@@ -43,7 +43,6 @@ theme:
     - navigation.tabs.sticky
     - navigation.footer
     - navigation.top
-    - toc.integrate
     - toc.follow
     - content.action.edit
     - content.code.copy