Deployed b1e6533 with MkDocs version: 1.6.1

errors/index.html

@@ -1066,10 +1066,18 @@ <h2 id="missingdecodererror"><code>MissingDecoderError</code><a class="headerlin
 <li><code>model: type</code> — the <code>response_model=</code> value that wasn't claimed.</li>
 <li><code>registered_names: tuple[str, ...]</code> — class names of the registered decoders that all rejected the model. Empty tuple means no decoders were registered.</li>
 </ul>
-<p>Corrective action depends on the message hint:</p>
+<p>The message reads <code>no decoder for response_model=&lt;Model&gt;: &lt;hint&gt;</code>, and the corrective action depends on the hint. The two hints, verbatim:</p>
 <ul>
-<li><code>no decoders registered. Install pip install httpware[pydantic] or pip install httpware[msgspec], or pass decoders=[...] explicitly.</code> — install an extra or pass an explicit decoder list.</li>
-<li><code>registered decoders (PydanticDecoder + MsgspecDecoder) all rejected it.</code> — your <code>response_model</code> type is exotic enough that neither built-in claims it. Pass a custom <code>ResponseDecoder</code> via <code>decoders=[...]</code>.</li>
+<li>
+<p><strong>No decoders were registered</strong> — install an extra or pass an explicit decoder list:</p>
+<div class="highlight"><pre><span></span><code>no decoders registered. Install `pip install httpware[pydantic]` or `pip install httpware[msgspec]`, or pass decoders=[...] explicitly.
+</code></pre></div>
+</li>
+<li>
+<p><strong>Registered decoders all rejected the model</strong> — your <code>response_model</code> type is exotic enough that neither built-in claims it; pass a custom <code>ResponseDecoder</code> via <code>decoders=[...]</code>:</p>
+<div class="highlight"><pre><span></span><code>registered decoders (PydanticDecoder + MsgspecDecoder) all rejected it. Pass a custom decoder via decoders=[...].
+</code></pre></div>
+</li>
 </ul>
 <p>Unlike <code>DecodeError</code>, this error fires <em>before</em> the HTTP request — no traffic is sent.</p>
 <h2 id="see-also">See also<a class="headerlink" href="#see-also" title="Permanent link">&para;</a></h2>

index.html

@@ -976,17 +976,21 @@ <h3 id="decoder-dispatch">Decoder dispatch<a class="headerlink" href="#decoder-d
 the first decoder whose <code>can_decode(model)</code> returns <code>True</code>. Both built-in
 decoders claim broadly within their library; the ordering encodes your
 preference for shared shapes (<code>dict</code>, <code>list[Foo]</code>, dataclasses, primitives):</p>
-<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="c1"># pydantic-first (the default when both extras are installed):</span>
-<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="c1"># - BaseModel  -&gt; pydantic</span>
-<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="c1"># - Struct     -&gt; msgspec</span>
-<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="c1"># - dict, list -&gt; pydantic (first in list)</span>
-<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="n">AsyncClient</span><span class="p">(</span><span class="n">decoders</span><span class="o">=</span><span class="p">[</span><span class="n">PydanticDecoder</span><span class="p">(),</span> <span class="n">MsgspecDecoder</span><span class="p">()])</span>
-<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>
-<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="c1"># msgspec-first — same native routing, but shared shapes go to msgspec:</span>
-<a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="c1"># - BaseModel  -&gt; pydantic</span>
-<a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="c1"># - Struct     -&gt; msgspec</span>
-<a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="c1"># - dict, list -&gt; msgspec</span>
-<a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="n">AsyncClient</span><span class="p">(</span><span class="n">decoders</span><span class="o">=</span><span class="p">[</span><span class="n">MsgspecDecoder</span><span class="p">(),</span> <span class="n">PydanticDecoder</span><span class="p">()])</span>
+<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">httpware</span><span class="w"> </span><span class="kn">import</span> <span class="n">AsyncClient</span>
+<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">httpware.decoders.msgspec</span><span class="w"> </span><span class="kn">import</span> <span class="n">MsgspecDecoder</span>
+<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="kn">from</span><span class="w"> </span><span class="nn">httpware.decoders.pydantic</span><span class="w"> </span><span class="kn">import</span> <span class="n">PydanticDecoder</span>
+<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a>
+<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="c1"># pydantic-first (the default when both extras are installed):</span>
+<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a><span class="c1"># - BaseModel  -&gt; pydantic</span>
+<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="c1"># - Struct     -&gt; msgspec</span>
+<a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="c1"># - dict, list -&gt; pydantic (first in list)</span>
+<a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="n">AsyncClient</span><span class="p">(</span><span class="n">decoders</span><span class="o">=</span><span class="p">[</span><span class="n">PydanticDecoder</span><span class="p">(),</span> <span class="n">MsgspecDecoder</span><span class="p">()])</span>
+<a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a>
+<a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></a><span class="c1"># msgspec-first — same native routing, but shared shapes go to msgspec:</span>
+<a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a><span class="c1"># - BaseModel  -&gt; pydantic</span>
+<a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="c1"># - Struct     -&gt; msgspec</span>
+<a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></a><span class="c1"># - dict, list -&gt; msgspec</span>
+<a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a><span class="n">AsyncClient</span><span class="p">(</span><span class="n">decoders</span><span class="o">=</span><span class="p">[</span><span class="n">MsgspecDecoder</span><span class="p">(),</span> <span class="n">PydanticDecoder</span><span class="p">()])</span>
 </code></pre></div>
 <p>If no registered decoder claims your <code>response_model</code>, the call raises
 <code>MissingDecoderError</code> <em>before</em> the HTTP request — see the

search/search_index.json

@@ -2,38 +2,38 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://httpware.modern-python.org/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/errors/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/middleware/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/resilience/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/testing/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/dev/contributing/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/recipes/link-header-pagination/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/recipes/modern-di/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
     <url>
          <loc>https://httpware.modern-python.org/recipes/phase-decorator-patterns/</loc>
-         <lastmod>2026-06-10</lastmod>
+         <lastmod>2026-06-13</lastmod>
     </url>
 </urlset>