Deploy site + cookbook: Merge pull request #107 from Tuntii/quick-wins

Tuntii · Tuntii · commit e7b7486375dd · 2026-02-08T19:27:03.000Z
chore(quick-wins): reduce dependency surface and align native OpenAPI… a943c4a
diff --git a/cookbook/404.html b/cookbook/404.html
@@ -37,7 +37,7 @@
             const path_to_root = "";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "searchindex-26942635.js";
+            window.path_to_searchindex_js = "searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="toc-54f2b124.js"></script>
diff --git a/cookbook/architecture/system_overview.html b/cookbook/architecture/system_overview.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
@@ -294,7 +294,6 @@ <h2 id="crate-dependency-graph"><a class="header" href="#crate-dependency-graph"
         Tokio[tokio]
         Hyper[hyper]
         Serde[serde]
-        Utoipa[utoipa]
         Validator[validator]
         Tungstenite[tungstenite]
         Tera[tera]
@@ -313,8 +312,8 @@ <h2 id="crate-dependency-graph"><a class="header" href="#crate-dependency-graph"
     Core --&gt; Tokio
     Core --&gt; Hyper
     Core --&gt; Serde
-    OpenAPI --&gt; Utoipa
-    Validate --&gt; Validator
+    OpenAPI --&gt; Serde
+    Validate -.-&gt;|legacy optional| Validator
     Toon --&gt; Serde
     WS --&gt; Tungstenite
     View --&gt; Tera
diff --git a/cookbook/concepts/handlers.html b/cookbook/concepts/handlers.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/concepts/index.html b/cookbook/concepts/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/concepts/performance.html b/cookbook/concepts/performance.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/concepts/testing.html b/cookbook/concepts/testing.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/cargo_rustapi.html b/cookbook/crates/cargo_rustapi.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/index.html b/cookbook/crates/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_core.html b/cookbook/crates/rustapi_core.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_extras.html b/cookbook/crates/rustapi_extras.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_jobs.html b/cookbook/crates/rustapi_jobs.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_macros.html b/cookbook/crates/rustapi_macros.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_openapi.html b/cookbook/crates/rustapi_openapi.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
@@ -185,7 +185,7 @@ <h1 id="rustapi-openapi-the-cartographer"><a class="header" href="#rustapi-opena
 <p><strong>Lens</strong>: “The Cartographer”
 <strong>Philosophy</strong>: “Documentation as Code.”</p>
 <h2 id="automatic-spec-generation"><a class="header" href="#automatic-spec-generation">Automatic Spec Generation</a></h2>
-<p>We believe that if documentation is manual, it is wrong. RustAPI uses <code>utoipa</code> to generate an OpenAPI 3.0 specification directly from your code.</p>
+<p>We believe that if documentation is manual, it is wrong. RustAPI uses a native OpenAPI generator to build the specification directly from your code.</p>
 <h2 id="the-schema-trait"><a class="header" href="#the-schema-trait">The <code>Schema</code> Trait</a></h2>
 <p>Any type that is part of your API (request or response) must implement <code>Schema</code>.</p>
 <pre class="playground"><code class="language-rust"><span class="boring">#![allow(unused)]
diff --git a/cookbook/crates/rustapi_testing.html b/cookbook/crates/rustapi_testing.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_toon.html b/cookbook/crates/rustapi_toon.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_validation.html b/cookbook/crates/rustapi_validation.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_view.html b/cookbook/crates/rustapi_view.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/crates/rustapi_ws.html b/cookbook/crates/rustapi_ws.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/getting_started/index.html b/cookbook/getting_started/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/getting_started/installation.html b/cookbook/getting_started/installation.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/getting_started/quickstart.html b/cookbook/getting_started/quickstart.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/getting_started/structure.html b/cookbook/getting_started/structure.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/index.html b/cookbook/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "searchindex-26942635.js";
+            window.path_to_searchindex_js = "searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="toc-54f2b124.js"></script>
diff --git a/cookbook/introduction.html b/cookbook/introduction.html
@@ -36,7 +36,7 @@
             const path_to_root = "";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "searchindex-26942635.js";
+            window.path_to_searchindex_js = "searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="toc-54f2b124.js"></script>
diff --git a/cookbook/learning/index.html b/cookbook/learning/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/print.html b/cookbook/print.html
@@ -37,7 +37,7 @@
             const path_to_root = "";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "searchindex-26942635.js";
+            window.path_to_searchindex_js = "searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="toc-54f2b124.js"></script>
@@ -582,7 +582,6 @@ <h2 id="crate-dependency-graph"><a class="header" href="#crate-dependency-graph"
         Tokio[tokio]
         Hyper[hyper]
         Serde[serde]
-        Utoipa[utoipa]
         Validator[validator]
         Tungstenite[tungstenite]
         Tera[tera]
@@ -601,8 +600,8 @@ <h2 id="crate-dependency-graph"><a class="header" href="#crate-dependency-graph"
     Core --&gt; Tokio
     Core --&gt; Hyper
     Core --&gt; Serde
-    OpenAPI --&gt; Utoipa
-    Validate --&gt; Validator
+    OpenAPI --&gt; Serde
+    Validate -.-&gt;|legacy optional| Validator
     Toon --&gt; Serde
     WS --&gt; Tungstenite
     View --&gt; Tera
@@ -1160,7 +1159,7 @@ <h1 id="rustapi-openapi-the-cartographer"><a class="header" href="#rustapi-opena
 <p><strong>Lens</strong>: “The Cartographer”
 <strong>Philosophy</strong>: “Documentation as Code.”</p>
 <h2 id="automatic-spec-generation"><a class="header" href="#automatic-spec-generation">Automatic Spec Generation</a></h2>
-<p>We believe that if documentation is manual, it is wrong. RustAPI uses <code>utoipa</code> to generate an OpenAPI 3.0 specification directly from your code.</p>
+<p>We believe that if documentation is manual, it is wrong. RustAPI uses a native OpenAPI generator to build the specification directly from your code.</p>
 <h2 id="the-schema-trait"><a class="header" href="#the-schema-trait">The <code>Schema</code> Trait</a></h2>
 <p>Any type that is part of your API (request or response) must implement <code>Schema</code>.</p>
 <pre class="playground"><code class="language-rust"><span class="boring">#![allow(unused)]
@@ -3290,7 +3289,7 @@ <h2 id="1-missing-schema-derive-on-extractor-types"><a class="header" href="#1-m
 <li>The <code>Schema</code> derive macro implements this trait for you</li>
 </ul>
 <hr>
-<h2 id="2-dont-use-utoipa-directly"><a class="header" href="#2-dont-use-utoipa-directly">2. Don’t Use <code>utoipa</code> Directly</a></h2>
+<h2 id="2-dont-add-external-openapi-generators-directly"><a class="header" href="#2-dont-add-external-openapi-generators-directly">2. Don’t Add External OpenAPI Generators Directly</a></h2>
 <p><strong>Wrong:</strong></p>
 <pre><code class="language-toml">[dependencies]
 utoipa = "4.2"  # ❌ Don't add this
@@ -3303,7 +3302,7 @@ <h2 id="2-dont-use-utoipa-directly"><a class="header" href="#2-dont-use-utoipa-d
 <p><strong>Why?</strong></p>
 <ul>
 <li>RustAPI has its own OpenAPI implementation (<code>rustapi-openapi</code>)</li>
-<li>Adding <code>utoipa</code> directly can cause dependency conflicts</li>
+<li>External OpenAPI derive/macros are not part of RustAPI’s public API surface</li>
 <li>The <code>Schema</code> derive macro is already in <code>rustapi_rs::prelude::*</code></li>
 </ul>
 <hr>
@@ -3601,7 +3600,7 @@ <h2 id="quick-checklist-adding-a-new-handler"><a class="header" href="#quick-che
 <h2 id="the-golden-rules"><a class="header" href="#the-golden-rules">The Golden Rules</a></h2>
 <ol>
 <li><strong>Add <code>Schema</code> derive</strong> to any struct used with extractors or responses</li>
-<li><strong>Don’t use <code>utoipa</code></strong> directly - <code>rustapi-openapi</code> is already included</li>
+<li><strong>Don’t add external OpenAPI crates</strong> directly - <code>rustapi-openapi</code> is already included</li>
 <li><strong>Import from <code>rustapi_rs</code></strong> only - never use internal crates directly</li>
 <li><strong>Use <code>RustApi::auto()</code></strong> with handler macros for automatic route discovery</li>
 </ol>
diff --git a/cookbook/recipes/crud_resource.html b/cookbook/recipes/crud_resource.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/csrf_protection.html b/cookbook/recipes/csrf_protection.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/custom_middleware.html b/cookbook/recipes/custom_middleware.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/db_integration.html b/cookbook/recipes/db_integration.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/deployment.html b/cookbook/recipes/deployment.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/file_uploads.html b/cookbook/recipes/file_uploads.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/high_performance.html b/cookbook/recipes/high_performance.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/http3_quic.html b/cookbook/recipes/http3_quic.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/index.html b/cookbook/recipes/index.html
@@ -36,7 +36,7 @@
             const path_to_root = "../";
             const default_light_theme = "light";
             const default_dark_theme = "navy";
-            window.path_to_searchindex_js = "../searchindex-26942635.js";
+            window.path_to_searchindex_js = "../searchindex-cdfa44bb.js";
         </script>
         <!-- Start loading toc.js asap -->
         <script src="../toc-54f2b124.js"></script>
diff --git a/cookbook/recipes/jwt_auth.html b/cookbook/recipes/jwt_auth.html
diff --git a/cookbook/recipes/replay.html b/cookbook/recipes/replay.html
diff --git a/cookbook/recipes/resilience.html b/cookbook/recipes/resilience.html
diff --git a/cookbook/recipes/status_page.html b/cookbook/recipes/status_page.html
diff --git a/cookbook/recipes/websockets.html b/cookbook/recipes/websockets.html
diff --git a/cookbook/searcher-c2a407aa.js b/cookbook/searcher-c2a407aa.js
diff --git a/cookbook/searchindex-26942635.js b/cookbook/searchindex-26942635.js
diff --git a/cookbook/searchindex-cdfa44bb.js b/cookbook/searchindex-cdfa44bb.js
diff --git a/cookbook/troubleshooting.html b/cookbook/troubleshooting.html
