From 883d34fdd7b36c3943a54cd7acbdfbd66dafcca7 Mon Sep 17 00:00:00 2001
From: Igor Benav <igor.magalhaes.r@gmail.com>
Date: Wed, 8 Jan 2025 23:42:52 -0300
Subject: [PATCH] Deployed 1015bfe with MkDocs version: 1.5.3

---
 404.html                                 |   68 +-
 advanced/crud/index.html                 |   68 +-
 advanced/endpoint/index.html             |   68 +-
 advanced/joins/index.html                |   68 +-
 advanced/overview/index.html             |   68 +-
 api/crud_router/index.html               | 1144 +--
 api/endpoint_creator/index.html          | 2210 +++---
 api/fastcrud/index.html                  | 8474 +++++++++++-----------
 api/overview/index.html                  |   68 +-
 api/paginated/index.html                 |   70 +-
 changelog/index.html                     |   68 +-
 community/CODE_OF_CONDUCT/index.html     |   70 +-
 community/CONTRIBUTING/index.html        |   70 +-
 community/LICENSE/index.html             |   68 +-
 community/overview/index.html            |   70 +-
 community/showcase_submission/index.html | 1420 ++++
 index.html                               |   68 +-
 installing/index.html                    |   68 +-
 quick-start/index.html                   |  297 +-
 search/search_index.json                 |    2 +-
 showcase/index.html                      | 1389 ++++
 sitemap.xml                              |   52 +-
 sitemap.xml.gz                           |  Bin 393 -> 414 bytes
 sqlmodel/index.html                      |   68 +-
 usage/crud/index.html                    |   68 +-
 usage/endpoint/index.html                |   68 +-
 usage/overview/index.html                |   68 +-
 27 files changed, 10357 insertions(+), 5863 deletions(-)
 create mode 100644 community/showcase_submission/index.html
 create mode 100644 showcase/index.html

diff --git a/404.html b/404.html
index 0de86de..820d10b 100644
--- a/404.html
+++ b/404.html
@@ -338,6 +338,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="/igorbenav/fastcrud/showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -923,6 +940,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="/igorbenav/fastcrud/showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -933,6 +970,8 @@
       
         
       
+        
+      
         
       
     
@@ -947,10 +986,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -961,8 +1000,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1016,6 +1055,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="/igorbenav/fastcrud/community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="/igorbenav/fastcrud/community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/advanced/crud/index.html b/advanced/crud/index.html
index 61b6ba0..8f650a9 100644
--- a/advanced/crud/index.html
+++ b/advanced/crud/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1296,6 +1313,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1306,6 +1343,8 @@
       
         
       
+        
+      
         
       
     
@@ -1320,10 +1359,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1334,8 +1373,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1389,6 +1428,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/advanced/endpoint/index.html b/advanced/endpoint/index.html
index 629ba68..c6cca9a 100644
--- a/advanced/endpoint/index.html
+++ b/advanced/endpoint/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1266,6 +1283,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1276,6 +1313,8 @@
       
         
       
+        
+      
         
       
     
@@ -1290,10 +1329,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1304,8 +1343,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1359,6 +1398,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/advanced/joins/index.html b/advanced/joins/index.html
index 3fb135f..60d6424 100644
--- a/advanced/joins/index.html
+++ b/advanced/joins/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1224,6 +1241,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1234,6 +1271,8 @@
       
         
       
+        
+      
         
       
     
@@ -1248,10 +1287,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1262,8 +1301,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1317,6 +1356,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/advanced/overview/index.html b/advanced/overview/index.html
index 07fb0d0..38278cf 100644
--- a/advanced/overview/index.html
+++ b/advanced/overview/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1074,6 +1091,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1084,6 +1121,8 @@
       
         
       
+        
+      
         
       
     
@@ -1098,10 +1137,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1112,8 +1151,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1167,6 +1206,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/api/crud_router/index.html b/api/crud_router/index.html
index ea946e6..0e7df5e 100644
--- a/api/crud_router/index.html
+++ b/api/crud_router/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -996,6 +1013,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1006,6 +1043,8 @@
       
         
       
+        
+      
         
       
     
@@ -1020,10 +1059,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1034,8 +1073,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1089,6 +1128,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
@@ -1570,6 +1630,20 @@ <h2 id="function-definition">Function Definition<a class="headerlink" href="#fun
                 <code>None</code>
           </td>
         </tr>
+        <tr>
+          <td><code>select_schema</code></td>
+          <td>
+                <code><span title="typing.Optional">Optional</span>[<span title="typing.Type">Type</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <p>Optional Pydantic schema for selecting an item.</p>
+            </div>
+          </td>
+          <td>
+                <code>None</code>
+          </td>
+        </tr>
     </tbody>
   </table>
 
@@ -2253,8 +2327,7 @@ <h2 id="function-definition">Function Definition<a class="headerlink" href="#fun
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/endpoint/crud_router.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-17"> 17</a></span>
-<span class="normal"><a href="#__codelineno-0-18"> 18</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-18"> 18</a></span>
 <span class="normal"><a href="#__codelineno-0-19"> 19</a></span>
 <span class="normal"><a href="#__codelineno-0-20"> 20</a></span>
 <span class="normal"><a href="#__codelineno-0-21"> 21</a></span>
@@ -2793,547 +2866,554 @@ <h2 id="function-definition">Function Definition<a class="headerlink" href="#fun
 <span class="normal"><a href="#__codelineno-0-554">554</a></span>
 <span class="normal"><a href="#__codelineno-0-555">555</a></span>
 <span class="normal"><a href="#__codelineno-0-556">556</a></span>
-<span class="normal"><a href="#__codelineno-0-557">557</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17"></a><span class="k">def</span> <span class="nf">crud_router</span><span class="p">(</span>
-</span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18"></a>    <span class="n">session</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
-</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19"></a>    <span class="n">model</span><span class="p">:</span> <span class="n">ModelType</span><span class="p">,</span>
-</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20"></a>    <span class="n">create_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">CreateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21"></a>    <span class="n">update_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22"></a>    <span class="n">crud</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">FastCRUD</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23"></a>    <span class="n">delete_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">DeleteSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24"></a>    <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25"></a>    <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26"></a>    <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27"></a>    <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28"></a>    <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29"></a>    <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30"></a>    <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31"></a>    <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32"></a>    <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33"></a>    <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34"></a>    <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35"></a>    <span class="n">endpoint_creator</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">EndpointCreator</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36"></a>    <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37"></a>    <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a>    <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39"></a>    <span class="n">endpoint_names</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40"></a>    <span class="n">filter_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">FilterConfig</span><span class="p">,</span> <span class="nb">dict</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">APIRouter</span><span class="p">:</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="sd">    Creates and configures a FastAPI router with CRUD endpoints for a given model.</span>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44"></a>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="sd">    This utility function streamlines the process of setting up a router for CRUD operations,</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a><span class="sd">    using a custom `EndpointCreator` if provided, and managing dependency injections as well</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47"></a><span class="sd">    as selective method inclusions or exclusions.</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50"></a><span class="sd">        session: The SQLAlchemy async session.</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="sd">        model: The SQLAlchemy model.</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a><span class="sd">        create_schema: Pydantic schema for creating an item.</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a><span class="sd">        update_schema: Pydantic schema for updating an item.</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a><span class="sd">        crud: An optional `FastCRUD` instance. If not provided, uses `FastCRUD(model)`.</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a><span class="sd">        delete_schema: Optional Pydantic schema for deleting an item.</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="sd">        path: Base path for the CRUD endpoints.</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a><span class="sd">        tags: Optional list of tags for grouping endpoints in the documentation.</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a><span class="sd">        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a><span class="sd">        create_deps: Optional list of functions to be injected as dependencies for the create endpoint.</span>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="sd">        read_deps: Optional list of functions to be injected as dependencies for the read endpoint.</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a><span class="sd">        read_multi_deps: Optional list of functions to be injected as dependencies for the read multiple items endpoint.</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a><span class="sd">        update_deps: Optional list of functions to be injected as dependencies for the update endpoint.</span>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a><span class="sd">        delete_deps: Optional list of functions to be injected as dependencies for the delete endpoint.</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64"></a><span class="sd">        db_delete_deps: Optional list of functions to be injected as dependencies for the hard delete endpoint.</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">        included_methods: Optional list of CRUD methods to include. If `None`, all methods are included.</span>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a><span class="sd">        deleted_methods: Optional list of CRUD methods to exclude.</span>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67"></a><span class="sd">        endpoint_creator: Optional custom class derived from `EndpointCreator` for advanced customization.</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72"></a><span class="sd">                        (`&quot;create&quot;`, `&quot;read&quot;`, `&quot;update&quot;`, `&quot;delete&quot;`, `&quot;db_delete&quot;`, `&quot;read_multi&quot;`), and</span>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">                        values are the custom names to use. Unspecified operations will use default names.</span>
-</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74"></a><span class="sd">        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">        Configured `APIRouter` instance with the CRUD endpoints.</span>
+<span class="normal"><a href="#__codelineno-0-557">557</a></span>
+<span class="normal"><a href="#__codelineno-0-558">558</a></span>
+<span class="normal"><a href="#__codelineno-0-559">559</a></span>
+<span class="normal"><a href="#__codelineno-0-560">560</a></span>
+<span class="normal"><a href="#__codelineno-0-561">561</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18"></a><span class="k">def</span> <span class="nf">crud_router</span><span class="p">(</span>
+</span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19"></a>    <span class="n">session</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
+</span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20"></a>    <span class="n">model</span><span class="p">:</span> <span class="n">ModelType</span><span class="p">,</span>
+</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21"></a>    <span class="n">create_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">CreateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22"></a>    <span class="n">update_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23"></a>    <span class="n">crud</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">FastCRUD</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24"></a>    <span class="n">delete_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">DeleteSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25"></a>    <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26"></a>    <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27"></a>    <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28"></a>    <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29"></a>    <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30"></a>    <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31"></a>    <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32"></a>    <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33"></a>    <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-34"><a id="__codelineno-0-34" name="__codelineno-0-34"></a>    <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35"></a>    <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36"></a>    <span class="n">endpoint_creator</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">EndpointCreator</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37"></a>    <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
+</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a>    <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39"></a>    <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40"></a>    <span class="n">endpoint_names</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41"></a>    <span class="n">filter_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">FilterConfig</span><span class="p">,</span> <span class="nb">dict</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42"></a>    <span class="n">select_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">APIRouter</span><span class="p">:</span>
+</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="sd">    Creates and configures a FastAPI router with CRUD endpoints for a given model.</span>
+</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a>
+</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47"></a><span class="sd">    This utility function streamlines the process of setting up a router for CRUD operations,</span>
+</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="sd">    using a custom `EndpointCreator` if provided, and managing dependency injections as well</span>
+</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49"></a><span class="sd">    as selective method inclusions or exclusions.</span>
+</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50"></a>
+</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a><span class="sd">        session: The SQLAlchemy async session.</span>
+</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a><span class="sd">        model: The SQLAlchemy model.</span>
+</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a><span class="sd">        create_schema: Pydantic schema for creating an item.</span>
+</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a><span class="sd">        update_schema: Pydantic schema for updating an item.</span>
+</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="sd">        crud: An optional `FastCRUD` instance. If not provided, uses `FastCRUD(model)`.</span>
+</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a><span class="sd">        delete_schema: Optional Pydantic schema for deleting an item.</span>
+</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a><span class="sd">        path: Base path for the CRUD endpoints.</span>
+</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a><span class="sd">        tags: Optional list of tags for grouping endpoints in the documentation.</span>
+</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="sd">        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.</span>
+</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a><span class="sd">        create_deps: Optional list of functions to be injected as dependencies for the create endpoint.</span>
+</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a><span class="sd">        read_deps: Optional list of functions to be injected as dependencies for the read endpoint.</span>
+</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a><span class="sd">        read_multi_deps: Optional list of functions to be injected as dependencies for the read multiple items endpoint.</span>
+</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64"></a><span class="sd">        update_deps: Optional list of functions to be injected as dependencies for the update endpoint.</span>
+</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">        delete_deps: Optional list of functions to be injected as dependencies for the delete endpoint.</span>
+</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a><span class="sd">        db_delete_deps: Optional list of functions to be injected as dependencies for the hard delete endpoint.</span>
+</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67"></a><span class="sd">        included_methods: Optional list of CRUD methods to include. If `None`, all methods are included.</span>
+</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a><span class="sd">        deleted_methods: Optional list of CRUD methods to exclude.</span>
+</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a><span class="sd">        endpoint_creator: Optional custom class derived from `EndpointCreator` for advanced customization.</span>
+</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
+</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
+</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
+</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types</span>
+</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74"></a><span class="sd">                        (`&quot;create&quot;`, `&quot;read&quot;`, `&quot;update&quot;`, `&quot;delete&quot;`, `&quot;db_delete&quot;`, `&quot;read_multi&quot;`), and</span>
+</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a><span class="sd">                        values are the custom names to use. Unspecified operations will use default names.</span>
+</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a><span class="sd">        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.</span>
+</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">        select_schema: Optional Pydantic schema for selecting an item.</span>
 </span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78"></a>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
+</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">        Configured `APIRouter` instance with the CRUD endpoints.</span>
 </span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81"></a>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">        ??? example &quot;Models and Schemas Used Below&quot;</span>
+</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
 </span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84"></a>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="sd">            ??? example &quot;`mymodel/model.py`&quot;</span>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a><span class="sd">                fastcrud/examples/mymodel/model.py:imports</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="sd">                fastcrud/examples/mymodel/model.py:model_simple</span>
+</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a><span class="sd">        ??? example &quot;Models and Schemas Used Below&quot;</span>
+</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a>
+</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a><span class="sd">            ??? example &quot;`mymodel/model.py`&quot;</span>
+</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a>
+</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">                ```</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a><span class="sd">            ??? example &quot;`mymodel/schemas.py`&quot;</span>
-</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a>
-</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:imports</span>
-</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:createschema</span>
-</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:updateschema</span>
-</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:deleteschema</span>
-</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a><span class="sd">                ```</span>
-</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a>
-</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a><span class="sd">            ---</span>
-</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a>
-</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a><span class="sd">            ??? example &quot;`customer/model.py`&quot;</span>
-</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a>
-</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="sd">                fastcrud/examples/customer/model.py:imports</span>
-</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="sd">                fastcrud/examples/customer/model.py:model</span>
+</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">                fastcrud/examples/mymodel/model.py:imports</span>
+</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a><span class="sd">                fastcrud/examples/mymodel/model.py:model_simple</span>
+</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="sd">                ```</span>
+</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a>
+</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a><span class="sd">            ??? example &quot;`mymodel/schemas.py`&quot;</span>
+</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a>
+</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:imports</span>
+</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:createschema</span>
+</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:updateschema</span>
+</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="sd">                fastcrud/examples/mymodel/schemas.py:deleteschema</span>
+</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a><span class="sd">                ```</span>
+</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a>
+</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a><span class="sd">            ---</span>
+</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a>
+</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110"></a><span class="sd">            ??? example &quot;`customer/model.py`&quot;</span>
+</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a>
+</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">                ```</span>
-</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115"></a>
-</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">            ??? example &quot;`customer/schemas.py`&quot;</span>
-</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a>
-</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a><span class="sd">                fastcrud/examples/customer/schemas.py:imports</span>
-</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a><span class="sd">                fastcrud/examples/customer/schemas.py:createschema</span>
-</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">                fastcrud/examples/customer/schemas.py:readschema</span>
-</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a><span class="sd">                fastcrud/examples/customer/schemas.py:updateschema</span>
-</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a><span class="sd">                fastcrud/examples/customer/schemas.py:deleteschema</span>
-</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a><span class="sd">                ```</span>
-</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a>
-</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a><span class="sd">            ??? example &quot;`product/model.py`&quot;</span>
-</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a>
-</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a><span class="sd">                fastcrud/examples/product/model.py:imports</span>
-</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a><span class="sd">                fastcrud/examples/product/model.py:model</span>
+</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">                fastcrud/examples/customer/model.py:imports</span>
+</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115"></a><span class="sd">                fastcrud/examples/customer/model.py:model</span>
+</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a><span class="sd">                ```</span>
+</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a>
+</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a><span class="sd">            ??? example &quot;`customer/schemas.py`&quot;</span>
+</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a>
+</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a><span class="sd">                fastcrud/examples/customer/schemas.py:imports</span>
+</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a><span class="sd">                fastcrud/examples/customer/schemas.py:createschema</span>
+</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">                fastcrud/examples/customer/schemas.py:readschema</span>
+</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a><span class="sd">                fastcrud/examples/customer/schemas.py:updateschema</span>
+</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a><span class="sd">                fastcrud/examples/customer/schemas.py:deleteschema</span>
+</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a><span class="sd">                ```</span>
+</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a>
+</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">            ??? example &quot;`product/model.py`&quot;</span>
+</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a>
+</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a><span class="sd">                ```</span>
-</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a>
-</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a><span class="sd">            ??? example &quot;`product/schemas.py`&quot;</span>
-</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a>
-</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="sd">                fastcrud/examples/product/schemas.py:imports</span>
-</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">                fastcrud/examples/product/schemas.py:createschema</span>
-</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">                fastcrud/examples/product/schemas.py:readschema</span>
-</span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144"></a><span class="sd">                fastcrud/examples/product/schemas.py:updateschema</span>
-</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">                fastcrud/examples/product/schemas.py:deleteschema</span>
-</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">                ```</span>
-</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a>
-</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">            ??? example &quot;`order/model.py`&quot;</span>
-</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a>
-</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">                fastcrud/examples/order/model.py:imports</span>
-</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">                fastcrud/examples/order/model.py:model</span>
+</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a><span class="sd">                fastcrud/examples/product/model.py:imports</span>
+</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a><span class="sd">                fastcrud/examples/product/model.py:model</span>
+</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="sd">                ```</span>
+</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a>
+</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">            ??? example &quot;`product/schemas.py`&quot;</span>
+</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a>
+</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144"></a><span class="sd">                fastcrud/examples/product/schemas.py:imports</span>
+</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">                fastcrud/examples/product/schemas.py:createschema</span>
+</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">                fastcrud/examples/product/schemas.py:readschema</span>
+</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">                fastcrud/examples/product/schemas.py:updateschema</span>
+</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="sd">                fastcrud/examples/product/schemas.py:deleteschema</span>
+</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">                ```</span>
+</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a>
+</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">            ??? example &quot;`order/model.py`&quot;</span>
+</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a>
+</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="sd">                ```</span>
-</span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157"></a>
-</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a><span class="sd">            ??? example &quot;`order/schemas.py`&quot;</span>
-</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a>
-</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a><span class="sd">                fastcrud/examples/order/schemas.py:imports</span>
-</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">                fastcrud/examples/order/schemas.py:createschema</span>
-</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a><span class="sd">                fastcrud/examples/order/schemas.py:readschema</span>
-</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">                fastcrud/examples/order/schemas.py:updateschema</span>
-</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a><span class="sd">                fastcrud/examples/order/schemas.py:deleteschema</span>
-</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a><span class="sd">                ```</span>
-</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a>
-</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="sd">            ---</span>
-</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a>
-</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="sd">            ??? example &quot;`tier/model.py`&quot;</span>
-</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a>
-</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a><span class="sd">                fastcrud/examples/tier/model.py:imports</span>
-</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a><span class="sd">                fastcrud/examples/tier/model.py:model</span>
+</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="sd">                fastcrud/examples/order/model.py:imports</span>
+</span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157"></a><span class="sd">                fastcrud/examples/order/model.py:model</span>
+</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a><span class="sd">                ```</span>
+</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a>
+</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a><span class="sd">            ??? example &quot;`order/schemas.py`&quot;</span>
+</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a>
+</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">                fastcrud/examples/order/schemas.py:imports</span>
+</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a><span class="sd">                fastcrud/examples/order/schemas.py:createschema</span>
+</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">                fastcrud/examples/order/schemas.py:readschema</span>
+</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a><span class="sd">                fastcrud/examples/order/schemas.py:updateschema</span>
+</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a><span class="sd">                fastcrud/examples/order/schemas.py:deleteschema</span>
+</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="sd">                ```</span>
+</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a>
+</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a><span class="sd">            ---</span>
+</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a>
+</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="sd">            ??? example &quot;`tier/model.py`&quot;</span>
+</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a>
+</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a><span class="sd">                ```</span>
-</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a>
-</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a><span class="sd">            ??? example &quot;`tier/schemas.py`&quot;</span>
-</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a>
-</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a><span class="sd">                fastcrud/examples/tier/schemas.py:imports</span>
-</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a><span class="sd">                fastcrud/examples/tier/schemas.py:readschema</span>
+</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a><span class="sd">                fastcrud/examples/tier/model.py:imports</span>
+</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a><span class="sd">                fastcrud/examples/tier/model.py:model</span>
+</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a><span class="sd">                ```</span>
+</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a>
+</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">            ??? example &quot;`tier/schemas.py`&quot;</span>
+</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a>
+</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">                ```</span>
-</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a>
-</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">            ??? example &quot;`department/model.py`&quot;</span>
-</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a>
-</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a><span class="sd">                fastcrud/examples/department/model.py:imports</span>
-</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">                fastcrud/examples/department/model.py:model</span>
+</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">                fastcrud/examples/tier/schemas.py:imports</span>
+</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a><span class="sd">                fastcrud/examples/tier/schemas.py:readschema</span>
+</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a><span class="sd">                ```</span>
+</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a>
+</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">            ??? example &quot;`department/model.py`&quot;</span>
+</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a>
+</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">                ```</span>
-</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a>
-</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">            ??? example &quot;`department/schemas.py`&quot;</span>
-</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a>
-</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">                fastcrud/examples/department/schemas.py:imports</span>
-</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">                fastcrud/examples/department/schemas.py:readschema</span>
+</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">                fastcrud/examples/department/model.py:imports</span>
+</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">                fastcrud/examples/department/model.py:model</span>
+</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">                ```</span>
+</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a>
+</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">            ??? example &quot;`department/schemas.py`&quot;</span>
+</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a>
+</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a><span class="sd">                ```</span>
-</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a>
-</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">            ??? example &quot;`user/model.py`&quot;</span>
-</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a>
-</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a><span class="sd">                fastcrud/examples/user/model.py:imports</span>
-</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">                fastcrud/examples/user/model.py:model</span>
+</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a><span class="sd">                fastcrud/examples/department/schemas.py:imports</span>
+</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">                fastcrud/examples/department/schemas.py:readschema</span>
+</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a><span class="sd">                ```</span>
+</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a>
+</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a><span class="sd">            ??? example &quot;`user/model.py`&quot;</span>
+</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a>
+</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd">                ```</span>
-</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a>
-</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">            ??? example &quot;`user/schemas.py`&quot;</span>
-</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a>
-</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd">                fastcrud/examples/user/schemas.py:imports</span>
-</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">                fastcrud/examples/user/schemas.py:createschema</span>
-</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd">                fastcrud/examples/user/schemas.py:readschema</span>
-</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">                fastcrud/examples/user/schemas.py:updateschema</span>
-</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd">                fastcrud/examples/user/schemas.py:deleteschema</span>
-</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd">                ```</span>
-</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a>
-</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd">            ??? example &quot;`story/model.py`&quot;</span>
-</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a>
-</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd">                fastcrud/examples/story/model.py:imports</span>
-</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">                fastcrud/examples/story/model.py:model</span>
+</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd">                fastcrud/examples/user/model.py:imports</span>
+</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="sd">                fastcrud/examples/user/model.py:model</span>
+</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd">                ```</span>
+</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a>
+</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">            ??? example &quot;`user/schemas.py`&quot;</span>
+</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a>
+</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">                fastcrud/examples/user/schemas.py:imports</span>
+</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd">                fastcrud/examples/user/schemas.py:createschema</span>
+</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">                fastcrud/examples/user/schemas.py:readschema</span>
+</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd">                fastcrud/examples/user/schemas.py:updateschema</span>
+</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd">                fastcrud/examples/user/schemas.py:deleteschema</span>
+</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd">                ```</span>
+</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a>
+</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd">            ??? example &quot;`story/model.py`&quot;</span>
+</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a>
+</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">                ```</span>
-</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a>
-</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd">            ??? example &quot;`story/schemas.py`&quot;</span>
-</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a>
-</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a><span class="sd">                fastcrud/examples/story/schemas.py:imports</span>
-</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a><span class="sd">                fastcrud/examples/story/schemas.py:createschema</span>
-</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a><span class="sd">                fastcrud/examples/story/schemas.py:readschema</span>
-</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd">                fastcrud/examples/story/schemas.py:updateschema</span>
-</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="sd">                fastcrud/examples/story/schemas.py:deleteschema</span>
-</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a><span class="sd">                ```</span>
-</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a>
-</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a><span class="sd">            ??? example &quot;`task/model.py`&quot;</span>
-</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a>
-</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a><span class="sd">                fastcrud/examples/task/model.py:imports</span>
-</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a><span class="sd">                fastcrud/examples/task/model.py:model</span>
+</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">                fastcrud/examples/story/model.py:imports</span>
+</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a><span class="sd">                fastcrud/examples/story/model.py:model</span>
+</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a><span class="sd">                ```</span>
+</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a>
+</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd">            ??? example &quot;`story/schemas.py`&quot;</span>
+</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a>
+</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd">                fastcrud/examples/story/schemas.py:imports</span>
+</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="sd">                fastcrud/examples/story/schemas.py:createschema</span>
+</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a><span class="sd">                fastcrud/examples/story/schemas.py:readschema</span>
+</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a><span class="sd">                fastcrud/examples/story/schemas.py:updateschema</span>
+</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a><span class="sd">                fastcrud/examples/story/schemas.py:deleteschema</span>
+</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a><span class="sd">                ```</span>
+</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a>
+</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a><span class="sd">            ??? example &quot;`task/model.py`&quot;</span>
+</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a>
+</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a><span class="sd">                ```python</span>
 </span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a><span class="sd">                ```</span>
-</span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258"></a>
-</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a><span class="sd">            ??? example &quot;`task/schemas.py`&quot;</span>
-</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a>
-</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a><span class="sd">                fastcrud/examples/task/schemas.py:imports</span>
-</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a><span class="sd">                fastcrud/examples/task/schemas.py:createschema</span>
-</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a><span class="sd">                fastcrud/examples/task/schemas.py:readschema</span>
-</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a><span class="sd">                fastcrud/examples/task/schemas.py:updateschema</span>
-</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a><span class="sd">                fastcrud/examples/task/schemas.py:deleteschema</span>
-</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a><span class="sd">                ```</span>
-</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a>
-</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a><span class="sd">        Basic Setup:</span>
-</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a>
-</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a><span class="sd">        mymodel_router = crud_router(</span>
-</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
-</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
-</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a><span class="sd">        )</span>
-</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a><span class="sd">        ```</span>
-</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a>
-</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a><span class="sd">        With Custom Dependencies:</span>
-</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a>
-</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a><span class="sd">        def get_current_user(token: str = Depends(oauth2_scheme)):</span>
-</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a><span class="sd">            # Implement user retrieval logic</span>
-</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a><span class="sd">            return ...</span>
-</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a>
-</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a><span class="sd">        user_router = crud_router(</span>
-</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a><span class="sd">            model=User,</span>
-</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a><span class="sd">            create_schema=CreateUserSchema,</span>
-</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a><span class="sd">            update_schema=UpdateUserSchema,</span>
-</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a><span class="sd">            read_deps=[get_current_user],</span>
-</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a><span class="sd">            update_deps=[get_current_user],</span>
-</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a><span class="sd">            path=&quot;/users&quot;,</span>
-</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a><span class="sd">            tags=[&quot;Users&quot;],</span>
-</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a><span class="sd">        )</span>
-</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a><span class="sd">        ```</span>
-</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a>
-</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a><span class="sd">        Adding Delete Endpoints:</span>
-</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a><span class="sd">        product_router = crud_router(</span>
-</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a><span class="sd">            model=Product,</span>
-</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a><span class="sd">            create_schema=CreateProductSchema,</span>
-</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a><span class="sd">            update_schema=UpdateProductSchema,</span>
-</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a><span class="sd">            delete_schema=DeleteProductSchema,</span>
-</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a><span class="sd">            path=&quot;/products&quot;,</span>
-</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a><span class="sd">            tags=[&quot;Products&quot;],</span>
-</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a><span class="sd">        )</span>
-</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a><span class="sd">        ```</span>
-</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a>
-</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a><span class="sd">        Customizing Path and Tags:</span>
-</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a><span class="sd">        OrderCRUD = FastCRUD[</span>
-</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a><span class="sd">            Order,</span>
-</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a><span class="sd">            CreateOrderSchema,</span>
-</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a><span class="sd">            UpdateOrderSchema,</span>
-</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a><span class="sd">            UpdateOrderSchema,</span>
-</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a><span class="sd">            DeleteOrderSchema,</span>
-</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a><span class="sd">        ]</span>
-</span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325"></a><span class="sd">        order_router = crud_router(</span>
-</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a><span class="sd">            model=Order,</span>
-</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a><span class="sd">            create_schema=CreateOrderSchema,</span>
-</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a><span class="sd">            update_schema=UpdateOrderSchema,</span>
-</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a><span class="sd">            crud=OrderCRUD(Order),</span>
-</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a><span class="sd">            path=&quot;/orders&quot;,</span>
-</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a><span class="sd">            tags=[&quot;Orders&quot;, &quot;Sales&quot;],</span>
-</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a><span class="sd">        )</span>
-</span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334"></a><span class="sd">        ```</span>
-</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a>
-</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a><span class="sd">        Integrating Multiple Models:</span>
-</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a><span class="sd">        ProductCRUD = FastCRUD[</span>
-</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a><span class="sd">            Product,</span>
-</span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340"></a><span class="sd">            CreateProductSchema,</span>
-</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a><span class="sd">            UpdateProductSchema,</span>
-</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a><span class="sd">            UpdateProductSchema,</span>
-</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a><span class="sd">            DeleteProductSchema,</span>
-</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a><span class="sd">        ]</span>
-</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a><span class="sd">        product_router = crud_router(</span>
-</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a><span class="sd">            model=Product,</span>
-</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a><span class="sd">            create_schema=CreateProductSchema,</span>
-</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a><span class="sd">            update_schema=UpdateProductSchema,</span>
-</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a><span class="sd">            crud=ProductCRUD(Product),</span>
-</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a><span class="sd">            path=&quot;/products&quot;,</span>
-</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a><span class="sd">            tags=[&quot;Inventory&quot;],</span>
-</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a><span class="sd">        )</span>
-</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a>
-</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a><span class="sd">        CustomerCRUD = FastCRUD[</span>
-</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a><span class="sd">            Customer,</span>
-</span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357"></a><span class="sd">            CreateCustomerSchema,</span>
-</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a><span class="sd">            UpdateCustomerSchema,</span>
-</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a><span class="sd">            UpdateCustomerSchema,</span>
-</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a><span class="sd">            DeleteCustomerSchema,</span>
-</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a><span class="sd">        ]</span>
-</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a><span class="sd">        customer_router = crud_router(</span>
-</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a><span class="sd">            model=Customer,</span>
-</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a><span class="sd">            create_schema=CreateCustomerSchema,</span>
-</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a><span class="sd">            update_schema=UpdateCustomerSchema,</span>
-</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a><span class="sd">            crud=CustomerCRUD(Customer),</span>
-</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a><span class="sd">            path=&quot;/customers&quot;,</span>
-</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a><span class="sd">            tags=[&quot;CRM&quot;],</span>
-</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a><span class="sd">        )</span>
-</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a><span class="sd">        ```</span>
-</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a>
-</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a><span class="sd">        With Selective CRUD Methods:</span>
-</span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374"></a>
-</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a><span class="sd">        MyModelCRUD = FastCRUD[</span>
-</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a><span class="sd">            MyModel,</span>
-</span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378"></a><span class="sd">            CreateMyModelSchema,</span>
-</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a><span class="sd">            UpdateMyModelSchema,</span>
-</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a><span class="sd">            UpdateMyModelSchema,</span>
-</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a><span class="sd">            DeleteMyModelSchema,</span>
-</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a><span class="sd">        ]</span>
-</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a><span class="sd">        # Only include &#39;create&#39; and &#39;read&#39; methods</span>
-</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a><span class="sd">        mymodel_router = crud_router(</span>
-</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a><span class="sd">            crud=MyModelCRUD(MyModel),</span>
-</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
-</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
-</span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
-</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a><span class="sd">        )</span>
-</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a><span class="sd">        ```</span>
-</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a>
-</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a><span class="sd">        Using a Custom `EndpointCreator`:</span>
-</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a>
-</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a><span class="sd">        class CustomEndpointCreator(EndpointCreator):</span>
-</span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400"></a><span class="sd">            def _custom_route(self):</span>
-</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a><span class="sd">                async def custom_endpoint():</span>
-</span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402"></a><span class="sd">                    # Custom endpoint logic</span>
-</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a><span class="sd">                    return {&quot;message&quot;: &quot;Custom route&quot;}</span>
-</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a>
-</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a><span class="sd">                return custom_endpoint</span>
-</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a>
-</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a><span class="sd">                async def add_routes_to_router(self, ...):</span>
-</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a><span class="sd">                    # First, add standard CRUD routes</span>
-</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a><span class="sd">                    super().add_routes_to_router(...)</span>
-</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a>
-</span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411"></a><span class="sd">                    # Now, add custom routes</span>
-</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a><span class="sd">                    self.router.add_api_route(</span>
-</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a><span class="sd">                        path=&quot;/custom&quot;,</span>
-</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">                        endpoint=self._custom_route(),</span>
-</span><span id="__span-0-415"><a id="__codelineno-0-415" name="__codelineno-0-415"></a><span class="sd">                        methods=[&quot;GET&quot;],</span>
-</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">                        tags=self.tags,</span>
-</span><span id="__span-0-417"><a id="__codelineno-0-417" name="__codelineno-0-417"></a><span class="sd">                        # Other parameters as needed</span>
-</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a><span class="sd">                    )</span>
-</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a>
-</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a><span class="sd">        MyModelCRUD = FastCRUD[</span>
-</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a><span class="sd">            MyModel,</span>
-</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a><span class="sd">            CreateMyModelSchema,</span>
-</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a><span class="sd">            UpdateMyModelSchema,</span>
-</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a><span class="sd">            UpdateMyModelSchema,</span>
-</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a><span class="sd">            DeleteMyModelSchema,</span>
-</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a><span class="sd">        ]</span>
-</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a><span class="sd">        mymodel_router = crud_router(</span>
-</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a><span class="sd">            crud=MyModelCRUD(MyModel),</span>
-</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
-</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
-</span><span id="__span-0-435"><a id="__codelineno-0-435" name="__codelineno-0-435"></a><span class="sd">            endpoint_creator=CustomEndpointCreator,</span>
-</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a><span class="sd">        )</span>
-</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a>
-</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a><span class="sd">        app.include_router(mymodel_router)</span>
-</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a><span class="sd">        ```</span>
+</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a><span class="sd">                fastcrud/examples/task/model.py:imports</span>
+</span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258"></a><span class="sd">                fastcrud/examples/task/model.py:model</span>
+</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a><span class="sd">                ```</span>
+</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a>
+</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a><span class="sd">            ??? example &quot;`task/schemas.py`&quot;</span>
+</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a>
+</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a><span class="sd">                fastcrud/examples/task/schemas.py:imports</span>
+</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a><span class="sd">                fastcrud/examples/task/schemas.py:createschema</span>
+</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a><span class="sd">                fastcrud/examples/task/schemas.py:readschema</span>
+</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a><span class="sd">                fastcrud/examples/task/schemas.py:updateschema</span>
+</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a><span class="sd">                fastcrud/examples/task/schemas.py:deleteschema</span>
+</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a><span class="sd">                ```</span>
+</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a>
+</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a><span class="sd">        Basic Setup:</span>
+</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a>
+</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a><span class="sd">        mymodel_router = crud_router(</span>
+</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
+</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
+</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a><span class="sd">        )</span>
+</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a><span class="sd">        ```</span>
+</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a>
+</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a><span class="sd">        With Custom Dependencies:</span>
+</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a>
+</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a><span class="sd">        def get_current_user(token: str = Depends(oauth2_scheme)):</span>
+</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a><span class="sd">            # Implement user retrieval logic</span>
+</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a><span class="sd">            return ...</span>
+</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a>
+</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a><span class="sd">        user_router = crud_router(</span>
+</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a><span class="sd">            model=User,</span>
+</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a><span class="sd">            create_schema=CreateUserSchema,</span>
+</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a><span class="sd">            update_schema=UpdateUserSchema,</span>
+</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a><span class="sd">            read_deps=[get_current_user],</span>
+</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a><span class="sd">            update_deps=[get_current_user],</span>
+</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a><span class="sd">            path=&quot;/users&quot;,</span>
+</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a><span class="sd">            tags=[&quot;Users&quot;],</span>
+</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a><span class="sd">        )</span>
+</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a><span class="sd">        ```</span>
+</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a>
+</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a><span class="sd">        Adding Delete Endpoints:</span>
+</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a><span class="sd">        product_router = crud_router(</span>
+</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a><span class="sd">            model=Product,</span>
+</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a><span class="sd">            create_schema=CreateProductSchema,</span>
+</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a><span class="sd">            update_schema=UpdateProductSchema,</span>
+</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a><span class="sd">            delete_schema=DeleteProductSchema,</span>
+</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a><span class="sd">            path=&quot;/products&quot;,</span>
+</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a><span class="sd">            tags=[&quot;Products&quot;],</span>
+</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a><span class="sd">        )</span>
+</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a><span class="sd">        ```</span>
+</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a>
+</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a><span class="sd">        Customizing Path and Tags:</span>
+</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a><span class="sd">        OrderCRUD = FastCRUD[</span>
+</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a><span class="sd">            Order,</span>
+</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a><span class="sd">            CreateOrderSchema,</span>
+</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a><span class="sd">            UpdateOrderSchema,</span>
+</span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325"></a><span class="sd">            UpdateOrderSchema,</span>
+</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a><span class="sd">            DeleteOrderSchema,</span>
+</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a><span class="sd">        ]</span>
+</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a><span class="sd">        order_router = crud_router(</span>
+</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a><span class="sd">            model=Order,</span>
+</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a><span class="sd">            create_schema=CreateOrderSchema,</span>
+</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a><span class="sd">            update_schema=UpdateOrderSchema,</span>
+</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a><span class="sd">            crud=OrderCRUD(Order),</span>
+</span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334"></a><span class="sd">            path=&quot;/orders&quot;,</span>
+</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a><span class="sd">            tags=[&quot;Orders&quot;, &quot;Sales&quot;],</span>
+</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a><span class="sd">        )</span>
+</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a><span class="sd">        ```</span>
+</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a>
+</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a><span class="sd">        Integrating Multiple Models:</span>
+</span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a><span class="sd">        ProductCRUD = FastCRUD[</span>
+</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a><span class="sd">            Product,</span>
+</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a><span class="sd">            CreateProductSchema,</span>
+</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a><span class="sd">            UpdateProductSchema,</span>
+</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a><span class="sd">            UpdateProductSchema,</span>
+</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a><span class="sd">            DeleteProductSchema,</span>
+</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a><span class="sd">        ]</span>
+</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a><span class="sd">        product_router = crud_router(</span>
+</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a><span class="sd">            model=Product,</span>
+</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a><span class="sd">            create_schema=CreateProductSchema,</span>
+</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a><span class="sd">            update_schema=UpdateProductSchema,</span>
+</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a><span class="sd">            crud=ProductCRUD(Product),</span>
+</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a><span class="sd">            path=&quot;/products&quot;,</span>
+</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a><span class="sd">            tags=[&quot;Inventory&quot;],</span>
+</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a><span class="sd">        )</span>
+</span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357"></a>
+</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a><span class="sd">        CustomerCRUD = FastCRUD[</span>
+</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a><span class="sd">            Customer,</span>
+</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a><span class="sd">            CreateCustomerSchema,</span>
+</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a><span class="sd">            UpdateCustomerSchema,</span>
+</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a><span class="sd">            UpdateCustomerSchema,</span>
+</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a><span class="sd">            DeleteCustomerSchema,</span>
+</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a><span class="sd">        ]</span>
+</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a><span class="sd">        customer_router = crud_router(</span>
+</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a><span class="sd">            model=Customer,</span>
+</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a><span class="sd">            create_schema=CreateCustomerSchema,</span>
+</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a><span class="sd">            update_schema=UpdateCustomerSchema,</span>
+</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a><span class="sd">            crud=CustomerCRUD(Customer),</span>
+</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a><span class="sd">            path=&quot;/customers&quot;,</span>
+</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a><span class="sd">            tags=[&quot;CRM&quot;],</span>
+</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a><span class="sd">        )</span>
+</span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374"></a><span class="sd">        ```</span>
+</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a>
+</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a><span class="sd">        With Selective CRUD Methods:</span>
+</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a>
+</span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a><span class="sd">        MyModelCRUD = FastCRUD[</span>
+</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a><span class="sd">            MyModel,</span>
+</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a><span class="sd">            CreateMyModelSchema,</span>
+</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a><span class="sd">            UpdateMyModelSchema,</span>
+</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a><span class="sd">            UpdateMyModelSchema,</span>
+</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a><span class="sd">            DeleteMyModelSchema,</span>
+</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a><span class="sd">        ]</span>
+</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a><span class="sd">        # Only include &#39;create&#39; and &#39;read&#39; methods</span>
+</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a><span class="sd">        mymodel_router = crud_router(</span>
+</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392"></a><span class="sd">            crud=MyModelCRUD(MyModel),</span>
+</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
+</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
+</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
+</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a><span class="sd">        )</span>
+</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a><span class="sd">        ```</span>
+</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a>
+</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a><span class="sd">        Using a Custom `EndpointCreator`:</span>
+</span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400"></a>
+</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402"></a><span class="sd">        class CustomEndpointCreator(EndpointCreator):</span>
+</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a><span class="sd">            def _custom_route(self):</span>
+</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a><span class="sd">                async def custom_endpoint():</span>
+</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a><span class="sd">                    # Custom endpoint logic</span>
+</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a><span class="sd">                    return {&quot;message&quot;: &quot;Custom route&quot;}</span>
+</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a>
+</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a><span class="sd">                return custom_endpoint</span>
+</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a>
+</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a><span class="sd">                async def add_routes_to_router(self, ...):</span>
+</span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411"></a><span class="sd">                    # First, add standard CRUD routes</span>
+</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a><span class="sd">                    super().add_routes_to_router(...)</span>
+</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a>
+</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">                    # Now, add custom routes</span>
+</span><span id="__span-0-415"><a id="__codelineno-0-415" name="__codelineno-0-415"></a><span class="sd">                    self.router.add_api_route(</span>
+</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">                        path=&quot;/custom&quot;,</span>
+</span><span id="__span-0-417"><a id="__codelineno-0-417" name="__codelineno-0-417"></a><span class="sd">                        endpoint=self._custom_route(),</span>
+</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a><span class="sd">                        methods=[&quot;GET&quot;],</span>
+</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a><span class="sd">                        tags=self.tags,</span>
+</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a><span class="sd">                        # Other parameters as needed</span>
+</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a><span class="sd">                    )</span>
+</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a>
+</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a><span class="sd">        MyModelCRUD = FastCRUD[</span>
+</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a><span class="sd">            MyModel,</span>
+</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a><span class="sd">            CreateMyModelSchema,</span>
+</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a><span class="sd">            UpdateMyModelSchema,</span>
+</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a><span class="sd">            UpdateMyModelSchema,</span>
+</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a><span class="sd">            DeleteMyModelSchema,</span>
+</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a><span class="sd">        ]</span>
+</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a><span class="sd">        mymodel_router = crud_router(</span>
+</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-435"><a id="__codelineno-0-435" name="__codelineno-0-435"></a><span class="sd">            crud=MyModelCRUD(MyModel),</span>
+</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
+</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
+</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a><span class="sd">            endpoint_creator=CustomEndpointCreator,</span>
+</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a><span class="sd">        )</span>
 </span><span id="__span-0-440"><a id="__codelineno-0-440" name="__codelineno-0-440"></a>
-</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a><span class="sd">        Customizing Endpoint Names:</span>
-</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a>
-</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a><span class="sd">        task_router = crud_router(</span>
-</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a><span class="sd">            model=Task,</span>
-</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a><span class="sd">            create_schema=CreateTaskSchema,</span>
-</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a><span class="sd">            update_schema=UpdateTaskSchema,</span>
-</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a><span class="sd">            path=&quot;/tasks&quot;,</span>
-</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a><span class="sd">            tags=[&quot;Task Management&quot;],</span>
-</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a><span class="sd">            endpoint_names={</span>
-</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a><span class="sd">                &quot;create&quot;: &quot;add_task&quot;,</span>
-</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a><span class="sd">                &quot;read&quot;: &quot;get_task&quot;,</span>
-</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a><span class="sd">                &quot;update&quot;: &quot;modify_task&quot;,</span>
-</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a><span class="sd">                &quot;delete&quot;: &quot;remove_task&quot;,</span>
-</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a><span class="sd">                &quot;db_delete&quot;: &quot;permanently_remove_task&quot;,</span>
-</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a><span class="sd">                &quot;read_multi&quot;: &quot;list_tasks&quot;,</span>
-</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a><span class="sd">            },</span>
-</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a><span class="sd">        )</span>
-</span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a><span class="sd">        ```</span>
-</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a>
-</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a><span class="sd">        Using `FilterConfig` with `dict`:</span>
-</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a>
-</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a><span class="sd">        from fastapi import FastAPI</span>
-</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a><span class="sd">        from fastcrud import crud_router</span>
-</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a>
-</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a><span class="sd">        from .database import async_session</span>
-</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a><span class="sd">        from .mymodel.model import MyModel</span>
-</span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
-</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a>
-</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a><span class="sd">        app = FastAPI()</span>
-</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>
-</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a><span class="sd">        mymodel_router = crud_router(</span>
-</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a><span class="sd">            filter_config=FilterConfig(filters={&quot;id&quot;: None, &quot;name&quot;: &quot;default&quot;}),</span>
-</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="sd">        )</span>
-</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
-</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">        app.include_router(mymodel_router, prefix=&quot;/mymodel&quot;)</span>
-</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>
-</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">        # Explanation:</span>
-</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
-</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
-</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
-</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
-</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">        ```</span>
-</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a>
-</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">        Using `FilterConfig` with keyword arguments:</span>
-</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>
-</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a><span class="sd">        from fastapi import FastAPI</span>
-</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a><span class="sd">        from fastcrud import crud_router</span>
-</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a>
-</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a><span class="sd">        from .database import async_session</span>
-</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a><span class="sd">        from .mymodel.model import MyModel</span>
-</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
-</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a>
-</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a><span class="sd">        app = FastAPI()</span>
-</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a>
-</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a><span class="sd">        mymodel_router = crud_router(</span>
-</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a><span class="sd">            filter_config=FilterConfig(id=None, name=&quot;default&quot;),</span>
-</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a><span class="sd">        )</span>
-</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
-</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a><span class="sd">        app.include_router(mymodel_router, prefix=&quot;/mymodel&quot;)</span>
-</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>
-</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a><span class="sd">        # Explanation:</span>
-</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
-</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
-</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
-</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
-</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a><span class="sd">        ```</span>
-</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a>
-</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>    <span class="n">crud</span> <span class="o">=</span> <span class="n">crud</span> <span class="ow">or</span> <span class="n">FastCRUD</span><span class="p">(</span>
-</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a>        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a>        <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
-</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a>        <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
-</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a>        <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
-</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a>    <span class="p">)</span>
-</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a>
-</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a>    <span class="n">endpoint_creator_class</span> <span class="o">=</span> <span class="n">endpoint_creator</span> <span class="ow">or</span> <span class="n">EndpointCreator</span>
-</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a>    <span class="n">endpoint_creator_instance</span> <span class="o">=</span> <span class="n">endpoint_creator_class</span><span class="p">(</span>
-</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a>        <span class="n">session</span><span class="o">=</span><span class="n">session</span><span class="p">,</span>
-</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a>        <span class="n">crud</span><span class="o">=</span><span class="n">crud</span><span class="p">,</span>
-</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a>        <span class="n">create_schema</span><span class="o">=</span><span class="n">create_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>        <span class="n">update_schema</span><span class="o">=</span><span class="n">update_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a>        <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a>        <span class="n">delete_schema</span><span class="o">=</span><span class="n">delete_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>        <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">,</span>
-</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a>        <span class="n">tags</span><span class="o">=</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a>        <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
-</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a>        <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
-</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a>        <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
-</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a>        <span class="n">endpoint_names</span><span class="o">=</span><span class="n">endpoint_names</span><span class="p">,</span>
-</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a>        <span class="n">filter_config</span><span class="o">=</span><span class="n">filter_config</span><span class="p">,</span>
-</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>    <span class="p">)</span>
-</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a>
-</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>    <span class="n">endpoint_creator_instance</span><span class="o">.</span><span class="n">add_routes_to_router</span><span class="p">(</span>
-</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a>        <span class="n">create_deps</span><span class="o">=</span><span class="n">create_deps</span><span class="p">,</span>
-</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a>        <span class="n">read_deps</span><span class="o">=</span><span class="n">read_deps</span><span class="p">,</span>
-</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a>        <span class="n">read_multi_deps</span><span class="o">=</span><span class="n">read_multi_deps</span><span class="p">,</span>
-</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a>        <span class="n">update_deps</span><span class="o">=</span><span class="n">update_deps</span><span class="p">,</span>
-</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a>        <span class="n">delete_deps</span><span class="o">=</span><span class="n">delete_deps</span><span class="p">,</span>
-</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a>        <span class="n">db_delete_deps</span><span class="o">=</span><span class="n">db_delete_deps</span><span class="p">,</span>
-</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>        <span class="n">included_methods</span><span class="o">=</span><span class="n">included_methods</span><span class="p">,</span>
-</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a>        <span class="n">deleted_methods</span><span class="o">=</span><span class="n">deleted_methods</span><span class="p">,</span>
-</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>    <span class="p">)</span>
-</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a>
-</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>    <span class="k">return</span> <span class="n">endpoint_creator_instance</span><span class="o">.</span><span class="n">router</span>
+</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a><span class="sd">        app.include_router(mymodel_router)</span>
+</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a><span class="sd">        ```</span>
+</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a>
+</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a><span class="sd">        Customizing Endpoint Names:</span>
+</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>
+</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a><span class="sd">        task_router = crud_router(</span>
+</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a><span class="sd">            model=Task,</span>
+</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a><span class="sd">            create_schema=CreateTaskSchema,</span>
+</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a><span class="sd">            update_schema=UpdateTaskSchema,</span>
+</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a><span class="sd">            path=&quot;/tasks&quot;,</span>
+</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a><span class="sd">            tags=[&quot;Task Management&quot;],</span>
+</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a><span class="sd">            endpoint_names={</span>
+</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a><span class="sd">                &quot;create&quot;: &quot;add_task&quot;,</span>
+</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a><span class="sd">                &quot;read&quot;: &quot;get_task&quot;,</span>
+</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a><span class="sd">                &quot;update&quot;: &quot;modify_task&quot;,</span>
+</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a><span class="sd">                &quot;delete&quot;: &quot;remove_task&quot;,</span>
+</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a><span class="sd">                &quot;db_delete&quot;: &quot;permanently_remove_task&quot;,</span>
+</span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a><span class="sd">                &quot;read_multi&quot;: &quot;list_tasks&quot;,</span>
+</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a><span class="sd">            },</span>
+</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a><span class="sd">        )</span>
+</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a><span class="sd">        ```</span>
+</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a>
+</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a><span class="sd">        Using `FilterConfig` with `dict`:</span>
+</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a>
+</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a><span class="sd">        from fastapi import FastAPI</span>
+</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a><span class="sd">        from fastcrud import crud_router</span>
+</span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a>
+</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a><span class="sd">        from .database import async_session</span>
+</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a><span class="sd">        from .mymodel.model import MyModel</span>
+</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
+</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a>
+</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a><span class="sd">        app = FastAPI()</span>
+</span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a>
+</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a><span class="sd">        mymodel_router = crud_router(</span>
+</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">            filter_config=FilterConfig(filters={&quot;id&quot;: None, &quot;name&quot;: &quot;default&quot;}),</span>
+</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a><span class="sd">        )</span>
+</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
+</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">        app.include_router(mymodel_router, prefix=&quot;/mymodel&quot;)</span>
+</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a>
+</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">        # Explanation:</span>
+</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
+</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
+</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
+</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
+</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a><span class="sd">        ```</span>
+</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a>
+</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a><span class="sd">        Using `FilterConfig` with keyword arguments:</span>
+</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a>
+</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a><span class="sd">        from fastapi import FastAPI</span>
+</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a><span class="sd">        from fastcrud import crud_router</span>
+</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a>
+</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a><span class="sd">        from .database import async_session</span>
+</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a><span class="sd">        from .mymodel.model import MyModel</span>
+</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
+</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a>
+</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a><span class="sd">        app = FastAPI()</span>
+</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a>
+</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a><span class="sd">        mymodel_router = crud_router(</span>
+</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a><span class="sd">            filter_config=FilterConfig(id=None, name=&quot;default&quot;),</span>
+</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a><span class="sd">        )</span>
+</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
+</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a><span class="sd">        app.include_router(mymodel_router, prefix=&quot;/mymodel&quot;)</span>
+</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>
+</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a><span class="sd">        # Explanation:</span>
+</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
+</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
+</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
+</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
+</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a><span class="sd">        ```</span>
+</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a>
+</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a>    <span class="n">crud</span> <span class="o">=</span> <span class="n">crud</span> <span class="ow">or</span> <span class="n">FastCRUD</span><span class="p">(</span>
+</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a>        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a>        <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
+</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a>        <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
+</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a>        <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
+</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a>    <span class="p">)</span>
+</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a>
+</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>    <span class="n">endpoint_creator_class</span> <span class="o">=</span> <span class="n">endpoint_creator</span> <span class="ow">or</span> <span class="n">EndpointCreator</span>
+</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a>    <span class="n">endpoint_creator_instance</span> <span class="o">=</span> <span class="n">endpoint_creator_class</span><span class="p">(</span>
+</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a>        <span class="n">session</span><span class="o">=</span><span class="n">session</span><span class="p">,</span>
+</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>        <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a>        <span class="n">crud</span><span class="o">=</span><span class="n">crud</span><span class="p">,</span>
+</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a>        <span class="n">create_schema</span><span class="o">=</span><span class="n">create_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>        <span class="n">update_schema</span><span class="o">=</span><span class="n">update_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a>        <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a>        <span class="n">delete_schema</span><span class="o">=</span><span class="n">delete_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a>        <span class="n">path</span><span class="o">=</span><span class="n">path</span><span class="p">,</span>
+</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a>        <span class="n">tags</span><span class="o">=</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a>        <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
+</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a>        <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
+</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>        <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
+</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a>        <span class="n">endpoint_names</span><span class="o">=</span><span class="n">endpoint_names</span><span class="p">,</span>
+</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>        <span class="n">filter_config</span><span class="o">=</span><span class="n">filter_config</span><span class="p">,</span>
+</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a>        <span class="n">select_schema</span><span class="o">=</span><span class="n">select_schema</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a>    <span class="p">)</span>
+</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a>
+</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a>    <span class="n">endpoint_creator_instance</span><span class="o">.</span><span class="n">add_routes_to_router</span><span class="p">(</span>
+</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a>        <span class="n">create_deps</span><span class="o">=</span><span class="n">create_deps</span><span class="p">,</span>
+</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a>        <span class="n">read_deps</span><span class="o">=</span><span class="n">read_deps</span><span class="p">,</span>
+</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>        <span class="n">read_multi_deps</span><span class="o">=</span><span class="n">read_multi_deps</span><span class="p">,</span>
+</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a>        <span class="n">update_deps</span><span class="o">=</span><span class="n">update_deps</span><span class="p">,</span>
+</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>        <span class="n">delete_deps</span><span class="o">=</span><span class="n">delete_deps</span><span class="p">,</span>
+</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a>        <span class="n">db_delete_deps</span><span class="o">=</span><span class="n">db_delete_deps</span><span class="p">,</span>
+</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>        <span class="n">included_methods</span><span class="o">=</span><span class="n">included_methods</span><span class="p">,</span>
+</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a>        <span class="n">deleted_methods</span><span class="o">=</span><span class="n">deleted_methods</span><span class="p">,</span>
+</span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>    <span class="p">)</span>
+</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a>
+</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a>    <span class="k">return</span> <span class="n">endpoint_creator_instance</span><span class="o">.</span><span class="n">router</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
diff --git a/api/endpoint_creator/index.html b/api/endpoint_creator/index.html
index b0eead7..d027714 100644
--- a/api/endpoint_creator/index.html
+++ b/api/endpoint_creator/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1015,8 +1032,30 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
     
+      
+      
+  
+  
+  
+  
     
+    
+      
+        
       
         
       
@@ -1038,10 +1077,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1052,8 +1091,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1107,6 +1146,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
@@ -1423,6 +1483,16 @@ <h2 id="class-definition">Class Definition<a class="headerlink" href="#class-def
             </div>
           </td>
         </tr>
+        <tr>
+          <td><code><span title="fastcrud.EndpointCreator.select_schema">select_schema</span></code></td>
+          <td>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <p>Optional Pydantic schema for selecting an item.</p>
+            </div>
+          </td>
+        </tr>
     </tbody>
   </table>
 
@@ -1615,9 +1685,7 @@ <h2 id="class-definition">Class Definition<a class="headerlink" href="#class-def
 
             <details class="quote">
               <summary>Source code in <code>fastcrud/endpoint/endpoint_creator.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-35"> 35</a></span>
-<span class="normal"><a href="#__codelineno-0-36"> 36</a></span>
-<span class="normal"><a href="#__codelineno-0-37"> 37</a></span>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-37"> 37</a></span>
 <span class="normal"><a href="#__codelineno-0-38"> 38</a></span>
 <span class="normal"><a href="#__codelineno-0-39"> 39</a></span>
 <span class="normal"><a href="#__codelineno-0-40"> 40</a></span>
@@ -2253,645 +2321,801 @@ <h2 id="class-definition">Class Definition<a class="headerlink" href="#class-def
 <span class="normal"><a href="#__codelineno-0-670">670</a></span>
 <span class="normal"><a href="#__codelineno-0-671">671</a></span>
 <span class="normal"><a href="#__codelineno-0-672">672</a></span>
-<span class="normal"><a href="#__codelineno-0-673">673</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-35"><a id="__codelineno-0-35" name="__codelineno-0-35"></a><span class="k">class</span> <span class="nc">EndpointCreator</span><span class="p">:</span>
-</span><span id="__span-0-36"><a id="__codelineno-0-36" name="__codelineno-0-36"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37"></a><span class="sd">    A class to create and register CRUD endpoints for a FastAPI application.</span>
-</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a>
-</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39"></a><span class="sd">    This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints</span>
-</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40"></a><span class="sd">    to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations,</span>
-</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41"></a><span class="sd">    and Pydantic schemas, and allows for custom dependency injection for each endpoint.</span>
-</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42"></a><span class="sd">    The method assumes `id` is the primary key for path parameters.</span>
-</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a>
-</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44"></a><span class="sd">    Attributes:</span>
-</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a><span class="sd">        session: The SQLAlchemy async session.</span>
-</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a><span class="sd">        model: The SQLAlchemy model.</span>
-</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47"></a><span class="sd">        create_schema: Pydantic schema for creating an item.</span>
-</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="sd">        update_schema: Pydantic schema for updating an item.</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49"></a><span class="sd">        crud: An optional FastCRUD instance. If not provided, uses `FastCRUD(model)`.</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50"></a><span class="sd">        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="sd">        delete_schema: Optional Pydantic schema for deleting an item.</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a><span class="sd">        path: Base path for the CRUD endpoints.</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a><span class="sd">        tags: List of tags for grouping endpoints in the documentation.</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a><span class="sd">        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a><span class="sd">                        (`&quot;create&quot;`, `&quot;read&quot;`, `&quot;update&quot;`, `&quot;delete&quot;`, `&quot;db_delete&quot;`, `&quot;read_multi&quot;`), and</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a><span class="sd">                        values are the custom names to use. Unspecified operations will use default names.</span>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="sd">        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
+<span class="normal"><a href="#__codelineno-0-673">673</a></span>
+<span class="normal"><a href="#__codelineno-0-674">674</a></span>
+<span class="normal"><a href="#__codelineno-0-675">675</a></span>
+<span class="normal"><a href="#__codelineno-0-676">676</a></span>
+<span class="normal"><a href="#__codelineno-0-677">677</a></span>
+<span class="normal"><a href="#__codelineno-0-678">678</a></span>
+<span class="normal"><a href="#__codelineno-0-679">679</a></span>
+<span class="normal"><a href="#__codelineno-0-680">680</a></span>
+<span class="normal"><a href="#__codelineno-0-681">681</a></span>
+<span class="normal"><a href="#__codelineno-0-682">682</a></span>
+<span class="normal"><a href="#__codelineno-0-683">683</a></span>
+<span class="normal"><a href="#__codelineno-0-684">684</a></span>
+<span class="normal"><a href="#__codelineno-0-685">685</a></span>
+<span class="normal"><a href="#__codelineno-0-686">686</a></span>
+<span class="normal"><a href="#__codelineno-0-687">687</a></span>
+<span class="normal"><a href="#__codelineno-0-688">688</a></span>
+<span class="normal"><a href="#__codelineno-0-689">689</a></span>
+<span class="normal"><a href="#__codelineno-0-690">690</a></span>
+<span class="normal"><a href="#__codelineno-0-691">691</a></span>
+<span class="normal"><a href="#__codelineno-0-692">692</a></span>
+<span class="normal"><a href="#__codelineno-0-693">693</a></span>
+<span class="normal"><a href="#__codelineno-0-694">694</a></span>
+<span class="normal"><a href="#__codelineno-0-695">695</a></span>
+<span class="normal"><a href="#__codelineno-0-696">696</a></span>
+<span class="normal"><a href="#__codelineno-0-697">697</a></span>
+<span class="normal"><a href="#__codelineno-0-698">698</a></span>
+<span class="normal"><a href="#__codelineno-0-699">699</a></span>
+<span class="normal"><a href="#__codelineno-0-700">700</a></span>
+<span class="normal"><a href="#__codelineno-0-701">701</a></span>
+<span class="normal"><a href="#__codelineno-0-702">702</a></span>
+<span class="normal"><a href="#__codelineno-0-703">703</a></span>
+<span class="normal"><a href="#__codelineno-0-704">704</a></span>
+<span class="normal"><a href="#__codelineno-0-705">705</a></span>
+<span class="normal"><a href="#__codelineno-0-706">706</a></span>
+<span class="normal"><a href="#__codelineno-0-707">707</a></span>
+<span class="normal"><a href="#__codelineno-0-708">708</a></span>
+<span class="normal"><a href="#__codelineno-0-709">709</a></span>
+<span class="normal"><a href="#__codelineno-0-710">710</a></span>
+<span class="normal"><a href="#__codelineno-0-711">711</a></span>
+<span class="normal"><a href="#__codelineno-0-712">712</a></span>
+<span class="normal"><a href="#__codelineno-0-713">713</a></span>
+<span class="normal"><a href="#__codelineno-0-714">714</a></span>
+<span class="normal"><a href="#__codelineno-0-715">715</a></span>
+<span class="normal"><a href="#__codelineno-0-716">716</a></span>
+<span class="normal"><a href="#__codelineno-0-717">717</a></span>
+<span class="normal"><a href="#__codelineno-0-718">718</a></span>
+<span class="normal"><a href="#__codelineno-0-719">719</a></span>
+<span class="normal"><a href="#__codelineno-0-720">720</a></span>
+<span class="normal"><a href="#__codelineno-0-721">721</a></span>
+<span class="normal"><a href="#__codelineno-0-722">722</a></span>
+<span class="normal"><a href="#__codelineno-0-723">723</a></span>
+<span class="normal"><a href="#__codelineno-0-724">724</a></span>
+<span class="normal"><a href="#__codelineno-0-725">725</a></span>
+<span class="normal"><a href="#__codelineno-0-726">726</a></span>
+<span class="normal"><a href="#__codelineno-0-727">727</a></span>
+<span class="normal"><a href="#__codelineno-0-728">728</a></span>
+<span class="normal"><a href="#__codelineno-0-729">729</a></span>
+<span class="normal"><a href="#__codelineno-0-730">730</a></span>
+<span class="normal"><a href="#__codelineno-0-731">731</a></span>
+<span class="normal"><a href="#__codelineno-0-732">732</a></span>
+<span class="normal"><a href="#__codelineno-0-733">733</a></span>
+<span class="normal"><a href="#__codelineno-0-734">734</a></span>
+<span class="normal"><a href="#__codelineno-0-735">735</a></span>
+<span class="normal"><a href="#__codelineno-0-736">736</a></span>
+<span class="normal"><a href="#__codelineno-0-737">737</a></span>
+<span class="normal"><a href="#__codelineno-0-738">738</a></span>
+<span class="normal"><a href="#__codelineno-0-739">739</a></span>
+<span class="normal"><a href="#__codelineno-0-740">740</a></span>
+<span class="normal"><a href="#__codelineno-0-741">741</a></span>
+<span class="normal"><a href="#__codelineno-0-742">742</a></span>
+<span class="normal"><a href="#__codelineno-0-743">743</a></span>
+<span class="normal"><a href="#__codelineno-0-744">744</a></span>
+<span class="normal"><a href="#__codelineno-0-745">745</a></span>
+<span class="normal"><a href="#__codelineno-0-746">746</a></span>
+<span class="normal"><a href="#__codelineno-0-747">747</a></span>
+<span class="normal"><a href="#__codelineno-0-748">748</a></span>
+<span class="normal"><a href="#__codelineno-0-749">749</a></span>
+<span class="normal"><a href="#__codelineno-0-750">750</a></span>
+<span class="normal"><a href="#__codelineno-0-751">751</a></span>
+<span class="normal"><a href="#__codelineno-0-752">752</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-37"><a id="__codelineno-0-37" name="__codelineno-0-37"></a><span class="k">class</span> <span class="nc">EndpointCreator</span><span class="p">:</span>
+</span><span id="__span-0-38"><a id="__codelineno-0-38" name="__codelineno-0-38"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-39"><a id="__codelineno-0-39" name="__codelineno-0-39"></a><span class="sd">    A class to create and register CRUD endpoints for a FastAPI application.</span>
+</span><span id="__span-0-40"><a id="__codelineno-0-40" name="__codelineno-0-40"></a>
+</span><span id="__span-0-41"><a id="__codelineno-0-41" name="__codelineno-0-41"></a><span class="sd">    This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints</span>
+</span><span id="__span-0-42"><a id="__codelineno-0-42" name="__codelineno-0-42"></a><span class="sd">    to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations,</span>
+</span><span id="__span-0-43"><a id="__codelineno-0-43" name="__codelineno-0-43"></a><span class="sd">    and Pydantic schemas, and allows for custom dependency injection for each endpoint.</span>
+</span><span id="__span-0-44"><a id="__codelineno-0-44" name="__codelineno-0-44"></a><span class="sd">    The method assumes `id` is the primary key for path parameters.</span>
+</span><span id="__span-0-45"><a id="__codelineno-0-45" name="__codelineno-0-45"></a>
+</span><span id="__span-0-46"><a id="__codelineno-0-46" name="__codelineno-0-46"></a><span class="sd">    Attributes:</span>
+</span><span id="__span-0-47"><a id="__codelineno-0-47" name="__codelineno-0-47"></a><span class="sd">        session: The SQLAlchemy async session.</span>
+</span><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="sd">        model: The SQLAlchemy model.</span>
+</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49"></a><span class="sd">        create_schema: Pydantic schema for creating an item.</span>
+</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50"></a><span class="sd">        update_schema: Pydantic schema for updating an item.</span>
+</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="sd">        crud: An optional FastCRUD instance. If not provided, uses `FastCRUD(model)`.</span>
+</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a><span class="sd">        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.</span>
+</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a><span class="sd">        delete_schema: Optional Pydantic schema for deleting an item.</span>
+</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a><span class="sd">        path: Base path for the CRUD endpoints.</span>
+</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a><span class="sd">        tags: List of tags for grouping endpoints in the documentation.</span>
+</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
+</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
+</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
+</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a><span class="sd">        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types</span>
+</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="sd">                        (`&quot;create&quot;`, `&quot;read&quot;`, `&quot;update&quot;`, `&quot;delete&quot;`, `&quot;db_delete&quot;`, `&quot;read_multi&quot;`), and</span>
+</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a><span class="sd">                        values are the custom names to use. Unspecified operations will use default names.</span>
+</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a><span class="sd">        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.</span>
+</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a><span class="sd">        select_schema: Optional Pydantic schema for selecting an item.</span>
 </span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64"></a>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a><span class="sd">        Basic Setup:</span>
+</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
 </span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67"></a>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a><span class="sd">        ??? example &quot;`mymodel/model.py`&quot;</span>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">            --8&lt;--</span>
-</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72"></a><span class="sd">            fastcrud/examples/mymodel/model.py:imports</span>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">            fastcrud/examples/mymodel/model.py:model_simple</span>
+</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a><span class="sd">        Basic Setup:</span>
+</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a>
+</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">        ??? example &quot;`mymodel/model.py`&quot;</span>
+</span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72"></a>
+</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">            ```python</span>
 </span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74"></a><span class="sd">            --8&lt;--</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a><span class="sd">            ```</span>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">        ??? example &quot;`mymodel/schemas.py`&quot;</span>
-</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78"></a>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">            --8&lt;--</span>
-</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:imports</span>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:createschema</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:updateschema</span>
-</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84"></a><span class="sd">            --8&lt;--</span>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="sd">            ```</span>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a><span class="sd">        from fastapi import FastAPI</span>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a><span class="sd">        from fastcrud import EndpointCreator</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a>
-</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91"></a><span class="sd">        from .database import async_session</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">        from .mymodel.model import MyModel</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a>
-</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="sd">        app = FastAPI()</span>
-</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
-</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">        )</span>
-</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
-</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
-</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="sd">        ```</span>
-</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a>
-</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a><span class="sd">        With Custom Dependencies:</span>
-</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a>
-</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a><span class="sd">        from fastapi.security import OAuth2PasswordBearer</span>
+</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a><span class="sd">            fastcrud/examples/mymodel/model.py:imports</span>
+</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a><span class="sd">            fastcrud/examples/mymodel/model.py:model_simple</span>
+</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">            --8&lt;--</span>
+</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78"></a><span class="sd">            ```</span>
+</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a>
+</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">        ??? example &quot;`mymodel/schemas.py`&quot;</span>
+</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81"></a>
+</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">            --8&lt;--</span>
+</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:imports</span>
+</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:createschema</span>
+</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a><span class="sd">            fastcrud/examples/mymodel/schemas.py:updateschema</span>
+</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="sd">            --8&lt;--</span>
+</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a><span class="sd">            ```</span>
+</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a>
+</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91"></a><span class="sd">        from fastapi import FastAPI</span>
+</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">        from fastcrud import EndpointCreator</span>
+</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a>
+</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a><span class="sd">        from .database import async_session</span>
+</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="sd">        from .mymodel.model import MyModel</span>
+</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
+</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a>
+</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a><span class="sd">        app = FastAPI()</span>
+</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
+</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="sd">        )</span>
+</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
+</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
+</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a><span class="sd">        ```</span>
+</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a>
+</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a><span class="sd">        With Custom Dependencies:</span>
 </span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110"></a>
-</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="sd">        oauth2_scheme = OAuth2PasswordBearer(tokenUrl=&quot;token&quot;)</span>
-</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a>
-</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="sd">        def get_current_user(token: str = Depends(oauth2_scheme)):</span>
-</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">            return ...</span>
+</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="sd">        from fastapi.security import OAuth2PasswordBearer</span>
+</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113"></a>
+</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">        oauth2_scheme = OAuth2PasswordBearer(tokenUrl=&quot;token&quot;)</span>
 </span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115"></a>
-</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a><span class="sd">            read_deps=[get_current_user],</span>
-</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a><span class="sd">            update_deps=[get_current_user],</span>
-</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a><span class="sd">        )</span>
-</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a><span class="sd">        ```</span>
-</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a>
-</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">        Selective Endpoint Creation (inclusion):</span>
-</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a>
-</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">        # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
-</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
-</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a><span class="sd">        )</span>
-</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a><span class="sd">        ```</span>
-</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a>
-</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">        Selective Endpoint Creation (deletion):</span>
-</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a>
-</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134"></a><span class="sd">        # Create all but &#39;update&#39; and &#39;delete&#39; endpoints</span>
-</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a><span class="sd">            deleted_methods=[&quot;update&quot;, &quot;delete&quot;],</span>
-</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a><span class="sd">        )</span>
-</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="sd">        ```</span>
-</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a>
-</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">        Integrating with Multiple Models:</span>
-</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a>
-</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">        # Assuming definitions for OtherModel, OtherModelCRUD, etc.</span>
+</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">        def get_current_user(token: str = Depends(oauth2_scheme)):</span>
+</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a><span class="sd">            return ...</span>
+</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a>
+</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a><span class="sd">            read_deps=[get_current_user],</span>
+</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a><span class="sd">            update_deps=[get_current_user],</span>
+</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">        )</span>
+</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a><span class="sd">        ```</span>
+</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a>
+</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">        Selective Endpoint Creation (inclusion):</span>
+</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a>
+</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a><span class="sd">        # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
+</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
+</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">        )</span>
+</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a><span class="sd">        ```</span>
+</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a>
+</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134"></a><span class="sd">        Selective Endpoint Creation (deletion):</span>
+</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a>
+</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a><span class="sd">        # Create all but &#39;update&#39; and &#39;delete&#39; endpoints</span>
+</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a><span class="sd">            deleted_methods=[&quot;update&quot;, &quot;delete&quot;],</span>
+</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">        )</span>
+</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="sd">        ```</span>
+</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a>
+</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">        Integrating with Multiple Models:</span>
 </span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144"></a>
-</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">        other_model_crud = OtherModelCRUD(OtherModel)</span>
-</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">        other_endpoint_creator = EndpointCreator(</span>
-</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="sd">            model=OtherModel,</span>
-</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">            create_schema=CreateOtherModelSchema,</span>
-</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">            update_schema=UpdateOtherModelSchema,</span>
-</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">            crud=other_model_crud,</span>
-</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">        )</span>
-</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">        other_endpoint_creator.add_routes_to_router()</span>
-</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">        app.include_router(other_endpoint_creator.router, prefix=&quot;/othermodel&quot;)</span>
-</span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155"></a><span class="sd">        ```</span>
-</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a>
-</span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157"></a><span class="sd">        Customizing Endpoint Names:</span>
-</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a>
-</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
-</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
-</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
-</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">            endpoint_names={</span>
-</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a><span class="sd">                &quot;create&quot;: &quot;add&quot;,  # Custom endpoint name for creating items</span>
-</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a><span class="sd">                &quot;read&quot;: &quot;fetch&quot;,  # Custom endpoint name for reading a single item</span>
-</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="sd">                &quot;update&quot;: &quot;change&quot;,  # Custom endpoint name for updating items</span>
-</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="sd">                # The delete operation will use the default name &quot;delete&quot;</span>
-</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="sd">            },</span>
-</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a><span class="sd">        )</span>
-</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
-</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="sd">        ```</span>
-</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a>
-</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a><span class="sd">        Using `filter_config` with `dict`:</span>
-</span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178"></a>
-</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a><span class="sd">        from fastapi import FastAPI</span>
-</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a><span class="sd">        from fastcrud import EndpointCreator, FilterConfig</span>
-</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a>
-</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">        from .database import async_session</span>
-</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">        from .mymodel.model import MyModel</span>
-</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
-</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a>
-</span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="sd">        app = FastAPI()</span>
-</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
-</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">            filter_config=FilterConfig(filters={&quot;id&quot;: None, &quot;name&quot;: &quot;default&quot;}),</span>
-</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a><span class="sd">        )</span>
-</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
-</span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
-</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">        # Include the internal router into the FastAPI app</span>
-</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
-</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a>
-</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">        # Explanation:</span>
-</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
-</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
-</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
-</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
-</span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">        ```</span>
-</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a>
-</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">        Using `filter_config` with keyword arguments:</span>
-</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a>
-</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a><span class="sd">        from fastapi import FastAPI</span>
-</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a><span class="sd">        from fastcrud import EndpointCreator, FilterConfig</span>
-</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a>
-</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">        from .database import async_session</span>
-</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a><span class="sd">        from .mymodel.model import MyModel</span>
-</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
-</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a>
-</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">        app = FastAPI()</span>
-</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
-</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd">            session=async_session,</span>
-</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">            model=MyModel,</span>
-</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
-</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
-</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd">            filter_config=FilterConfig(id=None, name=&quot;default&quot;),</span>
-</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">        )</span>
-</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
-</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
-</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd">        # Include the internal router into the FastAPI app</span>
-</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
-</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a>
-</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd">        # Explanation:</span>
-</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
-</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
-</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
-</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
-</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd">        ```</span>
-</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a>
-</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a>    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a>        <span class="n">session</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
-</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a>        <span class="n">model</span><span class="p">:</span> <span class="n">ModelType</span><span class="p">,</span>
-</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a>        <span class="n">create_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">CreateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a>        <span class="n">update_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a>        <span class="n">crud</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">FastCRUD</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a>        <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a>        <span class="n">delete_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">DeleteSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a>        <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a>        <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a>        <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
-</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a>        <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a>        <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a>        <span class="n">endpoint_names</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a>        <span class="n">filter_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">FilterConfig</span><span class="p">,</span> <span class="nb">dict</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span> <span class="o">=</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a>            <span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">_get_python_type</span><span class="p">(</span><span class="n">pk</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span>
-</span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258"></a>        <span class="p">}</span>
-</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span> <span class="o">=</span> <span class="p">[</span><span class="n">pk</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">]</span>
-</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="n">session</span>
-</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">crud</span> <span class="o">=</span> <span class="n">crud</span> <span class="ow">or</span> <span class="n">FastCRUD</span><span class="p">(</span>
-</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a>            <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a>            <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
-</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a>            <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
-</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a>            <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
-</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a>        <span class="p">)</span>
-</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">model</span>
-</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">create_schema</span> <span class="o">=</span> <span class="n">create_schema</span>
-</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">update_schema</span> <span class="o">=</span> <span class="n">update_schema</span>
-</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span> <span class="o">=</span> <span class="n">delete_schema</span>
-</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span> <span class="o">=</span> <span class="n">include_in_schema</span>
-</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">=</span> <span class="n">path</span>
-</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">tags</span> <span class="o">=</span> <span class="n">tags</span> <span class="ow">or</span> <span class="p">[]</span>
-</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span> <span class="o">=</span> <span class="n">APIRouter</span><span class="p">()</span>
-</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="o">=</span> <span class="n">is_deleted_column</span>
-</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="o">=</span> <span class="n">deleted_at_column</span>
-</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span> <span class="o">=</span> <span class="n">updated_at_column</span>
-</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a>            <span class="s2">&quot;create&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a>            <span class="s2">&quot;read&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a>            <span class="s2">&quot;update&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a>            <span class="s2">&quot;delete&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a>            <span class="s2">&quot;db_delete&quot;</span><span class="p">:</span> <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
-</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a>            <span class="s2">&quot;read_multi&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
-</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a>        <span class="p">}</span>
-</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">endpoint_names</span> <span class="o">=</span> <span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">endpoint_names</span> <span class="ow">or</span> <span class="p">{})}</span>
-</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a>        <span class="k">if</span> <span class="n">filter_config</span><span class="p">:</span>
-</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a>            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filter_config</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a>                <span class="n">filter_config</span> <span class="o">=</span> <span class="n">FilterConfig</span><span class="p">(</span><span class="o">**</span><span class="n">filter_config</span><span class="p">)</span>
-</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_validate_filter_config</span><span class="p">(</span><span class="n">filter_config</span><span class="p">)</span>
-</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">filter_config</span> <span class="o">=</span> <span class="n">filter_config</span>
-</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">column_types</span> <span class="o">=</span> <span class="n">_get_column_types</span><span class="p">(</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a>
-</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a>    <span class="k">def</span> <span class="nf">_validate_filter_config</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filter_config</span><span class="p">:</span> <span class="n">FilterConfig</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a>        <span class="n">model_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">model_col_names</span>
-</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a>        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">filter_config</span><span class="o">.</span><span class="n">filters</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
-</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a>            <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">model_columns</span><span class="p">:</span>
-</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a>                    <span class="sa">f</span><span class="s2">&quot;Invalid filter column &#39;</span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">&#39;: not found in model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; columns&quot;</span>
-</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a>                <span class="p">)</span>
-</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a>
-</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a>    <span class="k">def</span> <span class="nf">_create_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for creating items in the database.&quot;&quot;&quot;</span>
-</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a>
-</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
-</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
-</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a>            <span class="n">item</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_schema</span> <span class="o">=</span> <span class="n">Body</span><span class="p">(</span><span class="o">...</span><span class="p">),</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a>        <span class="p">):</span>
-</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a>            <span class="n">unique_columns</span> <span class="o">=</span> <span class="n">_extract_unique_columns</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a>
-</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a>            <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique_columns</span><span class="p">:</span>
-</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a>                <span class="n">col_name</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span>
-</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a>                <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">item</span><span class="p">,</span> <span class="n">col_name</span><span class="p">):</span>
-</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a>                    <span class="n">value</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">item</span><span class="p">,</span> <span class="n">col_name</span><span class="p">)</span>
-</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a>                    <span class="n">exists</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="p">{</span><span class="n">col_name</span><span class="p">:</span> <span class="n">value</span><span class="p">})</span>
-</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a>                    <span class="k">if</span> <span class="n">exists</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a>                        <span class="k">raise</span> <span class="n">DuplicateValueException</span><span class="p">(</span>
-</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a>                            <span class="sa">f</span><span class="s2">&quot;Value </span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s2"> is already registered&quot;</span>
-</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a>                        <span class="p">)</span>
-</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a>
-</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a>            <span class="k">return</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">item</span><span class="p">)</span>
-</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a>
-</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a>        <span class="k">return</span> <span class="n">endpoint</span>
-</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a>
-</span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325"></a>    <span class="k">def</span> <span class="nf">_read_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for reading a single item from the database.&quot;&quot;&quot;</span>
-</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a>
-</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
-</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
-</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a>            <span class="n">item</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
-</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">item</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a>                <span class="k">raise</span> <span class="n">NotFoundException</span><span class="p">(</span><span class="n">detail</span><span class="o">=</span><span class="s2">&quot;Item not found&quot;</span><span class="p">)</span>
-</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a>            <span class="k">return</span> <span class="n">item</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">        # Assuming definitions for OtherModel, OtherModelCRUD, etc.</span>
+</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a>
+</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="sd">        other_model_crud = OtherModelCRUD(OtherModel)</span>
+</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">        other_endpoint_creator = EndpointCreator(</span>
+</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">            model=OtherModel,</span>
+</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">            create_schema=CreateOtherModelSchema,</span>
+</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">            update_schema=UpdateOtherModelSchema,</span>
+</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">            crud=other_model_crud,</span>
+</span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155"></a><span class="sd">        )</span>
+</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="sd">        other_endpoint_creator.add_routes_to_router()</span>
+</span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157"></a><span class="sd">        app.include_router(other_endpoint_creator.router, prefix=&quot;/othermodel&quot;)</span>
+</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a><span class="sd">        ```</span>
+</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a>
+</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="sd">        Customizing Endpoint Names:</span>
+</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a>
+</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
+</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a><span class="sd">            path=&quot;/mymodel&quot;,</span>
+</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a><span class="sd">            tags=[&quot;MyModel&quot;],</span>
+</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="sd">            endpoint_names={</span>
+</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="sd">                &quot;create&quot;: &quot;add&quot;,  # Custom endpoint name for creating items</span>
+</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="sd">                &quot;read&quot;: &quot;fetch&quot;,  # Custom endpoint name for reading a single item</span>
+</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a><span class="sd">                &quot;update&quot;: &quot;change&quot;,  # Custom endpoint name for updating items</span>
+</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd">                # The delete operation will use the default name &quot;delete&quot;</span>
+</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="sd">            },</span>
+</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a><span class="sd">        )</span>
+</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
+</span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178"></a><span class="sd">        ```</span>
+</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a>
+</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a><span class="sd">        Using `filter_config` with `dict`:</span>
+</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a>
+</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">        from fastapi import FastAPI</span>
+</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">        from fastcrud import EndpointCreator, FilterConfig</span>
+</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a>
+</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a><span class="sd">        from .database import async_session</span>
+</span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="sd">        from .mymodel.model import MyModel</span>
+</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
+</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a>
+</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">        app = FastAPI()</span>
+</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
+</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196"></a><span class="sd">            filter_config=FilterConfig(filters={&quot;id&quot;: None, &quot;name&quot;: &quot;default&quot;}),</span>
+</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">        )</span>
+</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
+</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
+</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">        # Include the internal router into the FastAPI app</span>
+</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
+</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a>
+</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">        # Explanation:</span>
+</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
+</span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
+</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
+</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
+</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">        ```</span>
+</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a>
+</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a><span class="sd">        Using `filter_config` with keyword arguments:</span>
+</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a>
+</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">        from fastapi import FastAPI</span>
+</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a><span class="sd">        from fastcrud import EndpointCreator, FilterConfig</span>
+</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a>
+</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="sd">        from .database import async_session</span>
+</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">        from .mymodel.model import MyModel</span>
+</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd">        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema</span>
+</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a>
+</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">        app = FastAPI()</span>
+</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd">        endpoint_creator = EndpointCreator(</span>
+</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">            session=async_session,</span>
+</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd">            model=MyModel,</span>
+</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">            create_schema=CreateMyModelSchema,</span>
+</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd">            update_schema=UpdateMyModelSchema,</span>
+</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">            filter_config=FilterConfig(id=None, name=&quot;default&quot;),</span>
+</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd">        )</span>
+</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd">        # Adds CRUD routes with filtering capabilities</span>
+</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd">        endpoint_creator.add_routes_to_router()</span>
+</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd">        # Include the internal router into the FastAPI app</span>
+</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd">        app.include_router(endpoint_creator.router, prefix=&quot;/mymodel&quot;)</span>
+</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a>
+</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd">        # Explanation:</span>
+</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">        # The FilterConfig specifies that &#39;id&#39; should be a query parameter with no default value</span>
+</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd">        # and &#39;name&#39; should be a query parameter with a default value of &#39;default&#39;.</span>
+</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">        # When fetching multiple items, you can filter by these parameters.</span>
+</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a><span class="sd">        # Example GET request: /mymodel/get_multi?id=1&amp;name=example</span>
+</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd">        ```</span>
+</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a>
+</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a>    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a>        <span class="n">session</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
+</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a>        <span class="n">model</span><span class="p">:</span> <span class="n">ModelType</span><span class="p">,</span>
+</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a>        <span class="n">create_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">CreateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a>        <span class="n">update_schema</span><span class="p">:</span> <span class="n">Type</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a>        <span class="n">crud</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">FastCRUD</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a>        <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a>        <span class="n">delete_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">DeleteSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a>        <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a>        <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a>        <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
+</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a>        <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a>        <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a>        <span class="n">endpoint_names</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256"></a>        <span class="n">filter_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">FilterConfig</span><span class="p">,</span> <span class="nb">dict</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a>        <span class="n">select_schema</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span> <span class="o">=</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a>            <span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="n">_get_python_type</span><span class="p">(</span><span class="n">pk</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span>
+</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a>        <span class="p">}</span>
+</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span> <span class="o">=</span> <span class="p">[</span><span class="n">pk</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">]</span>
+</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">session</span> <span class="o">=</span> <span class="n">session</span>
+</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">crud</span> <span class="o">=</span> <span class="n">crud</span> <span class="ow">or</span> <span class="n">FastCRUD</span><span class="p">(</span>
+</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a>            <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a>            <span class="n">is_deleted_column</span><span class="o">=</span><span class="n">is_deleted_column</span><span class="p">,</span>
+</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a>            <span class="n">deleted_at_column</span><span class="o">=</span><span class="n">deleted_at_column</span><span class="p">,</span>
+</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a>            <span class="n">updated_at_column</span><span class="o">=</span><span class="n">updated_at_column</span><span class="p">,</span>
+</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a>        <span class="p">)</span>
+</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">model</span>
+</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">create_schema</span> <span class="o">=</span> <span class="n">create_schema</span>
+</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">update_schema</span> <span class="o">=</span> <span class="n">update_schema</span>
+</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span> <span class="o">=</span> <span class="n">delete_schema</span>
+</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="o">=</span> <span class="n">select_schema</span>
+</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span> <span class="o">=</span> <span class="n">include_in_schema</span>
+</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">path</span> <span class="o">=</span> <span class="n">path</span>
+</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">tags</span> <span class="o">=</span> <span class="n">tags</span> <span class="ow">or</span> <span class="p">[]</span>
+</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span> <span class="o">=</span> <span class="n">APIRouter</span><span class="p">()</span>
+</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="o">=</span> <span class="n">is_deleted_column</span>
+</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="o">=</span> <span class="n">deleted_at_column</span>
+</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span> <span class="o">=</span> <span class="n">updated_at_column</span>
+</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a>            <span class="s2">&quot;create&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a>            <span class="s2">&quot;read&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a>            <span class="s2">&quot;update&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a>            <span class="s2">&quot;delete&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a>            <span class="s2">&quot;db_delete&quot;</span><span class="p">:</span> <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
+</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a>            <span class="s2">&quot;read_multi&quot;</span><span class="p">:</span> <span class="s2">&quot;&quot;</span><span class="p">,</span>
+</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a>        <span class="p">}</span>
+</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">endpoint_names</span> <span class="o">=</span> <span class="p">{</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">endpoint_names</span> <span class="ow">or</span> <span class="p">{})}</span>
+</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a>        <span class="k">if</span> <span class="n">filter_config</span><span class="p">:</span>
+</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a>            <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">filter_config</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
+</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a>                <span class="n">filter_config</span> <span class="o">=</span> <span class="n">FilterConfig</span><span class="p">(</span><span class="o">**</span><span class="n">filter_config</span><span class="p">)</span>
+</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_validate_filter_config</span><span class="p">(</span><span class="n">filter_config</span><span class="p">)</span>
+</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">filter_config</span> <span class="o">=</span> <span class="n">filter_config</span>
+</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">column_types</span> <span class="o">=</span> <span class="n">_get_column_types</span><span class="p">(</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a>
+</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a>        <span class="k">if</span> <span class="n">select_schema</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">list_response_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Type</span><span class="p">[</span><span class="n">ListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">]]]</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span>
+</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a>                <span class="s2">&quot;DynamicListResponse&quot;</span><span class="p">,</span>
+</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a>                <span class="p">(</span><span class="n">ListResponse</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">],),</span>
+</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a>                <span class="p">{</span><span class="s2">&quot;__annotations__&quot;</span><span class="p">:</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">select_schema</span><span class="p">]}},</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a>            <span class="p">)</span>
+</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">paginated_response_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span>
+</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a>                <span class="n">Type</span><span class="p">[</span><span class="n">PaginatedListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span>
+</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a>            <span class="p">]</span> <span class="o">=</span> <span class="nb">type</span><span class="p">(</span>
+</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a>                <span class="s2">&quot;DynamicPaginatedResponse&quot;</span><span class="p">,</span>
+</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a>                <span class="p">(</span><span class="n">PaginatedListResponse</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">],),</span>
+</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a>                <span class="p">{</span>
+</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a>                    <span class="s2">&quot;__annotations__&quot;</span><span class="p">:</span> <span class="p">{</span>
+</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a>                        <span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">select_schema</span><span class="p">],</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a>                        <span class="s2">&quot;total_count&quot;</span><span class="p">:</span> <span class="nb">int</span><span class="p">,</span>
+</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a>                        <span class="s2">&quot;has_more&quot;</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span>
+</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a>                        <span class="s2">&quot;page&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a>                        <span class="s2">&quot;items_per_page&quot;</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">],</span>
+</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a>                    <span class="p">}</span>
+</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a>                <span class="p">},</span>
+</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a>            <span class="p">)</span>
+</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">list_response_model</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">paginated_response_model</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a>
+</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a>    <span class="k">def</span> <span class="nf">_validate_filter_config</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">filter_config</span><span class="p">:</span> <span class="n">FilterConfig</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325"></a>        <span class="n">model_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">model_col_names</span>
+</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a>        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">filter_config</span><span class="o">.</span><span class="n">filters</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a>            <span class="k">if</span> <span class="n">key</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">model_columns</span><span class="p">:</span>
+</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a>                    <span class="sa">f</span><span class="s2">&quot;Invalid filter column &#39;</span><span class="si">{</span><span class="n">key</span><span class="si">}</span><span class="s2">&#39;: not found in model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; columns&quot;</span>
+</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a>                <span class="p">)</span>
+</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a>
+</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a>    <span class="k">def</span> <span class="nf">_create_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for creating items in the database.&quot;&quot;&quot;</span>
 </span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334"></a>
-</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a>        <span class="k">return</span> <span class="n">endpoint</span>
-</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a>
-</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a>    <span class="k">def</span> <span class="nf">_read_items</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for reading multiple items from the database.&quot;&quot;&quot;</span>
-</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a>        <span class="n">dynamic_filters</span> <span class="o">=</span> <span class="n">_create_dynamic_filters</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">filter_config</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">column_types</span><span class="p">)</span>
+</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
+</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
+</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a>            <span class="n">item</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">create_schema</span> <span class="o">=</span> <span class="n">Body</span><span class="p">(</span><span class="o">...</span><span class="p">),</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a>        <span class="p">):</span>
+</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a>            <span class="n">unique_columns</span> <span class="o">=</span> <span class="n">_extract_unique_columns</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
 </span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340"></a>
-</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
-</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
-</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a>            <span class="n">offset</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
-</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Offset for unpaginated queries&quot;</span>
-</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a>            <span class="p">),</span>
-</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a>            <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
-</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Limit for unpaginated queries&quot;</span>
-</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a>            <span class="p">),</span>
-</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a>            <span class="n">page</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="s2">&quot;page&quot;</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Page number&quot;</span><span class="p">),</span>
-</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a>            <span class="n">items_per_page</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
-</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="s2">&quot;itemsPerPage&quot;</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Number of items per page&quot;</span>
-</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a>            <span class="p">),</span>
-</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a>            <span class="n">filters</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">dynamic_filters</span><span class="p">),</span>
-</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a>        <span class="p">):</span>
-</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a>            <span class="n">is_paginated</span> <span class="o">=</span> <span class="p">(</span><span class="n">page</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">items_per_page</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a>            <span class="n">has_offset_limit</span> <span class="o">=</span> <span class="p">(</span><span class="n">offset</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a>            <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="n">unique_columns</span><span class="p">:</span>
+</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a>                <span class="n">col_name</span> <span class="o">=</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span>
+</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a>                <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">item</span><span class="p">,</span> <span class="n">col_name</span><span class="p">):</span>
+</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a>                    <span class="n">value</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">item</span><span class="p">,</span> <span class="n">col_name</span><span class="p">)</span>
+</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a>                    <span class="n">exists</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">exists</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="p">{</span><span class="n">col_name</span><span class="p">:</span> <span class="n">value</span><span class="p">})</span>
+</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a>                    <span class="k">if</span> <span class="n">exists</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a>                        <span class="k">raise</span> <span class="n">DuplicateValueException</span><span class="p">(</span>
+</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a>                            <span class="sa">f</span><span class="s2">&quot;Value </span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s2"> is already registered&quot;</span>
+</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a>                        <span class="p">)</span>
+</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a>
+</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a>            <span class="k">return</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">item</span><span class="p">)</span>
+</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a>
+</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a>
+</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a>    <span class="k">def</span> <span class="nf">_read_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for reading a single item from the database.&quot;&quot;&quot;</span>
 </span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357"></a>
-</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a>            <span class="k">if</span> <span class="n">is_paginated</span> <span class="ow">and</span> <span class="n">has_offset_limit</span><span class="p">:</span>
-</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a>                <span class="k">raise</span> <span class="n">BadRequestException</span><span class="p">(</span>
-</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a>                    <span class="n">detail</span><span class="o">=</span><span class="s2">&quot;Conflicting parameters: Use either &#39;page&#39; and &#39;itemsPerPage&#39; for paginated results or &#39;offset&#39; and &#39;limit&#39; for specific range queries.&quot;</span>
-</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a>                <span class="p">)</span>
-</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a>
-</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a>            <span class="k">if</span> <span class="n">is_paginated</span><span class="p">:</span>
-</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a>                <span class="n">offset</span> <span class="o">=</span> <span class="n">compute_offset</span><span class="p">(</span><span class="n">page</span><span class="o">=</span><span class="n">page</span><span class="p">,</span> <span class="n">items_per_page</span><span class="o">=</span><span class="n">items_per_page</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a>                <span class="n">limit</span> <span class="o">=</span> <span class="n">items_per_page</span>
-</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a>                <span class="n">crud_data</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get_multi</span><span class="p">(</span>
-</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a>                    <span class="n">db</span><span class="p">,</span> <span class="n">offset</span><span class="o">=</span><span class="n">offset</span><span class="p">,</span> <span class="n">limit</span><span class="o">=</span><span class="n">limit</span><span class="p">,</span> <span class="o">**</span><span class="n">filters</span>
-</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a>                <span class="p">)</span>
-</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a>                <span class="k">return</span> <span class="n">paginated_response</span><span class="p">(</span>
-</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a>                    <span class="n">crud_data</span><span class="o">=</span><span class="n">crud_data</span><span class="p">,</span>
-</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a>                    <span class="n">page</span><span class="o">=</span><span class="n">page</span><span class="p">,</span> <span class="c1"># type: ignore</span>
-</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a>                    <span class="n">items_per_page</span><span class="o">=</span><span class="n">items_per_page</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a>                <span class="p">)</span>
+</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
+</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
+</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a>            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a>                <span class="n">item</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a>                    <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">cast</span><span class="p">(</span><span class="n">Type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">],</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span><span class="p">),</span>
+</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a>                    <span class="n">return_as_model</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a>                    <span class="o">**</span><span class="n">pkeys</span><span class="p">,</span>
+</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a>                <span class="p">)</span>
+</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a>                <span class="n">item</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
+</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">item</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a>                <span class="k">raise</span> <span class="n">NotFoundException</span><span class="p">(</span><span class="n">detail</span><span class="o">=</span><span class="s2">&quot;Item not found&quot;</span><span class="p">)</span>
+</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a>            <span class="k">return</span> <span class="n">item</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a>
+</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a>        <span class="k">return</span> <span class="n">endpoint</span>
 </span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374"></a>
-</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">has_offset_limit</span><span class="p">:</span>
-</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a>                <span class="n">offset</span> <span class="o">=</span> <span class="mi">0</span>
-</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a>                <span class="n">limit</span> <span class="o">=</span> <span class="mi">100</span>
+</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a>    <span class="k">def</span> <span class="nf">_read_items</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for reading multiple items from the database.&quot;&quot;&quot;</span>
+</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a>        <span class="n">dynamic_filters</span> <span class="o">=</span> <span class="n">_create_dynamic_filters</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">filter_config</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">column_types</span><span class="p">)</span>
 </span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378"></a>
-</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a>            <span class="n">crud_data</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get_multi</span><span class="p">(</span>
-</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a>                <span class="n">db</span><span class="p">,</span>
-</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a>                <span class="n">offset</span><span class="o">=</span><span class="n">offset</span><span class="p">,</span> <span class="c1"># type: ignore</span>
-</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a>                <span class="n">limit</span><span class="o">=</span><span class="n">limit</span><span class="p">,</span> <span class="c1"># type: ignore</span>
-</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a>                <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
-</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a>            <span class="p">)</span>
-</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a>            <span class="k">return</span> <span class="n">crud_data</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a>
-</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a>        <span class="k">return</span> <span class="n">endpoint</span>
-</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a>
-</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a>    <span class="k">def</span> <span class="nf">_update_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for updating an existing item in the database.&quot;&quot;&quot;</span>
-</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a>
-</span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
-</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
-</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a>            <span class="n">item</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">update_schema</span> <span class="o">=</span> <span class="n">Body</span><span class="p">(</span><span class="o">...</span><span class="p">),</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
-</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a>            <span class="o">**</span><span class="n">pkeys</span><span class="p">,</span>
-</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a>        <span class="p">):</span>
-</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a>            <span class="k">return</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">item</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
-</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a>
-</span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400"></a>        <span class="k">return</span> <span class="n">endpoint</span>
-</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a>
-</span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402"></a>    <span class="k">def</span> <span class="nf">_delete_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for deleting an item from the database.&quot;&quot;&quot;</span>
-</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a>
-</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
-</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
-</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
-</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a>            <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;Item deleted successfully&quot;</span><span class="p">}</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a>
-</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
+</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
+</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a>            <span class="n">offset</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
+</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Offset for unpaginated queries&quot;</span>
+</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a>            <span class="p">),</span>
+</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a>            <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
+</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Limit for unpaginated queries&quot;</span>
+</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a>            <span class="p">),</span>
+</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a>            <span class="n">page</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="s2">&quot;page&quot;</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Page number&quot;</span><span class="p">),</span>
+</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a>            <span class="n">items_per_page</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="n">Query</span><span class="p">(</span>
+</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a>                <span class="kc">None</span><span class="p">,</span> <span class="n">alias</span><span class="o">=</span><span class="s2">&quot;itemsPerPage&quot;</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">&quot;Number of items per page&quot;</span>
+</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a>            <span class="p">),</span>
+</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a>            <span class="n">filters</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="n">dynamic_filters</span><span class="p">),</span>
+</span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392"></a>        <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="n">PaginatedListResponse</span><span class="p">,</span> <span class="n">ListResponse</span><span class="p">]:</span>
+</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a>            <span class="n">is_paginated</span> <span class="o">=</span> <span class="p">(</span><span class="n">page</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">or</span> <span class="p">(</span><span class="n">items_per_page</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a>            <span class="n">has_offset_limit</span> <span class="o">=</span> <span class="p">(</span><span class="n">offset</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a>
+</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a>            <span class="k">if</span> <span class="n">is_paginated</span> <span class="ow">and</span> <span class="n">has_offset_limit</span><span class="p">:</span>
+</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a>                <span class="k">raise</span> <span class="n">BadRequestException</span><span class="p">(</span>
+</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a>                    <span class="n">detail</span><span class="o">=</span><span class="s2">&quot;Conflicting parameters: Use either &#39;page&#39; and &#39;itemsPerPage&#39; for paginated results or &#39;offset&#39; and &#39;limit&#39; for specific range queries.&quot;</span>
+</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a>                <span class="p">)</span>
+</span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400"></a>
+</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a>            <span class="k">if</span> <span class="n">is_paginated</span><span class="p">:</span>
+</span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">page</span><span class="p">:</span>
+</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a>                    <span class="n">page</span> <span class="o">=</span> <span class="mi">1</span>
+</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">items_per_page</span><span class="p">:</span>
+</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a>                    <span class="n">items_per_page</span> <span class="o">=</span> <span class="mi">10</span>
+</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a>                <span class="n">offset</span> <span class="o">=</span> <span class="n">compute_offset</span><span class="p">(</span><span class="n">page</span><span class="o">=</span><span class="n">page</span><span class="p">,</span> <span class="n">items_per_page</span><span class="o">=</span><span class="n">items_per_page</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a>                <span class="n">limit</span> <span class="o">=</span> <span class="n">items_per_page</span>
+</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a>            <span class="k">elif</span> <span class="ow">not</span> <span class="n">has_offset_limit</span><span class="p">:</span>
+</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a>                <span class="n">offset</span> <span class="o">=</span> <span class="mi">0</span>
+</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a>                <span class="n">limit</span> <span class="o">=</span> <span class="mi">100</span>
 </span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411"></a>
-</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a>    <span class="k">def</span> <span class="nf">_db_delete</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">        Creates an endpoint for hard deleting an item from the database.</span>
-</span><span id="__span-0-415"><a id="__codelineno-0-415" name="__codelineno-0-415"></a>
-</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">        This endpoint is only added if the `delete_schema` is provided during initialization.</span>
-</span><span id="__span-0-417"><a id="__codelineno-0-417" name="__codelineno-0-417"></a><span class="sd">        The endpoint expects an item ID as a path parameter and uses the provided SQLAlchemy</span>
-</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a><span class="sd">        async session to permanently delete the item from the database.</span>
-</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a>
-</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
-</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
-</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">db_delete</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
-</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a>            <span class="k">return</span> <span class="p">{</span>
-</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a>                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;Item permanently deleted from the database&quot;</span>
-</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a>            <span class="p">}</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a>
-</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a>        <span class="k">return</span> <span class="n">endpoint</span>
-</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a>
-</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a>    <span class="k">def</span> <span class="nf">_get_endpoint_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">operation</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
-</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a>        <span class="n">endpoint_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">endpoint_names</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a>            <span class="n">operation</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">operation</span><span class="p">,</span> <span class="n">operation</span><span class="p">)</span>
-</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a>        <span class="p">)</span>
-</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a>        <span class="n">path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">endpoint_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="k">if</span> <span class="n">endpoint_name</span> <span class="k">else</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
+</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a>            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a>                <span class="n">crud_data</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get_multi</span><span class="p">(</span>
+</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a>                    <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-415"><a id="__codelineno-0-415" name="__codelineno-0-415"></a>                    <span class="n">offset</span><span class="o">=</span><span class="n">offset</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a>                    <span class="n">limit</span><span class="o">=</span><span class="n">limit</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-417"><a id="__codelineno-0-417" name="__codelineno-0-417"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span><span class="p">,</span>
+</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a>                    <span class="n">return_as_model</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a>                    <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
+</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a>                <span class="p">)</span>
+</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a>                <span class="n">crud_data</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get_multi</span><span class="p">(</span>
+</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a>                    <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a>                    <span class="n">offset</span><span class="o">=</span><span class="n">offset</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a>                    <span class="n">limit</span><span class="o">=</span><span class="n">limit</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a>                    <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
+</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a>                <span class="p">)</span>
+</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a>
+</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a>            <span class="k">if</span> <span class="n">is_paginated</span><span class="p">:</span>
+</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a>                <span class="k">return</span> <span class="n">paginated_response</span><span class="p">(</span>
+</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a>                    <span class="n">crud_data</span><span class="o">=</span><span class="n">crud_data</span><span class="p">,</span>
+</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a>                    <span class="n">page</span><span class="o">=</span><span class="n">page</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a>                    <span class="n">items_per_page</span><span class="o">=</span><span class="n">items_per_page</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a>                <span class="p">)</span>
 </span><span id="__span-0-435"><a id="__codelineno-0-435" name="__codelineno-0-435"></a>
-</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a>        <span class="k">if</span> <span class="n">operation</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;read&quot;</span><span class="p">,</span> <span class="s2">&quot;update&quot;</span><span class="p">,</span> <span class="s2">&quot;delete&quot;</span><span class="p">,</span> <span class="s2">&quot;db_delete&quot;</span><span class="p">}:</span>
-</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a>            <span class="n">_primary_keys_path_suffix</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
-</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a>                <span class="sa">f</span><span class="s2">&quot;</span><span class="se">{{</span><span class="si">{</span><span class="n">n</span><span class="si">}</span><span class="se">}}</span><span class="s2">&quot;</span> <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span>
-</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a>            <span class="p">)</span>
-</span><span id="__span-0-440"><a id="__codelineno-0-440" name="__codelineno-0-440"></a>            <span class="n">path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">path</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">_primary_keys_path_suffix</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a>
-</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a>        <span class="k">return</span> <span class="n">path</span>
-</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a>
-</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a>    <span class="k">def</span> <span class="nf">add_routes_to_router</span><span class="p">(</span>
-</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a>        <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a>        <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a>        <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a>        <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a>        <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a>        <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a>        <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a>        <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a>    <span class="p">):</span>
-</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a><span class="sd">        Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</span>
-</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a>
-</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a><span class="sd">        This method registers routes for create, read, update, and delete operations with the FastAPI router,</span>
-</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a><span class="sd">        allowing for custom dependency injection for each type of operation.</span>
+</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">has_offset_limit</span><span class="p">:</span>
+</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a>                <span class="n">offset</span> <span class="o">=</span> <span class="mi">0</span>
+</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a>                <span class="n">limit</span> <span class="o">=</span> <span class="mi">100</span>
+</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a>
+</span><span id="__span-0-440"><a id="__codelineno-0-440" name="__codelineno-0-440"></a>            <span class="n">crud_data</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">get_multi</span><span class="p">(</span>
+</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a>                <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a>                <span class="n">offset</span><span class="o">=</span><span class="n">offset</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a>                <span class="n">limit</span><span class="o">=</span><span class="n">limit</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a>                <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
+</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>            <span class="p">)</span>
+</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a>            <span class="k">return</span> <span class="n">crud_data</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a>
+</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a>
+</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a>    <span class="k">def</span> <span class="nf">_update_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for updating an existing item in the database.&quot;&quot;&quot;</span>
+</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a>
+</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
+</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span>
+</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a>            <span class="n">item</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">update_schema</span> <span class="o">=</span> <span class="n">Body</span><span class="p">(</span><span class="o">...</span><span class="p">),</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a>            <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span>
+</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a>            <span class="o">**</span><span class="n">pkeys</span><span class="p">,</span>
+</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a>        <span class="p">):</span>
+</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a>            <span class="k">return</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">item</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
 </span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a>
-</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a><span class="sd">            create_deps: List of functions to be injected as dependencies for the create endpoint.</span>
-</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a><span class="sd">            read_deps: List of functions to be injected as dependencies for the read endpoint.</span>
-</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a><span class="sd">            read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.</span>
-</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a><span class="sd">            update_deps: List of functions to be injected as dependencies for the update endpoint.</span>
-</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a><span class="sd">            delete_deps: List of functions to be injected as dependencies for the delete endpoint.</span>
-</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a><span class="sd">            db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.</span>
-</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a><span class="sd">            included_methods: Optional list of methods to include. Defaults to all CRUD methods.</span>
-</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a><span class="sd">            deleted_methods: Optional list of methods to exclude. Defaults to `None`.</span>
+</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a>
+</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a>    <span class="k">def</span> <span class="nf">_delete_item</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Creates an endpoint for deleting an item from the database.&quot;&quot;&quot;</span>
+</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a>
+</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
+</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
+</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
+</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a>            <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;Item deleted successfully&quot;</span><span class="p">}</span>  <span class="c1"># pragma: no cover</span>
 </span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a>
-</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a><span class="sd">            ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
-</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>
-</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a><span class="sd">            Selective Endpoint Creation:</span>
+</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a>
+</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>    <span class="k">def</span> <span class="nf">_db_delete</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a><span class="sd">        Creates an endpoint for hard deleting an item from the database.</span>
 </span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a>
-</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a><span class="sd">            # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
-</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="sd">                included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
-</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="sd">            )</span>
-</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">            ```</span>
-</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>
-</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">            Excluding Specific Endpoints:</span>
-</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a>
-</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">            # Create all endpoints except &#39;delete&#39; and &#39;db_delete&#39;</span>
-</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">                deleted_methods=[&quot;delete&quot;, &quot;db_delete&quot;],</span>
-</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">            )</span>
-</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">            ```</span>
-</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>
-</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a><span class="sd">            With Custom Dependencies and Selective Endpoints:</span>
-</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a>
-</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a><span class="sd">            def get_current_user(...):</span>
-</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a><span class="sd">                ...</span>
-</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a>
-</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a><span class="sd">            # Create only &#39;read&#39; and &#39;update&#39; endpoints with custom dependencies</span>
-</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a><span class="sd">                read_deps=[get_current_user],</span>
-</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a><span class="sd">                update_deps=[get_current_user],</span>
-</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a><span class="sd">                included_methods=[&quot;read&quot;, &quot;update&quot;],</span>
-</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a><span class="sd">            )</span>
-</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a><span class="sd">            ```</span>
-</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>
-</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a><span class="sd">        Note:</span>
-</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a><span class="sd">            This method should be called to register the endpoints with the FastAPI application.</span>
-</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a><span class="sd">            If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.</span>
-</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a><span class="sd">            This method assumes `id` is the primary key for path parameters.</span>
-</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">included_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">deleted_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">):</span>
-</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>                <span class="s2">&quot;Cannot use both &#39;included_methods&#39; and &#39;deleted_methods&#39; simultaneously.&quot;</span>
-</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>            <span class="p">)</span>
-</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a>
-</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a>        <span class="k">if</span> <span class="n">included_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>            <span class="n">included_methods</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a>                <span class="s2">&quot;create&quot;</span><span class="p">,</span>
-</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a>                <span class="s2">&quot;read&quot;</span><span class="p">,</span>
-</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>                <span class="s2">&quot;read_multi&quot;</span><span class="p">,</span>
-</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a>                <span class="s2">&quot;update&quot;</span><span class="p">,</span>
-</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a>                <span class="s2">&quot;delete&quot;</span><span class="p">,</span>
-</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a>                <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
-</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a>            <span class="p">]</span>
-</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a>            <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a>                <span class="n">included_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
-</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a>                    <span class="n">valid_methods</span><span class="o">=</span><span class="n">included_methods</span>
-</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a>                <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
-</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in included_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a>
-</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>        <span class="k">if</span> <span class="n">deleted_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a>            <span class="n">deleted_methods</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>            <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a>                <span class="n">deleted_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
-</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a>                    <span class="n">valid_methods</span><span class="o">=</span><span class="n">deleted_methods</span>
-</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a>                <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
-</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in deleted_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a>
-</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>        <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Delete a&quot;</span>
-</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span><span class="p">:</span>
-</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>            <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Soft delete a&quot;</span>
-</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a>
-</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;create&quot;</span><span class="p">),</span>
-</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_create_item</span><span class="p">(),</span>
-</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;POST&quot;</span><span class="p">],</span>
-</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">create_deps</span><span class="p">),</span>
-</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Create a new </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>            <span class="p">)</span>
-</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a>
-</span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read&quot;</span><span class="p">),</span>
-</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_read_item</span><span class="p">(),</span>
-</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
-</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_deps</span><span class="p">),</span>
-</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read a single </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a>            <span class="p">)</span>
-</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a>
-</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read_multi&quot;</span><span class="p">),</span>
-</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_read_items</span><span class="p">(),</span>
-</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
-</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-577"><a id="__codelineno-0-577" name="__codelineno-0-577"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_multi_deps</span><span class="p">),</span>
-</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read multiple </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> rows from the database with a limit and an offset.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>            <span class="p">)</span>
-</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>
-</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;update&quot;</span><span class="p">),</span>
-</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_update_item</span><span class="p">(),</span>
-</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;PATCH&quot;</span><span class="p">],</span>
-</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">update_deps</span><span class="p">),</span>
-</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Update an existing </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>            <span class="p">)</span>
-</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>
-</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>            <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;delete&quot;</span><span class="p">)</span>
-</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a>                <span class="n">path</span><span class="p">,</span>
-</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_delete_item</span><span class="p">(),</span>
-</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
-</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">delete_deps</span><span class="p">),</span>
-</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">delete_description</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a>            <span class="p">)</span>
-</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a>
-</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a>        <span class="k">if</span> <span class="p">(</span>
-</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>            <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span>
-</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a>            <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">)</span>
-</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a>            <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span>
-</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a>        <span class="p">):</span>
-</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;db_delete&quot;</span><span class="p">),</span>
-</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_db_delete</span><span class="p">(),</span>
-</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
-</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">db_delete_deps</span><span class="p">),</span>
-</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Permanently delete a </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>            <span class="p">)</span>
-</span><span id="__span-0-618"><a id="__codelineno-0-618" name="__codelineno-0-618"></a>
-</span><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a>    <span class="k">def</span> <span class="nf">add_custom_route</span><span class="p">(</span>
-</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>        <span class="n">endpoint</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
-</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>        <span class="n">methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">set</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]],</span>
-</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>        <span class="n">path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>        <span class="n">dependencies</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>        <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>        <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>        <span class="n">summary</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>        <span class="n">description</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>        <span class="n">response_description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;Successful Response&quot;</span><span class="p">,</span>
-</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a><span class="sd">        Adds a custom route to the FastAPI router.</span>
-</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a>
-</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a><span class="sd">            endpoint: The endpoint function to execute when the route is called.</span>
-</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="sd">            methods: A list of HTTP methods for the route (e.g., `[&#39;GET&#39;, &#39;POST&#39;]`).</span>
-</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">            path: URL path for the custom route.</span>
-</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a><span class="sd">            dependencies: A list of functions to be injected as dependencies for the route.</span>
-</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a><span class="sd">            include_in_schema: Whether to include this route in the OpenAPI schema.</span>
-</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">            tags: Tags for grouping and categorizing the route in documentation.</span>
-</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">            summary: A short summary of the route, for documentation.</span>
-</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">            description: A detailed description of the route, for documentation.</span>
-</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a><span class="sd">            response_description: A description of the response, for documentation.</span>
-</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>
-</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a><span class="sd">        Example:</span>
-</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a><span class="sd">            async def custom_endpoint(foo: int, bar: str):</span>
-</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a><span class="sd">                # custom logic here</span>
-</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a><span class="sd">                return {&quot;foo&quot;: foo, &quot;bar&quot;: bar}</span>
-</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>
-</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a><span class="sd">            endpoint_creator.add_custom_route(</span>
-</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a><span class="sd">                endpoint=custom_endpoint,</span>
-</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a><span class="sd">                methods=[&quot;GET&quot;],</span>
-</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a><span class="sd">                path=&quot;/custom&quot;,</span>
-</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a><span class="sd">                tags=[&quot;custom&quot;],</span>
-</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a><span class="sd">                summary=&quot;Custom Endpoint&quot;,</span>
-</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a><span class="sd">                description=&quot;This is a custom endpoint.&quot;,</span>
-</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a><span class="sd">            )</span>
-</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a><span class="sd">            ```</span>
-</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">path</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
-</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a>        <span class="n">full_path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}{</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a>            <span class="n">path</span><span class="o">=</span><span class="n">full_path</span><span class="p">,</span>
-</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>            <span class="n">endpoint</span><span class="o">=</span><span class="n">endpoint</span><span class="p">,</span>
-</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a>            <span class="n">methods</span><span class="o">=</span><span class="n">methods</span><span class="p">,</span>
-</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">dependencies</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[],</span>
-</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>            <span class="n">tags</span><span class="o">=</span><span class="n">tags</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a>            <span class="n">summary</span><span class="o">=</span><span class="n">summary</span><span class="p">,</span>
-</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a>            <span class="n">description</span><span class="o">=</span><span class="n">description</span><span class="p">,</span>
-</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>            <span class="n">response_description</span><span class="o">=</span><span class="n">response_description</span><span class="p">,</span>
-</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>        <span class="p">)</span>
+</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a><span class="sd">        This endpoint is only added if the `delete_schema` is provided during initialization.</span>
+</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a><span class="sd">        The endpoint expects an item ID as a path parameter and uses the provided SQLAlchemy</span>
+</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a><span class="sd">        async session to permanently delete the item from the database.</span>
+</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a>
+</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a>        <span class="nd">@_apply_model_pk</span><span class="p">(</span><span class="o">**</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys_types</span><span class="p">)</span>
+</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>        <span class="k">async</span> <span class="k">def</span> <span class="nf">endpoint</span><span class="p">(</span><span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span> <span class="o">=</span> <span class="n">Depends</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="p">),</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">):</span>
+</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">crud</span><span class="o">.</span><span class="n">db_delete</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">pkeys</span><span class="p">)</span>
+</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a>            <span class="k">return</span> <span class="p">{</span>
+</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a>                <span class="s2">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;Item permanently deleted from the database&quot;</span>
+</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a>            <span class="p">}</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a>
+</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a>        <span class="k">return</span> <span class="n">endpoint</span>
+</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a>
+</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a>    <span class="k">def</span> <span class="nf">_get_endpoint_path</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">operation</span><span class="p">:</span> <span class="nb">str</span><span class="p">):</span>
+</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>        <span class="n">endpoint_name</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">endpoint_names</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a>            <span class="n">operation</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">default_endpoint_names</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">operation</span><span class="p">,</span> <span class="n">operation</span><span class="p">)</span>
+</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a>        <span class="p">)</span>
+</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a>        <span class="n">path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">endpoint_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="k">if</span> <span class="n">endpoint_name</span> <span class="k">else</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
+</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a>
+</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a>        <span class="k">if</span> <span class="n">operation</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;read&quot;</span><span class="p">,</span> <span class="s2">&quot;update&quot;</span><span class="p">,</span> <span class="s2">&quot;delete&quot;</span><span class="p">,</span> <span class="s2">&quot;db_delete&quot;</span><span class="p">}:</span>
+</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a>            <span class="n">_primary_keys_path_suffix</span> <span class="o">=</span> <span class="s2">&quot;/&quot;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span>
+</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a>                <span class="sa">f</span><span class="s2">&quot;</span><span class="se">{{</span><span class="si">{</span><span class="n">n</span><span class="si">}</span><span class="se">}}</span><span class="s2">&quot;</span> <span class="k">for</span> <span class="n">n</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span>
+</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a>            <span class="p">)</span>
+</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a>            <span class="n">path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">path</span><span class="si">}</span><span class="s2">/</span><span class="si">{</span><span class="n">_primary_keys_path_suffix</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a>
+</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a>        <span class="k">return</span> <span class="n">path</span>
+</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a>
+</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a>    <span class="k">def</span> <span class="nf">add_routes_to_router</span><span class="p">(</span>
+</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a>        <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a>        <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a>        <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a>        <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a>        <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>        <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>        <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>        <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>    <span class="p">):</span>
+</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a><span class="sd">        Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</span>
+</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>
+</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a><span class="sd">        This method registers routes for create, read, update, and delete operations with the FastAPI router,</span>
+</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a><span class="sd">        allowing for custom dependency injection for each type of operation.</span>
+</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>
+</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a><span class="sd">            create_deps: List of functions to be injected as dependencies for the create endpoint.</span>
+</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a><span class="sd">            read_deps: List of functions to be injected as dependencies for the read endpoint.</span>
+</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a><span class="sd">            read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.</span>
+</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a><span class="sd">            update_deps: List of functions to be injected as dependencies for the update endpoint.</span>
+</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a><span class="sd">            delete_deps: List of functions to be injected as dependencies for the delete endpoint.</span>
+</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a><span class="sd">            db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.</span>
+</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a><span class="sd">            included_methods: Optional list of methods to include. Defaults to all CRUD methods.</span>
+</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a><span class="sd">            deleted_methods: Optional list of methods to exclude. Defaults to `None`.</span>
+</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>
+</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a><span class="sd">            ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
+</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>
+</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a><span class="sd">            Selective Endpoint Creation:</span>
+</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>
+</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a><span class="sd">            # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
+</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a><span class="sd">                included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
+</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a><span class="sd">            )</span>
+</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a><span class="sd">            ```</span>
+</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>
+</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a><span class="sd">            Excluding Specific Endpoints:</span>
+</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>
+</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a><span class="sd">            # Create all endpoints except &#39;delete&#39; and &#39;db_delete&#39;</span>
+</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a><span class="sd">                deleted_methods=[&quot;delete&quot;, &quot;db_delete&quot;],</span>
+</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a><span class="sd">            )</span>
+</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a><span class="sd">            ```</span>
+</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>
+</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a><span class="sd">            With Custom Dependencies and Selective Endpoints:</span>
+</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>
+</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a><span class="sd">            def get_current_user(...):</span>
+</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a><span class="sd">                ...</span>
+</span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>
+</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a><span class="sd">            # Create only &#39;read&#39; and &#39;update&#39; endpoints with custom dependencies</span>
+</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a><span class="sd">            endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a><span class="sd">                read_deps=[get_current_user],</span>
+</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a><span class="sd">                update_deps=[get_current_user],</span>
+</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a><span class="sd">                included_methods=[&quot;read&quot;, &quot;update&quot;],</span>
+</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a><span class="sd">            )</span>
+</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a><span class="sd">            ```</span>
+</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>
+</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a><span class="sd">        Note:</span>
+</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a><span class="sd">            This method should be called to register the endpoints with the FastAPI application.</span>
+</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a><span class="sd">            If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.</span>
+</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a><span class="sd">            This method assumes `id` is the primary key for path parameters.</span>
+</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">included_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">deleted_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">):</span>
+</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>                <span class="s2">&quot;Cannot use both &#39;included_methods&#39; and &#39;deleted_methods&#39; simultaneously.&quot;</span>
+</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>            <span class="p">)</span>
+</span><span id="__span-0-577"><a id="__codelineno-0-577" name="__codelineno-0-577"></a>
+</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>        <span class="k">if</span> <span class="n">included_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>            <span class="n">included_methods</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>                <span class="s2">&quot;create&quot;</span><span class="p">,</span>
+</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>                <span class="s2">&quot;read&quot;</span><span class="p">,</span>
+</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>                <span class="s2">&quot;read_multi&quot;</span><span class="p">,</span>
+</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>                <span class="s2">&quot;update&quot;</span><span class="p">,</span>
+</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>                <span class="s2">&quot;delete&quot;</span><span class="p">,</span>
+</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>                <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
+</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>            <span class="p">]</span>
+</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>                <span class="n">included_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
+</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>                    <span class="n">valid_methods</span><span class="o">=</span><span class="n">included_methods</span>
+</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>                <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
+</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in included_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a>
+</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a>        <span class="k">if</span> <span class="n">deleted_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>            <span class="n">deleted_methods</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a>                <span class="n">deleted_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
+</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a>                    <span class="n">valid_methods</span><span class="o">=</span><span class="n">deleted_methods</span>
+</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a>                <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
+</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in deleted_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a>
+</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>        <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Delete a&quot;</span>
+</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span><span class="p">:</span>
+</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a>            <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Soft delete a&quot;</span>
+</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a>
+</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;create&quot;</span><span class="p">),</span>
+</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_create_item</span><span class="p">(),</span>
+</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;POST&quot;</span><span class="p">],</span>
+</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">create_deps</span><span class="p">),</span>
+</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Create a new </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-618"><a id="__codelineno-0-618" name="__codelineno-0-618"></a>            <span class="p">)</span>
+</span><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a>
+</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read&quot;</span><span class="p">),</span>
+</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_read_item</span><span class="p">(),</span>
+</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
+</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_deps</span><span class="p">),</span>
+</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>                <span class="n">response_model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read a single </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>            <span class="p">)</span>
+</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a>
+</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a>            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>                <span class="n">response_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span>
+</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a>                    <span class="n">Type</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">PaginatedListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">],</span> <span class="n">ListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">]]]</span>
+</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a>                <span class="p">]</span> <span class="o">=</span> <span class="n">Union</span><span class="p">[</span>
+</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">paginated_response_model</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">list_response_model</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a>                <span class="p">]</span>
+</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a>                <span class="n">response_model</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a>
+</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read_multi&quot;</span><span class="p">),</span>
+</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_read_items</span><span class="p">(),</span>
+</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
+</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_multi_deps</span><span class="p">),</span>
+</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>                <span class="n">response_model</span><span class="o">=</span><span class="n">response_model</span><span class="p">,</span>
+</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>                <span class="n">description</span><span class="o">=</span><span class="p">(</span>
+</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>                    <span class="sa">f</span><span class="s2">&quot;Read multiple </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> rows from the database.</span><span class="se">\n\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a>                    <span class="sa">f</span><span class="s2">&quot;- Use page &amp; itemsPerPage for paginated results</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a>                    <span class="sa">f</span><span class="s2">&quot;- Use offset &amp; limit for specific ranges</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>                    <span class="sa">f</span><span class="s2">&quot;- Returns paginated response when using page/itemsPerPage</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a>                    <span class="sa">f</span><span class="s2">&quot;- Returns simple list response when using offset/limit&quot;</span>
+</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a>                <span class="p">),</span>
+</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a>            <span class="p">)</span>
+</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>
+</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;update&quot;</span><span class="p">),</span>
+</span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_update_item</span><span class="p">(),</span>
+</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;PATCH&quot;</span><span class="p">],</span>
+</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">update_deps</span><span class="p">),</span>
+</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Update an existing </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>            <span class="p">)</span>
+</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a>
+</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a>        <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>            <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;delete&quot;</span><span class="p">)</span>
+</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a>                <span class="n">path</span><span class="p">,</span>
+</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_delete_item</span><span class="p">(),</span>
+</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
+</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">delete_deps</span><span class="p">),</span>
+</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">delete_description</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a>            <span class="p">)</span>
+</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a>
+</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a>        <span class="k">if</span> <span class="p">(</span>
+</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a>            <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span>
+</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a>            <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">)</span>
+</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a>            <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span>
+</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a>        <span class="p">):</span>
+</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;db_delete&quot;</span><span class="p">),</span>
+</span><span id="__span-0-690"><a id="__codelineno-0-690" name="__codelineno-0-690"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_db_delete</span><span class="p">(),</span>
+</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a>                <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
+</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a>                <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a>                <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a>                <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">db_delete_deps</span><span class="p">),</span>
+</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a>                <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Permanently delete a </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a>            <span class="p">)</span>
+</span><span id="__span-0-697"><a id="__codelineno-0-697" name="__codelineno-0-697"></a>
+</span><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a>    <span class="k">def</span> <span class="nf">add_custom_route</span><span class="p">(</span>
+</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a>        <span class="n">endpoint</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
+</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a>        <span class="n">methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">set</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]],</span>
+</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a>        <span class="n">path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a>        <span class="n">dependencies</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a>        <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a>        <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a>        <span class="n">summary</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a>        <span class="n">description</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a>        <span class="n">response_description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;Successful Response&quot;</span><span class="p">,</span>
+</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a><span class="sd">        Adds a custom route to the FastAPI router.</span>
+</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>
+</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-714"><a id="__codelineno-0-714" name="__codelineno-0-714"></a><span class="sd">            endpoint: The endpoint function to execute when the route is called.</span>
+</span><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a><span class="sd">            methods: A list of HTTP methods for the route (e.g., `[&#39;GET&#39;, &#39;POST&#39;]`).</span>
+</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a><span class="sd">            path: URL path for the custom route.</span>
+</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a><span class="sd">            dependencies: A list of functions to be injected as dependencies for the route.</span>
+</span><span id="__span-0-718"><a id="__codelineno-0-718" name="__codelineno-0-718"></a><span class="sd">            include_in_schema: Whether to include this route in the OpenAPI schema.</span>
+</span><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a><span class="sd">            tags: Tags for grouping and categorizing the route in documentation.</span>
+</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a><span class="sd">            summary: A short summary of the route, for documentation.</span>
+</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a><span class="sd">            description: A detailed description of the route, for documentation.</span>
+</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a><span class="sd">            response_description: A description of the response, for documentation.</span>
+</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a>
+</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a><span class="sd">        Example:</span>
+</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a><span class="sd">            async def custom_endpoint(foo: int, bar: str):</span>
+</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a><span class="sd">                # custom logic here</span>
+</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">                return {&quot;foo&quot;: foo, &quot;bar&quot;: bar}</span>
+</span><span id="__span-0-729"><a id="__codelineno-0-729" name="__codelineno-0-729"></a>
+</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">            endpoint_creator.add_custom_route(</span>
+</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a><span class="sd">                endpoint=custom_endpoint,</span>
+</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">                methods=[&quot;GET&quot;],</span>
+</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a><span class="sd">                path=&quot;/custom&quot;,</span>
+</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">                tags=[&quot;custom&quot;],</span>
+</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">                summary=&quot;Custom Endpoint&quot;,</span>
+</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a><span class="sd">                description=&quot;This is a custom endpoint.&quot;,</span>
+</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">            )</span>
+</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">            ```</span>
+</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a>        <span class="n">path</span> <span class="o">=</span> <span class="n">path</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
+</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a>        <span class="n">full_path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}{</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a>            <span class="n">path</span><span class="o">=</span><span class="n">full_path</span><span class="p">,</span>
+</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a>            <span class="n">endpoint</span><span class="o">=</span><span class="n">endpoint</span><span class="p">,</span>
+</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a>            <span class="n">methods</span><span class="o">=</span><span class="n">methods</span><span class="p">,</span>
+</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">dependencies</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[],</span>
+</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a>            <span class="n">tags</span><span class="o">=</span><span class="n">tags</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-749"><a id="__codelineno-0-749" name="__codelineno-0-749"></a>            <span class="n">summary</span><span class="o">=</span><span class="n">summary</span><span class="p">,</span>
+</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a>            <span class="n">description</span><span class="o">=</span><span class="n">description</span><span class="p">,</span>
+</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a>            <span class="n">response_description</span><span class="o">=</span><span class="n">response_description</span><span class="p">,</span>
+</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a>        <span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
             </details>
 
@@ -3082,115 +3306,115 @@ <h2 id="fastcrud.EndpointCreator.add_custom_route" class="doc doc-heading">
 </details>
           <details class="quote">
             <summary>Source code in <code>fastcrud/endpoint/endpoint_creator.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-619">619</a></span>
-<span class="normal"><a href="#__codelineno-0-620">620</a></span>
-<span class="normal"><a href="#__codelineno-0-621">621</a></span>
-<span class="normal"><a href="#__codelineno-0-622">622</a></span>
-<span class="normal"><a href="#__codelineno-0-623">623</a></span>
-<span class="normal"><a href="#__codelineno-0-624">624</a></span>
-<span class="normal"><a href="#__codelineno-0-625">625</a></span>
-<span class="normal"><a href="#__codelineno-0-626">626</a></span>
-<span class="normal"><a href="#__codelineno-0-627">627</a></span>
-<span class="normal"><a href="#__codelineno-0-628">628</a></span>
-<span class="normal"><a href="#__codelineno-0-629">629</a></span>
-<span class="normal"><a href="#__codelineno-0-630">630</a></span>
-<span class="normal"><a href="#__codelineno-0-631">631</a></span>
-<span class="normal"><a href="#__codelineno-0-632">632</a></span>
-<span class="normal"><a href="#__codelineno-0-633">633</a></span>
-<span class="normal"><a href="#__codelineno-0-634">634</a></span>
-<span class="normal"><a href="#__codelineno-0-635">635</a></span>
-<span class="normal"><a href="#__codelineno-0-636">636</a></span>
-<span class="normal"><a href="#__codelineno-0-637">637</a></span>
-<span class="normal"><a href="#__codelineno-0-638">638</a></span>
-<span class="normal"><a href="#__codelineno-0-639">639</a></span>
-<span class="normal"><a href="#__codelineno-0-640">640</a></span>
-<span class="normal"><a href="#__codelineno-0-641">641</a></span>
-<span class="normal"><a href="#__codelineno-0-642">642</a></span>
-<span class="normal"><a href="#__codelineno-0-643">643</a></span>
-<span class="normal"><a href="#__codelineno-0-644">644</a></span>
-<span class="normal"><a href="#__codelineno-0-645">645</a></span>
-<span class="normal"><a href="#__codelineno-0-646">646</a></span>
-<span class="normal"><a href="#__codelineno-0-647">647</a></span>
-<span class="normal"><a href="#__codelineno-0-648">648</a></span>
-<span class="normal"><a href="#__codelineno-0-649">649</a></span>
-<span class="normal"><a href="#__codelineno-0-650">650</a></span>
-<span class="normal"><a href="#__codelineno-0-651">651</a></span>
-<span class="normal"><a href="#__codelineno-0-652">652</a></span>
-<span class="normal"><a href="#__codelineno-0-653">653</a></span>
-<span class="normal"><a href="#__codelineno-0-654">654</a></span>
-<span class="normal"><a href="#__codelineno-0-655">655</a></span>
-<span class="normal"><a href="#__codelineno-0-656">656</a></span>
-<span class="normal"><a href="#__codelineno-0-657">657</a></span>
-<span class="normal"><a href="#__codelineno-0-658">658</a></span>
-<span class="normal"><a href="#__codelineno-0-659">659</a></span>
-<span class="normal"><a href="#__codelineno-0-660">660</a></span>
-<span class="normal"><a href="#__codelineno-0-661">661</a></span>
-<span class="normal"><a href="#__codelineno-0-662">662</a></span>
-<span class="normal"><a href="#__codelineno-0-663">663</a></span>
-<span class="normal"><a href="#__codelineno-0-664">664</a></span>
-<span class="normal"><a href="#__codelineno-0-665">665</a></span>
-<span class="normal"><a href="#__codelineno-0-666">666</a></span>
-<span class="normal"><a href="#__codelineno-0-667">667</a></span>
-<span class="normal"><a href="#__codelineno-0-668">668</a></span>
-<span class="normal"><a href="#__codelineno-0-669">669</a></span>
-<span class="normal"><a href="#__codelineno-0-670">670</a></span>
-<span class="normal"><a href="#__codelineno-0-671">671</a></span>
-<span class="normal"><a href="#__codelineno-0-672">672</a></span>
-<span class="normal"><a href="#__codelineno-0-673">673</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a><span class="k">def</span> <span class="nf">add_custom_route</span><span class="p">(</span>
-</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>    <span class="n">endpoint</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
-</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>    <span class="n">methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">set</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]],</span>
-</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>    <span class="n">path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>    <span class="n">dependencies</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>    <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>    <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>    <span class="n">summary</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>    <span class="n">description</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>    <span class="n">response_description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;Successful Response&quot;</span><span class="p">,</span>
-</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a><span class="sd">    Adds a custom route to the FastAPI router.</span>
-</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a>
-</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a><span class="sd">        endpoint: The endpoint function to execute when the route is called.</span>
-</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="sd">        methods: A list of HTTP methods for the route (e.g., `[&#39;GET&#39;, &#39;POST&#39;]`).</span>
-</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">        path: URL path for the custom route.</span>
-</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a><span class="sd">        dependencies: A list of functions to be injected as dependencies for the route.</span>
-</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a><span class="sd">        include_in_schema: Whether to include this route in the OpenAPI schema.</span>
-</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">        tags: Tags for grouping and categorizing the route in documentation.</span>
-</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">        summary: A short summary of the route, for documentation.</span>
-</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">        description: A detailed description of the route, for documentation.</span>
-</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a><span class="sd">        response_description: A description of the response, for documentation.</span>
-</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>
-</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a><span class="sd">    Example:</span>
-</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a><span class="sd">        async def custom_endpoint(foo: int, bar: str):</span>
-</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a><span class="sd">            # custom logic here</span>
-</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a><span class="sd">            return {&quot;foo&quot;: foo, &quot;bar&quot;: bar}</span>
-</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>
-</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a><span class="sd">        endpoint_creator.add_custom_route(</span>
-</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a><span class="sd">            endpoint=custom_endpoint,</span>
-</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a><span class="sd">            methods=[&quot;GET&quot;],</span>
-</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a><span class="sd">            path=&quot;/custom&quot;,</span>
-</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a><span class="sd">            tags=[&quot;custom&quot;],</span>
-</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a><span class="sd">            summary=&quot;Custom Endpoint&quot;,</span>
-</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a><span class="sd">            description=&quot;This is a custom endpoint.&quot;,</span>
-</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a><span class="sd">        )</span>
-</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a><span class="sd">        ```</span>
-</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>    <span class="n">path</span> <span class="o">=</span> <span class="n">path</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
-</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a>    <span class="n">full_path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}{</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a>        <span class="n">path</span><span class="o">=</span><span class="n">full_path</span><span class="p">,</span>
-</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>        <span class="n">endpoint</span><span class="o">=</span><span class="n">endpoint</span><span class="p">,</span>
-</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a>        <span class="n">methods</span><span class="o">=</span><span class="n">methods</span><span class="p">,</span>
-</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>        <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">dependencies</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[],</span>
-</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a>        <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>        <span class="n">tags</span><span class="o">=</span><span class="n">tags</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a>        <span class="n">summary</span><span class="o">=</span><span class="n">summary</span><span class="p">,</span>
-</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a>        <span class="n">description</span><span class="o">=</span><span class="n">description</span><span class="p">,</span>
-</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>        <span class="n">response_description</span><span class="o">=</span><span class="n">response_description</span><span class="p">,</span>
-</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>    <span class="p">)</span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-698">698</a></span>
+<span class="normal"><a href="#__codelineno-0-699">699</a></span>
+<span class="normal"><a href="#__codelineno-0-700">700</a></span>
+<span class="normal"><a href="#__codelineno-0-701">701</a></span>
+<span class="normal"><a href="#__codelineno-0-702">702</a></span>
+<span class="normal"><a href="#__codelineno-0-703">703</a></span>
+<span class="normal"><a href="#__codelineno-0-704">704</a></span>
+<span class="normal"><a href="#__codelineno-0-705">705</a></span>
+<span class="normal"><a href="#__codelineno-0-706">706</a></span>
+<span class="normal"><a href="#__codelineno-0-707">707</a></span>
+<span class="normal"><a href="#__codelineno-0-708">708</a></span>
+<span class="normal"><a href="#__codelineno-0-709">709</a></span>
+<span class="normal"><a href="#__codelineno-0-710">710</a></span>
+<span class="normal"><a href="#__codelineno-0-711">711</a></span>
+<span class="normal"><a href="#__codelineno-0-712">712</a></span>
+<span class="normal"><a href="#__codelineno-0-713">713</a></span>
+<span class="normal"><a href="#__codelineno-0-714">714</a></span>
+<span class="normal"><a href="#__codelineno-0-715">715</a></span>
+<span class="normal"><a href="#__codelineno-0-716">716</a></span>
+<span class="normal"><a href="#__codelineno-0-717">717</a></span>
+<span class="normal"><a href="#__codelineno-0-718">718</a></span>
+<span class="normal"><a href="#__codelineno-0-719">719</a></span>
+<span class="normal"><a href="#__codelineno-0-720">720</a></span>
+<span class="normal"><a href="#__codelineno-0-721">721</a></span>
+<span class="normal"><a href="#__codelineno-0-722">722</a></span>
+<span class="normal"><a href="#__codelineno-0-723">723</a></span>
+<span class="normal"><a href="#__codelineno-0-724">724</a></span>
+<span class="normal"><a href="#__codelineno-0-725">725</a></span>
+<span class="normal"><a href="#__codelineno-0-726">726</a></span>
+<span class="normal"><a href="#__codelineno-0-727">727</a></span>
+<span class="normal"><a href="#__codelineno-0-728">728</a></span>
+<span class="normal"><a href="#__codelineno-0-729">729</a></span>
+<span class="normal"><a href="#__codelineno-0-730">730</a></span>
+<span class="normal"><a href="#__codelineno-0-731">731</a></span>
+<span class="normal"><a href="#__codelineno-0-732">732</a></span>
+<span class="normal"><a href="#__codelineno-0-733">733</a></span>
+<span class="normal"><a href="#__codelineno-0-734">734</a></span>
+<span class="normal"><a href="#__codelineno-0-735">735</a></span>
+<span class="normal"><a href="#__codelineno-0-736">736</a></span>
+<span class="normal"><a href="#__codelineno-0-737">737</a></span>
+<span class="normal"><a href="#__codelineno-0-738">738</a></span>
+<span class="normal"><a href="#__codelineno-0-739">739</a></span>
+<span class="normal"><a href="#__codelineno-0-740">740</a></span>
+<span class="normal"><a href="#__codelineno-0-741">741</a></span>
+<span class="normal"><a href="#__codelineno-0-742">742</a></span>
+<span class="normal"><a href="#__codelineno-0-743">743</a></span>
+<span class="normal"><a href="#__codelineno-0-744">744</a></span>
+<span class="normal"><a href="#__codelineno-0-745">745</a></span>
+<span class="normal"><a href="#__codelineno-0-746">746</a></span>
+<span class="normal"><a href="#__codelineno-0-747">747</a></span>
+<span class="normal"><a href="#__codelineno-0-748">748</a></span>
+<span class="normal"><a href="#__codelineno-0-749">749</a></span>
+<span class="normal"><a href="#__codelineno-0-750">750</a></span>
+<span class="normal"><a href="#__codelineno-0-751">751</a></span>
+<span class="normal"><a href="#__codelineno-0-752">752</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a><span class="k">def</span> <span class="nf">add_custom_route</span><span class="p">(</span>
+</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a>    <span class="n">endpoint</span><span class="p">:</span> <span class="n">Callable</span><span class="p">,</span>
+</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a>    <span class="n">methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">set</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]],</span>
+</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a>    <span class="n">path</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a>    <span class="n">dependencies</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a>    <span class="n">include_in_schema</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a>    <span class="n">tags</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Enum</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a>    <span class="n">summary</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a>    <span class="n">description</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a>    <span class="n">response_description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;Successful Response&quot;</span><span class="p">,</span>
+</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a><span class="sd">    Adds a custom route to the FastAPI router.</span>
+</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>
+</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-714"><a id="__codelineno-0-714" name="__codelineno-0-714"></a><span class="sd">        endpoint: The endpoint function to execute when the route is called.</span>
+</span><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a><span class="sd">        methods: A list of HTTP methods for the route (e.g., `[&#39;GET&#39;, &#39;POST&#39;]`).</span>
+</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a><span class="sd">        path: URL path for the custom route.</span>
+</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a><span class="sd">        dependencies: A list of functions to be injected as dependencies for the route.</span>
+</span><span id="__span-0-718"><a id="__codelineno-0-718" name="__codelineno-0-718"></a><span class="sd">        include_in_schema: Whether to include this route in the OpenAPI schema.</span>
+</span><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a><span class="sd">        tags: Tags for grouping and categorizing the route in documentation.</span>
+</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a><span class="sd">        summary: A short summary of the route, for documentation.</span>
+</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a><span class="sd">        description: A detailed description of the route, for documentation.</span>
+</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a><span class="sd">        response_description: A description of the response, for documentation.</span>
+</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a>
+</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a><span class="sd">    Example:</span>
+</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a><span class="sd">        async def custom_endpoint(foo: int, bar: str):</span>
+</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a><span class="sd">            # custom logic here</span>
+</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">            return {&quot;foo&quot;: foo, &quot;bar&quot;: bar}</span>
+</span><span id="__span-0-729"><a id="__codelineno-0-729" name="__codelineno-0-729"></a>
+</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">        endpoint_creator.add_custom_route(</span>
+</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a><span class="sd">            endpoint=custom_endpoint,</span>
+</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">            methods=[&quot;GET&quot;],</span>
+</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a><span class="sd">            path=&quot;/custom&quot;,</span>
+</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">            tags=[&quot;custom&quot;],</span>
+</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">            summary=&quot;Custom Endpoint&quot;,</span>
+</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a><span class="sd">            description=&quot;This is a custom endpoint.&quot;,</span>
+</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">        )</span>
+</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">        ```</span>
+</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a>    <span class="n">path</span> <span class="o">=</span> <span class="n">path</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">path</span>
+</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a>    <span class="n">full_path</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">path</span><span class="si">}{</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a>    <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a>        <span class="n">path</span><span class="o">=</span><span class="n">full_path</span><span class="p">,</span>
+</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a>        <span class="n">endpoint</span><span class="o">=</span><span class="n">endpoint</span><span class="p">,</span>
+</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a>        <span class="n">methods</span><span class="o">=</span><span class="n">methods</span><span class="p">,</span>
+</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a>        <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">dependencies</span><span class="p">)</span> <span class="ow">or</span> <span class="p">[],</span>
+</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a>        <span class="n">include_in_schema</span><span class="o">=</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a>        <span class="n">tags</span><span class="o">=</span><span class="n">tags</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-749"><a id="__codelineno-0-749" name="__codelineno-0-749"></a>        <span class="n">summary</span><span class="o">=</span><span class="n">summary</span><span class="p">,</span>
+</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a>        <span class="n">description</span><span class="o">=</span><span class="n">description</span><span class="p">,</span>
+</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a>        <span class="n">response_description</span><span class="o">=</span><span class="n">response_description</span><span class="p">,</span>
+</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a>    <span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -3401,68 +3625,7 @@ <h2 id="fastcrud.EndpointCreator.add_routes_to_router" class="doc doc-heading">
 </details>
           <details class="quote">
             <summary>Source code in <code>fastcrud/endpoint/endpoint_creator.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-444">444</a></span>
-<span class="normal"><a href="#__codelineno-0-445">445</a></span>
-<span class="normal"><a href="#__codelineno-0-446">446</a></span>
-<span class="normal"><a href="#__codelineno-0-447">447</a></span>
-<span class="normal"><a href="#__codelineno-0-448">448</a></span>
-<span class="normal"><a href="#__codelineno-0-449">449</a></span>
-<span class="normal"><a href="#__codelineno-0-450">450</a></span>
-<span class="normal"><a href="#__codelineno-0-451">451</a></span>
-<span class="normal"><a href="#__codelineno-0-452">452</a></span>
-<span class="normal"><a href="#__codelineno-0-453">453</a></span>
-<span class="normal"><a href="#__codelineno-0-454">454</a></span>
-<span class="normal"><a href="#__codelineno-0-455">455</a></span>
-<span class="normal"><a href="#__codelineno-0-456">456</a></span>
-<span class="normal"><a href="#__codelineno-0-457">457</a></span>
-<span class="normal"><a href="#__codelineno-0-458">458</a></span>
-<span class="normal"><a href="#__codelineno-0-459">459</a></span>
-<span class="normal"><a href="#__codelineno-0-460">460</a></span>
-<span class="normal"><a href="#__codelineno-0-461">461</a></span>
-<span class="normal"><a href="#__codelineno-0-462">462</a></span>
-<span class="normal"><a href="#__codelineno-0-463">463</a></span>
-<span class="normal"><a href="#__codelineno-0-464">464</a></span>
-<span class="normal"><a href="#__codelineno-0-465">465</a></span>
-<span class="normal"><a href="#__codelineno-0-466">466</a></span>
-<span class="normal"><a href="#__codelineno-0-467">467</a></span>
-<span class="normal"><a href="#__codelineno-0-468">468</a></span>
-<span class="normal"><a href="#__codelineno-0-469">469</a></span>
-<span class="normal"><a href="#__codelineno-0-470">470</a></span>
-<span class="normal"><a href="#__codelineno-0-471">471</a></span>
-<span class="normal"><a href="#__codelineno-0-472">472</a></span>
-<span class="normal"><a href="#__codelineno-0-473">473</a></span>
-<span class="normal"><a href="#__codelineno-0-474">474</a></span>
-<span class="normal"><a href="#__codelineno-0-475">475</a></span>
-<span class="normal"><a href="#__codelineno-0-476">476</a></span>
-<span class="normal"><a href="#__codelineno-0-477">477</a></span>
-<span class="normal"><a href="#__codelineno-0-478">478</a></span>
-<span class="normal"><a href="#__codelineno-0-479">479</a></span>
-<span class="normal"><a href="#__codelineno-0-480">480</a></span>
-<span class="normal"><a href="#__codelineno-0-481">481</a></span>
-<span class="normal"><a href="#__codelineno-0-482">482</a></span>
-<span class="normal"><a href="#__codelineno-0-483">483</a></span>
-<span class="normal"><a href="#__codelineno-0-484">484</a></span>
-<span class="normal"><a href="#__codelineno-0-485">485</a></span>
-<span class="normal"><a href="#__codelineno-0-486">486</a></span>
-<span class="normal"><a href="#__codelineno-0-487">487</a></span>
-<span class="normal"><a href="#__codelineno-0-488">488</a></span>
-<span class="normal"><a href="#__codelineno-0-489">489</a></span>
-<span class="normal"><a href="#__codelineno-0-490">490</a></span>
-<span class="normal"><a href="#__codelineno-0-491">491</a></span>
-<span class="normal"><a href="#__codelineno-0-492">492</a></span>
-<span class="normal"><a href="#__codelineno-0-493">493</a></span>
-<span class="normal"><a href="#__codelineno-0-494">494</a></span>
-<span class="normal"><a href="#__codelineno-0-495">495</a></span>
-<span class="normal"><a href="#__codelineno-0-496">496</a></span>
-<span class="normal"><a href="#__codelineno-0-497">497</a></span>
-<span class="normal"><a href="#__codelineno-0-498">498</a></span>
-<span class="normal"><a href="#__codelineno-0-499">499</a></span>
-<span class="normal"><a href="#__codelineno-0-500">500</a></span>
-<span class="normal"><a href="#__codelineno-0-501">501</a></span>
-<span class="normal"><a href="#__codelineno-0-502">502</a></span>
-<span class="normal"><a href="#__codelineno-0-503">503</a></span>
-<span class="normal"><a href="#__codelineno-0-504">504</a></span>
-<span class="normal"><a href="#__codelineno-0-505">505</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-505">505</a></span>
 <span class="normal"><a href="#__codelineno-0-506">506</a></span>
 <span class="normal"><a href="#__codelineno-0-507">507</a></span>
 <span class="normal"><a href="#__codelineno-0-508">508</a></span>
@@ -3574,180 +3737,277 @@ <h2 id="fastcrud.EndpointCreator.add_routes_to_router" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-614">614</a></span>
 <span class="normal"><a href="#__codelineno-0-615">615</a></span>
 <span class="normal"><a href="#__codelineno-0-616">616</a></span>
-<span class="normal"><a href="#__codelineno-0-617">617</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a><span class="k">def</span> <span class="nf">add_routes_to_router</span><span class="p">(</span>
-</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a>    <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a>    <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a>    <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a>    <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a>    <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a>    <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
-</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a>    <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a>    <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a><span class="p">):</span>
-</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a><span class="sd">    Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</span>
-</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a>
-</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a><span class="sd">    This method registers routes for create, read, update, and delete operations with the FastAPI router,</span>
-</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a><span class="sd">    allowing for custom dependency injection for each type of operation.</span>
-</span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a>
-</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a><span class="sd">        create_deps: List of functions to be injected as dependencies for the create endpoint.</span>
-</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a><span class="sd">        read_deps: List of functions to be injected as dependencies for the read endpoint.</span>
-</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a><span class="sd">        read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.</span>
-</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a><span class="sd">        update_deps: List of functions to be injected as dependencies for the update endpoint.</span>
-</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a><span class="sd">        delete_deps: List of functions to be injected as dependencies for the delete endpoint.</span>
-</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a><span class="sd">        db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.</span>
-</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a><span class="sd">        included_methods: Optional list of methods to include. Defaults to all CRUD methods.</span>
-</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a><span class="sd">        deleted_methods: Optional list of methods to exclude. Defaults to `None`.</span>
-</span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a>
-</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
-</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>
-</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a><span class="sd">        Selective Endpoint Creation:</span>
-</span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a>
-</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a><span class="sd">        # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
-</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
-</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="sd">        )</span>
-</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">        ```</span>
-</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>
-</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">        Excluding Specific Endpoints:</span>
-</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a>
-</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">        # Create all endpoints except &#39;delete&#39; and &#39;db_delete&#39;</span>
-</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">            deleted_methods=[&quot;delete&quot;, &quot;db_delete&quot;],</span>
-</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">        )</span>
-</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">        ```</span>
-</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>
-</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a><span class="sd">        With Custom Dependencies and Selective Endpoints:</span>
-</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a>
-</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a><span class="sd">        def get_current_user(...):</span>
-</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a><span class="sd">            ...</span>
-</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a>
-</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a><span class="sd">        # Create only &#39;read&#39; and &#39;update&#39; endpoints with custom dependencies</span>
-</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
-</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a><span class="sd">            read_deps=[get_current_user],</span>
-</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a><span class="sd">            update_deps=[get_current_user],</span>
-</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a><span class="sd">            included_methods=[&quot;read&quot;, &quot;update&quot;],</span>
-</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a><span class="sd">        )</span>
-</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a><span class="sd">        ```</span>
-</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>
-</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a><span class="sd">    Note:</span>
-</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a><span class="sd">        This method should be called to register the endpoints with the FastAPI application.</span>
-</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a><span class="sd">        If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.</span>
-</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a><span class="sd">        This method assumes `id` is the primary key for path parameters.</span>
-</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">included_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">deleted_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">):</span>
-</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>            <span class="s2">&quot;Cannot use both &#39;included_methods&#39; and &#39;deleted_methods&#39; simultaneously.&quot;</span>
-</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>        <span class="p">)</span>
-</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a>
-</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a>    <span class="k">if</span> <span class="n">included_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>        <span class="n">included_methods</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a>            <span class="s2">&quot;create&quot;</span><span class="p">,</span>
-</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a>            <span class="s2">&quot;read&quot;</span><span class="p">,</span>
-</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>            <span class="s2">&quot;read_multi&quot;</span><span class="p">,</span>
-</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a>            <span class="s2">&quot;update&quot;</span><span class="p">,</span>
-</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a>            <span class="s2">&quot;delete&quot;</span><span class="p">,</span>
-</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a>            <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
-</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a>        <span class="p">]</span>
-</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a>        <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a>            <span class="n">included_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
-</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a>                <span class="n">valid_methods</span><span class="o">=</span><span class="n">included_methods</span>
-</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a>            <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
-</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in included_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a>
-</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>    <span class="k">if</span> <span class="n">deleted_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a>        <span class="n">deleted_methods</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>        <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a>            <span class="n">deleted_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
-</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a>                <span class="n">valid_methods</span><span class="o">=</span><span class="n">deleted_methods</span>
-</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a>            <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
-</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in deleted_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a>
-</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>    <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Delete a&quot;</span>
-</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span><span class="p">:</span>
-</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>        <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Soft delete a&quot;</span>
-</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a>
-</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;create&quot;</span><span class="p">),</span>
-</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_create_item</span><span class="p">(),</span>
-</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;POST&quot;</span><span class="p">],</span>
-</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">create_deps</span><span class="p">),</span>
-</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Create a new </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>        <span class="p">)</span>
-</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a>
-</span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read&quot;</span><span class="p">),</span>
-</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_read_item</span><span class="p">(),</span>
-</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
-</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_deps</span><span class="p">),</span>
-</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read a single </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a>        <span class="p">)</span>
-</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a>
-</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read_multi&quot;</span><span class="p">),</span>
-</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_read_items</span><span class="p">(),</span>
-</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
-</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-577"><a id="__codelineno-0-577" name="__codelineno-0-577"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_multi_deps</span><span class="p">),</span>
-</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read multiple </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> rows from the database with a limit and an offset.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>        <span class="p">)</span>
-</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>
-</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;update&quot;</span><span class="p">),</span>
-</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_update_item</span><span class="p">(),</span>
-</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;PATCH&quot;</span><span class="p">],</span>
-</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">update_deps</span><span class="p">),</span>
-</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Update an existing </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>        <span class="p">)</span>
-</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>
-</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
-</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>        <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;delete&quot;</span><span class="p">)</span>
-</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a>            <span class="n">path</span><span class="p">,</span>
-</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_delete_item</span><span class="p">(),</span>
-</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
-</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">delete_deps</span><span class="p">),</span>
-</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">delete_description</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a>        <span class="p">)</span>
-</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a>
-</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a>    <span class="k">if</span> <span class="p">(</span>
-</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>        <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span>
-</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a>        <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">)</span>
-</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a>        <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span>
-</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a>    <span class="p">):</span>
-</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
-</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;db_delete&quot;</span><span class="p">),</span>
-</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_db_delete</span><span class="p">(),</span>
-</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
-</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
-</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
-</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">db_delete_deps</span><span class="p">),</span>
-</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Permanently delete a </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
-</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>        <span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-617">617</a></span>
+<span class="normal"><a href="#__codelineno-0-618">618</a></span>
+<span class="normal"><a href="#__codelineno-0-619">619</a></span>
+<span class="normal"><a href="#__codelineno-0-620">620</a></span>
+<span class="normal"><a href="#__codelineno-0-621">621</a></span>
+<span class="normal"><a href="#__codelineno-0-622">622</a></span>
+<span class="normal"><a href="#__codelineno-0-623">623</a></span>
+<span class="normal"><a href="#__codelineno-0-624">624</a></span>
+<span class="normal"><a href="#__codelineno-0-625">625</a></span>
+<span class="normal"><a href="#__codelineno-0-626">626</a></span>
+<span class="normal"><a href="#__codelineno-0-627">627</a></span>
+<span class="normal"><a href="#__codelineno-0-628">628</a></span>
+<span class="normal"><a href="#__codelineno-0-629">629</a></span>
+<span class="normal"><a href="#__codelineno-0-630">630</a></span>
+<span class="normal"><a href="#__codelineno-0-631">631</a></span>
+<span class="normal"><a href="#__codelineno-0-632">632</a></span>
+<span class="normal"><a href="#__codelineno-0-633">633</a></span>
+<span class="normal"><a href="#__codelineno-0-634">634</a></span>
+<span class="normal"><a href="#__codelineno-0-635">635</a></span>
+<span class="normal"><a href="#__codelineno-0-636">636</a></span>
+<span class="normal"><a href="#__codelineno-0-637">637</a></span>
+<span class="normal"><a href="#__codelineno-0-638">638</a></span>
+<span class="normal"><a href="#__codelineno-0-639">639</a></span>
+<span class="normal"><a href="#__codelineno-0-640">640</a></span>
+<span class="normal"><a href="#__codelineno-0-641">641</a></span>
+<span class="normal"><a href="#__codelineno-0-642">642</a></span>
+<span class="normal"><a href="#__codelineno-0-643">643</a></span>
+<span class="normal"><a href="#__codelineno-0-644">644</a></span>
+<span class="normal"><a href="#__codelineno-0-645">645</a></span>
+<span class="normal"><a href="#__codelineno-0-646">646</a></span>
+<span class="normal"><a href="#__codelineno-0-647">647</a></span>
+<span class="normal"><a href="#__codelineno-0-648">648</a></span>
+<span class="normal"><a href="#__codelineno-0-649">649</a></span>
+<span class="normal"><a href="#__codelineno-0-650">650</a></span>
+<span class="normal"><a href="#__codelineno-0-651">651</a></span>
+<span class="normal"><a href="#__codelineno-0-652">652</a></span>
+<span class="normal"><a href="#__codelineno-0-653">653</a></span>
+<span class="normal"><a href="#__codelineno-0-654">654</a></span>
+<span class="normal"><a href="#__codelineno-0-655">655</a></span>
+<span class="normal"><a href="#__codelineno-0-656">656</a></span>
+<span class="normal"><a href="#__codelineno-0-657">657</a></span>
+<span class="normal"><a href="#__codelineno-0-658">658</a></span>
+<span class="normal"><a href="#__codelineno-0-659">659</a></span>
+<span class="normal"><a href="#__codelineno-0-660">660</a></span>
+<span class="normal"><a href="#__codelineno-0-661">661</a></span>
+<span class="normal"><a href="#__codelineno-0-662">662</a></span>
+<span class="normal"><a href="#__codelineno-0-663">663</a></span>
+<span class="normal"><a href="#__codelineno-0-664">664</a></span>
+<span class="normal"><a href="#__codelineno-0-665">665</a></span>
+<span class="normal"><a href="#__codelineno-0-666">666</a></span>
+<span class="normal"><a href="#__codelineno-0-667">667</a></span>
+<span class="normal"><a href="#__codelineno-0-668">668</a></span>
+<span class="normal"><a href="#__codelineno-0-669">669</a></span>
+<span class="normal"><a href="#__codelineno-0-670">670</a></span>
+<span class="normal"><a href="#__codelineno-0-671">671</a></span>
+<span class="normal"><a href="#__codelineno-0-672">672</a></span>
+<span class="normal"><a href="#__codelineno-0-673">673</a></span>
+<span class="normal"><a href="#__codelineno-0-674">674</a></span>
+<span class="normal"><a href="#__codelineno-0-675">675</a></span>
+<span class="normal"><a href="#__codelineno-0-676">676</a></span>
+<span class="normal"><a href="#__codelineno-0-677">677</a></span>
+<span class="normal"><a href="#__codelineno-0-678">678</a></span>
+<span class="normal"><a href="#__codelineno-0-679">679</a></span>
+<span class="normal"><a href="#__codelineno-0-680">680</a></span>
+<span class="normal"><a href="#__codelineno-0-681">681</a></span>
+<span class="normal"><a href="#__codelineno-0-682">682</a></span>
+<span class="normal"><a href="#__codelineno-0-683">683</a></span>
+<span class="normal"><a href="#__codelineno-0-684">684</a></span>
+<span class="normal"><a href="#__codelineno-0-685">685</a></span>
+<span class="normal"><a href="#__codelineno-0-686">686</a></span>
+<span class="normal"><a href="#__codelineno-0-687">687</a></span>
+<span class="normal"><a href="#__codelineno-0-688">688</a></span>
+<span class="normal"><a href="#__codelineno-0-689">689</a></span>
+<span class="normal"><a href="#__codelineno-0-690">690</a></span>
+<span class="normal"><a href="#__codelineno-0-691">691</a></span>
+<span class="normal"><a href="#__codelineno-0-692">692</a></span>
+<span class="normal"><a href="#__codelineno-0-693">693</a></span>
+<span class="normal"><a href="#__codelineno-0-694">694</a></span>
+<span class="normal"><a href="#__codelineno-0-695">695</a></span>
+<span class="normal"><a href="#__codelineno-0-696">696</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a><span class="k">def</span> <span class="nf">add_routes_to_router</span><span class="p">(</span>
+</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a>    <span class="n">create_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a>    <span class="n">read_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a>    <span class="n">read_multi_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a>    <span class="n">update_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a>    <span class="n">delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>    <span class="n">db_delete_deps</span><span class="p">:</span> <span class="n">Sequence</span><span class="p">[</span><span class="n">Callable</span><span class="p">]</span> <span class="o">=</span> <span class="p">[],</span>
+</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>    <span class="n">included_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>    <span class="n">deleted_methods</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Sequence</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a><span class="p">):</span>
+</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a><span class="sd">    Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</span>
+</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>
+</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a><span class="sd">    This method registers routes for create, read, update, and delete operations with the FastAPI router,</span>
+</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a><span class="sd">    allowing for custom dependency injection for each type of operation.</span>
+</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>
+</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a><span class="sd">        create_deps: List of functions to be injected as dependencies for the create endpoint.</span>
+</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a><span class="sd">        read_deps: List of functions to be injected as dependencies for the read endpoint.</span>
+</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a><span class="sd">        read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.</span>
+</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a><span class="sd">        update_deps: List of functions to be injected as dependencies for the update endpoint.</span>
+</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a><span class="sd">        delete_deps: List of functions to be injected as dependencies for the delete endpoint.</span>
+</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a><span class="sd">        db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.</span>
+</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a><span class="sd">        included_methods: Optional list of methods to include. Defaults to all CRUD methods.</span>
+</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a><span class="sd">        deleted_methods: Optional list of methods to exclude. Defaults to `None`.</span>
+</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>
+</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a><span class="sd">        ValueError: If both `included_methods` and `deleted_methods` are provided.</span>
+</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a>
+</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a><span class="sd">        Selective Endpoint Creation:</span>
+</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a>
+</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a><span class="sd">        # Only create &#39;create&#39; and &#39;read&#39; endpoints</span>
+</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a><span class="sd">            included_methods=[&quot;create&quot;, &quot;read&quot;],</span>
+</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a><span class="sd">        )</span>
+</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a><span class="sd">        ```</span>
+</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a>
+</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a><span class="sd">        Excluding Specific Endpoints:</span>
+</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>
+</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a><span class="sd">        # Create all endpoints except &#39;delete&#39; and &#39;db_delete&#39;</span>
+</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a><span class="sd">            deleted_methods=[&quot;delete&quot;, &quot;db_delete&quot;],</span>
+</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a><span class="sd">        )</span>
+</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a><span class="sd">        ```</span>
+</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>
+</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a><span class="sd">        With Custom Dependencies and Selective Endpoints:</span>
+</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>
+</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a><span class="sd">        def get_current_user(...):</span>
+</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a><span class="sd">            ...</span>
+</span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>
+</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a><span class="sd">        # Create only &#39;read&#39; and &#39;update&#39; endpoints with custom dependencies</span>
+</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a><span class="sd">        endpoint_creator.add_routes_to_router(</span>
+</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a><span class="sd">            read_deps=[get_current_user],</span>
+</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a><span class="sd">            update_deps=[get_current_user],</span>
+</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a><span class="sd">            included_methods=[&quot;read&quot;, &quot;update&quot;],</span>
+</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a><span class="sd">        )</span>
+</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a><span class="sd">        ```</span>
+</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>
+</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a><span class="sd">    Note:</span>
+</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a><span class="sd">        This method should be called to register the endpoints with the FastAPI application.</span>
+</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a><span class="sd">        If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.</span>
+</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a><span class="sd">        This method assumes `id` is the primary key for path parameters.</span>
+</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">included_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="n">deleted_methods</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">):</span>
+</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>            <span class="s2">&quot;Cannot use both &#39;included_methods&#39; and &#39;deleted_methods&#39; simultaneously.&quot;</span>
+</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>        <span class="p">)</span>
+</span><span id="__span-0-577"><a id="__codelineno-0-577" name="__codelineno-0-577"></a>
+</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>    <span class="k">if</span> <span class="n">included_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>        <span class="n">included_methods</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>            <span class="s2">&quot;create&quot;</span><span class="p">,</span>
+</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>            <span class="s2">&quot;read&quot;</span><span class="p">,</span>
+</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>            <span class="s2">&quot;read_multi&quot;</span><span class="p">,</span>
+</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>            <span class="s2">&quot;update&quot;</span><span class="p">,</span>
+</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>            <span class="s2">&quot;delete&quot;</span><span class="p">,</span>
+</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>            <span class="s2">&quot;db_delete&quot;</span><span class="p">,</span>
+</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>        <span class="p">]</span>
+</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>        <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>            <span class="n">included_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
+</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>                <span class="n">valid_methods</span><span class="o">=</span><span class="n">included_methods</span>
+</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>            <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
+</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in included_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a>
+</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a>    <span class="k">if</span> <span class="n">deleted_methods</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>        <span class="n">deleted_methods</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a>        <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a>            <span class="n">deleted_methods</span> <span class="o">=</span> <span class="n">CRUDMethods</span><span class="p">(</span>
+</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a>                <span class="n">valid_methods</span><span class="o">=</span><span class="n">deleted_methods</span>
+</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a>            <span class="p">)</span><span class="o">.</span><span class="n">valid_methods</span>
+</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid CRUD methods in deleted_methods: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a>
+</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>    <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Delete a&quot;</span>
+</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span><span class="p">:</span>
+</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a>        <span class="n">delete_description</span> <span class="o">=</span> <span class="s2">&quot;Soft delete a&quot;</span>
+</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a>
+</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;create&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;create&quot;</span><span class="p">),</span>
+</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_create_item</span><span class="p">(),</span>
+</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;POST&quot;</span><span class="p">],</span>
+</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">create_deps</span><span class="p">),</span>
+</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Create a new </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-618"><a id="__codelineno-0-618" name="__codelineno-0-618"></a>        <span class="p">)</span>
+</span><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a>
+</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read&quot;</span><span class="p">),</span>
+</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_read_item</span><span class="p">(),</span>
+</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
+</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_deps</span><span class="p">),</span>
+</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>            <span class="n">response_model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Read a single </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>        <span class="p">)</span>
+</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a>
+</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;read_multi&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">select_schema</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>            <span class="n">response_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span>
+</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a>                <span class="n">Type</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">PaginatedListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">],</span> <span class="n">ListResponse</span><span class="p">[</span><span class="n">Any</span><span class="p">]]]</span>
+</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a>            <span class="p">]</span> <span class="o">=</span> <span class="n">Union</span><span class="p">[</span>
+</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">paginated_response_model</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">list_response_model</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a>            <span class="p">]</span>
+</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a>            <span class="n">response_model</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a>
+</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;read_multi&quot;</span><span class="p">),</span>
+</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_read_items</span><span class="p">(),</span>
+</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;GET&quot;</span><span class="p">],</span>
+</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">read_multi_deps</span><span class="p">),</span>
+</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>            <span class="n">response_model</span><span class="o">=</span><span class="n">response_model</span><span class="p">,</span>
+</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>            <span class="n">description</span><span class="o">=</span><span class="p">(</span>
+</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>                <span class="sa">f</span><span class="s2">&quot;Read multiple </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> rows from the database.</span><span class="se">\n\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a>                <span class="sa">f</span><span class="s2">&quot;- Use page &amp; itemsPerPage for paginated results</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a>                <span class="sa">f</span><span class="s2">&quot;- Use offset &amp; limit for specific ranges</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>                <span class="sa">f</span><span class="s2">&quot;- Returns paginated response when using page/itemsPerPage</span><span class="se">\n</span><span class="s2">&quot;</span>
+</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a>                <span class="sa">f</span><span class="s2">&quot;- Returns simple list response when using offset/limit&quot;</span>
+</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a>            <span class="p">),</span>
+</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a>        <span class="p">)</span>
+</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>
+</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;update&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;update&quot;</span><span class="p">),</span>
+</span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_update_item</span><span class="p">(),</span>
+</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;PATCH&quot;</span><span class="p">],</span>
+</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">update_deps</span><span class="p">),</span>
+</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Update an existing </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row in the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>        <span class="p">)</span>
+</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a>
+</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a>    <span class="k">if</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span> <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">):</span>
+</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>        <span class="n">path</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;delete&quot;</span><span class="p">)</span>
+</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a>            <span class="n">path</span><span class="p">,</span>
+</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_delete_item</span><span class="p">(),</span>
+</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
+</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">delete_deps</span><span class="p">),</span>
+</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">delete_description</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a>        <span class="p">)</span>
+</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a>
+</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a>    <span class="k">if</span> <span class="p">(</span>
+</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a>        <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">in</span> <span class="n">included_methods</span><span class="p">)</span>
+</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a>        <span class="ow">and</span> <span class="p">(</span><span class="s2">&quot;db_delete&quot;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">deleted_methods</span><span class="p">)</span>
+</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a>        <span class="ow">and</span> <span class="bp">self</span><span class="o">.</span><span class="n">delete_schema</span>
+</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a>    <span class="p">):</span>
+</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">router</span><span class="o">.</span><span class="n">add_api_route</span><span class="p">(</span>
+</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_get_endpoint_path</span><span class="p">(</span><span class="n">operation</span><span class="o">=</span><span class="s2">&quot;db_delete&quot;</span><span class="p">),</span>
+</span><span id="__span-0-690"><a id="__codelineno-0-690" name="__codelineno-0-690"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_db_delete</span><span class="p">(),</span>
+</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a>            <span class="n">methods</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;DELETE&quot;</span><span class="p">],</span>
+</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a>            <span class="n">include_in_schema</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">include_in_schema</span><span class="p">,</span>
+</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a>            <span class="n">tags</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">tags</span><span class="p">,</span>
+</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a>            <span class="n">dependencies</span><span class="o">=</span><span class="n">_inject_dependencies</span><span class="p">(</span><span class="n">db_delete_deps</span><span class="p">),</span>
+</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a>            <span class="n">description</span><span class="o">=</span><span class="sa">f</span><span class="s2">&quot;Permanently delete a </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2"> row from the database by its primary keys: </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">primary_key_names</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">,</span>
+</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a>        <span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
diff --git a/api/fastcrud/index.html b/api/fastcrud/index.html
index d5b819b..0d37521 100644
--- a/api/fastcrud/index.html
+++ b/api/fastcrud/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1182,6 +1199,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1192,6 +1229,8 @@
       
         
       
+        
+      
         
       
     
@@ -1206,10 +1245,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1220,8 +1259,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1275,6 +1314,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
@@ -1598,7 +1658,7 @@ <h2 id="class-definition">Class Definition<a class="headerlink" href="#class-def
 <a id="fastcrud.FastCRUD"></a>
   <div class="doc doc-contents first">
           <p class="doc doc-class-bases">
-            Bases: <code><span title="typing.Generic">Generic</span>[<span title="fastcrud.types.ModelType">ModelType</span>, <span title="fastcrud.types.CreateSchemaType">CreateSchemaType</span>, <span title="fastcrud.types.UpdateSchemaType">UpdateSchemaType</span>, <span title="fastcrud.types.UpdateSchemaInternalType">UpdateSchemaInternalType</span>, <span title="fastcrud.types.DeleteSchemaType">DeleteSchemaType</span>]</code></p>
+            Bases: <code><span title="typing.Generic">Generic</span>[<span title="fastcrud.types.ModelType">ModelType</span>, <span title="fastcrud.types.CreateSchemaType">CreateSchemaType</span>, <span title="fastcrud.types.UpdateSchemaType">UpdateSchemaType</span>, <span title="fastcrud.types.UpdateSchemaInternalType">UpdateSchemaInternalType</span>, <span title="fastcrud.types.DeleteSchemaType">DeleteSchemaType</span>, <span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]</code></p>
 
   
       <p>Base class for CRUD operations on a model.</p>
@@ -2282,10 +2342,7 @@ <h3 id="fastcrud.FastCRUD--example-6-using-custom-column-names-for-soft-delete">
 
             <details class="quote">
               <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-48">  48</a></span>
-<span class="normal"><a href="#__codelineno-0-49">  49</a></span>
-<span class="normal"><a href="#__codelineno-0-50">  50</a></span>
-<span class="normal"><a href="#__codelineno-0-51">  51</a></span>
+              <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-51">  51</a></span>
 <span class="normal"><a href="#__codelineno-0-52">  52</a></span>
 <span class="normal"><a href="#__codelineno-0-53">  53</a></span>
 <span class="normal"><a href="#__codelineno-0-54">  54</a></span>
@@ -4674,2399 +4731,2436 @@ <h3 id="fastcrud.FastCRUD--example-6-using-custom-column-names-for-soft-delete">
 <span class="normal"><a href="#__codelineno-0-2437">2437</a></span>
 <span class="normal"><a href="#__codelineno-0-2438">2438</a></span>
 <span class="normal"><a href="#__codelineno-0-2439">2439</a></span>
-<span class="normal"><a href="#__codelineno-0-2440">2440</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-48"><a id="__codelineno-0-48" name="__codelineno-0-48"></a><span class="k">class</span> <span class="nc">FastCRUD</span><span class="p">(</span>
-</span><span id="__span-0-49"><a id="__codelineno-0-49" name="__codelineno-0-49"></a>    <span class="n">Generic</span><span class="p">[</span>
-</span><span id="__span-0-50"><a id="__codelineno-0-50" name="__codelineno-0-50"></a>        <span class="n">ModelType</span><span class="p">,</span>
-</span><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a>        <span class="n">CreateSchemaType</span><span class="p">,</span>
-</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a>        <span class="n">UpdateSchemaType</span><span class="p">,</span>
-</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a>        <span class="n">UpdateSchemaInternalType</span><span class="p">,</span>
-</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a>        <span class="n">DeleteSchemaType</span><span class="p">,</span>
-</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a>    <span class="p">]</span>
-</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a><span class="p">):</span>
-</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a><span class="sd">    Base class for CRUD operations on a model.</span>
-</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a>
-</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="sd">    This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model,</span>
-</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a><span class="sd">    utilizing Pydantic schemas for data validation and serialization.</span>
-</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a>
-</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64"></a><span class="sd">        model: The SQLAlchemy model type.</span>
-</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
-</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
-</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
-</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a>
-</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a><span class="sd">    Methods:</span>
-</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a><span class="sd">        create:</span>
-</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">            Creates a new record in the database from the provided Pydantic schema.</span>
+<span class="normal"><a href="#__codelineno-0-2440">2440</a></span>
+<span class="normal"><a href="#__codelineno-0-2441">2441</a></span>
+<span class="normal"><a href="#__codelineno-0-2442">2442</a></span>
+<span class="normal"><a href="#__codelineno-0-2443">2443</a></span>
+<span class="normal"><a href="#__codelineno-0-2444">2444</a></span>
+<span class="normal"><a href="#__codelineno-0-2445">2445</a></span>
+<span class="normal"><a href="#__codelineno-0-2446">2446</a></span>
+<span class="normal"><a href="#__codelineno-0-2447">2447</a></span>
+<span class="normal"><a href="#__codelineno-0-2448">2448</a></span>
+<span class="normal"><a href="#__codelineno-0-2449">2449</a></span>
+<span class="normal"><a href="#__codelineno-0-2450">2450</a></span>
+<span class="normal"><a href="#__codelineno-0-2451">2451</a></span>
+<span class="normal"><a href="#__codelineno-0-2452">2452</a></span>
+<span class="normal"><a href="#__codelineno-0-2453">2453</a></span>
+<span class="normal"><a href="#__codelineno-0-2454">2454</a></span>
+<span class="normal"><a href="#__codelineno-0-2455">2455</a></span>
+<span class="normal"><a href="#__codelineno-0-2456">2456</a></span>
+<span class="normal"><a href="#__codelineno-0-2457">2457</a></span>
+<span class="normal"><a href="#__codelineno-0-2458">2458</a></span>
+<span class="normal"><a href="#__codelineno-0-2459">2459</a></span>
+<span class="normal"><a href="#__codelineno-0-2460">2460</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-51"><a id="__codelineno-0-51" name="__codelineno-0-51"></a><span class="k">class</span> <span class="nc">FastCRUD</span><span class="p">(</span>
+</span><span id="__span-0-52"><a id="__codelineno-0-52" name="__codelineno-0-52"></a>    <span class="n">Generic</span><span class="p">[</span>
+</span><span id="__span-0-53"><a id="__codelineno-0-53" name="__codelineno-0-53"></a>        <span class="n">ModelType</span><span class="p">,</span>
+</span><span id="__span-0-54"><a id="__codelineno-0-54" name="__codelineno-0-54"></a>        <span class="n">CreateSchemaType</span><span class="p">,</span>
+</span><span id="__span-0-55"><a id="__codelineno-0-55" name="__codelineno-0-55"></a>        <span class="n">UpdateSchemaType</span><span class="p">,</span>
+</span><span id="__span-0-56"><a id="__codelineno-0-56" name="__codelineno-0-56"></a>        <span class="n">UpdateSchemaInternalType</span><span class="p">,</span>
+</span><span id="__span-0-57"><a id="__codelineno-0-57" name="__codelineno-0-57"></a>        <span class="n">DeleteSchemaType</span><span class="p">,</span>
+</span><span id="__span-0-58"><a id="__codelineno-0-58" name="__codelineno-0-58"></a>        <span class="n">SelectSchemaType</span><span class="p">,</span>
+</span><span id="__span-0-59"><a id="__codelineno-0-59" name="__codelineno-0-59"></a>    <span class="p">]</span>
+</span><span id="__span-0-60"><a id="__codelineno-0-60" name="__codelineno-0-60"></a><span class="p">):</span>
+</span><span id="__span-0-61"><a id="__codelineno-0-61" name="__codelineno-0-61"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-62"><a id="__codelineno-0-62" name="__codelineno-0-62"></a><span class="sd">    Base class for CRUD operations on a model.</span>
+</span><span id="__span-0-63"><a id="__codelineno-0-63" name="__codelineno-0-63"></a>
+</span><span id="__span-0-64"><a id="__codelineno-0-64" name="__codelineno-0-64"></a><span class="sd">    This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model,</span>
+</span><span id="__span-0-65"><a id="__codelineno-0-65" name="__codelineno-0-65"></a><span class="sd">    utilizing Pydantic schemas for data validation and serialization.</span>
+</span><span id="__span-0-66"><a id="__codelineno-0-66" name="__codelineno-0-66"></a>
+</span><span id="__span-0-67"><a id="__codelineno-0-67" name="__codelineno-0-67"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-68"><a id="__codelineno-0-68" name="__codelineno-0-68"></a><span class="sd">        model: The SQLAlchemy model type.</span>
+</span><span id="__span-0-69"><a id="__codelineno-0-69" name="__codelineno-0-69"></a><span class="sd">        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `&quot;is_deleted&quot;`.</span>
+</span><span id="__span-0-70"><a id="__codelineno-0-70" name="__codelineno-0-70"></a><span class="sd">        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `&quot;deleted_at&quot;`.</span>
+</span><span id="__span-0-71"><a id="__codelineno-0-71" name="__codelineno-0-71"></a><span class="sd">        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `&quot;updated_at&quot;`.</span>
 </span><span id="__span-0-72"><a id="__codelineno-0-72" name="__codelineno-0-72"></a>
-</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">        select:</span>
-</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74"></a><span class="sd">            Generates a SQL Alchemy `Select` statement with optional filtering and sorting.</span>
-</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a>
-</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a><span class="sd">        get:</span>
-</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">            Retrieves a single record based on filters. Supports advanced filtering through comparison operators like `__gt`, `__lt`, etc.</span>
-</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78"></a>
-</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a><span class="sd">        exists:</span>
-</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">            Checks if a record exists based on the provided filters.</span>
-</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81"></a>
-</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a><span class="sd">        count:</span>
-</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">            Counts the number of records matching the provided filters.</span>
-</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84"></a>
-</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="sd">        get_multi:</span>
-</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a><span class="sd">            Fetches multiple records with optional sorting, pagination, and model conversion.</span>
-</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a>
-</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a><span class="sd">        get_joined:</span>
-</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a><span class="sd">            Performs a join operation with another model, supporting custom join conditions and selection of specific columns.</span>
-</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a>
-</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91"></a><span class="sd">        get_multi_joined:</span>
-</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">            Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.</span>
-</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a>
-</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a><span class="sd">        get_multi_by_cursor:</span>
-</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="sd">            Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.</span>
-</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a>
-</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a><span class="sd">        update:</span>
-</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a><span class="sd">            Updates an existing record or multiple records based on specified filters.</span>
-</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a>
-</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="sd">        db_delete:</span>
-</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">            Hard deletes a record or multiple records from the database based on provided filters.</span>
-</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a>
-</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a><span class="sd">        delete:</span>
-</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="sd">            Soft deletes a record if it has an `&quot;is_deleted&quot;` attribute (or other attribute as defined by `is_deleted_column`); otherwise, performs a hard delete.</span>
-</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a>
-</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a><span class="sd">        ??? example &quot;Models and Schemas Used Below&quot;</span>
-</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a>
-</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a><span class="sd">            ??? example &quot;`customer/model.py`&quot;</span>
-</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110"></a>
-</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="sd">                fastcrud/examples/customer/model.py:imports</span>
-</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">                fastcrud/examples/customer/model.py:model</span>
-</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">                ```</span>
-</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a>
-</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a><span class="sd">            ??? example &quot;`product/model.py`&quot;</span>
-</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a>
-</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">                fastcrud/examples/product/model.py:imports</span>
-</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a><span class="sd">                fastcrud/examples/product/model.py:model</span>
-</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">                ```</span>
-</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a>
-</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a><span class="sd">            ??? example &quot;`product/schemas.py`&quot;</span>
-</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a>
-</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">                fastcrud/examples/product/schemas.py:imports</span>
-</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a><span class="sd">                fastcrud/examples/product/schemas.py:readschema</span>
-</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134"></a><span class="sd">                ```</span>
-</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a>
-</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a><span class="sd">            ??? example &quot;`order/model.py`&quot;</span>
-</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a>
-</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">                fastcrud/examples/order/model.py:imports</span>
-</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="sd">                fastcrud/examples/order/model.py:model</span>
-</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">                ```</span>
-</span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144"></a>
-</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">            ??? example &quot;`order/schemas.py`&quot;</span>
-</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a>
-</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">                fastcrud/examples/order/schemas.py:imports</span>
-</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">                fastcrud/examples/order/schemas.py:readschema</span>
-</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">                ```</span>
-</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a>
-</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">            ---</span>
-</span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155"></a>
-</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="sd">            ??? example &quot;`tier/model.py`&quot;</span>
+</span><span id="__span-0-73"><a id="__codelineno-0-73" name="__codelineno-0-73"></a><span class="sd">    Methods:</span>
+</span><span id="__span-0-74"><a id="__codelineno-0-74" name="__codelineno-0-74"></a><span class="sd">        create:</span>
+</span><span id="__span-0-75"><a id="__codelineno-0-75" name="__codelineno-0-75"></a><span class="sd">            Creates a new record in the database from the provided Pydantic schema.</span>
+</span><span id="__span-0-76"><a id="__codelineno-0-76" name="__codelineno-0-76"></a>
+</span><span id="__span-0-77"><a id="__codelineno-0-77" name="__codelineno-0-77"></a><span class="sd">        select:</span>
+</span><span id="__span-0-78"><a id="__codelineno-0-78" name="__codelineno-0-78"></a><span class="sd">            Generates a SQL Alchemy `Select` statement with optional filtering and sorting.</span>
+</span><span id="__span-0-79"><a id="__codelineno-0-79" name="__codelineno-0-79"></a>
+</span><span id="__span-0-80"><a id="__codelineno-0-80" name="__codelineno-0-80"></a><span class="sd">        get:</span>
+</span><span id="__span-0-81"><a id="__codelineno-0-81" name="__codelineno-0-81"></a><span class="sd">            Retrieves a single record based on filters. Supports advanced filtering through comparison operators like `__gt`, `__lt`, etc.</span>
+</span><span id="__span-0-82"><a id="__codelineno-0-82" name="__codelineno-0-82"></a>
+</span><span id="__span-0-83"><a id="__codelineno-0-83" name="__codelineno-0-83"></a><span class="sd">        exists:</span>
+</span><span id="__span-0-84"><a id="__codelineno-0-84" name="__codelineno-0-84"></a><span class="sd">            Checks if a record exists based on the provided filters.</span>
+</span><span id="__span-0-85"><a id="__codelineno-0-85" name="__codelineno-0-85"></a>
+</span><span id="__span-0-86"><a id="__codelineno-0-86" name="__codelineno-0-86"></a><span class="sd">        count:</span>
+</span><span id="__span-0-87"><a id="__codelineno-0-87" name="__codelineno-0-87"></a><span class="sd">            Counts the number of records matching the provided filters.</span>
+</span><span id="__span-0-88"><a id="__codelineno-0-88" name="__codelineno-0-88"></a>
+</span><span id="__span-0-89"><a id="__codelineno-0-89" name="__codelineno-0-89"></a><span class="sd">        get_multi:</span>
+</span><span id="__span-0-90"><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="sd">            Fetches multiple records with optional sorting, pagination, and model conversion.</span>
+</span><span id="__span-0-91"><a id="__codelineno-0-91" name="__codelineno-0-91"></a>
+</span><span id="__span-0-92"><a id="__codelineno-0-92" name="__codelineno-0-92"></a><span class="sd">        get_joined:</span>
+</span><span id="__span-0-93"><a id="__codelineno-0-93" name="__codelineno-0-93"></a><span class="sd">            Performs a join operation with another model, supporting custom join conditions and selection of specific columns.</span>
+</span><span id="__span-0-94"><a id="__codelineno-0-94" name="__codelineno-0-94"></a>
+</span><span id="__span-0-95"><a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="sd">        get_multi_joined:</span>
+</span><span id="__span-0-96"><a id="__codelineno-0-96" name="__codelineno-0-96"></a><span class="sd">            Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.</span>
+</span><span id="__span-0-97"><a id="__codelineno-0-97" name="__codelineno-0-97"></a>
+</span><span id="__span-0-98"><a id="__codelineno-0-98" name="__codelineno-0-98"></a><span class="sd">        get_multi_by_cursor:</span>
+</span><span id="__span-0-99"><a id="__codelineno-0-99" name="__codelineno-0-99"></a><span class="sd">            Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.</span>
+</span><span id="__span-0-100"><a id="__codelineno-0-100" name="__codelineno-0-100"></a>
+</span><span id="__span-0-101"><a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">        update:</span>
+</span><span id="__span-0-102"><a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">            Updates an existing record or multiple records based on specified filters.</span>
+</span><span id="__span-0-103"><a id="__codelineno-0-103" name="__codelineno-0-103"></a>
+</span><span id="__span-0-104"><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="sd">        db_delete:</span>
+</span><span id="__span-0-105"><a id="__codelineno-0-105" name="__codelineno-0-105"></a><span class="sd">            Hard deletes a record or multiple records from the database based on provided filters.</span>
+</span><span id="__span-0-106"><a id="__codelineno-0-106" name="__codelineno-0-106"></a>
+</span><span id="__span-0-107"><a id="__codelineno-0-107" name="__codelineno-0-107"></a><span class="sd">        delete:</span>
+</span><span id="__span-0-108"><a id="__codelineno-0-108" name="__codelineno-0-108"></a><span class="sd">            Soft deletes a record if it has an `&quot;is_deleted&quot;` attribute (or other attribute as defined by `is_deleted_column`); otherwise, performs a hard delete.</span>
+</span><span id="__span-0-109"><a id="__codelineno-0-109" name="__codelineno-0-109"></a>
+</span><span id="__span-0-110"><a id="__codelineno-0-110" name="__codelineno-0-110"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-111"><a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="sd">        ??? example &quot;Models and Schemas Used Below&quot;</span>
+</span><span id="__span-0-112"><a id="__codelineno-0-112" name="__codelineno-0-112"></a>
+</span><span id="__span-0-113"><a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="sd">            ??? example &quot;`customer/model.py`&quot;</span>
+</span><span id="__span-0-114"><a id="__codelineno-0-114" name="__codelineno-0-114"></a>
+</span><span id="__span-0-115"><a id="__codelineno-0-115" name="__codelineno-0-115"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-116"><a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-117"><a id="__codelineno-0-117" name="__codelineno-0-117"></a><span class="sd">                fastcrud/examples/customer/model.py:imports</span>
+</span><span id="__span-0-118"><a id="__codelineno-0-118" name="__codelineno-0-118"></a><span class="sd">                fastcrud/examples/customer/model.py:model</span>
+</span><span id="__span-0-119"><a id="__codelineno-0-119" name="__codelineno-0-119"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-120"><a id="__codelineno-0-120" name="__codelineno-0-120"></a><span class="sd">                ```</span>
+</span><span id="__span-0-121"><a id="__codelineno-0-121" name="__codelineno-0-121"></a>
+</span><span id="__span-0-122"><a id="__codelineno-0-122" name="__codelineno-0-122"></a><span class="sd">            ??? example &quot;`product/model.py`&quot;</span>
+</span><span id="__span-0-123"><a id="__codelineno-0-123" name="__codelineno-0-123"></a>
+</span><span id="__span-0-124"><a id="__codelineno-0-124" name="__codelineno-0-124"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-125"><a id="__codelineno-0-125" name="__codelineno-0-125"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-126"><a id="__codelineno-0-126" name="__codelineno-0-126"></a><span class="sd">                fastcrud/examples/product/model.py:imports</span>
+</span><span id="__span-0-127"><a id="__codelineno-0-127" name="__codelineno-0-127"></a><span class="sd">                fastcrud/examples/product/model.py:model</span>
+</span><span id="__span-0-128"><a id="__codelineno-0-128" name="__codelineno-0-128"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-129"><a id="__codelineno-0-129" name="__codelineno-0-129"></a><span class="sd">                ```</span>
+</span><span id="__span-0-130"><a id="__codelineno-0-130" name="__codelineno-0-130"></a>
+</span><span id="__span-0-131"><a id="__codelineno-0-131" name="__codelineno-0-131"></a><span class="sd">            ??? example &quot;`product/schemas.py`&quot;</span>
+</span><span id="__span-0-132"><a id="__codelineno-0-132" name="__codelineno-0-132"></a>
+</span><span id="__span-0-133"><a id="__codelineno-0-133" name="__codelineno-0-133"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-134"><a id="__codelineno-0-134" name="__codelineno-0-134"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-135"><a id="__codelineno-0-135" name="__codelineno-0-135"></a><span class="sd">                fastcrud/examples/product/schemas.py:imports</span>
+</span><span id="__span-0-136"><a id="__codelineno-0-136" name="__codelineno-0-136"></a><span class="sd">                fastcrud/examples/product/schemas.py:readschema</span>
+</span><span id="__span-0-137"><a id="__codelineno-0-137" name="__codelineno-0-137"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-138"><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="sd">                ```</span>
+</span><span id="__span-0-139"><a id="__codelineno-0-139" name="__codelineno-0-139"></a>
+</span><span id="__span-0-140"><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">            ??? example &quot;`order/model.py`&quot;</span>
+</span><span id="__span-0-141"><a id="__codelineno-0-141" name="__codelineno-0-141"></a>
+</span><span id="__span-0-142"><a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-143"><a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-144"><a id="__codelineno-0-144" name="__codelineno-0-144"></a><span class="sd">                fastcrud/examples/order/model.py:imports</span>
+</span><span id="__span-0-145"><a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">                fastcrud/examples/order/model.py:model</span>
+</span><span id="__span-0-146"><a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-147"><a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">                ```</span>
+</span><span id="__span-0-148"><a id="__codelineno-0-148" name="__codelineno-0-148"></a>
+</span><span id="__span-0-149"><a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">            ??? example &quot;`order/schemas.py`&quot;</span>
+</span><span id="__span-0-150"><a id="__codelineno-0-150" name="__codelineno-0-150"></a>
+</span><span id="__span-0-151"><a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-152"><a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-153"><a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">                fastcrud/examples/order/schemas.py:imports</span>
+</span><span id="__span-0-154"><a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">                fastcrud/examples/order/schemas.py:readschema</span>
+</span><span id="__span-0-155"><a id="__codelineno-0-155" name="__codelineno-0-155"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-156"><a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="sd">                ```</span>
 </span><span id="__span-0-157"><a id="__codelineno-0-157" name="__codelineno-0-157"></a>
-</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="sd">                fastcrud/examples/tier/model.py:imports</span>
-</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a><span class="sd">                fastcrud/examples/tier/model.py:model</span>
-</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">                ```</span>
-</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a>
-</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">            ??? example &quot;`tier/schemas.py`&quot;</span>
-</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a>
-</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a><span class="sd">                fastcrud/examples/tier/schemas.py:imports</span>
-</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="sd">                fastcrud/examples/tier/schemas.py:readschema</span>
-</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="sd">                ```</span>
-</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a>
-</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd">            ??? example &quot;`department/model.py`&quot;</span>
-</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a>
-</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178"></a><span class="sd">                fastcrud/examples/department/model.py:imports</span>
-</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a><span class="sd">                fastcrud/examples/department/model.py:model</span>
-</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a><span class="sd">                ```</span>
-</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a>
-</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">            ??? example &quot;`department/schemas.py`&quot;</span>
-</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a>
-</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="sd">                fastcrud/examples/department/schemas.py:imports</span>
-</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">                fastcrud/examples/department/schemas.py:readschema</span>
-</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">                ```</span>
-</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a>
-</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="sd">            ??? example &quot;`user/model.py`&quot;</span>
-</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a>
-</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196"></a><span class="sd">                fastcrud/examples/user/model.py:imports</span>
-</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">                fastcrud/examples/user/model.py:model</span>
-</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">                ```</span>
-</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a>
-</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">            ??? example &quot;`user/schemas.py`&quot;</span>
-</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a>
-</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">                fastcrud/examples/user/schemas.py:imports</span>
-</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a><span class="sd">                fastcrud/examples/user/schemas.py:createschema</span>
-</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">                fastcrud/examples/user/schemas.py:readschema</span>
-</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">                fastcrud/examples/user/schemas.py:updateschema</span>
-</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a><span class="sd">                fastcrud/examples/user/schemas.py:deleteschema</span>
-</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a><span class="sd">                ```</span>
-</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a>
-</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">            ??? example &quot;`story/model.py`&quot;</span>
-</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a>
-</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">                fastcrud/examples/story/model.py:imports</span>
-</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a><span class="sd">                fastcrud/examples/story/model.py:model</span>
-</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">                ```</span>
-</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a>
-</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">            ??? example &quot;`story/schemas.py`&quot;</span>
-</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a>
-</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">                fastcrud/examples/story/schemas.py:imports</span>
-</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a><span class="sd">                fastcrud/examples/story/schemas.py:createschema</span>
-</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd">                fastcrud/examples/story/schemas.py:readschema</span>
-</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd">                fastcrud/examples/story/schemas.py:updateschema</span>
-</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd">                fastcrud/examples/story/schemas.py:deleteschema</span>
-</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd">                ```</span>
-</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a>
-</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">            ??? example &quot;`task/model.py`&quot;</span>
-</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a>
-</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd">                fastcrud/examples/task/model.py:imports</span>
-</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a><span class="sd">                fastcrud/examples/task/model.py:model</span>
-</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd">                ```</span>
-</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a>
-</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a><span class="sd">            ??? example &quot;`task/schemas.py`&quot;</span>
-</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a>
-</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a><span class="sd">                fastcrud/examples/task/schemas.py:imports</span>
-</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a><span class="sd">                fastcrud/examples/task/schemas.py:createschema</span>
-</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a><span class="sd">                fastcrud/examples/task/schemas.py:readschema</span>
-</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a><span class="sd">                fastcrud/examples/task/schemas.py:updateschema</span>
-</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a><span class="sd">                fastcrud/examples/task/schemas.py:deleteschema</span>
-</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a><span class="sd">                ```</span>
-</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a>
-</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a><span class="sd">            ---</span>
-</span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256"></a>
-</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a><span class="sd">            ??? example &quot;`profile/model.py`&quot;</span>
+</span><span id="__span-0-158"><a id="__codelineno-0-158" name="__codelineno-0-158"></a><span class="sd">            ---</span>
+</span><span id="__span-0-159"><a id="__codelineno-0-159" name="__codelineno-0-159"></a>
+</span><span id="__span-0-160"><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="sd">            ??? example &quot;`tier/model.py`&quot;</span>
+</span><span id="__span-0-161"><a id="__codelineno-0-161" name="__codelineno-0-161"></a>
+</span><span id="__span-0-162"><a id="__codelineno-0-162" name="__codelineno-0-162"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-163"><a id="__codelineno-0-163" name="__codelineno-0-163"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-164"><a id="__codelineno-0-164" name="__codelineno-0-164"></a><span class="sd">                fastcrud/examples/tier/model.py:imports</span>
+</span><span id="__span-0-165"><a id="__codelineno-0-165" name="__codelineno-0-165"></a><span class="sd">                fastcrud/examples/tier/model.py:model</span>
+</span><span id="__span-0-166"><a id="__codelineno-0-166" name="__codelineno-0-166"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-167"><a id="__codelineno-0-167" name="__codelineno-0-167"></a><span class="sd">                ```</span>
+</span><span id="__span-0-168"><a id="__codelineno-0-168" name="__codelineno-0-168"></a>
+</span><span id="__span-0-169"><a id="__codelineno-0-169" name="__codelineno-0-169"></a><span class="sd">            ??? example &quot;`tier/schemas.py`&quot;</span>
+</span><span id="__span-0-170"><a id="__codelineno-0-170" name="__codelineno-0-170"></a>
+</span><span id="__span-0-171"><a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-172"><a id="__codelineno-0-172" name="__codelineno-0-172"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-173"><a id="__codelineno-0-173" name="__codelineno-0-173"></a><span class="sd">                fastcrud/examples/tier/schemas.py:imports</span>
+</span><span id="__span-0-174"><a id="__codelineno-0-174" name="__codelineno-0-174"></a><span class="sd">                fastcrud/examples/tier/schemas.py:readschema</span>
+</span><span id="__span-0-175"><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-176"><a id="__codelineno-0-176" name="__codelineno-0-176"></a><span class="sd">                ```</span>
+</span><span id="__span-0-177"><a id="__codelineno-0-177" name="__codelineno-0-177"></a>
+</span><span id="__span-0-178"><a id="__codelineno-0-178" name="__codelineno-0-178"></a><span class="sd">            ??? example &quot;`department/model.py`&quot;</span>
+</span><span id="__span-0-179"><a id="__codelineno-0-179" name="__codelineno-0-179"></a>
+</span><span id="__span-0-180"><a id="__codelineno-0-180" name="__codelineno-0-180"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-181"><a id="__codelineno-0-181" name="__codelineno-0-181"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-182"><a id="__codelineno-0-182" name="__codelineno-0-182"></a><span class="sd">                fastcrud/examples/department/model.py:imports</span>
+</span><span id="__span-0-183"><a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">                fastcrud/examples/department/model.py:model</span>
+</span><span id="__span-0-184"><a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-185"><a id="__codelineno-0-185" name="__codelineno-0-185"></a><span class="sd">                ```</span>
+</span><span id="__span-0-186"><a id="__codelineno-0-186" name="__codelineno-0-186"></a>
+</span><span id="__span-0-187"><a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="sd">            ??? example &quot;`department/schemas.py`&quot;</span>
+</span><span id="__span-0-188"><a id="__codelineno-0-188" name="__codelineno-0-188"></a>
+</span><span id="__span-0-189"><a id="__codelineno-0-189" name="__codelineno-0-189"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-190"><a id="__codelineno-0-190" name="__codelineno-0-190"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-191"><a id="__codelineno-0-191" name="__codelineno-0-191"></a><span class="sd">                fastcrud/examples/department/schemas.py:imports</span>
+</span><span id="__span-0-192"><a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="sd">                fastcrud/examples/department/schemas.py:readschema</span>
+</span><span id="__span-0-193"><a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-194"><a id="__codelineno-0-194" name="__codelineno-0-194"></a><span class="sd">                ```</span>
+</span><span id="__span-0-195"><a id="__codelineno-0-195" name="__codelineno-0-195"></a>
+</span><span id="__span-0-196"><a id="__codelineno-0-196" name="__codelineno-0-196"></a><span class="sd">            ??? example &quot;`user/model.py`&quot;</span>
+</span><span id="__span-0-197"><a id="__codelineno-0-197" name="__codelineno-0-197"></a>
+</span><span id="__span-0-198"><a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-199"><a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-200"><a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">                fastcrud/examples/user/model.py:imports</span>
+</span><span id="__span-0-201"><a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">                fastcrud/examples/user/model.py:model</span>
+</span><span id="__span-0-202"><a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-203"><a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">                ```</span>
+</span><span id="__span-0-204"><a id="__codelineno-0-204" name="__codelineno-0-204"></a>
+</span><span id="__span-0-205"><a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">            ??? example &quot;`user/schemas.py`&quot;</span>
+</span><span id="__span-0-206"><a id="__codelineno-0-206" name="__codelineno-0-206"></a>
+</span><span id="__span-0-207"><a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-208"><a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-209"><a id="__codelineno-0-209" name="__codelineno-0-209"></a><span class="sd">                fastcrud/examples/user/schemas.py:imports</span>
+</span><span id="__span-0-210"><a id="__codelineno-0-210" name="__codelineno-0-210"></a><span class="sd">                fastcrud/examples/user/schemas.py:createschema</span>
+</span><span id="__span-0-211"><a id="__codelineno-0-211" name="__codelineno-0-211"></a><span class="sd">                fastcrud/examples/user/schemas.py:readschema</span>
+</span><span id="__span-0-212"><a id="__codelineno-0-212" name="__codelineno-0-212"></a><span class="sd">                fastcrud/examples/user/schemas.py:updateschema</span>
+</span><span id="__span-0-213"><a id="__codelineno-0-213" name="__codelineno-0-213"></a><span class="sd">                fastcrud/examples/user/schemas.py:deleteschema</span>
+</span><span id="__span-0-214"><a id="__codelineno-0-214" name="__codelineno-0-214"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-215"><a id="__codelineno-0-215" name="__codelineno-0-215"></a><span class="sd">                ```</span>
+</span><span id="__span-0-216"><a id="__codelineno-0-216" name="__codelineno-0-216"></a>
+</span><span id="__span-0-217"><a id="__codelineno-0-217" name="__codelineno-0-217"></a><span class="sd">            ??? example &quot;`story/model.py`&quot;</span>
+</span><span id="__span-0-218"><a id="__codelineno-0-218" name="__codelineno-0-218"></a>
+</span><span id="__span-0-219"><a id="__codelineno-0-219" name="__codelineno-0-219"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-220"><a id="__codelineno-0-220" name="__codelineno-0-220"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-221"><a id="__codelineno-0-221" name="__codelineno-0-221"></a><span class="sd">                fastcrud/examples/story/model.py:imports</span>
+</span><span id="__span-0-222"><a id="__codelineno-0-222" name="__codelineno-0-222"></a><span class="sd">                fastcrud/examples/story/model.py:model</span>
+</span><span id="__span-0-223"><a id="__codelineno-0-223" name="__codelineno-0-223"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-224"><a id="__codelineno-0-224" name="__codelineno-0-224"></a><span class="sd">                ```</span>
+</span><span id="__span-0-225"><a id="__codelineno-0-225" name="__codelineno-0-225"></a>
+</span><span id="__span-0-226"><a id="__codelineno-0-226" name="__codelineno-0-226"></a><span class="sd">            ??? example &quot;`story/schemas.py`&quot;</span>
+</span><span id="__span-0-227"><a id="__codelineno-0-227" name="__codelineno-0-227"></a>
+</span><span id="__span-0-228"><a id="__codelineno-0-228" name="__codelineno-0-228"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-229"><a id="__codelineno-0-229" name="__codelineno-0-229"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-230"><a id="__codelineno-0-230" name="__codelineno-0-230"></a><span class="sd">                fastcrud/examples/story/schemas.py:imports</span>
+</span><span id="__span-0-231"><a id="__codelineno-0-231" name="__codelineno-0-231"></a><span class="sd">                fastcrud/examples/story/schemas.py:createschema</span>
+</span><span id="__span-0-232"><a id="__codelineno-0-232" name="__codelineno-0-232"></a><span class="sd">                fastcrud/examples/story/schemas.py:readschema</span>
+</span><span id="__span-0-233"><a id="__codelineno-0-233" name="__codelineno-0-233"></a><span class="sd">                fastcrud/examples/story/schemas.py:updateschema</span>
+</span><span id="__span-0-234"><a id="__codelineno-0-234" name="__codelineno-0-234"></a><span class="sd">                fastcrud/examples/story/schemas.py:deleteschema</span>
+</span><span id="__span-0-235"><a id="__codelineno-0-235" name="__codelineno-0-235"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-236"><a id="__codelineno-0-236" name="__codelineno-0-236"></a><span class="sd">                ```</span>
+</span><span id="__span-0-237"><a id="__codelineno-0-237" name="__codelineno-0-237"></a>
+</span><span id="__span-0-238"><a id="__codelineno-0-238" name="__codelineno-0-238"></a><span class="sd">            ??? example &quot;`task/model.py`&quot;</span>
+</span><span id="__span-0-239"><a id="__codelineno-0-239" name="__codelineno-0-239"></a>
+</span><span id="__span-0-240"><a id="__codelineno-0-240" name="__codelineno-0-240"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-241"><a id="__codelineno-0-241" name="__codelineno-0-241"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-242"><a id="__codelineno-0-242" name="__codelineno-0-242"></a><span class="sd">                fastcrud/examples/task/model.py:imports</span>
+</span><span id="__span-0-243"><a id="__codelineno-0-243" name="__codelineno-0-243"></a><span class="sd">                fastcrud/examples/task/model.py:model</span>
+</span><span id="__span-0-244"><a id="__codelineno-0-244" name="__codelineno-0-244"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-245"><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="sd">                ```</span>
+</span><span id="__span-0-246"><a id="__codelineno-0-246" name="__codelineno-0-246"></a>
+</span><span id="__span-0-247"><a id="__codelineno-0-247" name="__codelineno-0-247"></a><span class="sd">            ??? example &quot;`task/schemas.py`&quot;</span>
+</span><span id="__span-0-248"><a id="__codelineno-0-248" name="__codelineno-0-248"></a>
+</span><span id="__span-0-249"><a id="__codelineno-0-249" name="__codelineno-0-249"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-250"><a id="__codelineno-0-250" name="__codelineno-0-250"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-251"><a id="__codelineno-0-251" name="__codelineno-0-251"></a><span class="sd">                fastcrud/examples/task/schemas.py:imports</span>
+</span><span id="__span-0-252"><a id="__codelineno-0-252" name="__codelineno-0-252"></a><span class="sd">                fastcrud/examples/task/schemas.py:createschema</span>
+</span><span id="__span-0-253"><a id="__codelineno-0-253" name="__codelineno-0-253"></a><span class="sd">                fastcrud/examples/task/schemas.py:readschema</span>
+</span><span id="__span-0-254"><a id="__codelineno-0-254" name="__codelineno-0-254"></a><span class="sd">                fastcrud/examples/task/schemas.py:updateschema</span>
+</span><span id="__span-0-255"><a id="__codelineno-0-255" name="__codelineno-0-255"></a><span class="sd">                fastcrud/examples/task/schemas.py:deleteschema</span>
+</span><span id="__span-0-256"><a id="__codelineno-0-256" name="__codelineno-0-256"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-257"><a id="__codelineno-0-257" name="__codelineno-0-257"></a><span class="sd">                ```</span>
 </span><span id="__span-0-258"><a id="__codelineno-0-258" name="__codelineno-0-258"></a>
-</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a><span class="sd">                fastcrud/examples/profile/model.py:imports</span>
-</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a><span class="sd">                fastcrud/examples/profile/model.py:model</span>
-</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a><span class="sd">                ```</span>
-</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a>
-</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a><span class="sd">            ??? example &quot;`profile/schemas.py`&quot;</span>
-</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a>
-</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a><span class="sd">                fastcrud/examples/profile/schemas.py:imports</span>
-</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a><span class="sd">                fastcrud/examples/profile/schemas.py:readschema</span>
-</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a><span class="sd">                ```</span>
-</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a>
-</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a><span class="sd">            ??? example &quot;`author/model.py`&quot;</span>
-</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a>
-</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a><span class="sd">                fastcrud/examples/author/model.py:imports</span>
-</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a><span class="sd">                fastcrud/examples/author/model.py:model</span>
-</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a><span class="sd">                ```</span>
-</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a>
-</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a><span class="sd">            ??? example &quot;`author/schemas.py`&quot;</span>
-</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a>
-</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a><span class="sd">                fastcrud/examples/author/schemas.py:imports</span>
-</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a><span class="sd">                fastcrud/examples/author/schemas.py:readschema</span>
-</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a><span class="sd">                ```</span>
-</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a>
-</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a><span class="sd">            ??? example &quot;`article/model.py`&quot;</span>
-</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a>
-</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a><span class="sd">                fastcrud/examples/article/model.py:imports</span>
-</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a><span class="sd">                fastcrud/examples/article/model.py:model</span>
-</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a><span class="sd">                ```</span>
-</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a>
-</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a><span class="sd">            ??? example &quot;`article/schemas.py`&quot;</span>
-</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a>
-</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a><span class="sd">                ```python</span>
-</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a><span class="sd">                fastcrud/examples/article/schemas.py:imports</span>
-</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a><span class="sd">                fastcrud/examples/article/schemas.py:readschema</span>
-</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a><span class="sd">                --8&lt;--</span>
-</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a><span class="sd">                ```</span>
-</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a>
-</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a><span class="sd">        Example 1: Basic Usage</span>
-</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a><span class="sd">        ----------------------</span>
-</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a>
-</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a><span class="sd">        Create a FastCRUD instance for a `User` model and perform basic CRUD operations.</span>
-</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a>
-</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a><span class="sd">        # Assuming you have a User model (either SQLAlchemy or SQLModel)</span>
-</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a><span class="sd">        # pydantic schemas for creation, update and deletion and an async session `db`</span>
-</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a><span class="sd">        UserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]</span>
-</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a><span class="sd">        user_crud = UserCRUD(User)</span>
-</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a>
-</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a><span class="sd">        # If you don&#39;t care about typing, you can also just ignore the UserCRUD part</span>
-</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a><span class="sd">        # Straight up define user_crud with FastCRUD</span>
-</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a><span class="sd">        user_crud = FastCRUD(User)</span>
+</span><span id="__span-0-259"><a id="__codelineno-0-259" name="__codelineno-0-259"></a><span class="sd">            ---</span>
+</span><span id="__span-0-260"><a id="__codelineno-0-260" name="__codelineno-0-260"></a>
+</span><span id="__span-0-261"><a id="__codelineno-0-261" name="__codelineno-0-261"></a><span class="sd">            ??? example &quot;`profile/model.py`&quot;</span>
+</span><span id="__span-0-262"><a id="__codelineno-0-262" name="__codelineno-0-262"></a>
+</span><span id="__span-0-263"><a id="__codelineno-0-263" name="__codelineno-0-263"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-264"><a id="__codelineno-0-264" name="__codelineno-0-264"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-265"><a id="__codelineno-0-265" name="__codelineno-0-265"></a><span class="sd">                fastcrud/examples/profile/model.py:imports</span>
+</span><span id="__span-0-266"><a id="__codelineno-0-266" name="__codelineno-0-266"></a><span class="sd">                fastcrud/examples/profile/model.py:model</span>
+</span><span id="__span-0-267"><a id="__codelineno-0-267" name="__codelineno-0-267"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-268"><a id="__codelineno-0-268" name="__codelineno-0-268"></a><span class="sd">                ```</span>
+</span><span id="__span-0-269"><a id="__codelineno-0-269" name="__codelineno-0-269"></a>
+</span><span id="__span-0-270"><a id="__codelineno-0-270" name="__codelineno-0-270"></a><span class="sd">            ??? example &quot;`profile/schemas.py`&quot;</span>
+</span><span id="__span-0-271"><a id="__codelineno-0-271" name="__codelineno-0-271"></a>
+</span><span id="__span-0-272"><a id="__codelineno-0-272" name="__codelineno-0-272"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-273"><a id="__codelineno-0-273" name="__codelineno-0-273"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-274"><a id="__codelineno-0-274" name="__codelineno-0-274"></a><span class="sd">                fastcrud/examples/profile/schemas.py:imports</span>
+</span><span id="__span-0-275"><a id="__codelineno-0-275" name="__codelineno-0-275"></a><span class="sd">                fastcrud/examples/profile/schemas.py:readschema</span>
+</span><span id="__span-0-276"><a id="__codelineno-0-276" name="__codelineno-0-276"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-277"><a id="__codelineno-0-277" name="__codelineno-0-277"></a><span class="sd">                ```</span>
+</span><span id="__span-0-278"><a id="__codelineno-0-278" name="__codelineno-0-278"></a>
+</span><span id="__span-0-279"><a id="__codelineno-0-279" name="__codelineno-0-279"></a><span class="sd">            ??? example &quot;`author/model.py`&quot;</span>
+</span><span id="__span-0-280"><a id="__codelineno-0-280" name="__codelineno-0-280"></a>
+</span><span id="__span-0-281"><a id="__codelineno-0-281" name="__codelineno-0-281"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-282"><a id="__codelineno-0-282" name="__codelineno-0-282"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-283"><a id="__codelineno-0-283" name="__codelineno-0-283"></a><span class="sd">                fastcrud/examples/author/model.py:imports</span>
+</span><span id="__span-0-284"><a id="__codelineno-0-284" name="__codelineno-0-284"></a><span class="sd">                fastcrud/examples/author/model.py:model</span>
+</span><span id="__span-0-285"><a id="__codelineno-0-285" name="__codelineno-0-285"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-286"><a id="__codelineno-0-286" name="__codelineno-0-286"></a><span class="sd">                ```</span>
+</span><span id="__span-0-287"><a id="__codelineno-0-287" name="__codelineno-0-287"></a>
+</span><span id="__span-0-288"><a id="__codelineno-0-288" name="__codelineno-0-288"></a><span class="sd">            ??? example &quot;`author/schemas.py`&quot;</span>
+</span><span id="__span-0-289"><a id="__codelineno-0-289" name="__codelineno-0-289"></a>
+</span><span id="__span-0-290"><a id="__codelineno-0-290" name="__codelineno-0-290"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-291"><a id="__codelineno-0-291" name="__codelineno-0-291"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-292"><a id="__codelineno-0-292" name="__codelineno-0-292"></a><span class="sd">                fastcrud/examples/author/schemas.py:imports</span>
+</span><span id="__span-0-293"><a id="__codelineno-0-293" name="__codelineno-0-293"></a><span class="sd">                fastcrud/examples/author/schemas.py:readschema</span>
+</span><span id="__span-0-294"><a id="__codelineno-0-294" name="__codelineno-0-294"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-295"><a id="__codelineno-0-295" name="__codelineno-0-295"></a><span class="sd">                ```</span>
+</span><span id="__span-0-296"><a id="__codelineno-0-296" name="__codelineno-0-296"></a>
+</span><span id="__span-0-297"><a id="__codelineno-0-297" name="__codelineno-0-297"></a><span class="sd">            ??? example &quot;`article/model.py`&quot;</span>
+</span><span id="__span-0-298"><a id="__codelineno-0-298" name="__codelineno-0-298"></a>
+</span><span id="__span-0-299"><a id="__codelineno-0-299" name="__codelineno-0-299"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-300"><a id="__codelineno-0-300" name="__codelineno-0-300"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-301"><a id="__codelineno-0-301" name="__codelineno-0-301"></a><span class="sd">                fastcrud/examples/article/model.py:imports</span>
+</span><span id="__span-0-302"><a id="__codelineno-0-302" name="__codelineno-0-302"></a><span class="sd">                fastcrud/examples/article/model.py:model</span>
+</span><span id="__span-0-303"><a id="__codelineno-0-303" name="__codelineno-0-303"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-304"><a id="__codelineno-0-304" name="__codelineno-0-304"></a><span class="sd">                ```</span>
+</span><span id="__span-0-305"><a id="__codelineno-0-305" name="__codelineno-0-305"></a>
+</span><span id="__span-0-306"><a id="__codelineno-0-306" name="__codelineno-0-306"></a><span class="sd">            ??? example &quot;`article/schemas.py`&quot;</span>
+</span><span id="__span-0-307"><a id="__codelineno-0-307" name="__codelineno-0-307"></a>
+</span><span id="__span-0-308"><a id="__codelineno-0-308" name="__codelineno-0-308"></a><span class="sd">                ```python</span>
+</span><span id="__span-0-309"><a id="__codelineno-0-309" name="__codelineno-0-309"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-310"><a id="__codelineno-0-310" name="__codelineno-0-310"></a><span class="sd">                fastcrud/examples/article/schemas.py:imports</span>
+</span><span id="__span-0-311"><a id="__codelineno-0-311" name="__codelineno-0-311"></a><span class="sd">                fastcrud/examples/article/schemas.py:readschema</span>
+</span><span id="__span-0-312"><a id="__codelineno-0-312" name="__codelineno-0-312"></a><span class="sd">                --8&lt;--</span>
+</span><span id="__span-0-313"><a id="__codelineno-0-313" name="__codelineno-0-313"></a><span class="sd">                ```</span>
+</span><span id="__span-0-314"><a id="__codelineno-0-314" name="__codelineno-0-314"></a>
+</span><span id="__span-0-315"><a id="__codelineno-0-315" name="__codelineno-0-315"></a><span class="sd">        Example 1: Basic Usage</span>
+</span><span id="__span-0-316"><a id="__codelineno-0-316" name="__codelineno-0-316"></a><span class="sd">        ----------------------</span>
+</span><span id="__span-0-317"><a id="__codelineno-0-317" name="__codelineno-0-317"></a>
+</span><span id="__span-0-318"><a id="__codelineno-0-318" name="__codelineno-0-318"></a><span class="sd">        Create a FastCRUD instance for a `User` model and perform basic CRUD operations.</span>
+</span><span id="__span-0-319"><a id="__codelineno-0-319" name="__codelineno-0-319"></a>
+</span><span id="__span-0-320"><a id="__codelineno-0-320" name="__codelineno-0-320"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-321"><a id="__codelineno-0-321" name="__codelineno-0-321"></a><span class="sd">        # Assuming you have a User model (either SQLAlchemy or SQLModel)</span>
+</span><span id="__span-0-322"><a id="__codelineno-0-322" name="__codelineno-0-322"></a><span class="sd">        # pydantic schemas for creation, update and deletion and an async session `db`</span>
+</span><span id="__span-0-323"><a id="__codelineno-0-323" name="__codelineno-0-323"></a><span class="sd">        UserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]</span>
+</span><span id="__span-0-324"><a id="__codelineno-0-324" name="__codelineno-0-324"></a><span class="sd">        user_crud = UserCRUD(User)</span>
 </span><span id="__span-0-325"><a id="__codelineno-0-325" name="__codelineno-0-325"></a>
-</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a><span class="sd">        # Create a new user</span>
-</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a><span class="sd">        new_user = await user_crud.create(db, CreateUserSchema(name=&quot;Alice&quot;))</span>
-</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a><span class="sd">        # Read a user</span>
-</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a><span class="sd">        user = await user_crud.get(db, id=new_user.id)</span>
-</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a><span class="sd">        # Update a user</span>
-</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a><span class="sd">        await user_crud.update(db, UpdateUserSchema(email=&quot;alice@example.com&quot;), id=new_user.id)</span>
-</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a><span class="sd">        # Delete a user</span>
-</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a><span class="sd">        await user_crud.delete(db, id=new_user.id)</span>
-</span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334"></a><span class="sd">        ```</span>
-</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a>
-</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a><span class="sd">        Example 2: Advanced Filtering and Pagination</span>
-</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a><span class="sd">        --------------------------------------------</span>
-</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a>
-</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a><span class="sd">        Use advanced filtering, sorting, and pagination for fetching records.</span>
-</span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340"></a>
-</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a><span class="sd">        product_crud = FastCRUD(Product)</span>
-</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a><span class="sd">        products = await product_crud.get_multi(</span>
-</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a><span class="sd">            db,</span>
-</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a><span class="sd">            sort_columns=[&#39;price&#39;],</span>
-</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a><span class="sd">            sort_orders=[&#39;asc&#39;],</span>
-</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a><span class="sd">        )</span>
-</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a><span class="sd">        ```</span>
-</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a>
-</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a><span class="sd">        Example 3: Join Operations with Custom Schemas</span>
-</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a><span class="sd">        ----------------------------------------------</span>
-</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a>
-</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a><span class="sd">        Perform join operations between two models using custom schemas for selection.</span>
-</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a>
-</span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a><span class="sd">        order_crud = FastCRUD(Order)</span>
-</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a><span class="sd">        orders = await order_crud.get_multi_joined(</span>
-</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a><span class="sd">            db,</span>
-</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a><span class="sd">            schema_to_select=ReadOrderSchema,</span>
-</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a><span class="sd">            join_model=Product,</span>
-</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a><span class="sd">            join_prefix=&quot;product_&quot;,</span>
-</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a><span class="sd">            join_schema_to_select=ReadProductSchema,</span>
-</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a><span class="sd">            limit=5,</span>
-</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a><span class="sd">        )</span>
-</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a><span class="sd">        ```</span>
-</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a>
-</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a><span class="sd">        Example 4: Cursor Pagination</span>
-</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a><span class="sd">        ----------------------------</span>
-</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a>
-</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a><span class="sd">        Implement cursor-based pagination for efficient data retrieval in large datasets.</span>
-</span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374"></a>
-</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a><span class="sd">        class Comment(Base):</span>
-</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a><span class="sd">            id = Column(Integer, primary_key=True)</span>
-</span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378"></a><span class="sd">            user_id = Column(Integer, ForeignKey(&quot;user.id&quot;))</span>
-</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a><span class="sd">            subject = Column(String)</span>
-</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a><span class="sd">            body = Column(String)</span>
-</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a>
-</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a><span class="sd">        comment_crud = FastCRUD(Comment)</span>
-</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a>
-</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a><span class="sd">        first_page = await comment_crud.get_multi_by_cursor(db, limit=10)</span>
-</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a><span class="sd">        next_cursor = first_page[&#39;next_cursor&#39;]</span>
-</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a><span class="sd">        second_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)</span>
-</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a><span class="sd">        ```</span>
-</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a>
-</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a><span class="sd">        Example 5: Dynamic Filtering and Counting</span>
-</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a><span class="sd">        -----------------------------------------</span>
-</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a><span class="sd">        Dynamically filter records based on various criteria and count the results.</span>
+</span><span id="__span-0-326"><a id="__codelineno-0-326" name="__codelineno-0-326"></a><span class="sd">        # If you don&#39;t care about typing, you can also just ignore the UserCRUD part</span>
+</span><span id="__span-0-327"><a id="__codelineno-0-327" name="__codelineno-0-327"></a><span class="sd">        # Straight up define user_crud with FastCRUD</span>
+</span><span id="__span-0-328"><a id="__codelineno-0-328" name="__codelineno-0-328"></a><span class="sd">        user_crud = FastCRUD(User)</span>
+</span><span id="__span-0-329"><a id="__codelineno-0-329" name="__codelineno-0-329"></a>
+</span><span id="__span-0-330"><a id="__codelineno-0-330" name="__codelineno-0-330"></a><span class="sd">        # Create a new user</span>
+</span><span id="__span-0-331"><a id="__codelineno-0-331" name="__codelineno-0-331"></a><span class="sd">        new_user = await user_crud.create(db, CreateUserSchema(name=&quot;Alice&quot;))</span>
+</span><span id="__span-0-332"><a id="__codelineno-0-332" name="__codelineno-0-332"></a><span class="sd">        # Read a user</span>
+</span><span id="__span-0-333"><a id="__codelineno-0-333" name="__codelineno-0-333"></a><span class="sd">        user = await user_crud.get(db, id=new_user.id)</span>
+</span><span id="__span-0-334"><a id="__codelineno-0-334" name="__codelineno-0-334"></a><span class="sd">        # Update a user</span>
+</span><span id="__span-0-335"><a id="__codelineno-0-335" name="__codelineno-0-335"></a><span class="sd">        await user_crud.update(db, UpdateUserSchema(email=&quot;alice@example.com&quot;), id=new_user.id)</span>
+</span><span id="__span-0-336"><a id="__codelineno-0-336" name="__codelineno-0-336"></a><span class="sd">        # Delete a user</span>
+</span><span id="__span-0-337"><a id="__codelineno-0-337" name="__codelineno-0-337"></a><span class="sd">        await user_crud.delete(db, id=new_user.id)</span>
+</span><span id="__span-0-338"><a id="__codelineno-0-338" name="__codelineno-0-338"></a><span class="sd">        ```</span>
+</span><span id="__span-0-339"><a id="__codelineno-0-339" name="__codelineno-0-339"></a>
+</span><span id="__span-0-340"><a id="__codelineno-0-340" name="__codelineno-0-340"></a><span class="sd">        Example 2: Advanced Filtering and Pagination</span>
+</span><span id="__span-0-341"><a id="__codelineno-0-341" name="__codelineno-0-341"></a><span class="sd">        --------------------------------------------</span>
+</span><span id="__span-0-342"><a id="__codelineno-0-342" name="__codelineno-0-342"></a>
+</span><span id="__span-0-343"><a id="__codelineno-0-343" name="__codelineno-0-343"></a><span class="sd">        Use advanced filtering, sorting, and pagination for fetching records.</span>
+</span><span id="__span-0-344"><a id="__codelineno-0-344" name="__codelineno-0-344"></a>
+</span><span id="__span-0-345"><a id="__codelineno-0-345" name="__codelineno-0-345"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-346"><a id="__codelineno-0-346" name="__codelineno-0-346"></a><span class="sd">        product_crud = FastCRUD(Product)</span>
+</span><span id="__span-0-347"><a id="__codelineno-0-347" name="__codelineno-0-347"></a><span class="sd">        products = await product_crud.get_multi(</span>
+</span><span id="__span-0-348"><a id="__codelineno-0-348" name="__codelineno-0-348"></a><span class="sd">            db,</span>
+</span><span id="__span-0-349"><a id="__codelineno-0-349" name="__codelineno-0-349"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-350"><a id="__codelineno-0-350" name="__codelineno-0-350"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-351"><a id="__codelineno-0-351" name="__codelineno-0-351"></a><span class="sd">            sort_columns=[&#39;price&#39;],</span>
+</span><span id="__span-0-352"><a id="__codelineno-0-352" name="__codelineno-0-352"></a><span class="sd">            sort_orders=[&#39;asc&#39;],</span>
+</span><span id="__span-0-353"><a id="__codelineno-0-353" name="__codelineno-0-353"></a><span class="sd">        )</span>
+</span><span id="__span-0-354"><a id="__codelineno-0-354" name="__codelineno-0-354"></a><span class="sd">        ```</span>
+</span><span id="__span-0-355"><a id="__codelineno-0-355" name="__codelineno-0-355"></a>
+</span><span id="__span-0-356"><a id="__codelineno-0-356" name="__codelineno-0-356"></a><span class="sd">        Example 3: Join Operations with Custom Schemas</span>
+</span><span id="__span-0-357"><a id="__codelineno-0-357" name="__codelineno-0-357"></a><span class="sd">        ----------------------------------------------</span>
+</span><span id="__span-0-358"><a id="__codelineno-0-358" name="__codelineno-0-358"></a>
+</span><span id="__span-0-359"><a id="__codelineno-0-359" name="__codelineno-0-359"></a><span class="sd">        Perform join operations between two models using custom schemas for selection.</span>
+</span><span id="__span-0-360"><a id="__codelineno-0-360" name="__codelineno-0-360"></a>
+</span><span id="__span-0-361"><a id="__codelineno-0-361" name="__codelineno-0-361"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-362"><a id="__codelineno-0-362" name="__codelineno-0-362"></a><span class="sd">        order_crud = FastCRUD(Order)</span>
+</span><span id="__span-0-363"><a id="__codelineno-0-363" name="__codelineno-0-363"></a><span class="sd">        orders = await order_crud.get_multi_joined(</span>
+</span><span id="__span-0-364"><a id="__codelineno-0-364" name="__codelineno-0-364"></a><span class="sd">            db,</span>
+</span><span id="__span-0-365"><a id="__codelineno-0-365" name="__codelineno-0-365"></a><span class="sd">            schema_to_select=ReadOrderSchema,</span>
+</span><span id="__span-0-366"><a id="__codelineno-0-366" name="__codelineno-0-366"></a><span class="sd">            join_model=Product,</span>
+</span><span id="__span-0-367"><a id="__codelineno-0-367" name="__codelineno-0-367"></a><span class="sd">            join_prefix=&quot;product_&quot;,</span>
+</span><span id="__span-0-368"><a id="__codelineno-0-368" name="__codelineno-0-368"></a><span class="sd">            join_schema_to_select=ReadProductSchema,</span>
+</span><span id="__span-0-369"><a id="__codelineno-0-369" name="__codelineno-0-369"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-370"><a id="__codelineno-0-370" name="__codelineno-0-370"></a><span class="sd">            limit=5,</span>
+</span><span id="__span-0-371"><a id="__codelineno-0-371" name="__codelineno-0-371"></a><span class="sd">        )</span>
+</span><span id="__span-0-372"><a id="__codelineno-0-372" name="__codelineno-0-372"></a><span class="sd">        ```</span>
+</span><span id="__span-0-373"><a id="__codelineno-0-373" name="__codelineno-0-373"></a>
+</span><span id="__span-0-374"><a id="__codelineno-0-374" name="__codelineno-0-374"></a><span class="sd">        Example 4: Cursor Pagination</span>
+</span><span id="__span-0-375"><a id="__codelineno-0-375" name="__codelineno-0-375"></a><span class="sd">        ----------------------------</span>
+</span><span id="__span-0-376"><a id="__codelineno-0-376" name="__codelineno-0-376"></a>
+</span><span id="__span-0-377"><a id="__codelineno-0-377" name="__codelineno-0-377"></a><span class="sd">        Implement cursor-based pagination for efficient data retrieval in large datasets.</span>
+</span><span id="__span-0-378"><a id="__codelineno-0-378" name="__codelineno-0-378"></a>
+</span><span id="__span-0-379"><a id="__codelineno-0-379" name="__codelineno-0-379"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-380"><a id="__codelineno-0-380" name="__codelineno-0-380"></a><span class="sd">        class Comment(Base):</span>
+</span><span id="__span-0-381"><a id="__codelineno-0-381" name="__codelineno-0-381"></a><span class="sd">            id = Column(Integer, primary_key=True)</span>
+</span><span id="__span-0-382"><a id="__codelineno-0-382" name="__codelineno-0-382"></a><span class="sd">            user_id = Column(Integer, ForeignKey(&quot;user.id&quot;))</span>
+</span><span id="__span-0-383"><a id="__codelineno-0-383" name="__codelineno-0-383"></a><span class="sd">            subject = Column(String)</span>
+</span><span id="__span-0-384"><a id="__codelineno-0-384" name="__codelineno-0-384"></a><span class="sd">            body = Column(String)</span>
+</span><span id="__span-0-385"><a id="__codelineno-0-385" name="__codelineno-0-385"></a>
+</span><span id="__span-0-386"><a id="__codelineno-0-386" name="__codelineno-0-386"></a><span class="sd">        comment_crud = FastCRUD(Comment)</span>
+</span><span id="__span-0-387"><a id="__codelineno-0-387" name="__codelineno-0-387"></a>
+</span><span id="__span-0-388"><a id="__codelineno-0-388" name="__codelineno-0-388"></a><span class="sd">        first_page = await comment_crud.get_multi_by_cursor(db, limit=10)</span>
+</span><span id="__span-0-389"><a id="__codelineno-0-389" name="__codelineno-0-389"></a><span class="sd">        next_cursor = first_page[&#39;next_cursor&#39;]</span>
+</span><span id="__span-0-390"><a id="__codelineno-0-390" name="__codelineno-0-390"></a><span class="sd">        second_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)</span>
+</span><span id="__span-0-391"><a id="__codelineno-0-391" name="__codelineno-0-391"></a><span class="sd">        ```</span>
 </span><span id="__span-0-392"><a id="__codelineno-0-392" name="__codelineno-0-392"></a>
-</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a><span class="sd">        task_crud = FastCRUD(Task)</span>
-</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a><span class="sd">        completed_tasks = await task_crud.get_multi(</span>
-</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a><span class="sd">            db,</span>
-</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a><span class="sd">            status=&#39;completed&#39;,</span>
-</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a><span class="sd">        )</span>
-</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a><span class="sd">        high_priority_task_count = await task_crud.count(</span>
+</span><span id="__span-0-393"><a id="__codelineno-0-393" name="__codelineno-0-393"></a><span class="sd">        Example 5: Dynamic Filtering and Counting</span>
+</span><span id="__span-0-394"><a id="__codelineno-0-394" name="__codelineno-0-394"></a><span class="sd">        -----------------------------------------</span>
+</span><span id="__span-0-395"><a id="__codelineno-0-395" name="__codelineno-0-395"></a><span class="sd">        Dynamically filter records based on various criteria and count the results.</span>
+</span><span id="__span-0-396"><a id="__codelineno-0-396" name="__codelineno-0-396"></a>
+</span><span id="__span-0-397"><a id="__codelineno-0-397" name="__codelineno-0-397"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-398"><a id="__codelineno-0-398" name="__codelineno-0-398"></a><span class="sd">        task_crud = FastCRUD(Task)</span>
+</span><span id="__span-0-399"><a id="__codelineno-0-399" name="__codelineno-0-399"></a><span class="sd">        completed_tasks = await task_crud.get_multi(</span>
 </span><span id="__span-0-400"><a id="__codelineno-0-400" name="__codelineno-0-400"></a><span class="sd">            db,</span>
-</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a><span class="sd">            priority=&#39;high&#39;,</span>
+</span><span id="__span-0-401"><a id="__codelineno-0-401" name="__codelineno-0-401"></a><span class="sd">            status=&#39;completed&#39;,</span>
 </span><span id="__span-0-402"><a id="__codelineno-0-402" name="__codelineno-0-402"></a><span class="sd">        )</span>
-</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a><span class="sd">        ```</span>
-</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a>
-</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a><span class="sd">        Example 6: Using Custom Column Names for Soft Delete</span>
-</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a><span class="sd">        ----------------------------------------------------</span>
-</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a>
-</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a><span class="sd">        If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the `FastCRUD` instance.</span>
-</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a>
-</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411"></a><span class="sd">        --8&lt;--</span>
-</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a><span class="sd">        fastcrud/examples/user/model.py:model_common</span>
-</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a><span class="sd">        --8&lt;--</span>
-</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">            ...</span>
+</span><span id="__span-0-403"><a id="__codelineno-0-403" name="__codelineno-0-403"></a><span class="sd">        high_priority_task_count = await task_crud.count(</span>
+</span><span id="__span-0-404"><a id="__codelineno-0-404" name="__codelineno-0-404"></a><span class="sd">            db,</span>
+</span><span id="__span-0-405"><a id="__codelineno-0-405" name="__codelineno-0-405"></a><span class="sd">            priority=&#39;high&#39;,</span>
+</span><span id="__span-0-406"><a id="__codelineno-0-406" name="__codelineno-0-406"></a><span class="sd">        )</span>
+</span><span id="__span-0-407"><a id="__codelineno-0-407" name="__codelineno-0-407"></a><span class="sd">        ```</span>
+</span><span id="__span-0-408"><a id="__codelineno-0-408" name="__codelineno-0-408"></a>
+</span><span id="__span-0-409"><a id="__codelineno-0-409" name="__codelineno-0-409"></a><span class="sd">        Example 6: Using Custom Column Names for Soft Delete</span>
+</span><span id="__span-0-410"><a id="__codelineno-0-410" name="__codelineno-0-410"></a><span class="sd">        ----------------------------------------------------</span>
+</span><span id="__span-0-411"><a id="__codelineno-0-411" name="__codelineno-0-411"></a>
+</span><span id="__span-0-412"><a id="__codelineno-0-412" name="__codelineno-0-412"></a><span class="sd">        If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the `FastCRUD` instance.</span>
+</span><span id="__span-0-413"><a id="__codelineno-0-413" name="__codelineno-0-413"></a>
+</span><span id="__span-0-414"><a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">        ```python</span>
 </span><span id="__span-0-415"><a id="__codelineno-0-415" name="__codelineno-0-415"></a><span class="sd">        --8&lt;--</span>
-</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">        fastcrud/examples/user/model.py:model_archived</span>
+</span><span id="__span-0-416"><a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">        fastcrud/examples/user/model.py:model_common</span>
 </span><span id="__span-0-417"><a id="__codelineno-0-417" name="__codelineno-0-417"></a><span class="sd">        --8&lt;--</span>
-</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a>
-</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a>
-</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a><span class="sd">        custom_user_crud = FastCRUD(</span>
-</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a><span class="sd">            User,</span>
-</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a><span class="sd">            is_deleted_column=&quot;archived&quot;,</span>
-</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a><span class="sd">            deleted_at_column=&quot;archived_at&quot;,</span>
-</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a><span class="sd">        )</span>
-</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a><span class="sd">        # Now &#39;archived&#39; and &#39;archived_at&#39; will be used for soft delete operations.</span>
-</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a><span class="sd">        ```</span>
-</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a>
-</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a>    <span class="n">_SUPPORTED_FILTERS</span> <span class="o">=</span> <span class="p">{</span>
-</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a>        <span class="s2">&quot;gt&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__gt__</span><span class="p">,</span>
-</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a>        <span class="s2">&quot;lt&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__lt__</span><span class="p">,</span>
-</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a>        <span class="s2">&quot;gte&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__ge__</span><span class="p">,</span>
-</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a>        <span class="s2">&quot;lte&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__le__</span><span class="p">,</span>
-</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a>        <span class="s2">&quot;ne&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__ne__</span><span class="p">,</span>
-</span><span id="__span-0-435"><a id="__codelineno-0-435" name="__codelineno-0-435"></a>        <span class="s2">&quot;is&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">is_</span><span class="p">,</span>
-</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a>        <span class="s2">&quot;is_not&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">is_not</span><span class="p">,</span>
-</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a>        <span class="s2">&quot;like&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">like</span><span class="p">,</span>
-</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a>        <span class="s2">&quot;notlike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">notlike</span><span class="p">,</span>
-</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a>        <span class="s2">&quot;ilike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">ilike</span><span class="p">,</span>
-</span><span id="__span-0-440"><a id="__codelineno-0-440" name="__codelineno-0-440"></a>        <span class="s2">&quot;notilike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">notilike</span><span class="p">,</span>
-</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a>        <span class="s2">&quot;startswith&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">startswith</span><span class="p">,</span>
-</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a>        <span class="s2">&quot;endswith&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">endswith</span><span class="p">,</span>
-</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a>        <span class="s2">&quot;contains&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">contains</span><span class="p">,</span>
-</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a>        <span class="s2">&quot;match&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">match</span><span class="p">,</span>
-</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>        <span class="s2">&quot;between&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">between</span><span class="p">,</span>
-</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a>        <span class="s2">&quot;in&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">in_</span><span class="p">,</span>
-</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a>        <span class="s2">&quot;not_in&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">not_in</span><span class="p">,</span>
-</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a>    <span class="p">}</span>
-</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a>
-</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a>    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
-</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a>        <span class="n">model</span><span class="p">:</span> <span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">],</span>
-</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a>        <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
-</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a>        <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a>        <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
-</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">model</span>
-</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span> <span class="o">=</span> <span class="p">[</span><span class="n">col</span><span class="o">.</span><span class="n">key</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span><span class="p">]</span>
-</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="o">=</span> <span class="n">is_deleted_column</span>
-</span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="o">=</span> <span class="n">deleted_at_column</span>
-</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span> <span class="o">=</span> <span class="n">updated_at_column</span>
-</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span> <span class="o">=</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a>
-</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a>    <span class="k">def</span> <span class="nf">_get_sqlalchemy_filter</span><span class="p">(</span>
-</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a>        <span class="n">operator</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
-</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a>        <span class="n">value</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Callable</span><span class="p">[[</span><span class="nb">str</span><span class="p">],</span> <span class="n">Callable</span><span class="p">]]:</span>
-</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a>        <span class="k">if</span> <span class="n">operator</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;in&quot;</span><span class="p">,</span> <span class="s2">&quot;not_in&quot;</span><span class="p">,</span> <span class="s2">&quot;between&quot;</span><span class="p">}:</span>
-</span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">,</span> <span class="nb">set</span><span class="p">)):</span>
-</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;&lt;</span><span class="si">{</span><span class="n">operator</span><span class="si">}</span><span class="s2">&gt; filter must be tuple, list or set&quot;</span><span class="p">)</span>
-</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_SUPPORTED_FILTERS</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">operator</span><span class="p">)</span>
-</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>
-</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a>    <span class="k">def</span> <span class="nf">_parse_filters</span><span class="p">(</span>
-</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a>        <span class="bp">self</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">],</span> <span class="n">AliasedClass</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">]:</span>
-</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a>        <span class="n">model</span> <span class="o">=</span> <span class="n">model</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span>
-</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a>
-</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a>        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a>            <span class="k">if</span> <span class="s2">&quot;__&quot;</span> <span class="ow">in</span> <span class="n">key</span><span class="p">:</span>
-</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a>                <span class="n">field_name</span><span class="p">,</span> <span class="n">op</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
-</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">field_name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a>                <span class="k">if</span> <span class="n">column</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid filter column: </span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a>                <span class="k">if</span> <span class="n">op</span> <span class="o">==</span> <span class="s2">&quot;or&quot;</span><span class="p">:</span>
-</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a>                    <span class="n">or_filters</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a>                        <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="n">or_value</span><span class="p">)</span>
-</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a>                        <span class="k">for</span> <span class="n">or_key</span><span class="p">,</span> <span class="n">or_value</span> <span class="ow">in</span> <span class="n">value</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
-</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a>                        <span class="k">if</span> <span class="p">(</span>
-</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a>                            <span class="n">sqlalchemy_filter</span> <span class="o">:=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_sqlalchemy_filter</span><span class="p">(</span>
-</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>                                <span class="n">or_key</span><span class="p">,</span> <span class="n">or_value</span>
-</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a>                            <span class="p">)</span>
-</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a>                        <span class="p">)</span>
-</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a>                        <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a>                    <span class="p">]</span>
-</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a>                    <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">or_</span><span class="p">(</span><span class="o">*</span><span class="n">or_filters</span><span class="p">))</span>
-</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a>                <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a>                    <span class="n">sqlalchemy_filter</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_sqlalchemy_filter</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
-</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a>                    <span class="k">if</span> <span class="n">sqlalchemy_filter</span><span class="p">:</span>
-</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a>                        <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a>                            <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="n">value</span><span class="p">)</span>
-</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a>                            <span class="k">if</span> <span class="n">op</span> <span class="o">!=</span> <span class="s2">&quot;between&quot;</span>
-</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a>                            <span class="k">else</span> <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="o">*</span><span class="n">value</span><span class="p">)</span>
-</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a>                        <span class="p">)</span>
-</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a>                <span class="k">if</span> <span class="n">column</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a>                    <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span> <span class="o">==</span> <span class="n">value</span><span class="p">)</span>
-</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a>
-</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a>        <span class="k">return</span> <span class="n">filters</span>
-</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>
-</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>    <span class="k">def</span> <span class="nf">_apply_sorting</span><span class="p">(</span>
-</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span><span class="p">,</span>
-</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]],</span>
-</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
-</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a><span class="sd">        Apply sorting to a SQLAlchemy query based on specified column names and sort orders.</span>
-</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>
-</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a><span class="sd">            stmt: The SQLAlchemy `Select` statement to which sorting will be applied.</span>
-</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a><span class="sd">            sort_columns: A single column name or a list of column names on which to apply sorting.</span>
-</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding</span>
-</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a><span class="sd">                to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
-</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a>
-</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a><span class="sd">            ValueError: Raised if sort orders are provided without corresponding sort columns,</span>
-</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a><span class="sd">                or if an invalid sort order is provided (not `&quot;asc&quot;` or `&quot;desc&quot;`).</span>
-</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a><span class="sd">            ArgumentError: Raised if an invalid column name is provided that does not exist in the model.</span>
-</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a>
-</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a><span class="sd">            The modified `Select` statement with sorting applied.</span>
-</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a>
-</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a><span class="sd">            Applying ascending sort on a single column:</span>
-</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, &#39;name&#39;)</span>
+</span><span id="__span-0-418"><a id="__codelineno-0-418" name="__codelineno-0-418"></a><span class="sd">            ...</span>
+</span><span id="__span-0-419"><a id="__codelineno-0-419" name="__codelineno-0-419"></a><span class="sd">        --8&lt;--</span>
+</span><span id="__span-0-420"><a id="__codelineno-0-420" name="__codelineno-0-420"></a><span class="sd">        fastcrud/examples/user/model.py:model_archived</span>
+</span><span id="__span-0-421"><a id="__codelineno-0-421" name="__codelineno-0-421"></a><span class="sd">        --8&lt;--</span>
+</span><span id="__span-0-422"><a id="__codelineno-0-422" name="__codelineno-0-422"></a>
+</span><span id="__span-0-423"><a id="__codelineno-0-423" name="__codelineno-0-423"></a>
+</span><span id="__span-0-424"><a id="__codelineno-0-424" name="__codelineno-0-424"></a><span class="sd">        custom_user_crud = FastCRUD(</span>
+</span><span id="__span-0-425"><a id="__codelineno-0-425" name="__codelineno-0-425"></a><span class="sd">            User,</span>
+</span><span id="__span-0-426"><a id="__codelineno-0-426" name="__codelineno-0-426"></a><span class="sd">            is_deleted_column=&quot;archived&quot;,</span>
+</span><span id="__span-0-427"><a id="__codelineno-0-427" name="__codelineno-0-427"></a><span class="sd">            deleted_at_column=&quot;archived_at&quot;,</span>
+</span><span id="__span-0-428"><a id="__codelineno-0-428" name="__codelineno-0-428"></a><span class="sd">        )</span>
+</span><span id="__span-0-429"><a id="__codelineno-0-429" name="__codelineno-0-429"></a><span class="sd">        # Now &#39;archived&#39; and &#39;archived_at&#39; will be used for soft delete operations.</span>
+</span><span id="__span-0-430"><a id="__codelineno-0-430" name="__codelineno-0-430"></a><span class="sd">        ```</span>
+</span><span id="__span-0-431"><a id="__codelineno-0-431" name="__codelineno-0-431"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-432"><a id="__codelineno-0-432" name="__codelineno-0-432"></a>
+</span><span id="__span-0-433"><a id="__codelineno-0-433" name="__codelineno-0-433"></a>    <span class="n">_SUPPORTED_FILTERS</span> <span class="o">=</span> <span class="p">{</span>
+</span><span id="__span-0-434"><a id="__codelineno-0-434" name="__codelineno-0-434"></a>        <span class="s2">&quot;gt&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__gt__</span><span class="p">,</span>
+</span><span id="__span-0-435"><a id="__codelineno-0-435" name="__codelineno-0-435"></a>        <span class="s2">&quot;lt&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__lt__</span><span class="p">,</span>
+</span><span id="__span-0-436"><a id="__codelineno-0-436" name="__codelineno-0-436"></a>        <span class="s2">&quot;gte&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__ge__</span><span class="p">,</span>
+</span><span id="__span-0-437"><a id="__codelineno-0-437" name="__codelineno-0-437"></a>        <span class="s2">&quot;lte&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__le__</span><span class="p">,</span>
+</span><span id="__span-0-438"><a id="__codelineno-0-438" name="__codelineno-0-438"></a>        <span class="s2">&quot;ne&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="fm">__ne__</span><span class="p">,</span>
+</span><span id="__span-0-439"><a id="__codelineno-0-439" name="__codelineno-0-439"></a>        <span class="s2">&quot;is&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">is_</span><span class="p">,</span>
+</span><span id="__span-0-440"><a id="__codelineno-0-440" name="__codelineno-0-440"></a>        <span class="s2">&quot;is_not&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">is_not</span><span class="p">,</span>
+</span><span id="__span-0-441"><a id="__codelineno-0-441" name="__codelineno-0-441"></a>        <span class="s2">&quot;like&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">like</span><span class="p">,</span>
+</span><span id="__span-0-442"><a id="__codelineno-0-442" name="__codelineno-0-442"></a>        <span class="s2">&quot;notlike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">notlike</span><span class="p">,</span>
+</span><span id="__span-0-443"><a id="__codelineno-0-443" name="__codelineno-0-443"></a>        <span class="s2">&quot;ilike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">ilike</span><span class="p">,</span>
+</span><span id="__span-0-444"><a id="__codelineno-0-444" name="__codelineno-0-444"></a>        <span class="s2">&quot;notilike&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">notilike</span><span class="p">,</span>
+</span><span id="__span-0-445"><a id="__codelineno-0-445" name="__codelineno-0-445"></a>        <span class="s2">&quot;startswith&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">startswith</span><span class="p">,</span>
+</span><span id="__span-0-446"><a id="__codelineno-0-446" name="__codelineno-0-446"></a>        <span class="s2">&quot;endswith&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">endswith</span><span class="p">,</span>
+</span><span id="__span-0-447"><a id="__codelineno-0-447" name="__codelineno-0-447"></a>        <span class="s2">&quot;contains&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">contains</span><span class="p">,</span>
+</span><span id="__span-0-448"><a id="__codelineno-0-448" name="__codelineno-0-448"></a>        <span class="s2">&quot;match&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">match</span><span class="p">,</span>
+</span><span id="__span-0-449"><a id="__codelineno-0-449" name="__codelineno-0-449"></a>        <span class="s2">&quot;between&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">between</span><span class="p">,</span>
+</span><span id="__span-0-450"><a id="__codelineno-0-450" name="__codelineno-0-450"></a>        <span class="s2">&quot;in&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">in_</span><span class="p">,</span>
+</span><span id="__span-0-451"><a id="__codelineno-0-451" name="__codelineno-0-451"></a>        <span class="s2">&quot;not_in&quot;</span><span class="p">:</span> <span class="k">lambda</span> <span class="n">column</span><span class="p">:</span> <span class="n">column</span><span class="o">.</span><span class="n">not_in</span><span class="p">,</span>
+</span><span id="__span-0-452"><a id="__codelineno-0-452" name="__codelineno-0-452"></a>    <span class="p">}</span>
+</span><span id="__span-0-453"><a id="__codelineno-0-453" name="__codelineno-0-453"></a>
+</span><span id="__span-0-454"><a id="__codelineno-0-454" name="__codelineno-0-454"></a>    <span class="k">def</span> <span class="fm">__init__</span><span class="p">(</span>
+</span><span id="__span-0-455"><a id="__codelineno-0-455" name="__codelineno-0-455"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-456"><a id="__codelineno-0-456" name="__codelineno-0-456"></a>        <span class="n">model</span><span class="p">:</span> <span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">],</span>
+</span><span id="__span-0-457"><a id="__codelineno-0-457" name="__codelineno-0-457"></a>        <span class="n">is_deleted_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;is_deleted&quot;</span><span class="p">,</span>
+</span><span id="__span-0-458"><a id="__codelineno-0-458" name="__codelineno-0-458"></a>        <span class="n">deleted_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;deleted_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-459"><a id="__codelineno-0-459" name="__codelineno-0-459"></a>        <span class="n">updated_at_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;updated_at&quot;</span><span class="p">,</span>
+</span><span id="__span-0-460"><a id="__codelineno-0-460" name="__codelineno-0-460"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-461"><a id="__codelineno-0-461" name="__codelineno-0-461"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model</span> <span class="o">=</span> <span class="n">model</span>
+</span><span id="__span-0-462"><a id="__codelineno-0-462" name="__codelineno-0-462"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span> <span class="o">=</span> <span class="p">[</span><span class="n">col</span><span class="o">.</span><span class="n">key</span> <span class="k">for</span> <span class="n">col</span> <span class="ow">in</span> <span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span><span class="p">]</span>
+</span><span id="__span-0-463"><a id="__codelineno-0-463" name="__codelineno-0-463"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="o">=</span> <span class="n">is_deleted_column</span>
+</span><span id="__span-0-464"><a id="__codelineno-0-464" name="__codelineno-0-464"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="o">=</span> <span class="n">deleted_at_column</span>
+</span><span id="__span-0-465"><a id="__codelineno-0-465" name="__codelineno-0-465"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span> <span class="o">=</span> <span class="n">updated_at_column</span>
+</span><span id="__span-0-466"><a id="__codelineno-0-466" name="__codelineno-0-466"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span> <span class="o">=</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-467"><a id="__codelineno-0-467" name="__codelineno-0-467"></a>
+</span><span id="__span-0-468"><a id="__codelineno-0-468" name="__codelineno-0-468"></a>    <span class="k">def</span> <span class="nf">_get_sqlalchemy_filter</span><span class="p">(</span>
+</span><span id="__span-0-469"><a id="__codelineno-0-469" name="__codelineno-0-469"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-470"><a id="__codelineno-0-470" name="__codelineno-0-470"></a>        <span class="n">operator</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>
+</span><span id="__span-0-471"><a id="__codelineno-0-471" name="__codelineno-0-471"></a>        <span class="n">value</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-472"><a id="__codelineno-0-472" name="__codelineno-0-472"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Callable</span><span class="p">[[</span><span class="nb">str</span><span class="p">],</span> <span class="n">Callable</span><span class="p">]]:</span>
+</span><span id="__span-0-473"><a id="__codelineno-0-473" name="__codelineno-0-473"></a>        <span class="k">if</span> <span class="n">operator</span> <span class="ow">in</span> <span class="p">{</span><span class="s2">&quot;in&quot;</span><span class="p">,</span> <span class="s2">&quot;not_in&quot;</span><span class="p">,</span> <span class="s2">&quot;between&quot;</span><span class="p">}:</span>
+</span><span id="__span-0-474"><a id="__codelineno-0-474" name="__codelineno-0-474"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">value</span><span class="p">,</span> <span class="p">(</span><span class="nb">tuple</span><span class="p">,</span> <span class="nb">list</span><span class="p">,</span> <span class="nb">set</span><span class="p">)):</span>
+</span><span id="__span-0-475"><a id="__codelineno-0-475" name="__codelineno-0-475"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;&lt;</span><span class="si">{</span><span class="n">operator</span><span class="si">}</span><span class="s2">&gt; filter must be tuple, list or set&quot;</span><span class="p">)</span>
+</span><span id="__span-0-476"><a id="__codelineno-0-476" name="__codelineno-0-476"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_SUPPORTED_FILTERS</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">operator</span><span class="p">)</span>
+</span><span id="__span-0-477"><a id="__codelineno-0-477" name="__codelineno-0-477"></a>
+</span><span id="__span-0-478"><a id="__codelineno-0-478" name="__codelineno-0-478"></a>    <span class="k">def</span> <span class="nf">_parse_filters</span><span class="p">(</span>
+</span><span id="__span-0-479"><a id="__codelineno-0-479" name="__codelineno-0-479"></a>        <span class="bp">self</span><span class="p">,</span> <span class="n">model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">],</span> <span class="n">AliasedClass</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="__span-0-480"><a id="__codelineno-0-480" name="__codelineno-0-480"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">]:</span>
+</span><span id="__span-0-481"><a id="__codelineno-0-481" name="__codelineno-0-481"></a>        <span class="n">model</span> <span class="o">=</span> <span class="n">model</span> <span class="ow">or</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span>
+</span><span id="__span-0-482"><a id="__codelineno-0-482" name="__codelineno-0-482"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-483"><a id="__codelineno-0-483" name="__codelineno-0-483"></a>
+</span><span id="__span-0-484"><a id="__codelineno-0-484" name="__codelineno-0-484"></a>        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value</span> <span class="ow">in</span> <span class="n">kwargs</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+</span><span id="__span-0-485"><a id="__codelineno-0-485" name="__codelineno-0-485"></a>            <span class="k">if</span> <span class="s2">&quot;__&quot;</span> <span class="ow">in</span> <span class="n">key</span><span class="p">:</span>
+</span><span id="__span-0-486"><a id="__codelineno-0-486" name="__codelineno-0-486"></a>                <span class="n">field_name</span><span class="p">,</span> <span class="n">op</span> <span class="o">=</span> <span class="n">key</span><span class="o">.</span><span class="n">rsplit</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+</span><span id="__span-0-487"><a id="__codelineno-0-487" name="__codelineno-0-487"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">field_name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-488"><a id="__codelineno-0-488" name="__codelineno-0-488"></a>                <span class="k">if</span> <span class="n">column</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-489"><a id="__codelineno-0-489" name="__codelineno-0-489"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid filter column: </span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-490"><a id="__codelineno-0-490" name="__codelineno-0-490"></a>                <span class="k">if</span> <span class="n">op</span> <span class="o">==</span> <span class="s2">&quot;or&quot;</span><span class="p">:</span>
+</span><span id="__span-0-491"><a id="__codelineno-0-491" name="__codelineno-0-491"></a>                    <span class="n">or_filters</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-492"><a id="__codelineno-0-492" name="__codelineno-0-492"></a>                        <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="n">or_value</span><span class="p">)</span>
+</span><span id="__span-0-493"><a id="__codelineno-0-493" name="__codelineno-0-493"></a>                        <span class="k">for</span> <span class="n">or_key</span><span class="p">,</span> <span class="n">or_value</span> <span class="ow">in</span> <span class="n">value</span><span class="o">.</span><span class="n">items</span><span class="p">()</span>
+</span><span id="__span-0-494"><a id="__codelineno-0-494" name="__codelineno-0-494"></a>                        <span class="k">if</span> <span class="p">(</span>
+</span><span id="__span-0-495"><a id="__codelineno-0-495" name="__codelineno-0-495"></a>                            <span class="n">sqlalchemy_filter</span> <span class="o">:=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_sqlalchemy_filter</span><span class="p">(</span>
+</span><span id="__span-0-496"><a id="__codelineno-0-496" name="__codelineno-0-496"></a>                                <span class="n">or_key</span><span class="p">,</span> <span class="n">or_value</span>
+</span><span id="__span-0-497"><a id="__codelineno-0-497" name="__codelineno-0-497"></a>                            <span class="p">)</span>
+</span><span id="__span-0-498"><a id="__codelineno-0-498" name="__codelineno-0-498"></a>                        <span class="p">)</span>
+</span><span id="__span-0-499"><a id="__codelineno-0-499" name="__codelineno-0-499"></a>                        <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-500"><a id="__codelineno-0-500" name="__codelineno-0-500"></a>                    <span class="p">]</span>
+</span><span id="__span-0-501"><a id="__codelineno-0-501" name="__codelineno-0-501"></a>                    <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">or_</span><span class="p">(</span><span class="o">*</span><span class="n">or_filters</span><span class="p">))</span>
+</span><span id="__span-0-502"><a id="__codelineno-0-502" name="__codelineno-0-502"></a>                <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-503"><a id="__codelineno-0-503" name="__codelineno-0-503"></a>                    <span class="n">sqlalchemy_filter</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_sqlalchemy_filter</span><span class="p">(</span><span class="n">op</span><span class="p">,</span> <span class="n">value</span><span class="p">)</span>
+</span><span id="__span-0-504"><a id="__codelineno-0-504" name="__codelineno-0-504"></a>                    <span class="k">if</span> <span class="n">sqlalchemy_filter</span><span class="p">:</span>
+</span><span id="__span-0-505"><a id="__codelineno-0-505" name="__codelineno-0-505"></a>                        <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="__span-0-506"><a id="__codelineno-0-506" name="__codelineno-0-506"></a>                            <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="n">value</span><span class="p">)</span>
+</span><span id="__span-0-507"><a id="__codelineno-0-507" name="__codelineno-0-507"></a>                            <span class="k">if</span> <span class="n">op</span> <span class="o">!=</span> <span class="s2">&quot;between&quot;</span>
+</span><span id="__span-0-508"><a id="__codelineno-0-508" name="__codelineno-0-508"></a>                            <span class="k">else</span> <span class="n">sqlalchemy_filter</span><span class="p">(</span><span class="n">column</span><span class="p">)(</span><span class="o">*</span><span class="n">value</span><span class="p">)</span>
+</span><span id="__span-0-509"><a id="__codelineno-0-509" name="__codelineno-0-509"></a>                        <span class="p">)</span>
+</span><span id="__span-0-510"><a id="__codelineno-0-510" name="__codelineno-0-510"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-511"><a id="__codelineno-0-511" name="__codelineno-0-511"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">key</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-512"><a id="__codelineno-0-512" name="__codelineno-0-512"></a>                <span class="k">if</span> <span class="n">column</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-513"><a id="__codelineno-0-513" name="__codelineno-0-513"></a>                    <span class="n">filters</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">column</span> <span class="o">==</span> <span class="n">value</span><span class="p">)</span>
+</span><span id="__span-0-514"><a id="__codelineno-0-514" name="__codelineno-0-514"></a>
+</span><span id="__span-0-515"><a id="__codelineno-0-515" name="__codelineno-0-515"></a>        <span class="k">return</span> <span class="n">filters</span>
+</span><span id="__span-0-516"><a id="__codelineno-0-516" name="__codelineno-0-516"></a>
+</span><span id="__span-0-517"><a id="__codelineno-0-517" name="__codelineno-0-517"></a>    <span class="k">def</span> <span class="nf">_apply_sorting</span><span class="p">(</span>
+</span><span id="__span-0-518"><a id="__codelineno-0-518" name="__codelineno-0-518"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-519"><a id="__codelineno-0-519" name="__codelineno-0-519"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span><span class="p">,</span>
+</span><span id="__span-0-520"><a id="__codelineno-0-520" name="__codelineno-0-520"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]],</span>
+</span><span id="__span-0-521"><a id="__codelineno-0-521" name="__codelineno-0-521"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-522"><a id="__codelineno-0-522" name="__codelineno-0-522"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
+</span><span id="__span-0-523"><a id="__codelineno-0-523" name="__codelineno-0-523"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-524"><a id="__codelineno-0-524" name="__codelineno-0-524"></a><span class="sd">        Apply sorting to a SQLAlchemy query based on specified column names and sort orders.</span>
+</span><span id="__span-0-525"><a id="__codelineno-0-525" name="__codelineno-0-525"></a>
+</span><span id="__span-0-526"><a id="__codelineno-0-526" name="__codelineno-0-526"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-527"><a id="__codelineno-0-527" name="__codelineno-0-527"></a><span class="sd">            stmt: The SQLAlchemy `Select` statement to which sorting will be applied.</span>
+</span><span id="__span-0-528"><a id="__codelineno-0-528" name="__codelineno-0-528"></a><span class="sd">            sort_columns: A single column name or a list of column names on which to apply sorting.</span>
+</span><span id="__span-0-529"><a id="__codelineno-0-529" name="__codelineno-0-529"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding</span>
+</span><span id="__span-0-530"><a id="__codelineno-0-530" name="__codelineno-0-530"></a><span class="sd">                to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
+</span><span id="__span-0-531"><a id="__codelineno-0-531" name="__codelineno-0-531"></a>
+</span><span id="__span-0-532"><a id="__codelineno-0-532" name="__codelineno-0-532"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-533"><a id="__codelineno-0-533" name="__codelineno-0-533"></a><span class="sd">            ValueError: Raised if sort orders are provided without corresponding sort columns,</span>
+</span><span id="__span-0-534"><a id="__codelineno-0-534" name="__codelineno-0-534"></a><span class="sd">                or if an invalid sort order is provided (not `&quot;asc&quot;` or `&quot;desc&quot;`).</span>
+</span><span id="__span-0-535"><a id="__codelineno-0-535" name="__codelineno-0-535"></a><span class="sd">            ArgumentError: Raised if an invalid column name is provided that does not exist in the model.</span>
+</span><span id="__span-0-536"><a id="__codelineno-0-536" name="__codelineno-0-536"></a>
+</span><span id="__span-0-537"><a id="__codelineno-0-537" name="__codelineno-0-537"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-538"><a id="__codelineno-0-538" name="__codelineno-0-538"></a><span class="sd">            The modified `Select` statement with sorting applied.</span>
 </span><span id="__span-0-539"><a id="__codelineno-0-539" name="__codelineno-0-539"></a>
-</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a><span class="sd">            Applying descending sort on a single column:</span>
-</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, &#39;age&#39;, &#39;desc&#39;)</span>
-</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a>
-</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a><span class="sd">            Applying mixed sort orders on multiple columns:</span>
-</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, [&#39;name&#39;, &#39;age&#39;], [&#39;asc&#39;, &#39;desc&#39;])</span>
-</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a>
-</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a><span class="sd">            Applying ascending sort on multiple columns:</span>
-</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, [&#39;name&#39;, &#39;age&#39;])</span>
-</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a>
-</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a><span class="sd">        Note:</span>
-</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a><span class="sd">            This method modifies the passed `Select` statement in-place by applying the `order_by` clause</span>
-</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a><span class="sd">            based on the provided column names and sort orders.</span>
-</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a>        <span class="k">if</span> <span class="n">sort_orders</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Sort orders provided without corresponding sort columns.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a>
-</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a>                <span class="n">sort_columns</span> <span class="o">=</span> <span class="p">[</span><span class="n">sort_columns</span><span class="p">]</span>
+</span><span id="__span-0-540"><a id="__codelineno-0-540" name="__codelineno-0-540"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-541"><a id="__codelineno-0-541" name="__codelineno-0-541"></a><span class="sd">            Applying ascending sort on a single column:</span>
+</span><span id="__span-0-542"><a id="__codelineno-0-542" name="__codelineno-0-542"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, &#39;name&#39;)</span>
+</span><span id="__span-0-543"><a id="__codelineno-0-543" name="__codelineno-0-543"></a>
+</span><span id="__span-0-544"><a id="__codelineno-0-544" name="__codelineno-0-544"></a><span class="sd">            Applying descending sort on a single column:</span>
+</span><span id="__span-0-545"><a id="__codelineno-0-545" name="__codelineno-0-545"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, &#39;age&#39;, &#39;desc&#39;)</span>
+</span><span id="__span-0-546"><a id="__codelineno-0-546" name="__codelineno-0-546"></a>
+</span><span id="__span-0-547"><a id="__codelineno-0-547" name="__codelineno-0-547"></a><span class="sd">            Applying mixed sort orders on multiple columns:</span>
+</span><span id="__span-0-548"><a id="__codelineno-0-548" name="__codelineno-0-548"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, [&#39;name&#39;, &#39;age&#39;], [&#39;asc&#39;, &#39;desc&#39;])</span>
+</span><span id="__span-0-549"><a id="__codelineno-0-549" name="__codelineno-0-549"></a>
+</span><span id="__span-0-550"><a id="__codelineno-0-550" name="__codelineno-0-550"></a><span class="sd">            Applying ascending sort on multiple columns:</span>
+</span><span id="__span-0-551"><a id="__codelineno-0-551" name="__codelineno-0-551"></a><span class="sd">            &gt;&gt;&gt; stmt = _apply_sorting(stmt, [&#39;name&#39;, &#39;age&#39;])</span>
+</span><span id="__span-0-552"><a id="__codelineno-0-552" name="__codelineno-0-552"></a>
+</span><span id="__span-0-553"><a id="__codelineno-0-553" name="__codelineno-0-553"></a><span class="sd">        Note:</span>
+</span><span id="__span-0-554"><a id="__codelineno-0-554" name="__codelineno-0-554"></a><span class="sd">            This method modifies the passed `Select` statement in-place by applying the `order_by` clause</span>
+</span><span id="__span-0-555"><a id="__codelineno-0-555" name="__codelineno-0-555"></a><span class="sd">            based on the provided column names and sort orders.</span>
+</span><span id="__span-0-556"><a id="__codelineno-0-556" name="__codelineno-0-556"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-557"><a id="__codelineno-0-557" name="__codelineno-0-557"></a>        <span class="k">if</span> <span class="n">sort_orders</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-558"><a id="__codelineno-0-558" name="__codelineno-0-558"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Sort orders provided without corresponding sort columns.&quot;</span><span class="p">)</span>
 </span><span id="__span-0-559"><a id="__codelineno-0-559" name="__codelineno-0-559"></a>
-</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a>            <span class="k">if</span> <span class="n">sort_orders</span><span class="p">:</span>
-</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
-</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a>                    <span class="n">sort_orders</span> <span class="o">=</span> <span class="p">[</span><span class="n">sort_orders</span><span class="p">]</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span>
-</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a>                <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">):</span>
-</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a>                        <span class="s2">&quot;The length of sort_columns and sort_orders must match.&quot;</span>
-</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a>                    <span class="p">)</span>
-</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>
-</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a>                <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">order</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">):</span>
-</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a>                    <span class="k">if</span> <span class="n">order</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;asc&quot;</span><span class="p">,</span> <span class="s2">&quot;desc&quot;</span><span class="p">]:</span>
-</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a>                        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a>                            <span class="sa">f</span><span class="s2">&quot;Invalid sort order: </span><span class="si">{</span><span class="n">order</span><span class="si">}</span><span class="s2">. Only &#39;asc&#39; or &#39;desc&#39; are allowed.&quot;</span>
-</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a>                        <span class="p">)</span>
-</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>
-</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>            <span class="n">validated_sort_orders</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>                <span class="p">[</span><span class="s2">&quot;asc&quot;</span><span class="p">]</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">sort_orders</span> <span class="k">else</span> <span class="n">sort_orders</span>
-</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>            <span class="p">)</span>
+</span><span id="__span-0-560"><a id="__codelineno-0-560" name="__codelineno-0-560"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-561"><a id="__codelineno-0-561" name="__codelineno-0-561"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+</span><span id="__span-0-562"><a id="__codelineno-0-562" name="__codelineno-0-562"></a>                <span class="n">sort_columns</span> <span class="o">=</span> <span class="p">[</span><span class="n">sort_columns</span><span class="p">]</span>
+</span><span id="__span-0-563"><a id="__codelineno-0-563" name="__codelineno-0-563"></a>
+</span><span id="__span-0-564"><a id="__codelineno-0-564" name="__codelineno-0-564"></a>            <span class="k">if</span> <span class="n">sort_orders</span><span class="p">:</span>
+</span><span id="__span-0-565"><a id="__codelineno-0-565" name="__codelineno-0-565"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">,</span> <span class="nb">list</span><span class="p">):</span>
+</span><span id="__span-0-566"><a id="__codelineno-0-566" name="__codelineno-0-566"></a>                    <span class="n">sort_orders</span> <span class="o">=</span> <span class="p">[</span><span class="n">sort_orders</span><span class="p">]</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span>
+</span><span id="__span-0-567"><a id="__codelineno-0-567" name="__codelineno-0-567"></a>                <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span> <span class="o">!=</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">):</span>
+</span><span id="__span-0-568"><a id="__codelineno-0-568" name="__codelineno-0-568"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-569"><a id="__codelineno-0-569" name="__codelineno-0-569"></a>                        <span class="s2">&quot;The length of sort_columns and sort_orders must match.&quot;</span>
+</span><span id="__span-0-570"><a id="__codelineno-0-570" name="__codelineno-0-570"></a>                    <span class="p">)</span>
+</span><span id="__span-0-571"><a id="__codelineno-0-571" name="__codelineno-0-571"></a>
+</span><span id="__span-0-572"><a id="__codelineno-0-572" name="__codelineno-0-572"></a>                <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">order</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sort_orders</span><span class="p">):</span>
+</span><span id="__span-0-573"><a id="__codelineno-0-573" name="__codelineno-0-573"></a>                    <span class="k">if</span> <span class="n">order</span> <span class="ow">not</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;asc&quot;</span><span class="p">,</span> <span class="s2">&quot;desc&quot;</span><span class="p">]:</span>
+</span><span id="__span-0-574"><a id="__codelineno-0-574" name="__codelineno-0-574"></a>                        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-575"><a id="__codelineno-0-575" name="__codelineno-0-575"></a>                            <span class="sa">f</span><span class="s2">&quot;Invalid sort order: </span><span class="si">{</span><span class="n">order</span><span class="si">}</span><span class="s2">. Only &#39;asc&#39; or &#39;desc&#39; are allowed.&quot;</span>
+</span><span id="__span-0-576"><a id="__codelineno-0-576" name="__codelineno-0-576"></a>                        <span class="p">)</span>
 </span><span id="__span-0-577"><a id="__codelineno-0-577" name="__codelineno-0-577"></a>
-</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>            <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">column_name</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">):</span>
-</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">column_name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="p">:</span>
-</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>                    <span class="k">raise</span> <span class="n">ArgumentError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid column name: </span><span class="si">{</span><span class="n">column_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>
-</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>                <span class="n">order</span> <span class="o">=</span> <span class="n">validated_sort_orders</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
-</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span><span class="n">asc</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> <span class="k">if</span> <span class="n">order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span> <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="n">column</span><span class="p">))</span>
-</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>
-</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>        <span class="k">return</span> <span class="n">stmt</span>
-</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>
-</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>    <span class="k">def</span> <span class="nf">_prepare_and_apply_joins</span><span class="p">(</span>
-</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span><span class="p">,</span>
-</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">],</span>
-</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>        <span class="n">use_temporary_prefix</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>    <span class="p">):</span>
-</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a><span class="sd">        Applies joins to the given SQL statement based on a list of `JoinConfig` objects.</span>
-</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>
-</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a><span class="sd">            stmt: The initial SQL statement.</span>
-</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a><span class="sd">            joins_config: Configurations for all joins.</span>
-</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a><span class="sd">            use_temporary_prefix: Whether to use or not an additional prefix for joins. Default `False`.</span>
-</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a>
-</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a><span class="sd">            The modified SQL statement with joins applied.</span>
-</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>        <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
-</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a>            <span class="n">model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
-</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a>            <span class="n">join_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a>                <span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>                <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>                <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="p">,</span>
-</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>                <span class="n">join</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span>
-</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>                <span class="n">use_temporary_prefix</span><span class="p">,</span>
-</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>            <span class="p">)</span>
-</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>            <span class="n">joined_model_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span>
-</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>                <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span> <span class="ow">or</span> <span class="p">{})</span>
-</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>            <span class="p">)</span>
-</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>
-</span><span id="__span-0-618"><a id="__codelineno-0-618" name="__codelineno-0-618"></a>            <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;left&quot;</span><span class="p">:</span>
-</span><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span><span class="o">.</span><span class="n">add_columns</span><span class="p">(</span><span class="o">*</span><span class="n">join_select</span><span class="p">)</span>
-</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>            <span class="k">elif</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
-</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span><span class="o">.</span><span class="n">add_columns</span><span class="p">(</span><span class="o">*</span><span class="n">join_select</span><span class="p">)</span>
-</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>            <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Unsupported join type: </span><span class="si">{</span><span class="n">join</span><span class="o">.</span><span class="n">join_type</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>            <span class="k">if</span> <span class="n">joined_model_filters</span><span class="p">:</span>
-</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">joined_model_filters</span><span class="p">)</span>
-</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>
-</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>        <span class="k">return</span> <span class="n">stmt</span>
-</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>
-</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">create</span><span class="p">(</span>
-</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>        <span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="nb">object</span><span class="p">:</span> <span class="n">CreateSchemaType</span><span class="p">,</span> <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ModelType</span><span class="p">:</span>
-</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a><span class="sd">        Create a new record in the database.</span>
-</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>
-</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="sd">            db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">            object: The Pydantic schema containing the data to be saved.</span>
-</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a>
-</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">            The created database object.</span>
-</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>        <span class="n">object_dict</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">()</span>
-</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>        <span class="n">db_object</span><span class="p">:</span> <span class="n">ModelType</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">object_dict</span><span class="p">)</span>
-</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a>        <span class="n">db</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">db_object</span><span class="p">)</span>
-</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>        <span class="k">return</span> <span class="n">db_object</span>
-</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a>
-</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">select</span><span class="p">(</span>
-</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
-</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a><span class="sd">        Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.</span>
-</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>
-</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a><span class="sd">        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
-</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>
-</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-578"><a id="__codelineno-0-578" name="__codelineno-0-578"></a>            <span class="n">validated_sort_orders</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="__span-0-579"><a id="__codelineno-0-579" name="__codelineno-0-579"></a>                <span class="p">[</span><span class="s2">&quot;asc&quot;</span><span class="p">]</span> <span class="o">*</span> <span class="nb">len</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">)</span> <span class="k">if</span> <span class="ow">not</span> <span class="n">sort_orders</span> <span class="k">else</span> <span class="n">sort_orders</span>
+</span><span id="__span-0-580"><a id="__codelineno-0-580" name="__codelineno-0-580"></a>            <span class="p">)</span>
+</span><span id="__span-0-581"><a id="__codelineno-0-581" name="__codelineno-0-581"></a>
+</span><span id="__span-0-582"><a id="__codelineno-0-582" name="__codelineno-0-582"></a>            <span class="k">for</span> <span class="n">idx</span><span class="p">,</span> <span class="n">column_name</span> <span class="ow">in</span> <span class="nb">enumerate</span><span class="p">(</span><span class="n">sort_columns</span><span class="p">):</span>
+</span><span id="__span-0-583"><a id="__codelineno-0-583" name="__codelineno-0-583"></a>                <span class="n">column</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">column_name</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-584"><a id="__codelineno-0-584" name="__codelineno-0-584"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="p">:</span>
+</span><span id="__span-0-585"><a id="__codelineno-0-585" name="__codelineno-0-585"></a>                    <span class="k">raise</span> <span class="n">ArgumentError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Invalid column name: </span><span class="si">{</span><span class="n">column_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-586"><a id="__codelineno-0-586" name="__codelineno-0-586"></a>
+</span><span id="__span-0-587"><a id="__codelineno-0-587" name="__codelineno-0-587"></a>                <span class="n">order</span> <span class="o">=</span> <span class="n">validated_sort_orders</span><span class="p">[</span><span class="n">idx</span><span class="p">]</span>
+</span><span id="__span-0-588"><a id="__codelineno-0-588" name="__codelineno-0-588"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span><span class="n">asc</span><span class="p">(</span><span class="n">column</span><span class="p">)</span> <span class="k">if</span> <span class="n">order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span> <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="n">column</span><span class="p">))</span>
+</span><span id="__span-0-589"><a id="__codelineno-0-589" name="__codelineno-0-589"></a>
+</span><span id="__span-0-590"><a id="__codelineno-0-590" name="__codelineno-0-590"></a>        <span class="k">return</span> <span class="n">stmt</span>
+</span><span id="__span-0-591"><a id="__codelineno-0-591" name="__codelineno-0-591"></a>
+</span><span id="__span-0-592"><a id="__codelineno-0-592" name="__codelineno-0-592"></a>    <span class="k">def</span> <span class="nf">_prepare_and_apply_joins</span><span class="p">(</span>
+</span><span id="__span-0-593"><a id="__codelineno-0-593" name="__codelineno-0-593"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-594"><a id="__codelineno-0-594" name="__codelineno-0-594"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span><span class="p">,</span>
+</span><span id="__span-0-595"><a id="__codelineno-0-595" name="__codelineno-0-595"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">],</span>
+</span><span id="__span-0-596"><a id="__codelineno-0-596" name="__codelineno-0-596"></a>        <span class="n">use_temporary_prefix</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-597"><a id="__codelineno-0-597" name="__codelineno-0-597"></a>    <span class="p">):</span>
+</span><span id="__span-0-598"><a id="__codelineno-0-598" name="__codelineno-0-598"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-599"><a id="__codelineno-0-599" name="__codelineno-0-599"></a><span class="sd">        Applies joins to the given SQL statement based on a list of `JoinConfig` objects.</span>
+</span><span id="__span-0-600"><a id="__codelineno-0-600" name="__codelineno-0-600"></a>
+</span><span id="__span-0-601"><a id="__codelineno-0-601" name="__codelineno-0-601"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-602"><a id="__codelineno-0-602" name="__codelineno-0-602"></a><span class="sd">            stmt: The initial SQL statement.</span>
+</span><span id="__span-0-603"><a id="__codelineno-0-603" name="__codelineno-0-603"></a><span class="sd">            joins_config: Configurations for all joins.</span>
+</span><span id="__span-0-604"><a id="__codelineno-0-604" name="__codelineno-0-604"></a><span class="sd">            use_temporary_prefix: Whether to use or not an additional prefix for joins. Default `False`.</span>
+</span><span id="__span-0-605"><a id="__codelineno-0-605" name="__codelineno-0-605"></a>
+</span><span id="__span-0-606"><a id="__codelineno-0-606" name="__codelineno-0-606"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-607"><a id="__codelineno-0-607" name="__codelineno-0-607"></a><span class="sd">            The modified SQL statement with joins applied.</span>
+</span><span id="__span-0-608"><a id="__codelineno-0-608" name="__codelineno-0-608"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-609"><a id="__codelineno-0-609" name="__codelineno-0-609"></a>        <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
+</span><span id="__span-0-610"><a id="__codelineno-0-610" name="__codelineno-0-610"></a>            <span class="n">model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
+</span><span id="__span-0-611"><a id="__codelineno-0-611" name="__codelineno-0-611"></a>            <span class="n">join_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-612"><a id="__codelineno-0-612" name="__codelineno-0-612"></a>                <span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-613"><a id="__codelineno-0-613" name="__codelineno-0-613"></a>                <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-614"><a id="__codelineno-0-614" name="__codelineno-0-614"></a>                <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="p">,</span>
+</span><span id="__span-0-615"><a id="__codelineno-0-615" name="__codelineno-0-615"></a>                <span class="n">join</span><span class="o">.</span><span class="n">alias</span><span class="p">,</span>
+</span><span id="__span-0-616"><a id="__codelineno-0-616" name="__codelineno-0-616"></a>                <span class="n">use_temporary_prefix</span><span class="p">,</span>
+</span><span id="__span-0-617"><a id="__codelineno-0-617" name="__codelineno-0-617"></a>            <span class="p">)</span>
+</span><span id="__span-0-618"><a id="__codelineno-0-618" name="__codelineno-0-618"></a>            <span class="n">joined_model_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span>
+</span><span id="__span-0-619"><a id="__codelineno-0-619" name="__codelineno-0-619"></a>                <span class="n">model</span><span class="o">=</span><span class="n">model</span><span class="p">,</span> <span class="o">**</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span> <span class="ow">or</span> <span class="p">{})</span>
+</span><span id="__span-0-620"><a id="__codelineno-0-620" name="__codelineno-0-620"></a>            <span class="p">)</span>
+</span><span id="__span-0-621"><a id="__codelineno-0-621" name="__codelineno-0-621"></a>
+</span><span id="__span-0-622"><a id="__codelineno-0-622" name="__codelineno-0-622"></a>            <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;left&quot;</span><span class="p">:</span>
+</span><span id="__span-0-623"><a id="__codelineno-0-623" name="__codelineno-0-623"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span><span class="o">.</span><span class="n">add_columns</span><span class="p">(</span><span class="o">*</span><span class="n">join_select</span><span class="p">)</span>
+</span><span id="__span-0-624"><a id="__codelineno-0-624" name="__codelineno-0-624"></a>            <span class="k">elif</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
+</span><span id="__span-0-625"><a id="__codelineno-0-625" name="__codelineno-0-625"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span><span class="o">.</span><span class="n">add_columns</span><span class="p">(</span><span class="o">*</span><span class="n">join_select</span><span class="p">)</span>
+</span><span id="__span-0-626"><a id="__codelineno-0-626" name="__codelineno-0-626"></a>            <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-627"><a id="__codelineno-0-627" name="__codelineno-0-627"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Unsupported join type: </span><span class="si">{</span><span class="n">join</span><span class="o">.</span><span class="n">join_type</span><span class="si">}</span><span class="s2">.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-628"><a id="__codelineno-0-628" name="__codelineno-0-628"></a>            <span class="k">if</span> <span class="n">joined_model_filters</span><span class="p">:</span>
+</span><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">joined_model_filters</span><span class="p">)</span>
+</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>
+</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a>        <span class="k">return</span> <span class="n">stmt</span>
+</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a>
+</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">create</span><span class="p">(</span>
+</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>        <span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="nb">object</span><span class="p">:</span> <span class="n">CreateSchemaType</span><span class="p">,</span> <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ModelType</span><span class="p">:</span>
+</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">        Create a new record in the database.</span>
+</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a>
+</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">            db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">            object: The Pydantic schema containing the data to be saved.</span>
+</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>
+</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a><span class="sd">            The created database object.</span>
+</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>        <span class="n">object_dict</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">()</span>
+</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>        <span class="n">db_object</span><span class="p">:</span> <span class="n">ModelType</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">object_dict</span><span class="p">)</span>
+</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a>        <span class="n">db</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">db_object</span><span class="p">)</span>
+</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>        <span class="k">return</span> <span class="n">db_object</span>
+</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a>
+</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">select</span><span class="p">(</span>
+</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
+</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a><span class="sd">        Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.</span>
 </span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>
-</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a><span class="sd">            schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</span>
-</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a><span class="sd">            sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.</span>
-</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.</span>
-</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
-</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>
-</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a><span class="sd">            An SQL Alchemy `Select` statement object that can be executed or further modified.</span>
-</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>
-</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a><span class="sd">            Selecting specific columns with filtering and sorting:</span>
-</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a>
-</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a><span class="sd">            stmt = await user_crud.select(</span>
-</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a><span class="sd">                sort_columns=[&#39;age&#39;, &#39;name&#39;],</span>
-</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a><span class="sd">                sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
-</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a><span class="sd">                age__gt=18,</span>
-</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a><span class="sd">            )</span>
-</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a><span class="sd">            ```</span>
-</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a>
-</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a><span class="sd">            Creating a statement to select all users without any filters:</span>
-</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a>
-</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a><span class="sd">            stmt = await user_crud.select()</span>
-</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a><span class="sd">            ```</span>
+</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a><span class="sd">        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
+</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>
+</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>
+</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a><span class="sd">            schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</span>
+</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a><span class="sd">            sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.</span>
+</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.</span>
+</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
+</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>
+</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a><span class="sd">            An SQL Alchemy `Select` statement object that can be executed or further modified.</span>
+</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a>
+</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a><span class="sd">            Selecting specific columns with filtering and sorting:</span>
+</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a>
+</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a><span class="sd">            stmt = await user_crud.select(</span>
+</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a><span class="sd">                sort_columns=[&#39;age&#39;, &#39;name&#39;],</span>
+</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a><span class="sd">                sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
+</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a><span class="sd">                age__gt=18,</span>
+</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a><span class="sd">            )</span>
+</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a><span class="sd">            ```</span>
+</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a>
+</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a><span class="sd">            Creating a statement to select all users without any filters:</span>
 </span><span id="__span-0-690"><a id="__codelineno-0-690" name="__codelineno-0-690"></a>
-</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a><span class="sd">            Selecting users with a specific `role`, ordered by `name`:</span>
-</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a>
-</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a><span class="sd">            stmt = await user_crud.select(</span>
-</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a><span class="sd">                schema_to_select=UserReadSchema,</span>
-</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a><span class="sd">                sort_columns=&#39;name&#39;,</span>
-</span><span id="__span-0-697"><a id="__codelineno-0-697" name="__codelineno-0-697"></a><span class="sd">                role=&#39;admin&#39;,</span>
-</span><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a><span class="sd">            )</span>
-</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a><span class="sd">            ```</span>
-</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a>
-</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a><span class="sd">        Note:</span>
-</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a><span class="sd">            This method does not execute the generated SQL statement.</span>
-</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a><span class="sd">            Use `db.execute(stmt)` to run the query and fetch results.</span>
-</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a>        <span class="n">to_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a>        <span class="p">)</span>
-</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a>
-</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
-</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a>        <span class="k">return</span> <span class="n">stmt</span>
+</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a><span class="sd">            stmt = await user_crud.select()</span>
+</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a><span class="sd">            ```</span>
+</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a>
+</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a><span class="sd">            Selecting users with a specific `role`, ordered by `name`:</span>
+</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a>
+</span><span id="__span-0-697"><a id="__codelineno-0-697" name="__codelineno-0-697"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a><span class="sd">            stmt = await user_crud.select(</span>
+</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a><span class="sd">                schema_to_select=UserReadSchema,</span>
+</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a><span class="sd">                sort_columns=&#39;name&#39;,</span>
+</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a><span class="sd">                role=&#39;admin&#39;,</span>
+</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a><span class="sd">            )</span>
+</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a><span class="sd">            ```</span>
+</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a>
+</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a><span class="sd">        Note:</span>
+</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a><span class="sd">            This method does not execute the generated SQL statement.</span>
+</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a><span class="sd">            Use `db.execute(stmt)` to run the query and fetch results.</span>
+</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a>        <span class="n">to_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a>        <span class="p">)</span>
+</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
 </span><span id="__span-0-714"><a id="__codelineno-0-714" name="__codelineno-0-714"></a>
-</span><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get</span><span class="p">(</span>
-</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-718"><a id="__codelineno-0-718" name="__codelineno-0-718"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]:</span>
-</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a><span class="sd">        Fetches a single record based on specified filters.</span>
-</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a>
-</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a><span class="sd">        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
-</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a>
-</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
+</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a>        <span class="k">return</span> <span class="n">stmt</span>
+</span><span id="__span-0-718"><a id="__codelineno-0-718" name="__codelineno-0-718"></a>
+</span><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get</span><span class="p">(</span>
+</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]:</span>
+</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">        Fetches a single record based on specified filters.</span>
 </span><span id="__span-0-729"><a id="__codelineno-0-729" name="__codelineno-0-729"></a>
-</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns.</span>
-</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">            one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.</span>
-</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">            **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</span>
-</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a>
-</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
-</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a>
-</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a><span class="sd">            A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.</span>
-</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a>
-</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a><span class="sd">            Fetch a user by ID:</span>
-</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a>
-</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a><span class="sd">            user = await user_crud.get(db, id=1)</span>
-</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a><span class="sd">            ```</span>
+</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
+</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a>
+</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a>
+</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns.</span>
+</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">            one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.</span>
+</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a><span class="sd">            **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</span>
+</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a>
+</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a><span class="sd">            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
+</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a>
+</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a><span class="sd">            A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.</span>
+</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a>
+</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a><span class="sd">            Fetch a user by ID:</span>
 </span><span id="__span-0-749"><a id="__codelineno-0-749" name="__codelineno-0-749"></a>
-</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a><span class="sd">            Fetch a user with an age greater than 30:</span>
-</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a>
-</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-753"><a id="__codelineno-0-753" name="__codelineno-0-753"></a><span class="sd">            user = await user_crud.get(db, age__gt=30)</span>
-</span><span id="__span-0-754"><a id="__codelineno-0-754" name="__codelineno-0-754"></a><span class="sd">            ```</span>
+</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a><span class="sd">            user = await user_crud.get(db, id=1)</span>
+</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a><span class="sd">            ```</span>
+</span><span id="__span-0-753"><a id="__codelineno-0-753" name="__codelineno-0-753"></a>
+</span><span id="__span-0-754"><a id="__codelineno-0-754" name="__codelineno-0-754"></a><span class="sd">            Fetch a user with an age greater than 30:</span>
 </span><span id="__span-0-755"><a id="__codelineno-0-755" name="__codelineno-0-755"></a>
-</span><span id="__span-0-756"><a id="__codelineno-0-756" name="__codelineno-0-756"></a><span class="sd">            Fetch a user with a registration date before Jan 1, 2020:</span>
-</span><span id="__span-0-757"><a id="__codelineno-0-757" name="__codelineno-0-757"></a>
-</span><span id="__span-0-758"><a id="__codelineno-0-758" name="__codelineno-0-758"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-759"><a id="__codelineno-0-759" name="__codelineno-0-759"></a><span class="sd">            user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))</span>
-</span><span id="__span-0-760"><a id="__codelineno-0-760" name="__codelineno-0-760"></a><span class="sd">            ```</span>
+</span><span id="__span-0-756"><a id="__codelineno-0-756" name="__codelineno-0-756"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-757"><a id="__codelineno-0-757" name="__codelineno-0-757"></a><span class="sd">            user = await user_crud.get(db, age__gt=30)</span>
+</span><span id="__span-0-758"><a id="__codelineno-0-758" name="__codelineno-0-758"></a><span class="sd">            ```</span>
+</span><span id="__span-0-759"><a id="__codelineno-0-759" name="__codelineno-0-759"></a>
+</span><span id="__span-0-760"><a id="__codelineno-0-760" name="__codelineno-0-760"></a><span class="sd">            Fetch a user with a registration date before Jan 1, 2020:</span>
 </span><span id="__span-0-761"><a id="__codelineno-0-761" name="__codelineno-0-761"></a>
-</span><span id="__span-0-762"><a id="__codelineno-0-762" name="__codelineno-0-762"></a><span class="sd">            Fetch a user not equal to a specific username:</span>
-</span><span id="__span-0-763"><a id="__codelineno-0-763" name="__codelineno-0-763"></a>
-</span><span id="__span-0-764"><a id="__codelineno-0-764" name="__codelineno-0-764"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-765"><a id="__codelineno-0-765" name="__codelineno-0-765"></a><span class="sd">            user = await user_crud.get(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-766"><a id="__codelineno-0-766" name="__codelineno-0-766"></a><span class="sd">            ```</span>
-</span><span id="__span-0-767"><a id="__codelineno-0-767" name="__codelineno-0-767"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-768"><a id="__codelineno-0-768" name="__codelineno-0-768"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-769"><a id="__codelineno-0-769" name="__codelineno-0-769"></a>
-</span><span id="__span-0-770"><a id="__codelineno-0-770" name="__codelineno-0-770"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-771"><a id="__codelineno-0-771" name="__codelineno-0-771"></a>        <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-</span><span id="__span-0-772"><a id="__codelineno-0-772" name="__codelineno-0-772"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-773"><a id="__codelineno-0-773" name="__codelineno-0-773"></a>            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-774"><a id="__codelineno-0-774" name="__codelineno-0-774"></a>        <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
-</span><span id="__span-0-775"><a id="__codelineno-0-775" name="__codelineno-0-775"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-776"><a id="__codelineno-0-776" name="__codelineno-0-776"></a>            <span class="k">return</span> <span class="n">out</span>
-</span><span id="__span-0-777"><a id="__codelineno-0-777" name="__codelineno-0-777"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
-</span><span id="__span-0-778"><a id="__codelineno-0-778" name="__codelineno-0-778"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-779"><a id="__codelineno-0-779" name="__codelineno-0-779"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-780"><a id="__codelineno-0-780" name="__codelineno-0-780"></a>            <span class="p">)</span>
-</span><span id="__span-0-781"><a id="__codelineno-0-781" name="__codelineno-0-781"></a>        <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
-</span><span id="__span-0-782"><a id="__codelineno-0-782" name="__codelineno-0-782"></a>
-</span><span id="__span-0-783"><a id="__codelineno-0-783" name="__codelineno-0-783"></a>    <span class="k">def</span> <span class="nf">_get_pk_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance</span><span class="p">):</span>
-</span><span id="__span-0-784"><a id="__codelineno-0-784" name="__codelineno-0-784"></a>        <span class="k">return</span> <span class="p">{</span><span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">instance</span><span class="p">,</span> <span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">}</span>
-</span><span id="__span-0-785"><a id="__codelineno-0-785" name="__codelineno-0-785"></a>
-</span><span id="__span-0-786"><a id="__codelineno-0-786" name="__codelineno-0-786"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">upsert</span><span class="p">(</span>
-</span><span id="__span-0-787"><a id="__codelineno-0-787" name="__codelineno-0-787"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-788"><a id="__codelineno-0-788" name="__codelineno-0-788"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-789"><a id="__codelineno-0-789" name="__codelineno-0-789"></a>        <span class="n">instance</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-790"><a id="__codelineno-0-790" name="__codelineno-0-790"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-791"><a id="__codelineno-0-791" name="__codelineno-0-791"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-792"><a id="__codelineno-0-792" name="__codelineno-0-792"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">,</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="kc">None</span><span class="p">]:</span>
-</span><span id="__span-0-793"><a id="__codelineno-0-793" name="__codelineno-0-793"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the instance or create it if it doesn&#39;t exists.</span>
-</span><span id="__span-0-794"><a id="__codelineno-0-794" name="__codelineno-0-794"></a>
-</span><span id="__span-0-795"><a id="__codelineno-0-795" name="__codelineno-0-795"></a><span class="sd">        Note: This method will perform two transactions to the database (get and create or update).</span>
-</span><span id="__span-0-796"><a id="__codelineno-0-796" name="__codelineno-0-796"></a>
-</span><span id="__span-0-797"><a id="__codelineno-0-797" name="__codelineno-0-797"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-798"><a id="__codelineno-0-798" name="__codelineno-0-798"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-799"><a id="__codelineno-0-799" name="__codelineno-0-799"></a><span class="sd">            instance: A Pydantic schema representing the instance.</span>
-</span><span id="__span-0-800"><a id="__codelineno-0-800" name="__codelineno-0-800"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.</span>
-</span><span id="__span-0-801"><a id="__codelineno-0-801" name="__codelineno-0-801"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-802"><a id="__codelineno-0-802" name="__codelineno-0-802"></a>
-</span><span id="__span-0-803"><a id="__codelineno-0-803" name="__codelineno-0-803"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-804"><a id="__codelineno-0-804" name="__codelineno-0-804"></a><span class="sd">            The created or updated instance</span>
-</span><span id="__span-0-805"><a id="__codelineno-0-805" name="__codelineno-0-805"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-806"><a id="__codelineno-0-806" name="__codelineno-0-806"></a>        <span class="n">_pks</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pk_dict</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
-</span><span id="__span-0-807"><a id="__codelineno-0-807" name="__codelineno-0-807"></a>        <span class="n">schema_to_select</span> <span class="o">=</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="nb">type</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
-</span><span id="__span-0-808"><a id="__codelineno-0-808" name="__codelineno-0-808"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="__span-0-809"><a id="__codelineno-0-809" name="__codelineno-0-809"></a>            <span class="n">db</span><span class="p">,</span>
-</span><span id="__span-0-810"><a id="__codelineno-0-810" name="__codelineno-0-810"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-811"><a id="__codelineno-0-811" name="__codelineno-0-811"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-812"><a id="__codelineno-0-812" name="__codelineno-0-812"></a>            <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
-</span><span id="__span-0-813"><a id="__codelineno-0-813" name="__codelineno-0-813"></a>        <span class="p">)</span>
-</span><span id="__span-0-814"><a id="__codelineno-0-814" name="__codelineno-0-814"></a>        <span class="k">if</span> <span class="n">db_instance</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-815"><a id="__codelineno-0-815" name="__codelineno-0-815"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-816"><a id="__codelineno-0-816" name="__codelineno-0-816"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="o">.</span><span class="n">model_validate</span><span class="p">(</span>
-</span><span id="__span-0-817"><a id="__codelineno-0-817" name="__codelineno-0-817"></a>                <span class="n">db_instance</span><span class="p">,</span> <span class="n">from_attributes</span><span class="o">=</span><span class="kc">True</span>
-</span><span id="__span-0-818"><a id="__codelineno-0-818" name="__codelineno-0-818"></a>            <span class="p">)</span>
-</span><span id="__span-0-819"><a id="__codelineno-0-819" name="__codelineno-0-819"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-820"><a id="__codelineno-0-820" name="__codelineno-0-820"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-821"><a id="__codelineno-0-821" name="__codelineno-0-821"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="__span-0-822"><a id="__codelineno-0-822" name="__codelineno-0-822"></a>                <span class="n">db</span><span class="p">,</span>
-</span><span id="__span-0-823"><a id="__codelineno-0-823" name="__codelineno-0-823"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-824"><a id="__codelineno-0-824" name="__codelineno-0-824"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-825"><a id="__codelineno-0-825" name="__codelineno-0-825"></a>                <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
-</span><span id="__span-0-826"><a id="__codelineno-0-826" name="__codelineno-0-826"></a>            <span class="p">)</span>
-</span><span id="__span-0-827"><a id="__codelineno-0-827" name="__codelineno-0-827"></a>
-</span><span id="__span-0-828"><a id="__codelineno-0-828" name="__codelineno-0-828"></a>        <span class="k">return</span> <span class="n">db_instance</span>
-</span><span id="__span-0-829"><a id="__codelineno-0-829" name="__codelineno-0-829"></a>
-</span><span id="__span-0-830"><a id="__codelineno-0-830" name="__codelineno-0-830"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">upsert_multi</span><span class="p">(</span>
-</span><span id="__span-0-831"><a id="__codelineno-0-831" name="__codelineno-0-831"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-832"><a id="__codelineno-0-832" name="__codelineno-0-832"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-833"><a id="__codelineno-0-833" name="__codelineno-0-833"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
-</span><span id="__span-0-834"><a id="__codelineno-0-834" name="__codelineno-0-834"></a>        <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-835"><a id="__codelineno-0-835" name="__codelineno-0-835"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-836"><a id="__codelineno-0-836" name="__codelineno-0-836"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-837"><a id="__codelineno-0-837" name="__codelineno-0-837"></a>        <span class="n">update_override</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-838"><a id="__codelineno-0-838" name="__codelineno-0-838"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-839"><a id="__codelineno-0-839" name="__codelineno-0-839"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
-</span><span id="__span-0-840"><a id="__codelineno-0-840" name="__codelineno-0-840"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-841"><a id="__codelineno-0-841" name="__codelineno-0-841"></a><span class="sd">        Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</span>
-</span><span id="__span-0-842"><a id="__codelineno-0-842" name="__codelineno-0-842"></a>
-</span><span id="__span-0-843"><a id="__codelineno-0-843" name="__codelineno-0-843"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-844"><a id="__codelineno-0-844" name="__codelineno-0-844"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-845"><a id="__codelineno-0-845" name="__codelineno-0-845"></a><span class="sd">            instances: A list of Pydantic schemas representing the instances to upsert.</span>
-</span><span id="__span-0-846"><a id="__codelineno-0-846" name="__codelineno-0-846"></a><span class="sd">            return_columns: Optional list of column names to return after the upsert operation.</span>
-</span><span id="__span-0-847"><a id="__codelineno-0-847" name="__codelineno-0-847"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</span>
-</span><span id="__span-0-848"><a id="__codelineno-0-848" name="__codelineno-0-848"></a><span class="sd">            return_as_model: If True, returns data as instances of the specified Pydantic model.</span>
-</span><span id="__span-0-849"><a id="__codelineno-0-849" name="__codelineno-0-849"></a><span class="sd">            update_override: Optional dictionary to override the update values for the upsert operation.</span>
-</span><span id="__span-0-850"><a id="__codelineno-0-850" name="__codelineno-0-850"></a><span class="sd">            **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</span>
-</span><span id="__span-0-851"><a id="__codelineno-0-851" name="__codelineno-0-851"></a>
-</span><span id="__span-0-852"><a id="__codelineno-0-852" name="__codelineno-0-852"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-853"><a id="__codelineno-0-853" name="__codelineno-0-853"></a><span class="sd">            The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.</span>
-</span><span id="__span-0-854"><a id="__codelineno-0-854" name="__codelineno-0-854"></a>
-</span><span id="__span-0-855"><a id="__codelineno-0-855" name="__codelineno-0-855"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-856"><a id="__codelineno-0-856" name="__codelineno-0-856"></a><span class="sd">            ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</span>
-</span><span id="__span-0-857"><a id="__codelineno-0-857" name="__codelineno-0-857"></a><span class="sd">            NotImplementedError: If the database dialect is not supported for upsert multi.</span>
-</span><span id="__span-0-858"><a id="__codelineno-0-858" name="__codelineno-0-858"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-859"><a id="__codelineno-0-859" name="__codelineno-0-859"></a>        <span class="k">if</span> <span class="n">update_override</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-860"><a id="__codelineno-0-860" name="__codelineno-0-860"></a>            <span class="n">update_override</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-861"><a id="__codelineno-0-861" name="__codelineno-0-861"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-862"><a id="__codelineno-0-862" name="__codelineno-0-862"></a>
-</span><span id="__span-0-863"><a id="__codelineno-0-863" name="__codelineno-0-863"></a>        <span class="k">if</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;postgresql&quot;</span><span class="p">:</span>
-</span><span id="__span-0-864"><a id="__codelineno-0-864" name="__codelineno-0-864"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_postgresql</span><span class="p">(</span>
-</span><span id="__span-0-865"><a id="__codelineno-0-865" name="__codelineno-0-865"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-866"><a id="__codelineno-0-866" name="__codelineno-0-866"></a>            <span class="p">)</span>
-</span><span id="__span-0-867"><a id="__codelineno-0-867" name="__codelineno-0-867"></a>        <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;sqlite&quot;</span><span class="p">:</span>
-</span><span id="__span-0-868"><a id="__codelineno-0-868" name="__codelineno-0-868"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_sqlite</span><span class="p">(</span>
-</span><span id="__span-0-869"><a id="__codelineno-0-869" name="__codelineno-0-869"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-870"><a id="__codelineno-0-870" name="__codelineno-0-870"></a>            <span class="p">)</span>
-</span><span id="__span-0-871"><a id="__codelineno-0-871" name="__codelineno-0-871"></a>        <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;mysql&quot;</span><span class="p">,</span> <span class="s2">&quot;mariadb&quot;</span><span class="p">]:</span>
-</span><span id="__span-0-872"><a id="__codelineno-0-872" name="__codelineno-0-872"></a>            <span class="k">if</span> <span class="n">filters</span><span class="p">:</span>
-</span><span id="__span-0-873"><a id="__codelineno-0-873" name="__codelineno-0-873"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-874"><a id="__codelineno-0-874" name="__codelineno-0-874"></a>                    <span class="s2">&quot;MySQL does not support filtering on insert operations.&quot;</span>
-</span><span id="__span-0-875"><a id="__codelineno-0-875" name="__codelineno-0-875"></a>                <span class="p">)</span>
-</span><span id="__span-0-876"><a id="__codelineno-0-876" name="__codelineno-0-876"></a>            <span class="k">if</span> <span class="n">return_columns</span> <span class="ow">or</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-877"><a id="__codelineno-0-877" name="__codelineno-0-877"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-878"><a id="__codelineno-0-878" name="__codelineno-0-878"></a>                    <span class="s2">&quot;MySQL does not support the returning clause for insert operations.&quot;</span>
-</span><span id="__span-0-879"><a id="__codelineno-0-879" name="__codelineno-0-879"></a>                <span class="p">)</span>
-</span><span id="__span-0-880"><a id="__codelineno-0-880" name="__codelineno-0-880"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_mysql</span><span class="p">(</span>
-</span><span id="__span-0-881"><a id="__codelineno-0-881" name="__codelineno-0-881"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-882"><a id="__codelineno-0-882" name="__codelineno-0-882"></a>            <span class="p">)</span>
-</span><span id="__span-0-883"><a id="__codelineno-0-883" name="__codelineno-0-883"></a>        <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-884"><a id="__codelineno-0-884" name="__codelineno-0-884"></a>            <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
-</span><span id="__span-0-885"><a id="__codelineno-0-885" name="__codelineno-0-885"></a>                <span class="sa">f</span><span class="s2">&quot;Upsert multi is not implemented for </span><span class="si">{</span><span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-886"><a id="__codelineno-0-886" name="__codelineno-0-886"></a>            <span class="p">)</span>
-</span><span id="__span-0-887"><a id="__codelineno-0-887" name="__codelineno-0-887"></a>
-</span><span id="__span-0-888"><a id="__codelineno-0-888" name="__codelineno-0-888"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-889"><a id="__codelineno-0-889" name="__codelineno-0-889"></a>            <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
-</span><span id="__span-0-890"><a id="__codelineno-0-890" name="__codelineno-0-890"></a>
-</span><span id="__span-0-891"><a id="__codelineno-0-891" name="__codelineno-0-891"></a>        <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
-</span><span id="__span-0-892"><a id="__codelineno-0-892" name="__codelineno-0-892"></a>            <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
-</span><span id="__span-0-893"><a id="__codelineno-0-893" name="__codelineno-0-893"></a>            <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
-</span><span id="__span-0-894"><a id="__codelineno-0-894" name="__codelineno-0-894"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
-</span><span id="__span-0-895"><a id="__codelineno-0-895" name="__codelineno-0-895"></a>                <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-896"><a id="__codelineno-0-896" name="__codelineno-0-896"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-897"><a id="__codelineno-0-897" name="__codelineno-0-897"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-898"><a id="__codelineno-0-898" name="__codelineno-0-898"></a>            <span class="p">)</span>
-</span><span id="__span-0-899"><a id="__codelineno-0-899" name="__codelineno-0-899"></a>
-</span><span id="__span-0-900"><a id="__codelineno-0-900" name="__codelineno-0-900"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
-</span><span id="__span-0-901"><a id="__codelineno-0-901" name="__codelineno-0-901"></a>        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-902"><a id="__codelineno-0-902" name="__codelineno-0-902"></a>
-</span><span id="__span-0-903"><a id="__codelineno-0-903" name="__codelineno-0-903"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_postgresql</span><span class="p">(</span>
-</span><span id="__span-0-904"><a id="__codelineno-0-904" name="__codelineno-0-904"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-905"><a id="__codelineno-0-905" name="__codelineno-0-905"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
-</span><span id="__span-0-906"><a id="__codelineno-0-906" name="__codelineno-0-906"></a>        <span class="n">filters</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">],</span>
-</span><span id="__span-0-907"><a id="__codelineno-0-907" name="__codelineno-0-907"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
-</span><span id="__span-0-908"><a id="__codelineno-0-908" name="__codelineno-0-908"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
-</span><span id="__span-0-909"><a id="__codelineno-0-909" name="__codelineno-0-909"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">postgresql</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-910"><a id="__codelineno-0-910" name="__codelineno-0-910"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_conflict_do_update</span><span class="p">(</span>
-</span><span id="__span-0-911"><a id="__codelineno-0-911" name="__codelineno-0-911"></a>            <span class="n">index_elements</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">,</span>
-</span><span id="__span-0-912"><a id="__codelineno-0-912" name="__codelineno-0-912"></a>            <span class="n">set_</span><span class="o">=</span><span class="p">{</span>
-</span><span id="__span-0-913"><a id="__codelineno-0-913" name="__codelineno-0-913"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">excluded</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-</span><span id="__span-0-914"><a id="__codelineno-0-914" name="__codelineno-0-914"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
-</span><span id="__span-0-915"><a id="__codelineno-0-915" name="__codelineno-0-915"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
-</span><span id="__span-0-916"><a id="__codelineno-0-916" name="__codelineno-0-916"></a>            <span class="p">}</span>
-</span><span id="__span-0-917"><a id="__codelineno-0-917" name="__codelineno-0-917"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
-</span><span id="__span-0-918"><a id="__codelineno-0-918" name="__codelineno-0-918"></a>            <span class="n">where</span><span class="o">=</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span> <span class="k">if</span> <span class="n">filters</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-919"><a id="__codelineno-0-919" name="__codelineno-0-919"></a>        <span class="p">)</span>
-</span><span id="__span-0-920"><a id="__codelineno-0-920" name="__codelineno-0-920"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-921"><a id="__codelineno-0-921" name="__codelineno-0-921"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
-</span><span id="__span-0-922"><a id="__codelineno-0-922" name="__codelineno-0-922"></a>        <span class="p">]</span>
-</span><span id="__span-0-923"><a id="__codelineno-0-923" name="__codelineno-0-923"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
-</span><span id="__span-0-924"><a id="__codelineno-0-924" name="__codelineno-0-924"></a>
-</span><span id="__span-0-925"><a id="__codelineno-0-925" name="__codelineno-0-925"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_sqlite</span><span class="p">(</span>
-</span><span id="__span-0-926"><a id="__codelineno-0-926" name="__codelineno-0-926"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-927"><a id="__codelineno-0-927" name="__codelineno-0-927"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
-</span><span id="__span-0-928"><a id="__codelineno-0-928" name="__codelineno-0-928"></a>        <span class="n">filters</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">],</span>
-</span><span id="__span-0-929"><a id="__codelineno-0-929" name="__codelineno-0-929"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
-</span><span id="__span-0-930"><a id="__codelineno-0-930" name="__codelineno-0-930"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
-</span><span id="__span-0-931"><a id="__codelineno-0-931" name="__codelineno-0-931"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">sqlite</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-932"><a id="__codelineno-0-932" name="__codelineno-0-932"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_conflict_do_update</span><span class="p">(</span>
-</span><span id="__span-0-933"><a id="__codelineno-0-933" name="__codelineno-0-933"></a>            <span class="n">index_elements</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">,</span>
-</span><span id="__span-0-934"><a id="__codelineno-0-934" name="__codelineno-0-934"></a>            <span class="n">set_</span><span class="o">=</span><span class="p">{</span>
-</span><span id="__span-0-935"><a id="__codelineno-0-935" name="__codelineno-0-935"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">excluded</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-</span><span id="__span-0-936"><a id="__codelineno-0-936" name="__codelineno-0-936"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
-</span><span id="__span-0-937"><a id="__codelineno-0-937" name="__codelineno-0-937"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
-</span><span id="__span-0-938"><a id="__codelineno-0-938" name="__codelineno-0-938"></a>            <span class="p">}</span>
-</span><span id="__span-0-939"><a id="__codelineno-0-939" name="__codelineno-0-939"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
-</span><span id="__span-0-940"><a id="__codelineno-0-940" name="__codelineno-0-940"></a>            <span class="n">where</span><span class="o">=</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span> <span class="k">if</span> <span class="n">filters</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-941"><a id="__codelineno-0-941" name="__codelineno-0-941"></a>        <span class="p">)</span>
-</span><span id="__span-0-942"><a id="__codelineno-0-942" name="__codelineno-0-942"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-943"><a id="__codelineno-0-943" name="__codelineno-0-943"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
-</span><span id="__span-0-944"><a id="__codelineno-0-944" name="__codelineno-0-944"></a>        <span class="p">]</span>
-</span><span id="__span-0-945"><a id="__codelineno-0-945" name="__codelineno-0-945"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
-</span><span id="__span-0-946"><a id="__codelineno-0-946" name="__codelineno-0-946"></a>
-</span><span id="__span-0-947"><a id="__codelineno-0-947" name="__codelineno-0-947"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_mysql</span><span class="p">(</span>
-</span><span id="__span-0-948"><a id="__codelineno-0-948" name="__codelineno-0-948"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-949"><a id="__codelineno-0-949" name="__codelineno-0-949"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
-</span><span id="__span-0-950"><a id="__codelineno-0-950" name="__codelineno-0-950"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
-</span><span id="__span-0-951"><a id="__codelineno-0-951" name="__codelineno-0-951"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
-</span><span id="__span-0-952"><a id="__codelineno-0-952" name="__codelineno-0-952"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">mysql</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-953"><a id="__codelineno-0-953" name="__codelineno-0-953"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_duplicate_key_update</span><span class="p">(</span>
-</span><span id="__span-0-954"><a id="__codelineno-0-954" name="__codelineno-0-954"></a>            <span class="p">{</span>
-</span><span id="__span-0-955"><a id="__codelineno-0-955" name="__codelineno-0-955"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">inserted</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
-</span><span id="__span-0-956"><a id="__codelineno-0-956" name="__codelineno-0-956"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
-</span><span id="__span-0-957"><a id="__codelineno-0-957" name="__codelineno-0-957"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span>
-</span><span id="__span-0-958"><a id="__codelineno-0-958" name="__codelineno-0-958"></a>                <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
-</span><span id="__span-0-959"><a id="__codelineno-0-959" name="__codelineno-0-959"></a>                <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
-</span><span id="__span-0-960"><a id="__codelineno-0-960" name="__codelineno-0-960"></a>            <span class="p">}</span>
-</span><span id="__span-0-961"><a id="__codelineno-0-961" name="__codelineno-0-961"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
-</span><span id="__span-0-962"><a id="__codelineno-0-962" name="__codelineno-0-962"></a>        <span class="p">)</span>
-</span><span id="__span-0-963"><a id="__codelineno-0-963" name="__codelineno-0-963"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-964"><a id="__codelineno-0-964" name="__codelineno-0-964"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
-</span><span id="__span-0-965"><a id="__codelineno-0-965" name="__codelineno-0-965"></a>        <span class="p">]</span>
-</span><span id="__span-0-966"><a id="__codelineno-0-966" name="__codelineno-0-966"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
-</span><span id="__span-0-967"><a id="__codelineno-0-967" name="__codelineno-0-967"></a>
-</span><span id="__span-0-968"><a id="__codelineno-0-968" name="__codelineno-0-968"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
-</span><span id="__span-0-969"><a id="__codelineno-0-969" name="__codelineno-0-969"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-970"><a id="__codelineno-0-970" name="__codelineno-0-970"></a><span class="sd">        Checks if any records exist that match the given filter conditions.</span>
-</span><span id="__span-0-971"><a id="__codelineno-0-971" name="__codelineno-0-971"></a>
-</span><span id="__span-0-972"><a id="__codelineno-0-972" name="__codelineno-0-972"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-973"><a id="__codelineno-0-973" name="__codelineno-0-973"></a>
-</span><span id="__span-0-974"><a id="__codelineno-0-974" name="__codelineno-0-974"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-975"><a id="__codelineno-0-975" name="__codelineno-0-975"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-976"><a id="__codelineno-0-976" name="__codelineno-0-976"></a><span class="sd">            **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</span>
+</span><span id="__span-0-762"><a id="__codelineno-0-762" name="__codelineno-0-762"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-763"><a id="__codelineno-0-763" name="__codelineno-0-763"></a><span class="sd">            user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))</span>
+</span><span id="__span-0-764"><a id="__codelineno-0-764" name="__codelineno-0-764"></a><span class="sd">            ```</span>
+</span><span id="__span-0-765"><a id="__codelineno-0-765" name="__codelineno-0-765"></a>
+</span><span id="__span-0-766"><a id="__codelineno-0-766" name="__codelineno-0-766"></a><span class="sd">            Fetch a user not equal to a specific username:</span>
+</span><span id="__span-0-767"><a id="__codelineno-0-767" name="__codelineno-0-767"></a>
+</span><span id="__span-0-768"><a id="__codelineno-0-768" name="__codelineno-0-768"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-769"><a id="__codelineno-0-769" name="__codelineno-0-769"></a><span class="sd">            user = await user_crud.get(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-770"><a id="__codelineno-0-770" name="__codelineno-0-770"></a><span class="sd">            ```</span>
+</span><span id="__span-0-771"><a id="__codelineno-0-771" name="__codelineno-0-771"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-772"><a id="__codelineno-0-772" name="__codelineno-0-772"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-773"><a id="__codelineno-0-773" name="__codelineno-0-773"></a>
+</span><span id="__span-0-774"><a id="__codelineno-0-774" name="__codelineno-0-774"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-775"><a id="__codelineno-0-775" name="__codelineno-0-775"></a>        <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+</span><span id="__span-0-776"><a id="__codelineno-0-776" name="__codelineno-0-776"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-777"><a id="__codelineno-0-777" name="__codelineno-0-777"></a>            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-778"><a id="__codelineno-0-778" name="__codelineno-0-778"></a>        <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
+</span><span id="__span-0-779"><a id="__codelineno-0-779" name="__codelineno-0-779"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-780"><a id="__codelineno-0-780" name="__codelineno-0-780"></a>            <span class="k">return</span> <span class="n">out</span>
+</span><span id="__span-0-781"><a id="__codelineno-0-781" name="__codelineno-0-781"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
+</span><span id="__span-0-782"><a id="__codelineno-0-782" name="__codelineno-0-782"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-783"><a id="__codelineno-0-783" name="__codelineno-0-783"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-784"><a id="__codelineno-0-784" name="__codelineno-0-784"></a>            <span class="p">)</span>
+</span><span id="__span-0-785"><a id="__codelineno-0-785" name="__codelineno-0-785"></a>        <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
+</span><span id="__span-0-786"><a id="__codelineno-0-786" name="__codelineno-0-786"></a>
+</span><span id="__span-0-787"><a id="__codelineno-0-787" name="__codelineno-0-787"></a>    <span class="k">def</span> <span class="nf">_get_pk_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">instance</span><span class="p">):</span>
+</span><span id="__span-0-788"><a id="__codelineno-0-788" name="__codelineno-0-788"></a>        <span class="k">return</span> <span class="p">{</span><span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">instance</span><span class="p">,</span> <span class="n">pk</span><span class="o">.</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">}</span>
+</span><span id="__span-0-789"><a id="__codelineno-0-789" name="__codelineno-0-789"></a>
+</span><span id="__span-0-790"><a id="__codelineno-0-790" name="__codelineno-0-790"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">upsert</span><span class="p">(</span>
+</span><span id="__span-0-791"><a id="__codelineno-0-791" name="__codelineno-0-791"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-792"><a id="__codelineno-0-792" name="__codelineno-0-792"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-793"><a id="__codelineno-0-793" name="__codelineno-0-793"></a>        <span class="n">instance</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-794"><a id="__codelineno-0-794" name="__codelineno-0-794"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-795"><a id="__codelineno-0-795" name="__codelineno-0-795"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-796"><a id="__codelineno-0-796" name="__codelineno-0-796"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="kc">None</span><span class="p">]:</span>
+</span><span id="__span-0-797"><a id="__codelineno-0-797" name="__codelineno-0-797"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update the instance or create it if it doesn&#39;t exists.</span>
+</span><span id="__span-0-798"><a id="__codelineno-0-798" name="__codelineno-0-798"></a>
+</span><span id="__span-0-799"><a id="__codelineno-0-799" name="__codelineno-0-799"></a><span class="sd">        Note: This method will perform two transactions to the database (get and create or update).</span>
+</span><span id="__span-0-800"><a id="__codelineno-0-800" name="__codelineno-0-800"></a>
+</span><span id="__span-0-801"><a id="__codelineno-0-801" name="__codelineno-0-801"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-802"><a id="__codelineno-0-802" name="__codelineno-0-802"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-803"><a id="__codelineno-0-803" name="__codelineno-0-803"></a><span class="sd">            instance: A Pydantic schema representing the instance.</span>
+</span><span id="__span-0-804"><a id="__codelineno-0-804" name="__codelineno-0-804"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.</span>
+</span><span id="__span-0-805"><a id="__codelineno-0-805" name="__codelineno-0-805"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-806"><a id="__codelineno-0-806" name="__codelineno-0-806"></a>
+</span><span id="__span-0-807"><a id="__codelineno-0-807" name="__codelineno-0-807"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-808"><a id="__codelineno-0-808" name="__codelineno-0-808"></a><span class="sd">            The created or updated instance</span>
+</span><span id="__span-0-809"><a id="__codelineno-0-809" name="__codelineno-0-809"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-810"><a id="__codelineno-0-810" name="__codelineno-0-810"></a>        <span class="n">_pks</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pk_dict</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
+</span><span id="__span-0-811"><a id="__codelineno-0-811" name="__codelineno-0-811"></a>        <span class="n">schema_to_select</span> <span class="o">=</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="nb">type</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-812"><a id="__codelineno-0-812" name="__codelineno-0-812"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-813"><a id="__codelineno-0-813" name="__codelineno-0-813"></a>            <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-814"><a id="__codelineno-0-814" name="__codelineno-0-814"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-815"><a id="__codelineno-0-815" name="__codelineno-0-815"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-816"><a id="__codelineno-0-816" name="__codelineno-0-816"></a>            <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
+</span><span id="__span-0-817"><a id="__codelineno-0-817" name="__codelineno-0-817"></a>        <span class="p">)</span>
+</span><span id="__span-0-818"><a id="__codelineno-0-818" name="__codelineno-0-818"></a>        <span class="k">if</span> <span class="n">db_instance</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-819"><a id="__codelineno-0-819" name="__codelineno-0-819"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-820"><a id="__codelineno-0-820" name="__codelineno-0-820"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="o">.</span><span class="n">model_validate</span><span class="p">(</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-821"><a id="__codelineno-0-821" name="__codelineno-0-821"></a>                <span class="n">db_instance</span><span class="p">,</span> <span class="n">from_attributes</span><span class="o">=</span><span class="kc">True</span>
+</span><span id="__span-0-822"><a id="__codelineno-0-822" name="__codelineno-0-822"></a>            <span class="p">)</span>
+</span><span id="__span-0-823"><a id="__codelineno-0-823" name="__codelineno-0-823"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-824"><a id="__codelineno-0-824" name="__codelineno-0-824"></a>            <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-825"><a id="__codelineno-0-825" name="__codelineno-0-825"></a>            <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-826"><a id="__codelineno-0-826" name="__codelineno-0-826"></a>                <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-827"><a id="__codelineno-0-827" name="__codelineno-0-827"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-828"><a id="__codelineno-0-828" name="__codelineno-0-828"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-829"><a id="__codelineno-0-829" name="__codelineno-0-829"></a>                <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
+</span><span id="__span-0-830"><a id="__codelineno-0-830" name="__codelineno-0-830"></a>            <span class="p">)</span>
+</span><span id="__span-0-831"><a id="__codelineno-0-831" name="__codelineno-0-831"></a>
+</span><span id="__span-0-832"><a id="__codelineno-0-832" name="__codelineno-0-832"></a>        <span class="k">return</span> <span class="n">db_instance</span>
+</span><span id="__span-0-833"><a id="__codelineno-0-833" name="__codelineno-0-833"></a>
+</span><span id="__span-0-834"><a id="__codelineno-0-834" name="__codelineno-0-834"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">upsert_multi</span><span class="p">(</span>
+</span><span id="__span-0-835"><a id="__codelineno-0-835" name="__codelineno-0-835"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-836"><a id="__codelineno-0-836" name="__codelineno-0-836"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-837"><a id="__codelineno-0-837" name="__codelineno-0-837"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
+</span><span id="__span-0-838"><a id="__codelineno-0-838" name="__codelineno-0-838"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-839"><a id="__codelineno-0-839" name="__codelineno-0-839"></a>        <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-840"><a id="__codelineno-0-840" name="__codelineno-0-840"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-841"><a id="__codelineno-0-841" name="__codelineno-0-841"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-842"><a id="__codelineno-0-842" name="__codelineno-0-842"></a>        <span class="n">update_override</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-843"><a id="__codelineno-0-843" name="__codelineno-0-843"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-844"><a id="__codelineno-0-844" name="__codelineno-0-844"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
+</span><span id="__span-0-845"><a id="__codelineno-0-845" name="__codelineno-0-845"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-846"><a id="__codelineno-0-846" name="__codelineno-0-846"></a><span class="sd">        Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</span>
+</span><span id="__span-0-847"><a id="__codelineno-0-847" name="__codelineno-0-847"></a>
+</span><span id="__span-0-848"><a id="__codelineno-0-848" name="__codelineno-0-848"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-849"><a id="__codelineno-0-849" name="__codelineno-0-849"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-850"><a id="__codelineno-0-850" name="__codelineno-0-850"></a><span class="sd">            instances: A list of Pydantic schemas representing the instances to upsert.</span>
+</span><span id="__span-0-851"><a id="__codelineno-0-851" name="__codelineno-0-851"></a><span class="sd">            commit: If True, commits the transaction immediately. Default is False.</span>
+</span><span id="__span-0-852"><a id="__codelineno-0-852" name="__codelineno-0-852"></a><span class="sd">            return_columns: Optional list of column names to return after the upsert operation.</span>
+</span><span id="__span-0-853"><a id="__codelineno-0-853" name="__codelineno-0-853"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</span>
+</span><span id="__span-0-854"><a id="__codelineno-0-854" name="__codelineno-0-854"></a><span class="sd">            return_as_model: If True, returns data as instances of the specified Pydantic model.</span>
+</span><span id="__span-0-855"><a id="__codelineno-0-855" name="__codelineno-0-855"></a><span class="sd">            update_override: Optional dictionary to override the update values for the upsert operation.</span>
+</span><span id="__span-0-856"><a id="__codelineno-0-856" name="__codelineno-0-856"></a><span class="sd">            **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-857"><a id="__codelineno-0-857" name="__codelineno-0-857"></a>
+</span><span id="__span-0-858"><a id="__codelineno-0-858" name="__codelineno-0-858"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-859"><a id="__codelineno-0-859" name="__codelineno-0-859"></a><span class="sd">            The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.</span>
+</span><span id="__span-0-860"><a id="__codelineno-0-860" name="__codelineno-0-860"></a>
+</span><span id="__span-0-861"><a id="__codelineno-0-861" name="__codelineno-0-861"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-862"><a id="__codelineno-0-862" name="__codelineno-0-862"></a><span class="sd">            ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</span>
+</span><span id="__span-0-863"><a id="__codelineno-0-863" name="__codelineno-0-863"></a><span class="sd">            NotImplementedError: If the database dialect is not supported for upsert multi.</span>
+</span><span id="__span-0-864"><a id="__codelineno-0-864" name="__codelineno-0-864"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-865"><a id="__codelineno-0-865" name="__codelineno-0-865"></a>        <span class="k">if</span> <span class="n">update_override</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-866"><a id="__codelineno-0-866" name="__codelineno-0-866"></a>            <span class="n">update_override</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-867"><a id="__codelineno-0-867" name="__codelineno-0-867"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-868"><a id="__codelineno-0-868" name="__codelineno-0-868"></a>
+</span><span id="__span-0-869"><a id="__codelineno-0-869" name="__codelineno-0-869"></a>        <span class="k">if</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;postgresql&quot;</span><span class="p">:</span>
+</span><span id="__span-0-870"><a id="__codelineno-0-870" name="__codelineno-0-870"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_postgresql</span><span class="p">(</span>
+</span><span id="__span-0-871"><a id="__codelineno-0-871" name="__codelineno-0-871"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-872"><a id="__codelineno-0-872" name="__codelineno-0-872"></a>            <span class="p">)</span>
+</span><span id="__span-0-873"><a id="__codelineno-0-873" name="__codelineno-0-873"></a>        <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;sqlite&quot;</span><span class="p">:</span>
+</span><span id="__span-0-874"><a id="__codelineno-0-874" name="__codelineno-0-874"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_sqlite</span><span class="p">(</span>
+</span><span id="__span-0-875"><a id="__codelineno-0-875" name="__codelineno-0-875"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-876"><a id="__codelineno-0-876" name="__codelineno-0-876"></a>            <span class="p">)</span>
+</span><span id="__span-0-877"><a id="__codelineno-0-877" name="__codelineno-0-877"></a>        <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;mysql&quot;</span><span class="p">,</span> <span class="s2">&quot;mariadb&quot;</span><span class="p">]:</span>
+</span><span id="__span-0-878"><a id="__codelineno-0-878" name="__codelineno-0-878"></a>            <span class="k">if</span> <span class="n">filters</span><span class="p">:</span>
+</span><span id="__span-0-879"><a id="__codelineno-0-879" name="__codelineno-0-879"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-880"><a id="__codelineno-0-880" name="__codelineno-0-880"></a>                    <span class="s2">&quot;MySQL does not support filtering on insert operations.&quot;</span>
+</span><span id="__span-0-881"><a id="__codelineno-0-881" name="__codelineno-0-881"></a>                <span class="p">)</span>
+</span><span id="__span-0-882"><a id="__codelineno-0-882" name="__codelineno-0-882"></a>            <span class="k">if</span> <span class="n">return_columns</span> <span class="ow">or</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-883"><a id="__codelineno-0-883" name="__codelineno-0-883"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-884"><a id="__codelineno-0-884" name="__codelineno-0-884"></a>                    <span class="s2">&quot;MySQL does not support the returning clause for insert operations.&quot;</span>
+</span><span id="__span-0-885"><a id="__codelineno-0-885" name="__codelineno-0-885"></a>                <span class="p">)</span>
+</span><span id="__span-0-886"><a id="__codelineno-0-886" name="__codelineno-0-886"></a>            <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_mysql</span><span class="p">(</span>
+</span><span id="__span-0-887"><a id="__codelineno-0-887" name="__codelineno-0-887"></a>                <span class="n">instances</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-888"><a id="__codelineno-0-888" name="__codelineno-0-888"></a>            <span class="p">)</span>
+</span><span id="__span-0-889"><a id="__codelineno-0-889" name="__codelineno-0-889"></a>        <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-890"><a id="__codelineno-0-890" name="__codelineno-0-890"></a>            <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
+</span><span id="__span-0-891"><a id="__codelineno-0-891" name="__codelineno-0-891"></a>                <span class="sa">f</span><span class="s2">&quot;Upsert multi is not implemented for </span><span class="si">{</span><span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-892"><a id="__codelineno-0-892" name="__codelineno-0-892"></a>            <span class="p">)</span>
+</span><span id="__span-0-893"><a id="__codelineno-0-893" name="__codelineno-0-893"></a>
+</span><span id="__span-0-894"><a id="__codelineno-0-894" name="__codelineno-0-894"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-895"><a id="__codelineno-0-895" name="__codelineno-0-895"></a>            <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
+</span><span id="__span-0-896"><a id="__codelineno-0-896" name="__codelineno-0-896"></a>
+</span><span id="__span-0-897"><a id="__codelineno-0-897" name="__codelineno-0-897"></a>        <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
+</span><span id="__span-0-898"><a id="__codelineno-0-898" name="__codelineno-0-898"></a>            <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
+</span><span id="__span-0-899"><a id="__codelineno-0-899" name="__codelineno-0-899"></a>            <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
+</span><span id="__span-0-900"><a id="__codelineno-0-900" name="__codelineno-0-900"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-901"><a id="__codelineno-0-901" name="__codelineno-0-901"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-902"><a id="__codelineno-0-902" name="__codelineno-0-902"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
+</span><span id="__span-0-903"><a id="__codelineno-0-903" name="__codelineno-0-903"></a>                <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-904"><a id="__codelineno-0-904" name="__codelineno-0-904"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-905"><a id="__codelineno-0-905" name="__codelineno-0-905"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-906"><a id="__codelineno-0-906" name="__codelineno-0-906"></a>            <span class="p">)</span>
+</span><span id="__span-0-907"><a id="__codelineno-0-907" name="__codelineno-0-907"></a>
+</span><span id="__span-0-908"><a id="__codelineno-0-908" name="__codelineno-0-908"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
+</span><span id="__span-0-909"><a id="__codelineno-0-909" name="__codelineno-0-909"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-910"><a id="__codelineno-0-910" name="__codelineno-0-910"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-911"><a id="__codelineno-0-911" name="__codelineno-0-911"></a>        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-912"><a id="__codelineno-0-912" name="__codelineno-0-912"></a>
+</span><span id="__span-0-913"><a id="__codelineno-0-913" name="__codelineno-0-913"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_postgresql</span><span class="p">(</span>
+</span><span id="__span-0-914"><a id="__codelineno-0-914" name="__codelineno-0-914"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-915"><a id="__codelineno-0-915" name="__codelineno-0-915"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
+</span><span id="__span-0-916"><a id="__codelineno-0-916" name="__codelineno-0-916"></a>        <span class="n">filters</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">],</span>
+</span><span id="__span-0-917"><a id="__codelineno-0-917" name="__codelineno-0-917"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
+</span><span id="__span-0-918"><a id="__codelineno-0-918" name="__codelineno-0-918"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
+</span><span id="__span-0-919"><a id="__codelineno-0-919" name="__codelineno-0-919"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">postgresql</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-920"><a id="__codelineno-0-920" name="__codelineno-0-920"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_conflict_do_update</span><span class="p">(</span>
+</span><span id="__span-0-921"><a id="__codelineno-0-921" name="__codelineno-0-921"></a>            <span class="n">index_elements</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">,</span>
+</span><span id="__span-0-922"><a id="__codelineno-0-922" name="__codelineno-0-922"></a>            <span class="n">set_</span><span class="o">=</span><span class="p">{</span>
+</span><span id="__span-0-923"><a id="__codelineno-0-923" name="__codelineno-0-923"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">excluded</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
+</span><span id="__span-0-924"><a id="__codelineno-0-924" name="__codelineno-0-924"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
+</span><span id="__span-0-925"><a id="__codelineno-0-925" name="__codelineno-0-925"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
+</span><span id="__span-0-926"><a id="__codelineno-0-926" name="__codelineno-0-926"></a>            <span class="p">}</span>
+</span><span id="__span-0-927"><a id="__codelineno-0-927" name="__codelineno-0-927"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
+</span><span id="__span-0-928"><a id="__codelineno-0-928" name="__codelineno-0-928"></a>            <span class="n">where</span><span class="o">=</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span> <span class="k">if</span> <span class="n">filters</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-929"><a id="__codelineno-0-929" name="__codelineno-0-929"></a>        <span class="p">)</span>
+</span><span id="__span-0-930"><a id="__codelineno-0-930" name="__codelineno-0-930"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-931"><a id="__codelineno-0-931" name="__codelineno-0-931"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
+</span><span id="__span-0-932"><a id="__codelineno-0-932" name="__codelineno-0-932"></a>        <span class="p">]</span>
+</span><span id="__span-0-933"><a id="__codelineno-0-933" name="__codelineno-0-933"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
+</span><span id="__span-0-934"><a id="__codelineno-0-934" name="__codelineno-0-934"></a>
+</span><span id="__span-0-935"><a id="__codelineno-0-935" name="__codelineno-0-935"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_sqlite</span><span class="p">(</span>
+</span><span id="__span-0-936"><a id="__codelineno-0-936" name="__codelineno-0-936"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-937"><a id="__codelineno-0-937" name="__codelineno-0-937"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
+</span><span id="__span-0-938"><a id="__codelineno-0-938" name="__codelineno-0-938"></a>        <span class="n">filters</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ColumnElement</span><span class="p">],</span>
+</span><span id="__span-0-939"><a id="__codelineno-0-939" name="__codelineno-0-939"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
+</span><span id="__span-0-940"><a id="__codelineno-0-940" name="__codelineno-0-940"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
+</span><span id="__span-0-941"><a id="__codelineno-0-941" name="__codelineno-0-941"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">sqlite</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-942"><a id="__codelineno-0-942" name="__codelineno-0-942"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_conflict_do_update</span><span class="p">(</span>
+</span><span id="__span-0-943"><a id="__codelineno-0-943" name="__codelineno-0-943"></a>            <span class="n">index_elements</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">,</span>
+</span><span id="__span-0-944"><a id="__codelineno-0-944" name="__codelineno-0-944"></a>            <span class="n">set_</span><span class="o">=</span><span class="p">{</span>
+</span><span id="__span-0-945"><a id="__codelineno-0-945" name="__codelineno-0-945"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">excluded</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
+</span><span id="__span-0-946"><a id="__codelineno-0-946" name="__codelineno-0-946"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
+</span><span id="__span-0-947"><a id="__codelineno-0-947" name="__codelineno-0-947"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
+</span><span id="__span-0-948"><a id="__codelineno-0-948" name="__codelineno-0-948"></a>            <span class="p">}</span>
+</span><span id="__span-0-949"><a id="__codelineno-0-949" name="__codelineno-0-949"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
+</span><span id="__span-0-950"><a id="__codelineno-0-950" name="__codelineno-0-950"></a>            <span class="n">where</span><span class="o">=</span><span class="n">and_</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span> <span class="k">if</span> <span class="n">filters</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-951"><a id="__codelineno-0-951" name="__codelineno-0-951"></a>        <span class="p">)</span>
+</span><span id="__span-0-952"><a id="__codelineno-0-952" name="__codelineno-0-952"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-953"><a id="__codelineno-0-953" name="__codelineno-0-953"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
+</span><span id="__span-0-954"><a id="__codelineno-0-954" name="__codelineno-0-954"></a>        <span class="p">]</span>
+</span><span id="__span-0-955"><a id="__codelineno-0-955" name="__codelineno-0-955"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
+</span><span id="__span-0-956"><a id="__codelineno-0-956" name="__codelineno-0-956"></a>
+</span><span id="__span-0-957"><a id="__codelineno-0-957" name="__codelineno-0-957"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">_upsert_multi_mysql</span><span class="p">(</span>
+</span><span id="__span-0-958"><a id="__codelineno-0-958" name="__codelineno-0-958"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-959"><a id="__codelineno-0-959" name="__codelineno-0-959"></a>        <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
+</span><span id="__span-0-960"><a id="__codelineno-0-960" name="__codelineno-0-960"></a>        <span class="n">update_set_override</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span>
+</span><span id="__span-0-961"><a id="__codelineno-0-961" name="__codelineno-0-961"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">tuple</span><span class="p">[</span><span class="n">Insert</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]]:</span>
+</span><span id="__span-0-962"><a id="__codelineno-0-962" name="__codelineno-0-962"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">mysql</span><span class="o">.</span><span class="n">insert</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-963"><a id="__codelineno-0-963" name="__codelineno-0-963"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">on_duplicate_key_update</span><span class="p">(</span>
+</span><span id="__span-0-964"><a id="__codelineno-0-964" name="__codelineno-0-964"></a>            <span class="p">{</span>
+</span><span id="__span-0-965"><a id="__codelineno-0-965" name="__codelineno-0-965"></a>                <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">statement</span><span class="o">.</span><span class="n">inserted</span><span class="p">,</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span><span class="p">)</span>
+</span><span id="__span-0-966"><a id="__codelineno-0-966" name="__codelineno-0-966"></a>                <span class="k">for</span> <span class="n">column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">columns</span>
+</span><span id="__span-0-967"><a id="__codelineno-0-967" name="__codelineno-0-967"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">primary_key</span>
+</span><span id="__span-0-968"><a id="__codelineno-0-968" name="__codelineno-0-968"></a>                <span class="ow">and</span> <span class="ow">not</span> <span class="n">column</span><span class="o">.</span><span class="n">unique</span>
+</span><span id="__span-0-969"><a id="__codelineno-0-969" name="__codelineno-0-969"></a>                <span class="ow">and</span> <span class="n">column</span><span class="o">.</span><span class="n">name</span> <span class="o">!=</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
+</span><span id="__span-0-970"><a id="__codelineno-0-970" name="__codelineno-0-970"></a>            <span class="p">}</span>
+</span><span id="__span-0-971"><a id="__codelineno-0-971" name="__codelineno-0-971"></a>            <span class="o">|</span> <span class="n">update_set_override</span><span class="p">,</span>
+</span><span id="__span-0-972"><a id="__codelineno-0-972" name="__codelineno-0-972"></a>        <span class="p">)</span>
+</span><span id="__span-0-973"><a id="__codelineno-0-973" name="__codelineno-0-973"></a>        <span class="n">params</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-974"><a id="__codelineno-0-974" name="__codelineno-0-974"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">instance</span><span class="o">.</span><span class="n">model_dump</span><span class="p">())</span><span class="o">.</span><span class="vm">__dict__</span> <span class="k">for</span> <span class="n">instance</span> <span class="ow">in</span> <span class="n">instances</span>
+</span><span id="__span-0-975"><a id="__codelineno-0-975" name="__codelineno-0-975"></a>        <span class="p">]</span>
+</span><span id="__span-0-976"><a id="__codelineno-0-976" name="__codelineno-0-976"></a>        <span class="k">return</span> <span class="n">statement</span><span class="p">,</span> <span class="n">params</span>
 </span><span id="__span-0-977"><a id="__codelineno-0-977" name="__codelineno-0-977"></a>
-</span><span id="__span-0-978"><a id="__codelineno-0-978" name="__codelineno-0-978"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-979"><a id="__codelineno-0-979" name="__codelineno-0-979"></a><span class="sd">            `True` if at least one record matches the filter conditions, `False` otherwise.</span>
-</span><span id="__span-0-980"><a id="__codelineno-0-980" name="__codelineno-0-980"></a>
-</span><span id="__span-0-981"><a id="__codelineno-0-981" name="__codelineno-0-981"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-982"><a id="__codelineno-0-982" name="__codelineno-0-982"></a><span class="sd">            Check if a user with a specific ID exists:</span>
+</span><span id="__span-0-978"><a id="__codelineno-0-978" name="__codelineno-0-978"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+</span><span id="__span-0-979"><a id="__codelineno-0-979" name="__codelineno-0-979"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-980"><a id="__codelineno-0-980" name="__codelineno-0-980"></a><span class="sd">        Checks if any records exist that match the given filter conditions.</span>
+</span><span id="__span-0-981"><a id="__codelineno-0-981" name="__codelineno-0-981"></a>
+</span><span id="__span-0-982"><a id="__codelineno-0-982" name="__codelineno-0-982"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-983"><a id="__codelineno-0-983" name="__codelineno-0-983"></a>
-</span><span id="__span-0-984"><a id="__codelineno-0-984" name="__codelineno-0-984"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-985"><a id="__codelineno-0-985" name="__codelineno-0-985"></a><span class="sd">            exists = await user_crud.exists(db, id=1)</span>
-</span><span id="__span-0-986"><a id="__codelineno-0-986" name="__codelineno-0-986"></a><span class="sd">            ```</span>
+</span><span id="__span-0-984"><a id="__codelineno-0-984" name="__codelineno-0-984"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-985"><a id="__codelineno-0-985" name="__codelineno-0-985"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-986"><a id="__codelineno-0-986" name="__codelineno-0-986"></a><span class="sd">            **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</span>
 </span><span id="__span-0-987"><a id="__codelineno-0-987" name="__codelineno-0-987"></a>
-</span><span id="__span-0-988"><a id="__codelineno-0-988" name="__codelineno-0-988"></a><span class="sd">            Check if any user is older than 30:</span>
-</span><span id="__span-0-989"><a id="__codelineno-0-989" name="__codelineno-0-989"></a>
-</span><span id="__span-0-990"><a id="__codelineno-0-990" name="__codelineno-0-990"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-991"><a id="__codelineno-0-991" name="__codelineno-0-991"></a><span class="sd">            exists = await user_crud.exists(db, age__gt=30)</span>
-</span><span id="__span-0-992"><a id="__codelineno-0-992" name="__codelineno-0-992"></a><span class="sd">            ```</span>
+</span><span id="__span-0-988"><a id="__codelineno-0-988" name="__codelineno-0-988"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-989"><a id="__codelineno-0-989" name="__codelineno-0-989"></a><span class="sd">            `True` if at least one record matches the filter conditions, `False` otherwise.</span>
+</span><span id="__span-0-990"><a id="__codelineno-0-990" name="__codelineno-0-990"></a>
+</span><span id="__span-0-991"><a id="__codelineno-0-991" name="__codelineno-0-991"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-992"><a id="__codelineno-0-992" name="__codelineno-0-992"></a><span class="sd">            Check if a user with a specific ID exists:</span>
 </span><span id="__span-0-993"><a id="__codelineno-0-993" name="__codelineno-0-993"></a>
-</span><span id="__span-0-994"><a id="__codelineno-0-994" name="__codelineno-0-994"></a><span class="sd">            Check if any user was registered before Jan 1, 2020:</span>
-</span><span id="__span-0-995"><a id="__codelineno-0-995" name="__codelineno-0-995"></a>
-</span><span id="__span-0-996"><a id="__codelineno-0-996" name="__codelineno-0-996"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-997"><a id="__codelineno-0-997" name="__codelineno-0-997"></a><span class="sd">            exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))</span>
-</span><span id="__span-0-998"><a id="__codelineno-0-998" name="__codelineno-0-998"></a><span class="sd">            ```</span>
+</span><span id="__span-0-994"><a id="__codelineno-0-994" name="__codelineno-0-994"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-995"><a id="__codelineno-0-995" name="__codelineno-0-995"></a><span class="sd">            exists = await user_crud.exists(db, id=1)</span>
+</span><span id="__span-0-996"><a id="__codelineno-0-996" name="__codelineno-0-996"></a><span class="sd">            ```</span>
+</span><span id="__span-0-997"><a id="__codelineno-0-997" name="__codelineno-0-997"></a>
+</span><span id="__span-0-998"><a id="__codelineno-0-998" name="__codelineno-0-998"></a><span class="sd">            Check if any user is older than 30:</span>
 </span><span id="__span-0-999"><a id="__codelineno-0-999" name="__codelineno-0-999"></a>
-</span><span id="__span-0-1000"><a id="__codelineno-0-1000" name="__codelineno-0-1000"></a><span class="sd">            Check if a username other than `admin` exists:</span>
-</span><span id="__span-0-1001"><a id="__codelineno-0-1001" name="__codelineno-0-1001"></a>
-</span><span id="__span-0-1002"><a id="__codelineno-0-1002" name="__codelineno-0-1002"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1003"><a id="__codelineno-0-1003" name="__codelineno-0-1003"></a><span class="sd">            exists = await user_crud.exists(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-1004"><a id="__codelineno-0-1004" name="__codelineno-0-1004"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1005"><a id="__codelineno-0-1005" name="__codelineno-0-1005"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-1006"><a id="__codelineno-0-1006" name="__codelineno-0-1006"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1007"><a id="__codelineno-0-1007" name="__codelineno-0-1007"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-</span><span id="__span-0-1008"><a id="__codelineno-0-1008" name="__codelineno-0-1008"></a>
-</span><span id="__span-0-1009"><a id="__codelineno-0-1009" name="__codelineno-0-1009"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1010"><a id="__codelineno-0-1010" name="__codelineno-0-1010"></a>        <span class="k">return</span> <span class="n">result</span><span class="o">.</span><span class="n">first</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-1000"><a id="__codelineno-0-1000" name="__codelineno-0-1000"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1001"><a id="__codelineno-0-1001" name="__codelineno-0-1001"></a><span class="sd">            exists = await user_crud.exists(db, age__gt=30)</span>
+</span><span id="__span-0-1002"><a id="__codelineno-0-1002" name="__codelineno-0-1002"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1003"><a id="__codelineno-0-1003" name="__codelineno-0-1003"></a>
+</span><span id="__span-0-1004"><a id="__codelineno-0-1004" name="__codelineno-0-1004"></a><span class="sd">            Check if any user was registered before Jan 1, 2020:</span>
+</span><span id="__span-0-1005"><a id="__codelineno-0-1005" name="__codelineno-0-1005"></a>
+</span><span id="__span-0-1006"><a id="__codelineno-0-1006" name="__codelineno-0-1006"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1007"><a id="__codelineno-0-1007" name="__codelineno-0-1007"></a><span class="sd">            exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))</span>
+</span><span id="__span-0-1008"><a id="__codelineno-0-1008" name="__codelineno-0-1008"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1009"><a id="__codelineno-0-1009" name="__codelineno-0-1009"></a>
+</span><span id="__span-0-1010"><a id="__codelineno-0-1010" name="__codelineno-0-1010"></a><span class="sd">            Check if a username other than `admin` exists:</span>
 </span><span id="__span-0-1011"><a id="__codelineno-0-1011" name="__codelineno-0-1011"></a>
-</span><span id="__span-0-1012"><a id="__codelineno-0-1012" name="__codelineno-0-1012"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">count</span><span class="p">(</span>
-</span><span id="__span-0-1013"><a id="__codelineno-0-1013" name="__codelineno-0-1013"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1014"><a id="__codelineno-0-1014" name="__codelineno-0-1014"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1015"><a id="__codelineno-0-1015" name="__codelineno-0-1015"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1016"><a id="__codelineno-0-1016" name="__codelineno-0-1016"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1017"><a id="__codelineno-0-1017" name="__codelineno-0-1017"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
-</span><span id="__span-0-1018"><a id="__codelineno-0-1018" name="__codelineno-0-1018"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1019"><a id="__codelineno-0-1019" name="__codelineno-0-1019"></a><span class="sd">        Counts records that match specified filters.</span>
-</span><span id="__span-0-1020"><a id="__codelineno-0-1020" name="__codelineno-0-1020"></a>
-</span><span id="__span-0-1021"><a id="__codelineno-0-1021" name="__codelineno-0-1021"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1022"><a id="__codelineno-0-1022" name="__codelineno-0-1022"></a>
-</span><span id="__span-0-1023"><a id="__codelineno-0-1023" name="__codelineno-0-1023"></a><span class="sd">        Can also count records based on a configuration of joins, useful for complex queries involving relationships.</span>
-</span><span id="__span-0-1024"><a id="__codelineno-0-1024" name="__codelineno-0-1024"></a>
-</span><span id="__span-0-1025"><a id="__codelineno-0-1025" name="__codelineno-0-1025"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-1026"><a id="__codelineno-0-1026" name="__codelineno-0-1026"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-1027"><a id="__codelineno-0-1027" name="__codelineno-0-1027"></a><span class="sd">            joins_config: Optional configuration for applying joins in the count query.</span>
-</span><span id="__span-0-1028"><a id="__codelineno-0-1028" name="__codelineno-0-1028"></a><span class="sd">            **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</span>
-</span><span id="__span-0-1029"><a id="__codelineno-0-1029" name="__codelineno-0-1029"></a>
-</span><span id="__span-0-1030"><a id="__codelineno-0-1030" name="__codelineno-0-1030"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-1031"><a id="__codelineno-0-1031" name="__codelineno-0-1031"></a><span class="sd">            The total number of records matching the filter conditions.</span>
+</span><span id="__span-0-1012"><a id="__codelineno-0-1012" name="__codelineno-0-1012"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1013"><a id="__codelineno-0-1013" name="__codelineno-0-1013"></a><span class="sd">            exists = await user_crud.exists(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-1014"><a id="__codelineno-0-1014" name="__codelineno-0-1014"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1015"><a id="__codelineno-0-1015" name="__codelineno-0-1015"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-1016"><a id="__codelineno-0-1016" name="__codelineno-0-1016"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1017"><a id="__codelineno-0-1017" name="__codelineno-0-1017"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+</span><span id="__span-0-1018"><a id="__codelineno-0-1018" name="__codelineno-0-1018"></a>
+</span><span id="__span-0-1019"><a id="__codelineno-0-1019" name="__codelineno-0-1019"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1020"><a id="__codelineno-0-1020" name="__codelineno-0-1020"></a>        <span class="k">return</span> <span class="n">result</span><span class="o">.</span><span class="n">first</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-1021"><a id="__codelineno-0-1021" name="__codelineno-0-1021"></a>
+</span><span id="__span-0-1022"><a id="__codelineno-0-1022" name="__codelineno-0-1022"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">count</span><span class="p">(</span>
+</span><span id="__span-0-1023"><a id="__codelineno-0-1023" name="__codelineno-0-1023"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1024"><a id="__codelineno-0-1024" name="__codelineno-0-1024"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1025"><a id="__codelineno-0-1025" name="__codelineno-0-1025"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1026"><a id="__codelineno-0-1026" name="__codelineno-0-1026"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1027"><a id="__codelineno-0-1027" name="__codelineno-0-1027"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+</span><span id="__span-0-1028"><a id="__codelineno-0-1028" name="__codelineno-0-1028"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1029"><a id="__codelineno-0-1029" name="__codelineno-0-1029"></a><span class="sd">        Counts records that match specified filters.</span>
+</span><span id="__span-0-1030"><a id="__codelineno-0-1030" name="__codelineno-0-1030"></a>
+</span><span id="__span-0-1031"><a id="__codelineno-0-1031" name="__codelineno-0-1031"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-1032"><a id="__codelineno-0-1032" name="__codelineno-0-1032"></a>
-</span><span id="__span-0-1033"><a id="__codelineno-0-1033" name="__codelineno-0-1033"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-1034"><a id="__codelineno-0-1034" name="__codelineno-0-1034"></a><span class="sd">            Count users by ID:</span>
-</span><span id="__span-0-1035"><a id="__codelineno-0-1035" name="__codelineno-0-1035"></a>
-</span><span id="__span-0-1036"><a id="__codelineno-0-1036" name="__codelineno-0-1036"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1037"><a id="__codelineno-0-1037" name="__codelineno-0-1037"></a><span class="sd">            count = await user_crud.count(db, id=1)</span>
-</span><span id="__span-0-1038"><a id="__codelineno-0-1038" name="__codelineno-0-1038"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1033"><a id="__codelineno-0-1033" name="__codelineno-0-1033"></a><span class="sd">        Can also count records based on a configuration of joins, useful for complex queries involving relationships.</span>
+</span><span id="__span-0-1034"><a id="__codelineno-0-1034" name="__codelineno-0-1034"></a>
+</span><span id="__span-0-1035"><a id="__codelineno-0-1035" name="__codelineno-0-1035"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-1036"><a id="__codelineno-0-1036" name="__codelineno-0-1036"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-1037"><a id="__codelineno-0-1037" name="__codelineno-0-1037"></a><span class="sd">            joins_config: Optional configuration for applying joins in the count query.</span>
+</span><span id="__span-0-1038"><a id="__codelineno-0-1038" name="__codelineno-0-1038"></a><span class="sd">            **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</span>
 </span><span id="__span-0-1039"><a id="__codelineno-0-1039" name="__codelineno-0-1039"></a>
-</span><span id="__span-0-1040"><a id="__codelineno-0-1040" name="__codelineno-0-1040"></a><span class="sd">            Count users older than 30:</span>
-</span><span id="__span-0-1041"><a id="__codelineno-0-1041" name="__codelineno-0-1041"></a>
-</span><span id="__span-0-1042"><a id="__codelineno-0-1042" name="__codelineno-0-1042"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1043"><a id="__codelineno-0-1043" name="__codelineno-0-1043"></a><span class="sd">            count = await user_crud.count(db, age__gt=30)</span>
-</span><span id="__span-0-1044"><a id="__codelineno-0-1044" name="__codelineno-0-1044"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1040"><a id="__codelineno-0-1040" name="__codelineno-0-1040"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-1041"><a id="__codelineno-0-1041" name="__codelineno-0-1041"></a><span class="sd">            The total number of records matching the filter conditions.</span>
+</span><span id="__span-0-1042"><a id="__codelineno-0-1042" name="__codelineno-0-1042"></a>
+</span><span id="__span-0-1043"><a id="__codelineno-0-1043" name="__codelineno-0-1043"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-1044"><a id="__codelineno-0-1044" name="__codelineno-0-1044"></a><span class="sd">            Count users by ID:</span>
 </span><span id="__span-0-1045"><a id="__codelineno-0-1045" name="__codelineno-0-1045"></a>
-</span><span id="__span-0-1046"><a id="__codelineno-0-1046" name="__codelineno-0-1046"></a><span class="sd">            Count users with a username other than `admin`:</span>
-</span><span id="__span-0-1047"><a id="__codelineno-0-1047" name="__codelineno-0-1047"></a>
-</span><span id="__span-0-1048"><a id="__codelineno-0-1048" name="__codelineno-0-1048"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1049"><a id="__codelineno-0-1049" name="__codelineno-0-1049"></a><span class="sd">            count = await user_crud.count(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-1050"><a id="__codelineno-0-1050" name="__codelineno-0-1050"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1046"><a id="__codelineno-0-1046" name="__codelineno-0-1046"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1047"><a id="__codelineno-0-1047" name="__codelineno-0-1047"></a><span class="sd">            count = await user_crud.count(db, id=1)</span>
+</span><span id="__span-0-1048"><a id="__codelineno-0-1048" name="__codelineno-0-1048"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1049"><a id="__codelineno-0-1049" name="__codelineno-0-1049"></a>
+</span><span id="__span-0-1050"><a id="__codelineno-0-1050" name="__codelineno-0-1050"></a><span class="sd">            Count users older than 30:</span>
 </span><span id="__span-0-1051"><a id="__codelineno-0-1051" name="__codelineno-0-1051"></a>
-</span><span id="__span-0-1052"><a id="__codelineno-0-1052" name="__codelineno-0-1052"></a><span class="sd">            Count projects with at least one participant (many-to-many relationship):</span>
-</span><span id="__span-0-1053"><a id="__codelineno-0-1053" name="__codelineno-0-1053"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1054"><a id="__codelineno-0-1054" name="__codelineno-0-1054"></a><span class="sd">            joins_config = [</span>
-</span><span id="__span-0-1055"><a id="__codelineno-0-1055" name="__codelineno-0-1055"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1056"><a id="__codelineno-0-1056" name="__codelineno-0-1056"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1057"><a id="__codelineno-0-1057" name="__codelineno-0-1057"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1058"><a id="__codelineno-0-1058" name="__codelineno-0-1058"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1059"><a id="__codelineno-0-1059" name="__codelineno-0-1059"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1060"><a id="__codelineno-0-1060" name="__codelineno-0-1060"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1061"><a id="__codelineno-0-1061" name="__codelineno-0-1061"></a><span class="sd">                    model=Participant,</span>
-</span><span id="__span-0-1062"><a id="__codelineno-0-1062" name="__codelineno-0-1062"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1063"><a id="__codelineno-0-1063" name="__codelineno-0-1063"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1064"><a id="__codelineno-0-1064" name="__codelineno-0-1064"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1065"><a id="__codelineno-0-1065" name="__codelineno-0-1065"></a><span class="sd">            ]</span>
-</span><span id="__span-0-1066"><a id="__codelineno-0-1066" name="__codelineno-0-1066"></a><span class="sd">            count = await crud.count(db, joins_config=joins_config)</span>
-</span><span id="__span-0-1067"><a id="__codelineno-0-1067" name="__codelineno-0-1067"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1068"><a id="__codelineno-0-1068" name="__codelineno-0-1068"></a>
-</span><span id="__span-0-1069"><a id="__codelineno-0-1069" name="__codelineno-0-1069"></a><span class="sd">            Count projects by a specific participant name (filter applied on a joined model):</span>
-</span><span id="__span-0-1070"><a id="__codelineno-0-1070" name="__codelineno-0-1070"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1071"><a id="__codelineno-0-1071" name="__codelineno-0-1071"></a><span class="sd">            joins_config = [</span>
-</span><span id="__span-0-1072"><a id="__codelineno-0-1072" name="__codelineno-0-1072"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1073"><a id="__codelineno-0-1073" name="__codelineno-0-1073"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1074"><a id="__codelineno-0-1074" name="__codelineno-0-1074"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1075"><a id="__codelineno-0-1075" name="__codelineno-0-1075"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1076"><a id="__codelineno-0-1076" name="__codelineno-0-1076"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1077"><a id="__codelineno-0-1077" name="__codelineno-0-1077"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1078"><a id="__codelineno-0-1078" name="__codelineno-0-1078"></a><span class="sd">                    model=Participant,</span>
-</span><span id="__span-0-1079"><a id="__codelineno-0-1079" name="__codelineno-0-1079"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1080"><a id="__codelineno-0-1080" name="__codelineno-0-1080"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1081"><a id="__codelineno-0-1081" name="__codelineno-0-1081"></a><span class="sd">                    filters={&#39;name&#39;: &#39;Jane Doe&#39;},</span>
-</span><span id="__span-0-1082"><a id="__codelineno-0-1082" name="__codelineno-0-1082"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1083"><a id="__codelineno-0-1083" name="__codelineno-0-1083"></a><span class="sd">            ]</span>
-</span><span id="__span-0-1084"><a id="__codelineno-0-1084" name="__codelineno-0-1084"></a><span class="sd">            count = await crud.count(db, joins_config=joins_config)</span>
-</span><span id="__span-0-1085"><a id="__codelineno-0-1085" name="__codelineno-0-1085"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1086"><a id="__codelineno-0-1086" name="__codelineno-0-1086"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-1087"><a id="__codelineno-0-1087" name="__codelineno-0-1087"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1088"><a id="__codelineno-0-1088" name="__codelineno-0-1088"></a>
-</span><span id="__span-0-1089"><a id="__codelineno-0-1089" name="__codelineno-0-1089"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1090"><a id="__codelineno-0-1090" name="__codelineno-0-1090"></a>            <span class="n">primary_keys</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)]</span>
-</span><span id="__span-0-1091"><a id="__codelineno-0-1091" name="__codelineno-0-1091"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">primary_keys</span><span class="p">):</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-1092"><a id="__codelineno-0-1092" name="__codelineno-0-1092"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1093"><a id="__codelineno-0-1093" name="__codelineno-0-1093"></a>                    <span class="sa">f</span><span class="s2">&quot;The model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; does not have a primary key defined, which is required for counting with joins.&quot;</span>
-</span><span id="__span-0-1094"><a id="__codelineno-0-1094" name="__codelineno-0-1094"></a>                <span class="p">)</span>
-</span><span id="__span-0-1095"><a id="__codelineno-0-1095" name="__codelineno-0-1095"></a>            <span class="n">to_select</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-1096"><a id="__codelineno-0-1096" name="__codelineno-0-1096"></a>                <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">pk</span><span class="p">)</span><span class="o">.</span><span class="n">label</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;distinct_</span><span class="si">{</span><span class="n">pk</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="n">primary_keys</span>
-</span><span id="__span-0-1097"><a id="__codelineno-0-1097" name="__codelineno-0-1097"></a>            <span class="p">]</span>
-</span><span id="__span-0-1098"><a id="__codelineno-0-1098" name="__codelineno-0-1098"></a>            <span class="n">base_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span>
-</span><span id="__span-0-1099"><a id="__codelineno-0-1099" name="__codelineno-0-1099"></a>
-</span><span id="__span-0-1100"><a id="__codelineno-0-1100" name="__codelineno-0-1100"></a>            <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
-</span><span id="__span-0-1101"><a id="__codelineno-0-1101" name="__codelineno-0-1101"></a>                <span class="n">join_model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
-</span><span id="__span-0-1102"><a id="__codelineno-0-1102" name="__codelineno-0-1102"></a>                <span class="n">join_filters</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="__span-0-1103"><a id="__codelineno-0-1103" name="__codelineno-0-1103"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span> <span class="o">**</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-1104"><a id="__codelineno-0-1104" name="__codelineno-0-1104"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">filters</span>
-</span><span id="__span-0-1105"><a id="__codelineno-0-1105" name="__codelineno-0-1105"></a>                    <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1106"><a id="__codelineno-0-1106" name="__codelineno-0-1106"></a>                <span class="p">)</span>
-</span><span id="__span-0-1107"><a id="__codelineno-0-1107" name="__codelineno-0-1107"></a>
-</span><span id="__span-0-1108"><a id="__codelineno-0-1108" name="__codelineno-0-1108"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
-</span><span id="__span-0-1109"><a id="__codelineno-0-1109" name="__codelineno-0-1109"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
-</span><span id="__span-0-1110"><a id="__codelineno-0-1110" name="__codelineno-0-1110"></a>                <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1111"><a id="__codelineno-0-1111" name="__codelineno-0-1111"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
-</span><span id="__span-0-1112"><a id="__codelineno-0-1112" name="__codelineno-0-1112"></a>
-</span><span id="__span-0-1113"><a id="__codelineno-0-1113" name="__codelineno-0-1113"></a>                <span class="k">if</span> <span class="n">join_filters</span><span class="p">:</span>
-</span><span id="__span-0-1114"><a id="__codelineno-0-1114" name="__codelineno-0-1114"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">join_filters</span><span class="p">)</span>
-</span><span id="__span-0-1115"><a id="__codelineno-0-1115" name="__codelineno-0-1115"></a>
-</span><span id="__span-0-1116"><a id="__codelineno-0-1116" name="__codelineno-0-1116"></a>            <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1117"><a id="__codelineno-0-1117" name="__codelineno-0-1117"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1118"><a id="__codelineno-0-1118" name="__codelineno-0-1118"></a>
-</span><span id="__span-0-1119"><a id="__codelineno-0-1119" name="__codelineno-0-1119"></a>            <span class="n">subquery</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">subquery</span><span class="p">()</span>
-</span><span id="__span-0-1120"><a id="__codelineno-0-1120" name="__codelineno-0-1120"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="n">subquery</span><span class="p">)</span>
-</span><span id="__span-0-1121"><a id="__codelineno-0-1121" name="__codelineno-0-1121"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1122"><a id="__codelineno-0-1122" name="__codelineno-0-1122"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-1123"><a id="__codelineno-0-1123" name="__codelineno-0-1123"></a>            <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1124"><a id="__codelineno-0-1124" name="__codelineno-0-1124"></a>                <span class="n">count_query</span> <span class="o">=</span> <span class="n">count_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1052"><a id="__codelineno-0-1052" name="__codelineno-0-1052"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1053"><a id="__codelineno-0-1053" name="__codelineno-0-1053"></a><span class="sd">            count = await user_crud.count(db, age__gt=30)</span>
+</span><span id="__span-0-1054"><a id="__codelineno-0-1054" name="__codelineno-0-1054"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1055"><a id="__codelineno-0-1055" name="__codelineno-0-1055"></a>
+</span><span id="__span-0-1056"><a id="__codelineno-0-1056" name="__codelineno-0-1056"></a><span class="sd">            Count users with a username other than `admin`:</span>
+</span><span id="__span-0-1057"><a id="__codelineno-0-1057" name="__codelineno-0-1057"></a>
+</span><span id="__span-0-1058"><a id="__codelineno-0-1058" name="__codelineno-0-1058"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1059"><a id="__codelineno-0-1059" name="__codelineno-0-1059"></a><span class="sd">            count = await user_crud.count(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-1060"><a id="__codelineno-0-1060" name="__codelineno-0-1060"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1061"><a id="__codelineno-0-1061" name="__codelineno-0-1061"></a>
+</span><span id="__span-0-1062"><a id="__codelineno-0-1062" name="__codelineno-0-1062"></a><span class="sd">            Count projects with at least one participant (many-to-many relationship):</span>
+</span><span id="__span-0-1063"><a id="__codelineno-0-1063" name="__codelineno-0-1063"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1064"><a id="__codelineno-0-1064" name="__codelineno-0-1064"></a><span class="sd">            joins_config = [</span>
+</span><span id="__span-0-1065"><a id="__codelineno-0-1065" name="__codelineno-0-1065"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1066"><a id="__codelineno-0-1066" name="__codelineno-0-1066"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1067"><a id="__codelineno-0-1067" name="__codelineno-0-1067"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1068"><a id="__codelineno-0-1068" name="__codelineno-0-1068"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1069"><a id="__codelineno-0-1069" name="__codelineno-0-1069"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1070"><a id="__codelineno-0-1070" name="__codelineno-0-1070"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1071"><a id="__codelineno-0-1071" name="__codelineno-0-1071"></a><span class="sd">                    model=Participant,</span>
+</span><span id="__span-0-1072"><a id="__codelineno-0-1072" name="__codelineno-0-1072"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1073"><a id="__codelineno-0-1073" name="__codelineno-0-1073"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1074"><a id="__codelineno-0-1074" name="__codelineno-0-1074"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1075"><a id="__codelineno-0-1075" name="__codelineno-0-1075"></a><span class="sd">            ]</span>
+</span><span id="__span-0-1076"><a id="__codelineno-0-1076" name="__codelineno-0-1076"></a><span class="sd">            count = await crud.count(db, joins_config=joins_config)</span>
+</span><span id="__span-0-1077"><a id="__codelineno-0-1077" name="__codelineno-0-1077"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1078"><a id="__codelineno-0-1078" name="__codelineno-0-1078"></a>
+</span><span id="__span-0-1079"><a id="__codelineno-0-1079" name="__codelineno-0-1079"></a><span class="sd">            Count projects by a specific participant name (filter applied on a joined model):</span>
+</span><span id="__span-0-1080"><a id="__codelineno-0-1080" name="__codelineno-0-1080"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1081"><a id="__codelineno-0-1081" name="__codelineno-0-1081"></a><span class="sd">            joins_config = [</span>
+</span><span id="__span-0-1082"><a id="__codelineno-0-1082" name="__codelineno-0-1082"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1083"><a id="__codelineno-0-1083" name="__codelineno-0-1083"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1084"><a id="__codelineno-0-1084" name="__codelineno-0-1084"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1085"><a id="__codelineno-0-1085" name="__codelineno-0-1085"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1086"><a id="__codelineno-0-1086" name="__codelineno-0-1086"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1087"><a id="__codelineno-0-1087" name="__codelineno-0-1087"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1088"><a id="__codelineno-0-1088" name="__codelineno-0-1088"></a><span class="sd">                    model=Participant,</span>
+</span><span id="__span-0-1089"><a id="__codelineno-0-1089" name="__codelineno-0-1089"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1090"><a id="__codelineno-0-1090" name="__codelineno-0-1090"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1091"><a id="__codelineno-0-1091" name="__codelineno-0-1091"></a><span class="sd">                    filters={&#39;name&#39;: &#39;Jane Doe&#39;},</span>
+</span><span id="__span-0-1092"><a id="__codelineno-0-1092" name="__codelineno-0-1092"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1093"><a id="__codelineno-0-1093" name="__codelineno-0-1093"></a><span class="sd">            ]</span>
+</span><span id="__span-0-1094"><a id="__codelineno-0-1094" name="__codelineno-0-1094"></a><span class="sd">            count = await crud.count(db, joins_config=joins_config)</span>
+</span><span id="__span-0-1095"><a id="__codelineno-0-1095" name="__codelineno-0-1095"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1096"><a id="__codelineno-0-1096" name="__codelineno-0-1096"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-1097"><a id="__codelineno-0-1097" name="__codelineno-0-1097"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1098"><a id="__codelineno-0-1098" name="__codelineno-0-1098"></a>
+</span><span id="__span-0-1099"><a id="__codelineno-0-1099" name="__codelineno-0-1099"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1100"><a id="__codelineno-0-1100" name="__codelineno-0-1100"></a>            <span class="n">primary_keys</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)]</span>
+</span><span id="__span-0-1101"><a id="__codelineno-0-1101" name="__codelineno-0-1101"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">primary_keys</span><span class="p">):</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1102"><a id="__codelineno-0-1102" name="__codelineno-0-1102"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1103"><a id="__codelineno-0-1103" name="__codelineno-0-1103"></a>                    <span class="sa">f</span><span class="s2">&quot;The model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; does not have a primary key defined, which is required for counting with joins.&quot;</span>
+</span><span id="__span-0-1104"><a id="__codelineno-0-1104" name="__codelineno-0-1104"></a>                <span class="p">)</span>
+</span><span id="__span-0-1105"><a id="__codelineno-0-1105" name="__codelineno-0-1105"></a>            <span class="n">to_select</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-1106"><a id="__codelineno-0-1106" name="__codelineno-0-1106"></a>                <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">pk</span><span class="p">)</span><span class="o">.</span><span class="n">label</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;distinct_</span><span class="si">{</span><span class="n">pk</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="n">primary_keys</span>
+</span><span id="__span-0-1107"><a id="__codelineno-0-1107" name="__codelineno-0-1107"></a>            <span class="p">]</span>
+</span><span id="__span-0-1108"><a id="__codelineno-0-1108" name="__codelineno-0-1108"></a>            <span class="n">base_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span>
+</span><span id="__span-0-1109"><a id="__codelineno-0-1109" name="__codelineno-0-1109"></a>
+</span><span id="__span-0-1110"><a id="__codelineno-0-1110" name="__codelineno-0-1110"></a>            <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
+</span><span id="__span-0-1111"><a id="__codelineno-0-1111" name="__codelineno-0-1111"></a>                <span class="n">join_model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
+</span><span id="__span-0-1112"><a id="__codelineno-0-1112" name="__codelineno-0-1112"></a>                <span class="n">join_filters</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="__span-0-1113"><a id="__codelineno-0-1113" name="__codelineno-0-1113"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span> <span class="o">**</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-1114"><a id="__codelineno-0-1114" name="__codelineno-0-1114"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">filters</span>
+</span><span id="__span-0-1115"><a id="__codelineno-0-1115" name="__codelineno-0-1115"></a>                    <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1116"><a id="__codelineno-0-1116" name="__codelineno-0-1116"></a>                <span class="p">)</span>
+</span><span id="__span-0-1117"><a id="__codelineno-0-1117" name="__codelineno-0-1117"></a>
+</span><span id="__span-0-1118"><a id="__codelineno-0-1118" name="__codelineno-0-1118"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
+</span><span id="__span-0-1119"><a id="__codelineno-0-1119" name="__codelineno-0-1119"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
+</span><span id="__span-0-1120"><a id="__codelineno-0-1120" name="__codelineno-0-1120"></a>                <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1121"><a id="__codelineno-0-1121" name="__codelineno-0-1121"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
+</span><span id="__span-0-1122"><a id="__codelineno-0-1122" name="__codelineno-0-1122"></a>
+</span><span id="__span-0-1123"><a id="__codelineno-0-1123" name="__codelineno-0-1123"></a>                <span class="k">if</span> <span class="n">join_filters</span><span class="p">:</span>
+</span><span id="__span-0-1124"><a id="__codelineno-0-1124" name="__codelineno-0-1124"></a>                    <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">join_filters</span><span class="p">)</span>
 </span><span id="__span-0-1125"><a id="__codelineno-0-1125" name="__codelineno-0-1125"></a>
-</span><span id="__span-0-1126"><a id="__codelineno-0-1126" name="__codelineno-0-1126"></a>        <span class="n">total_count</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">scalar</span><span class="p">(</span><span class="n">count_query</span><span class="p">)</span>
-</span><span id="__span-0-1127"><a id="__codelineno-0-1127" name="__codelineno-0-1127"></a>        <span class="k">if</span> <span class="n">total_count</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1128"><a id="__codelineno-0-1128" name="__codelineno-0-1128"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Could not find the count.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1129"><a id="__codelineno-0-1129" name="__codelineno-0-1129"></a>
-</span><span id="__span-0-1130"><a id="__codelineno-0-1130" name="__codelineno-0-1130"></a>        <span class="k">return</span> <span class="n">total_count</span>
-</span><span id="__span-0-1131"><a id="__codelineno-0-1131" name="__codelineno-0-1131"></a>
-</span><span id="__span-0-1132"><a id="__codelineno-0-1132" name="__codelineno-0-1132"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi</span><span class="p">(</span>
-</span><span id="__span-0-1133"><a id="__codelineno-0-1133" name="__codelineno-0-1133"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1134"><a id="__codelineno-0-1134" name="__codelineno-0-1134"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1135"><a id="__codelineno-0-1135" name="__codelineno-0-1135"></a>        <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
-</span><span id="__span-0-1136"><a id="__codelineno-0-1136" name="__codelineno-0-1136"></a>        <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-1137"><a id="__codelineno-0-1137" name="__codelineno-0-1137"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1138"><a id="__codelineno-0-1138" name="__codelineno-0-1138"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1139"><a id="__codelineno-0-1139" name="__codelineno-0-1139"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1140"><a id="__codelineno-0-1140" name="__codelineno-0-1140"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1141"><a id="__codelineno-0-1141" name="__codelineno-0-1141"></a>        <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-1142"><a id="__codelineno-0-1142" name="__codelineno-0-1142"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1143"><a id="__codelineno-0-1143" name="__codelineno-0-1143"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-1144"><a id="__codelineno-0-1144" name="__codelineno-0-1144"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1145"><a id="__codelineno-0-1145" name="__codelineno-0-1145"></a><span class="sd">        Fetches multiple records based on filters, supporting sorting, pagination.</span>
-</span><span id="__span-0-1146"><a id="__codelineno-0-1146" name="__codelineno-0-1146"></a>
-</span><span id="__span-0-1147"><a id="__codelineno-0-1147" name="__codelineno-0-1147"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1148"><a id="__codelineno-0-1148" name="__codelineno-0-1148"></a>
-</span><span id="__span-0-1149"><a id="__codelineno-0-1149" name="__codelineno-0-1149"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-1150"><a id="__codelineno-0-1150" name="__codelineno-0-1150"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-1151"><a id="__codelineno-0-1151" name="__codelineno-0-1151"></a><span class="sd">            offset: Starting index for records to fetch, useful for pagination.</span>
-</span><span id="__span-0-1152"><a id="__codelineno-0-1152" name="__codelineno-0-1152"></a><span class="sd">            limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
-</span><span id="__span-0-1153"><a id="__codelineno-0-1153" name="__codelineno-0-1153"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1154"><a id="__codelineno-0-1154" name="__codelineno-0-1154"></a><span class="sd">            sort_columns: Column names to sort the results by.</span>
-</span><span id="__span-0-1155"><a id="__codelineno-0-1155" name="__codelineno-0-1155"></a><span class="sd">            sort_orders: Corresponding sort orders (`&quot;asc&quot;`, `&quot;desc&quot;`) for each column in `sort_columns`.</span>
-</span><span id="__span-0-1156"><a id="__codelineno-0-1156" name="__codelineno-0-1156"></a><span class="sd">            return_as_model: If `True`, returns data as instances of the specified Pydantic model.</span>
-</span><span id="__span-0-1157"><a id="__codelineno-0-1157" name="__codelineno-0-1157"></a><span class="sd">            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
-</span><span id="__span-0-1158"><a id="__codelineno-0-1158" name="__codelineno-0-1158"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
-</span><span id="__span-0-1159"><a id="__codelineno-0-1159" name="__codelineno-0-1159"></a>
-</span><span id="__span-0-1160"><a id="__codelineno-0-1160" name="__codelineno-0-1160"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-1161"><a id="__codelineno-0-1161" name="__codelineno-0-1161"></a><span class="sd">            A dictionary containing `&quot;data&quot;` with fetched records and `&quot;total_count&quot;` indicating the total number of records matching the filters.</span>
-</span><span id="__span-0-1162"><a id="__codelineno-0-1162" name="__codelineno-0-1162"></a>
-</span><span id="__span-0-1163"><a id="__codelineno-0-1163" name="__codelineno-0-1163"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-1164"><a id="__codelineno-0-1164" name="__codelineno-0-1164"></a><span class="sd">            ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.</span>
-</span><span id="__span-0-1165"><a id="__codelineno-0-1165" name="__codelineno-0-1165"></a>
-</span><span id="__span-0-1166"><a id="__codelineno-0-1166" name="__codelineno-0-1166"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-1167"><a id="__codelineno-0-1167" name="__codelineno-0-1167"></a><span class="sd">            Fetch the first 10 users:</span>
-</span><span id="__span-0-1168"><a id="__codelineno-0-1168" name="__codelineno-0-1168"></a>
-</span><span id="__span-0-1169"><a id="__codelineno-0-1169" name="__codelineno-0-1169"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1170"><a id="__codelineno-0-1170" name="__codelineno-0-1170"></a><span class="sd">            users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1171"><a id="__codelineno-0-1171" name="__codelineno-0-1171"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1172"><a id="__codelineno-0-1172" name="__codelineno-0-1172"></a><span class="sd">                0,</span>
-</span><span id="__span-0-1173"><a id="__codelineno-0-1173" name="__codelineno-0-1173"></a><span class="sd">                10,</span>
-</span><span id="__span-0-1174"><a id="__codelineno-0-1174" name="__codelineno-0-1174"></a><span class="sd">            )</span>
-</span><span id="__span-0-1175"><a id="__codelineno-0-1175" name="__codelineno-0-1175"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1176"><a id="__codelineno-0-1176" name="__codelineno-0-1176"></a>
-</span><span id="__span-0-1177"><a id="__codelineno-0-1177" name="__codelineno-0-1177"></a><span class="sd">            Fetch next 10 users with sorted by username:</span>
+</span><span id="__span-0-1126"><a id="__codelineno-0-1126" name="__codelineno-0-1126"></a>            <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1127"><a id="__codelineno-0-1127" name="__codelineno-0-1127"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1128"><a id="__codelineno-0-1128" name="__codelineno-0-1128"></a>
+</span><span id="__span-0-1129"><a id="__codelineno-0-1129" name="__codelineno-0-1129"></a>            <span class="n">subquery</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">subquery</span><span class="p">()</span>
+</span><span id="__span-0-1130"><a id="__codelineno-0-1130" name="__codelineno-0-1130"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="n">subquery</span><span class="p">)</span>
+</span><span id="__span-0-1131"><a id="__codelineno-0-1131" name="__codelineno-0-1131"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1132"><a id="__codelineno-0-1132" name="__codelineno-0-1132"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-1133"><a id="__codelineno-0-1133" name="__codelineno-0-1133"></a>            <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1134"><a id="__codelineno-0-1134" name="__codelineno-0-1134"></a>                <span class="n">count_query</span> <span class="o">=</span> <span class="n">count_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1135"><a id="__codelineno-0-1135" name="__codelineno-0-1135"></a>
+</span><span id="__span-0-1136"><a id="__codelineno-0-1136" name="__codelineno-0-1136"></a>        <span class="n">total_count</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">scalar</span><span class="p">(</span><span class="n">count_query</span><span class="p">)</span>
+</span><span id="__span-0-1137"><a id="__codelineno-0-1137" name="__codelineno-0-1137"></a>        <span class="k">if</span> <span class="n">total_count</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1138"><a id="__codelineno-0-1138" name="__codelineno-0-1138"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Could not find the count.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1139"><a id="__codelineno-0-1139" name="__codelineno-0-1139"></a>
+</span><span id="__span-0-1140"><a id="__codelineno-0-1140" name="__codelineno-0-1140"></a>        <span class="k">return</span> <span class="n">total_count</span>
+</span><span id="__span-0-1141"><a id="__codelineno-0-1141" name="__codelineno-0-1141"></a>
+</span><span id="__span-0-1142"><a id="__codelineno-0-1142" name="__codelineno-0-1142"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi</span><span class="p">(</span>
+</span><span id="__span-0-1143"><a id="__codelineno-0-1143" name="__codelineno-0-1143"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1144"><a id="__codelineno-0-1144" name="__codelineno-0-1144"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1145"><a id="__codelineno-0-1145" name="__codelineno-0-1145"></a>        <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+</span><span id="__span-0-1146"><a id="__codelineno-0-1146" name="__codelineno-0-1146"></a>        <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-1147"><a id="__codelineno-0-1147" name="__codelineno-0-1147"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1148"><a id="__codelineno-0-1148" name="__codelineno-0-1148"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1149"><a id="__codelineno-0-1149" name="__codelineno-0-1149"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1150"><a id="__codelineno-0-1150" name="__codelineno-0-1150"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1151"><a id="__codelineno-0-1151" name="__codelineno-0-1151"></a>        <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-1152"><a id="__codelineno-0-1152" name="__codelineno-0-1152"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1153"><a id="__codelineno-0-1153" name="__codelineno-0-1153"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">GetMultiResponseModel</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">],</span> <span class="n">GetMultiResponseDict</span><span class="p">]:</span>
+</span><span id="__span-0-1154"><a id="__codelineno-0-1154" name="__codelineno-0-1154"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1155"><a id="__codelineno-0-1155" name="__codelineno-0-1155"></a><span class="sd">        Fetches multiple records based on filters, supporting sorting, pagination.</span>
+</span><span id="__span-0-1156"><a id="__codelineno-0-1156" name="__codelineno-0-1156"></a>
+</span><span id="__span-0-1157"><a id="__codelineno-0-1157" name="__codelineno-0-1157"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1158"><a id="__codelineno-0-1158" name="__codelineno-0-1158"></a>
+</span><span id="__span-0-1159"><a id="__codelineno-0-1159" name="__codelineno-0-1159"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-1160"><a id="__codelineno-0-1160" name="__codelineno-0-1160"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-1161"><a id="__codelineno-0-1161" name="__codelineno-0-1161"></a><span class="sd">            offset: Starting index for records to fetch, useful for pagination.</span>
+</span><span id="__span-0-1162"><a id="__codelineno-0-1162" name="__codelineno-0-1162"></a><span class="sd">            limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
+</span><span id="__span-0-1163"><a id="__codelineno-0-1163" name="__codelineno-0-1163"></a><span class="sd">            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1164"><a id="__codelineno-0-1164" name="__codelineno-0-1164"></a><span class="sd">            sort_columns: Column names to sort the results by.</span>
+</span><span id="__span-0-1165"><a id="__codelineno-0-1165" name="__codelineno-0-1165"></a><span class="sd">            sort_orders: Corresponding sort orders (`&quot;asc&quot;`, `&quot;desc&quot;`) for each column in `sort_columns`.</span>
+</span><span id="__span-0-1166"><a id="__codelineno-0-1166" name="__codelineno-0-1166"></a><span class="sd">            return_as_model: If `True`, returns data as instances of the specified Pydantic model.</span>
+</span><span id="__span-0-1167"><a id="__codelineno-0-1167" name="__codelineno-0-1167"></a><span class="sd">            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
+</span><span id="__span-0-1168"><a id="__codelineno-0-1168" name="__codelineno-0-1168"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
+</span><span id="__span-0-1169"><a id="__codelineno-0-1169" name="__codelineno-0-1169"></a>
+</span><span id="__span-0-1170"><a id="__codelineno-0-1170" name="__codelineno-0-1170"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-1171"><a id="__codelineno-0-1171" name="__codelineno-0-1171"></a><span class="sd">            A dictionary containing the data list and optionally the total count:</span>
+</span><span id="__span-0-1172"><a id="__codelineno-0-1172" name="__codelineno-0-1172"></a><span class="sd">            - With return_as_model=True: Dict with &quot;data&quot;: List[SelectSchemaType]</span>
+</span><span id="__span-0-1173"><a id="__codelineno-0-1173" name="__codelineno-0-1173"></a><span class="sd">            - With return_as_model=False: Dict with &quot;data&quot;: List[Dict[str, Any]]</span>
+</span><span id="__span-0-1174"><a id="__codelineno-0-1174" name="__codelineno-0-1174"></a><span class="sd">            - If return_total_count=True, includes &quot;total_count&quot;: int</span>
+</span><span id="__span-0-1175"><a id="__codelineno-0-1175" name="__codelineno-0-1175"></a>
+</span><span id="__span-0-1176"><a id="__codelineno-0-1176" name="__codelineno-0-1176"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-1177"><a id="__codelineno-0-1177" name="__codelineno-0-1177"></a><span class="sd">            ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.</span>
 </span><span id="__span-0-1178"><a id="__codelineno-0-1178" name="__codelineno-0-1178"></a>
-</span><span id="__span-0-1179"><a id="__codelineno-0-1179" name="__codelineno-0-1179"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1180"><a id="__codelineno-0-1180" name="__codelineno-0-1180"></a><span class="sd">            users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1181"><a id="__codelineno-0-1181" name="__codelineno-0-1181"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1182"><a id="__codelineno-0-1182" name="__codelineno-0-1182"></a><span class="sd">                10,</span>
-</span><span id="__span-0-1183"><a id="__codelineno-0-1183" name="__codelineno-0-1183"></a><span class="sd">                10,</span>
-</span><span id="__span-0-1184"><a id="__codelineno-0-1184" name="__codelineno-0-1184"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1185"><a id="__codelineno-0-1185" name="__codelineno-0-1185"></a><span class="sd">                sort_orders=&#39;desc&#39;,</span>
-</span><span id="__span-0-1186"><a id="__codelineno-0-1186" name="__codelineno-0-1186"></a><span class="sd">            )</span>
-</span><span id="__span-0-1187"><a id="__codelineno-0-1187" name="__codelineno-0-1187"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1188"><a id="__codelineno-0-1188" name="__codelineno-0-1188"></a>
-</span><span id="__span-0-1189"><a id="__codelineno-0-1189" name="__codelineno-0-1189"></a><span class="sd">            Fetch 10 users older than 30, sorted by age in descending order:</span>
-</span><span id="__span-0-1190"><a id="__codelineno-0-1190" name="__codelineno-0-1190"></a>
-</span><span id="__span-0-1191"><a id="__codelineno-0-1191" name="__codelineno-0-1191"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1192"><a id="__codelineno-0-1192" name="__codelineno-0-1192"></a><span class="sd">            users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1193"><a id="__codelineno-0-1193" name="__codelineno-0-1193"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1194"><a id="__codelineno-0-1194" name="__codelineno-0-1194"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1195"><a id="__codelineno-0-1195" name="__codelineno-0-1195"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1196"><a id="__codelineno-0-1196" name="__codelineno-0-1196"></a><span class="sd">                sort_columns=&#39;age&#39;,</span>
-</span><span id="__span-0-1197"><a id="__codelineno-0-1197" name="__codelineno-0-1197"></a><span class="sd">                sort_orders=&#39;desc&#39;,</span>
-</span><span id="__span-0-1198"><a id="__codelineno-0-1198" name="__codelineno-0-1198"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-1179"><a id="__codelineno-0-1179" name="__codelineno-0-1179"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-1180"><a id="__codelineno-0-1180" name="__codelineno-0-1180"></a><span class="sd">            Fetch the first 10 users:</span>
+</span><span id="__span-0-1181"><a id="__codelineno-0-1181" name="__codelineno-0-1181"></a>
+</span><span id="__span-0-1182"><a id="__codelineno-0-1182" name="__codelineno-0-1182"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1183"><a id="__codelineno-0-1183" name="__codelineno-0-1183"></a><span class="sd">            users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1184"><a id="__codelineno-0-1184" name="__codelineno-0-1184"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1185"><a id="__codelineno-0-1185" name="__codelineno-0-1185"></a><span class="sd">                0,</span>
+</span><span id="__span-0-1186"><a id="__codelineno-0-1186" name="__codelineno-0-1186"></a><span class="sd">                10,</span>
+</span><span id="__span-0-1187"><a id="__codelineno-0-1187" name="__codelineno-0-1187"></a><span class="sd">            )</span>
+</span><span id="__span-0-1188"><a id="__codelineno-0-1188" name="__codelineno-0-1188"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1189"><a id="__codelineno-0-1189" name="__codelineno-0-1189"></a>
+</span><span id="__span-0-1190"><a id="__codelineno-0-1190" name="__codelineno-0-1190"></a><span class="sd">            Fetch next 10 users with sorted by username:</span>
+</span><span id="__span-0-1191"><a id="__codelineno-0-1191" name="__codelineno-0-1191"></a>
+</span><span id="__span-0-1192"><a id="__codelineno-0-1192" name="__codelineno-0-1192"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1193"><a id="__codelineno-0-1193" name="__codelineno-0-1193"></a><span class="sd">            users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1194"><a id="__codelineno-0-1194" name="__codelineno-0-1194"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1195"><a id="__codelineno-0-1195" name="__codelineno-0-1195"></a><span class="sd">                10,</span>
+</span><span id="__span-0-1196"><a id="__codelineno-0-1196" name="__codelineno-0-1196"></a><span class="sd">                10,</span>
+</span><span id="__span-0-1197"><a id="__codelineno-0-1197" name="__codelineno-0-1197"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1198"><a id="__codelineno-0-1198" name="__codelineno-0-1198"></a><span class="sd">                sort_orders=&#39;desc&#39;,</span>
 </span><span id="__span-0-1199"><a id="__codelineno-0-1199" name="__codelineno-0-1199"></a><span class="sd">            )</span>
 </span><span id="__span-0-1200"><a id="__codelineno-0-1200" name="__codelineno-0-1200"></a><span class="sd">            ```</span>
 </span><span id="__span-0-1201"><a id="__codelineno-0-1201" name="__codelineno-0-1201"></a>
-</span><span id="__span-0-1202"><a id="__codelineno-0-1202" name="__codelineno-0-1202"></a><span class="sd">            Fetch 10 users with a registration date before Jan 1, 2020:</span>
-</span><span id="__span-0-1203"><a id="__codelineno-0-1203" name="__codelineno-0-1203"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1204"><a id="__codelineno-0-1204" name="__codelineno-0-1204"></a><span class="sd">            users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1205"><a id="__codelineno-0-1205" name="__codelineno-0-1205"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1206"><a id="__codelineno-0-1206" name="__codelineno-0-1206"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1207"><a id="__codelineno-0-1207" name="__codelineno-0-1207"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1208"><a id="__codelineno-0-1208" name="__codelineno-0-1208"></a><span class="sd">                registration_date__lt=datetime(2020, 1, 1),</span>
-</span><span id="__span-0-1209"><a id="__codelineno-0-1209" name="__codelineno-0-1209"></a><span class="sd">            )</span>
-</span><span id="__span-0-1210"><a id="__codelineno-0-1210" name="__codelineno-0-1210"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1211"><a id="__codelineno-0-1211" name="__codelineno-0-1211"></a>
-</span><span id="__span-0-1212"><a id="__codelineno-0-1212" name="__codelineno-0-1212"></a><span class="sd">            Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):</span>
-</span><span id="__span-0-1213"><a id="__codelineno-0-1213" name="__codelineno-0-1213"></a>
-</span><span id="__span-0-1214"><a id="__codelineno-0-1214" name="__codelineno-0-1214"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1215"><a id="__codelineno-0-1215" name="__codelineno-0-1215"></a><span class="sd">            users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1216"><a id="__codelineno-0-1216" name="__codelineno-0-1216"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1217"><a id="__codelineno-0-1217" name="__codelineno-0-1217"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1218"><a id="__codelineno-0-1218" name="__codelineno-0-1218"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1219"><a id="__codelineno-0-1219" name="__codelineno-0-1219"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1220"><a id="__codelineno-0-1220" name="__codelineno-0-1220"></a><span class="sd">                return_as_model=True,</span>
-</span><span id="__span-0-1221"><a id="__codelineno-0-1221" name="__codelineno-0-1221"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1202"><a id="__codelineno-0-1202" name="__codelineno-0-1202"></a><span class="sd">            Fetch 10 users older than 30, sorted by age in descending order:</span>
+</span><span id="__span-0-1203"><a id="__codelineno-0-1203" name="__codelineno-0-1203"></a>
+</span><span id="__span-0-1204"><a id="__codelineno-0-1204" name="__codelineno-0-1204"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1205"><a id="__codelineno-0-1205" name="__codelineno-0-1205"></a><span class="sd">            users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1206"><a id="__codelineno-0-1206" name="__codelineno-0-1206"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1207"><a id="__codelineno-0-1207" name="__codelineno-0-1207"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1208"><a id="__codelineno-0-1208" name="__codelineno-0-1208"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1209"><a id="__codelineno-0-1209" name="__codelineno-0-1209"></a><span class="sd">                sort_columns=&#39;age&#39;,</span>
+</span><span id="__span-0-1210"><a id="__codelineno-0-1210" name="__codelineno-0-1210"></a><span class="sd">                sort_orders=&#39;desc&#39;,</span>
+</span><span id="__span-0-1211"><a id="__codelineno-0-1211" name="__codelineno-0-1211"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-1212"><a id="__codelineno-0-1212" name="__codelineno-0-1212"></a><span class="sd">            )</span>
+</span><span id="__span-0-1213"><a id="__codelineno-0-1213" name="__codelineno-0-1213"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1214"><a id="__codelineno-0-1214" name="__codelineno-0-1214"></a>
+</span><span id="__span-0-1215"><a id="__codelineno-0-1215" name="__codelineno-0-1215"></a><span class="sd">            Fetch 10 users with a registration date before Jan 1, 2020:</span>
+</span><span id="__span-0-1216"><a id="__codelineno-0-1216" name="__codelineno-0-1216"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1217"><a id="__codelineno-0-1217" name="__codelineno-0-1217"></a><span class="sd">            users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1218"><a id="__codelineno-0-1218" name="__codelineno-0-1218"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1219"><a id="__codelineno-0-1219" name="__codelineno-0-1219"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1220"><a id="__codelineno-0-1220" name="__codelineno-0-1220"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1221"><a id="__codelineno-0-1221" name="__codelineno-0-1221"></a><span class="sd">                registration_date__lt=datetime(2020, 1, 1),</span>
 </span><span id="__span-0-1222"><a id="__codelineno-0-1222" name="__codelineno-0-1222"></a><span class="sd">            )</span>
 </span><span id="__span-0-1223"><a id="__codelineno-0-1223" name="__codelineno-0-1223"></a><span class="sd">            ```</span>
 </span><span id="__span-0-1224"><a id="__codelineno-0-1224" name="__codelineno-0-1224"></a>
-</span><span id="__span-0-1225"><a id="__codelineno-0-1225" name="__codelineno-0-1225"></a><span class="sd">            Fetch users with filtering and multiple column sorting:</span>
+</span><span id="__span-0-1225"><a id="__codelineno-0-1225" name="__codelineno-0-1225"></a><span class="sd">            Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):</span>
 </span><span id="__span-0-1226"><a id="__codelineno-0-1226" name="__codelineno-0-1226"></a>
 </span><span id="__span-0-1227"><a id="__codelineno-0-1227" name="__codelineno-0-1227"></a><span class="sd">            ```python</span>
 </span><span id="__span-0-1228"><a id="__codelineno-0-1228" name="__codelineno-0-1228"></a><span class="sd">            users = await user_crud.get_multi(</span>
 </span><span id="__span-0-1229"><a id="__codelineno-0-1229" name="__codelineno-0-1229"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1230"><a id="__codelineno-0-1230" name="__codelineno-0-1230"></a><span class="sd">                0,</span>
-</span><span id="__span-0-1231"><a id="__codelineno-0-1231" name="__codelineno-0-1231"></a><span class="sd">                10,</span>
-</span><span id="__span-0-1232"><a id="__codelineno-0-1232" name="__codelineno-0-1232"></a><span class="sd">                sort_columns=[&#39;username&#39;, &#39;email&#39;],</span>
-</span><span id="__span-0-1233"><a id="__codelineno-0-1233" name="__codelineno-0-1233"></a><span class="sd">                sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
-</span><span id="__span-0-1234"><a id="__codelineno-0-1234" name="__codelineno-0-1234"></a><span class="sd">                is_active=True,</span>
+</span><span id="__span-0-1230"><a id="__codelineno-0-1230" name="__codelineno-0-1230"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1231"><a id="__codelineno-0-1231" name="__codelineno-0-1231"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1232"><a id="__codelineno-0-1232" name="__codelineno-0-1232"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1233"><a id="__codelineno-0-1233" name="__codelineno-0-1233"></a><span class="sd">                return_as_model=True,</span>
+</span><span id="__span-0-1234"><a id="__codelineno-0-1234" name="__codelineno-0-1234"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
 </span><span id="__span-0-1235"><a id="__codelineno-0-1235" name="__codelineno-0-1235"></a><span class="sd">            )</span>
 </span><span id="__span-0-1236"><a id="__codelineno-0-1236" name="__codelineno-0-1236"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1237"><a id="__codelineno-0-1237" name="__codelineno-0-1237"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-1238"><a id="__codelineno-0-1238" name="__codelineno-0-1238"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-1239"><a id="__codelineno-0-1239" name="__codelineno-0-1239"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1240"><a id="__codelineno-0-1240" name="__codelineno-0-1240"></a>
-</span><span id="__span-0-1241"><a id="__codelineno-0-1241" name="__codelineno-0-1241"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
-</span><span id="__span-0-1242"><a id="__codelineno-0-1242" name="__codelineno-0-1242"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1243"><a id="__codelineno-0-1243" name="__codelineno-0-1243"></a>            <span class="n">sort_columns</span><span class="o">=</span><span class="n">sort_columns</span><span class="p">,</span>
-</span><span id="__span-0-1244"><a id="__codelineno-0-1244" name="__codelineno-0-1244"></a>            <span class="n">sort_orders</span><span class="o">=</span><span class="n">sort_orders</span><span class="p">,</span>
-</span><span id="__span-0-1245"><a id="__codelineno-0-1245" name="__codelineno-0-1245"></a>            <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
-</span><span id="__span-0-1246"><a id="__codelineno-0-1246" name="__codelineno-0-1246"></a>        <span class="p">)</span>
-</span><span id="__span-0-1247"><a id="__codelineno-0-1247" name="__codelineno-0-1247"></a>
-</span><span id="__span-0-1248"><a id="__codelineno-0-1248" name="__codelineno-0-1248"></a>        <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
-</span><span id="__span-0-1249"><a id="__codelineno-0-1249" name="__codelineno-0-1249"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
-</span><span id="__span-0-1250"><a id="__codelineno-0-1250" name="__codelineno-0-1250"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1251"><a id="__codelineno-0-1251" name="__codelineno-0-1251"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-1252"><a id="__codelineno-0-1252" name="__codelineno-0-1252"></a>
-</span><span id="__span-0-1253"><a id="__codelineno-0-1253" name="__codelineno-0-1253"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1254"><a id="__codelineno-0-1254" name="__codelineno-0-1254"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
-</span><span id="__span-0-1255"><a id="__codelineno-0-1255" name="__codelineno-0-1255"></a>
-</span><span id="__span-0-1256"><a id="__codelineno-0-1256" name="__codelineno-0-1256"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
-</span><span id="__span-0-1257"><a id="__codelineno-0-1257" name="__codelineno-0-1257"></a>
-</span><span id="__span-0-1258"><a id="__codelineno-0-1258" name="__codelineno-0-1258"></a>        <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
-</span><span id="__span-0-1259"><a id="__codelineno-0-1259" name="__codelineno-0-1259"></a>            <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1260"><a id="__codelineno-0-1260" name="__codelineno-0-1260"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
-</span><span id="__span-0-1261"><a id="__codelineno-0-1261" name="__codelineno-0-1261"></a>
-</span><span id="__span-0-1262"><a id="__codelineno-0-1262" name="__codelineno-0-1262"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-1263"><a id="__codelineno-0-1263" name="__codelineno-0-1263"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
-</span><span id="__span-0-1264"><a id="__codelineno-0-1264" name="__codelineno-0-1264"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1265"><a id="__codelineno-0-1265" name="__codelineno-0-1265"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-1266"><a id="__codelineno-0-1266" name="__codelineno-0-1266"></a>                <span class="p">)</span>
-</span><span id="__span-0-1267"><a id="__codelineno-0-1267" name="__codelineno-0-1267"></a>            <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-1268"><a id="__codelineno-0-1268" name="__codelineno-0-1268"></a>                <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
-</span><span id="__span-0-1269"><a id="__codelineno-0-1269" name="__codelineno-0-1269"></a>                <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
-</span><span id="__span-0-1270"><a id="__codelineno-0-1270" name="__codelineno-0-1270"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-1271"><a id="__codelineno-0-1271" name="__codelineno-0-1271"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1272"><a id="__codelineno-0-1272" name="__codelineno-0-1272"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-1273"><a id="__codelineno-0-1273" name="__codelineno-0-1273"></a>                <span class="p">)</span>
+</span><span id="__span-0-1237"><a id="__codelineno-0-1237" name="__codelineno-0-1237"></a>
+</span><span id="__span-0-1238"><a id="__codelineno-0-1238" name="__codelineno-0-1238"></a><span class="sd">            Fetch users with filtering and multiple column sorting:</span>
+</span><span id="__span-0-1239"><a id="__codelineno-0-1239" name="__codelineno-0-1239"></a>
+</span><span id="__span-0-1240"><a id="__codelineno-0-1240" name="__codelineno-0-1240"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1241"><a id="__codelineno-0-1241" name="__codelineno-0-1241"></a><span class="sd">            users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1242"><a id="__codelineno-0-1242" name="__codelineno-0-1242"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1243"><a id="__codelineno-0-1243" name="__codelineno-0-1243"></a><span class="sd">                0,</span>
+</span><span id="__span-0-1244"><a id="__codelineno-0-1244" name="__codelineno-0-1244"></a><span class="sd">                10,</span>
+</span><span id="__span-0-1245"><a id="__codelineno-0-1245" name="__codelineno-0-1245"></a><span class="sd">                sort_columns=[&#39;username&#39;, &#39;email&#39;],</span>
+</span><span id="__span-0-1246"><a id="__codelineno-0-1246" name="__codelineno-0-1246"></a><span class="sd">                sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
+</span><span id="__span-0-1247"><a id="__codelineno-0-1247" name="__codelineno-0-1247"></a><span class="sd">                is_active=True,</span>
+</span><span id="__span-0-1248"><a id="__codelineno-0-1248" name="__codelineno-0-1248"></a><span class="sd">            )</span>
+</span><span id="__span-0-1249"><a id="__codelineno-0-1249" name="__codelineno-0-1249"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1250"><a id="__codelineno-0-1250" name="__codelineno-0-1250"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-1251"><a id="__codelineno-0-1251" name="__codelineno-0-1251"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-1252"><a id="__codelineno-0-1252" name="__codelineno-0-1252"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1253"><a id="__codelineno-0-1253" name="__codelineno-0-1253"></a>
+</span><span id="__span-0-1254"><a id="__codelineno-0-1254" name="__codelineno-0-1254"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
+</span><span id="__span-0-1255"><a id="__codelineno-0-1255" name="__codelineno-0-1255"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1256"><a id="__codelineno-0-1256" name="__codelineno-0-1256"></a>            <span class="n">sort_columns</span><span class="o">=</span><span class="n">sort_columns</span><span class="p">,</span>
+</span><span id="__span-0-1257"><a id="__codelineno-0-1257" name="__codelineno-0-1257"></a>            <span class="n">sort_orders</span><span class="o">=</span><span class="n">sort_orders</span><span class="p">,</span>
+</span><span id="__span-0-1258"><a id="__codelineno-0-1258" name="__codelineno-0-1258"></a>            <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
+</span><span id="__span-0-1259"><a id="__codelineno-0-1259" name="__codelineno-0-1259"></a>        <span class="p">)</span>
+</span><span id="__span-0-1260"><a id="__codelineno-0-1260" name="__codelineno-0-1260"></a>
+</span><span id="__span-0-1261"><a id="__codelineno-0-1261" name="__codelineno-0-1261"></a>        <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
+</span><span id="__span-0-1262"><a id="__codelineno-0-1262" name="__codelineno-0-1262"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
+</span><span id="__span-0-1263"><a id="__codelineno-0-1263" name="__codelineno-0-1263"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1264"><a id="__codelineno-0-1264" name="__codelineno-0-1264"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-1265"><a id="__codelineno-0-1265" name="__codelineno-0-1265"></a>
+</span><span id="__span-0-1266"><a id="__codelineno-0-1266" name="__codelineno-0-1266"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1267"><a id="__codelineno-0-1267" name="__codelineno-0-1267"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
+</span><span id="__span-0-1268"><a id="__codelineno-0-1268" name="__codelineno-0-1268"></a>
+</span><span id="__span-0-1269"><a id="__codelineno-0-1269" name="__codelineno-0-1269"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
+</span><span id="__span-0-1270"><a id="__codelineno-0-1270" name="__codelineno-0-1270"></a>
+</span><span id="__span-0-1271"><a id="__codelineno-0-1271" name="__codelineno-0-1271"></a>        <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
+</span><span id="__span-0-1272"><a id="__codelineno-0-1272" name="__codelineno-0-1272"></a>            <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1273"><a id="__codelineno-0-1273" name="__codelineno-0-1273"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
 </span><span id="__span-0-1274"><a id="__codelineno-0-1274" name="__codelineno-0-1274"></a>
-</span><span id="__span-0-1275"><a id="__codelineno-0-1275" name="__codelineno-0-1275"></a>        <span class="k">return</span> <span class="n">response</span>
-</span><span id="__span-0-1276"><a id="__codelineno-0-1276" name="__codelineno-0-1276"></a>
-</span><span id="__span-0-1277"><a id="__codelineno-0-1277" name="__codelineno-0-1277"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_joined</span><span class="p">(</span>
-</span><span id="__span-0-1278"><a id="__codelineno-0-1278" name="__codelineno-0-1278"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1279"><a id="__codelineno-0-1279" name="__codelineno-0-1279"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1280"><a id="__codelineno-0-1280" name="__codelineno-0-1280"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1281"><a id="__codelineno-0-1281" name="__codelineno-0-1281"></a>        <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1282"><a id="__codelineno-0-1282" name="__codelineno-0-1282"></a>        <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">Join</span><span class="p">,</span> <span class="n">BinaryExpression</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1283"><a id="__codelineno-0-1283" name="__codelineno-0-1283"></a>        <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1284"><a id="__codelineno-0-1284" name="__codelineno-0-1284"></a>        <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1285"><a id="__codelineno-0-1285" name="__codelineno-0-1285"></a>        <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
-</span><span id="__span-0-1286"><a id="__codelineno-0-1286" name="__codelineno-0-1286"></a>        <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1287"><a id="__codelineno-0-1287" name="__codelineno-0-1287"></a>        <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1288"><a id="__codelineno-0-1288" name="__codelineno-0-1288"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1289"><a id="__codelineno-0-1289" name="__codelineno-0-1289"></a>        <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1290"><a id="__codelineno-0-1290" name="__codelineno-0-1290"></a>        <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1291"><a id="__codelineno-0-1291" name="__codelineno-0-1291"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1292"><a id="__codelineno-0-1292" name="__codelineno-0-1292"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
-</span><span id="__span-0-1293"><a id="__codelineno-0-1293" name="__codelineno-0-1293"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1294"><a id="__codelineno-0-1294" name="__codelineno-0-1294"></a><span class="sd">        Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts</span>
-</span><span id="__span-0-1295"><a id="__codelineno-0-1295" name="__codelineno-0-1295"></a><span class="sd">        to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to</span>
-</span><span id="__span-0-1296"><a id="__codelineno-0-1296" name="__codelineno-0-1296"></a><span class="sd">        specify each join configuration.</span>
-</span><span id="__span-0-1297"><a id="__codelineno-0-1297" name="__codelineno-0-1297"></a>
-</span><span id="__span-0-1298"><a id="__codelineno-0-1298" name="__codelineno-0-1298"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1299"><a id="__codelineno-0-1299" name="__codelineno-0-1299"></a>
-</span><span id="__span-0-1300"><a id="__codelineno-0-1300" name="__codelineno-0-1300"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-1301"><a id="__codelineno-0-1301" name="__codelineno-0-1301"></a><span class="sd">            db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-1302"><a id="__codelineno-0-1302" name="__codelineno-0-1302"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1303"><a id="__codelineno-0-1303" name="__codelineno-0-1303"></a><span class="sd">            join_model: The model to join with.</span>
-</span><span id="__span-0-1304"><a id="__codelineno-0-1304" name="__codelineno-0-1304"></a><span class="sd">            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
-</span><span id="__span-0-1305"><a id="__codelineno-0-1305" name="__codelineno-0-1305"></a><span class="sd">            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
-</span><span id="__span-0-1306"><a id="__codelineno-0-1306" name="__codelineno-0-1306"></a><span class="sd">            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
-</span><span id="__span-0-1307"><a id="__codelineno-0-1307" name="__codelineno-0-1307"></a><span class="sd">            join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
-</span><span id="__span-0-1308"><a id="__codelineno-0-1308" name="__codelineno-0-1308"></a><span class="sd">            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
-</span><span id="__span-0-1309"><a id="__codelineno-0-1309" name="__codelineno-0-1309"></a><span class="sd">            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
-</span><span id="__span-0-1310"><a id="__codelineno-0-1310" name="__codelineno-0-1310"></a><span class="sd">            joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</span>
-</span><span id="__span-0-1311"><a id="__codelineno-0-1311" name="__codelineno-0-1311"></a><span class="sd">            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
-</span><span id="__span-0-1312"><a id="__codelineno-0-1312" name="__codelineno-0-1312"></a><span class="sd">            relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
-</span><span id="__span-0-1313"><a id="__codelineno-0-1313" name="__codelineno-0-1313"></a><span class="sd">            **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</span>
-</span><span id="__span-0-1314"><a id="__codelineno-0-1314" name="__codelineno-0-1314"></a>
-</span><span id="__span-0-1315"><a id="__codelineno-0-1315" name="__codelineno-0-1315"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-1316"><a id="__codelineno-0-1316" name="__codelineno-0-1316"></a><span class="sd">            A dictionary representing the joined record, or `None` if no record matches the criteria.</span>
-</span><span id="__span-0-1317"><a id="__codelineno-0-1317" name="__codelineno-0-1317"></a>
-</span><span id="__span-0-1318"><a id="__codelineno-0-1318" name="__codelineno-0-1318"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-1319"><a id="__codelineno-0-1319" name="__codelineno-0-1319"></a><span class="sd">            ValueError: If both single join parameters and `joins_config` are used simultaneously.</span>
-</span><span id="__span-0-1320"><a id="__codelineno-0-1320" name="__codelineno-0-1320"></a><span class="sd">            ArgumentError: If any provided model in `joins_config` is not recognized or invalid.</span>
-</span><span id="__span-0-1321"><a id="__codelineno-0-1321" name="__codelineno-0-1321"></a><span class="sd">            NoResultFound: If no record matches the criteria with the provided filters.</span>
-</span><span id="__span-0-1322"><a id="__codelineno-0-1322" name="__codelineno-0-1322"></a>
-</span><span id="__span-0-1323"><a id="__codelineno-0-1323" name="__codelineno-0-1323"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-1324"><a id="__codelineno-0-1324" name="__codelineno-0-1324"></a><span class="sd">            Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`</span>
-</span><span id="__span-0-1325"><a id="__codelineno-0-1325" name="__codelineno-0-1325"></a>
-</span><span id="__span-0-1326"><a id="__codelineno-0-1326" name="__codelineno-0-1326"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1327"><a id="__codelineno-0-1327" name="__codelineno-0-1327"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1328"><a id="__codelineno-0-1328" name="__codelineno-0-1328"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1329"><a id="__codelineno-0-1329" name="__codelineno-0-1329"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1330"><a id="__codelineno-0-1330" name="__codelineno-0-1330"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1331"><a id="__codelineno-0-1331" name="__codelineno-0-1331"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1332"><a id="__codelineno-0-1332" name="__codelineno-0-1332"></a><span class="sd">            )</span>
-</span><span id="__span-0-1333"><a id="__codelineno-0-1333" name="__codelineno-0-1333"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1334"><a id="__codelineno-0-1334" name="__codelineno-0-1334"></a>
-</span><span id="__span-0-1335"><a id="__codelineno-0-1335" name="__codelineno-0-1335"></a><span class="sd">            Fetch a user and their associated tier, filtering by user ID:</span>
-</span><span id="__span-0-1336"><a id="__codelineno-0-1336" name="__codelineno-0-1336"></a>
-</span><span id="__span-0-1337"><a id="__codelineno-0-1337" name="__codelineno-0-1337"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1338"><a id="__codelineno-0-1338" name="__codelineno-0-1338"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1339"><a id="__codelineno-0-1339" name="__codelineno-0-1339"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1340"><a id="__codelineno-0-1340" name="__codelineno-0-1340"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1341"><a id="__codelineno-0-1341" name="__codelineno-0-1341"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1342"><a id="__codelineno-0-1342" name="__codelineno-0-1342"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1343"><a id="__codelineno-0-1343" name="__codelineno-0-1343"></a><span class="sd">                id=1,</span>
-</span><span id="__span-0-1344"><a id="__codelineno-0-1344" name="__codelineno-0-1344"></a><span class="sd">            )</span>
-</span><span id="__span-0-1345"><a id="__codelineno-0-1345" name="__codelineno-0-1345"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1346"><a id="__codelineno-0-1346" name="__codelineno-0-1346"></a>
-</span><span id="__span-0-1347"><a id="__codelineno-0-1347" name="__codelineno-0-1347"></a><span class="sd">            Fetch a user and their associated tier, where the user&#39;s age is greater than 30:</span>
-</span><span id="__span-0-1348"><a id="__codelineno-0-1348" name="__codelineno-0-1348"></a>
-</span><span id="__span-0-1349"><a id="__codelineno-0-1349" name="__codelineno-0-1349"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1350"><a id="__codelineno-0-1350" name="__codelineno-0-1350"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1351"><a id="__codelineno-0-1351" name="__codelineno-0-1351"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1352"><a id="__codelineno-0-1352" name="__codelineno-0-1352"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1353"><a id="__codelineno-0-1353" name="__codelineno-0-1353"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1354"><a id="__codelineno-0-1354" name="__codelineno-0-1354"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1355"><a id="__codelineno-0-1355" name="__codelineno-0-1355"></a><span class="sd">                age__gt=30,</span>
-</span><span id="__span-0-1356"><a id="__codelineno-0-1356" name="__codelineno-0-1356"></a><span class="sd">            )</span>
-</span><span id="__span-0-1357"><a id="__codelineno-0-1357" name="__codelineno-0-1357"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1358"><a id="__codelineno-0-1358" name="__codelineno-0-1358"></a>
-</span><span id="__span-0-1359"><a id="__codelineno-0-1359" name="__codelineno-0-1359"></a><span class="sd">            Fetch a user and their associated tier, excluding users with the `admin` username:</span>
-</span><span id="__span-0-1360"><a id="__codelineno-0-1360" name="__codelineno-0-1360"></a>
-</span><span id="__span-0-1361"><a id="__codelineno-0-1361" name="__codelineno-0-1361"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1362"><a id="__codelineno-0-1362" name="__codelineno-0-1362"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1363"><a id="__codelineno-0-1363" name="__codelineno-0-1363"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1364"><a id="__codelineno-0-1364" name="__codelineno-0-1364"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1365"><a id="__codelineno-0-1365" name="__codelineno-0-1365"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1366"><a id="__codelineno-0-1366" name="__codelineno-0-1366"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1367"><a id="__codelineno-0-1367" name="__codelineno-0-1367"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
-</span><span id="__span-0-1368"><a id="__codelineno-0-1368" name="__codelineno-0-1368"></a><span class="sd">            )</span>
-</span><span id="__span-0-1369"><a id="__codelineno-0-1369" name="__codelineno-0-1369"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1370"><a id="__codelineno-0-1370" name="__codelineno-0-1370"></a>
-</span><span id="__span-0-1371"><a id="__codelineno-0-1371" name="__codelineno-0-1371"></a><span class="sd">            Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</span>
-</span><span id="__span-0-1372"><a id="__codelineno-0-1372" name="__codelineno-0-1372"></a>
-</span><span id="__span-0-1373"><a id="__codelineno-0-1373" name="__codelineno-0-1373"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1374"><a id="__codelineno-0-1374" name="__codelineno-0-1374"></a><span class="sd">            from sqlalchemy import and_</span>
+</span><span id="__span-0-1275"><a id="__codelineno-0-1275" name="__codelineno-0-1275"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-1276"><a id="__codelineno-0-1276" name="__codelineno-0-1276"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
+</span><span id="__span-0-1277"><a id="__codelineno-0-1277" name="__codelineno-0-1277"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1278"><a id="__codelineno-0-1278" name="__codelineno-0-1278"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-1279"><a id="__codelineno-0-1279" name="__codelineno-0-1279"></a>                <span class="p">)</span>
+</span><span id="__span-0-1280"><a id="__codelineno-0-1280" name="__codelineno-0-1280"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1281"><a id="__codelineno-0-1281" name="__codelineno-0-1281"></a>                <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
+</span><span id="__span-0-1282"><a id="__codelineno-0-1282" name="__codelineno-0-1282"></a>                <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
+</span><span id="__span-0-1283"><a id="__codelineno-0-1283" name="__codelineno-0-1283"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-1284"><a id="__codelineno-0-1284" name="__codelineno-0-1284"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1285"><a id="__codelineno-0-1285" name="__codelineno-0-1285"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-1286"><a id="__codelineno-0-1286" name="__codelineno-0-1286"></a>                <span class="p">)</span>
+</span><span id="__span-0-1287"><a id="__codelineno-0-1287" name="__codelineno-0-1287"></a>
+</span><span id="__span-0-1288"><a id="__codelineno-0-1288" name="__codelineno-0-1288"></a>        <span class="k">return</span> <span class="n">response</span>
+</span><span id="__span-0-1289"><a id="__codelineno-0-1289" name="__codelineno-0-1289"></a>
+</span><span id="__span-0-1290"><a id="__codelineno-0-1290" name="__codelineno-0-1290"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_joined</span><span class="p">(</span>
+</span><span id="__span-0-1291"><a id="__codelineno-0-1291" name="__codelineno-0-1291"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1292"><a id="__codelineno-0-1292" name="__codelineno-0-1292"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1293"><a id="__codelineno-0-1293" name="__codelineno-0-1293"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1294"><a id="__codelineno-0-1294" name="__codelineno-0-1294"></a>        <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1295"><a id="__codelineno-0-1295" name="__codelineno-0-1295"></a>        <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">Join</span><span class="p">,</span> <span class="n">BinaryExpression</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1296"><a id="__codelineno-0-1296" name="__codelineno-0-1296"></a>        <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1297"><a id="__codelineno-0-1297" name="__codelineno-0-1297"></a>        <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1298"><a id="__codelineno-0-1298" name="__codelineno-0-1298"></a>        <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
+</span><span id="__span-0-1299"><a id="__codelineno-0-1299" name="__codelineno-0-1299"></a>        <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1300"><a id="__codelineno-0-1300" name="__codelineno-0-1300"></a>        <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1301"><a id="__codelineno-0-1301" name="__codelineno-0-1301"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1302"><a id="__codelineno-0-1302" name="__codelineno-0-1302"></a>        <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1303"><a id="__codelineno-0-1303" name="__codelineno-0-1303"></a>        <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1304"><a id="__codelineno-0-1304" name="__codelineno-0-1304"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1305"><a id="__codelineno-0-1305" name="__codelineno-0-1305"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
+</span><span id="__span-0-1306"><a id="__codelineno-0-1306" name="__codelineno-0-1306"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1307"><a id="__codelineno-0-1307" name="__codelineno-0-1307"></a><span class="sd">        Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts</span>
+</span><span id="__span-0-1308"><a id="__codelineno-0-1308" name="__codelineno-0-1308"></a><span class="sd">        to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to</span>
+</span><span id="__span-0-1309"><a id="__codelineno-0-1309" name="__codelineno-0-1309"></a><span class="sd">        specify each join configuration.</span>
+</span><span id="__span-0-1310"><a id="__codelineno-0-1310" name="__codelineno-0-1310"></a>
+</span><span id="__span-0-1311"><a id="__codelineno-0-1311" name="__codelineno-0-1311"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1312"><a id="__codelineno-0-1312" name="__codelineno-0-1312"></a>
+</span><span id="__span-0-1313"><a id="__codelineno-0-1313" name="__codelineno-0-1313"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-1314"><a id="__codelineno-0-1314" name="__codelineno-0-1314"></a><span class="sd">            db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-1315"><a id="__codelineno-0-1315" name="__codelineno-0-1315"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1316"><a id="__codelineno-0-1316" name="__codelineno-0-1316"></a><span class="sd">            join_model: The model to join with.</span>
+</span><span id="__span-0-1317"><a id="__codelineno-0-1317" name="__codelineno-0-1317"></a><span class="sd">            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
+</span><span id="__span-0-1318"><a id="__codelineno-0-1318" name="__codelineno-0-1318"></a><span class="sd">            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
+</span><span id="__span-0-1319"><a id="__codelineno-0-1319" name="__codelineno-0-1319"></a><span class="sd">            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
+</span><span id="__span-0-1320"><a id="__codelineno-0-1320" name="__codelineno-0-1320"></a><span class="sd">            join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
+</span><span id="__span-0-1321"><a id="__codelineno-0-1321" name="__codelineno-0-1321"></a><span class="sd">            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
+</span><span id="__span-0-1322"><a id="__codelineno-0-1322" name="__codelineno-0-1322"></a><span class="sd">            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
+</span><span id="__span-0-1323"><a id="__codelineno-0-1323" name="__codelineno-0-1323"></a><span class="sd">            joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</span>
+</span><span id="__span-0-1324"><a id="__codelineno-0-1324" name="__codelineno-0-1324"></a><span class="sd">            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
+</span><span id="__span-0-1325"><a id="__codelineno-0-1325" name="__codelineno-0-1325"></a><span class="sd">            relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
+</span><span id="__span-0-1326"><a id="__codelineno-0-1326" name="__codelineno-0-1326"></a><span class="sd">            **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</span>
+</span><span id="__span-0-1327"><a id="__codelineno-0-1327" name="__codelineno-0-1327"></a>
+</span><span id="__span-0-1328"><a id="__codelineno-0-1328" name="__codelineno-0-1328"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-1329"><a id="__codelineno-0-1329" name="__codelineno-0-1329"></a><span class="sd">            A dictionary representing the joined record, or `None` if no record matches the criteria.</span>
+</span><span id="__span-0-1330"><a id="__codelineno-0-1330" name="__codelineno-0-1330"></a>
+</span><span id="__span-0-1331"><a id="__codelineno-0-1331" name="__codelineno-0-1331"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-1332"><a id="__codelineno-0-1332" name="__codelineno-0-1332"></a><span class="sd">            ValueError: If both single join parameters and `joins_config` are used simultaneously.</span>
+</span><span id="__span-0-1333"><a id="__codelineno-0-1333" name="__codelineno-0-1333"></a><span class="sd">            ArgumentError: If any provided model in `joins_config` is not recognized or invalid.</span>
+</span><span id="__span-0-1334"><a id="__codelineno-0-1334" name="__codelineno-0-1334"></a><span class="sd">            NoResultFound: If no record matches the criteria with the provided filters.</span>
+</span><span id="__span-0-1335"><a id="__codelineno-0-1335" name="__codelineno-0-1335"></a>
+</span><span id="__span-0-1336"><a id="__codelineno-0-1336" name="__codelineno-0-1336"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-1337"><a id="__codelineno-0-1337" name="__codelineno-0-1337"></a><span class="sd">            Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`</span>
+</span><span id="__span-0-1338"><a id="__codelineno-0-1338" name="__codelineno-0-1338"></a>
+</span><span id="__span-0-1339"><a id="__codelineno-0-1339" name="__codelineno-0-1339"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1340"><a id="__codelineno-0-1340" name="__codelineno-0-1340"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1341"><a id="__codelineno-0-1341" name="__codelineno-0-1341"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1342"><a id="__codelineno-0-1342" name="__codelineno-0-1342"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1343"><a id="__codelineno-0-1343" name="__codelineno-0-1343"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1344"><a id="__codelineno-0-1344" name="__codelineno-0-1344"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1345"><a id="__codelineno-0-1345" name="__codelineno-0-1345"></a><span class="sd">            )</span>
+</span><span id="__span-0-1346"><a id="__codelineno-0-1346" name="__codelineno-0-1346"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1347"><a id="__codelineno-0-1347" name="__codelineno-0-1347"></a>
+</span><span id="__span-0-1348"><a id="__codelineno-0-1348" name="__codelineno-0-1348"></a><span class="sd">            Fetch a user and their associated tier, filtering by user ID:</span>
+</span><span id="__span-0-1349"><a id="__codelineno-0-1349" name="__codelineno-0-1349"></a>
+</span><span id="__span-0-1350"><a id="__codelineno-0-1350" name="__codelineno-0-1350"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1351"><a id="__codelineno-0-1351" name="__codelineno-0-1351"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1352"><a id="__codelineno-0-1352" name="__codelineno-0-1352"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1353"><a id="__codelineno-0-1353" name="__codelineno-0-1353"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1354"><a id="__codelineno-0-1354" name="__codelineno-0-1354"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1355"><a id="__codelineno-0-1355" name="__codelineno-0-1355"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1356"><a id="__codelineno-0-1356" name="__codelineno-0-1356"></a><span class="sd">                id=1,</span>
+</span><span id="__span-0-1357"><a id="__codelineno-0-1357" name="__codelineno-0-1357"></a><span class="sd">            )</span>
+</span><span id="__span-0-1358"><a id="__codelineno-0-1358" name="__codelineno-0-1358"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1359"><a id="__codelineno-0-1359" name="__codelineno-0-1359"></a>
+</span><span id="__span-0-1360"><a id="__codelineno-0-1360" name="__codelineno-0-1360"></a><span class="sd">            Fetch a user and their associated tier, where the user&#39;s age is greater than 30:</span>
+</span><span id="__span-0-1361"><a id="__codelineno-0-1361" name="__codelineno-0-1361"></a>
+</span><span id="__span-0-1362"><a id="__codelineno-0-1362" name="__codelineno-0-1362"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1363"><a id="__codelineno-0-1363" name="__codelineno-0-1363"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1364"><a id="__codelineno-0-1364" name="__codelineno-0-1364"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1365"><a id="__codelineno-0-1365" name="__codelineno-0-1365"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1366"><a id="__codelineno-0-1366" name="__codelineno-0-1366"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1367"><a id="__codelineno-0-1367" name="__codelineno-0-1367"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1368"><a id="__codelineno-0-1368" name="__codelineno-0-1368"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-1369"><a id="__codelineno-0-1369" name="__codelineno-0-1369"></a><span class="sd">            )</span>
+</span><span id="__span-0-1370"><a id="__codelineno-0-1370" name="__codelineno-0-1370"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1371"><a id="__codelineno-0-1371" name="__codelineno-0-1371"></a>
+</span><span id="__span-0-1372"><a id="__codelineno-0-1372" name="__codelineno-0-1372"></a><span class="sd">            Fetch a user and their associated tier, excluding users with the `admin` username:</span>
+</span><span id="__span-0-1373"><a id="__codelineno-0-1373" name="__codelineno-0-1373"></a>
+</span><span id="__span-0-1374"><a id="__codelineno-0-1374" name="__codelineno-0-1374"></a><span class="sd">            ```python</span>
 </span><span id="__span-0-1375"><a id="__codelineno-0-1375" name="__codelineno-0-1375"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1376"><a id="__codelineno-0-1376" name="__codelineno-0-1376"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1376"><a id="__codelineno-0-1376" name="__codelineno-0-1376"></a><span class="sd">                db,</span>
 </span><span id="__span-0-1377"><a id="__codelineno-0-1377" name="__codelineno-0-1377"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
 </span><span id="__span-0-1378"><a id="__codelineno-0-1378" name="__codelineno-0-1378"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1379"><a id="__codelineno-0-1379" name="__codelineno-0-1379"></a><span class="sd">                join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),</span>
-</span><span id="__span-0-1380"><a id="__codelineno-0-1380" name="__codelineno-0-1380"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1381"><a id="__codelineno-0-1381" name="__codelineno-0-1381"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1382"><a id="__codelineno-0-1382" name="__codelineno-0-1382"></a><span class="sd">                username=&quot;john_doe&quot;,</span>
-</span><span id="__span-0-1383"><a id="__codelineno-0-1383" name="__codelineno-0-1383"></a><span class="sd">            )</span>
-</span><span id="__span-0-1384"><a id="__codelineno-0-1384" name="__codelineno-0-1384"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1379"><a id="__codelineno-0-1379" name="__codelineno-0-1379"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1380"><a id="__codelineno-0-1380" name="__codelineno-0-1380"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1381"><a id="__codelineno-0-1381" name="__codelineno-0-1381"></a><span class="sd">            )</span>
+</span><span id="__span-0-1382"><a id="__codelineno-0-1382" name="__codelineno-0-1382"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1383"><a id="__codelineno-0-1383" name="__codelineno-0-1383"></a>
+</span><span id="__span-0-1384"><a id="__codelineno-0-1384" name="__codelineno-0-1384"></a><span class="sd">            Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</span>
 </span><span id="__span-0-1385"><a id="__codelineno-0-1385" name="__codelineno-0-1385"></a>
-</span><span id="__span-0-1386"><a id="__codelineno-0-1386" name="__codelineno-0-1386"></a><span class="sd">            Example of using `joins_config` for multiple joins:</span>
-</span><span id="__span-0-1387"><a id="__codelineno-0-1387" name="__codelineno-0-1387"></a>
-</span><span id="__span-0-1388"><a id="__codelineno-0-1388" name="__codelineno-0-1388"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1389"><a id="__codelineno-0-1389" name="__codelineno-0-1389"></a><span class="sd">            from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1390"><a id="__codelineno-0-1390" name="__codelineno-0-1390"></a>
-</span><span id="__span-0-1391"><a id="__codelineno-0-1391" name="__codelineno-0-1391"></a><span class="sd">            # Using same User/Tier/Department models/schemas as above.</span>
-</span><span id="__span-0-1392"><a id="__codelineno-0-1392" name="__codelineno-0-1392"></a>
-</span><span id="__span-0-1393"><a id="__codelineno-0-1393" name="__codelineno-0-1393"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1394"><a id="__codelineno-0-1394" name="__codelineno-0-1394"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1395"><a id="__codelineno-0-1395" name="__codelineno-0-1395"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1396"><a id="__codelineno-0-1396" name="__codelineno-0-1396"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1397"><a id="__codelineno-0-1397" name="__codelineno-0-1397"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1398"><a id="__codelineno-0-1398" name="__codelineno-0-1398"></a><span class="sd">                        model=Tier,</span>
-</span><span id="__span-0-1399"><a id="__codelineno-0-1399" name="__codelineno-0-1399"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1400"><a id="__codelineno-0-1400" name="__codelineno-0-1400"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1401"><a id="__codelineno-0-1401" name="__codelineno-0-1401"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1402"><a id="__codelineno-0-1402" name="__codelineno-0-1402"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1403"><a id="__codelineno-0-1403" name="__codelineno-0-1403"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1404"><a id="__codelineno-0-1404" name="__codelineno-0-1404"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1405"><a id="__codelineno-0-1405" name="__codelineno-0-1405"></a><span class="sd">                        model=Department,</span>
-</span><span id="__span-0-1406"><a id="__codelineno-0-1406" name="__codelineno-0-1406"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1407"><a id="__codelineno-0-1407" name="__codelineno-0-1407"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1408"><a id="__codelineno-0-1408" name="__codelineno-0-1408"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1409"><a id="__codelineno-0-1409" name="__codelineno-0-1409"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1410"><a id="__codelineno-0-1410" name="__codelineno-0-1410"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1411"><a id="__codelineno-0-1411" name="__codelineno-0-1411"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1412"><a id="__codelineno-0-1412" name="__codelineno-0-1412"></a><span class="sd">            )</span>
-</span><span id="__span-0-1413"><a id="__codelineno-0-1413" name="__codelineno-0-1413"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1414"><a id="__codelineno-0-1414" name="__codelineno-0-1414"></a>
-</span><span id="__span-0-1415"><a id="__codelineno-0-1415" name="__codelineno-0-1415"></a><span class="sd">            Using `alias` for joining the same model multiple times:</span>
-</span><span id="__span-0-1416"><a id="__codelineno-0-1416" name="__codelineno-0-1416"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1417"><a id="__codelineno-0-1417" name="__codelineno-0-1417"></a><span class="sd">            from fastcrud import aliased</span>
-</span><span id="__span-0-1418"><a id="__codelineno-0-1418" name="__codelineno-0-1418"></a>
-</span><span id="__span-0-1419"><a id="__codelineno-0-1419" name="__codelineno-0-1419"></a><span class="sd">            owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
-</span><span id="__span-0-1420"><a id="__codelineno-0-1420" name="__codelineno-0-1420"></a><span class="sd">            user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
-</span><span id="__span-0-1421"><a id="__codelineno-0-1421" name="__codelineno-0-1421"></a>
-</span><span id="__span-0-1422"><a id="__codelineno-0-1422" name="__codelineno-0-1422"></a><span class="sd">            result = await crud.get_joined(</span>
-</span><span id="__span-0-1423"><a id="__codelineno-0-1423" name="__codelineno-0-1423"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1424"><a id="__codelineno-0-1424" name="__codelineno-0-1424"></a><span class="sd">                schema_to_select=BookingSchema,</span>
-</span><span id="__span-0-1425"><a id="__codelineno-0-1425" name="__codelineno-0-1425"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1426"><a id="__codelineno-0-1426" name="__codelineno-0-1426"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1427"><a id="__codelineno-0-1427" name="__codelineno-0-1427"></a><span class="sd">                        model=ModelTest,</span>
-</span><span id="__span-0-1428"><a id="__codelineno-0-1428" name="__codelineno-0-1428"></a><span class="sd">                        join_on=BookingModel.owner_id == owner_alias.id,</span>
-</span><span id="__span-0-1429"><a id="__codelineno-0-1429" name="__codelineno-0-1429"></a><span class="sd">                        join_prefix=&quot;owner_&quot;,</span>
-</span><span id="__span-0-1430"><a id="__codelineno-0-1430" name="__codelineno-0-1430"></a><span class="sd">                        alias=owner_alias,</span>
-</span><span id="__span-0-1431"><a id="__codelineno-0-1431" name="__codelineno-0-1431"></a><span class="sd">                        schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1432"><a id="__codelineno-0-1432" name="__codelineno-0-1432"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1433"><a id="__codelineno-0-1433" name="__codelineno-0-1433"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1434"><a id="__codelineno-0-1434" name="__codelineno-0-1434"></a><span class="sd">                        model=ModelTest,</span>
-</span><span id="__span-0-1435"><a id="__codelineno-0-1435" name="__codelineno-0-1435"></a><span class="sd">                        join_on=BookingModel.user_id == user_alias.id,</span>
-</span><span id="__span-0-1436"><a id="__codelineno-0-1436" name="__codelineno-0-1436"></a><span class="sd">                        join_prefix=&quot;user_&quot;,</span>
-</span><span id="__span-0-1437"><a id="__codelineno-0-1437" name="__codelineno-0-1437"></a><span class="sd">                        alias=user_alias,</span>
-</span><span id="__span-0-1438"><a id="__codelineno-0-1438" name="__codelineno-0-1438"></a><span class="sd">                        schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1439"><a id="__codelineno-0-1439" name="__codelineno-0-1439"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1440"><a id="__codelineno-0-1440" name="__codelineno-0-1440"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1441"><a id="__codelineno-0-1441" name="__codelineno-0-1441"></a><span class="sd">                id=1,</span>
-</span><span id="__span-0-1442"><a id="__codelineno-0-1442" name="__codelineno-0-1442"></a><span class="sd">            )</span>
-</span><span id="__span-0-1443"><a id="__codelineno-0-1443" name="__codelineno-0-1443"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1444"><a id="__codelineno-0-1444" name="__codelineno-0-1444"></a>
-</span><span id="__span-0-1445"><a id="__codelineno-0-1445" name="__codelineno-0-1445"></a><span class="sd">            Fetching a single project and its associated participants where a participant has a specific role:</span>
-</span><span id="__span-0-1446"><a id="__codelineno-0-1446" name="__codelineno-0-1446"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1447"><a id="__codelineno-0-1447" name="__codelineno-0-1447"></a><span class="sd">            joins_config = [</span>
-</span><span id="__span-0-1448"><a id="__codelineno-0-1448" name="__codelineno-0-1448"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1449"><a id="__codelineno-0-1449" name="__codelineno-0-1449"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1450"><a id="__codelineno-0-1450" name="__codelineno-0-1450"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1451"><a id="__codelineno-0-1451" name="__codelineno-0-1451"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1452"><a id="__codelineno-0-1452" name="__codelineno-0-1452"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1453"><a id="__codelineno-0-1453" name="__codelineno-0-1453"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1454"><a id="__codelineno-0-1454" name="__codelineno-0-1454"></a><span class="sd">                    model=Participant,</span>
-</span><span id="__span-0-1455"><a id="__codelineno-0-1455" name="__codelineno-0-1455"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1456"><a id="__codelineno-0-1456" name="__codelineno-0-1456"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1457"><a id="__codelineno-0-1457" name="__codelineno-0-1457"></a><span class="sd">                    filters={&#39;role&#39;: &#39;Designer&#39;},</span>
-</span><span id="__span-0-1458"><a id="__codelineno-0-1458" name="__codelineno-0-1458"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1459"><a id="__codelineno-0-1459" name="__codelineno-0-1459"></a><span class="sd">            ]</span>
-</span><span id="__span-0-1460"><a id="__codelineno-0-1460" name="__codelineno-0-1460"></a><span class="sd">            project = await crud.get_joined(</span>
-</span><span id="__span-0-1461"><a id="__codelineno-0-1461" name="__codelineno-0-1461"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1462"><a id="__codelineno-0-1462" name="__codelineno-0-1462"></a><span class="sd">                schema_to_select=ProjectSchema,</span>
-</span><span id="__span-0-1463"><a id="__codelineno-0-1463" name="__codelineno-0-1463"></a><span class="sd">                joins_config=joins_config,</span>
-</span><span id="__span-0-1464"><a id="__codelineno-0-1464" name="__codelineno-0-1464"></a><span class="sd">            )</span>
-</span><span id="__span-0-1465"><a id="__codelineno-0-1465" name="__codelineno-0-1465"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1466"><a id="__codelineno-0-1466" name="__codelineno-0-1466"></a>
-</span><span id="__span-0-1467"><a id="__codelineno-0-1467" name="__codelineno-0-1467"></a><span class="sd">            Example of using `joins_config` for multiple joins with nested joins enabled:</span>
-</span><span id="__span-0-1468"><a id="__codelineno-0-1468" name="__codelineno-0-1468"></a>
-</span><span id="__span-0-1469"><a id="__codelineno-0-1469" name="__codelineno-0-1469"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1470"><a id="__codelineno-0-1470" name="__codelineno-0-1470"></a><span class="sd">            from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1471"><a id="__codelineno-0-1471" name="__codelineno-0-1471"></a>
-</span><span id="__span-0-1472"><a id="__codelineno-0-1472" name="__codelineno-0-1472"></a><span class="sd">            result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1473"><a id="__codelineno-0-1473" name="__codelineno-0-1473"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1474"><a id="__codelineno-0-1474" name="__codelineno-0-1474"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1475"><a id="__codelineno-0-1475" name="__codelineno-0-1475"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1476"><a id="__codelineno-0-1476" name="__codelineno-0-1476"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1477"><a id="__codelineno-0-1477" name="__codelineno-0-1477"></a><span class="sd">                        model=Tier,</span>
-</span><span id="__span-0-1478"><a id="__codelineno-0-1478" name="__codelineno-0-1478"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1479"><a id="__codelineno-0-1479" name="__codelineno-0-1479"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1480"><a id="__codelineno-0-1480" name="__codelineno-0-1480"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1481"><a id="__codelineno-0-1481" name="__codelineno-0-1481"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1482"><a id="__codelineno-0-1482" name="__codelineno-0-1482"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1483"><a id="__codelineno-0-1483" name="__codelineno-0-1483"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1484"><a id="__codelineno-0-1484" name="__codelineno-0-1484"></a><span class="sd">                        model=Department,</span>
-</span><span id="__span-0-1485"><a id="__codelineno-0-1485" name="__codelineno-0-1485"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1486"><a id="__codelineno-0-1486" name="__codelineno-0-1486"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1487"><a id="__codelineno-0-1487" name="__codelineno-0-1487"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1488"><a id="__codelineno-0-1488" name="__codelineno-0-1488"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1489"><a id="__codelineno-0-1489" name="__codelineno-0-1489"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1490"><a id="__codelineno-0-1490" name="__codelineno-0-1490"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1491"><a id="__codelineno-0-1491" name="__codelineno-0-1491"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1492"><a id="__codelineno-0-1492" name="__codelineno-0-1492"></a><span class="sd">            )</span>
-</span><span id="__span-0-1493"><a id="__codelineno-0-1493" name="__codelineno-0-1493"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;tier&#39; and &#39;dept&#39; as nested dictionaries</span>
-</span><span id="__span-0-1494"><a id="__codelineno-0-1494" name="__codelineno-0-1494"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1495"><a id="__codelineno-0-1495" name="__codelineno-0-1495"></a>
-</span><span id="__span-0-1496"><a id="__codelineno-0-1496" name="__codelineno-0-1496"></a><span class="sd">            Example using one-to-one relationship:</span>
-</span><span id="__span-0-1497"><a id="__codelineno-0-1497" name="__codelineno-0-1497"></a>
-</span><span id="__span-0-1498"><a id="__codelineno-0-1498" name="__codelineno-0-1498"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1499"><a id="__codelineno-0-1499" name="__codelineno-0-1499"></a><span class="sd">            author_crud = FastCRUD(Author)</span>
-</span><span id="__span-0-1500"><a id="__codelineno-0-1500" name="__codelineno-0-1500"></a><span class="sd">            result = await author_crud.get_joined(</span>
-</span><span id="__span-0-1501"><a id="__codelineno-0-1501" name="__codelineno-0-1501"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1502"><a id="__codelineno-0-1502" name="__codelineno-0-1502"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1503"><a id="__codelineno-0-1503" name="__codelineno-0-1503"></a><span class="sd">                join_model=Profile,</span>
-</span><span id="__span-0-1504"><a id="__codelineno-0-1504" name="__codelineno-0-1504"></a><span class="sd">                join_on=Author.profile_id == Profile.id,</span>
-</span><span id="__span-0-1505"><a id="__codelineno-0-1505" name="__codelineno-0-1505"></a><span class="sd">                join_schema_to_select=ReadProfileSchema,</span>
-</span><span id="__span-0-1506"><a id="__codelineno-0-1506" name="__codelineno-0-1506"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1507"><a id="__codelineno-0-1507" name="__codelineno-0-1507"></a><span class="sd">                relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
-</span><span id="__span-0-1508"><a id="__codelineno-0-1508" name="__codelineno-0-1508"></a><span class="sd">            )</span>
-</span><span id="__span-0-1509"><a id="__codelineno-0-1509" name="__codelineno-0-1509"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;profile&#39; as a nested dictionary</span>
-</span><span id="__span-0-1510"><a id="__codelineno-0-1510" name="__codelineno-0-1510"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1511"><a id="__codelineno-0-1511" name="__codelineno-0-1511"></a>
-</span><span id="__span-0-1512"><a id="__codelineno-0-1512" name="__codelineno-0-1512"></a><span class="sd">            Example using one-to-many relationship:</span>
-</span><span id="__span-0-1513"><a id="__codelineno-0-1513" name="__codelineno-0-1513"></a>
-</span><span id="__span-0-1514"><a id="__codelineno-0-1514" name="__codelineno-0-1514"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1515"><a id="__codelineno-0-1515" name="__codelineno-0-1515"></a><span class="sd">            result = await author_crud.get_joined(</span>
-</span><span id="__span-0-1516"><a id="__codelineno-0-1516" name="__codelineno-0-1516"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1517"><a id="__codelineno-0-1517" name="__codelineno-0-1517"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1518"><a id="__codelineno-0-1518" name="__codelineno-0-1518"></a><span class="sd">                join_model=Article,</span>
-</span><span id="__span-0-1519"><a id="__codelineno-0-1519" name="__codelineno-0-1519"></a><span class="sd">                join_on=Author.id == Article.author_id,</span>
-</span><span id="__span-0-1520"><a id="__codelineno-0-1520" name="__codelineno-0-1520"></a><span class="sd">                join_schema_to_select=ReadArticleSchema,</span>
-</span><span id="__span-0-1521"><a id="__codelineno-0-1521" name="__codelineno-0-1521"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1522"><a id="__codelineno-0-1522" name="__codelineno-0-1522"></a><span class="sd">                relationship_type=&#39;one-to-many&#39;,</span>
-</span><span id="__span-0-1523"><a id="__codelineno-0-1523" name="__codelineno-0-1523"></a><span class="sd">            )</span>
-</span><span id="__span-0-1524"><a id="__codelineno-0-1524" name="__codelineno-0-1524"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;posts&#39; as a nested list of dictionaries</span>
-</span><span id="__span-0-1525"><a id="__codelineno-0-1525" name="__codelineno-0-1525"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1526"><a id="__codelineno-0-1526" name="__codelineno-0-1526"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-1527"><a id="__codelineno-0-1527" name="__codelineno-0-1527"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
-</span><span id="__span-0-1528"><a id="__codelineno-0-1528" name="__codelineno-0-1528"></a>            <span class="n">join_model</span> <span class="ow">or</span> <span class="n">join_prefix</span> <span class="ow">or</span> <span class="n">join_on</span> <span class="ow">or</span> <span class="n">join_schema_to_select</span> <span class="ow">or</span> <span class="n">alias</span>
-</span><span id="__span-0-1529"><a id="__codelineno-0-1529" name="__codelineno-0-1529"></a>        <span class="p">):</span>
-</span><span id="__span-0-1530"><a id="__codelineno-0-1530" name="__codelineno-0-1530"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1531"><a id="__codelineno-0-1531" name="__codelineno-0-1531"></a>                <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
-</span><span id="__span-0-1532"><a id="__codelineno-0-1532" name="__codelineno-0-1532"></a>            <span class="p">)</span>
-</span><span id="__span-0-1533"><a id="__codelineno-0-1533" name="__codelineno-0-1533"></a>        <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1534"><a id="__codelineno-0-1534" name="__codelineno-0-1534"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1535"><a id="__codelineno-0-1535" name="__codelineno-0-1535"></a>
-</span><span id="__span-0-1536"><a id="__codelineno-0-1536" name="__codelineno-0-1536"></a>        <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-1537"><a id="__codelineno-0-1537" name="__codelineno-0-1537"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-1538"><a id="__codelineno-0-1538" name="__codelineno-0-1538"></a>            <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1539"><a id="__codelineno-0-1539" name="__codelineno-0-1539"></a>        <span class="p">)</span>
-</span><span id="__span-0-1540"><a id="__codelineno-0-1540" name="__codelineno-0-1540"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-1541"><a id="__codelineno-0-1541" name="__codelineno-0-1541"></a>
-</span><span id="__span-0-1542"><a id="__codelineno-0-1542" name="__codelineno-0-1542"></a>        <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1543"><a id="__codelineno-0-1543" name="__codelineno-0-1543"></a>        <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1544"><a id="__codelineno-0-1544" name="__codelineno-0-1544"></a>            <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="__span-0-1545"><a id="__codelineno-0-1545" name="__codelineno-0-1545"></a>                <span class="n">JoinConfig</span><span class="p">(</span>
-</span><span id="__span-0-1546"><a id="__codelineno-0-1546" name="__codelineno-0-1546"></a>                    <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
-</span><span id="__span-0-1547"><a id="__codelineno-0-1547" name="__codelineno-0-1547"></a>                    <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span><span class="p">,</span>
-</span><span id="__span-0-1548"><a id="__codelineno-0-1548" name="__codelineno-0-1548"></a>                    <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
-</span><span id="__span-0-1549"><a id="__codelineno-0-1549" name="__codelineno-0-1549"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1550"><a id="__codelineno-0-1550" name="__codelineno-0-1550"></a>                    <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
-</span><span id="__span-0-1551"><a id="__codelineno-0-1551" name="__codelineno-0-1551"></a>                    <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
-</span><span id="__span-0-1552"><a id="__codelineno-0-1552" name="__codelineno-0-1552"></a>                    <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
-</span><span id="__span-0-1553"><a id="__codelineno-0-1553" name="__codelineno-0-1553"></a>                    <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
-</span><span id="__span-0-1554"><a id="__codelineno-0-1554" name="__codelineno-0-1554"></a>                <span class="p">)</span>
-</span><span id="__span-0-1555"><a id="__codelineno-0-1555" name="__codelineno-0-1555"></a>            <span class="p">)</span>
-</span><span id="__span-0-1556"><a id="__codelineno-0-1556" name="__codelineno-0-1556"></a>
-</span><span id="__span-0-1557"><a id="__codelineno-0-1557" name="__codelineno-0-1557"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
-</span><span id="__span-0-1558"><a id="__codelineno-0-1558" name="__codelineno-0-1558"></a>            <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
-</span><span id="__span-0-1559"><a id="__codelineno-0-1559" name="__codelineno-0-1559"></a>        <span class="p">)</span>
-</span><span id="__span-0-1560"><a id="__codelineno-0-1560" name="__codelineno-0-1560"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1561"><a id="__codelineno-0-1561" name="__codelineno-0-1561"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1562"><a id="__codelineno-0-1562" name="__codelineno-0-1562"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1563"><a id="__codelineno-0-1563" name="__codelineno-0-1563"></a>
-</span><span id="__span-0-1564"><a id="__codelineno-0-1564" name="__codelineno-0-1564"></a>        <span class="n">db_rows</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1565"><a id="__codelineno-0-1565" name="__codelineno-0-1565"></a>        <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span><span class="p">):</span>
-</span><span id="__span-0-1566"><a id="__codelineno-0-1566" name="__codelineno-0-1566"></a>            <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-1567"><a id="__codelineno-0-1567" name="__codelineno-0-1567"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1568"><a id="__codelineno-0-1568" name="__codelineno-0-1568"></a>                    <span class="s2">&quot;Cannot use one-to-many relationship with nest_joins=False&quot;</span>
-</span><span id="__span-0-1569"><a id="__codelineno-0-1569" name="__codelineno-0-1569"></a>                <span class="p">)</span>
-</span><span id="__span-0-1570"><a id="__codelineno-0-1570" name="__codelineno-0-1570"></a>            <span class="n">results</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>
-</span><span id="__span-0-1571"><a id="__codelineno-0-1571" name="__codelineno-0-1571"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
-</span><span id="__span-0-1572"><a id="__codelineno-0-1572" name="__codelineno-0-1572"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1573"><a id="__codelineno-0-1573" name="__codelineno-0-1573"></a>            <span class="n">result</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-</span><span id="__span-0-1574"><a id="__codelineno-0-1574" name="__codelineno-0-1574"></a>            <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1575"><a id="__codelineno-0-1575" name="__codelineno-0-1575"></a>                <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)]</span>
-</span><span id="__span-0-1576"><a id="__codelineno-0-1576" name="__codelineno-0-1576"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1577"><a id="__codelineno-0-1577" name="__codelineno-0-1577"></a>                <span class="n">data_list</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-1578"><a id="__codelineno-0-1578" name="__codelineno-0-1578"></a>
-</span><span id="__span-0-1579"><a id="__codelineno-0-1579" name="__codelineno-0-1579"></a>        <span class="k">if</span> <span class="n">data_list</span><span class="p">:</span>
-</span><span id="__span-0-1580"><a id="__codelineno-0-1580" name="__codelineno-0-1580"></a>            <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
-</span><span id="__span-0-1581"><a id="__codelineno-0-1581" name="__codelineno-0-1581"></a>                <span class="n">nested_data</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-1582"><a id="__codelineno-0-1582" name="__codelineno-0-1582"></a>                <span class="k">for</span> <span class="n">data</span> <span class="ow">in</span> <span class="n">data_list</span><span class="p">:</span>
-</span><span id="__span-0-1583"><a id="__codelineno-0-1583" name="__codelineno-0-1583"></a>                    <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1584"><a id="__codelineno-0-1584" name="__codelineno-0-1584"></a>                        <span class="n">data</span><span class="p">,</span>
-</span><span id="__span-0-1585"><a id="__codelineno-0-1585" name="__codelineno-0-1585"></a>                        <span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1586"><a id="__codelineno-0-1586" name="__codelineno-0-1586"></a>                        <span class="n">nested_data</span><span class="o">=</span><span class="n">nested_data</span><span class="p">,</span>
-</span><span id="__span-0-1587"><a id="__codelineno-0-1587" name="__codelineno-0-1587"></a>                    <span class="p">)</span>
-</span><span id="__span-0-1588"><a id="__codelineno-0-1588" name="__codelineno-0-1588"></a>                <span class="k">return</span> <span class="n">nested_data</span>
-</span><span id="__span-0-1589"><a id="__codelineno-0-1589" name="__codelineno-0-1589"></a>            <span class="k">return</span> <span class="n">data_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="__span-0-1590"><a id="__codelineno-0-1590" name="__codelineno-0-1590"></a>
-</span><span id="__span-0-1591"><a id="__codelineno-0-1591" name="__codelineno-0-1591"></a>        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-1592"><a id="__codelineno-0-1592" name="__codelineno-0-1592"></a>
-</span><span id="__span-0-1593"><a id="__codelineno-0-1593" name="__codelineno-0-1593"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_joined</span><span class="p">(</span>
-</span><span id="__span-0-1594"><a id="__codelineno-0-1594" name="__codelineno-0-1594"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1595"><a id="__codelineno-0-1595" name="__codelineno-0-1595"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1596"><a id="__codelineno-0-1596" name="__codelineno-0-1596"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1597"><a id="__codelineno-0-1597" name="__codelineno-0-1597"></a>        <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1598"><a id="__codelineno-0-1598" name="__codelineno-0-1598"></a>        <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1599"><a id="__codelineno-0-1599" name="__codelineno-0-1599"></a>        <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1600"><a id="__codelineno-0-1600" name="__codelineno-0-1600"></a>        <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1601"><a id="__codelineno-0-1601" name="__codelineno-0-1601"></a>        <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
-</span><span id="__span-0-1602"><a id="__codelineno-0-1602" name="__codelineno-0-1602"></a>        <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1603"><a id="__codelineno-0-1603" name="__codelineno-0-1603"></a>        <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1604"><a id="__codelineno-0-1604" name="__codelineno-0-1604"></a>        <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1605"><a id="__codelineno-0-1605" name="__codelineno-0-1605"></a>        <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
-</span><span id="__span-0-1606"><a id="__codelineno-0-1606" name="__codelineno-0-1606"></a>        <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-1607"><a id="__codelineno-0-1607" name="__codelineno-0-1607"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1608"><a id="__codelineno-0-1608" name="__codelineno-0-1608"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1609"><a id="__codelineno-0-1609" name="__codelineno-0-1609"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1610"><a id="__codelineno-0-1610" name="__codelineno-0-1610"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1611"><a id="__codelineno-0-1611" name="__codelineno-0-1611"></a>        <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-1612"><a id="__codelineno-0-1612" name="__codelineno-0-1612"></a>        <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1613"><a id="__codelineno-0-1613" name="__codelineno-0-1613"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1614"><a id="__codelineno-0-1614" name="__codelineno-0-1614"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-1615"><a id="__codelineno-0-1615" name="__codelineno-0-1615"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1616"><a id="__codelineno-0-1616" name="__codelineno-0-1616"></a><span class="sd">        Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</span>
-</span><span id="__span-0-1617"><a id="__codelineno-0-1617" name="__codelineno-0-1617"></a>
-</span><span id="__span-0-1618"><a id="__codelineno-0-1618" name="__codelineno-0-1618"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1619"><a id="__codelineno-0-1619" name="__codelineno-0-1619"></a>
-</span><span id="__span-0-1620"><a id="__codelineno-0-1620" name="__codelineno-0-1620"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-1621"><a id="__codelineno-0-1621" name="__codelineno-0-1621"></a><span class="sd">            db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-1622"><a id="__codelineno-0-1622" name="__codelineno-0-1622"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1623"><a id="__codelineno-0-1623" name="__codelineno-0-1623"></a><span class="sd">            join_model: The model to join with.</span>
-</span><span id="__span-0-1624"><a id="__codelineno-0-1624" name="__codelineno-0-1624"></a><span class="sd">            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
-</span><span id="__span-0-1625"><a id="__codelineno-0-1625" name="__codelineno-0-1625"></a><span class="sd">            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
-</span><span id="__span-0-1626"><a id="__codelineno-0-1626" name="__codelineno-0-1626"></a><span class="sd">            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
-</span><span id="__span-0-1627"><a id="__codelineno-0-1627" name="__codelineno-0-1627"></a><span class="sd">            join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
-</span><span id="__span-0-1628"><a id="__codelineno-0-1628" name="__codelineno-0-1628"></a><span class="sd">            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
-</span><span id="__span-0-1629"><a id="__codelineno-0-1629" name="__codelineno-0-1629"></a><span class="sd">            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
-</span><span id="__span-0-1630"><a id="__codelineno-0-1630" name="__codelineno-0-1630"></a><span class="sd">            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
-</span><span id="__span-0-1631"><a id="__codelineno-0-1631" name="__codelineno-0-1631"></a><span class="sd">            offset: The offset (number of records to skip) for pagination.</span>
-</span><span id="__span-0-1632"><a id="__codelineno-0-1632" name="__codelineno-0-1632"></a><span class="sd">            limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
-</span><span id="__span-0-1633"><a id="__codelineno-0-1633" name="__codelineno-0-1633"></a><span class="sd">            sort_columns: A single column name or a list of column names on which to apply sorting.</span>
-</span><span id="__span-0-1634"><a id="__codelineno-0-1634" name="__codelineno-0-1634"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
-</span><span id="__span-0-1635"><a id="__codelineno-0-1635" name="__codelineno-0-1635"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-1636"><a id="__codelineno-0-1636" name="__codelineno-0-1636"></a><span class="sd">            joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</span>
-</span><span id="__span-0-1637"><a id="__codelineno-0-1637" name="__codelineno-0-1637"></a><span class="sd">            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
-</span><span id="__span-0-1638"><a id="__codelineno-0-1638" name="__codelineno-0-1638"></a><span class="sd">            relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
-</span><span id="__span-0-1639"><a id="__codelineno-0-1639" name="__codelineno-0-1639"></a><span class="sd">            **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.</span>
-</span><span id="__span-0-1640"><a id="__codelineno-0-1640" name="__codelineno-0-1640"></a>
-</span><span id="__span-0-1641"><a id="__codelineno-0-1641" name="__codelineno-0-1641"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-1642"><a id="__codelineno-0-1642" name="__codelineno-0-1642"></a><span class="sd">            A dictionary containing the fetched rows under `&quot;data&quot;` key and total count under `&quot;total_count&quot;`.</span>
-</span><span id="__span-0-1643"><a id="__codelineno-0-1643" name="__codelineno-0-1643"></a>
-</span><span id="__span-0-1644"><a id="__codelineno-0-1644" name="__codelineno-0-1644"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-1645"><a id="__codelineno-0-1645" name="__codelineno-0-1645"></a><span class="sd">            ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.</span>
-</span><span id="__span-0-1646"><a id="__codelineno-0-1646" name="__codelineno-0-1646"></a><span class="sd">                        Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.</span>
-</span><span id="__span-0-1647"><a id="__codelineno-0-1647" name="__codelineno-0-1647"></a>
-</span><span id="__span-0-1648"><a id="__codelineno-0-1648" name="__codelineno-0-1648"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-1649"><a id="__codelineno-0-1649" name="__codelineno-0-1649"></a><span class="sd">            Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:</span>
-</span><span id="__span-0-1650"><a id="__codelineno-0-1650" name="__codelineno-0-1650"></a>
-</span><span id="__span-0-1651"><a id="__codelineno-0-1651" name="__codelineno-0-1651"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1652"><a id="__codelineno-0-1652" name="__codelineno-0-1652"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1653"><a id="__codelineno-0-1653" name="__codelineno-0-1653"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1654"><a id="__codelineno-0-1654" name="__codelineno-0-1654"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1655"><a id="__codelineno-0-1655" name="__codelineno-0-1655"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1656"><a id="__codelineno-0-1656" name="__codelineno-0-1656"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1657"><a id="__codelineno-0-1657" name="__codelineno-0-1657"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1658"><a id="__codelineno-0-1658" name="__codelineno-0-1658"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1659"><a id="__codelineno-0-1659" name="__codelineno-0-1659"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1660"><a id="__codelineno-0-1660" name="__codelineno-0-1660"></a><span class="sd">            )</span>
-</span><span id="__span-0-1661"><a id="__codelineno-0-1661" name="__codelineno-0-1661"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1662"><a id="__codelineno-0-1662" name="__codelineno-0-1662"></a>
-</span><span id="__span-0-1663"><a id="__codelineno-0-1663" name="__codelineno-0-1663"></a><span class="sd">            Fetch users joined with their tiers, sorted by username, where user&#39;s age is greater than 30:</span>
-</span><span id="__span-0-1664"><a id="__codelineno-0-1664" name="__codelineno-0-1664"></a>
-</span><span id="__span-0-1665"><a id="__codelineno-0-1665" name="__codelineno-0-1665"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1666"><a id="__codelineno-0-1666" name="__codelineno-0-1666"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1667"><a id="__codelineno-0-1667" name="__codelineno-0-1667"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1668"><a id="__codelineno-0-1668" name="__codelineno-0-1668"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1669"><a id="__codelineno-0-1669" name="__codelineno-0-1669"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1386"><a id="__codelineno-0-1386" name="__codelineno-0-1386"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1387"><a id="__codelineno-0-1387" name="__codelineno-0-1387"></a><span class="sd">            from sqlalchemy import and_</span>
+</span><span id="__span-0-1388"><a id="__codelineno-0-1388" name="__codelineno-0-1388"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1389"><a id="__codelineno-0-1389" name="__codelineno-0-1389"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1390"><a id="__codelineno-0-1390" name="__codelineno-0-1390"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1391"><a id="__codelineno-0-1391" name="__codelineno-0-1391"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1392"><a id="__codelineno-0-1392" name="__codelineno-0-1392"></a><span class="sd">                join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),</span>
+</span><span id="__span-0-1393"><a id="__codelineno-0-1393" name="__codelineno-0-1393"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1394"><a id="__codelineno-0-1394" name="__codelineno-0-1394"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1395"><a id="__codelineno-0-1395" name="__codelineno-0-1395"></a><span class="sd">                username=&quot;john_doe&quot;,</span>
+</span><span id="__span-0-1396"><a id="__codelineno-0-1396" name="__codelineno-0-1396"></a><span class="sd">            )</span>
+</span><span id="__span-0-1397"><a id="__codelineno-0-1397" name="__codelineno-0-1397"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1398"><a id="__codelineno-0-1398" name="__codelineno-0-1398"></a>
+</span><span id="__span-0-1399"><a id="__codelineno-0-1399" name="__codelineno-0-1399"></a><span class="sd">            Example of using `joins_config` for multiple joins:</span>
+</span><span id="__span-0-1400"><a id="__codelineno-0-1400" name="__codelineno-0-1400"></a>
+</span><span id="__span-0-1401"><a id="__codelineno-0-1401" name="__codelineno-0-1401"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1402"><a id="__codelineno-0-1402" name="__codelineno-0-1402"></a><span class="sd">            from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1403"><a id="__codelineno-0-1403" name="__codelineno-0-1403"></a>
+</span><span id="__span-0-1404"><a id="__codelineno-0-1404" name="__codelineno-0-1404"></a><span class="sd">            # Using same User/Tier/Department models/schemas as above.</span>
+</span><span id="__span-0-1405"><a id="__codelineno-0-1405" name="__codelineno-0-1405"></a>
+</span><span id="__span-0-1406"><a id="__codelineno-0-1406" name="__codelineno-0-1406"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1407"><a id="__codelineno-0-1407" name="__codelineno-0-1407"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1408"><a id="__codelineno-0-1408" name="__codelineno-0-1408"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1409"><a id="__codelineno-0-1409" name="__codelineno-0-1409"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1410"><a id="__codelineno-0-1410" name="__codelineno-0-1410"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1411"><a id="__codelineno-0-1411" name="__codelineno-0-1411"></a><span class="sd">                        model=Tier,</span>
+</span><span id="__span-0-1412"><a id="__codelineno-0-1412" name="__codelineno-0-1412"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1413"><a id="__codelineno-0-1413" name="__codelineno-0-1413"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1414"><a id="__codelineno-0-1414" name="__codelineno-0-1414"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1415"><a id="__codelineno-0-1415" name="__codelineno-0-1415"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1416"><a id="__codelineno-0-1416" name="__codelineno-0-1416"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1417"><a id="__codelineno-0-1417" name="__codelineno-0-1417"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1418"><a id="__codelineno-0-1418" name="__codelineno-0-1418"></a><span class="sd">                        model=Department,</span>
+</span><span id="__span-0-1419"><a id="__codelineno-0-1419" name="__codelineno-0-1419"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1420"><a id="__codelineno-0-1420" name="__codelineno-0-1420"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1421"><a id="__codelineno-0-1421" name="__codelineno-0-1421"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1422"><a id="__codelineno-0-1422" name="__codelineno-0-1422"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1423"><a id="__codelineno-0-1423" name="__codelineno-0-1423"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1424"><a id="__codelineno-0-1424" name="__codelineno-0-1424"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1425"><a id="__codelineno-0-1425" name="__codelineno-0-1425"></a><span class="sd">            )</span>
+</span><span id="__span-0-1426"><a id="__codelineno-0-1426" name="__codelineno-0-1426"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1427"><a id="__codelineno-0-1427" name="__codelineno-0-1427"></a>
+</span><span id="__span-0-1428"><a id="__codelineno-0-1428" name="__codelineno-0-1428"></a><span class="sd">            Using `alias` for joining the same model multiple times:</span>
+</span><span id="__span-0-1429"><a id="__codelineno-0-1429" name="__codelineno-0-1429"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1430"><a id="__codelineno-0-1430" name="__codelineno-0-1430"></a><span class="sd">            from fastcrud import aliased</span>
+</span><span id="__span-0-1431"><a id="__codelineno-0-1431" name="__codelineno-0-1431"></a>
+</span><span id="__span-0-1432"><a id="__codelineno-0-1432" name="__codelineno-0-1432"></a><span class="sd">            owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
+</span><span id="__span-0-1433"><a id="__codelineno-0-1433" name="__codelineno-0-1433"></a><span class="sd">            user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
+</span><span id="__span-0-1434"><a id="__codelineno-0-1434" name="__codelineno-0-1434"></a>
+</span><span id="__span-0-1435"><a id="__codelineno-0-1435" name="__codelineno-0-1435"></a><span class="sd">            result = await crud.get_joined(</span>
+</span><span id="__span-0-1436"><a id="__codelineno-0-1436" name="__codelineno-0-1436"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1437"><a id="__codelineno-0-1437" name="__codelineno-0-1437"></a><span class="sd">                schema_to_select=BookingSchema,</span>
+</span><span id="__span-0-1438"><a id="__codelineno-0-1438" name="__codelineno-0-1438"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1439"><a id="__codelineno-0-1439" name="__codelineno-0-1439"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1440"><a id="__codelineno-0-1440" name="__codelineno-0-1440"></a><span class="sd">                        model=ModelTest,</span>
+</span><span id="__span-0-1441"><a id="__codelineno-0-1441" name="__codelineno-0-1441"></a><span class="sd">                        join_on=BookingModel.owner_id == owner_alias.id,</span>
+</span><span id="__span-0-1442"><a id="__codelineno-0-1442" name="__codelineno-0-1442"></a><span class="sd">                        join_prefix=&quot;owner_&quot;,</span>
+</span><span id="__span-0-1443"><a id="__codelineno-0-1443" name="__codelineno-0-1443"></a><span class="sd">                        alias=owner_alias,</span>
+</span><span id="__span-0-1444"><a id="__codelineno-0-1444" name="__codelineno-0-1444"></a><span class="sd">                        schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1445"><a id="__codelineno-0-1445" name="__codelineno-0-1445"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1446"><a id="__codelineno-0-1446" name="__codelineno-0-1446"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1447"><a id="__codelineno-0-1447" name="__codelineno-0-1447"></a><span class="sd">                        model=ModelTest,</span>
+</span><span id="__span-0-1448"><a id="__codelineno-0-1448" name="__codelineno-0-1448"></a><span class="sd">                        join_on=BookingModel.user_id == user_alias.id,</span>
+</span><span id="__span-0-1449"><a id="__codelineno-0-1449" name="__codelineno-0-1449"></a><span class="sd">                        join_prefix=&quot;user_&quot;,</span>
+</span><span id="__span-0-1450"><a id="__codelineno-0-1450" name="__codelineno-0-1450"></a><span class="sd">                        alias=user_alias,</span>
+</span><span id="__span-0-1451"><a id="__codelineno-0-1451" name="__codelineno-0-1451"></a><span class="sd">                        schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1452"><a id="__codelineno-0-1452" name="__codelineno-0-1452"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1453"><a id="__codelineno-0-1453" name="__codelineno-0-1453"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1454"><a id="__codelineno-0-1454" name="__codelineno-0-1454"></a><span class="sd">                id=1,</span>
+</span><span id="__span-0-1455"><a id="__codelineno-0-1455" name="__codelineno-0-1455"></a><span class="sd">            )</span>
+</span><span id="__span-0-1456"><a id="__codelineno-0-1456" name="__codelineno-0-1456"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1457"><a id="__codelineno-0-1457" name="__codelineno-0-1457"></a>
+</span><span id="__span-0-1458"><a id="__codelineno-0-1458" name="__codelineno-0-1458"></a><span class="sd">            Fetching a single project and its associated participants where a participant has a specific role:</span>
+</span><span id="__span-0-1459"><a id="__codelineno-0-1459" name="__codelineno-0-1459"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1460"><a id="__codelineno-0-1460" name="__codelineno-0-1460"></a><span class="sd">            joins_config = [</span>
+</span><span id="__span-0-1461"><a id="__codelineno-0-1461" name="__codelineno-0-1461"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1462"><a id="__codelineno-0-1462" name="__codelineno-0-1462"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1463"><a id="__codelineno-0-1463" name="__codelineno-0-1463"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1464"><a id="__codelineno-0-1464" name="__codelineno-0-1464"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1465"><a id="__codelineno-0-1465" name="__codelineno-0-1465"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1466"><a id="__codelineno-0-1466" name="__codelineno-0-1466"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1467"><a id="__codelineno-0-1467" name="__codelineno-0-1467"></a><span class="sd">                    model=Participant,</span>
+</span><span id="__span-0-1468"><a id="__codelineno-0-1468" name="__codelineno-0-1468"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1469"><a id="__codelineno-0-1469" name="__codelineno-0-1469"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1470"><a id="__codelineno-0-1470" name="__codelineno-0-1470"></a><span class="sd">                    filters={&#39;role&#39;: &#39;Designer&#39;},</span>
+</span><span id="__span-0-1471"><a id="__codelineno-0-1471" name="__codelineno-0-1471"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1472"><a id="__codelineno-0-1472" name="__codelineno-0-1472"></a><span class="sd">            ]</span>
+</span><span id="__span-0-1473"><a id="__codelineno-0-1473" name="__codelineno-0-1473"></a><span class="sd">            project = await crud.get_joined(</span>
+</span><span id="__span-0-1474"><a id="__codelineno-0-1474" name="__codelineno-0-1474"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1475"><a id="__codelineno-0-1475" name="__codelineno-0-1475"></a><span class="sd">                schema_to_select=ProjectSchema,</span>
+</span><span id="__span-0-1476"><a id="__codelineno-0-1476" name="__codelineno-0-1476"></a><span class="sd">                joins_config=joins_config,</span>
+</span><span id="__span-0-1477"><a id="__codelineno-0-1477" name="__codelineno-0-1477"></a><span class="sd">            )</span>
+</span><span id="__span-0-1478"><a id="__codelineno-0-1478" name="__codelineno-0-1478"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1479"><a id="__codelineno-0-1479" name="__codelineno-0-1479"></a>
+</span><span id="__span-0-1480"><a id="__codelineno-0-1480" name="__codelineno-0-1480"></a><span class="sd">            Example of using `joins_config` for multiple joins with nested joins enabled:</span>
+</span><span id="__span-0-1481"><a id="__codelineno-0-1481" name="__codelineno-0-1481"></a>
+</span><span id="__span-0-1482"><a id="__codelineno-0-1482" name="__codelineno-0-1482"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1483"><a id="__codelineno-0-1483" name="__codelineno-0-1483"></a><span class="sd">            from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1484"><a id="__codelineno-0-1484" name="__codelineno-0-1484"></a>
+</span><span id="__span-0-1485"><a id="__codelineno-0-1485" name="__codelineno-0-1485"></a><span class="sd">            result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1486"><a id="__codelineno-0-1486" name="__codelineno-0-1486"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1487"><a id="__codelineno-0-1487" name="__codelineno-0-1487"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1488"><a id="__codelineno-0-1488" name="__codelineno-0-1488"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1489"><a id="__codelineno-0-1489" name="__codelineno-0-1489"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1490"><a id="__codelineno-0-1490" name="__codelineno-0-1490"></a><span class="sd">                        model=Tier,</span>
+</span><span id="__span-0-1491"><a id="__codelineno-0-1491" name="__codelineno-0-1491"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1492"><a id="__codelineno-0-1492" name="__codelineno-0-1492"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1493"><a id="__codelineno-0-1493" name="__codelineno-0-1493"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1494"><a id="__codelineno-0-1494" name="__codelineno-0-1494"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1495"><a id="__codelineno-0-1495" name="__codelineno-0-1495"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1496"><a id="__codelineno-0-1496" name="__codelineno-0-1496"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1497"><a id="__codelineno-0-1497" name="__codelineno-0-1497"></a><span class="sd">                        model=Department,</span>
+</span><span id="__span-0-1498"><a id="__codelineno-0-1498" name="__codelineno-0-1498"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1499"><a id="__codelineno-0-1499" name="__codelineno-0-1499"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1500"><a id="__codelineno-0-1500" name="__codelineno-0-1500"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1501"><a id="__codelineno-0-1501" name="__codelineno-0-1501"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1502"><a id="__codelineno-0-1502" name="__codelineno-0-1502"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1503"><a id="__codelineno-0-1503" name="__codelineno-0-1503"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1504"><a id="__codelineno-0-1504" name="__codelineno-0-1504"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1505"><a id="__codelineno-0-1505" name="__codelineno-0-1505"></a><span class="sd">            )</span>
+</span><span id="__span-0-1506"><a id="__codelineno-0-1506" name="__codelineno-0-1506"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;tier&#39; and &#39;dept&#39; as nested dictionaries</span>
+</span><span id="__span-0-1507"><a id="__codelineno-0-1507" name="__codelineno-0-1507"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1508"><a id="__codelineno-0-1508" name="__codelineno-0-1508"></a>
+</span><span id="__span-0-1509"><a id="__codelineno-0-1509" name="__codelineno-0-1509"></a><span class="sd">            Example using one-to-one relationship:</span>
+</span><span id="__span-0-1510"><a id="__codelineno-0-1510" name="__codelineno-0-1510"></a>
+</span><span id="__span-0-1511"><a id="__codelineno-0-1511" name="__codelineno-0-1511"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1512"><a id="__codelineno-0-1512" name="__codelineno-0-1512"></a><span class="sd">            author_crud = FastCRUD(Author)</span>
+</span><span id="__span-0-1513"><a id="__codelineno-0-1513" name="__codelineno-0-1513"></a><span class="sd">            result = await author_crud.get_joined(</span>
+</span><span id="__span-0-1514"><a id="__codelineno-0-1514" name="__codelineno-0-1514"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1515"><a id="__codelineno-0-1515" name="__codelineno-0-1515"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1516"><a id="__codelineno-0-1516" name="__codelineno-0-1516"></a><span class="sd">                join_model=Profile,</span>
+</span><span id="__span-0-1517"><a id="__codelineno-0-1517" name="__codelineno-0-1517"></a><span class="sd">                join_on=Author.profile_id == Profile.id,</span>
+</span><span id="__span-0-1518"><a id="__codelineno-0-1518" name="__codelineno-0-1518"></a><span class="sd">                join_schema_to_select=ReadProfileSchema,</span>
+</span><span id="__span-0-1519"><a id="__codelineno-0-1519" name="__codelineno-0-1519"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1520"><a id="__codelineno-0-1520" name="__codelineno-0-1520"></a><span class="sd">                relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
+</span><span id="__span-0-1521"><a id="__codelineno-0-1521" name="__codelineno-0-1521"></a><span class="sd">            )</span>
+</span><span id="__span-0-1522"><a id="__codelineno-0-1522" name="__codelineno-0-1522"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;profile&#39; as a nested dictionary</span>
+</span><span id="__span-0-1523"><a id="__codelineno-0-1523" name="__codelineno-0-1523"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1524"><a id="__codelineno-0-1524" name="__codelineno-0-1524"></a>
+</span><span id="__span-0-1525"><a id="__codelineno-0-1525" name="__codelineno-0-1525"></a><span class="sd">            Example using one-to-many relationship:</span>
+</span><span id="__span-0-1526"><a id="__codelineno-0-1526" name="__codelineno-0-1526"></a>
+</span><span id="__span-0-1527"><a id="__codelineno-0-1527" name="__codelineno-0-1527"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1528"><a id="__codelineno-0-1528" name="__codelineno-0-1528"></a><span class="sd">            result = await author_crud.get_joined(</span>
+</span><span id="__span-0-1529"><a id="__codelineno-0-1529" name="__codelineno-0-1529"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1530"><a id="__codelineno-0-1530" name="__codelineno-0-1530"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1531"><a id="__codelineno-0-1531" name="__codelineno-0-1531"></a><span class="sd">                join_model=Article,</span>
+</span><span id="__span-0-1532"><a id="__codelineno-0-1532" name="__codelineno-0-1532"></a><span class="sd">                join_on=Author.id == Article.author_id,</span>
+</span><span id="__span-0-1533"><a id="__codelineno-0-1533" name="__codelineno-0-1533"></a><span class="sd">                join_schema_to_select=ReadArticleSchema,</span>
+</span><span id="__span-0-1534"><a id="__codelineno-0-1534" name="__codelineno-0-1534"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1535"><a id="__codelineno-0-1535" name="__codelineno-0-1535"></a><span class="sd">                relationship_type=&#39;one-to-many&#39;,</span>
+</span><span id="__span-0-1536"><a id="__codelineno-0-1536" name="__codelineno-0-1536"></a><span class="sd">            )</span>
+</span><span id="__span-0-1537"><a id="__codelineno-0-1537" name="__codelineno-0-1537"></a><span class="sd">            # Expect &#39;result&#39; to have &#39;posts&#39; as a nested list of dictionaries</span>
+</span><span id="__span-0-1538"><a id="__codelineno-0-1538" name="__codelineno-0-1538"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1539"><a id="__codelineno-0-1539" name="__codelineno-0-1539"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-1540"><a id="__codelineno-0-1540" name="__codelineno-0-1540"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
+</span><span id="__span-0-1541"><a id="__codelineno-0-1541" name="__codelineno-0-1541"></a>            <span class="n">join_model</span> <span class="ow">or</span> <span class="n">join_prefix</span> <span class="ow">or</span> <span class="n">join_on</span> <span class="ow">or</span> <span class="n">join_schema_to_select</span> <span class="ow">or</span> <span class="n">alias</span>
+</span><span id="__span-0-1542"><a id="__codelineno-0-1542" name="__codelineno-0-1542"></a>        <span class="p">):</span>
+</span><span id="__span-0-1543"><a id="__codelineno-0-1543" name="__codelineno-0-1543"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1544"><a id="__codelineno-0-1544" name="__codelineno-0-1544"></a>                <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
+</span><span id="__span-0-1545"><a id="__codelineno-0-1545" name="__codelineno-0-1545"></a>            <span class="p">)</span>
+</span><span id="__span-0-1546"><a id="__codelineno-0-1546" name="__codelineno-0-1546"></a>        <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1547"><a id="__codelineno-0-1547" name="__codelineno-0-1547"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1548"><a id="__codelineno-0-1548" name="__codelineno-0-1548"></a>
+</span><span id="__span-0-1549"><a id="__codelineno-0-1549" name="__codelineno-0-1549"></a>        <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-1550"><a id="__codelineno-0-1550" name="__codelineno-0-1550"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-1551"><a id="__codelineno-0-1551" name="__codelineno-0-1551"></a>            <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1552"><a id="__codelineno-0-1552" name="__codelineno-0-1552"></a>        <span class="p">)</span>
+</span><span id="__span-0-1553"><a id="__codelineno-0-1553" name="__codelineno-0-1553"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-1554"><a id="__codelineno-0-1554" name="__codelineno-0-1554"></a>
+</span><span id="__span-0-1555"><a id="__codelineno-0-1555" name="__codelineno-0-1555"></a>        <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1556"><a id="__codelineno-0-1556" name="__codelineno-0-1556"></a>        <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1557"><a id="__codelineno-0-1557" name="__codelineno-0-1557"></a>            <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="__span-0-1558"><a id="__codelineno-0-1558" name="__codelineno-0-1558"></a>                <span class="n">JoinConfig</span><span class="p">(</span>
+</span><span id="__span-0-1559"><a id="__codelineno-0-1559" name="__codelineno-0-1559"></a>                    <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
+</span><span id="__span-0-1560"><a id="__codelineno-0-1560" name="__codelineno-0-1560"></a>                    <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span><span class="p">,</span>
+</span><span id="__span-0-1561"><a id="__codelineno-0-1561" name="__codelineno-0-1561"></a>                    <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
+</span><span id="__span-0-1562"><a id="__codelineno-0-1562" name="__codelineno-0-1562"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1563"><a id="__codelineno-0-1563" name="__codelineno-0-1563"></a>                    <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
+</span><span id="__span-0-1564"><a id="__codelineno-0-1564" name="__codelineno-0-1564"></a>                    <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
+</span><span id="__span-0-1565"><a id="__codelineno-0-1565" name="__codelineno-0-1565"></a>                    <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
+</span><span id="__span-0-1566"><a id="__codelineno-0-1566" name="__codelineno-0-1566"></a>                    <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
+</span><span id="__span-0-1567"><a id="__codelineno-0-1567" name="__codelineno-0-1567"></a>                <span class="p">)</span>
+</span><span id="__span-0-1568"><a id="__codelineno-0-1568" name="__codelineno-0-1568"></a>            <span class="p">)</span>
+</span><span id="__span-0-1569"><a id="__codelineno-0-1569" name="__codelineno-0-1569"></a>
+</span><span id="__span-0-1570"><a id="__codelineno-0-1570" name="__codelineno-0-1570"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
+</span><span id="__span-0-1571"><a id="__codelineno-0-1571" name="__codelineno-0-1571"></a>            <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
+</span><span id="__span-0-1572"><a id="__codelineno-0-1572" name="__codelineno-0-1572"></a>        <span class="p">)</span>
+</span><span id="__span-0-1573"><a id="__codelineno-0-1573" name="__codelineno-0-1573"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1574"><a id="__codelineno-0-1574" name="__codelineno-0-1574"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1575"><a id="__codelineno-0-1575" name="__codelineno-0-1575"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1576"><a id="__codelineno-0-1576" name="__codelineno-0-1576"></a>
+</span><span id="__span-0-1577"><a id="__codelineno-0-1577" name="__codelineno-0-1577"></a>        <span class="n">db_rows</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1578"><a id="__codelineno-0-1578" name="__codelineno-0-1578"></a>        <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span><span class="p">):</span>
+</span><span id="__span-0-1579"><a id="__codelineno-0-1579" name="__codelineno-0-1579"></a>            <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1580"><a id="__codelineno-0-1580" name="__codelineno-0-1580"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1581"><a id="__codelineno-0-1581" name="__codelineno-0-1581"></a>                    <span class="s2">&quot;Cannot use one-to-many relationship with nest_joins=False&quot;</span>
+</span><span id="__span-0-1582"><a id="__codelineno-0-1582" name="__codelineno-0-1582"></a>                <span class="p">)</span>
+</span><span id="__span-0-1583"><a id="__codelineno-0-1583" name="__codelineno-0-1583"></a>            <span class="n">results</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>
+</span><span id="__span-0-1584"><a id="__codelineno-0-1584" name="__codelineno-0-1584"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
+</span><span id="__span-0-1585"><a id="__codelineno-0-1585" name="__codelineno-0-1585"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1586"><a id="__codelineno-0-1586" name="__codelineno-0-1586"></a>            <span class="n">result</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+</span><span id="__span-0-1587"><a id="__codelineno-0-1587" name="__codelineno-0-1587"></a>            <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1588"><a id="__codelineno-0-1588" name="__codelineno-0-1588"></a>                <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)]</span>
+</span><span id="__span-0-1589"><a id="__codelineno-0-1589" name="__codelineno-0-1589"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1590"><a id="__codelineno-0-1590" name="__codelineno-0-1590"></a>                <span class="n">data_list</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-1591"><a id="__codelineno-0-1591" name="__codelineno-0-1591"></a>
+</span><span id="__span-0-1592"><a id="__codelineno-0-1592" name="__codelineno-0-1592"></a>        <span class="k">if</span> <span class="n">data_list</span><span class="p">:</span>
+</span><span id="__span-0-1593"><a id="__codelineno-0-1593" name="__codelineno-0-1593"></a>            <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
+</span><span id="__span-0-1594"><a id="__codelineno-0-1594" name="__codelineno-0-1594"></a>                <span class="n">nested_data</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-1595"><a id="__codelineno-0-1595" name="__codelineno-0-1595"></a>                <span class="k">for</span> <span class="n">data</span> <span class="ow">in</span> <span class="n">data_list</span><span class="p">:</span>
+</span><span id="__span-0-1596"><a id="__codelineno-0-1596" name="__codelineno-0-1596"></a>                    <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1597"><a id="__codelineno-0-1597" name="__codelineno-0-1597"></a>                        <span class="n">data</span><span class="p">,</span>
+</span><span id="__span-0-1598"><a id="__codelineno-0-1598" name="__codelineno-0-1598"></a>                        <span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1599"><a id="__codelineno-0-1599" name="__codelineno-0-1599"></a>                        <span class="n">nested_data</span><span class="o">=</span><span class="n">nested_data</span><span class="p">,</span>
+</span><span id="__span-0-1600"><a id="__codelineno-0-1600" name="__codelineno-0-1600"></a>                    <span class="p">)</span>
+</span><span id="__span-0-1601"><a id="__codelineno-0-1601" name="__codelineno-0-1601"></a>                <span class="k">return</span> <span class="n">nested_data</span>
+</span><span id="__span-0-1602"><a id="__codelineno-0-1602" name="__codelineno-0-1602"></a>            <span class="k">return</span> <span class="n">data_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+</span><span id="__span-0-1603"><a id="__codelineno-0-1603" name="__codelineno-0-1603"></a>
+</span><span id="__span-0-1604"><a id="__codelineno-0-1604" name="__codelineno-0-1604"></a>        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-1605"><a id="__codelineno-0-1605" name="__codelineno-0-1605"></a>
+</span><span id="__span-0-1606"><a id="__codelineno-0-1606" name="__codelineno-0-1606"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_joined</span><span class="p">(</span>
+</span><span id="__span-0-1607"><a id="__codelineno-0-1607" name="__codelineno-0-1607"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1608"><a id="__codelineno-0-1608" name="__codelineno-0-1608"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1609"><a id="__codelineno-0-1609" name="__codelineno-0-1609"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1610"><a id="__codelineno-0-1610" name="__codelineno-0-1610"></a>        <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1611"><a id="__codelineno-0-1611" name="__codelineno-0-1611"></a>        <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1612"><a id="__codelineno-0-1612" name="__codelineno-0-1612"></a>        <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1613"><a id="__codelineno-0-1613" name="__codelineno-0-1613"></a>        <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1614"><a id="__codelineno-0-1614" name="__codelineno-0-1614"></a>        <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
+</span><span id="__span-0-1615"><a id="__codelineno-0-1615" name="__codelineno-0-1615"></a>        <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1616"><a id="__codelineno-0-1616" name="__codelineno-0-1616"></a>        <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1617"><a id="__codelineno-0-1617" name="__codelineno-0-1617"></a>        <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1618"><a id="__codelineno-0-1618" name="__codelineno-0-1618"></a>        <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+</span><span id="__span-0-1619"><a id="__codelineno-0-1619" name="__codelineno-0-1619"></a>        <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-1620"><a id="__codelineno-0-1620" name="__codelineno-0-1620"></a>        <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1621"><a id="__codelineno-0-1621" name="__codelineno-0-1621"></a>        <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1622"><a id="__codelineno-0-1622" name="__codelineno-0-1622"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1623"><a id="__codelineno-0-1623" name="__codelineno-0-1623"></a>        <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1624"><a id="__codelineno-0-1624" name="__codelineno-0-1624"></a>        <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-1625"><a id="__codelineno-0-1625" name="__codelineno-0-1625"></a>        <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1626"><a id="__codelineno-0-1626" name="__codelineno-0-1626"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1627"><a id="__codelineno-0-1627" name="__codelineno-0-1627"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+</span><span id="__span-0-1628"><a id="__codelineno-0-1628" name="__codelineno-0-1628"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1629"><a id="__codelineno-0-1629" name="__codelineno-0-1629"></a><span class="sd">        Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</span>
+</span><span id="__span-0-1630"><a id="__codelineno-0-1630" name="__codelineno-0-1630"></a>
+</span><span id="__span-0-1631"><a id="__codelineno-0-1631" name="__codelineno-0-1631"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1632"><a id="__codelineno-0-1632" name="__codelineno-0-1632"></a>
+</span><span id="__span-0-1633"><a id="__codelineno-0-1633" name="__codelineno-0-1633"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-1634"><a id="__codelineno-0-1634" name="__codelineno-0-1634"></a><span class="sd">            db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-1635"><a id="__codelineno-0-1635" name="__codelineno-0-1635"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1636"><a id="__codelineno-0-1636" name="__codelineno-0-1636"></a><span class="sd">            join_model: The model to join with.</span>
+</span><span id="__span-0-1637"><a id="__codelineno-0-1637" name="__codelineno-0-1637"></a><span class="sd">            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
+</span><span id="__span-0-1638"><a id="__codelineno-0-1638" name="__codelineno-0-1638"></a><span class="sd">            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
+</span><span id="__span-0-1639"><a id="__codelineno-0-1639" name="__codelineno-0-1639"></a><span class="sd">            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
+</span><span id="__span-0-1640"><a id="__codelineno-0-1640" name="__codelineno-0-1640"></a><span class="sd">            join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
+</span><span id="__span-0-1641"><a id="__codelineno-0-1641" name="__codelineno-0-1641"></a><span class="sd">            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
+</span><span id="__span-0-1642"><a id="__codelineno-0-1642" name="__codelineno-0-1642"></a><span class="sd">            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
+</span><span id="__span-0-1643"><a id="__codelineno-0-1643" name="__codelineno-0-1643"></a><span class="sd">            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
+</span><span id="__span-0-1644"><a id="__codelineno-0-1644" name="__codelineno-0-1644"></a><span class="sd">            offset: The offset (number of records to skip) for pagination.</span>
+</span><span id="__span-0-1645"><a id="__codelineno-0-1645" name="__codelineno-0-1645"></a><span class="sd">            limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
+</span><span id="__span-0-1646"><a id="__codelineno-0-1646" name="__codelineno-0-1646"></a><span class="sd">            sort_columns: A single column name or a list of column names on which to apply sorting.</span>
+</span><span id="__span-0-1647"><a id="__codelineno-0-1647" name="__codelineno-0-1647"></a><span class="sd">            sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
+</span><span id="__span-0-1648"><a id="__codelineno-0-1648" name="__codelineno-0-1648"></a><span class="sd">            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-1649"><a id="__codelineno-0-1649" name="__codelineno-0-1649"></a><span class="sd">            joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</span>
+</span><span id="__span-0-1650"><a id="__codelineno-0-1650" name="__codelineno-0-1650"></a><span class="sd">            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
+</span><span id="__span-0-1651"><a id="__codelineno-0-1651" name="__codelineno-0-1651"></a><span class="sd">            relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
+</span><span id="__span-0-1652"><a id="__codelineno-0-1652" name="__codelineno-0-1652"></a><span class="sd">            **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.</span>
+</span><span id="__span-0-1653"><a id="__codelineno-0-1653" name="__codelineno-0-1653"></a>
+</span><span id="__span-0-1654"><a id="__codelineno-0-1654" name="__codelineno-0-1654"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-1655"><a id="__codelineno-0-1655" name="__codelineno-0-1655"></a><span class="sd">            A dictionary containing the fetched rows under `&quot;data&quot;` key and total count under `&quot;total_count&quot;`.</span>
+</span><span id="__span-0-1656"><a id="__codelineno-0-1656" name="__codelineno-0-1656"></a>
+</span><span id="__span-0-1657"><a id="__codelineno-0-1657" name="__codelineno-0-1657"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-1658"><a id="__codelineno-0-1658" name="__codelineno-0-1658"></a><span class="sd">            ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.</span>
+</span><span id="__span-0-1659"><a id="__codelineno-0-1659" name="__codelineno-0-1659"></a><span class="sd">                        Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.</span>
+</span><span id="__span-0-1660"><a id="__codelineno-0-1660" name="__codelineno-0-1660"></a>
+</span><span id="__span-0-1661"><a id="__codelineno-0-1661" name="__codelineno-0-1661"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-1662"><a id="__codelineno-0-1662" name="__codelineno-0-1662"></a><span class="sd">            Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:</span>
+</span><span id="__span-0-1663"><a id="__codelineno-0-1663" name="__codelineno-0-1663"></a>
+</span><span id="__span-0-1664"><a id="__codelineno-0-1664" name="__codelineno-0-1664"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1665"><a id="__codelineno-0-1665" name="__codelineno-0-1665"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1666"><a id="__codelineno-0-1666" name="__codelineno-0-1666"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1667"><a id="__codelineno-0-1667" name="__codelineno-0-1667"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1668"><a id="__codelineno-0-1668" name="__codelineno-0-1668"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1669"><a id="__codelineno-0-1669" name="__codelineno-0-1669"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
 </span><span id="__span-0-1670"><a id="__codelineno-0-1670" name="__codelineno-0-1670"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1671"><a id="__codelineno-0-1671" name="__codelineno-0-1671"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1672"><a id="__codelineno-0-1672" name="__codelineno-0-1672"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1673"><a id="__codelineno-0-1673" name="__codelineno-0-1673"></a><span class="sd">                age__gt=30,</span>
-</span><span id="__span-0-1674"><a id="__codelineno-0-1674" name="__codelineno-0-1674"></a><span class="sd">            )</span>
-</span><span id="__span-0-1675"><a id="__codelineno-0-1675" name="__codelineno-0-1675"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1676"><a id="__codelineno-0-1676" name="__codelineno-0-1676"></a>
-</span><span id="__span-0-1677"><a id="__codelineno-0-1677" name="__codelineno-0-1677"></a><span class="sd">            Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:</span>
-</span><span id="__span-0-1678"><a id="__codelineno-0-1678" name="__codelineno-0-1678"></a>
-</span><span id="__span-0-1679"><a id="__codelineno-0-1679" name="__codelineno-0-1679"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1680"><a id="__codelineno-0-1680" name="__codelineno-0-1680"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1681"><a id="__codelineno-0-1681" name="__codelineno-0-1681"></a><span class="sd">                db,</span>
-</span><span id="__span-0-1682"><a id="__codelineno-0-1682" name="__codelineno-0-1682"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1683"><a id="__codelineno-0-1683" name="__codelineno-0-1683"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1684"><a id="__codelineno-0-1684" name="__codelineno-0-1684"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1685"><a id="__codelineno-0-1685" name="__codelineno-0-1685"></a><span class="sd">                return_as_model=True,</span>
-</span><span id="__span-0-1686"><a id="__codelineno-0-1686" name="__codelineno-0-1686"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1671"><a id="__codelineno-0-1671" name="__codelineno-0-1671"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1672"><a id="__codelineno-0-1672" name="__codelineno-0-1672"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1673"><a id="__codelineno-0-1673" name="__codelineno-0-1673"></a><span class="sd">            )</span>
+</span><span id="__span-0-1674"><a id="__codelineno-0-1674" name="__codelineno-0-1674"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1675"><a id="__codelineno-0-1675" name="__codelineno-0-1675"></a>
+</span><span id="__span-0-1676"><a id="__codelineno-0-1676" name="__codelineno-0-1676"></a><span class="sd">            Fetch users joined with their tiers, sorted by username, where user&#39;s age is greater than 30:</span>
+</span><span id="__span-0-1677"><a id="__codelineno-0-1677" name="__codelineno-0-1677"></a>
+</span><span id="__span-0-1678"><a id="__codelineno-0-1678" name="__codelineno-0-1678"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1679"><a id="__codelineno-0-1679" name="__codelineno-0-1679"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1680"><a id="__codelineno-0-1680" name="__codelineno-0-1680"></a><span class="sd">                db,</span>
+</span><span id="__span-0-1681"><a id="__codelineno-0-1681" name="__codelineno-0-1681"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1682"><a id="__codelineno-0-1682" name="__codelineno-0-1682"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1683"><a id="__codelineno-0-1683" name="__codelineno-0-1683"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1684"><a id="__codelineno-0-1684" name="__codelineno-0-1684"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1685"><a id="__codelineno-0-1685" name="__codelineno-0-1685"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1686"><a id="__codelineno-0-1686" name="__codelineno-0-1686"></a><span class="sd">                age__gt=30,</span>
 </span><span id="__span-0-1687"><a id="__codelineno-0-1687" name="__codelineno-0-1687"></a><span class="sd">            )</span>
 </span><span id="__span-0-1688"><a id="__codelineno-0-1688" name="__codelineno-0-1688"></a><span class="sd">            ```</span>
 </span><span id="__span-0-1689"><a id="__codelineno-0-1689" name="__codelineno-0-1689"></a>
-</span><span id="__span-0-1690"><a id="__codelineno-0-1690" name="__codelineno-0-1690"></a><span class="sd">            Fetching and sorting by username in descending order, returning as Pydantic model:</span>
+</span><span id="__span-0-1690"><a id="__codelineno-0-1690" name="__codelineno-0-1690"></a><span class="sd">            Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:</span>
 </span><span id="__span-0-1691"><a id="__codelineno-0-1691" name="__codelineno-0-1691"></a>
 </span><span id="__span-0-1692"><a id="__codelineno-0-1692" name="__codelineno-0-1692"></a><span class="sd">            ```python</span>
 </span><span id="__span-0-1693"><a id="__codelineno-0-1693" name="__codelineno-0-1693"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1694"><a id="__codelineno-0-1694" name="__codelineno-0-1694"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1694"><a id="__codelineno-0-1694" name="__codelineno-0-1694"></a><span class="sd">                db,</span>
 </span><span id="__span-0-1695"><a id="__codelineno-0-1695" name="__codelineno-0-1695"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
 </span><span id="__span-0-1696"><a id="__codelineno-0-1696" name="__codelineno-0-1696"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1697"><a id="__codelineno-0-1697" name="__codelineno-0-1697"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1698"><a id="__codelineno-0-1698" name="__codelineno-0-1698"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1699"><a id="__codelineno-0-1699" name="__codelineno-0-1699"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1700"><a id="__codelineno-0-1700" name="__codelineno-0-1700"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1701"><a id="__codelineno-0-1701" name="__codelineno-0-1701"></a><span class="sd">                sort_columns=[&#39;username&#39;],</span>
-</span><span id="__span-0-1702"><a id="__codelineno-0-1702" name="__codelineno-0-1702"></a><span class="sd">                sort_orders=[&#39;desc&#39;],</span>
-</span><span id="__span-0-1703"><a id="__codelineno-0-1703" name="__codelineno-0-1703"></a><span class="sd">                return_as_model=True,</span>
-</span><span id="__span-0-1704"><a id="__codelineno-0-1704" name="__codelineno-0-1704"></a><span class="sd">            )</span>
-</span><span id="__span-0-1705"><a id="__codelineno-0-1705" name="__codelineno-0-1705"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1706"><a id="__codelineno-0-1706" name="__codelineno-0-1706"></a>
-</span><span id="__span-0-1707"><a id="__codelineno-0-1707" name="__codelineno-0-1707"></a><span class="sd">            Fetching with complex conditions and custom join, returning as Pydantic model:</span>
-</span><span id="__span-0-1708"><a id="__codelineno-0-1708" name="__codelineno-0-1708"></a>
-</span><span id="__span-0-1709"><a id="__codelineno-0-1709" name="__codelineno-0-1709"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1710"><a id="__codelineno-0-1710" name="__codelineno-0-1710"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1711"><a id="__codelineno-0-1711" name="__codelineno-0-1711"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1712"><a id="__codelineno-0-1712" name="__codelineno-0-1712"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1713"><a id="__codelineno-0-1713" name="__codelineno-0-1713"></a><span class="sd">                join_model=Tier,</span>
-</span><span id="__span-0-1714"><a id="__codelineno-0-1714" name="__codelineno-0-1714"></a><span class="sd">                join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1715"><a id="__codelineno-0-1715" name="__codelineno-0-1715"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1716"><a id="__codelineno-0-1716" name="__codelineno-0-1716"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1717"><a id="__codelineno-0-1717" name="__codelineno-0-1717"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1718"><a id="__codelineno-0-1718" name="__codelineno-0-1718"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1719"><a id="__codelineno-0-1719" name="__codelineno-0-1719"></a><span class="sd">                return_as_model=True,</span>
-</span><span id="__span-0-1720"><a id="__codelineno-0-1720" name="__codelineno-0-1720"></a><span class="sd">                is_active=True,</span>
-</span><span id="__span-0-1721"><a id="__codelineno-0-1721" name="__codelineno-0-1721"></a><span class="sd">            )</span>
-</span><span id="__span-0-1722"><a id="__codelineno-0-1722" name="__codelineno-0-1722"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1723"><a id="__codelineno-0-1723" name="__codelineno-0-1723"></a>
-</span><span id="__span-0-1724"><a id="__codelineno-0-1724" name="__codelineno-0-1724"></a><span class="sd">            Example using `joins_config` for multiple joins:</span>
-</span><span id="__span-0-1725"><a id="__codelineno-0-1725" name="__codelineno-0-1725"></a>
-</span><span id="__span-0-1726"><a id="__codelineno-0-1726" name="__codelineno-0-1726"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1727"><a id="__codelineno-0-1727" name="__codelineno-0-1727"></a><span class="sd">            from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1728"><a id="__codelineno-0-1728" name="__codelineno-0-1728"></a>
-</span><span id="__span-0-1729"><a id="__codelineno-0-1729" name="__codelineno-0-1729"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1730"><a id="__codelineno-0-1730" name="__codelineno-0-1730"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1731"><a id="__codelineno-0-1731" name="__codelineno-0-1731"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1732"><a id="__codelineno-0-1732" name="__codelineno-0-1732"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1733"><a id="__codelineno-0-1733" name="__codelineno-0-1733"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1734"><a id="__codelineno-0-1734" name="__codelineno-0-1734"></a><span class="sd">                        model=Tier,</span>
-</span><span id="__span-0-1735"><a id="__codelineno-0-1735" name="__codelineno-0-1735"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1736"><a id="__codelineno-0-1736" name="__codelineno-0-1736"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1737"><a id="__codelineno-0-1737" name="__codelineno-0-1737"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1738"><a id="__codelineno-0-1738" name="__codelineno-0-1738"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1739"><a id="__codelineno-0-1739" name="__codelineno-0-1739"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1740"><a id="__codelineno-0-1740" name="__codelineno-0-1740"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1741"><a id="__codelineno-0-1741" name="__codelineno-0-1741"></a><span class="sd">                        model=Department,</span>
-</span><span id="__span-0-1742"><a id="__codelineno-0-1742" name="__codelineno-0-1742"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1743"><a id="__codelineno-0-1743" name="__codelineno-0-1743"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1744"><a id="__codelineno-0-1744" name="__codelineno-0-1744"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1745"><a id="__codelineno-0-1745" name="__codelineno-0-1745"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1746"><a id="__codelineno-0-1746" name="__codelineno-0-1746"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1747"><a id="__codelineno-0-1747" name="__codelineno-0-1747"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1748"><a id="__codelineno-0-1748" name="__codelineno-0-1748"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1749"><a id="__codelineno-0-1749" name="__codelineno-0-1749"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1750"><a id="__codelineno-0-1750" name="__codelineno-0-1750"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1751"><a id="__codelineno-0-1751" name="__codelineno-0-1751"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1752"><a id="__codelineno-0-1752" name="__codelineno-0-1752"></a><span class="sd">            )</span>
-</span><span id="__span-0-1753"><a id="__codelineno-0-1753" name="__codelineno-0-1753"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1754"><a id="__codelineno-0-1754" name="__codelineno-0-1754"></a>
-</span><span id="__span-0-1755"><a id="__codelineno-0-1755" name="__codelineno-0-1755"></a><span class="sd">            Example using `alias` for multiple joins, with pagination, sorting, and model conversion:</span>
-</span><span id="__span-0-1756"><a id="__codelineno-0-1756" name="__codelineno-0-1756"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1757"><a id="__codelineno-0-1757" name="__codelineno-0-1757"></a><span class="sd">            from fastcrud import JoinConfig, FastCRUD, aliased</span>
-</span><span id="__span-0-1758"><a id="__codelineno-0-1758" name="__codelineno-0-1758"></a>
-</span><span id="__span-0-1759"><a id="__codelineno-0-1759" name="__codelineno-0-1759"></a><span class="sd">            # Aliasing for self-joins or multiple joins on the same table</span>
-</span><span id="__span-0-1760"><a id="__codelineno-0-1760" name="__codelineno-0-1760"></a><span class="sd">            owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
-</span><span id="__span-0-1761"><a id="__codelineno-0-1761" name="__codelineno-0-1761"></a><span class="sd">            user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
-</span><span id="__span-0-1762"><a id="__codelineno-0-1762" name="__codelineno-0-1762"></a>
-</span><span id="__span-0-1763"><a id="__codelineno-0-1763" name="__codelineno-0-1763"></a><span class="sd">            # Initialize your FastCRUD instance for BookingModel</span>
-</span><span id="__span-0-1764"><a id="__codelineno-0-1764" name="__codelineno-0-1764"></a><span class="sd">            crud = FastCRUD(BookingModel)</span>
-</span><span id="__span-0-1765"><a id="__codelineno-0-1765" name="__codelineno-0-1765"></a>
-</span><span id="__span-0-1766"><a id="__codelineno-0-1766" name="__codelineno-0-1766"></a><span class="sd">            result = await crud.get_multi_joined(</span>
-</span><span id="__span-0-1767"><a id="__codelineno-0-1767" name="__codelineno-0-1767"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1768"><a id="__codelineno-0-1768" name="__codelineno-0-1768"></a><span class="sd">                schema_to_select=BookingSchema,  # Primary model schema</span>
-</span><span id="__span-0-1769"><a id="__codelineno-0-1769" name="__codelineno-0-1769"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1770"><a id="__codelineno-0-1770" name="__codelineno-0-1770"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1771"><a id="__codelineno-0-1771" name="__codelineno-0-1771"></a><span class="sd">                        model=ModelTest,</span>
-</span><span id="__span-0-1772"><a id="__codelineno-0-1772" name="__codelineno-0-1772"></a><span class="sd">                        join_on=BookingModel.owner_id == owner_alias.id,</span>
-</span><span id="__span-0-1773"><a id="__codelineno-0-1773" name="__codelineno-0-1773"></a><span class="sd">                        join_prefix=&quot;owner_&quot;,</span>
-</span><span id="__span-0-1774"><a id="__codelineno-0-1774" name="__codelineno-0-1774"></a><span class="sd">                        schema_to_select=UserSchema,  # Schema for the joined model</span>
-</span><span id="__span-0-1775"><a id="__codelineno-0-1775" name="__codelineno-0-1775"></a><span class="sd">                        alias=owner_alias,</span>
-</span><span id="__span-0-1776"><a id="__codelineno-0-1776" name="__codelineno-0-1776"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1777"><a id="__codelineno-0-1777" name="__codelineno-0-1777"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1778"><a id="__codelineno-0-1778" name="__codelineno-0-1778"></a><span class="sd">                        model=ModelTest,</span>
-</span><span id="__span-0-1779"><a id="__codelineno-0-1779" name="__codelineno-0-1779"></a><span class="sd">                        join_on=BookingModel.user_id == user_alias.id,</span>
-</span><span id="__span-0-1780"><a id="__codelineno-0-1780" name="__codelineno-0-1780"></a><span class="sd">                        join_prefix=&quot;user_&quot;,</span>
-</span><span id="__span-0-1781"><a id="__codelineno-0-1781" name="__codelineno-0-1781"></a><span class="sd">                        schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1782"><a id="__codelineno-0-1782" name="__codelineno-0-1782"></a><span class="sd">                        alias=user_alias,</span>
-</span><span id="__span-0-1783"><a id="__codelineno-0-1783" name="__codelineno-0-1783"></a><span class="sd">                    )</span>
-</span><span id="__span-0-1784"><a id="__codelineno-0-1784" name="__codelineno-0-1784"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1785"><a id="__codelineno-0-1785" name="__codelineno-0-1785"></a><span class="sd">                offset=10,  # Skip the first 10 records</span>
-</span><span id="__span-0-1786"><a id="__codelineno-0-1786" name="__codelineno-0-1786"></a><span class="sd">                limit=5,  # Fetch up to 5 records</span>
-</span><span id="__span-0-1787"><a id="__codelineno-0-1787" name="__codelineno-0-1787"></a><span class="sd">                sort_columns=[&#39;booking_date&#39;],  # Sort by booking_date</span>
-</span><span id="__span-0-1788"><a id="__codelineno-0-1788" name="__codelineno-0-1788"></a><span class="sd">                sort_orders=[&#39;desc&#39;],  # In descending order</span>
-</span><span id="__span-0-1789"><a id="__codelineno-0-1789" name="__codelineno-0-1789"></a><span class="sd">            )</span>
-</span><span id="__span-0-1790"><a id="__codelineno-0-1790" name="__codelineno-0-1790"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1791"><a id="__codelineno-0-1791" name="__codelineno-0-1791"></a>
-</span><span id="__span-0-1792"><a id="__codelineno-0-1792" name="__codelineno-0-1792"></a><span class="sd">            Fetching multiple project records and their associated participants where participants have a specific role:</span>
-</span><span id="__span-0-1793"><a id="__codelineno-0-1793" name="__codelineno-0-1793"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1794"><a id="__codelineno-0-1794" name="__codelineno-0-1794"></a><span class="sd">            joins_config = [</span>
-</span><span id="__span-0-1795"><a id="__codelineno-0-1795" name="__codelineno-0-1795"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1796"><a id="__codelineno-0-1796" name="__codelineno-0-1796"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1797"><a id="__codelineno-0-1797" name="__codelineno-0-1797"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1798"><a id="__codelineno-0-1798" name="__codelineno-0-1798"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1799"><a id="__codelineno-0-1799" name="__codelineno-0-1799"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1800"><a id="__codelineno-0-1800" name="__codelineno-0-1800"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1801"><a id="__codelineno-0-1801" name="__codelineno-0-1801"></a><span class="sd">                    model=Participant,</span>
-</span><span id="__span-0-1802"><a id="__codelineno-0-1802" name="__codelineno-0-1802"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1803"><a id="__codelineno-0-1803" name="__codelineno-0-1803"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1804"><a id="__codelineno-0-1804" name="__codelineno-0-1804"></a><span class="sd">                    filters={&#39;role&#39;: &#39;Developer&#39;},</span>
-</span><span id="__span-0-1805"><a id="__codelineno-0-1805" name="__codelineno-0-1805"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1806"><a id="__codelineno-0-1806" name="__codelineno-0-1806"></a><span class="sd">            ]</span>
-</span><span id="__span-0-1807"><a id="__codelineno-0-1807" name="__codelineno-0-1807"></a><span class="sd">            projects = await crud.get_multi_joined(</span>
-</span><span id="__span-0-1808"><a id="__codelineno-0-1808" name="__codelineno-0-1808"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1809"><a id="__codelineno-0-1809" name="__codelineno-0-1809"></a><span class="sd">                schema_to_select=ProjectSchema,</span>
-</span><span id="__span-0-1810"><a id="__codelineno-0-1810" name="__codelineno-0-1810"></a><span class="sd">                joins_config=joins_config,</span>
-</span><span id="__span-0-1811"><a id="__codelineno-0-1811" name="__codelineno-0-1811"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1812"><a id="__codelineno-0-1812" name="__codelineno-0-1812"></a><span class="sd">            )</span>
-</span><span id="__span-0-1813"><a id="__codelineno-0-1813" name="__codelineno-0-1813"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1814"><a id="__codelineno-0-1814" name="__codelineno-0-1814"></a>
-</span><span id="__span-0-1815"><a id="__codelineno-0-1815" name="__codelineno-0-1815"></a><span class="sd">            Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</span>
-</span><span id="__span-0-1816"><a id="__codelineno-0-1816" name="__codelineno-0-1816"></a>
-</span><span id="__span-0-1817"><a id="__codelineno-0-1817" name="__codelineno-0-1817"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1818"><a id="__codelineno-0-1818" name="__codelineno-0-1818"></a><span class="sd">            story_crud = FastCRUD(Story)</span>
-</span><span id="__span-0-1819"><a id="__codelineno-0-1819" name="__codelineno-0-1819"></a><span class="sd">            stories = await story_crud.get_multi_joined(</span>
-</span><span id="__span-0-1820"><a id="__codelineno-0-1820" name="__codelineno-0-1820"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1821"><a id="__codelineno-0-1821" name="__codelineno-0-1821"></a><span class="sd">                schema_to_select=ReadStorySchema,</span>
-</span><span id="__span-0-1822"><a id="__codelineno-0-1822" name="__codelineno-0-1822"></a><span class="sd">                joins_config=[</span>
-</span><span id="__span-0-1823"><a id="__codelineno-0-1823" name="__codelineno-0-1823"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1824"><a id="__codelineno-0-1824" name="__codelineno-0-1824"></a><span class="sd">                        model=Task,</span>
-</span><span id="__span-0-1825"><a id="__codelineno-0-1825" name="__codelineno-0-1825"></a><span class="sd">                        join_on=Story.id == Task.story_id,</span>
-</span><span id="__span-0-1826"><a id="__codelineno-0-1826" name="__codelineno-0-1826"></a><span class="sd">                        join_prefix=&quot;task_&quot;,</span>
-</span><span id="__span-0-1827"><a id="__codelineno-0-1827" name="__codelineno-0-1827"></a><span class="sd">                        schema_to_select=ReadTaskSchema,</span>
-</span><span id="__span-0-1828"><a id="__codelineno-0-1828" name="__codelineno-0-1828"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1829"><a id="__codelineno-0-1829" name="__codelineno-0-1829"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1830"><a id="__codelineno-0-1830" name="__codelineno-0-1830"></a><span class="sd">                    JoinConfig(</span>
-</span><span id="__span-0-1831"><a id="__codelineno-0-1831" name="__codelineno-0-1831"></a><span class="sd">                        model=User,</span>
-</span><span id="__span-0-1832"><a id="__codelineno-0-1832" name="__codelineno-0-1832"></a><span class="sd">                        join_on=Task.creator_id == User.id,</span>
-</span><span id="__span-0-1833"><a id="__codelineno-0-1833" name="__codelineno-0-1833"></a><span class="sd">                        join_prefix=&quot;creator_&quot;,</span>
-</span><span id="__span-0-1834"><a id="__codelineno-0-1834" name="__codelineno-0-1834"></a><span class="sd">                        schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1835"><a id="__codelineno-0-1835" name="__codelineno-0-1835"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1836"><a id="__codelineno-0-1836" name="__codelineno-0-1836"></a><span class="sd">                        alias=aliased(User, name=&quot;task_creator&quot;),</span>
-</span><span id="__span-0-1837"><a id="__codelineno-0-1837" name="__codelineno-0-1837"></a><span class="sd">                    ),</span>
-</span><span id="__span-0-1838"><a id="__codelineno-0-1838" name="__codelineno-0-1838"></a><span class="sd">                ],</span>
-</span><span id="__span-0-1839"><a id="__codelineno-0-1839" name="__codelineno-0-1839"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1840"><a id="__codelineno-0-1840" name="__codelineno-0-1840"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1841"><a id="__codelineno-0-1841" name="__codelineno-0-1841"></a><span class="sd">                limit=5,</span>
-</span><span id="__span-0-1842"><a id="__codelineno-0-1842" name="__codelineno-0-1842"></a><span class="sd">                sort_columns=&#39;name&#39;,</span>
-</span><span id="__span-0-1843"><a id="__codelineno-0-1843" name="__codelineno-0-1843"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1844"><a id="__codelineno-0-1844" name="__codelineno-0-1844"></a><span class="sd">            )</span>
-</span><span id="__span-0-1845"><a id="__codelineno-0-1845" name="__codelineno-0-1845"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1846"><a id="__codelineno-0-1846" name="__codelineno-0-1846"></a>
-</span><span id="__span-0-1847"><a id="__codelineno-0-1847" name="__codelineno-0-1847"></a><span class="sd">            Example using one-to-one relationship:</span>
-</span><span id="__span-0-1848"><a id="__codelineno-0-1848" name="__codelineno-0-1848"></a>
-</span><span id="__span-0-1849"><a id="__codelineno-0-1849" name="__codelineno-0-1849"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1850"><a id="__codelineno-0-1850" name="__codelineno-0-1850"></a><span class="sd">            author_crud = FastCRUD(Author)</span>
-</span><span id="__span-0-1851"><a id="__codelineno-0-1851" name="__codelineno-0-1851"></a><span class="sd">            results = await author_crud.get_multi_joined(</span>
-</span><span id="__span-0-1852"><a id="__codelineno-0-1852" name="__codelineno-0-1852"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1853"><a id="__codelineno-0-1853" name="__codelineno-0-1853"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1854"><a id="__codelineno-0-1854" name="__codelineno-0-1854"></a><span class="sd">                join_model=Profile,</span>
-</span><span id="__span-0-1855"><a id="__codelineno-0-1855" name="__codelineno-0-1855"></a><span class="sd">                join_on=Author.profile_id == Profile.id,</span>
-</span><span id="__span-0-1856"><a id="__codelineno-0-1856" name="__codelineno-0-1856"></a><span class="sd">                join_schema_to_select=ReadProfileSchema,</span>
-</span><span id="__span-0-1857"><a id="__codelineno-0-1857" name="__codelineno-0-1857"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1858"><a id="__codelineno-0-1858" name="__codelineno-0-1858"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1859"><a id="__codelineno-0-1859" name="__codelineno-0-1859"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1860"><a id="__codelineno-0-1860" name="__codelineno-0-1860"></a><span class="sd">                relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
-</span><span id="__span-0-1861"><a id="__codelineno-0-1861" name="__codelineno-0-1861"></a><span class="sd">            )</span>
-</span><span id="__span-0-1862"><a id="__codelineno-0-1862" name="__codelineno-0-1862"></a><span class="sd">            # Expect &#39;profile&#39; to be nested as a dictionary under each user</span>
-</span><span id="__span-0-1863"><a id="__codelineno-0-1863" name="__codelineno-0-1863"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1864"><a id="__codelineno-0-1864" name="__codelineno-0-1864"></a>
-</span><span id="__span-0-1865"><a id="__codelineno-0-1865" name="__codelineno-0-1865"></a><span class="sd">            Example using one-to-many relationship:</span>
-</span><span id="__span-0-1866"><a id="__codelineno-0-1866" name="__codelineno-0-1866"></a>
-</span><span id="__span-0-1867"><a id="__codelineno-0-1867" name="__codelineno-0-1867"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-1868"><a id="__codelineno-0-1868" name="__codelineno-0-1868"></a><span class="sd">            results = await author_crud.get_multi_joined(</span>
-</span><span id="__span-0-1869"><a id="__codelineno-0-1869" name="__codelineno-0-1869"></a><span class="sd">                db=session,</span>
-</span><span id="__span-0-1870"><a id="__codelineno-0-1870" name="__codelineno-0-1870"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1871"><a id="__codelineno-0-1871" name="__codelineno-0-1871"></a><span class="sd">                join_model=Article,</span>
-</span><span id="__span-0-1872"><a id="__codelineno-0-1872" name="__codelineno-0-1872"></a><span class="sd">                join_on=Author.id == Article.author_id,</span>
-</span><span id="__span-0-1873"><a id="__codelineno-0-1873" name="__codelineno-0-1873"></a><span class="sd">                join_schema_to_select=ReadArticleSchema,</span>
-</span><span id="__span-0-1874"><a id="__codelineno-0-1874" name="__codelineno-0-1874"></a><span class="sd">                nest_joins=True,</span>
-</span><span id="__span-0-1875"><a id="__codelineno-0-1875" name="__codelineno-0-1875"></a><span class="sd">                offset=0,</span>
-</span><span id="__span-0-1876"><a id="__codelineno-0-1876" name="__codelineno-0-1876"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-1877"><a id="__codelineno-0-1877" name="__codelineno-0-1877"></a><span class="sd">                relationship_type=&#39;one-to-many&#39;,</span>
-</span><span id="__span-0-1878"><a id="__codelineno-0-1878" name="__codelineno-0-1878"></a><span class="sd">            )</span>
-</span><span id="__span-0-1879"><a id="__codelineno-0-1879" name="__codelineno-0-1879"></a><span class="sd">            # Expect &#39;posts&#39; to be nested as a list of dictionaries under each user</span>
-</span><span id="__span-0-1880"><a id="__codelineno-0-1880" name="__codelineno-0-1880"></a><span class="sd">            ```</span>
-</span><span id="__span-0-1881"><a id="__codelineno-0-1881" name="__codelineno-0-1881"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-1882"><a id="__codelineno-0-1882" name="__codelineno-0-1882"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
-</span><span id="__span-0-1883"><a id="__codelineno-0-1883" name="__codelineno-0-1883"></a>            <span class="n">join_model</span>
-</span><span id="__span-0-1884"><a id="__codelineno-0-1884" name="__codelineno-0-1884"></a>            <span class="ow">or</span> <span class="n">join_prefix</span>
-</span><span id="__span-0-1885"><a id="__codelineno-0-1885" name="__codelineno-0-1885"></a>            <span class="ow">or</span> <span class="n">join_on</span>
-</span><span id="__span-0-1886"><a id="__codelineno-0-1886" name="__codelineno-0-1886"></a>            <span class="ow">or</span> <span class="n">join_schema_to_select</span>
-</span><span id="__span-0-1887"><a id="__codelineno-0-1887" name="__codelineno-0-1887"></a>            <span class="ow">or</span> <span class="n">alias</span>
-</span><span id="__span-0-1888"><a id="__codelineno-0-1888" name="__codelineno-0-1888"></a>            <span class="ow">or</span> <span class="n">relationship_type</span>
-</span><span id="__span-0-1889"><a id="__codelineno-0-1889" name="__codelineno-0-1889"></a>        <span class="p">):</span>
-</span><span id="__span-0-1890"><a id="__codelineno-0-1890" name="__codelineno-0-1890"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1891"><a id="__codelineno-0-1891" name="__codelineno-0-1891"></a>                <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
-</span><span id="__span-0-1892"><a id="__codelineno-0-1892" name="__codelineno-0-1892"></a>            <span class="p">)</span>
-</span><span id="__span-0-1893"><a id="__codelineno-0-1893" name="__codelineno-0-1893"></a>        <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1894"><a id="__codelineno-0-1894" name="__codelineno-0-1894"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1895"><a id="__codelineno-0-1895" name="__codelineno-0-1895"></a>
-</span><span id="__span-0-1896"><a id="__codelineno-0-1896" name="__codelineno-0-1896"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-1897"><a id="__codelineno-0-1897" name="__codelineno-0-1897"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1898"><a id="__codelineno-0-1898" name="__codelineno-0-1898"></a>
-</span><span id="__span-0-1899"><a id="__codelineno-0-1899" name="__codelineno-0-1899"></a>        <span class="k">if</span> <span class="n">relationship_type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1900"><a id="__codelineno-0-1900" name="__codelineno-0-1900"></a>            <span class="n">relationship_type</span> <span class="o">=</span> <span class="s2">&quot;one-to-one&quot;</span>
-</span><span id="__span-0-1901"><a id="__codelineno-0-1901" name="__codelineno-0-1901"></a>
-</span><span id="__span-0-1902"><a id="__codelineno-0-1902" name="__codelineno-0-1902"></a>        <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-1903"><a id="__codelineno-0-1903" name="__codelineno-0-1903"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1904"><a id="__codelineno-0-1904" name="__codelineno-0-1904"></a>        <span class="p">)</span>
-</span><span id="__span-0-1905"><a id="__codelineno-0-1905" name="__codelineno-0-1905"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span>
-</span><span id="__span-0-1906"><a id="__codelineno-0-1906" name="__codelineno-0-1906"></a>
-</span><span id="__span-0-1907"><a id="__codelineno-0-1907" name="__codelineno-0-1907"></a>        <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1908"><a id="__codelineno-0-1908" name="__codelineno-0-1908"></a>        <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1909"><a id="__codelineno-0-1909" name="__codelineno-0-1909"></a>            <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="__span-0-1910"><a id="__codelineno-0-1910" name="__codelineno-0-1910"></a>                <span class="n">JoinConfig</span><span class="p">(</span>
-</span><span id="__span-0-1911"><a id="__codelineno-0-1911" name="__codelineno-0-1911"></a>                    <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
-</span><span id="__span-0-1912"><a id="__codelineno-0-1912" name="__codelineno-0-1912"></a>                    <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span>
-</span><span id="__span-0-1913"><a id="__codelineno-0-1913" name="__codelineno-0-1913"></a>                    <span class="ow">or</span> <span class="n">_auto_detect_join_condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">join_model</span><span class="p">),</span>
-</span><span id="__span-0-1914"><a id="__codelineno-0-1914" name="__codelineno-0-1914"></a>                    <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
-</span><span id="__span-0-1915"><a id="__codelineno-0-1915" name="__codelineno-0-1915"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1916"><a id="__codelineno-0-1916" name="__codelineno-0-1916"></a>                    <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
-</span><span id="__span-0-1917"><a id="__codelineno-0-1917" name="__codelineno-0-1917"></a>                    <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
-</span><span id="__span-0-1918"><a id="__codelineno-0-1918" name="__codelineno-0-1918"></a>                    <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
-</span><span id="__span-0-1919"><a id="__codelineno-0-1919" name="__codelineno-0-1919"></a>                    <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
-</span><span id="__span-0-1920"><a id="__codelineno-0-1920" name="__codelineno-0-1920"></a>                <span class="p">)</span>
-</span><span id="__span-0-1921"><a id="__codelineno-0-1921" name="__codelineno-0-1921"></a>            <span class="p">)</span>
-</span><span id="__span-0-1922"><a id="__codelineno-0-1922" name="__codelineno-0-1922"></a>
-</span><span id="__span-0-1923"><a id="__codelineno-0-1923" name="__codelineno-0-1923"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
-</span><span id="__span-0-1924"><a id="__codelineno-0-1924" name="__codelineno-0-1924"></a>            <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
-</span><span id="__span-0-1925"><a id="__codelineno-0-1925" name="__codelineno-0-1925"></a>        <span class="p">)</span>
-</span><span id="__span-0-1926"><a id="__codelineno-0-1926" name="__codelineno-0-1926"></a>
-</span><span id="__span-0-1927"><a id="__codelineno-0-1927" name="__codelineno-0-1927"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1928"><a id="__codelineno-0-1928" name="__codelineno-0-1928"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1929"><a id="__codelineno-0-1929" name="__codelineno-0-1929"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1930"><a id="__codelineno-0-1930" name="__codelineno-0-1930"></a>
-</span><span id="__span-0-1931"><a id="__codelineno-0-1931" name="__codelineno-0-1931"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-1932"><a id="__codelineno-0-1932" name="__codelineno-0-1932"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
-</span><span id="__span-0-1933"><a id="__codelineno-0-1933" name="__codelineno-0-1933"></a>
-</span><span id="__span-0-1934"><a id="__codelineno-0-1934" name="__codelineno-0-1934"></a>        <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
-</span><span id="__span-0-1935"><a id="__codelineno-0-1935" name="__codelineno-0-1935"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
-</span><span id="__span-0-1936"><a id="__codelineno-0-1936" name="__codelineno-0-1936"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1937"><a id="__codelineno-0-1937" name="__codelineno-0-1937"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-1938"><a id="__codelineno-0-1938" name="__codelineno-0-1938"></a>
-</span><span id="__span-0-1939"><a id="__codelineno-0-1939" name="__codelineno-0-1939"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1940"><a id="__codelineno-0-1940" name="__codelineno-0-1940"></a>        <span class="n">data</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-1941"><a id="__codelineno-0-1941" name="__codelineno-0-1941"></a>
-</span><span id="__span-0-1942"><a id="__codelineno-0-1942" name="__codelineno-0-1942"></a>        <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()</span><span class="o">.</span><span class="n">all</span><span class="p">():</span>
-</span><span id="__span-0-1943"><a id="__codelineno-0-1943" name="__codelineno-0-1943"></a>            <span class="n">row_dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
-</span><span id="__span-0-1944"><a id="__codelineno-0-1944" name="__codelineno-0-1944"></a>
-</span><span id="__span-0-1945"><a id="__codelineno-0-1945" name="__codelineno-0-1945"></a>            <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
-</span><span id="__span-0-1946"><a id="__codelineno-0-1946" name="__codelineno-0-1946"></a>                <span class="n">row_dict</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1947"><a id="__codelineno-0-1947" name="__codelineno-0-1947"></a>                    <span class="n">data</span><span class="o">=</span><span class="n">row_dict</span><span class="p">,</span>
-</span><span id="__span-0-1948"><a id="__codelineno-0-1948" name="__codelineno-0-1948"></a>                    <span class="n">join_definitions</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1949"><a id="__codelineno-0-1949" name="__codelineno-0-1949"></a>                <span class="p">)</span>
+</span><span id="__span-0-1697"><a id="__codelineno-0-1697" name="__codelineno-0-1697"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1698"><a id="__codelineno-0-1698" name="__codelineno-0-1698"></a><span class="sd">                return_as_model=True,</span>
+</span><span id="__span-0-1699"><a id="__codelineno-0-1699" name="__codelineno-0-1699"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1700"><a id="__codelineno-0-1700" name="__codelineno-0-1700"></a><span class="sd">            )</span>
+</span><span id="__span-0-1701"><a id="__codelineno-0-1701" name="__codelineno-0-1701"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1702"><a id="__codelineno-0-1702" name="__codelineno-0-1702"></a>
+</span><span id="__span-0-1703"><a id="__codelineno-0-1703" name="__codelineno-0-1703"></a><span class="sd">            Fetching and sorting by username in descending order, returning as Pydantic model:</span>
+</span><span id="__span-0-1704"><a id="__codelineno-0-1704" name="__codelineno-0-1704"></a>
+</span><span id="__span-0-1705"><a id="__codelineno-0-1705" name="__codelineno-0-1705"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1706"><a id="__codelineno-0-1706" name="__codelineno-0-1706"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1707"><a id="__codelineno-0-1707" name="__codelineno-0-1707"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1708"><a id="__codelineno-0-1708" name="__codelineno-0-1708"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1709"><a id="__codelineno-0-1709" name="__codelineno-0-1709"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1710"><a id="__codelineno-0-1710" name="__codelineno-0-1710"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1711"><a id="__codelineno-0-1711" name="__codelineno-0-1711"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1712"><a id="__codelineno-0-1712" name="__codelineno-0-1712"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1713"><a id="__codelineno-0-1713" name="__codelineno-0-1713"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1714"><a id="__codelineno-0-1714" name="__codelineno-0-1714"></a><span class="sd">                sort_columns=[&#39;username&#39;],</span>
+</span><span id="__span-0-1715"><a id="__codelineno-0-1715" name="__codelineno-0-1715"></a><span class="sd">                sort_orders=[&#39;desc&#39;],</span>
+</span><span id="__span-0-1716"><a id="__codelineno-0-1716" name="__codelineno-0-1716"></a><span class="sd">                return_as_model=True,</span>
+</span><span id="__span-0-1717"><a id="__codelineno-0-1717" name="__codelineno-0-1717"></a><span class="sd">            )</span>
+</span><span id="__span-0-1718"><a id="__codelineno-0-1718" name="__codelineno-0-1718"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1719"><a id="__codelineno-0-1719" name="__codelineno-0-1719"></a>
+</span><span id="__span-0-1720"><a id="__codelineno-0-1720" name="__codelineno-0-1720"></a><span class="sd">            Fetching with complex conditions and custom join, returning as Pydantic model:</span>
+</span><span id="__span-0-1721"><a id="__codelineno-0-1721" name="__codelineno-0-1721"></a>
+</span><span id="__span-0-1722"><a id="__codelineno-0-1722" name="__codelineno-0-1722"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1723"><a id="__codelineno-0-1723" name="__codelineno-0-1723"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1724"><a id="__codelineno-0-1724" name="__codelineno-0-1724"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1725"><a id="__codelineno-0-1725" name="__codelineno-0-1725"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1726"><a id="__codelineno-0-1726" name="__codelineno-0-1726"></a><span class="sd">                join_model=Tier,</span>
+</span><span id="__span-0-1727"><a id="__codelineno-0-1727" name="__codelineno-0-1727"></a><span class="sd">                join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1728"><a id="__codelineno-0-1728" name="__codelineno-0-1728"></a><span class="sd">                join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1729"><a id="__codelineno-0-1729" name="__codelineno-0-1729"></a><span class="sd">                join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1730"><a id="__codelineno-0-1730" name="__codelineno-0-1730"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1731"><a id="__codelineno-0-1731" name="__codelineno-0-1731"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1732"><a id="__codelineno-0-1732" name="__codelineno-0-1732"></a><span class="sd">                return_as_model=True,</span>
+</span><span id="__span-0-1733"><a id="__codelineno-0-1733" name="__codelineno-0-1733"></a><span class="sd">                is_active=True,</span>
+</span><span id="__span-0-1734"><a id="__codelineno-0-1734" name="__codelineno-0-1734"></a><span class="sd">            )</span>
+</span><span id="__span-0-1735"><a id="__codelineno-0-1735" name="__codelineno-0-1735"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1736"><a id="__codelineno-0-1736" name="__codelineno-0-1736"></a>
+</span><span id="__span-0-1737"><a id="__codelineno-0-1737" name="__codelineno-0-1737"></a><span class="sd">            Example using `joins_config` for multiple joins:</span>
+</span><span id="__span-0-1738"><a id="__codelineno-0-1738" name="__codelineno-0-1738"></a>
+</span><span id="__span-0-1739"><a id="__codelineno-0-1739" name="__codelineno-0-1739"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1740"><a id="__codelineno-0-1740" name="__codelineno-0-1740"></a><span class="sd">            from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1741"><a id="__codelineno-0-1741" name="__codelineno-0-1741"></a>
+</span><span id="__span-0-1742"><a id="__codelineno-0-1742" name="__codelineno-0-1742"></a><span class="sd">            users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1743"><a id="__codelineno-0-1743" name="__codelineno-0-1743"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1744"><a id="__codelineno-0-1744" name="__codelineno-0-1744"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1745"><a id="__codelineno-0-1745" name="__codelineno-0-1745"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1746"><a id="__codelineno-0-1746" name="__codelineno-0-1746"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1747"><a id="__codelineno-0-1747" name="__codelineno-0-1747"></a><span class="sd">                        model=Tier,</span>
+</span><span id="__span-0-1748"><a id="__codelineno-0-1748" name="__codelineno-0-1748"></a><span class="sd">                        join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1749"><a id="__codelineno-0-1749" name="__codelineno-0-1749"></a><span class="sd">                        join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1750"><a id="__codelineno-0-1750" name="__codelineno-0-1750"></a><span class="sd">                        schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1751"><a id="__codelineno-0-1751" name="__codelineno-0-1751"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1752"><a id="__codelineno-0-1752" name="__codelineno-0-1752"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1753"><a id="__codelineno-0-1753" name="__codelineno-0-1753"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1754"><a id="__codelineno-0-1754" name="__codelineno-0-1754"></a><span class="sd">                        model=Department,</span>
+</span><span id="__span-0-1755"><a id="__codelineno-0-1755" name="__codelineno-0-1755"></a><span class="sd">                        join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1756"><a id="__codelineno-0-1756" name="__codelineno-0-1756"></a><span class="sd">                        join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1757"><a id="__codelineno-0-1757" name="__codelineno-0-1757"></a><span class="sd">                        schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1758"><a id="__codelineno-0-1758" name="__codelineno-0-1758"></a><span class="sd">                        join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1759"><a id="__codelineno-0-1759" name="__codelineno-0-1759"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1760"><a id="__codelineno-0-1760" name="__codelineno-0-1760"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1761"><a id="__codelineno-0-1761" name="__codelineno-0-1761"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1762"><a id="__codelineno-0-1762" name="__codelineno-0-1762"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1763"><a id="__codelineno-0-1763" name="__codelineno-0-1763"></a><span class="sd">                sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1764"><a id="__codelineno-0-1764" name="__codelineno-0-1764"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1765"><a id="__codelineno-0-1765" name="__codelineno-0-1765"></a><span class="sd">            )</span>
+</span><span id="__span-0-1766"><a id="__codelineno-0-1766" name="__codelineno-0-1766"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1767"><a id="__codelineno-0-1767" name="__codelineno-0-1767"></a>
+</span><span id="__span-0-1768"><a id="__codelineno-0-1768" name="__codelineno-0-1768"></a><span class="sd">            Example using `alias` for multiple joins, with pagination, sorting, and model conversion:</span>
+</span><span id="__span-0-1769"><a id="__codelineno-0-1769" name="__codelineno-0-1769"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1770"><a id="__codelineno-0-1770" name="__codelineno-0-1770"></a><span class="sd">            from fastcrud import JoinConfig, FastCRUD, aliased</span>
+</span><span id="__span-0-1771"><a id="__codelineno-0-1771" name="__codelineno-0-1771"></a>
+</span><span id="__span-0-1772"><a id="__codelineno-0-1772" name="__codelineno-0-1772"></a><span class="sd">            # Aliasing for self-joins or multiple joins on the same table</span>
+</span><span id="__span-0-1773"><a id="__codelineno-0-1773" name="__codelineno-0-1773"></a><span class="sd">            owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
+</span><span id="__span-0-1774"><a id="__codelineno-0-1774" name="__codelineno-0-1774"></a><span class="sd">            user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
+</span><span id="__span-0-1775"><a id="__codelineno-0-1775" name="__codelineno-0-1775"></a>
+</span><span id="__span-0-1776"><a id="__codelineno-0-1776" name="__codelineno-0-1776"></a><span class="sd">            # Initialize your FastCRUD instance for BookingModel</span>
+</span><span id="__span-0-1777"><a id="__codelineno-0-1777" name="__codelineno-0-1777"></a><span class="sd">            crud = FastCRUD(BookingModel)</span>
+</span><span id="__span-0-1778"><a id="__codelineno-0-1778" name="__codelineno-0-1778"></a>
+</span><span id="__span-0-1779"><a id="__codelineno-0-1779" name="__codelineno-0-1779"></a><span class="sd">            result = await crud.get_multi_joined(</span>
+</span><span id="__span-0-1780"><a id="__codelineno-0-1780" name="__codelineno-0-1780"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1781"><a id="__codelineno-0-1781" name="__codelineno-0-1781"></a><span class="sd">                schema_to_select=BookingSchema,  # Primary model schema</span>
+</span><span id="__span-0-1782"><a id="__codelineno-0-1782" name="__codelineno-0-1782"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1783"><a id="__codelineno-0-1783" name="__codelineno-0-1783"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1784"><a id="__codelineno-0-1784" name="__codelineno-0-1784"></a><span class="sd">                        model=ModelTest,</span>
+</span><span id="__span-0-1785"><a id="__codelineno-0-1785" name="__codelineno-0-1785"></a><span class="sd">                        join_on=BookingModel.owner_id == owner_alias.id,</span>
+</span><span id="__span-0-1786"><a id="__codelineno-0-1786" name="__codelineno-0-1786"></a><span class="sd">                        join_prefix=&quot;owner_&quot;,</span>
+</span><span id="__span-0-1787"><a id="__codelineno-0-1787" name="__codelineno-0-1787"></a><span class="sd">                        schema_to_select=UserSchema,  # Schema for the joined model</span>
+</span><span id="__span-0-1788"><a id="__codelineno-0-1788" name="__codelineno-0-1788"></a><span class="sd">                        alias=owner_alias,</span>
+</span><span id="__span-0-1789"><a id="__codelineno-0-1789" name="__codelineno-0-1789"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1790"><a id="__codelineno-0-1790" name="__codelineno-0-1790"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1791"><a id="__codelineno-0-1791" name="__codelineno-0-1791"></a><span class="sd">                        model=ModelTest,</span>
+</span><span id="__span-0-1792"><a id="__codelineno-0-1792" name="__codelineno-0-1792"></a><span class="sd">                        join_on=BookingModel.user_id == user_alias.id,</span>
+</span><span id="__span-0-1793"><a id="__codelineno-0-1793" name="__codelineno-0-1793"></a><span class="sd">                        join_prefix=&quot;user_&quot;,</span>
+</span><span id="__span-0-1794"><a id="__codelineno-0-1794" name="__codelineno-0-1794"></a><span class="sd">                        schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1795"><a id="__codelineno-0-1795" name="__codelineno-0-1795"></a><span class="sd">                        alias=user_alias,</span>
+</span><span id="__span-0-1796"><a id="__codelineno-0-1796" name="__codelineno-0-1796"></a><span class="sd">                    )</span>
+</span><span id="__span-0-1797"><a id="__codelineno-0-1797" name="__codelineno-0-1797"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1798"><a id="__codelineno-0-1798" name="__codelineno-0-1798"></a><span class="sd">                offset=10,  # Skip the first 10 records</span>
+</span><span id="__span-0-1799"><a id="__codelineno-0-1799" name="__codelineno-0-1799"></a><span class="sd">                limit=5,  # Fetch up to 5 records</span>
+</span><span id="__span-0-1800"><a id="__codelineno-0-1800" name="__codelineno-0-1800"></a><span class="sd">                sort_columns=[&#39;booking_date&#39;],  # Sort by booking_date</span>
+</span><span id="__span-0-1801"><a id="__codelineno-0-1801" name="__codelineno-0-1801"></a><span class="sd">                sort_orders=[&#39;desc&#39;],  # In descending order</span>
+</span><span id="__span-0-1802"><a id="__codelineno-0-1802" name="__codelineno-0-1802"></a><span class="sd">            )</span>
+</span><span id="__span-0-1803"><a id="__codelineno-0-1803" name="__codelineno-0-1803"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1804"><a id="__codelineno-0-1804" name="__codelineno-0-1804"></a>
+</span><span id="__span-0-1805"><a id="__codelineno-0-1805" name="__codelineno-0-1805"></a><span class="sd">            Fetching multiple project records and their associated participants where participants have a specific role:</span>
+</span><span id="__span-0-1806"><a id="__codelineno-0-1806" name="__codelineno-0-1806"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1807"><a id="__codelineno-0-1807" name="__codelineno-0-1807"></a><span class="sd">            joins_config = [</span>
+</span><span id="__span-0-1808"><a id="__codelineno-0-1808" name="__codelineno-0-1808"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1809"><a id="__codelineno-0-1809" name="__codelineno-0-1809"></a><span class="sd">                    model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1810"><a id="__codelineno-0-1810" name="__codelineno-0-1810"></a><span class="sd">                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1811"><a id="__codelineno-0-1811" name="__codelineno-0-1811"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1812"><a id="__codelineno-0-1812" name="__codelineno-0-1812"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1813"><a id="__codelineno-0-1813" name="__codelineno-0-1813"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1814"><a id="__codelineno-0-1814" name="__codelineno-0-1814"></a><span class="sd">                    model=Participant,</span>
+</span><span id="__span-0-1815"><a id="__codelineno-0-1815" name="__codelineno-0-1815"></a><span class="sd">                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1816"><a id="__codelineno-0-1816" name="__codelineno-0-1816"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1817"><a id="__codelineno-0-1817" name="__codelineno-0-1817"></a><span class="sd">                    filters={&#39;role&#39;: &#39;Developer&#39;},</span>
+</span><span id="__span-0-1818"><a id="__codelineno-0-1818" name="__codelineno-0-1818"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1819"><a id="__codelineno-0-1819" name="__codelineno-0-1819"></a><span class="sd">            ]</span>
+</span><span id="__span-0-1820"><a id="__codelineno-0-1820" name="__codelineno-0-1820"></a><span class="sd">            projects = await crud.get_multi_joined(</span>
+</span><span id="__span-0-1821"><a id="__codelineno-0-1821" name="__codelineno-0-1821"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1822"><a id="__codelineno-0-1822" name="__codelineno-0-1822"></a><span class="sd">                schema_to_select=ProjectSchema,</span>
+</span><span id="__span-0-1823"><a id="__codelineno-0-1823" name="__codelineno-0-1823"></a><span class="sd">                joins_config=joins_config,</span>
+</span><span id="__span-0-1824"><a id="__codelineno-0-1824" name="__codelineno-0-1824"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1825"><a id="__codelineno-0-1825" name="__codelineno-0-1825"></a><span class="sd">            )</span>
+</span><span id="__span-0-1826"><a id="__codelineno-0-1826" name="__codelineno-0-1826"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1827"><a id="__codelineno-0-1827" name="__codelineno-0-1827"></a>
+</span><span id="__span-0-1828"><a id="__codelineno-0-1828" name="__codelineno-0-1828"></a><span class="sd">            Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</span>
+</span><span id="__span-0-1829"><a id="__codelineno-0-1829" name="__codelineno-0-1829"></a>
+</span><span id="__span-0-1830"><a id="__codelineno-0-1830" name="__codelineno-0-1830"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1831"><a id="__codelineno-0-1831" name="__codelineno-0-1831"></a><span class="sd">            story_crud = FastCRUD(Story)</span>
+</span><span id="__span-0-1832"><a id="__codelineno-0-1832" name="__codelineno-0-1832"></a><span class="sd">            stories = await story_crud.get_multi_joined(</span>
+</span><span id="__span-0-1833"><a id="__codelineno-0-1833" name="__codelineno-0-1833"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1834"><a id="__codelineno-0-1834" name="__codelineno-0-1834"></a><span class="sd">                schema_to_select=ReadStorySchema,</span>
+</span><span id="__span-0-1835"><a id="__codelineno-0-1835" name="__codelineno-0-1835"></a><span class="sd">                joins_config=[</span>
+</span><span id="__span-0-1836"><a id="__codelineno-0-1836" name="__codelineno-0-1836"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1837"><a id="__codelineno-0-1837" name="__codelineno-0-1837"></a><span class="sd">                        model=Task,</span>
+</span><span id="__span-0-1838"><a id="__codelineno-0-1838" name="__codelineno-0-1838"></a><span class="sd">                        join_on=Story.id == Task.story_id,</span>
+</span><span id="__span-0-1839"><a id="__codelineno-0-1839" name="__codelineno-0-1839"></a><span class="sd">                        join_prefix=&quot;task_&quot;,</span>
+</span><span id="__span-0-1840"><a id="__codelineno-0-1840" name="__codelineno-0-1840"></a><span class="sd">                        schema_to_select=ReadTaskSchema,</span>
+</span><span id="__span-0-1841"><a id="__codelineno-0-1841" name="__codelineno-0-1841"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1842"><a id="__codelineno-0-1842" name="__codelineno-0-1842"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1843"><a id="__codelineno-0-1843" name="__codelineno-0-1843"></a><span class="sd">                    JoinConfig(</span>
+</span><span id="__span-0-1844"><a id="__codelineno-0-1844" name="__codelineno-0-1844"></a><span class="sd">                        model=User,</span>
+</span><span id="__span-0-1845"><a id="__codelineno-0-1845" name="__codelineno-0-1845"></a><span class="sd">                        join_on=Task.creator_id == User.id,</span>
+</span><span id="__span-0-1846"><a id="__codelineno-0-1846" name="__codelineno-0-1846"></a><span class="sd">                        join_prefix=&quot;creator_&quot;,</span>
+</span><span id="__span-0-1847"><a id="__codelineno-0-1847" name="__codelineno-0-1847"></a><span class="sd">                        schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1848"><a id="__codelineno-0-1848" name="__codelineno-0-1848"></a><span class="sd">                        join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1849"><a id="__codelineno-0-1849" name="__codelineno-0-1849"></a><span class="sd">                        alias=aliased(User, name=&quot;task_creator&quot;),</span>
+</span><span id="__span-0-1850"><a id="__codelineno-0-1850" name="__codelineno-0-1850"></a><span class="sd">                    ),</span>
+</span><span id="__span-0-1851"><a id="__codelineno-0-1851" name="__codelineno-0-1851"></a><span class="sd">                ],</span>
+</span><span id="__span-0-1852"><a id="__codelineno-0-1852" name="__codelineno-0-1852"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1853"><a id="__codelineno-0-1853" name="__codelineno-0-1853"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1854"><a id="__codelineno-0-1854" name="__codelineno-0-1854"></a><span class="sd">                limit=5,</span>
+</span><span id="__span-0-1855"><a id="__codelineno-0-1855" name="__codelineno-0-1855"></a><span class="sd">                sort_columns=&#39;name&#39;,</span>
+</span><span id="__span-0-1856"><a id="__codelineno-0-1856" name="__codelineno-0-1856"></a><span class="sd">                sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1857"><a id="__codelineno-0-1857" name="__codelineno-0-1857"></a><span class="sd">            )</span>
+</span><span id="__span-0-1858"><a id="__codelineno-0-1858" name="__codelineno-0-1858"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1859"><a id="__codelineno-0-1859" name="__codelineno-0-1859"></a>
+</span><span id="__span-0-1860"><a id="__codelineno-0-1860" name="__codelineno-0-1860"></a><span class="sd">            Example using one-to-one relationship:</span>
+</span><span id="__span-0-1861"><a id="__codelineno-0-1861" name="__codelineno-0-1861"></a>
+</span><span id="__span-0-1862"><a id="__codelineno-0-1862" name="__codelineno-0-1862"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1863"><a id="__codelineno-0-1863" name="__codelineno-0-1863"></a><span class="sd">            author_crud = FastCRUD(Author)</span>
+</span><span id="__span-0-1864"><a id="__codelineno-0-1864" name="__codelineno-0-1864"></a><span class="sd">            results = await author_crud.get_multi_joined(</span>
+</span><span id="__span-0-1865"><a id="__codelineno-0-1865" name="__codelineno-0-1865"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1866"><a id="__codelineno-0-1866" name="__codelineno-0-1866"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1867"><a id="__codelineno-0-1867" name="__codelineno-0-1867"></a><span class="sd">                join_model=Profile,</span>
+</span><span id="__span-0-1868"><a id="__codelineno-0-1868" name="__codelineno-0-1868"></a><span class="sd">                join_on=Author.profile_id == Profile.id,</span>
+</span><span id="__span-0-1869"><a id="__codelineno-0-1869" name="__codelineno-0-1869"></a><span class="sd">                join_schema_to_select=ReadProfileSchema,</span>
+</span><span id="__span-0-1870"><a id="__codelineno-0-1870" name="__codelineno-0-1870"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1871"><a id="__codelineno-0-1871" name="__codelineno-0-1871"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1872"><a id="__codelineno-0-1872" name="__codelineno-0-1872"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1873"><a id="__codelineno-0-1873" name="__codelineno-0-1873"></a><span class="sd">                relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
+</span><span id="__span-0-1874"><a id="__codelineno-0-1874" name="__codelineno-0-1874"></a><span class="sd">            )</span>
+</span><span id="__span-0-1875"><a id="__codelineno-0-1875" name="__codelineno-0-1875"></a><span class="sd">            # Expect &#39;profile&#39; to be nested as a dictionary under each user</span>
+</span><span id="__span-0-1876"><a id="__codelineno-0-1876" name="__codelineno-0-1876"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1877"><a id="__codelineno-0-1877" name="__codelineno-0-1877"></a>
+</span><span id="__span-0-1878"><a id="__codelineno-0-1878" name="__codelineno-0-1878"></a><span class="sd">            Example using one-to-many relationship:</span>
+</span><span id="__span-0-1879"><a id="__codelineno-0-1879" name="__codelineno-0-1879"></a>
+</span><span id="__span-0-1880"><a id="__codelineno-0-1880" name="__codelineno-0-1880"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-1881"><a id="__codelineno-0-1881" name="__codelineno-0-1881"></a><span class="sd">            results = await author_crud.get_multi_joined(</span>
+</span><span id="__span-0-1882"><a id="__codelineno-0-1882" name="__codelineno-0-1882"></a><span class="sd">                db=session,</span>
+</span><span id="__span-0-1883"><a id="__codelineno-0-1883" name="__codelineno-0-1883"></a><span class="sd">                schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1884"><a id="__codelineno-0-1884" name="__codelineno-0-1884"></a><span class="sd">                join_model=Article,</span>
+</span><span id="__span-0-1885"><a id="__codelineno-0-1885" name="__codelineno-0-1885"></a><span class="sd">                join_on=Author.id == Article.author_id,</span>
+</span><span id="__span-0-1886"><a id="__codelineno-0-1886" name="__codelineno-0-1886"></a><span class="sd">                join_schema_to_select=ReadArticleSchema,</span>
+</span><span id="__span-0-1887"><a id="__codelineno-0-1887" name="__codelineno-0-1887"></a><span class="sd">                nest_joins=True,</span>
+</span><span id="__span-0-1888"><a id="__codelineno-0-1888" name="__codelineno-0-1888"></a><span class="sd">                offset=0,</span>
+</span><span id="__span-0-1889"><a id="__codelineno-0-1889" name="__codelineno-0-1889"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-1890"><a id="__codelineno-0-1890" name="__codelineno-0-1890"></a><span class="sd">                relationship_type=&#39;one-to-many&#39;,</span>
+</span><span id="__span-0-1891"><a id="__codelineno-0-1891" name="__codelineno-0-1891"></a><span class="sd">            )</span>
+</span><span id="__span-0-1892"><a id="__codelineno-0-1892" name="__codelineno-0-1892"></a><span class="sd">            # Expect &#39;posts&#39; to be nested as a list of dictionaries under each user</span>
+</span><span id="__span-0-1893"><a id="__codelineno-0-1893" name="__codelineno-0-1893"></a><span class="sd">            ```</span>
+</span><span id="__span-0-1894"><a id="__codelineno-0-1894" name="__codelineno-0-1894"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-1895"><a id="__codelineno-0-1895" name="__codelineno-0-1895"></a>        <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
+</span><span id="__span-0-1896"><a id="__codelineno-0-1896" name="__codelineno-0-1896"></a>            <span class="n">join_model</span>
+</span><span id="__span-0-1897"><a id="__codelineno-0-1897" name="__codelineno-0-1897"></a>            <span class="ow">or</span> <span class="n">join_prefix</span>
+</span><span id="__span-0-1898"><a id="__codelineno-0-1898" name="__codelineno-0-1898"></a>            <span class="ow">or</span> <span class="n">join_on</span>
+</span><span id="__span-0-1899"><a id="__codelineno-0-1899" name="__codelineno-0-1899"></a>            <span class="ow">or</span> <span class="n">join_schema_to_select</span>
+</span><span id="__span-0-1900"><a id="__codelineno-0-1900" name="__codelineno-0-1900"></a>            <span class="ow">or</span> <span class="n">alias</span>
+</span><span id="__span-0-1901"><a id="__codelineno-0-1901" name="__codelineno-0-1901"></a>            <span class="ow">or</span> <span class="n">relationship_type</span>
+</span><span id="__span-0-1902"><a id="__codelineno-0-1902" name="__codelineno-0-1902"></a>        <span class="p">):</span>
+</span><span id="__span-0-1903"><a id="__codelineno-0-1903" name="__codelineno-0-1903"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1904"><a id="__codelineno-0-1904" name="__codelineno-0-1904"></a>                <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
+</span><span id="__span-0-1905"><a id="__codelineno-0-1905" name="__codelineno-0-1905"></a>            <span class="p">)</span>
+</span><span id="__span-0-1906"><a id="__codelineno-0-1906" name="__codelineno-0-1906"></a>        <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1907"><a id="__codelineno-0-1907" name="__codelineno-0-1907"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1908"><a id="__codelineno-0-1908" name="__codelineno-0-1908"></a>
+</span><span id="__span-0-1909"><a id="__codelineno-0-1909" name="__codelineno-0-1909"></a>        <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-1910"><a id="__codelineno-0-1910" name="__codelineno-0-1910"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1911"><a id="__codelineno-0-1911" name="__codelineno-0-1911"></a>
+</span><span id="__span-0-1912"><a id="__codelineno-0-1912" name="__codelineno-0-1912"></a>        <span class="k">if</span> <span class="n">relationship_type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1913"><a id="__codelineno-0-1913" name="__codelineno-0-1913"></a>            <span class="n">relationship_type</span> <span class="o">=</span> <span class="s2">&quot;one-to-one&quot;</span>
+</span><span id="__span-0-1914"><a id="__codelineno-0-1914" name="__codelineno-0-1914"></a>
+</span><span id="__span-0-1915"><a id="__codelineno-0-1915" name="__codelineno-0-1915"></a>        <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-1916"><a id="__codelineno-0-1916" name="__codelineno-0-1916"></a>            <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-1917"><a id="__codelineno-0-1917" name="__codelineno-0-1917"></a>        <span class="p">)</span>
+</span><span id="__span-0-1918"><a id="__codelineno-0-1918" name="__codelineno-0-1918"></a>        <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span>
+</span><span id="__span-0-1919"><a id="__codelineno-0-1919" name="__codelineno-0-1919"></a>
+</span><span id="__span-0-1920"><a id="__codelineno-0-1920" name="__codelineno-0-1920"></a>        <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1921"><a id="__codelineno-0-1921" name="__codelineno-0-1921"></a>        <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1922"><a id="__codelineno-0-1922" name="__codelineno-0-1922"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1923"><a id="__codelineno-0-1923" name="__codelineno-0-1923"></a>                <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="__span-0-1924"><a id="__codelineno-0-1924" name="__codelineno-0-1924"></a>                    <span class="n">JoinConfig</span><span class="p">(</span>
+</span><span id="__span-0-1925"><a id="__codelineno-0-1925" name="__codelineno-0-1925"></a>                        <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
+</span><span id="__span-0-1926"><a id="__codelineno-0-1926" name="__codelineno-0-1926"></a>                        <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span>
+</span><span id="__span-0-1927"><a id="__codelineno-0-1927" name="__codelineno-0-1927"></a>                        <span class="k">if</span> <span class="n">join_on</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-1928"><a id="__codelineno-0-1928" name="__codelineno-0-1928"></a>                        <span class="k">else</span> <span class="n">_auto_detect_join_condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">join_model</span><span class="p">),</span>
+</span><span id="__span-0-1929"><a id="__codelineno-0-1929" name="__codelineno-0-1929"></a>                        <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
+</span><span id="__span-0-1930"><a id="__codelineno-0-1930" name="__codelineno-0-1930"></a>                        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1931"><a id="__codelineno-0-1931" name="__codelineno-0-1931"></a>                        <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
+</span><span id="__span-0-1932"><a id="__codelineno-0-1932" name="__codelineno-0-1932"></a>                        <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
+</span><span id="__span-0-1933"><a id="__codelineno-0-1933" name="__codelineno-0-1933"></a>                        <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
+</span><span id="__span-0-1934"><a id="__codelineno-0-1934" name="__codelineno-0-1934"></a>                        <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
+</span><span id="__span-0-1935"><a id="__codelineno-0-1935" name="__codelineno-0-1935"></a>                    <span class="p">)</span>
+</span><span id="__span-0-1936"><a id="__codelineno-0-1936" name="__codelineno-0-1936"></a>                <span class="p">)</span>
+</span><span id="__span-0-1937"><a id="__codelineno-0-1937" name="__codelineno-0-1937"></a>            <span class="k">except</span> <span class="ne">ValueError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1938"><a id="__codelineno-0-1938" name="__codelineno-0-1938"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Could not configure join: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1939"><a id="__codelineno-0-1939" name="__codelineno-0-1939"></a>
+</span><span id="__span-0-1940"><a id="__codelineno-0-1940" name="__codelineno-0-1940"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
+</span><span id="__span-0-1941"><a id="__codelineno-0-1941" name="__codelineno-0-1941"></a>            <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
+</span><span id="__span-0-1942"><a id="__codelineno-0-1942" name="__codelineno-0-1942"></a>        <span class="p">)</span>
+</span><span id="__span-0-1943"><a id="__codelineno-0-1943" name="__codelineno-0-1943"></a>
+</span><span id="__span-0-1944"><a id="__codelineno-0-1944" name="__codelineno-0-1944"></a>        <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1945"><a id="__codelineno-0-1945" name="__codelineno-0-1945"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1946"><a id="__codelineno-0-1946" name="__codelineno-0-1946"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1947"><a id="__codelineno-0-1947" name="__codelineno-0-1947"></a>
+</span><span id="__span-0-1948"><a id="__codelineno-0-1948" name="__codelineno-0-1948"></a>        <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-1949"><a id="__codelineno-0-1949" name="__codelineno-0-1949"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
 </span><span id="__span-0-1950"><a id="__codelineno-0-1950" name="__codelineno-0-1950"></a>
-</span><span id="__span-0-1951"><a id="__codelineno-0-1951" name="__codelineno-0-1951"></a>            <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-1952"><a id="__codelineno-0-1952" name="__codelineno-0-1952"></a>                <span class="k">if</span> <span class="n">schema_to_select</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1953"><a id="__codelineno-0-1953" name="__codelineno-0-1953"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1954"><a id="__codelineno-0-1954" name="__codelineno-0-1954"></a>                        <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-1955"><a id="__codelineno-0-1955" name="__codelineno-0-1955"></a>                    <span class="p">)</span>
-</span><span id="__span-0-1956"><a id="__codelineno-0-1956" name="__codelineno-0-1956"></a>                <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-1957"><a id="__codelineno-0-1957" name="__codelineno-0-1957"></a>                    <span class="n">model_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row_dict</span><span class="p">)</span>
-</span><span id="__span-0-1958"><a id="__codelineno-0-1958" name="__codelineno-0-1958"></a>                    <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">model_instance</span><span class="p">)</span>
-</span><span id="__span-0-1959"><a id="__codelineno-0-1959" name="__codelineno-0-1959"></a>                <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-1960"><a id="__codelineno-0-1960" name="__codelineno-0-1960"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1961"><a id="__codelineno-0-1961" name="__codelineno-0-1961"></a>                        <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-1962"><a id="__codelineno-0-1962" name="__codelineno-0-1962"></a>                    <span class="p">)</span>
-</span><span id="__span-0-1963"><a id="__codelineno-0-1963" name="__codelineno-0-1963"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1964"><a id="__codelineno-0-1964" name="__codelineno-0-1964"></a>                <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row_dict</span><span class="p">)</span>
-</span><span id="__span-0-1965"><a id="__codelineno-0-1965" name="__codelineno-0-1965"></a>
-</span><span id="__span-0-1966"><a id="__codelineno-0-1966" name="__codelineno-0-1966"></a>        <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span>
-</span><span id="__span-0-1967"><a id="__codelineno-0-1967" name="__codelineno-0-1967"></a>            <span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
-</span><span id="__span-0-1968"><a id="__codelineno-0-1968" name="__codelineno-0-1968"></a>        <span class="p">):</span>
-</span><span id="__span-0-1969"><a id="__codelineno-0-1969" name="__codelineno-0-1969"></a>            <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_multi_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1970"><a id="__codelineno-0-1970" name="__codelineno-0-1970"></a>                <span class="n">base_primary_key</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-</span><span id="__span-0-1971"><a id="__codelineno-0-1971" name="__codelineno-0-1971"></a>                <span class="n">data</span><span class="o">=</span><span class="n">data</span><span class="p">,</span>
-</span><span id="__span-0-1972"><a id="__codelineno-0-1972" name="__codelineno-0-1972"></a>                <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1973"><a id="__codelineno-0-1973" name="__codelineno-0-1973"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-1974"><a id="__codelineno-0-1974" name="__codelineno-0-1974"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span> <span class="k">if</span> <span class="n">return_as_model</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1975"><a id="__codelineno-0-1975" name="__codelineno-0-1975"></a>                <span class="n">nested_schema_to_select</span><span class="o">=</span><span class="p">{</span>
-</span><span id="__span-0-1976"><a id="__codelineno-0-1976" name="__codelineno-0-1976"></a>                    <span class="p">(</span>
-</span><span id="__span-0-1977"><a id="__codelineno-0-1977" name="__codelineno-0-1977"></a>                        <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1978"><a id="__codelineno-0-1978" name="__codelineno-0-1978"></a>                        <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span>
-</span><span id="__span-0-1979"><a id="__codelineno-0-1979" name="__codelineno-0-1979"></a>                        <span class="k">else</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span>
-</span><span id="__span-0-1980"><a id="__codelineno-0-1980" name="__codelineno-0-1980"></a>                    <span class="p">):</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1981"><a id="__codelineno-0-1981" name="__codelineno-0-1981"></a>                    <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
-</span><span id="__span-0-1982"><a id="__codelineno-0-1982" name="__codelineno-0-1982"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1983"><a id="__codelineno-0-1983" name="__codelineno-0-1983"></a>                <span class="p">},</span>
-</span><span id="__span-0-1984"><a id="__codelineno-0-1984" name="__codelineno-0-1984"></a>            <span class="p">)</span>
-</span><span id="__span-0-1985"><a id="__codelineno-0-1985" name="__codelineno-0-1985"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1986"><a id="__codelineno-0-1986" name="__codelineno-0-1986"></a>            <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_handle_null_primary_key_multi_join</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">join_definitions</span><span class="p">)</span>
-</span><span id="__span-0-1987"><a id="__codelineno-0-1987" name="__codelineno-0-1987"></a>
-</span><span id="__span-0-1988"><a id="__codelineno-0-1988" name="__codelineno-0-1988"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">nested_data</span><span class="p">}</span>
-</span><span id="__span-0-1989"><a id="__codelineno-0-1989" name="__codelineno-0-1989"></a>
-</span><span id="__span-0-1990"><a id="__codelineno-0-1990" name="__codelineno-0-1990"></a>        <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
-</span><span id="__span-0-1991"><a id="__codelineno-0-1991" name="__codelineno-0-1991"></a>            <span class="n">total_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span>
-</span><span id="__span-0-1992"><a id="__codelineno-0-1992" name="__codelineno-0-1992"></a>                <span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">joins_config</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="__span-0-1993"><a id="__codelineno-0-1993" name="__codelineno-0-1993"></a>            <span class="p">)</span>
-</span><span id="__span-0-1994"><a id="__codelineno-0-1994" name="__codelineno-0-1994"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
-</span><span id="__span-0-1995"><a id="__codelineno-0-1995" name="__codelineno-0-1995"></a>
-</span><span id="__span-0-1996"><a id="__codelineno-0-1996" name="__codelineno-0-1996"></a>        <span class="k">return</span> <span class="n">response</span>
-</span><span id="__span-0-1997"><a id="__codelineno-0-1997" name="__codelineno-0-1997"></a>
-</span><span id="__span-0-1998"><a id="__codelineno-0-1998" name="__codelineno-0-1998"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_by_cursor</span><span class="p">(</span>
-</span><span id="__span-0-1999"><a id="__codelineno-0-1999" name="__codelineno-0-1999"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2000"><a id="__codelineno-0-2000" name="__codelineno-0-2000"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2001"><a id="__codelineno-0-2001" name="__codelineno-0-2001"></a>        <span class="n">cursor</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2002"><a id="__codelineno-0-2002" name="__codelineno-0-2002"></a>        <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-2003"><a id="__codelineno-0-2003" name="__codelineno-0-2003"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2004"><a id="__codelineno-0-2004" name="__codelineno-0-2004"></a>        <span class="n">sort_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;id&quot;</span><span class="p">,</span>
-</span><span id="__span-0-2005"><a id="__codelineno-0-2005" name="__codelineno-0-2005"></a>        <span class="n">sort_order</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;asc&quot;</span><span class="p">,</span>
-</span><span id="__span-0-2006"><a id="__codelineno-0-2006" name="__codelineno-0-2006"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2007"><a id="__codelineno-0-2007" name="__codelineno-0-2007"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-2008"><a id="__codelineno-0-2008" name="__codelineno-0-2008"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2009"><a id="__codelineno-0-2009" name="__codelineno-0-2009"></a><span class="sd">        Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</span>
-</span><span id="__span-0-2010"><a id="__codelineno-0-2010" name="__codelineno-0-2010"></a>
-</span><span id="__span-0-2011"><a id="__codelineno-0-2011" name="__codelineno-0-2011"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1951"><a id="__codelineno-0-1951" name="__codelineno-0-1951"></a>        <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
+</span><span id="__span-0-1952"><a id="__codelineno-0-1952" name="__codelineno-0-1952"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
+</span><span id="__span-0-1953"><a id="__codelineno-0-1953" name="__codelineno-0-1953"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1954"><a id="__codelineno-0-1954" name="__codelineno-0-1954"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-1955"><a id="__codelineno-0-1955" name="__codelineno-0-1955"></a>
+</span><span id="__span-0-1956"><a id="__codelineno-0-1956" name="__codelineno-0-1956"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1957"><a id="__codelineno-0-1957" name="__codelineno-0-1957"></a>        <span class="n">data</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-1958"><a id="__codelineno-0-1958" name="__codelineno-0-1958"></a>
+</span><span id="__span-0-1959"><a id="__codelineno-0-1959" name="__codelineno-0-1959"></a>        <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()</span><span class="o">.</span><span class="n">all</span><span class="p">():</span>
+</span><span id="__span-0-1960"><a id="__codelineno-0-1960" name="__codelineno-0-1960"></a>            <span class="n">row_dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
+</span><span id="__span-0-1961"><a id="__codelineno-0-1961" name="__codelineno-0-1961"></a>
+</span><span id="__span-0-1962"><a id="__codelineno-0-1962" name="__codelineno-0-1962"></a>            <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
+</span><span id="__span-0-1963"><a id="__codelineno-0-1963" name="__codelineno-0-1963"></a>                <span class="n">row_dict</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1964"><a id="__codelineno-0-1964" name="__codelineno-0-1964"></a>                    <span class="n">data</span><span class="o">=</span><span class="n">row_dict</span><span class="p">,</span>
+</span><span id="__span-0-1965"><a id="__codelineno-0-1965" name="__codelineno-0-1965"></a>                    <span class="n">join_definitions</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1966"><a id="__codelineno-0-1966" name="__codelineno-0-1966"></a>                <span class="p">)</span>
+</span><span id="__span-0-1967"><a id="__codelineno-0-1967" name="__codelineno-0-1967"></a>
+</span><span id="__span-0-1968"><a id="__codelineno-0-1968" name="__codelineno-0-1968"></a>            <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-1969"><a id="__codelineno-0-1969" name="__codelineno-0-1969"></a>                <span class="k">if</span> <span class="n">schema_to_select</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1970"><a id="__codelineno-0-1970" name="__codelineno-0-1970"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1971"><a id="__codelineno-0-1971" name="__codelineno-0-1971"></a>                        <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-1972"><a id="__codelineno-0-1972" name="__codelineno-0-1972"></a>                    <span class="p">)</span>
+</span><span id="__span-0-1973"><a id="__codelineno-0-1973" name="__codelineno-0-1973"></a>                <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1974"><a id="__codelineno-0-1974" name="__codelineno-0-1974"></a>                    <span class="n">model_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row_dict</span><span class="p">)</span>
+</span><span id="__span-0-1975"><a id="__codelineno-0-1975" name="__codelineno-0-1975"></a>                    <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">model_instance</span><span class="p">)</span>
+</span><span id="__span-0-1976"><a id="__codelineno-0-1976" name="__codelineno-0-1976"></a>                <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-1977"><a id="__codelineno-0-1977" name="__codelineno-0-1977"></a>                    <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1978"><a id="__codelineno-0-1978" name="__codelineno-0-1978"></a>                        <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-1979"><a id="__codelineno-0-1979" name="__codelineno-0-1979"></a>                    <span class="p">)</span>
+</span><span id="__span-0-1980"><a id="__codelineno-0-1980" name="__codelineno-0-1980"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1981"><a id="__codelineno-0-1981" name="__codelineno-0-1981"></a>                <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row_dict</span><span class="p">)</span>
+</span><span id="__span-0-1982"><a id="__codelineno-0-1982" name="__codelineno-0-1982"></a>
+</span><span id="__span-0-1983"><a id="__codelineno-0-1983" name="__codelineno-0-1983"></a>        <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span>
+</span><span id="__span-0-1984"><a id="__codelineno-0-1984" name="__codelineno-0-1984"></a>            <span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
+</span><span id="__span-0-1985"><a id="__codelineno-0-1985" name="__codelineno-0-1985"></a>        <span class="p">):</span>
+</span><span id="__span-0-1986"><a id="__codelineno-0-1986" name="__codelineno-0-1986"></a>            <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_multi_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1987"><a id="__codelineno-0-1987" name="__codelineno-0-1987"></a>                <span class="n">base_primary_key</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>  <span class="c1"># type: ignore[misc]</span>
+</span><span id="__span-0-1988"><a id="__codelineno-0-1988" name="__codelineno-0-1988"></a>                <span class="n">data</span><span class="o">=</span><span class="n">data</span><span class="p">,</span>
+</span><span id="__span-0-1989"><a id="__codelineno-0-1989" name="__codelineno-0-1989"></a>                <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1990"><a id="__codelineno-0-1990" name="__codelineno-0-1990"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-1991"><a id="__codelineno-0-1991" name="__codelineno-0-1991"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span> <span class="k">if</span> <span class="n">return_as_model</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1992"><a id="__codelineno-0-1992" name="__codelineno-0-1992"></a>                <span class="n">nested_schema_to_select</span><span class="o">=</span><span class="p">{</span>
+</span><span id="__span-0-1993"><a id="__codelineno-0-1993" name="__codelineno-0-1993"></a>                    <span class="p">(</span>
+</span><span id="__span-0-1994"><a id="__codelineno-0-1994" name="__codelineno-0-1994"></a>                        <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1995"><a id="__codelineno-0-1995" name="__codelineno-0-1995"></a>                        <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span>
+</span><span id="__span-0-1996"><a id="__codelineno-0-1996" name="__codelineno-0-1996"></a>                        <span class="k">else</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__tablename__</span>
+</span><span id="__span-0-1997"><a id="__codelineno-0-1997" name="__codelineno-0-1997"></a>                    <span class="p">):</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-1998"><a id="__codelineno-0-1998" name="__codelineno-0-1998"></a>                    <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
+</span><span id="__span-0-1999"><a id="__codelineno-0-1999" name="__codelineno-0-1999"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-2000"><a id="__codelineno-0-2000" name="__codelineno-0-2000"></a>                <span class="p">},</span>
+</span><span id="__span-0-2001"><a id="__codelineno-0-2001" name="__codelineno-0-2001"></a>            <span class="p">)</span>
+</span><span id="__span-0-2002"><a id="__codelineno-0-2002" name="__codelineno-0-2002"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2003"><a id="__codelineno-0-2003" name="__codelineno-0-2003"></a>            <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_handle_null_primary_key_multi_join</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">join_definitions</span><span class="p">)</span>
+</span><span id="__span-0-2004"><a id="__codelineno-0-2004" name="__codelineno-0-2004"></a>
+</span><span id="__span-0-2005"><a id="__codelineno-0-2005" name="__codelineno-0-2005"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">nested_data</span><span class="p">}</span>
+</span><span id="__span-0-2006"><a id="__codelineno-0-2006" name="__codelineno-0-2006"></a>
+</span><span id="__span-0-2007"><a id="__codelineno-0-2007" name="__codelineno-0-2007"></a>        <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
+</span><span id="__span-0-2008"><a id="__codelineno-0-2008" name="__codelineno-0-2008"></a>            <span class="n">total_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span>
+</span><span id="__span-0-2009"><a id="__codelineno-0-2009" name="__codelineno-0-2009"></a>                <span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">joins_config</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="__span-0-2010"><a id="__codelineno-0-2010" name="__codelineno-0-2010"></a>            <span class="p">)</span>
+</span><span id="__span-0-2011"><a id="__codelineno-0-2011" name="__codelineno-0-2011"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
 </span><span id="__span-0-2012"><a id="__codelineno-0-2012" name="__codelineno-0-2012"></a>
-</span><span id="__span-0-2013"><a id="__codelineno-0-2013" name="__codelineno-0-2013"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-2014"><a id="__codelineno-0-2014" name="__codelineno-0-2014"></a><span class="sd">            db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-2015"><a id="__codelineno-0-2015" name="__codelineno-0-2015"></a><span class="sd">            cursor: The cursor value to start fetching records from. Defaults to `None`.</span>
-</span><span id="__span-0-2016"><a id="__codelineno-0-2016" name="__codelineno-0-2016"></a><span class="sd">            limit: Maximum number of rows to fetch.</span>
-</span><span id="__span-0-2017"><a id="__codelineno-0-2017" name="__codelineno-0-2017"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns.</span>
-</span><span id="__span-0-2018"><a id="__codelineno-0-2018" name="__codelineno-0-2018"></a><span class="sd">            sort_column: Column name to use for sorting and cursor pagination.</span>
-</span><span id="__span-0-2019"><a id="__codelineno-0-2019" name="__codelineno-0-2019"></a><span class="sd">            sort_order: Sorting direction, either `&quot;asc&quot;` or `&quot;desc&quot;`.</span>
-</span><span id="__span-0-2020"><a id="__codelineno-0-2020" name="__codelineno-0-2020"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.</span>
-</span><span id="__span-0-2021"><a id="__codelineno-0-2021" name="__codelineno-0-2021"></a>
-</span><span id="__span-0-2022"><a id="__codelineno-0-2022" name="__codelineno-0-2022"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-2023"><a id="__codelineno-0-2023" name="__codelineno-0-2023"></a><span class="sd">            A dictionary containing the fetched rows under `&quot;data&quot;` key and the next cursor value under `&quot;next_cursor&quot;`.</span>
-</span><span id="__span-0-2024"><a id="__codelineno-0-2024" name="__codelineno-0-2024"></a>
-</span><span id="__span-0-2025"><a id="__codelineno-0-2025" name="__codelineno-0-2025"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-2026"><a id="__codelineno-0-2026" name="__codelineno-0-2026"></a><span class="sd">            Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</span>
+</span><span id="__span-0-2013"><a id="__codelineno-0-2013" name="__codelineno-0-2013"></a>        <span class="k">return</span> <span class="n">response</span>
+</span><span id="__span-0-2014"><a id="__codelineno-0-2014" name="__codelineno-0-2014"></a>
+</span><span id="__span-0-2015"><a id="__codelineno-0-2015" name="__codelineno-0-2015"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_by_cursor</span><span class="p">(</span>
+</span><span id="__span-0-2016"><a id="__codelineno-0-2016" name="__codelineno-0-2016"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2017"><a id="__codelineno-0-2017" name="__codelineno-0-2017"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2018"><a id="__codelineno-0-2018" name="__codelineno-0-2018"></a>        <span class="n">cursor</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2019"><a id="__codelineno-0-2019" name="__codelineno-0-2019"></a>        <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-2020"><a id="__codelineno-0-2020" name="__codelineno-0-2020"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2021"><a id="__codelineno-0-2021" name="__codelineno-0-2021"></a>        <span class="n">sort_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;id&quot;</span><span class="p">,</span>
+</span><span id="__span-0-2022"><a id="__codelineno-0-2022" name="__codelineno-0-2022"></a>        <span class="n">sort_order</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;asc&quot;</span><span class="p">,</span>
+</span><span id="__span-0-2023"><a id="__codelineno-0-2023" name="__codelineno-0-2023"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2024"><a id="__codelineno-0-2024" name="__codelineno-0-2024"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+</span><span id="__span-0-2025"><a id="__codelineno-0-2025" name="__codelineno-0-2025"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2026"><a id="__codelineno-0-2026" name="__codelineno-0-2026"></a><span class="sd">        Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</span>
 </span><span id="__span-0-2027"><a id="__codelineno-0-2027" name="__codelineno-0-2027"></a>
-</span><span id="__span-0-2028"><a id="__codelineno-0-2028" name="__codelineno-0-2028"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2029"><a id="__codelineno-0-2029" name="__codelineno-0-2029"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2030"><a id="__codelineno-0-2030" name="__codelineno-0-2030"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2031"><a id="__codelineno-0-2031" name="__codelineno-0-2031"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-2032"><a id="__codelineno-0-2032" name="__codelineno-0-2032"></a><span class="sd">                sort_column=&#39;registration_date&#39;,</span>
-</span><span id="__span-0-2033"><a id="__codelineno-0-2033" name="__codelineno-0-2033"></a><span class="sd">                sort_order=&#39;desc&#39;,</span>
-</span><span id="__span-0-2034"><a id="__codelineno-0-2034" name="__codelineno-0-2034"></a><span class="sd">            )</span>
-</span><span id="__span-0-2035"><a id="__codelineno-0-2035" name="__codelineno-0-2035"></a>
-</span><span id="__span-0-2036"><a id="__codelineno-0-2036" name="__codelineno-0-2036"></a><span class="sd">            # Fetch the next set of records using the cursor from the first page</span>
-</span><span id="__span-0-2037"><a id="__codelineno-0-2037" name="__codelineno-0-2037"></a><span class="sd">            next_cursor = first_page[&#39;next_cursor&#39;]</span>
-</span><span id="__span-0-2038"><a id="__codelineno-0-2038" name="__codelineno-0-2038"></a><span class="sd">            second_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2039"><a id="__codelineno-0-2039" name="__codelineno-0-2039"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2040"><a id="__codelineno-0-2040" name="__codelineno-0-2040"></a><span class="sd">                cursor=next_cursor,</span>
-</span><span id="__span-0-2041"><a id="__codelineno-0-2041" name="__codelineno-0-2041"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-2042"><a id="__codelineno-0-2042" name="__codelineno-0-2042"></a><span class="sd">                sort_column=&#39;registration_date&#39;,</span>
-</span><span id="__span-0-2043"><a id="__codelineno-0-2043" name="__codelineno-0-2043"></a><span class="sd">                sort_order=&#39;desc&#39;,</span>
-</span><span id="__span-0-2044"><a id="__codelineno-0-2044" name="__codelineno-0-2044"></a><span class="sd">            )</span>
-</span><span id="__span-0-2045"><a id="__codelineno-0-2045" name="__codelineno-0-2045"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2046"><a id="__codelineno-0-2046" name="__codelineno-0-2046"></a>
-</span><span id="__span-0-2047"><a id="__codelineno-0-2047" name="__codelineno-0-2047"></a><span class="sd">            Fetch records with age greater than 30 using cursor-based pagination:</span>
-</span><span id="__span-0-2048"><a id="__codelineno-0-2048" name="__codelineno-0-2048"></a>
-</span><span id="__span-0-2049"><a id="__codelineno-0-2049" name="__codelineno-0-2049"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2050"><a id="__codelineno-0-2050" name="__codelineno-0-2050"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2051"><a id="__codelineno-0-2051" name="__codelineno-0-2051"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2052"><a id="__codelineno-0-2052" name="__codelineno-0-2052"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-2053"><a id="__codelineno-0-2053" name="__codelineno-0-2053"></a><span class="sd">                sort_column=&#39;age&#39;,</span>
-</span><span id="__span-0-2054"><a id="__codelineno-0-2054" name="__codelineno-0-2054"></a><span class="sd">                sort_order=&#39;asc&#39;,</span>
-</span><span id="__span-0-2055"><a id="__codelineno-0-2055" name="__codelineno-0-2055"></a><span class="sd">                age__gt=30,</span>
-</span><span id="__span-0-2056"><a id="__codelineno-0-2056" name="__codelineno-0-2056"></a><span class="sd">            )</span>
-</span><span id="__span-0-2057"><a id="__codelineno-0-2057" name="__codelineno-0-2057"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2058"><a id="__codelineno-0-2058" name="__codelineno-0-2058"></a>
-</span><span id="__span-0-2059"><a id="__codelineno-0-2059" name="__codelineno-0-2059"></a><span class="sd">            Fetch records excluding a specific username using cursor-based pagination:</span>
-</span><span id="__span-0-2060"><a id="__codelineno-0-2060" name="__codelineno-0-2060"></a>
-</span><span id="__span-0-2061"><a id="__codelineno-0-2061" name="__codelineno-0-2061"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2062"><a id="__codelineno-0-2062" name="__codelineno-0-2062"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2063"><a id="__codelineno-0-2063" name="__codelineno-0-2063"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2064"><a id="__codelineno-0-2064" name="__codelineno-0-2064"></a><span class="sd">                limit=10,</span>
-</span><span id="__span-0-2065"><a id="__codelineno-0-2065" name="__codelineno-0-2065"></a><span class="sd">                sort_column=&#39;username&#39;,</span>
-</span><span id="__span-0-2066"><a id="__codelineno-0-2066" name="__codelineno-0-2066"></a><span class="sd">                sort_order=&#39;asc&#39;,</span>
-</span><span id="__span-0-2067"><a id="__codelineno-0-2067" name="__codelineno-0-2067"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
-</span><span id="__span-0-2068"><a id="__codelineno-0-2068" name="__codelineno-0-2068"></a><span class="sd">            )</span>
-</span><span id="__span-0-2069"><a id="__codelineno-0-2069" name="__codelineno-0-2069"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2070"><a id="__codelineno-0-2070" name="__codelineno-0-2070"></a>
-</span><span id="__span-0-2071"><a id="__codelineno-0-2071" name="__codelineno-0-2071"></a><span class="sd">        Note:</span>
-</span><span id="__span-0-2072"><a id="__codelineno-0-2072" name="__codelineno-0-2072"></a><span class="sd">            This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.</span>
-</span><span id="__span-0-2073"><a id="__codelineno-0-2073" name="__codelineno-0-2073"></a><span class="sd">            Make sure the column used for cursor pagination is indexed for performance.</span>
-</span><span id="__span-0-2074"><a id="__codelineno-0-2074" name="__codelineno-0-2074"></a><span class="sd">            This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).</span>
-</span><span id="__span-0-2075"><a id="__codelineno-0-2075" name="__codelineno-0-2075"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-2076"><a id="__codelineno-0-2076" name="__codelineno-0-2076"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-2077"><a id="__codelineno-0-2077" name="__codelineno-0-2077"></a>            <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="p">[],</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">}</span>
-</span><span id="__span-0-2078"><a id="__codelineno-0-2078" name="__codelineno-0-2078"></a>
-</span><span id="__span-0-2079"><a id="__codelineno-0-2079" name="__codelineno-0-2079"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
-</span><span id="__span-0-2080"><a id="__codelineno-0-2080" name="__codelineno-0-2080"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2081"><a id="__codelineno-0-2081" name="__codelineno-0-2081"></a>            <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
-</span><span id="__span-0-2082"><a id="__codelineno-0-2082" name="__codelineno-0-2082"></a>        <span class="p">)</span>
-</span><span id="__span-0-2083"><a id="__codelineno-0-2083" name="__codelineno-0-2083"></a>
-</span><span id="__span-0-2084"><a id="__codelineno-0-2084" name="__codelineno-0-2084"></a>        <span class="k">if</span> <span class="n">cursor</span><span class="p">:</span>
-</span><span id="__span-0-2085"><a id="__codelineno-0-2085" name="__codelineno-0-2085"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
-</span><span id="__span-0-2086"><a id="__codelineno-0-2086" name="__codelineno-0-2086"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">cursor</span><span class="p">)</span>
-</span><span id="__span-0-2087"><a id="__codelineno-0-2087" name="__codelineno-0-2087"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2088"><a id="__codelineno-0-2088" name="__codelineno-0-2088"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&lt;</span> <span class="n">cursor</span><span class="p">)</span>
-</span><span id="__span-0-2089"><a id="__codelineno-0-2089" name="__codelineno-0-2089"></a>
-</span><span id="__span-0-2090"><a id="__codelineno-0-2090" name="__codelineno-0-2090"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span>
-</span><span id="__span-0-2091"><a id="__codelineno-0-2091" name="__codelineno-0-2091"></a>            <span class="n">asc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
-</span><span id="__span-0-2092"><a id="__codelineno-0-2092" name="__codelineno-0-2092"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span>
-</span><span id="__span-0-2093"><a id="__codelineno-0-2093" name="__codelineno-0-2093"></a>            <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
-</span><span id="__span-0-2094"><a id="__codelineno-0-2094" name="__codelineno-0-2094"></a>        <span class="p">)</span>
-</span><span id="__span-0-2095"><a id="__codelineno-0-2095" name="__codelineno-0-2095"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-2096"><a id="__codelineno-0-2096" name="__codelineno-0-2096"></a>
-</span><span id="__span-0-2097"><a id="__codelineno-0-2097" name="__codelineno-0-2097"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2098"><a id="__codelineno-0-2098" name="__codelineno-0-2098"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
-</span><span id="__span-0-2099"><a id="__codelineno-0-2099" name="__codelineno-0-2099"></a>
-</span><span id="__span-0-2100"><a id="__codelineno-0-2100" name="__codelineno-0-2100"></a>        <span class="n">next_cursor</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-2101"><a id="__codelineno-0-2101" name="__codelineno-0-2101"></a>        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="n">limit</span><span class="p">:</span>
-</span><span id="__span-0-2102"><a id="__codelineno-0-2102" name="__codelineno-0-2102"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
-</span><span id="__span-0-2103"><a id="__codelineno-0-2103" name="__codelineno-0-2103"></a>                <span class="n">next_cursor</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
-</span><span id="__span-0-2104"><a id="__codelineno-0-2104" name="__codelineno-0-2104"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2105"><a id="__codelineno-0-2105" name="__codelineno-0-2105"></a>                <span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
-</span><span id="__span-0-2106"><a id="__codelineno-0-2106" name="__codelineno-0-2106"></a>
-</span><span id="__span-0-2107"><a id="__codelineno-0-2107" name="__codelineno-0-2107"></a>        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="n">next_cursor</span><span class="p">}</span>
-</span><span id="__span-0-2108"><a id="__codelineno-0-2108" name="__codelineno-0-2108"></a>
-</span><span id="__span-0-2109"><a id="__codelineno-0-2109" name="__codelineno-0-2109"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
-</span><span id="__span-0-2110"><a id="__codelineno-0-2110" name="__codelineno-0-2110"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2111"><a id="__codelineno-0-2111" name="__codelineno-0-2111"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2112"><a id="__codelineno-0-2112" name="__codelineno-0-2112"></a>        <span class="nb">object</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]],</span>
-</span><span id="__span-0-2113"><a id="__codelineno-0-2113" name="__codelineno-0-2113"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2114"><a id="__codelineno-0-2114" name="__codelineno-0-2114"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2115"><a id="__codelineno-0-2115" name="__codelineno-0-2115"></a>        <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2116"><a id="__codelineno-0-2116" name="__codelineno-0-2116"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2117"><a id="__codelineno-0-2117" name="__codelineno-0-2117"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2118"><a id="__codelineno-0-2118" name="__codelineno-0-2118"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2119"><a id="__codelineno-0-2119" name="__codelineno-0-2119"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2120"><a id="__codelineno-0-2120" name="__codelineno-0-2120"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]:</span>
-</span><span id="__span-0-2121"><a id="__codelineno-0-2121" name="__codelineno-0-2121"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2122"><a id="__codelineno-0-2122" name="__codelineno-0-2122"></a><span class="sd">        Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</span>
-</span><span id="__span-0-2123"><a id="__codelineno-0-2123" name="__codelineno-0-2123"></a>
-</span><span id="__span-0-2124"><a id="__codelineno-0-2124" name="__codelineno-0-2124"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2125"><a id="__codelineno-0-2125" name="__codelineno-0-2125"></a>
-</span><span id="__span-0-2126"><a id="__codelineno-0-2126" name="__codelineno-0-2126"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-2127"><a id="__codelineno-0-2127" name="__codelineno-0-2127"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-2128"><a id="__codelineno-0-2128" name="__codelineno-0-2128"></a><span class="sd">            object: A Pydantic schema or dictionary containing the update data.</span>
-</span><span id="__span-0-2129"><a id="__codelineno-0-2129" name="__codelineno-0-2129"></a><span class="sd">            allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2130"><a id="__codelineno-0-2130" name="__codelineno-0-2130"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2131"><a id="__codelineno-0-2131" name="__codelineno-0-2131"></a><span class="sd">            return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.</span>
-</span><span id="__span-0-2132"><a id="__codelineno-0-2132" name="__codelineno-0-2132"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.</span>
-</span><span id="__span-0-2133"><a id="__codelineno-0-2133" name="__codelineno-0-2133"></a><span class="sd">            return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.</span>
-</span><span id="__span-0-2134"><a id="__codelineno-0-2134" name="__codelineno-0-2134"></a><span class="sd">            one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.</span>
-</span><span id="__span-0-2135"><a id="__codelineno-0-2135" name="__codelineno-0-2135"></a><span class="sd">            **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</span>
-</span><span id="__span-0-2136"><a id="__codelineno-0-2136" name="__codelineno-0-2136"></a>
-</span><span id="__span-0-2137"><a id="__codelineno-0-2137" name="__codelineno-0-2137"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-2138"><a id="__codelineno-0-2138" name="__codelineno-0-2138"></a><span class="sd">            The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.</span>
+</span><span id="__span-0-2028"><a id="__codelineno-0-2028" name="__codelineno-0-2028"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2029"><a id="__codelineno-0-2029" name="__codelineno-0-2029"></a>
+</span><span id="__span-0-2030"><a id="__codelineno-0-2030" name="__codelineno-0-2030"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-2031"><a id="__codelineno-0-2031" name="__codelineno-0-2031"></a><span class="sd">            db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-2032"><a id="__codelineno-0-2032" name="__codelineno-0-2032"></a><span class="sd">            cursor: The cursor value to start fetching records from. Defaults to `None`.</span>
+</span><span id="__span-0-2033"><a id="__codelineno-0-2033" name="__codelineno-0-2033"></a><span class="sd">            limit: Maximum number of rows to fetch.</span>
+</span><span id="__span-0-2034"><a id="__codelineno-0-2034" name="__codelineno-0-2034"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns.</span>
+</span><span id="__span-0-2035"><a id="__codelineno-0-2035" name="__codelineno-0-2035"></a><span class="sd">            sort_column: Column name to use for sorting and cursor pagination.</span>
+</span><span id="__span-0-2036"><a id="__codelineno-0-2036" name="__codelineno-0-2036"></a><span class="sd">            sort_order: Sorting direction, either `&quot;asc&quot;` or `&quot;desc&quot;`.</span>
+</span><span id="__span-0-2037"><a id="__codelineno-0-2037" name="__codelineno-0-2037"></a><span class="sd">            **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.</span>
+</span><span id="__span-0-2038"><a id="__codelineno-0-2038" name="__codelineno-0-2038"></a>
+</span><span id="__span-0-2039"><a id="__codelineno-0-2039" name="__codelineno-0-2039"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-2040"><a id="__codelineno-0-2040" name="__codelineno-0-2040"></a><span class="sd">            A dictionary containing the fetched rows under `&quot;data&quot;` key and the next cursor value under `&quot;next_cursor&quot;`.</span>
+</span><span id="__span-0-2041"><a id="__codelineno-0-2041" name="__codelineno-0-2041"></a>
+</span><span id="__span-0-2042"><a id="__codelineno-0-2042" name="__codelineno-0-2042"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-2043"><a id="__codelineno-0-2043" name="__codelineno-0-2043"></a><span class="sd">            Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</span>
+</span><span id="__span-0-2044"><a id="__codelineno-0-2044" name="__codelineno-0-2044"></a>
+</span><span id="__span-0-2045"><a id="__codelineno-0-2045" name="__codelineno-0-2045"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2046"><a id="__codelineno-0-2046" name="__codelineno-0-2046"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2047"><a id="__codelineno-0-2047" name="__codelineno-0-2047"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2048"><a id="__codelineno-0-2048" name="__codelineno-0-2048"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-2049"><a id="__codelineno-0-2049" name="__codelineno-0-2049"></a><span class="sd">                sort_column=&#39;registration_date&#39;,</span>
+</span><span id="__span-0-2050"><a id="__codelineno-0-2050" name="__codelineno-0-2050"></a><span class="sd">                sort_order=&#39;desc&#39;,</span>
+</span><span id="__span-0-2051"><a id="__codelineno-0-2051" name="__codelineno-0-2051"></a><span class="sd">            )</span>
+</span><span id="__span-0-2052"><a id="__codelineno-0-2052" name="__codelineno-0-2052"></a>
+</span><span id="__span-0-2053"><a id="__codelineno-0-2053" name="__codelineno-0-2053"></a><span class="sd">            # Fetch the next set of records using the cursor from the first page</span>
+</span><span id="__span-0-2054"><a id="__codelineno-0-2054" name="__codelineno-0-2054"></a><span class="sd">            next_cursor = first_page[&#39;next_cursor&#39;]</span>
+</span><span id="__span-0-2055"><a id="__codelineno-0-2055" name="__codelineno-0-2055"></a><span class="sd">            second_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2056"><a id="__codelineno-0-2056" name="__codelineno-0-2056"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2057"><a id="__codelineno-0-2057" name="__codelineno-0-2057"></a><span class="sd">                cursor=next_cursor,</span>
+</span><span id="__span-0-2058"><a id="__codelineno-0-2058" name="__codelineno-0-2058"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-2059"><a id="__codelineno-0-2059" name="__codelineno-0-2059"></a><span class="sd">                sort_column=&#39;registration_date&#39;,</span>
+</span><span id="__span-0-2060"><a id="__codelineno-0-2060" name="__codelineno-0-2060"></a><span class="sd">                sort_order=&#39;desc&#39;,</span>
+</span><span id="__span-0-2061"><a id="__codelineno-0-2061" name="__codelineno-0-2061"></a><span class="sd">            )</span>
+</span><span id="__span-0-2062"><a id="__codelineno-0-2062" name="__codelineno-0-2062"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2063"><a id="__codelineno-0-2063" name="__codelineno-0-2063"></a>
+</span><span id="__span-0-2064"><a id="__codelineno-0-2064" name="__codelineno-0-2064"></a><span class="sd">            Fetch records with age greater than 30 using cursor-based pagination:</span>
+</span><span id="__span-0-2065"><a id="__codelineno-0-2065" name="__codelineno-0-2065"></a>
+</span><span id="__span-0-2066"><a id="__codelineno-0-2066" name="__codelineno-0-2066"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2067"><a id="__codelineno-0-2067" name="__codelineno-0-2067"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2068"><a id="__codelineno-0-2068" name="__codelineno-0-2068"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2069"><a id="__codelineno-0-2069" name="__codelineno-0-2069"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-2070"><a id="__codelineno-0-2070" name="__codelineno-0-2070"></a><span class="sd">                sort_column=&#39;age&#39;,</span>
+</span><span id="__span-0-2071"><a id="__codelineno-0-2071" name="__codelineno-0-2071"></a><span class="sd">                sort_order=&#39;asc&#39;,</span>
+</span><span id="__span-0-2072"><a id="__codelineno-0-2072" name="__codelineno-0-2072"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-2073"><a id="__codelineno-0-2073" name="__codelineno-0-2073"></a><span class="sd">            )</span>
+</span><span id="__span-0-2074"><a id="__codelineno-0-2074" name="__codelineno-0-2074"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2075"><a id="__codelineno-0-2075" name="__codelineno-0-2075"></a>
+</span><span id="__span-0-2076"><a id="__codelineno-0-2076" name="__codelineno-0-2076"></a><span class="sd">            Fetch records excluding a specific username using cursor-based pagination:</span>
+</span><span id="__span-0-2077"><a id="__codelineno-0-2077" name="__codelineno-0-2077"></a>
+</span><span id="__span-0-2078"><a id="__codelineno-0-2078" name="__codelineno-0-2078"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2079"><a id="__codelineno-0-2079" name="__codelineno-0-2079"></a><span class="sd">            first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2080"><a id="__codelineno-0-2080" name="__codelineno-0-2080"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2081"><a id="__codelineno-0-2081" name="__codelineno-0-2081"></a><span class="sd">                limit=10,</span>
+</span><span id="__span-0-2082"><a id="__codelineno-0-2082" name="__codelineno-0-2082"></a><span class="sd">                sort_column=&#39;username&#39;,</span>
+</span><span id="__span-0-2083"><a id="__codelineno-0-2083" name="__codelineno-0-2083"></a><span class="sd">                sort_order=&#39;asc&#39;,</span>
+</span><span id="__span-0-2084"><a id="__codelineno-0-2084" name="__codelineno-0-2084"></a><span class="sd">                username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-2085"><a id="__codelineno-0-2085" name="__codelineno-0-2085"></a><span class="sd">            )</span>
+</span><span id="__span-0-2086"><a id="__codelineno-0-2086" name="__codelineno-0-2086"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2087"><a id="__codelineno-0-2087" name="__codelineno-0-2087"></a>
+</span><span id="__span-0-2088"><a id="__codelineno-0-2088" name="__codelineno-0-2088"></a><span class="sd">        Note:</span>
+</span><span id="__span-0-2089"><a id="__codelineno-0-2089" name="__codelineno-0-2089"></a><span class="sd">            This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.</span>
+</span><span id="__span-0-2090"><a id="__codelineno-0-2090" name="__codelineno-0-2090"></a><span class="sd">            Make sure the column used for cursor pagination is indexed for performance.</span>
+</span><span id="__span-0-2091"><a id="__codelineno-0-2091" name="__codelineno-0-2091"></a><span class="sd">            This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).</span>
+</span><span id="__span-0-2092"><a id="__codelineno-0-2092" name="__codelineno-0-2092"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-2093"><a id="__codelineno-0-2093" name="__codelineno-0-2093"></a>        <span class="k">if</span> <span class="n">limit</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2094"><a id="__codelineno-0-2094" name="__codelineno-0-2094"></a>            <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="p">[],</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">}</span>
+</span><span id="__span-0-2095"><a id="__codelineno-0-2095" name="__codelineno-0-2095"></a>
+</span><span id="__span-0-2096"><a id="__codelineno-0-2096" name="__codelineno-0-2096"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2097"><a id="__codelineno-0-2097" name="__codelineno-0-2097"></a>
+</span><span id="__span-0-2098"><a id="__codelineno-0-2098" name="__codelineno-0-2098"></a>        <span class="k">if</span> <span class="n">cursor</span><span class="p">:</span>
+</span><span id="__span-0-2099"><a id="__codelineno-0-2099" name="__codelineno-0-2099"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
+</span><span id="__span-0-2100"><a id="__codelineno-0-2100" name="__codelineno-0-2100"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">cursor</span><span class="p">)</span>
+</span><span id="__span-0-2101"><a id="__codelineno-0-2101" name="__codelineno-0-2101"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2102"><a id="__codelineno-0-2102" name="__codelineno-0-2102"></a>                <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&lt;</span> <span class="n">cursor</span><span class="p">)</span>
+</span><span id="__span-0-2103"><a id="__codelineno-0-2103" name="__codelineno-0-2103"></a>
+</span><span id="__span-0-2104"><a id="__codelineno-0-2104" name="__codelineno-0-2104"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span>
+</span><span id="__span-0-2105"><a id="__codelineno-0-2105" name="__codelineno-0-2105"></a>            <span class="n">asc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
+</span><span id="__span-0-2106"><a id="__codelineno-0-2106" name="__codelineno-0-2106"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span>
+</span><span id="__span-0-2107"><a id="__codelineno-0-2107" name="__codelineno-0-2107"></a>            <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
+</span><span id="__span-0-2108"><a id="__codelineno-0-2108" name="__codelineno-0-2108"></a>        <span class="p">)</span>
+</span><span id="__span-0-2109"><a id="__codelineno-0-2109" name="__codelineno-0-2109"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-2110"><a id="__codelineno-0-2110" name="__codelineno-0-2110"></a>
+</span><span id="__span-0-2111"><a id="__codelineno-0-2111" name="__codelineno-0-2111"></a>        <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2112"><a id="__codelineno-0-2112" name="__codelineno-0-2112"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
+</span><span id="__span-0-2113"><a id="__codelineno-0-2113" name="__codelineno-0-2113"></a>
+</span><span id="__span-0-2114"><a id="__codelineno-0-2114" name="__codelineno-0-2114"></a>        <span class="n">next_cursor</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-2115"><a id="__codelineno-0-2115" name="__codelineno-0-2115"></a>        <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="n">limit</span><span class="p">:</span>
+</span><span id="__span-0-2116"><a id="__codelineno-0-2116" name="__codelineno-0-2116"></a>            <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
+</span><span id="__span-0-2117"><a id="__codelineno-0-2117" name="__codelineno-0-2117"></a>                <span class="n">next_cursor</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
+</span><span id="__span-0-2118"><a id="__codelineno-0-2118" name="__codelineno-0-2118"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2119"><a id="__codelineno-0-2119" name="__codelineno-0-2119"></a>                <span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
+</span><span id="__span-0-2120"><a id="__codelineno-0-2120" name="__codelineno-0-2120"></a>
+</span><span id="__span-0-2121"><a id="__codelineno-0-2121" name="__codelineno-0-2121"></a>        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="n">next_cursor</span><span class="p">}</span>
+</span><span id="__span-0-2122"><a id="__codelineno-0-2122" name="__codelineno-0-2122"></a>
+</span><span id="__span-0-2123"><a id="__codelineno-0-2123" name="__codelineno-0-2123"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
+</span><span id="__span-0-2124"><a id="__codelineno-0-2124" name="__codelineno-0-2124"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2125"><a id="__codelineno-0-2125" name="__codelineno-0-2125"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2126"><a id="__codelineno-0-2126" name="__codelineno-0-2126"></a>        <span class="nb">object</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]],</span>
+</span><span id="__span-0-2127"><a id="__codelineno-0-2127" name="__codelineno-0-2127"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2128"><a id="__codelineno-0-2128" name="__codelineno-0-2128"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2129"><a id="__codelineno-0-2129" name="__codelineno-0-2129"></a>        <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2130"><a id="__codelineno-0-2130" name="__codelineno-0-2130"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2131"><a id="__codelineno-0-2131" name="__codelineno-0-2131"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2132"><a id="__codelineno-0-2132" name="__codelineno-0-2132"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2133"><a id="__codelineno-0-2133" name="__codelineno-0-2133"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2134"><a id="__codelineno-0-2134" name="__codelineno-0-2134"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]:</span>
+</span><span id="__span-0-2135"><a id="__codelineno-0-2135" name="__codelineno-0-2135"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2136"><a id="__codelineno-0-2136" name="__codelineno-0-2136"></a><span class="sd">        Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</span>
+</span><span id="__span-0-2137"><a id="__codelineno-0-2137" name="__codelineno-0-2137"></a>
+</span><span id="__span-0-2138"><a id="__codelineno-0-2138" name="__codelineno-0-2138"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-2139"><a id="__codelineno-0-2139" name="__codelineno-0-2139"></a>
-</span><span id="__span-0-2140"><a id="__codelineno-0-2140" name="__codelineno-0-2140"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-2141"><a id="__codelineno-0-2141" name="__codelineno-0-2141"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2142"><a id="__codelineno-0-2142" name="__codelineno-0-2142"></a><span class="sd">            ValueError: If extra fields not present in the model are provided in the update data.</span>
-</span><span id="__span-0-2143"><a id="__codelineno-0-2143" name="__codelineno-0-2143"></a><span class="sd">            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
-</span><span id="__span-0-2144"><a id="__codelineno-0-2144" name="__codelineno-0-2144"></a>
-</span><span id="__span-0-2145"><a id="__codelineno-0-2145" name="__codelineno-0-2145"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-2146"><a id="__codelineno-0-2146" name="__codelineno-0-2146"></a><span class="sd">            Update a user&#39;s email based on their ID:</span>
-</span><span id="__span-0-2147"><a id="__codelineno-0-2147" name="__codelineno-0-2147"></a>
-</span><span id="__span-0-2148"><a id="__codelineno-0-2148" name="__codelineno-0-2148"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2149"><a id="__codelineno-0-2149" name="__codelineno-0-2149"></a><span class="sd">            await user_crud.update(db, {&#39;email&#39;: &#39;new_email@example.com&#39;}, id=1)</span>
-</span><span id="__span-0-2150"><a id="__codelineno-0-2150" name="__codelineno-0-2150"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2151"><a id="__codelineno-0-2151" name="__codelineno-0-2151"></a>
-</span><span id="__span-0-2152"><a id="__codelineno-0-2152" name="__codelineno-0-2152"></a><span class="sd">            Update users to be inactive where age is greater than 30 and allow updates to multiple records:</span>
+</span><span id="__span-0-2140"><a id="__codelineno-0-2140" name="__codelineno-0-2140"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-2141"><a id="__codelineno-0-2141" name="__codelineno-0-2141"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-2142"><a id="__codelineno-0-2142" name="__codelineno-0-2142"></a><span class="sd">            object: A Pydantic schema or dictionary containing the update data.</span>
+</span><span id="__span-0-2143"><a id="__codelineno-0-2143" name="__codelineno-0-2143"></a><span class="sd">            allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2144"><a id="__codelineno-0-2144" name="__codelineno-0-2144"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2145"><a id="__codelineno-0-2145" name="__codelineno-0-2145"></a><span class="sd">            return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.</span>
+</span><span id="__span-0-2146"><a id="__codelineno-0-2146" name="__codelineno-0-2146"></a><span class="sd">            schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.</span>
+</span><span id="__span-0-2147"><a id="__codelineno-0-2147" name="__codelineno-0-2147"></a><span class="sd">            return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.</span>
+</span><span id="__span-0-2148"><a id="__codelineno-0-2148" name="__codelineno-0-2148"></a><span class="sd">            one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.</span>
+</span><span id="__span-0-2149"><a id="__codelineno-0-2149" name="__codelineno-0-2149"></a><span class="sd">            **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-2150"><a id="__codelineno-0-2150" name="__codelineno-0-2150"></a>
+</span><span id="__span-0-2151"><a id="__codelineno-0-2151" name="__codelineno-0-2151"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-2152"><a id="__codelineno-0-2152" name="__codelineno-0-2152"></a><span class="sd">            The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.</span>
 </span><span id="__span-0-2153"><a id="__codelineno-0-2153" name="__codelineno-0-2153"></a>
-</span><span id="__span-0-2154"><a id="__codelineno-0-2154" name="__codelineno-0-2154"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2155"><a id="__codelineno-0-2155" name="__codelineno-0-2155"></a><span class="sd">            await user_crud.update(</span>
-</span><span id="__span-0-2156"><a id="__codelineno-0-2156" name="__codelineno-0-2156"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2157"><a id="__codelineno-0-2157" name="__codelineno-0-2157"></a><span class="sd">                {&#39;is_active&#39;: False},</span>
-</span><span id="__span-0-2158"><a id="__codelineno-0-2158" name="__codelineno-0-2158"></a><span class="sd">                allow_multiple=True,</span>
-</span><span id="__span-0-2159"><a id="__codelineno-0-2159" name="__codelineno-0-2159"></a><span class="sd">                age__gt=30,</span>
-</span><span id="__span-0-2160"><a id="__codelineno-0-2160" name="__codelineno-0-2160"></a><span class="sd">            )</span>
-</span><span id="__span-0-2161"><a id="__codelineno-0-2161" name="__codelineno-0-2161"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2154"><a id="__codelineno-0-2154" name="__codelineno-0-2154"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-2155"><a id="__codelineno-0-2155" name="__codelineno-0-2155"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2156"><a id="__codelineno-0-2156" name="__codelineno-0-2156"></a><span class="sd">            NoResultFound: If no record matches the filters. (on version 0.15.3)</span>
+</span><span id="__span-0-2157"><a id="__codelineno-0-2157" name="__codelineno-0-2157"></a><span class="sd">            ValueError: If extra fields not present in the model are provided in the update data.</span>
+</span><span id="__span-0-2158"><a id="__codelineno-0-2158" name="__codelineno-0-2158"></a><span class="sd">            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
+</span><span id="__span-0-2159"><a id="__codelineno-0-2159" name="__codelineno-0-2159"></a>
+</span><span id="__span-0-2160"><a id="__codelineno-0-2160" name="__codelineno-0-2160"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-2161"><a id="__codelineno-0-2161" name="__codelineno-0-2161"></a><span class="sd">            Update a user&#39;s email based on their ID:</span>
 </span><span id="__span-0-2162"><a id="__codelineno-0-2162" name="__codelineno-0-2162"></a>
-</span><span id="__span-0-2163"><a id="__codelineno-0-2163" name="__codelineno-0-2163"></a><span class="sd">            Update a user&#39;s username excluding specific user ID and prevent multiple updates:</span>
-</span><span id="__span-0-2164"><a id="__codelineno-0-2164" name="__codelineno-0-2164"></a>
-</span><span id="__span-0-2165"><a id="__codelineno-0-2165" name="__codelineno-0-2165"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2166"><a id="__codelineno-0-2166" name="__codelineno-0-2166"></a><span class="sd">            await user_crud.update(</span>
-</span><span id="__span-0-2167"><a id="__codelineno-0-2167" name="__codelineno-0-2167"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2168"><a id="__codelineno-0-2168" name="__codelineno-0-2168"></a><span class="sd">                {&#39;username&#39;: &#39;new_username&#39;},</span>
-</span><span id="__span-0-2169"><a id="__codelineno-0-2169" name="__codelineno-0-2169"></a><span class="sd">                allow_multiple=False,</span>
-</span><span id="__span-0-2170"><a id="__codelineno-0-2170" name="__codelineno-0-2170"></a><span class="sd">                id__ne=1,</span>
-</span><span id="__span-0-2171"><a id="__codelineno-0-2171" name="__codelineno-0-2171"></a><span class="sd">            )</span>
-</span><span id="__span-0-2172"><a id="__codelineno-0-2172" name="__codelineno-0-2172"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2173"><a id="__codelineno-0-2173" name="__codelineno-0-2173"></a>
-</span><span id="__span-0-2174"><a id="__codelineno-0-2174" name="__codelineno-0-2174"></a><span class="sd">            Update a user&#39;s email and return the updated record as a Pydantic model instance:</span>
-</span><span id="__span-0-2175"><a id="__codelineno-0-2175" name="__codelineno-0-2175"></a>
-</span><span id="__span-0-2176"><a id="__codelineno-0-2176" name="__codelineno-0-2176"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2177"><a id="__codelineno-0-2177" name="__codelineno-0-2177"></a><span class="sd">            user = await user_crud.update(</span>
-</span><span id="__span-0-2178"><a id="__codelineno-0-2178" name="__codelineno-0-2178"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2179"><a id="__codelineno-0-2179" name="__codelineno-0-2179"></a><span class="sd">                {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
-</span><span id="__span-0-2180"><a id="__codelineno-0-2180" name="__codelineno-0-2180"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-2181"><a id="__codelineno-0-2181" name="__codelineno-0-2181"></a><span class="sd">                return_as_model=True,</span>
-</span><span id="__span-0-2182"><a id="__codelineno-0-2182" name="__codelineno-0-2182"></a><span class="sd">                id=1,</span>
-</span><span id="__span-0-2183"><a id="__codelineno-0-2183" name="__codelineno-0-2183"></a><span class="sd">            )</span>
-</span><span id="__span-0-2184"><a id="__codelineno-0-2184" name="__codelineno-0-2184"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2185"><a id="__codelineno-0-2185" name="__codelineno-0-2185"></a>
-</span><span id="__span-0-2186"><a id="__codelineno-0-2186" name="__codelineno-0-2186"></a><span class="sd">            Update a user&#39;s email and return the updated record as a dictionary:</span>
-</span><span id="__span-0-2187"><a id="__codelineno-0-2187" name="__codelineno-0-2187"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2188"><a id="__codelineno-0-2188" name="__codelineno-0-2188"></a><span class="sd">            user = await user_crud.update(</span>
-</span><span id="__span-0-2189"><a id="__codelineno-0-2189" name="__codelineno-0-2189"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2190"><a id="__codelineno-0-2190" name="__codelineno-0-2190"></a><span class="sd">                {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
-</span><span id="__span-0-2191"><a id="__codelineno-0-2191" name="__codelineno-0-2191"></a><span class="sd">                return_columns=[&#39;id&#39;, &#39;email&#39;],</span>
-</span><span id="__span-0-2192"><a id="__codelineno-0-2192" name="__codelineno-0-2192"></a><span class="sd">                id=1,</span>
-</span><span id="__span-0-2193"><a id="__codelineno-0-2193" name="__codelineno-0-2193"></a><span class="sd">            )</span>
-</span><span id="__span-0-2194"><a id="__codelineno-0-2194" name="__codelineno-0-2194"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2195"><a id="__codelineno-0-2195" name="__codelineno-0-2195"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-2196"><a id="__codelineno-0-2196" name="__codelineno-0-2196"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2197"><a id="__codelineno-0-2197" name="__codelineno-0-2197"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2198"><a id="__codelineno-0-2198" name="__codelineno-0-2198"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to update, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2199"><a id="__codelineno-0-2199" name="__codelineno-0-2199"></a>            <span class="p">)</span>
+</span><span id="__span-0-2163"><a id="__codelineno-0-2163" name="__codelineno-0-2163"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2164"><a id="__codelineno-0-2164" name="__codelineno-0-2164"></a><span class="sd">            await user_crud.update(db, {&#39;email&#39;: &#39;new_email@example.com&#39;}, id=1)</span>
+</span><span id="__span-0-2165"><a id="__codelineno-0-2165" name="__codelineno-0-2165"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2166"><a id="__codelineno-0-2166" name="__codelineno-0-2166"></a>
+</span><span id="__span-0-2167"><a id="__codelineno-0-2167" name="__codelineno-0-2167"></a><span class="sd">            Update users to be inactive where age is greater than 30 and allow updates to multiple records:</span>
+</span><span id="__span-0-2168"><a id="__codelineno-0-2168" name="__codelineno-0-2168"></a>
+</span><span id="__span-0-2169"><a id="__codelineno-0-2169" name="__codelineno-0-2169"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2170"><a id="__codelineno-0-2170" name="__codelineno-0-2170"></a><span class="sd">            await user_crud.update(</span>
+</span><span id="__span-0-2171"><a id="__codelineno-0-2171" name="__codelineno-0-2171"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2172"><a id="__codelineno-0-2172" name="__codelineno-0-2172"></a><span class="sd">                {&#39;is_active&#39;: False},</span>
+</span><span id="__span-0-2173"><a id="__codelineno-0-2173" name="__codelineno-0-2173"></a><span class="sd">                allow_multiple=True,</span>
+</span><span id="__span-0-2174"><a id="__codelineno-0-2174" name="__codelineno-0-2174"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-2175"><a id="__codelineno-0-2175" name="__codelineno-0-2175"></a><span class="sd">            )</span>
+</span><span id="__span-0-2176"><a id="__codelineno-0-2176" name="__codelineno-0-2176"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2177"><a id="__codelineno-0-2177" name="__codelineno-0-2177"></a>
+</span><span id="__span-0-2178"><a id="__codelineno-0-2178" name="__codelineno-0-2178"></a><span class="sd">            Update a user&#39;s username excluding specific user ID and prevent multiple updates:</span>
+</span><span id="__span-0-2179"><a id="__codelineno-0-2179" name="__codelineno-0-2179"></a>
+</span><span id="__span-0-2180"><a id="__codelineno-0-2180" name="__codelineno-0-2180"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2181"><a id="__codelineno-0-2181" name="__codelineno-0-2181"></a><span class="sd">            await user_crud.update(</span>
+</span><span id="__span-0-2182"><a id="__codelineno-0-2182" name="__codelineno-0-2182"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2183"><a id="__codelineno-0-2183" name="__codelineno-0-2183"></a><span class="sd">                {&#39;username&#39;: &#39;new_username&#39;},</span>
+</span><span id="__span-0-2184"><a id="__codelineno-0-2184" name="__codelineno-0-2184"></a><span class="sd">                allow_multiple=False,</span>
+</span><span id="__span-0-2185"><a id="__codelineno-0-2185" name="__codelineno-0-2185"></a><span class="sd">                id__ne=1,</span>
+</span><span id="__span-0-2186"><a id="__codelineno-0-2186" name="__codelineno-0-2186"></a><span class="sd">            )</span>
+</span><span id="__span-0-2187"><a id="__codelineno-0-2187" name="__codelineno-0-2187"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2188"><a id="__codelineno-0-2188" name="__codelineno-0-2188"></a>
+</span><span id="__span-0-2189"><a id="__codelineno-0-2189" name="__codelineno-0-2189"></a><span class="sd">            Update a user&#39;s email and return the updated record as a Pydantic model instance:</span>
+</span><span id="__span-0-2190"><a id="__codelineno-0-2190" name="__codelineno-0-2190"></a>
+</span><span id="__span-0-2191"><a id="__codelineno-0-2191" name="__codelineno-0-2191"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2192"><a id="__codelineno-0-2192" name="__codelineno-0-2192"></a><span class="sd">            user = await user_crud.update(</span>
+</span><span id="__span-0-2193"><a id="__codelineno-0-2193" name="__codelineno-0-2193"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2194"><a id="__codelineno-0-2194" name="__codelineno-0-2194"></a><span class="sd">                {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
+</span><span id="__span-0-2195"><a id="__codelineno-0-2195" name="__codelineno-0-2195"></a><span class="sd">                schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-2196"><a id="__codelineno-0-2196" name="__codelineno-0-2196"></a><span class="sd">                return_as_model=True,</span>
+</span><span id="__span-0-2197"><a id="__codelineno-0-2197" name="__codelineno-0-2197"></a><span class="sd">                id=1,</span>
+</span><span id="__span-0-2198"><a id="__codelineno-0-2198" name="__codelineno-0-2198"></a><span class="sd">            )</span>
+</span><span id="__span-0-2199"><a id="__codelineno-0-2199" name="__codelineno-0-2199"></a><span class="sd">            ```</span>
 </span><span id="__span-0-2200"><a id="__codelineno-0-2200" name="__codelineno-0-2200"></a>
-</span><span id="__span-0-2201"><a id="__codelineno-0-2201" name="__codelineno-0-2201"></a>        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">object</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-</span><span id="__span-0-2202"><a id="__codelineno-0-2202" name="__codelineno-0-2202"></a>            <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span>
-</span><span id="__span-0-2203"><a id="__codelineno-0-2203" name="__codelineno-0-2203"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2204"><a id="__codelineno-0-2204" name="__codelineno-0-2204"></a>            <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">(</span><span class="n">exclude_unset</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-2205"><a id="__codelineno-0-2205" name="__codelineno-0-2205"></a>
-</span><span id="__span-0-2206"><a id="__codelineno-0-2206" name="__codelineno-0-2206"></a>        <span class="n">updated_at_col</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-2207"><a id="__codelineno-0-2207" name="__codelineno-0-2207"></a>        <span class="k">if</span> <span class="n">updated_at_col</span><span class="p">:</span>
-</span><span id="__span-0-2208"><a id="__codelineno-0-2208" name="__codelineno-0-2208"></a>            <span class="n">update_data</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
-</span><span id="__span-0-2209"><a id="__codelineno-0-2209" name="__codelineno-0-2209"></a>
-</span><span id="__span-0-2210"><a id="__codelineno-0-2210" name="__codelineno-0-2210"></a>        <span class="n">update_data_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">update_data</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
-</span><span id="__span-0-2211"><a id="__codelineno-0-2211" name="__codelineno-0-2211"></a>        <span class="n">model_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">_column</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">_column</span> <span class="ow">in</span> <span class="n">inspect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">c</span><span class="p">}</span>
-</span><span id="__span-0-2212"><a id="__codelineno-0-2212" name="__codelineno-0-2212"></a>        <span class="n">extra_fields</span> <span class="o">=</span> <span class="n">update_data_keys</span> <span class="o">-</span> <span class="n">model_columns</span>
-</span><span id="__span-0-2213"><a id="__codelineno-0-2213" name="__codelineno-0-2213"></a>        <span class="k">if</span> <span class="n">extra_fields</span><span class="p">:</span>
-</span><span id="__span-0-2214"><a id="__codelineno-0-2214" name="__codelineno-0-2214"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Extra fields provided: </span><span class="si">{</span><span class="n">extra_fields</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-2215"><a id="__codelineno-0-2215" name="__codelineno-0-2215"></a>
-</span><span id="__span-0-2216"><a id="__codelineno-0-2216" name="__codelineno-0-2216"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2217"><a id="__codelineno-0-2217" name="__codelineno-0-2217"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="n">update_data</span><span class="p">)</span>
+</span><span id="__span-0-2201"><a id="__codelineno-0-2201" name="__codelineno-0-2201"></a><span class="sd">            Update a user&#39;s email and return the updated record as a dictionary:</span>
+</span><span id="__span-0-2202"><a id="__codelineno-0-2202" name="__codelineno-0-2202"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2203"><a id="__codelineno-0-2203" name="__codelineno-0-2203"></a><span class="sd">            user = await user_crud.update(</span>
+</span><span id="__span-0-2204"><a id="__codelineno-0-2204" name="__codelineno-0-2204"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2205"><a id="__codelineno-0-2205" name="__codelineno-0-2205"></a><span class="sd">                {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
+</span><span id="__span-0-2206"><a id="__codelineno-0-2206" name="__codelineno-0-2206"></a><span class="sd">                return_columns=[&#39;id&#39;, &#39;email&#39;],</span>
+</span><span id="__span-0-2207"><a id="__codelineno-0-2207" name="__codelineno-0-2207"></a><span class="sd">                id=1,</span>
+</span><span id="__span-0-2208"><a id="__codelineno-0-2208" name="__codelineno-0-2208"></a><span class="sd">            )</span>
+</span><span id="__span-0-2209"><a id="__codelineno-0-2209" name="__codelineno-0-2209"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2210"><a id="__codelineno-0-2210" name="__codelineno-0-2210"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-2211"><a id="__codelineno-0-2211" name="__codelineno-0-2211"></a>        <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2212"><a id="__codelineno-0-2212" name="__codelineno-0-2212"></a>        <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2213"><a id="__codelineno-0-2213" name="__codelineno-0-2213"></a>            <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to update.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2214"><a id="__codelineno-0-2214" name="__codelineno-0-2214"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2215"><a id="__codelineno-0-2215" name="__codelineno-0-2215"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2216"><a id="__codelineno-0-2216" name="__codelineno-0-2216"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to update, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2217"><a id="__codelineno-0-2217" name="__codelineno-0-2217"></a>            <span class="p">)</span>
 </span><span id="__span-0-2218"><a id="__codelineno-0-2218" name="__codelineno-0-2218"></a>
-</span><span id="__span-0-2219"><a id="__codelineno-0-2219" name="__codelineno-0-2219"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-2220"><a id="__codelineno-0-2220" name="__codelineno-0-2220"></a>            <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
-</span><span id="__span-0-2221"><a id="__codelineno-0-2221" name="__codelineno-0-2221"></a>
-</span><span id="__span-0-2222"><a id="__codelineno-0-2222" name="__codelineno-0-2222"></a>        <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
-</span><span id="__span-0-2223"><a id="__codelineno-0-2223" name="__codelineno-0-2223"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
-</span><span id="__span-0-2224"><a id="__codelineno-0-2224" name="__codelineno-0-2224"></a>            <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2225"><a id="__codelineno-0-2225" name="__codelineno-0-2225"></a>            <span class="k">if</span> <span class="n">allow_multiple</span><span class="p">:</span>
-</span><span id="__span-0-2226"><a id="__codelineno-0-2226" name="__codelineno-0-2226"></a>                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
-</span><span id="__span-0-2227"><a id="__codelineno-0-2227" name="__codelineno-0-2227"></a>                    <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-2228"><a id="__codelineno-0-2228" name="__codelineno-0-2228"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2229"><a id="__codelineno-0-2229" name="__codelineno-0-2229"></a>                    <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-2230"><a id="__codelineno-0-2230" name="__codelineno-0-2230"></a>                <span class="p">)</span>
-</span><span id="__span-0-2231"><a id="__codelineno-0-2231" name="__codelineno-0-2231"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_single_response</span><span class="p">(</span>
-</span><span id="__span-0-2232"><a id="__codelineno-0-2232" name="__codelineno-0-2232"></a>                <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-2233"><a id="__codelineno-0-2233" name="__codelineno-0-2233"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2234"><a id="__codelineno-0-2234" name="__codelineno-0-2234"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-2235"><a id="__codelineno-0-2235" name="__codelineno-0-2235"></a>                <span class="n">one_or_none</span><span class="o">=</span><span class="n">one_or_none</span><span class="p">,</span>
-</span><span id="__span-0-2236"><a id="__codelineno-0-2236" name="__codelineno-0-2236"></a>            <span class="p">)</span>
-</span><span id="__span-0-2237"><a id="__codelineno-0-2237" name="__codelineno-0-2237"></a>
-</span><span id="__span-0-2238"><a id="__codelineno-0-2238" name="__codelineno-0-2238"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2239"><a id="__codelineno-0-2239" name="__codelineno-0-2239"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2240"><a id="__codelineno-0-2240" name="__codelineno-0-2240"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2241"><a id="__codelineno-0-2241" name="__codelineno-0-2241"></a>        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-2242"><a id="__codelineno-0-2242" name="__codelineno-0-2242"></a>
-</span><span id="__span-0-2243"><a id="__codelineno-0-2243" name="__codelineno-0-2243"></a>    <span class="k">def</span> <span class="nf">_as_single_response</span><span class="p">(</span>
-</span><span id="__span-0-2244"><a id="__codelineno-0-2244" name="__codelineno-0-2244"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2245"><a id="__codelineno-0-2245" name="__codelineno-0-2245"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span>
-</span><span id="__span-0-2246"><a id="__codelineno-0-2246" name="__codelineno-0-2246"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2247"><a id="__codelineno-0-2247" name="__codelineno-0-2247"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2248"><a id="__codelineno-0-2248" name="__codelineno-0-2248"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2249"><a id="__codelineno-0-2249" name="__codelineno-0-2249"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]:</span>
-</span><span id="__span-0-2250"><a id="__codelineno-0-2250" name="__codelineno-0-2250"></a>        <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-</span><span id="__span-0-2251"><a id="__codelineno-0-2251" name="__codelineno-0-2251"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-2252"><a id="__codelineno-0-2252" name="__codelineno-0-2252"></a>            <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-2253"><a id="__codelineno-0-2253" name="__codelineno-0-2253"></a>        <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
-</span><span id="__span-0-2254"><a id="__codelineno-0-2254" name="__codelineno-0-2254"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-2255"><a id="__codelineno-0-2255" name="__codelineno-0-2255"></a>            <span class="k">return</span> <span class="n">out</span>
-</span><span id="__span-0-2256"><a id="__codelineno-0-2256" name="__codelineno-0-2256"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-2257"><a id="__codelineno-0-2257" name="__codelineno-0-2257"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-2258"><a id="__codelineno-0-2258" name="__codelineno-0-2258"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-2259"><a id="__codelineno-0-2259" name="__codelineno-0-2259"></a>            <span class="p">)</span>
-</span><span id="__span-0-2260"><a id="__codelineno-0-2260" name="__codelineno-0-2260"></a>        <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
-</span><span id="__span-0-2261"><a id="__codelineno-0-2261" name="__codelineno-0-2261"></a>
-</span><span id="__span-0-2262"><a id="__codelineno-0-2262" name="__codelineno-0-2262"></a>    <span class="k">def</span> <span class="nf">_as_multi_response</span><span class="p">(</span>
-</span><span id="__span-0-2263"><a id="__codelineno-0-2263" name="__codelineno-0-2263"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2264"><a id="__codelineno-0-2264" name="__codelineno-0-2264"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span>
-</span><span id="__span-0-2265"><a id="__codelineno-0-2265" name="__codelineno-0-2265"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2266"><a id="__codelineno-0-2266" name="__codelineno-0-2266"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2267"><a id="__codelineno-0-2267" name="__codelineno-0-2267"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
-</span><span id="__span-0-2268"><a id="__codelineno-0-2268" name="__codelineno-0-2268"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">db_row</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
-</span><span id="__span-0-2269"><a id="__codelineno-0-2269" name="__codelineno-0-2269"></a>
-</span><span id="__span-0-2270"><a id="__codelineno-0-2270" name="__codelineno-0-2270"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
-</span><span id="__span-0-2271"><a id="__codelineno-0-2271" name="__codelineno-0-2271"></a>
-</span><span id="__span-0-2272"><a id="__codelineno-0-2272" name="__codelineno-0-2272"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-2273"><a id="__codelineno-0-2273" name="__codelineno-0-2273"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-2274"><a id="__codelineno-0-2274" name="__codelineno-0-2274"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-2275"><a id="__codelineno-0-2275" name="__codelineno-0-2275"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-2276"><a id="__codelineno-0-2276" name="__codelineno-0-2276"></a>                <span class="p">)</span>
-</span><span id="__span-0-2277"><a id="__codelineno-0-2277" name="__codelineno-0-2277"></a>            <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-2278"><a id="__codelineno-0-2278" name="__codelineno-0-2278"></a>                <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
-</span><span id="__span-0-2279"><a id="__codelineno-0-2279" name="__codelineno-0-2279"></a>                <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
-</span><span id="__span-0-2280"><a id="__codelineno-0-2280" name="__codelineno-0-2280"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-2281"><a id="__codelineno-0-2281" name="__codelineno-0-2281"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-2282"><a id="__codelineno-0-2282" name="__codelineno-0-2282"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-2283"><a id="__codelineno-0-2283" name="__codelineno-0-2283"></a>                <span class="p">)</span>
-</span><span id="__span-0-2284"><a id="__codelineno-0-2284" name="__codelineno-0-2284"></a>
-</span><span id="__span-0-2285"><a id="__codelineno-0-2285" name="__codelineno-0-2285"></a>        <span class="k">return</span> <span class="n">response</span>
-</span><span id="__span-0-2286"><a id="__codelineno-0-2286" name="__codelineno-0-2286"></a>
-</span><span id="__span-0-2287"><a id="__codelineno-0-2287" name="__codelineno-0-2287"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">db_delete</span><span class="p">(</span>
-</span><span id="__span-0-2288"><a id="__codelineno-0-2288" name="__codelineno-0-2288"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2289"><a id="__codelineno-0-2289" name="__codelineno-0-2289"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2290"><a id="__codelineno-0-2290" name="__codelineno-0-2290"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2291"><a id="__codelineno-0-2291" name="__codelineno-0-2291"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2292"><a id="__codelineno-0-2292" name="__codelineno-0-2292"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2293"><a id="__codelineno-0-2293" name="__codelineno-0-2293"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-2294"><a id="__codelineno-0-2294" name="__codelineno-0-2294"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2295"><a id="__codelineno-0-2295" name="__codelineno-0-2295"></a><span class="sd">        Deletes a record or multiple records from the database based on specified filters.</span>
-</span><span id="__span-0-2296"><a id="__codelineno-0-2296" name="__codelineno-0-2296"></a>
-</span><span id="__span-0-2297"><a id="__codelineno-0-2297" name="__codelineno-0-2297"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2298"><a id="__codelineno-0-2298" name="__codelineno-0-2298"></a>
-</span><span id="__span-0-2299"><a id="__codelineno-0-2299" name="__codelineno-0-2299"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-2300"><a id="__codelineno-0-2300" name="__codelineno-0-2300"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-2301"><a id="__codelineno-0-2301" name="__codelineno-0-2301"></a><span class="sd">            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2302"><a id="__codelineno-0-2302" name="__codelineno-0-2302"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2303"><a id="__codelineno-0-2303" name="__codelineno-0-2303"></a><span class="sd">            **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</span>
+</span><span id="__span-0-2219"><a id="__codelineno-0-2219" name="__codelineno-0-2219"></a>        <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">object</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
+</span><span id="__span-0-2220"><a id="__codelineno-0-2220" name="__codelineno-0-2220"></a>            <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span>
+</span><span id="__span-0-2221"><a id="__codelineno-0-2221" name="__codelineno-0-2221"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2222"><a id="__codelineno-0-2222" name="__codelineno-0-2222"></a>            <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">(</span><span class="n">exclude_unset</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-2223"><a id="__codelineno-0-2223" name="__codelineno-0-2223"></a>
+</span><span id="__span-0-2224"><a id="__codelineno-0-2224" name="__codelineno-0-2224"></a>        <span class="n">updated_at_col</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-2225"><a id="__codelineno-0-2225" name="__codelineno-0-2225"></a>        <span class="k">if</span> <span class="n">updated_at_col</span><span class="p">:</span>
+</span><span id="__span-0-2226"><a id="__codelineno-0-2226" name="__codelineno-0-2226"></a>            <span class="n">update_data</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="__span-0-2227"><a id="__codelineno-0-2227" name="__codelineno-0-2227"></a>
+</span><span id="__span-0-2228"><a id="__codelineno-0-2228" name="__codelineno-0-2228"></a>        <span class="n">update_data_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">update_data</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
+</span><span id="__span-0-2229"><a id="__codelineno-0-2229" name="__codelineno-0-2229"></a>        <span class="n">model_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">_column</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">_column</span> <span class="ow">in</span> <span class="n">inspect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">c</span><span class="p">}</span>
+</span><span id="__span-0-2230"><a id="__codelineno-0-2230" name="__codelineno-0-2230"></a>        <span class="n">extra_fields</span> <span class="o">=</span> <span class="n">update_data_keys</span> <span class="o">-</span> <span class="n">model_columns</span>
+</span><span id="__span-0-2231"><a id="__codelineno-0-2231" name="__codelineno-0-2231"></a>        <span class="k">if</span> <span class="n">extra_fields</span><span class="p">:</span>
+</span><span id="__span-0-2232"><a id="__codelineno-0-2232" name="__codelineno-0-2232"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Extra fields provided: </span><span class="si">{</span><span class="n">extra_fields</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2233"><a id="__codelineno-0-2233" name="__codelineno-0-2233"></a>
+</span><span id="__span-0-2234"><a id="__codelineno-0-2234" name="__codelineno-0-2234"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2235"><a id="__codelineno-0-2235" name="__codelineno-0-2235"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="n">update_data</span><span class="p">)</span>
+</span><span id="__span-0-2236"><a id="__codelineno-0-2236" name="__codelineno-0-2236"></a>
+</span><span id="__span-0-2237"><a id="__codelineno-0-2237" name="__codelineno-0-2237"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-2238"><a id="__codelineno-0-2238" name="__codelineno-0-2238"></a>            <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
+</span><span id="__span-0-2239"><a id="__codelineno-0-2239" name="__codelineno-0-2239"></a>
+</span><span id="__span-0-2240"><a id="__codelineno-0-2240" name="__codelineno-0-2240"></a>        <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
+</span><span id="__span-0-2241"><a id="__codelineno-0-2241" name="__codelineno-0-2241"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
+</span><span id="__span-0-2242"><a id="__codelineno-0-2242" name="__codelineno-0-2242"></a>            <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2243"><a id="__codelineno-0-2243" name="__codelineno-0-2243"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2244"><a id="__codelineno-0-2244" name="__codelineno-0-2244"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2245"><a id="__codelineno-0-2245" name="__codelineno-0-2245"></a>            <span class="k">if</span> <span class="n">allow_multiple</span><span class="p">:</span>
+</span><span id="__span-0-2246"><a id="__codelineno-0-2246" name="__codelineno-0-2246"></a>                <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
+</span><span id="__span-0-2247"><a id="__codelineno-0-2247" name="__codelineno-0-2247"></a>                    <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-2248"><a id="__codelineno-0-2248" name="__codelineno-0-2248"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-2249"><a id="__codelineno-0-2249" name="__codelineno-0-2249"></a>                    <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-2250"><a id="__codelineno-0-2250" name="__codelineno-0-2250"></a>                <span class="p">)</span>
+</span><span id="__span-0-2251"><a id="__codelineno-0-2251" name="__codelineno-0-2251"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_single_response</span><span class="p">(</span>
+</span><span id="__span-0-2252"><a id="__codelineno-0-2252" name="__codelineno-0-2252"></a>                <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-2253"><a id="__codelineno-0-2253" name="__codelineno-0-2253"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-2254"><a id="__codelineno-0-2254" name="__codelineno-0-2254"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-2255"><a id="__codelineno-0-2255" name="__codelineno-0-2255"></a>                <span class="n">one_or_none</span><span class="o">=</span><span class="n">one_or_none</span><span class="p">,</span>
+</span><span id="__span-0-2256"><a id="__codelineno-0-2256" name="__codelineno-0-2256"></a>            <span class="p">)</span>
+</span><span id="__span-0-2257"><a id="__codelineno-0-2257" name="__codelineno-0-2257"></a>
+</span><span id="__span-0-2258"><a id="__codelineno-0-2258" name="__codelineno-0-2258"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2259"><a id="__codelineno-0-2259" name="__codelineno-0-2259"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2260"><a id="__codelineno-0-2260" name="__codelineno-0-2260"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2261"><a id="__codelineno-0-2261" name="__codelineno-0-2261"></a>        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-2262"><a id="__codelineno-0-2262" name="__codelineno-0-2262"></a>
+</span><span id="__span-0-2263"><a id="__codelineno-0-2263" name="__codelineno-0-2263"></a>    <span class="k">def</span> <span class="nf">_as_single_response</span><span class="p">(</span>
+</span><span id="__span-0-2264"><a id="__codelineno-0-2264" name="__codelineno-0-2264"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2265"><a id="__codelineno-0-2265" name="__codelineno-0-2265"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span>
+</span><span id="__span-0-2266"><a id="__codelineno-0-2266" name="__codelineno-0-2266"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2267"><a id="__codelineno-0-2267" name="__codelineno-0-2267"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2268"><a id="__codelineno-0-2268" name="__codelineno-0-2268"></a>        <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2269"><a id="__codelineno-0-2269" name="__codelineno-0-2269"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]:</span>
+</span><span id="__span-0-2270"><a id="__codelineno-0-2270" name="__codelineno-0-2270"></a>        <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+</span><span id="__span-0-2271"><a id="__codelineno-0-2271" name="__codelineno-0-2271"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-2272"><a id="__codelineno-0-2272" name="__codelineno-0-2272"></a>            <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-2273"><a id="__codelineno-0-2273" name="__codelineno-0-2273"></a>        <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
+</span><span id="__span-0-2274"><a id="__codelineno-0-2274" name="__codelineno-0-2274"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-2275"><a id="__codelineno-0-2275" name="__codelineno-0-2275"></a>            <span class="k">return</span> <span class="n">out</span>
+</span><span id="__span-0-2276"><a id="__codelineno-0-2276" name="__codelineno-0-2276"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-2277"><a id="__codelineno-0-2277" name="__codelineno-0-2277"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-2278"><a id="__codelineno-0-2278" name="__codelineno-0-2278"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-2279"><a id="__codelineno-0-2279" name="__codelineno-0-2279"></a>            <span class="p">)</span>
+</span><span id="__span-0-2280"><a id="__codelineno-0-2280" name="__codelineno-0-2280"></a>        <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
+</span><span id="__span-0-2281"><a id="__codelineno-0-2281" name="__codelineno-0-2281"></a>
+</span><span id="__span-0-2282"><a id="__codelineno-0-2282" name="__codelineno-0-2282"></a>    <span class="k">def</span> <span class="nf">_as_multi_response</span><span class="p">(</span>
+</span><span id="__span-0-2283"><a id="__codelineno-0-2283" name="__codelineno-0-2283"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2284"><a id="__codelineno-0-2284" name="__codelineno-0-2284"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Result</span><span class="p">,</span>
+</span><span id="__span-0-2285"><a id="__codelineno-0-2285" name="__codelineno-0-2285"></a>        <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2286"><a id="__codelineno-0-2286" name="__codelineno-0-2286"></a>        <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2287"><a id="__codelineno-0-2287" name="__codelineno-0-2287"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">:</span>
+</span><span id="__span-0-2288"><a id="__codelineno-0-2288" name="__codelineno-0-2288"></a>        <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">db_row</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
+</span><span id="__span-0-2289"><a id="__codelineno-0-2289" name="__codelineno-0-2289"></a>
+</span><span id="__span-0-2290"><a id="__codelineno-0-2290" name="__codelineno-0-2290"></a>        <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
+</span><span id="__span-0-2291"><a id="__codelineno-0-2291" name="__codelineno-0-2291"></a>
+</span><span id="__span-0-2292"><a id="__codelineno-0-2292" name="__codelineno-0-2292"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-2293"><a id="__codelineno-0-2293" name="__codelineno-0-2293"></a>            <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-2294"><a id="__codelineno-0-2294" name="__codelineno-0-2294"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-2295"><a id="__codelineno-0-2295" name="__codelineno-0-2295"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-2296"><a id="__codelineno-0-2296" name="__codelineno-0-2296"></a>                <span class="p">)</span>
+</span><span id="__span-0-2297"><a id="__codelineno-0-2297" name="__codelineno-0-2297"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-2298"><a id="__codelineno-0-2298" name="__codelineno-0-2298"></a>                <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
+</span><span id="__span-0-2299"><a id="__codelineno-0-2299" name="__codelineno-0-2299"></a>                <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
+</span><span id="__span-0-2300"><a id="__codelineno-0-2300" name="__codelineno-0-2300"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-2301"><a id="__codelineno-0-2301" name="__codelineno-0-2301"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-2302"><a id="__codelineno-0-2302" name="__codelineno-0-2302"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-2303"><a id="__codelineno-0-2303" name="__codelineno-0-2303"></a>                <span class="p">)</span>
 </span><span id="__span-0-2304"><a id="__codelineno-0-2304" name="__codelineno-0-2304"></a>
-</span><span id="__span-0-2305"><a id="__codelineno-0-2305" name="__codelineno-0-2305"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-2306"><a id="__codelineno-0-2306" name="__codelineno-0-2306"></a><span class="sd">            None</span>
-</span><span id="__span-0-2307"><a id="__codelineno-0-2307" name="__codelineno-0-2307"></a>
-</span><span id="__span-0-2308"><a id="__codelineno-0-2308" name="__codelineno-0-2308"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-2309"><a id="__codelineno-0-2309" name="__codelineno-0-2309"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2310"><a id="__codelineno-0-2310" name="__codelineno-0-2310"></a>
-</span><span id="__span-0-2311"><a id="__codelineno-0-2311" name="__codelineno-0-2311"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-2312"><a id="__codelineno-0-2312" name="__codelineno-0-2312"></a><span class="sd">            Delete a user based on their ID:</span>
-</span><span id="__span-0-2313"><a id="__codelineno-0-2313" name="__codelineno-0-2313"></a>
-</span><span id="__span-0-2314"><a id="__codelineno-0-2314" name="__codelineno-0-2314"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2315"><a id="__codelineno-0-2315" name="__codelineno-0-2315"></a><span class="sd">            await user_crud.db_delete(db, id=1)</span>
-</span><span id="__span-0-2316"><a id="__codelineno-0-2316" name="__codelineno-0-2316"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2317"><a id="__codelineno-0-2317" name="__codelineno-0-2317"></a>
-</span><span id="__span-0-2318"><a id="__codelineno-0-2318" name="__codelineno-0-2318"></a><span class="sd">            Delete users older than 30 years and allow deletion of multiple records:</span>
-</span><span id="__span-0-2319"><a id="__codelineno-0-2319" name="__codelineno-0-2319"></a>
-</span><span id="__span-0-2320"><a id="__codelineno-0-2320" name="__codelineno-0-2320"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2321"><a id="__codelineno-0-2321" name="__codelineno-0-2321"></a><span class="sd">            await user_crud.db_delete(</span>
-</span><span id="__span-0-2322"><a id="__codelineno-0-2322" name="__codelineno-0-2322"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2323"><a id="__codelineno-0-2323" name="__codelineno-0-2323"></a><span class="sd">                allow_multiple=True,</span>
-</span><span id="__span-0-2324"><a id="__codelineno-0-2324" name="__codelineno-0-2324"></a><span class="sd">                age__gt=30,</span>
-</span><span id="__span-0-2325"><a id="__codelineno-0-2325" name="__codelineno-0-2325"></a><span class="sd">            )</span>
-</span><span id="__span-0-2326"><a id="__codelineno-0-2326" name="__codelineno-0-2326"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2305"><a id="__codelineno-0-2305" name="__codelineno-0-2305"></a>        <span class="k">return</span> <span class="n">response</span>
+</span><span id="__span-0-2306"><a id="__codelineno-0-2306" name="__codelineno-0-2306"></a>
+</span><span id="__span-0-2307"><a id="__codelineno-0-2307" name="__codelineno-0-2307"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">db_delete</span><span class="p">(</span>
+</span><span id="__span-0-2308"><a id="__codelineno-0-2308" name="__codelineno-0-2308"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2309"><a id="__codelineno-0-2309" name="__codelineno-0-2309"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2310"><a id="__codelineno-0-2310" name="__codelineno-0-2310"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2311"><a id="__codelineno-0-2311" name="__codelineno-0-2311"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2312"><a id="__codelineno-0-2312" name="__codelineno-0-2312"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2313"><a id="__codelineno-0-2313" name="__codelineno-0-2313"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-2314"><a id="__codelineno-0-2314" name="__codelineno-0-2314"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2315"><a id="__codelineno-0-2315" name="__codelineno-0-2315"></a><span class="sd">        Deletes a record or multiple records from the database based on specified filters.</span>
+</span><span id="__span-0-2316"><a id="__codelineno-0-2316" name="__codelineno-0-2316"></a>
+</span><span id="__span-0-2317"><a id="__codelineno-0-2317" name="__codelineno-0-2317"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2318"><a id="__codelineno-0-2318" name="__codelineno-0-2318"></a>
+</span><span id="__span-0-2319"><a id="__codelineno-0-2319" name="__codelineno-0-2319"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-2320"><a id="__codelineno-0-2320" name="__codelineno-0-2320"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-2321"><a id="__codelineno-0-2321" name="__codelineno-0-2321"></a><span class="sd">            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2322"><a id="__codelineno-0-2322" name="__codelineno-0-2322"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2323"><a id="__codelineno-0-2323" name="__codelineno-0-2323"></a><span class="sd">            **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</span>
+</span><span id="__span-0-2324"><a id="__codelineno-0-2324" name="__codelineno-0-2324"></a>
+</span><span id="__span-0-2325"><a id="__codelineno-0-2325" name="__codelineno-0-2325"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-2326"><a id="__codelineno-0-2326" name="__codelineno-0-2326"></a><span class="sd">            None</span>
 </span><span id="__span-0-2327"><a id="__codelineno-0-2327" name="__codelineno-0-2327"></a>
-</span><span id="__span-0-2328"><a id="__codelineno-0-2328" name="__codelineno-0-2328"></a><span class="sd">            Delete a user with a specific username, ensuring only one record is deleted:</span>
-</span><span id="__span-0-2329"><a id="__codelineno-0-2329" name="__codelineno-0-2329"></a>
-</span><span id="__span-0-2330"><a id="__codelineno-0-2330" name="__codelineno-0-2330"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2331"><a id="__codelineno-0-2331" name="__codelineno-0-2331"></a><span class="sd">            await user_crud.db_delete(</span>
-</span><span id="__span-0-2332"><a id="__codelineno-0-2332" name="__codelineno-0-2332"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2333"><a id="__codelineno-0-2333" name="__codelineno-0-2333"></a><span class="sd">                allow_multiple=False,</span>
-</span><span id="__span-0-2334"><a id="__codelineno-0-2334" name="__codelineno-0-2334"></a><span class="sd">                username=&#39;unique_username&#39;,</span>
-</span><span id="__span-0-2335"><a id="__codelineno-0-2335" name="__codelineno-0-2335"></a><span class="sd">            )</span>
+</span><span id="__span-0-2328"><a id="__codelineno-0-2328" name="__codelineno-0-2328"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-2329"><a id="__codelineno-0-2329" name="__codelineno-0-2329"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2330"><a id="__codelineno-0-2330" name="__codelineno-0-2330"></a>
+</span><span id="__span-0-2331"><a id="__codelineno-0-2331" name="__codelineno-0-2331"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-2332"><a id="__codelineno-0-2332" name="__codelineno-0-2332"></a><span class="sd">            Delete a user based on their ID:</span>
+</span><span id="__span-0-2333"><a id="__codelineno-0-2333" name="__codelineno-0-2333"></a>
+</span><span id="__span-0-2334"><a id="__codelineno-0-2334" name="__codelineno-0-2334"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2335"><a id="__codelineno-0-2335" name="__codelineno-0-2335"></a><span class="sd">            await user_crud.db_delete(db, id=1)</span>
 </span><span id="__span-0-2336"><a id="__codelineno-0-2336" name="__codelineno-0-2336"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2337"><a id="__codelineno-0-2337" name="__codelineno-0-2337"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-2338"><a id="__codelineno-0-2338" name="__codelineno-0-2338"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2339"><a id="__codelineno-0-2339" name="__codelineno-0-2339"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2340"><a id="__codelineno-0-2340" name="__codelineno-0-2340"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2341"><a id="__codelineno-0-2341" name="__codelineno-0-2341"></a>            <span class="p">)</span>
-</span><span id="__span-0-2342"><a id="__codelineno-0-2342" name="__codelineno-0-2342"></a>
-</span><span id="__span-0-2343"><a id="__codelineno-0-2343" name="__codelineno-0-2343"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2344"><a id="__codelineno-0-2344" name="__codelineno-0-2344"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">delete</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-2345"><a id="__codelineno-0-2345" name="__codelineno-0-2345"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2346"><a id="__codelineno-0-2346" name="__codelineno-0-2346"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2347"><a id="__codelineno-0-2347" name="__codelineno-0-2347"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2348"><a id="__codelineno-0-2348" name="__codelineno-0-2348"></a>
-</span><span id="__span-0-2349"><a id="__codelineno-0-2349" name="__codelineno-0-2349"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">delete</span><span class="p">(</span>
-</span><span id="__span-0-2350"><a id="__codelineno-0-2350" name="__codelineno-0-2350"></a>        <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2351"><a id="__codelineno-0-2351" name="__codelineno-0-2351"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2352"><a id="__codelineno-0-2352" name="__codelineno-0-2352"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2353"><a id="__codelineno-0-2353" name="__codelineno-0-2353"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2354"><a id="__codelineno-0-2354" name="__codelineno-0-2354"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2355"><a id="__codelineno-0-2355" name="__codelineno-0-2355"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2356"><a id="__codelineno-0-2356" name="__codelineno-0-2356"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-2357"><a id="__codelineno-0-2357" name="__codelineno-0-2357"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2358"><a id="__codelineno-0-2358" name="__codelineno-0-2358"></a><span class="sd">        Soft deletes a record or optionally multiple records if it has an `&quot;is_deleted&quot;` attribute, otherwise performs a hard delete, based on specified filters.</span>
-</span><span id="__span-0-2359"><a id="__codelineno-0-2359" name="__codelineno-0-2359"></a>
-</span><span id="__span-0-2360"><a id="__codelineno-0-2360" name="__codelineno-0-2360"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2361"><a id="__codelineno-0-2361" name="__codelineno-0-2361"></a>
-</span><span id="__span-0-2362"><a id="__codelineno-0-2362" name="__codelineno-0-2362"></a><span class="sd">        Args:</span>
-</span><span id="__span-0-2363"><a id="__codelineno-0-2363" name="__codelineno-0-2363"></a><span class="sd">            db: The database session to use for the operation.</span>
-</span><span id="__span-0-2364"><a id="__codelineno-0-2364" name="__codelineno-0-2364"></a><span class="sd">            db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</span>
-</span><span id="__span-0-2365"><a id="__codelineno-0-2365" name="__codelineno-0-2365"></a><span class="sd">            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2366"><a id="__codelineno-0-2366" name="__codelineno-0-2366"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2367"><a id="__codelineno-0-2367" name="__codelineno-0-2367"></a><span class="sd">            **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-2337"><a id="__codelineno-0-2337" name="__codelineno-0-2337"></a>
+</span><span id="__span-0-2338"><a id="__codelineno-0-2338" name="__codelineno-0-2338"></a><span class="sd">            Delete users older than 30 years and allow deletion of multiple records:</span>
+</span><span id="__span-0-2339"><a id="__codelineno-0-2339" name="__codelineno-0-2339"></a>
+</span><span id="__span-0-2340"><a id="__codelineno-0-2340" name="__codelineno-0-2340"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2341"><a id="__codelineno-0-2341" name="__codelineno-0-2341"></a><span class="sd">            await user_crud.db_delete(</span>
+</span><span id="__span-0-2342"><a id="__codelineno-0-2342" name="__codelineno-0-2342"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2343"><a id="__codelineno-0-2343" name="__codelineno-0-2343"></a><span class="sd">                allow_multiple=True,</span>
+</span><span id="__span-0-2344"><a id="__codelineno-0-2344" name="__codelineno-0-2344"></a><span class="sd">                age__gt=30,</span>
+</span><span id="__span-0-2345"><a id="__codelineno-0-2345" name="__codelineno-0-2345"></a><span class="sd">            )</span>
+</span><span id="__span-0-2346"><a id="__codelineno-0-2346" name="__codelineno-0-2346"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2347"><a id="__codelineno-0-2347" name="__codelineno-0-2347"></a>
+</span><span id="__span-0-2348"><a id="__codelineno-0-2348" name="__codelineno-0-2348"></a><span class="sd">            Delete a user with a specific username, ensuring only one record is deleted:</span>
+</span><span id="__span-0-2349"><a id="__codelineno-0-2349" name="__codelineno-0-2349"></a>
+</span><span id="__span-0-2350"><a id="__codelineno-0-2350" name="__codelineno-0-2350"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2351"><a id="__codelineno-0-2351" name="__codelineno-0-2351"></a><span class="sd">            await user_crud.db_delete(</span>
+</span><span id="__span-0-2352"><a id="__codelineno-0-2352" name="__codelineno-0-2352"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2353"><a id="__codelineno-0-2353" name="__codelineno-0-2353"></a><span class="sd">                allow_multiple=False,</span>
+</span><span id="__span-0-2354"><a id="__codelineno-0-2354" name="__codelineno-0-2354"></a><span class="sd">                username=&#39;unique_username&#39;,</span>
+</span><span id="__span-0-2355"><a id="__codelineno-0-2355" name="__codelineno-0-2355"></a><span class="sd">            )</span>
+</span><span id="__span-0-2356"><a id="__codelineno-0-2356" name="__codelineno-0-2356"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2357"><a id="__codelineno-0-2357" name="__codelineno-0-2357"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-2358"><a id="__codelineno-0-2358" name="__codelineno-0-2358"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2359"><a id="__codelineno-0-2359" name="__codelineno-0-2359"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2360"><a id="__codelineno-0-2360" name="__codelineno-0-2360"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2361"><a id="__codelineno-0-2361" name="__codelineno-0-2361"></a>            <span class="p">)</span>
+</span><span id="__span-0-2362"><a id="__codelineno-0-2362" name="__codelineno-0-2362"></a>
+</span><span id="__span-0-2363"><a id="__codelineno-0-2363" name="__codelineno-0-2363"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2364"><a id="__codelineno-0-2364" name="__codelineno-0-2364"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">delete</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-2365"><a id="__codelineno-0-2365" name="__codelineno-0-2365"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2366"><a id="__codelineno-0-2366" name="__codelineno-0-2366"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2367"><a id="__codelineno-0-2367" name="__codelineno-0-2367"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
 </span><span id="__span-0-2368"><a id="__codelineno-0-2368" name="__codelineno-0-2368"></a>
-</span><span id="__span-0-2369"><a id="__codelineno-0-2369" name="__codelineno-0-2369"></a><span class="sd">        Raises:</span>
-</span><span id="__span-0-2370"><a id="__codelineno-0-2370" name="__codelineno-0-2370"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2371"><a id="__codelineno-0-2371" name="__codelineno-0-2371"></a><span class="sd">            NoResultFound: If no record matches the filters.</span>
-</span><span id="__span-0-2372"><a id="__codelineno-0-2372" name="__codelineno-0-2372"></a>
-</span><span id="__span-0-2373"><a id="__codelineno-0-2373" name="__codelineno-0-2373"></a><span class="sd">        Returns:</span>
-</span><span id="__span-0-2374"><a id="__codelineno-0-2374" name="__codelineno-0-2374"></a><span class="sd">            None</span>
-</span><span id="__span-0-2375"><a id="__codelineno-0-2375" name="__codelineno-0-2375"></a>
-</span><span id="__span-0-2376"><a id="__codelineno-0-2376" name="__codelineno-0-2376"></a><span class="sd">        Examples:</span>
-</span><span id="__span-0-2377"><a id="__codelineno-0-2377" name="__codelineno-0-2377"></a><span class="sd">            Soft delete a specific user by ID:</span>
-</span><span id="__span-0-2378"><a id="__codelineno-0-2378" name="__codelineno-0-2378"></a>
-</span><span id="__span-0-2379"><a id="__codelineno-0-2379" name="__codelineno-0-2379"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2380"><a id="__codelineno-0-2380" name="__codelineno-0-2380"></a><span class="sd">            await user_crud.delete(db, id=1)</span>
-</span><span id="__span-0-2381"><a id="__codelineno-0-2381" name="__codelineno-0-2381"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2382"><a id="__codelineno-0-2382" name="__codelineno-0-2382"></a>
-</span><span id="__span-0-2383"><a id="__codelineno-0-2383" name="__codelineno-0-2383"></a><span class="sd">            Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</span>
-</span><span id="__span-0-2384"><a id="__codelineno-0-2384" name="__codelineno-0-2384"></a>
-</span><span id="__span-0-2385"><a id="__codelineno-0-2385" name="__codelineno-0-2385"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2386"><a id="__codelineno-0-2386" name="__codelineno-0-2386"></a><span class="sd">            await user_crud.delete(</span>
-</span><span id="__span-0-2387"><a id="__codelineno-0-2387" name="__codelineno-0-2387"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2388"><a id="__codelineno-0-2388" name="__codelineno-0-2388"></a><span class="sd">                allow_multiple=True,</span>
-</span><span id="__span-0-2389"><a id="__codelineno-0-2389" name="__codelineno-0-2389"></a><span class="sd">                creation_date__lt=datetime(2020, 1, 1),</span>
-</span><span id="__span-0-2390"><a id="__codelineno-0-2390" name="__codelineno-0-2390"></a><span class="sd">            )</span>
-</span><span id="__span-0-2391"><a id="__codelineno-0-2391" name="__codelineno-0-2391"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2369"><a id="__codelineno-0-2369" name="__codelineno-0-2369"></a>    <span class="k">async</span> <span class="k">def</span> <span class="nf">delete</span><span class="p">(</span>
+</span><span id="__span-0-2370"><a id="__codelineno-0-2370" name="__codelineno-0-2370"></a>        <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2371"><a id="__codelineno-0-2371" name="__codelineno-0-2371"></a>        <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2372"><a id="__codelineno-0-2372" name="__codelineno-0-2372"></a>        <span class="n">db_row</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2373"><a id="__codelineno-0-2373" name="__codelineno-0-2373"></a>        <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2374"><a id="__codelineno-0-2374" name="__codelineno-0-2374"></a>        <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2375"><a id="__codelineno-0-2375" name="__codelineno-0-2375"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2376"><a id="__codelineno-0-2376" name="__codelineno-0-2376"></a>    <span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-2377"><a id="__codelineno-0-2377" name="__codelineno-0-2377"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2378"><a id="__codelineno-0-2378" name="__codelineno-0-2378"></a><span class="sd">        Soft deletes a record or optionally multiple records if it has an `&quot;is_deleted&quot;` attribute, otherwise performs a hard delete, based on specified filters.</span>
+</span><span id="__span-0-2379"><a id="__codelineno-0-2379" name="__codelineno-0-2379"></a>
+</span><span id="__span-0-2380"><a id="__codelineno-0-2380" name="__codelineno-0-2380"></a><span class="sd">        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2381"><a id="__codelineno-0-2381" name="__codelineno-0-2381"></a>
+</span><span id="__span-0-2382"><a id="__codelineno-0-2382" name="__codelineno-0-2382"></a><span class="sd">        Args:</span>
+</span><span id="__span-0-2383"><a id="__codelineno-0-2383" name="__codelineno-0-2383"></a><span class="sd">            db: The database session to use for the operation.</span>
+</span><span id="__span-0-2384"><a id="__codelineno-0-2384" name="__codelineno-0-2384"></a><span class="sd">            db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</span>
+</span><span id="__span-0-2385"><a id="__codelineno-0-2385" name="__codelineno-0-2385"></a><span class="sd">            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2386"><a id="__codelineno-0-2386" name="__codelineno-0-2386"></a><span class="sd">            commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2387"><a id="__codelineno-0-2387" name="__codelineno-0-2387"></a><span class="sd">            **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-2388"><a id="__codelineno-0-2388" name="__codelineno-0-2388"></a>
+</span><span id="__span-0-2389"><a id="__codelineno-0-2389" name="__codelineno-0-2389"></a><span class="sd">        Raises:</span>
+</span><span id="__span-0-2390"><a id="__codelineno-0-2390" name="__codelineno-0-2390"></a><span class="sd">            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2391"><a id="__codelineno-0-2391" name="__codelineno-0-2391"></a><span class="sd">            NoResultFound: If no record matches the filters.</span>
 </span><span id="__span-0-2392"><a id="__codelineno-0-2392" name="__codelineno-0-2392"></a>
-</span><span id="__span-0-2393"><a id="__codelineno-0-2393" name="__codelineno-0-2393"></a><span class="sd">            Soft delete a user with a specific email, ensuring only one record is deleted:</span>
-</span><span id="__span-0-2394"><a id="__codelineno-0-2394" name="__codelineno-0-2394"></a>
-</span><span id="__span-0-2395"><a id="__codelineno-0-2395" name="__codelineno-0-2395"></a><span class="sd">            ```python</span>
-</span><span id="__span-0-2396"><a id="__codelineno-0-2396" name="__codelineno-0-2396"></a><span class="sd">            await user_crud.delete(</span>
-</span><span id="__span-0-2397"><a id="__codelineno-0-2397" name="__codelineno-0-2397"></a><span class="sd">                db,</span>
-</span><span id="__span-0-2398"><a id="__codelineno-0-2398" name="__codelineno-0-2398"></a><span class="sd">                allow_multiple=False,</span>
-</span><span id="__span-0-2399"><a id="__codelineno-0-2399" name="__codelineno-0-2399"></a><span class="sd">                email=&#39;unique@example.com&#39;,</span>
-</span><span id="__span-0-2400"><a id="__codelineno-0-2400" name="__codelineno-0-2400"></a><span class="sd">            )</span>
+</span><span id="__span-0-2393"><a id="__codelineno-0-2393" name="__codelineno-0-2393"></a><span class="sd">        Returns:</span>
+</span><span id="__span-0-2394"><a id="__codelineno-0-2394" name="__codelineno-0-2394"></a><span class="sd">            None</span>
+</span><span id="__span-0-2395"><a id="__codelineno-0-2395" name="__codelineno-0-2395"></a>
+</span><span id="__span-0-2396"><a id="__codelineno-0-2396" name="__codelineno-0-2396"></a><span class="sd">        Examples:</span>
+</span><span id="__span-0-2397"><a id="__codelineno-0-2397" name="__codelineno-0-2397"></a><span class="sd">            Soft delete a specific user by ID:</span>
+</span><span id="__span-0-2398"><a id="__codelineno-0-2398" name="__codelineno-0-2398"></a>
+</span><span id="__span-0-2399"><a id="__codelineno-0-2399" name="__codelineno-0-2399"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2400"><a id="__codelineno-0-2400" name="__codelineno-0-2400"></a><span class="sd">            await user_crud.delete(db, id=1)</span>
 </span><span id="__span-0-2401"><a id="__codelineno-0-2401" name="__codelineno-0-2401"></a><span class="sd">            ```</span>
-</span><span id="__span-0-2402"><a id="__codelineno-0-2402" name="__codelineno-0-2402"></a><span class="sd">        &quot;&quot;&quot;</span>
-</span><span id="__span-0-2403"><a id="__codelineno-0-2403" name="__codelineno-0-2403"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2404"><a id="__codelineno-0-2404" name="__codelineno-0-2404"></a>        <span class="k">if</span> <span class="n">db_row</span><span class="p">:</span>
-</span><span id="__span-0-2405"><a id="__codelineno-0-2405" name="__codelineno-0-2405"></a>            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span>
-</span><span id="__span-0-2406"><a id="__codelineno-0-2406" name="__codelineno-0-2406"></a>                <span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
-</span><span id="__span-0-2407"><a id="__codelineno-0-2407" name="__codelineno-0-2407"></a>            <span class="p">):</span>
-</span><span id="__span-0-2408"><a id="__codelineno-0-2408" name="__codelineno-0-2408"></a>                <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-2409"><a id="__codelineno-0-2409" name="__codelineno-0-2409"></a>                <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">,</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">))</span>
-</span><span id="__span-0-2410"><a id="__codelineno-0-2410" name="__codelineno-0-2410"></a>                <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2411"><a id="__codelineno-0-2411" name="__codelineno-0-2411"></a>                    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2412"><a id="__codelineno-0-2412" name="__codelineno-0-2412"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2413"><a id="__codelineno-0-2413" name="__codelineno-0-2413"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db_row</span><span class="p">)</span>
-</span><span id="__span-0-2414"><a id="__codelineno-0-2414" name="__codelineno-0-2414"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2415"><a id="__codelineno-0-2415" name="__codelineno-0-2415"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2416"><a id="__codelineno-0-2416" name="__codelineno-0-2416"></a>            <span class="k">return</span>
-</span><span id="__span-0-2417"><a id="__codelineno-0-2417" name="__codelineno-0-2417"></a>
-</span><span id="__span-0-2418"><a id="__codelineno-0-2418" name="__codelineno-0-2418"></a>        <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2419"><a id="__codelineno-0-2419" name="__codelineno-0-2419"></a>        <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-2420"><a id="__codelineno-0-2420" name="__codelineno-0-2420"></a>            <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to delete.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-2421"><a id="__codelineno-0-2421" name="__codelineno-0-2421"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2422"><a id="__codelineno-0-2422" name="__codelineno-0-2422"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2423"><a id="__codelineno-0-2423" name="__codelineno-0-2423"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2424"><a id="__codelineno-0-2424" name="__codelineno-0-2424"></a>            <span class="p">)</span>
-</span><span id="__span-0-2425"><a id="__codelineno-0-2425" name="__codelineno-0-2425"></a>
-</span><span id="__span-0-2426"><a id="__codelineno-0-2426" name="__codelineno-0-2426"></a>        <span class="n">update_values</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Union</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">datetime</span><span class="p">]]</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-2427"><a id="__codelineno-0-2427" name="__codelineno-0-2427"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
-</span><span id="__span-0-2428"><a id="__codelineno-0-2428" name="__codelineno-0-2428"></a>            <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
-</span><span id="__span-0-2429"><a id="__codelineno-0-2429" name="__codelineno-0-2429"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
-</span><span id="__span-0-2430"><a id="__codelineno-0-2430" name="__codelineno-0-2430"></a>            <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="__span-0-2431"><a id="__codelineno-0-2431" name="__codelineno-0-2431"></a>
-</span><span id="__span-0-2432"><a id="__codelineno-0-2432" name="__codelineno-0-2432"></a>        <span class="k">if</span> <span class="n">update_values</span><span class="p">:</span>
-</span><span id="__span-0-2433"><a id="__codelineno-0-2433" name="__codelineno-0-2433"></a>            <span class="n">update_stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="o">**</span><span class="n">update_values</span><span class="p">)</span>
-</span><span id="__span-0-2434"><a id="__codelineno-0-2434" name="__codelineno-0-2434"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">update_stmt</span><span class="p">)</span>
-</span><span id="__span-0-2435"><a id="__codelineno-0-2435" name="__codelineno-0-2435"></a>
-</span><span id="__span-0-2436"><a id="__codelineno-0-2436" name="__codelineno-0-2436"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2437"><a id="__codelineno-0-2437" name="__codelineno-0-2437"></a>            <span class="n">delete_stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-2438"><a id="__codelineno-0-2438" name="__codelineno-0-2438"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">delete_stmt</span><span class="p">)</span>
-</span><span id="__span-0-2439"><a id="__codelineno-0-2439" name="__codelineno-0-2439"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2440"><a id="__codelineno-0-2440" name="__codelineno-0-2440"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2402"><a id="__codelineno-0-2402" name="__codelineno-0-2402"></a>
+</span><span id="__span-0-2403"><a id="__codelineno-0-2403" name="__codelineno-0-2403"></a><span class="sd">            Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</span>
+</span><span id="__span-0-2404"><a id="__codelineno-0-2404" name="__codelineno-0-2404"></a>
+</span><span id="__span-0-2405"><a id="__codelineno-0-2405" name="__codelineno-0-2405"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2406"><a id="__codelineno-0-2406" name="__codelineno-0-2406"></a><span class="sd">            await user_crud.delete(</span>
+</span><span id="__span-0-2407"><a id="__codelineno-0-2407" name="__codelineno-0-2407"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2408"><a id="__codelineno-0-2408" name="__codelineno-0-2408"></a><span class="sd">                allow_multiple=True,</span>
+</span><span id="__span-0-2409"><a id="__codelineno-0-2409" name="__codelineno-0-2409"></a><span class="sd">                creation_date__lt=datetime(2020, 1, 1),</span>
+</span><span id="__span-0-2410"><a id="__codelineno-0-2410" name="__codelineno-0-2410"></a><span class="sd">            )</span>
+</span><span id="__span-0-2411"><a id="__codelineno-0-2411" name="__codelineno-0-2411"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2412"><a id="__codelineno-0-2412" name="__codelineno-0-2412"></a>
+</span><span id="__span-0-2413"><a id="__codelineno-0-2413" name="__codelineno-0-2413"></a><span class="sd">            Soft delete a user with a specific email, ensuring only one record is deleted:</span>
+</span><span id="__span-0-2414"><a id="__codelineno-0-2414" name="__codelineno-0-2414"></a>
+</span><span id="__span-0-2415"><a id="__codelineno-0-2415" name="__codelineno-0-2415"></a><span class="sd">            ```python</span>
+</span><span id="__span-0-2416"><a id="__codelineno-0-2416" name="__codelineno-0-2416"></a><span class="sd">            await user_crud.delete(</span>
+</span><span id="__span-0-2417"><a id="__codelineno-0-2417" name="__codelineno-0-2417"></a><span class="sd">                db,</span>
+</span><span id="__span-0-2418"><a id="__codelineno-0-2418" name="__codelineno-0-2418"></a><span class="sd">                allow_multiple=False,</span>
+</span><span id="__span-0-2419"><a id="__codelineno-0-2419" name="__codelineno-0-2419"></a><span class="sd">                email=&#39;unique@example.com&#39;,</span>
+</span><span id="__span-0-2420"><a id="__codelineno-0-2420" name="__codelineno-0-2420"></a><span class="sd">            )</span>
+</span><span id="__span-0-2421"><a id="__codelineno-0-2421" name="__codelineno-0-2421"></a><span class="sd">            ```</span>
+</span><span id="__span-0-2422"><a id="__codelineno-0-2422" name="__codelineno-0-2422"></a><span class="sd">        &quot;&quot;&quot;</span>
+</span><span id="__span-0-2423"><a id="__codelineno-0-2423" name="__codelineno-0-2423"></a>        <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2424"><a id="__codelineno-0-2424" name="__codelineno-0-2424"></a>        <span class="k">if</span> <span class="n">db_row</span><span class="p">:</span>
+</span><span id="__span-0-2425"><a id="__codelineno-0-2425" name="__codelineno-0-2425"></a>            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span>
+</span><span id="__span-0-2426"><a id="__codelineno-0-2426" name="__codelineno-0-2426"></a>                <span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
+</span><span id="__span-0-2427"><a id="__codelineno-0-2427" name="__codelineno-0-2427"></a>            <span class="p">):</span>
+</span><span id="__span-0-2428"><a id="__codelineno-0-2428" name="__codelineno-0-2428"></a>                <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-2429"><a id="__codelineno-0-2429" name="__codelineno-0-2429"></a>                <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">,</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">))</span>
+</span><span id="__span-0-2430"><a id="__codelineno-0-2430" name="__codelineno-0-2430"></a>                <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2431"><a id="__codelineno-0-2431" name="__codelineno-0-2431"></a>                    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2432"><a id="__codelineno-0-2432" name="__codelineno-0-2432"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2433"><a id="__codelineno-0-2433" name="__codelineno-0-2433"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db_row</span><span class="p">)</span>
+</span><span id="__span-0-2434"><a id="__codelineno-0-2434" name="__codelineno-0-2434"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2435"><a id="__codelineno-0-2435" name="__codelineno-0-2435"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2436"><a id="__codelineno-0-2436" name="__codelineno-0-2436"></a>            <span class="k">return</span>
+</span><span id="__span-0-2437"><a id="__codelineno-0-2437" name="__codelineno-0-2437"></a>
+</span><span id="__span-0-2438"><a id="__codelineno-0-2438" name="__codelineno-0-2438"></a>        <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2439"><a id="__codelineno-0-2439" name="__codelineno-0-2439"></a>        <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2440"><a id="__codelineno-0-2440" name="__codelineno-0-2440"></a>            <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to delete.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2441"><a id="__codelineno-0-2441" name="__codelineno-0-2441"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2442"><a id="__codelineno-0-2442" name="__codelineno-0-2442"></a>            <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2443"><a id="__codelineno-0-2443" name="__codelineno-0-2443"></a>                <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2444"><a id="__codelineno-0-2444" name="__codelineno-0-2444"></a>            <span class="p">)</span>
+</span><span id="__span-0-2445"><a id="__codelineno-0-2445" name="__codelineno-0-2445"></a>
+</span><span id="__span-0-2446"><a id="__codelineno-0-2446" name="__codelineno-0-2446"></a>        <span class="n">update_values</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Union</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">datetime</span><span class="p">]]</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-2447"><a id="__codelineno-0-2447" name="__codelineno-0-2447"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
+</span><span id="__span-0-2448"><a id="__codelineno-0-2448" name="__codelineno-0-2448"></a>            <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="__span-0-2449"><a id="__codelineno-0-2449" name="__codelineno-0-2449"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
+</span><span id="__span-0-2450"><a id="__codelineno-0-2450" name="__codelineno-0-2450"></a>            <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="__span-0-2451"><a id="__codelineno-0-2451" name="__codelineno-0-2451"></a>
+</span><span id="__span-0-2452"><a id="__codelineno-0-2452" name="__codelineno-0-2452"></a>        <span class="k">if</span> <span class="n">update_values</span><span class="p">:</span>
+</span><span id="__span-0-2453"><a id="__codelineno-0-2453" name="__codelineno-0-2453"></a>            <span class="n">update_stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="o">**</span><span class="n">update_values</span><span class="p">)</span>
+</span><span id="__span-0-2454"><a id="__codelineno-0-2454" name="__codelineno-0-2454"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">update_stmt</span><span class="p">)</span>
+</span><span id="__span-0-2455"><a id="__codelineno-0-2455" name="__codelineno-0-2455"></a>
+</span><span id="__span-0-2456"><a id="__codelineno-0-2456" name="__codelineno-0-2456"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2457"><a id="__codelineno-0-2457" name="__codelineno-0-2457"></a>            <span class="n">delete_stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-2458"><a id="__codelineno-0-2458" name="__codelineno-0-2458"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">delete_stmt</span><span class="p">)</span>
+</span><span id="__span-0-2459"><a id="__codelineno-0-2459" name="__codelineno-0-2459"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2460"><a id="__codelineno-0-2460" name="__codelineno-0-2460"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
 </span></code></pre></div></td></tr></table></div>
             </details>
 
@@ -7231,17 +7325,7 @@ <h2 id="fastcrud.FastCRUD.count" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1012">1012</a></span>
-<span class="normal"><a href="#__codelineno-0-1013">1013</a></span>
-<span class="normal"><a href="#__codelineno-0-1014">1014</a></span>
-<span class="normal"><a href="#__codelineno-0-1015">1015</a></span>
-<span class="normal"><a href="#__codelineno-0-1016">1016</a></span>
-<span class="normal"><a href="#__codelineno-0-1017">1017</a></span>
-<span class="normal"><a href="#__codelineno-0-1018">1018</a></span>
-<span class="normal"><a href="#__codelineno-0-1019">1019</a></span>
-<span class="normal"><a href="#__codelineno-0-1020">1020</a></span>
-<span class="normal"><a href="#__codelineno-0-1021">1021</a></span>
-<span class="normal"><a href="#__codelineno-0-1022">1022</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1022">1022</a></span>
 <span class="normal"><a href="#__codelineno-0-1023">1023</a></span>
 <span class="normal"><a href="#__codelineno-0-1024">1024</a></span>
 <span class="normal"><a href="#__codelineno-0-1025">1025</a></span>
@@ -7349,125 +7433,135 @@ <h2 id="fastcrud.FastCRUD.count" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-1127">1127</a></span>
 <span class="normal"><a href="#__codelineno-0-1128">1128</a></span>
 <span class="normal"><a href="#__codelineno-0-1129">1129</a></span>
-<span class="normal"><a href="#__codelineno-0-1130">1130</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1012"><a id="__codelineno-0-1012" name="__codelineno-0-1012"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">count</span><span class="p">(</span>
-</span><span id="__span-0-1013"><a id="__codelineno-0-1013" name="__codelineno-0-1013"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1014"><a id="__codelineno-0-1014" name="__codelineno-0-1014"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1015"><a id="__codelineno-0-1015" name="__codelineno-0-1015"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1016"><a id="__codelineno-0-1016" name="__codelineno-0-1016"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1017"><a id="__codelineno-0-1017" name="__codelineno-0-1017"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
-</span><span id="__span-0-1018"><a id="__codelineno-0-1018" name="__codelineno-0-1018"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1019"><a id="__codelineno-0-1019" name="__codelineno-0-1019"></a><span class="sd">    Counts records that match specified filters.</span>
-</span><span id="__span-0-1020"><a id="__codelineno-0-1020" name="__codelineno-0-1020"></a>
-</span><span id="__span-0-1021"><a id="__codelineno-0-1021" name="__codelineno-0-1021"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1022"><a id="__codelineno-0-1022" name="__codelineno-0-1022"></a>
-</span><span id="__span-0-1023"><a id="__codelineno-0-1023" name="__codelineno-0-1023"></a><span class="sd">    Can also count records based on a configuration of joins, useful for complex queries involving relationships.</span>
-</span><span id="__span-0-1024"><a id="__codelineno-0-1024" name="__codelineno-0-1024"></a>
-</span><span id="__span-0-1025"><a id="__codelineno-0-1025" name="__codelineno-0-1025"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-1026"><a id="__codelineno-0-1026" name="__codelineno-0-1026"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-1027"><a id="__codelineno-0-1027" name="__codelineno-0-1027"></a><span class="sd">        joins_config: Optional configuration for applying joins in the count query.</span>
-</span><span id="__span-0-1028"><a id="__codelineno-0-1028" name="__codelineno-0-1028"></a><span class="sd">        **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</span>
-</span><span id="__span-0-1029"><a id="__codelineno-0-1029" name="__codelineno-0-1029"></a>
-</span><span id="__span-0-1030"><a id="__codelineno-0-1030" name="__codelineno-0-1030"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-1031"><a id="__codelineno-0-1031" name="__codelineno-0-1031"></a><span class="sd">        The total number of records matching the filter conditions.</span>
+<span class="normal"><a href="#__codelineno-0-1130">1130</a></span>
+<span class="normal"><a href="#__codelineno-0-1131">1131</a></span>
+<span class="normal"><a href="#__codelineno-0-1132">1132</a></span>
+<span class="normal"><a href="#__codelineno-0-1133">1133</a></span>
+<span class="normal"><a href="#__codelineno-0-1134">1134</a></span>
+<span class="normal"><a href="#__codelineno-0-1135">1135</a></span>
+<span class="normal"><a href="#__codelineno-0-1136">1136</a></span>
+<span class="normal"><a href="#__codelineno-0-1137">1137</a></span>
+<span class="normal"><a href="#__codelineno-0-1138">1138</a></span>
+<span class="normal"><a href="#__codelineno-0-1139">1139</a></span>
+<span class="normal"><a href="#__codelineno-0-1140">1140</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1022"><a id="__codelineno-0-1022" name="__codelineno-0-1022"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">count</span><span class="p">(</span>
+</span><span id="__span-0-1023"><a id="__codelineno-0-1023" name="__codelineno-0-1023"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1024"><a id="__codelineno-0-1024" name="__codelineno-0-1024"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1025"><a id="__codelineno-0-1025" name="__codelineno-0-1025"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1026"><a id="__codelineno-0-1026" name="__codelineno-0-1026"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1027"><a id="__codelineno-0-1027" name="__codelineno-0-1027"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">int</span><span class="p">:</span>
+</span><span id="__span-0-1028"><a id="__codelineno-0-1028" name="__codelineno-0-1028"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1029"><a id="__codelineno-0-1029" name="__codelineno-0-1029"></a><span class="sd">    Counts records that match specified filters.</span>
+</span><span id="__span-0-1030"><a id="__codelineno-0-1030" name="__codelineno-0-1030"></a>
+</span><span id="__span-0-1031"><a id="__codelineno-0-1031" name="__codelineno-0-1031"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-1032"><a id="__codelineno-0-1032" name="__codelineno-0-1032"></a>
-</span><span id="__span-0-1033"><a id="__codelineno-0-1033" name="__codelineno-0-1033"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-1034"><a id="__codelineno-0-1034" name="__codelineno-0-1034"></a><span class="sd">        Count users by ID:</span>
-</span><span id="__span-0-1035"><a id="__codelineno-0-1035" name="__codelineno-0-1035"></a>
-</span><span id="__span-0-1036"><a id="__codelineno-0-1036" name="__codelineno-0-1036"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1037"><a id="__codelineno-0-1037" name="__codelineno-0-1037"></a><span class="sd">        count = await user_crud.count(db, id=1)</span>
-</span><span id="__span-0-1038"><a id="__codelineno-0-1038" name="__codelineno-0-1038"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1033"><a id="__codelineno-0-1033" name="__codelineno-0-1033"></a><span class="sd">    Can also count records based on a configuration of joins, useful for complex queries involving relationships.</span>
+</span><span id="__span-0-1034"><a id="__codelineno-0-1034" name="__codelineno-0-1034"></a>
+</span><span id="__span-0-1035"><a id="__codelineno-0-1035" name="__codelineno-0-1035"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-1036"><a id="__codelineno-0-1036" name="__codelineno-0-1036"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-1037"><a id="__codelineno-0-1037" name="__codelineno-0-1037"></a><span class="sd">        joins_config: Optional configuration for applying joins in the count query.</span>
+</span><span id="__span-0-1038"><a id="__codelineno-0-1038" name="__codelineno-0-1038"></a><span class="sd">        **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</span>
 </span><span id="__span-0-1039"><a id="__codelineno-0-1039" name="__codelineno-0-1039"></a>
-</span><span id="__span-0-1040"><a id="__codelineno-0-1040" name="__codelineno-0-1040"></a><span class="sd">        Count users older than 30:</span>
-</span><span id="__span-0-1041"><a id="__codelineno-0-1041" name="__codelineno-0-1041"></a>
-</span><span id="__span-0-1042"><a id="__codelineno-0-1042" name="__codelineno-0-1042"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1043"><a id="__codelineno-0-1043" name="__codelineno-0-1043"></a><span class="sd">        count = await user_crud.count(db, age__gt=30)</span>
-</span><span id="__span-0-1044"><a id="__codelineno-0-1044" name="__codelineno-0-1044"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1040"><a id="__codelineno-0-1040" name="__codelineno-0-1040"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-1041"><a id="__codelineno-0-1041" name="__codelineno-0-1041"></a><span class="sd">        The total number of records matching the filter conditions.</span>
+</span><span id="__span-0-1042"><a id="__codelineno-0-1042" name="__codelineno-0-1042"></a>
+</span><span id="__span-0-1043"><a id="__codelineno-0-1043" name="__codelineno-0-1043"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-1044"><a id="__codelineno-0-1044" name="__codelineno-0-1044"></a><span class="sd">        Count users by ID:</span>
 </span><span id="__span-0-1045"><a id="__codelineno-0-1045" name="__codelineno-0-1045"></a>
-</span><span id="__span-0-1046"><a id="__codelineno-0-1046" name="__codelineno-0-1046"></a><span class="sd">        Count users with a username other than `admin`:</span>
-</span><span id="__span-0-1047"><a id="__codelineno-0-1047" name="__codelineno-0-1047"></a>
-</span><span id="__span-0-1048"><a id="__codelineno-0-1048" name="__codelineno-0-1048"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1049"><a id="__codelineno-0-1049" name="__codelineno-0-1049"></a><span class="sd">        count = await user_crud.count(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-1050"><a id="__codelineno-0-1050" name="__codelineno-0-1050"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1046"><a id="__codelineno-0-1046" name="__codelineno-0-1046"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1047"><a id="__codelineno-0-1047" name="__codelineno-0-1047"></a><span class="sd">        count = await user_crud.count(db, id=1)</span>
+</span><span id="__span-0-1048"><a id="__codelineno-0-1048" name="__codelineno-0-1048"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1049"><a id="__codelineno-0-1049" name="__codelineno-0-1049"></a>
+</span><span id="__span-0-1050"><a id="__codelineno-0-1050" name="__codelineno-0-1050"></a><span class="sd">        Count users older than 30:</span>
 </span><span id="__span-0-1051"><a id="__codelineno-0-1051" name="__codelineno-0-1051"></a>
-</span><span id="__span-0-1052"><a id="__codelineno-0-1052" name="__codelineno-0-1052"></a><span class="sd">        Count projects with at least one participant (many-to-many relationship):</span>
-</span><span id="__span-0-1053"><a id="__codelineno-0-1053" name="__codelineno-0-1053"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1054"><a id="__codelineno-0-1054" name="__codelineno-0-1054"></a><span class="sd">        joins_config = [</span>
-</span><span id="__span-0-1055"><a id="__codelineno-0-1055" name="__codelineno-0-1055"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1056"><a id="__codelineno-0-1056" name="__codelineno-0-1056"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1057"><a id="__codelineno-0-1057" name="__codelineno-0-1057"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1058"><a id="__codelineno-0-1058" name="__codelineno-0-1058"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1059"><a id="__codelineno-0-1059" name="__codelineno-0-1059"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1060"><a id="__codelineno-0-1060" name="__codelineno-0-1060"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1061"><a id="__codelineno-0-1061" name="__codelineno-0-1061"></a><span class="sd">                model=Participant,</span>
-</span><span id="__span-0-1062"><a id="__codelineno-0-1062" name="__codelineno-0-1062"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1063"><a id="__codelineno-0-1063" name="__codelineno-0-1063"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1064"><a id="__codelineno-0-1064" name="__codelineno-0-1064"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1065"><a id="__codelineno-0-1065" name="__codelineno-0-1065"></a><span class="sd">        ]</span>
-</span><span id="__span-0-1066"><a id="__codelineno-0-1066" name="__codelineno-0-1066"></a><span class="sd">        count = await crud.count(db, joins_config=joins_config)</span>
-</span><span id="__span-0-1067"><a id="__codelineno-0-1067" name="__codelineno-0-1067"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1068"><a id="__codelineno-0-1068" name="__codelineno-0-1068"></a>
-</span><span id="__span-0-1069"><a id="__codelineno-0-1069" name="__codelineno-0-1069"></a><span class="sd">        Count projects by a specific participant name (filter applied on a joined model):</span>
-</span><span id="__span-0-1070"><a id="__codelineno-0-1070" name="__codelineno-0-1070"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1071"><a id="__codelineno-0-1071" name="__codelineno-0-1071"></a><span class="sd">        joins_config = [</span>
-</span><span id="__span-0-1072"><a id="__codelineno-0-1072" name="__codelineno-0-1072"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1073"><a id="__codelineno-0-1073" name="__codelineno-0-1073"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1074"><a id="__codelineno-0-1074" name="__codelineno-0-1074"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1075"><a id="__codelineno-0-1075" name="__codelineno-0-1075"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1076"><a id="__codelineno-0-1076" name="__codelineno-0-1076"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1077"><a id="__codelineno-0-1077" name="__codelineno-0-1077"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1078"><a id="__codelineno-0-1078" name="__codelineno-0-1078"></a><span class="sd">                model=Participant,</span>
-</span><span id="__span-0-1079"><a id="__codelineno-0-1079" name="__codelineno-0-1079"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1080"><a id="__codelineno-0-1080" name="__codelineno-0-1080"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1081"><a id="__codelineno-0-1081" name="__codelineno-0-1081"></a><span class="sd">                filters={&#39;name&#39;: &#39;Jane Doe&#39;},</span>
-</span><span id="__span-0-1082"><a id="__codelineno-0-1082" name="__codelineno-0-1082"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1083"><a id="__codelineno-0-1083" name="__codelineno-0-1083"></a><span class="sd">        ]</span>
-</span><span id="__span-0-1084"><a id="__codelineno-0-1084" name="__codelineno-0-1084"></a><span class="sd">        count = await crud.count(db, joins_config=joins_config)</span>
-</span><span id="__span-0-1085"><a id="__codelineno-0-1085" name="__codelineno-0-1085"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1086"><a id="__codelineno-0-1086" name="__codelineno-0-1086"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-1087"><a id="__codelineno-0-1087" name="__codelineno-0-1087"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1088"><a id="__codelineno-0-1088" name="__codelineno-0-1088"></a>
-</span><span id="__span-0-1089"><a id="__codelineno-0-1089" name="__codelineno-0-1089"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1090"><a id="__codelineno-0-1090" name="__codelineno-0-1090"></a>        <span class="n">primary_keys</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)]</span>
-</span><span id="__span-0-1091"><a id="__codelineno-0-1091" name="__codelineno-0-1091"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">primary_keys</span><span class="p">):</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-1092"><a id="__codelineno-0-1092" name="__codelineno-0-1092"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1093"><a id="__codelineno-0-1093" name="__codelineno-0-1093"></a>                <span class="sa">f</span><span class="s2">&quot;The model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; does not have a primary key defined, which is required for counting with joins.&quot;</span>
-</span><span id="__span-0-1094"><a id="__codelineno-0-1094" name="__codelineno-0-1094"></a>            <span class="p">)</span>
-</span><span id="__span-0-1095"><a id="__codelineno-0-1095" name="__codelineno-0-1095"></a>        <span class="n">to_select</span> <span class="o">=</span> <span class="p">[</span>
-</span><span id="__span-0-1096"><a id="__codelineno-0-1096" name="__codelineno-0-1096"></a>            <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">pk</span><span class="p">)</span><span class="o">.</span><span class="n">label</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;distinct_</span><span class="si">{</span><span class="n">pk</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="n">primary_keys</span>
-</span><span id="__span-0-1097"><a id="__codelineno-0-1097" name="__codelineno-0-1097"></a>        <span class="p">]</span>
-</span><span id="__span-0-1098"><a id="__codelineno-0-1098" name="__codelineno-0-1098"></a>        <span class="n">base_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span>
-</span><span id="__span-0-1099"><a id="__codelineno-0-1099" name="__codelineno-0-1099"></a>
-</span><span id="__span-0-1100"><a id="__codelineno-0-1100" name="__codelineno-0-1100"></a>        <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
-</span><span id="__span-0-1101"><a id="__codelineno-0-1101" name="__codelineno-0-1101"></a>            <span class="n">join_model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
-</span><span id="__span-0-1102"><a id="__codelineno-0-1102" name="__codelineno-0-1102"></a>            <span class="n">join_filters</span> <span class="o">=</span> <span class="p">(</span>
-</span><span id="__span-0-1103"><a id="__codelineno-0-1103" name="__codelineno-0-1103"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span> <span class="o">**</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-1104"><a id="__codelineno-0-1104" name="__codelineno-0-1104"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">filters</span>
-</span><span id="__span-0-1105"><a id="__codelineno-0-1105" name="__codelineno-0-1105"></a>                <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1106"><a id="__codelineno-0-1106" name="__codelineno-0-1106"></a>            <span class="p">)</span>
-</span><span id="__span-0-1107"><a id="__codelineno-0-1107" name="__codelineno-0-1107"></a>
-</span><span id="__span-0-1108"><a id="__codelineno-0-1108" name="__codelineno-0-1108"></a>            <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
-</span><span id="__span-0-1109"><a id="__codelineno-0-1109" name="__codelineno-0-1109"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
-</span><span id="__span-0-1110"><a id="__codelineno-0-1110" name="__codelineno-0-1110"></a>            <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1111"><a id="__codelineno-0-1111" name="__codelineno-0-1111"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
-</span><span id="__span-0-1112"><a id="__codelineno-0-1112" name="__codelineno-0-1112"></a>
-</span><span id="__span-0-1113"><a id="__codelineno-0-1113" name="__codelineno-0-1113"></a>            <span class="k">if</span> <span class="n">join_filters</span><span class="p">:</span>
-</span><span id="__span-0-1114"><a id="__codelineno-0-1114" name="__codelineno-0-1114"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">join_filters</span><span class="p">)</span>
-</span><span id="__span-0-1115"><a id="__codelineno-0-1115" name="__codelineno-0-1115"></a>
-</span><span id="__span-0-1116"><a id="__codelineno-0-1116" name="__codelineno-0-1116"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1117"><a id="__codelineno-0-1117" name="__codelineno-0-1117"></a>            <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1118"><a id="__codelineno-0-1118" name="__codelineno-0-1118"></a>
-</span><span id="__span-0-1119"><a id="__codelineno-0-1119" name="__codelineno-0-1119"></a>        <span class="n">subquery</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">subquery</span><span class="p">()</span>
-</span><span id="__span-0-1120"><a id="__codelineno-0-1120" name="__codelineno-0-1120"></a>        <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="n">subquery</span><span class="p">)</span>
-</span><span id="__span-0-1121"><a id="__codelineno-0-1121" name="__codelineno-0-1121"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1122"><a id="__codelineno-0-1122" name="__codelineno-0-1122"></a>        <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-1123"><a id="__codelineno-0-1123" name="__codelineno-0-1123"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1124"><a id="__codelineno-0-1124" name="__codelineno-0-1124"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">count_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1052"><a id="__codelineno-0-1052" name="__codelineno-0-1052"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1053"><a id="__codelineno-0-1053" name="__codelineno-0-1053"></a><span class="sd">        count = await user_crud.count(db, age__gt=30)</span>
+</span><span id="__span-0-1054"><a id="__codelineno-0-1054" name="__codelineno-0-1054"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1055"><a id="__codelineno-0-1055" name="__codelineno-0-1055"></a>
+</span><span id="__span-0-1056"><a id="__codelineno-0-1056" name="__codelineno-0-1056"></a><span class="sd">        Count users with a username other than `admin`:</span>
+</span><span id="__span-0-1057"><a id="__codelineno-0-1057" name="__codelineno-0-1057"></a>
+</span><span id="__span-0-1058"><a id="__codelineno-0-1058" name="__codelineno-0-1058"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1059"><a id="__codelineno-0-1059" name="__codelineno-0-1059"></a><span class="sd">        count = await user_crud.count(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-1060"><a id="__codelineno-0-1060" name="__codelineno-0-1060"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1061"><a id="__codelineno-0-1061" name="__codelineno-0-1061"></a>
+</span><span id="__span-0-1062"><a id="__codelineno-0-1062" name="__codelineno-0-1062"></a><span class="sd">        Count projects with at least one participant (many-to-many relationship):</span>
+</span><span id="__span-0-1063"><a id="__codelineno-0-1063" name="__codelineno-0-1063"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1064"><a id="__codelineno-0-1064" name="__codelineno-0-1064"></a><span class="sd">        joins_config = [</span>
+</span><span id="__span-0-1065"><a id="__codelineno-0-1065" name="__codelineno-0-1065"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1066"><a id="__codelineno-0-1066" name="__codelineno-0-1066"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1067"><a id="__codelineno-0-1067" name="__codelineno-0-1067"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1068"><a id="__codelineno-0-1068" name="__codelineno-0-1068"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1069"><a id="__codelineno-0-1069" name="__codelineno-0-1069"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1070"><a id="__codelineno-0-1070" name="__codelineno-0-1070"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1071"><a id="__codelineno-0-1071" name="__codelineno-0-1071"></a><span class="sd">                model=Participant,</span>
+</span><span id="__span-0-1072"><a id="__codelineno-0-1072" name="__codelineno-0-1072"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1073"><a id="__codelineno-0-1073" name="__codelineno-0-1073"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1074"><a id="__codelineno-0-1074" name="__codelineno-0-1074"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1075"><a id="__codelineno-0-1075" name="__codelineno-0-1075"></a><span class="sd">        ]</span>
+</span><span id="__span-0-1076"><a id="__codelineno-0-1076" name="__codelineno-0-1076"></a><span class="sd">        count = await crud.count(db, joins_config=joins_config)</span>
+</span><span id="__span-0-1077"><a id="__codelineno-0-1077" name="__codelineno-0-1077"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1078"><a id="__codelineno-0-1078" name="__codelineno-0-1078"></a>
+</span><span id="__span-0-1079"><a id="__codelineno-0-1079" name="__codelineno-0-1079"></a><span class="sd">        Count projects by a specific participant name (filter applied on a joined model):</span>
+</span><span id="__span-0-1080"><a id="__codelineno-0-1080" name="__codelineno-0-1080"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1081"><a id="__codelineno-0-1081" name="__codelineno-0-1081"></a><span class="sd">        joins_config = [</span>
+</span><span id="__span-0-1082"><a id="__codelineno-0-1082" name="__codelineno-0-1082"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1083"><a id="__codelineno-0-1083" name="__codelineno-0-1083"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1084"><a id="__codelineno-0-1084" name="__codelineno-0-1084"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1085"><a id="__codelineno-0-1085" name="__codelineno-0-1085"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1086"><a id="__codelineno-0-1086" name="__codelineno-0-1086"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1087"><a id="__codelineno-0-1087" name="__codelineno-0-1087"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1088"><a id="__codelineno-0-1088" name="__codelineno-0-1088"></a><span class="sd">                model=Participant,</span>
+</span><span id="__span-0-1089"><a id="__codelineno-0-1089" name="__codelineno-0-1089"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1090"><a id="__codelineno-0-1090" name="__codelineno-0-1090"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1091"><a id="__codelineno-0-1091" name="__codelineno-0-1091"></a><span class="sd">                filters={&#39;name&#39;: &#39;Jane Doe&#39;},</span>
+</span><span id="__span-0-1092"><a id="__codelineno-0-1092" name="__codelineno-0-1092"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1093"><a id="__codelineno-0-1093" name="__codelineno-0-1093"></a><span class="sd">        ]</span>
+</span><span id="__span-0-1094"><a id="__codelineno-0-1094" name="__codelineno-0-1094"></a><span class="sd">        count = await crud.count(db, joins_config=joins_config)</span>
+</span><span id="__span-0-1095"><a id="__codelineno-0-1095" name="__codelineno-0-1095"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1096"><a id="__codelineno-0-1096" name="__codelineno-0-1096"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-1097"><a id="__codelineno-0-1097" name="__codelineno-0-1097"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1098"><a id="__codelineno-0-1098" name="__codelineno-0-1098"></a>
+</span><span id="__span-0-1099"><a id="__codelineno-0-1099" name="__codelineno-0-1099"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1100"><a id="__codelineno-0-1100" name="__codelineno-0-1100"></a>        <span class="n">primary_keys</span> <span class="o">=</span> <span class="p">[</span><span class="n">p</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">p</span> <span class="ow">in</span> <span class="n">_get_primary_keys</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)]</span>
+</span><span id="__span-0-1101"><a id="__codelineno-0-1101" name="__codelineno-0-1101"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="nb">any</span><span class="p">(</span><span class="n">primary_keys</span><span class="p">):</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1102"><a id="__codelineno-0-1102" name="__codelineno-0-1102"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1103"><a id="__codelineno-0-1103" name="__codelineno-0-1103"></a>                <span class="sa">f</span><span class="s2">&quot;The model &#39;</span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">&#39; does not have a primary key defined, which is required for counting with joins.&quot;</span>
+</span><span id="__span-0-1104"><a id="__codelineno-0-1104" name="__codelineno-0-1104"></a>            <span class="p">)</span>
+</span><span id="__span-0-1105"><a id="__codelineno-0-1105" name="__codelineno-0-1105"></a>        <span class="n">to_select</span> <span class="o">=</span> <span class="p">[</span>
+</span><span id="__span-0-1106"><a id="__codelineno-0-1106" name="__codelineno-0-1106"></a>            <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">pk</span><span class="p">)</span><span class="o">.</span><span class="n">label</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;distinct_</span><span class="si">{</span><span class="n">pk</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">pk</span> <span class="ow">in</span> <span class="n">primary_keys</span>
+</span><span id="__span-0-1107"><a id="__codelineno-0-1107" name="__codelineno-0-1107"></a>        <span class="p">]</span>
+</span><span id="__span-0-1108"><a id="__codelineno-0-1108" name="__codelineno-0-1108"></a>        <span class="n">base_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span>
+</span><span id="__span-0-1109"><a id="__codelineno-0-1109" name="__codelineno-0-1109"></a>
+</span><span id="__span-0-1110"><a id="__codelineno-0-1110" name="__codelineno-0-1110"></a>        <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">joins_config</span><span class="p">:</span>
+</span><span id="__span-0-1111"><a id="__codelineno-0-1111" name="__codelineno-0-1111"></a>            <span class="n">join_model</span> <span class="o">=</span> <span class="n">join</span><span class="o">.</span><span class="n">alias</span> <span class="ow">or</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span>
+</span><span id="__span-0-1112"><a id="__codelineno-0-1112" name="__codelineno-0-1112"></a>            <span class="n">join_filters</span> <span class="o">=</span> <span class="p">(</span>
+</span><span id="__span-0-1113"><a id="__codelineno-0-1113" name="__codelineno-0-1113"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span> <span class="o">**</span><span class="n">join</span><span class="o">.</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-1114"><a id="__codelineno-0-1114" name="__codelineno-0-1114"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">filters</span>
+</span><span id="__span-0-1115"><a id="__codelineno-0-1115" name="__codelineno-0-1115"></a>                <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1116"><a id="__codelineno-0-1116" name="__codelineno-0-1116"></a>            <span class="p">)</span>
+</span><span id="__span-0-1117"><a id="__codelineno-0-1117" name="__codelineno-0-1117"></a>
+</span><span id="__span-0-1118"><a id="__codelineno-0-1118" name="__codelineno-0-1118"></a>            <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_type</span> <span class="o">==</span> <span class="s2">&quot;inner&quot;</span><span class="p">:</span>
+</span><span id="__span-0-1119"><a id="__codelineno-0-1119" name="__codelineno-0-1119"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
+</span><span id="__span-0-1120"><a id="__codelineno-0-1120" name="__codelineno-0-1120"></a>            <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1121"><a id="__codelineno-0-1121" name="__codelineno-0-1121"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">outerjoin</span><span class="p">(</span><span class="n">join_model</span><span class="p">,</span> <span class="n">join</span><span class="o">.</span><span class="n">join_on</span><span class="p">)</span>
+</span><span id="__span-0-1122"><a id="__codelineno-0-1122" name="__codelineno-0-1122"></a>
+</span><span id="__span-0-1123"><a id="__codelineno-0-1123" name="__codelineno-0-1123"></a>            <span class="k">if</span> <span class="n">join_filters</span><span class="p">:</span>
+</span><span id="__span-0-1124"><a id="__codelineno-0-1124" name="__codelineno-0-1124"></a>                <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">join_filters</span><span class="p">)</span>
 </span><span id="__span-0-1125"><a id="__codelineno-0-1125" name="__codelineno-0-1125"></a>
-</span><span id="__span-0-1126"><a id="__codelineno-0-1126" name="__codelineno-0-1126"></a>    <span class="n">total_count</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">scalar</span><span class="p">(</span><span class="n">count_query</span><span class="p">)</span>
-</span><span id="__span-0-1127"><a id="__codelineno-0-1127" name="__codelineno-0-1127"></a>    <span class="k">if</span> <span class="n">total_count</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1128"><a id="__codelineno-0-1128" name="__codelineno-0-1128"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Could not find the count.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1129"><a id="__codelineno-0-1129" name="__codelineno-0-1129"></a>
-</span><span id="__span-0-1130"><a id="__codelineno-0-1130" name="__codelineno-0-1130"></a>    <span class="k">return</span> <span class="n">total_count</span>
+</span><span id="__span-0-1126"><a id="__codelineno-0-1126" name="__codelineno-0-1126"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1127"><a id="__codelineno-0-1127" name="__codelineno-0-1127"></a>            <span class="n">base_query</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1128"><a id="__codelineno-0-1128" name="__codelineno-0-1128"></a>
+</span><span id="__span-0-1129"><a id="__codelineno-0-1129" name="__codelineno-0-1129"></a>        <span class="n">subquery</span> <span class="o">=</span> <span class="n">base_query</span><span class="o">.</span><span class="n">subquery</span><span class="p">()</span>
+</span><span id="__span-0-1130"><a id="__codelineno-0-1130" name="__codelineno-0-1130"></a>        <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="n">subquery</span><span class="p">)</span>
+</span><span id="__span-0-1131"><a id="__codelineno-0-1131" name="__codelineno-0-1131"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1132"><a id="__codelineno-0-1132" name="__codelineno-0-1132"></a>        <span class="n">count_query</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="n">func</span><span class="o">.</span><span class="n">count</span><span class="p">())</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-1133"><a id="__codelineno-0-1133" name="__codelineno-0-1133"></a>        <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1134"><a id="__codelineno-0-1134" name="__codelineno-0-1134"></a>            <span class="n">count_query</span> <span class="o">=</span> <span class="n">count_query</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1135"><a id="__codelineno-0-1135" name="__codelineno-0-1135"></a>
+</span><span id="__span-0-1136"><a id="__codelineno-0-1136" name="__codelineno-0-1136"></a>    <span class="n">total_count</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">scalar</span><span class="p">(</span><span class="n">count_query</span><span class="p">)</span>
+</span><span id="__span-0-1137"><a id="__codelineno-0-1137" name="__codelineno-0-1137"></a>    <span class="k">if</span> <span class="n">total_count</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1138"><a id="__codelineno-0-1138" name="__codelineno-0-1138"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Could not find the count.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1139"><a id="__codelineno-0-1139" name="__codelineno-0-1139"></a>
+</span><span id="__span-0-1140"><a id="__codelineno-0-1140" name="__codelineno-0-1140"></a>    <span class="k">return</span> <span class="n">total_count</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -7577,11 +7671,7 @@ <h2 id="fastcrud.FastCRUD.create" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-629">629</a></span>
-<span class="normal"><a href="#__codelineno-0-630">630</a></span>
-<span class="normal"><a href="#__codelineno-0-631">631</a></span>
-<span class="normal"><a href="#__codelineno-0-632">632</a></span>
-<span class="normal"><a href="#__codelineno-0-633">633</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-633">633</a></span>
 <span class="normal"><a href="#__codelineno-0-634">634</a></span>
 <span class="normal"><a href="#__codelineno-0-635">635</a></span>
 <span class="normal"><a href="#__codelineno-0-636">636</a></span>
@@ -7596,26 +7686,30 @@ <h2 id="fastcrud.FastCRUD.create" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-645">645</a></span>
 <span class="normal"><a href="#__codelineno-0-646">646</a></span>
 <span class="normal"><a href="#__codelineno-0-647">647</a></span>
-<span class="normal"><a href="#__codelineno-0-648">648</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-629"><a id="__codelineno-0-629" name="__codelineno-0-629"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">create</span><span class="p">(</span>
-</span><span id="__span-0-630"><a id="__codelineno-0-630" name="__codelineno-0-630"></a>    <span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="nb">object</span><span class="p">:</span> <span class="n">CreateSchemaType</span><span class="p">,</span> <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="__span-0-631"><a id="__codelineno-0-631" name="__codelineno-0-631"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ModelType</span><span class="p">:</span>
-</span><span id="__span-0-632"><a id="__codelineno-0-632" name="__codelineno-0-632"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a><span class="sd">    Create a new record in the database.</span>
-</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>
-</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="sd">        db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">        object: The Pydantic schema containing the data to be saved.</span>
-</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a>
-</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">        The created database object.</span>
-</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>    <span class="n">object_dict</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">()</span>
-</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a>    <span class="n">db_object</span><span class="p">:</span> <span class="n">ModelType</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">object_dict</span><span class="p">)</span>
-</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a>    <span class="n">db</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">db_object</span><span class="p">)</span>
-</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>    <span class="k">return</span> <span class="n">db_object</span>
+<span class="normal"><a href="#__codelineno-0-648">648</a></span>
+<span class="normal"><a href="#__codelineno-0-649">649</a></span>
+<span class="normal"><a href="#__codelineno-0-650">650</a></span>
+<span class="normal"><a href="#__codelineno-0-651">651</a></span>
+<span class="normal"><a href="#__codelineno-0-652">652</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-633"><a id="__codelineno-0-633" name="__codelineno-0-633"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">create</span><span class="p">(</span>
+</span><span id="__span-0-634"><a id="__codelineno-0-634" name="__codelineno-0-634"></a>    <span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="nb">object</span><span class="p">:</span> <span class="n">CreateSchemaType</span><span class="p">,</span> <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="__span-0-635"><a id="__codelineno-0-635" name="__codelineno-0-635"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ModelType</span><span class="p">:</span>
+</span><span id="__span-0-636"><a id="__codelineno-0-636" name="__codelineno-0-636"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-637"><a id="__codelineno-0-637" name="__codelineno-0-637"></a><span class="sd">    Create a new record in the database.</span>
+</span><span id="__span-0-638"><a id="__codelineno-0-638" name="__codelineno-0-638"></a>
+</span><span id="__span-0-639"><a id="__codelineno-0-639" name="__codelineno-0-639"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-640"><a id="__codelineno-0-640" name="__codelineno-0-640"></a><span class="sd">        db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-641"><a id="__codelineno-0-641" name="__codelineno-0-641"></a><span class="sd">        object: The Pydantic schema containing the data to be saved.</span>
+</span><span id="__span-0-642"><a id="__codelineno-0-642" name="__codelineno-0-642"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-643"><a id="__codelineno-0-643" name="__codelineno-0-643"></a>
+</span><span id="__span-0-644"><a id="__codelineno-0-644" name="__codelineno-0-644"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-645"><a id="__codelineno-0-645" name="__codelineno-0-645"></a><span class="sd">        The created database object.</span>
+</span><span id="__span-0-646"><a id="__codelineno-0-646" name="__codelineno-0-646"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-647"><a id="__codelineno-0-647" name="__codelineno-0-647"></a>    <span class="n">object_dict</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">()</span>
+</span><span id="__span-0-648"><a id="__codelineno-0-648" name="__codelineno-0-648"></a>    <span class="n">db_object</span><span class="p">:</span> <span class="n">ModelType</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">(</span><span class="o">**</span><span class="n">object_dict</span><span class="p">)</span>
+</span><span id="__span-0-649"><a id="__codelineno-0-649" name="__codelineno-0-649"></a>    <span class="n">db</span><span class="o">.</span><span class="n">add</span><span class="p">(</span><span class="n">db_object</span><span class="p">)</span>
+</span><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>    <span class="k">return</span> <span class="n">db_object</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -7785,27 +7879,7 @@ <h2 id="fastcrud.FastCRUD.db_delete" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2287">2287</a></span>
-<span class="normal"><a href="#__codelineno-0-2288">2288</a></span>
-<span class="normal"><a href="#__codelineno-0-2289">2289</a></span>
-<span class="normal"><a href="#__codelineno-0-2290">2290</a></span>
-<span class="normal"><a href="#__codelineno-0-2291">2291</a></span>
-<span class="normal"><a href="#__codelineno-0-2292">2292</a></span>
-<span class="normal"><a href="#__codelineno-0-2293">2293</a></span>
-<span class="normal"><a href="#__codelineno-0-2294">2294</a></span>
-<span class="normal"><a href="#__codelineno-0-2295">2295</a></span>
-<span class="normal"><a href="#__codelineno-0-2296">2296</a></span>
-<span class="normal"><a href="#__codelineno-0-2297">2297</a></span>
-<span class="normal"><a href="#__codelineno-0-2298">2298</a></span>
-<span class="normal"><a href="#__codelineno-0-2299">2299</a></span>
-<span class="normal"><a href="#__codelineno-0-2300">2300</a></span>
-<span class="normal"><a href="#__codelineno-0-2301">2301</a></span>
-<span class="normal"><a href="#__codelineno-0-2302">2302</a></span>
-<span class="normal"><a href="#__codelineno-0-2303">2303</a></span>
-<span class="normal"><a href="#__codelineno-0-2304">2304</a></span>
-<span class="normal"><a href="#__codelineno-0-2305">2305</a></span>
-<span class="normal"><a href="#__codelineno-0-2306">2306</a></span>
-<span class="normal"><a href="#__codelineno-0-2307">2307</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2307">2307</a></span>
 <span class="normal"><a href="#__codelineno-0-2308">2308</a></span>
 <span class="normal"><a href="#__codelineno-0-2309">2309</a></span>
 <span class="normal"><a href="#__codelineno-0-2310">2310</a></span>
@@ -7845,67 +7919,87 @@ <h2 id="fastcrud.FastCRUD.db_delete" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-2344">2344</a></span>
 <span class="normal"><a href="#__codelineno-0-2345">2345</a></span>
 <span class="normal"><a href="#__codelineno-0-2346">2346</a></span>
-<span class="normal"><a href="#__codelineno-0-2347">2347</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2287"><a id="__codelineno-0-2287" name="__codelineno-0-2287"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">db_delete</span><span class="p">(</span>
-</span><span id="__span-0-2288"><a id="__codelineno-0-2288" name="__codelineno-0-2288"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2289"><a id="__codelineno-0-2289" name="__codelineno-0-2289"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2290"><a id="__codelineno-0-2290" name="__codelineno-0-2290"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2291"><a id="__codelineno-0-2291" name="__codelineno-0-2291"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2292"><a id="__codelineno-0-2292" name="__codelineno-0-2292"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2293"><a id="__codelineno-0-2293" name="__codelineno-0-2293"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-2294"><a id="__codelineno-0-2294" name="__codelineno-0-2294"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2295"><a id="__codelineno-0-2295" name="__codelineno-0-2295"></a><span class="sd">    Deletes a record or multiple records from the database based on specified filters.</span>
-</span><span id="__span-0-2296"><a id="__codelineno-0-2296" name="__codelineno-0-2296"></a>
-</span><span id="__span-0-2297"><a id="__codelineno-0-2297" name="__codelineno-0-2297"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2298"><a id="__codelineno-0-2298" name="__codelineno-0-2298"></a>
-</span><span id="__span-0-2299"><a id="__codelineno-0-2299" name="__codelineno-0-2299"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-2300"><a id="__codelineno-0-2300" name="__codelineno-0-2300"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-2301"><a id="__codelineno-0-2301" name="__codelineno-0-2301"></a><span class="sd">        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2302"><a id="__codelineno-0-2302" name="__codelineno-0-2302"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2303"><a id="__codelineno-0-2303" name="__codelineno-0-2303"></a><span class="sd">        **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</span>
-</span><span id="__span-0-2304"><a id="__codelineno-0-2304" name="__codelineno-0-2304"></a>
-</span><span id="__span-0-2305"><a id="__codelineno-0-2305" name="__codelineno-0-2305"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-2306"><a id="__codelineno-0-2306" name="__codelineno-0-2306"></a><span class="sd">        None</span>
-</span><span id="__span-0-2307"><a id="__codelineno-0-2307" name="__codelineno-0-2307"></a>
-</span><span id="__span-0-2308"><a id="__codelineno-0-2308" name="__codelineno-0-2308"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-2309"><a id="__codelineno-0-2309" name="__codelineno-0-2309"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2310"><a id="__codelineno-0-2310" name="__codelineno-0-2310"></a>
-</span><span id="__span-0-2311"><a id="__codelineno-0-2311" name="__codelineno-0-2311"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-2312"><a id="__codelineno-0-2312" name="__codelineno-0-2312"></a><span class="sd">        Delete a user based on their ID:</span>
-</span><span id="__span-0-2313"><a id="__codelineno-0-2313" name="__codelineno-0-2313"></a>
-</span><span id="__span-0-2314"><a id="__codelineno-0-2314" name="__codelineno-0-2314"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2315"><a id="__codelineno-0-2315" name="__codelineno-0-2315"></a><span class="sd">        await user_crud.db_delete(db, id=1)</span>
-</span><span id="__span-0-2316"><a id="__codelineno-0-2316" name="__codelineno-0-2316"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2317"><a id="__codelineno-0-2317" name="__codelineno-0-2317"></a>
-</span><span id="__span-0-2318"><a id="__codelineno-0-2318" name="__codelineno-0-2318"></a><span class="sd">        Delete users older than 30 years and allow deletion of multiple records:</span>
-</span><span id="__span-0-2319"><a id="__codelineno-0-2319" name="__codelineno-0-2319"></a>
-</span><span id="__span-0-2320"><a id="__codelineno-0-2320" name="__codelineno-0-2320"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2321"><a id="__codelineno-0-2321" name="__codelineno-0-2321"></a><span class="sd">        await user_crud.db_delete(</span>
-</span><span id="__span-0-2322"><a id="__codelineno-0-2322" name="__codelineno-0-2322"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2323"><a id="__codelineno-0-2323" name="__codelineno-0-2323"></a><span class="sd">            allow_multiple=True,</span>
-</span><span id="__span-0-2324"><a id="__codelineno-0-2324" name="__codelineno-0-2324"></a><span class="sd">            age__gt=30,</span>
-</span><span id="__span-0-2325"><a id="__codelineno-0-2325" name="__codelineno-0-2325"></a><span class="sd">        )</span>
-</span><span id="__span-0-2326"><a id="__codelineno-0-2326" name="__codelineno-0-2326"></a><span class="sd">        ```</span>
+<span class="normal"><a href="#__codelineno-0-2347">2347</a></span>
+<span class="normal"><a href="#__codelineno-0-2348">2348</a></span>
+<span class="normal"><a href="#__codelineno-0-2349">2349</a></span>
+<span class="normal"><a href="#__codelineno-0-2350">2350</a></span>
+<span class="normal"><a href="#__codelineno-0-2351">2351</a></span>
+<span class="normal"><a href="#__codelineno-0-2352">2352</a></span>
+<span class="normal"><a href="#__codelineno-0-2353">2353</a></span>
+<span class="normal"><a href="#__codelineno-0-2354">2354</a></span>
+<span class="normal"><a href="#__codelineno-0-2355">2355</a></span>
+<span class="normal"><a href="#__codelineno-0-2356">2356</a></span>
+<span class="normal"><a href="#__codelineno-0-2357">2357</a></span>
+<span class="normal"><a href="#__codelineno-0-2358">2358</a></span>
+<span class="normal"><a href="#__codelineno-0-2359">2359</a></span>
+<span class="normal"><a href="#__codelineno-0-2360">2360</a></span>
+<span class="normal"><a href="#__codelineno-0-2361">2361</a></span>
+<span class="normal"><a href="#__codelineno-0-2362">2362</a></span>
+<span class="normal"><a href="#__codelineno-0-2363">2363</a></span>
+<span class="normal"><a href="#__codelineno-0-2364">2364</a></span>
+<span class="normal"><a href="#__codelineno-0-2365">2365</a></span>
+<span class="normal"><a href="#__codelineno-0-2366">2366</a></span>
+<span class="normal"><a href="#__codelineno-0-2367">2367</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2307"><a id="__codelineno-0-2307" name="__codelineno-0-2307"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">db_delete</span><span class="p">(</span>
+</span><span id="__span-0-2308"><a id="__codelineno-0-2308" name="__codelineno-0-2308"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2309"><a id="__codelineno-0-2309" name="__codelineno-0-2309"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2310"><a id="__codelineno-0-2310" name="__codelineno-0-2310"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2311"><a id="__codelineno-0-2311" name="__codelineno-0-2311"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2312"><a id="__codelineno-0-2312" name="__codelineno-0-2312"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2313"><a id="__codelineno-0-2313" name="__codelineno-0-2313"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-2314"><a id="__codelineno-0-2314" name="__codelineno-0-2314"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2315"><a id="__codelineno-0-2315" name="__codelineno-0-2315"></a><span class="sd">    Deletes a record or multiple records from the database based on specified filters.</span>
+</span><span id="__span-0-2316"><a id="__codelineno-0-2316" name="__codelineno-0-2316"></a>
+</span><span id="__span-0-2317"><a id="__codelineno-0-2317" name="__codelineno-0-2317"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2318"><a id="__codelineno-0-2318" name="__codelineno-0-2318"></a>
+</span><span id="__span-0-2319"><a id="__codelineno-0-2319" name="__codelineno-0-2319"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-2320"><a id="__codelineno-0-2320" name="__codelineno-0-2320"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-2321"><a id="__codelineno-0-2321" name="__codelineno-0-2321"></a><span class="sd">        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2322"><a id="__codelineno-0-2322" name="__codelineno-0-2322"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2323"><a id="__codelineno-0-2323" name="__codelineno-0-2323"></a><span class="sd">        **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</span>
+</span><span id="__span-0-2324"><a id="__codelineno-0-2324" name="__codelineno-0-2324"></a>
+</span><span id="__span-0-2325"><a id="__codelineno-0-2325" name="__codelineno-0-2325"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-2326"><a id="__codelineno-0-2326" name="__codelineno-0-2326"></a><span class="sd">        None</span>
 </span><span id="__span-0-2327"><a id="__codelineno-0-2327" name="__codelineno-0-2327"></a>
-</span><span id="__span-0-2328"><a id="__codelineno-0-2328" name="__codelineno-0-2328"></a><span class="sd">        Delete a user with a specific username, ensuring only one record is deleted:</span>
-</span><span id="__span-0-2329"><a id="__codelineno-0-2329" name="__codelineno-0-2329"></a>
-</span><span id="__span-0-2330"><a id="__codelineno-0-2330" name="__codelineno-0-2330"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2331"><a id="__codelineno-0-2331" name="__codelineno-0-2331"></a><span class="sd">        await user_crud.db_delete(</span>
-</span><span id="__span-0-2332"><a id="__codelineno-0-2332" name="__codelineno-0-2332"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2333"><a id="__codelineno-0-2333" name="__codelineno-0-2333"></a><span class="sd">            allow_multiple=False,</span>
-</span><span id="__span-0-2334"><a id="__codelineno-0-2334" name="__codelineno-0-2334"></a><span class="sd">            username=&#39;unique_username&#39;,</span>
-</span><span id="__span-0-2335"><a id="__codelineno-0-2335" name="__codelineno-0-2335"></a><span class="sd">        )</span>
+</span><span id="__span-0-2328"><a id="__codelineno-0-2328" name="__codelineno-0-2328"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-2329"><a id="__codelineno-0-2329" name="__codelineno-0-2329"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2330"><a id="__codelineno-0-2330" name="__codelineno-0-2330"></a>
+</span><span id="__span-0-2331"><a id="__codelineno-0-2331" name="__codelineno-0-2331"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-2332"><a id="__codelineno-0-2332" name="__codelineno-0-2332"></a><span class="sd">        Delete a user based on their ID:</span>
+</span><span id="__span-0-2333"><a id="__codelineno-0-2333" name="__codelineno-0-2333"></a>
+</span><span id="__span-0-2334"><a id="__codelineno-0-2334" name="__codelineno-0-2334"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2335"><a id="__codelineno-0-2335" name="__codelineno-0-2335"></a><span class="sd">        await user_crud.db_delete(db, id=1)</span>
 </span><span id="__span-0-2336"><a id="__codelineno-0-2336" name="__codelineno-0-2336"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2337"><a id="__codelineno-0-2337" name="__codelineno-0-2337"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-2338"><a id="__codelineno-0-2338" name="__codelineno-0-2338"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2339"><a id="__codelineno-0-2339" name="__codelineno-0-2339"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2340"><a id="__codelineno-0-2340" name="__codelineno-0-2340"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2341"><a id="__codelineno-0-2341" name="__codelineno-0-2341"></a>        <span class="p">)</span>
-</span><span id="__span-0-2342"><a id="__codelineno-0-2342" name="__codelineno-0-2342"></a>
-</span><span id="__span-0-2343"><a id="__codelineno-0-2343" name="__codelineno-0-2343"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2344"><a id="__codelineno-0-2344" name="__codelineno-0-2344"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">delete</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-2345"><a id="__codelineno-0-2345" name="__codelineno-0-2345"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2346"><a id="__codelineno-0-2346" name="__codelineno-0-2346"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2347"><a id="__codelineno-0-2347" name="__codelineno-0-2347"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2337"><a id="__codelineno-0-2337" name="__codelineno-0-2337"></a>
+</span><span id="__span-0-2338"><a id="__codelineno-0-2338" name="__codelineno-0-2338"></a><span class="sd">        Delete users older than 30 years and allow deletion of multiple records:</span>
+</span><span id="__span-0-2339"><a id="__codelineno-0-2339" name="__codelineno-0-2339"></a>
+</span><span id="__span-0-2340"><a id="__codelineno-0-2340" name="__codelineno-0-2340"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2341"><a id="__codelineno-0-2341" name="__codelineno-0-2341"></a><span class="sd">        await user_crud.db_delete(</span>
+</span><span id="__span-0-2342"><a id="__codelineno-0-2342" name="__codelineno-0-2342"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2343"><a id="__codelineno-0-2343" name="__codelineno-0-2343"></a><span class="sd">            allow_multiple=True,</span>
+</span><span id="__span-0-2344"><a id="__codelineno-0-2344" name="__codelineno-0-2344"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-2345"><a id="__codelineno-0-2345" name="__codelineno-0-2345"></a><span class="sd">        )</span>
+</span><span id="__span-0-2346"><a id="__codelineno-0-2346" name="__codelineno-0-2346"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2347"><a id="__codelineno-0-2347" name="__codelineno-0-2347"></a>
+</span><span id="__span-0-2348"><a id="__codelineno-0-2348" name="__codelineno-0-2348"></a><span class="sd">        Delete a user with a specific username, ensuring only one record is deleted:</span>
+</span><span id="__span-0-2349"><a id="__codelineno-0-2349" name="__codelineno-0-2349"></a>
+</span><span id="__span-0-2350"><a id="__codelineno-0-2350" name="__codelineno-0-2350"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2351"><a id="__codelineno-0-2351" name="__codelineno-0-2351"></a><span class="sd">        await user_crud.db_delete(</span>
+</span><span id="__span-0-2352"><a id="__codelineno-0-2352" name="__codelineno-0-2352"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2353"><a id="__codelineno-0-2353" name="__codelineno-0-2353"></a><span class="sd">            allow_multiple=False,</span>
+</span><span id="__span-0-2354"><a id="__codelineno-0-2354" name="__codelineno-0-2354"></a><span class="sd">            username=&#39;unique_username&#39;,</span>
+</span><span id="__span-0-2355"><a id="__codelineno-0-2355" name="__codelineno-0-2355"></a><span class="sd">        )</span>
+</span><span id="__span-0-2356"><a id="__codelineno-0-2356" name="__codelineno-0-2356"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2357"><a id="__codelineno-0-2357" name="__codelineno-0-2357"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-2358"><a id="__codelineno-0-2358" name="__codelineno-0-2358"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2359"><a id="__codelineno-0-2359" name="__codelineno-0-2359"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2360"><a id="__codelineno-0-2360" name="__codelineno-0-2360"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2361"><a id="__codelineno-0-2361" name="__codelineno-0-2361"></a>        <span class="p">)</span>
+</span><span id="__span-0-2362"><a id="__codelineno-0-2362" name="__codelineno-0-2362"></a>
+</span><span id="__span-0-2363"><a id="__codelineno-0-2363" name="__codelineno-0-2363"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2364"><a id="__codelineno-0-2364" name="__codelineno-0-2364"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">delete</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-2365"><a id="__codelineno-0-2365" name="__codelineno-0-2365"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2366"><a id="__codelineno-0-2366" name="__codelineno-0-2366"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2367"><a id="__codelineno-0-2367" name="__codelineno-0-2367"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -8099,27 +8193,7 @@ <h2 id="fastcrud.FastCRUD.delete" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2349">2349</a></span>
-<span class="normal"><a href="#__codelineno-0-2350">2350</a></span>
-<span class="normal"><a href="#__codelineno-0-2351">2351</a></span>
-<span class="normal"><a href="#__codelineno-0-2352">2352</a></span>
-<span class="normal"><a href="#__codelineno-0-2353">2353</a></span>
-<span class="normal"><a href="#__codelineno-0-2354">2354</a></span>
-<span class="normal"><a href="#__codelineno-0-2355">2355</a></span>
-<span class="normal"><a href="#__codelineno-0-2356">2356</a></span>
-<span class="normal"><a href="#__codelineno-0-2357">2357</a></span>
-<span class="normal"><a href="#__codelineno-0-2358">2358</a></span>
-<span class="normal"><a href="#__codelineno-0-2359">2359</a></span>
-<span class="normal"><a href="#__codelineno-0-2360">2360</a></span>
-<span class="normal"><a href="#__codelineno-0-2361">2361</a></span>
-<span class="normal"><a href="#__codelineno-0-2362">2362</a></span>
-<span class="normal"><a href="#__codelineno-0-2363">2363</a></span>
-<span class="normal"><a href="#__codelineno-0-2364">2364</a></span>
-<span class="normal"><a href="#__codelineno-0-2365">2365</a></span>
-<span class="normal"><a href="#__codelineno-0-2366">2366</a></span>
-<span class="normal"><a href="#__codelineno-0-2367">2367</a></span>
-<span class="normal"><a href="#__codelineno-0-2368">2368</a></span>
-<span class="normal"><a href="#__codelineno-0-2369">2369</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2369">2369</a></span>
 <span class="normal"><a href="#__codelineno-0-2370">2370</a></span>
 <span class="normal"><a href="#__codelineno-0-2371">2371</a></span>
 <span class="normal"><a href="#__codelineno-0-2372">2372</a></span>
@@ -8190,98 +8264,118 @@ <h2 id="fastcrud.FastCRUD.delete" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-2437">2437</a></span>
 <span class="normal"><a href="#__codelineno-0-2438">2438</a></span>
 <span class="normal"><a href="#__codelineno-0-2439">2439</a></span>
-<span class="normal"><a href="#__codelineno-0-2440">2440</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2349"><a id="__codelineno-0-2349" name="__codelineno-0-2349"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">delete</span><span class="p">(</span>
-</span><span id="__span-0-2350"><a id="__codelineno-0-2350" name="__codelineno-0-2350"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2351"><a id="__codelineno-0-2351" name="__codelineno-0-2351"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2352"><a id="__codelineno-0-2352" name="__codelineno-0-2352"></a>    <span class="n">db_row</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2353"><a id="__codelineno-0-2353" name="__codelineno-0-2353"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2354"><a id="__codelineno-0-2354" name="__codelineno-0-2354"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2355"><a id="__codelineno-0-2355" name="__codelineno-0-2355"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2356"><a id="__codelineno-0-2356" name="__codelineno-0-2356"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-2357"><a id="__codelineno-0-2357" name="__codelineno-0-2357"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2358"><a id="__codelineno-0-2358" name="__codelineno-0-2358"></a><span class="sd">    Soft deletes a record or optionally multiple records if it has an `&quot;is_deleted&quot;` attribute, otherwise performs a hard delete, based on specified filters.</span>
-</span><span id="__span-0-2359"><a id="__codelineno-0-2359" name="__codelineno-0-2359"></a>
-</span><span id="__span-0-2360"><a id="__codelineno-0-2360" name="__codelineno-0-2360"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2361"><a id="__codelineno-0-2361" name="__codelineno-0-2361"></a>
-</span><span id="__span-0-2362"><a id="__codelineno-0-2362" name="__codelineno-0-2362"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-2363"><a id="__codelineno-0-2363" name="__codelineno-0-2363"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-2364"><a id="__codelineno-0-2364" name="__codelineno-0-2364"></a><span class="sd">        db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</span>
-</span><span id="__span-0-2365"><a id="__codelineno-0-2365" name="__codelineno-0-2365"></a><span class="sd">        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2366"><a id="__codelineno-0-2366" name="__codelineno-0-2366"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2367"><a id="__codelineno-0-2367" name="__codelineno-0-2367"></a><span class="sd">        **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</span>
-</span><span id="__span-0-2368"><a id="__codelineno-0-2368" name="__codelineno-0-2368"></a>
-</span><span id="__span-0-2369"><a id="__codelineno-0-2369" name="__codelineno-0-2369"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-2370"><a id="__codelineno-0-2370" name="__codelineno-0-2370"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2371"><a id="__codelineno-0-2371" name="__codelineno-0-2371"></a><span class="sd">        NoResultFound: If no record matches the filters.</span>
-</span><span id="__span-0-2372"><a id="__codelineno-0-2372" name="__codelineno-0-2372"></a>
-</span><span id="__span-0-2373"><a id="__codelineno-0-2373" name="__codelineno-0-2373"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-2374"><a id="__codelineno-0-2374" name="__codelineno-0-2374"></a><span class="sd">        None</span>
-</span><span id="__span-0-2375"><a id="__codelineno-0-2375" name="__codelineno-0-2375"></a>
-</span><span id="__span-0-2376"><a id="__codelineno-0-2376" name="__codelineno-0-2376"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-2377"><a id="__codelineno-0-2377" name="__codelineno-0-2377"></a><span class="sd">        Soft delete a specific user by ID:</span>
-</span><span id="__span-0-2378"><a id="__codelineno-0-2378" name="__codelineno-0-2378"></a>
-</span><span id="__span-0-2379"><a id="__codelineno-0-2379" name="__codelineno-0-2379"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2380"><a id="__codelineno-0-2380" name="__codelineno-0-2380"></a><span class="sd">        await user_crud.delete(db, id=1)</span>
-</span><span id="__span-0-2381"><a id="__codelineno-0-2381" name="__codelineno-0-2381"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2382"><a id="__codelineno-0-2382" name="__codelineno-0-2382"></a>
-</span><span id="__span-0-2383"><a id="__codelineno-0-2383" name="__codelineno-0-2383"></a><span class="sd">        Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</span>
-</span><span id="__span-0-2384"><a id="__codelineno-0-2384" name="__codelineno-0-2384"></a>
-</span><span id="__span-0-2385"><a id="__codelineno-0-2385" name="__codelineno-0-2385"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2386"><a id="__codelineno-0-2386" name="__codelineno-0-2386"></a><span class="sd">        await user_crud.delete(</span>
-</span><span id="__span-0-2387"><a id="__codelineno-0-2387" name="__codelineno-0-2387"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2388"><a id="__codelineno-0-2388" name="__codelineno-0-2388"></a><span class="sd">            allow_multiple=True,</span>
-</span><span id="__span-0-2389"><a id="__codelineno-0-2389" name="__codelineno-0-2389"></a><span class="sd">            creation_date__lt=datetime(2020, 1, 1),</span>
-</span><span id="__span-0-2390"><a id="__codelineno-0-2390" name="__codelineno-0-2390"></a><span class="sd">        )</span>
-</span><span id="__span-0-2391"><a id="__codelineno-0-2391" name="__codelineno-0-2391"></a><span class="sd">        ```</span>
+<span class="normal"><a href="#__codelineno-0-2440">2440</a></span>
+<span class="normal"><a href="#__codelineno-0-2441">2441</a></span>
+<span class="normal"><a href="#__codelineno-0-2442">2442</a></span>
+<span class="normal"><a href="#__codelineno-0-2443">2443</a></span>
+<span class="normal"><a href="#__codelineno-0-2444">2444</a></span>
+<span class="normal"><a href="#__codelineno-0-2445">2445</a></span>
+<span class="normal"><a href="#__codelineno-0-2446">2446</a></span>
+<span class="normal"><a href="#__codelineno-0-2447">2447</a></span>
+<span class="normal"><a href="#__codelineno-0-2448">2448</a></span>
+<span class="normal"><a href="#__codelineno-0-2449">2449</a></span>
+<span class="normal"><a href="#__codelineno-0-2450">2450</a></span>
+<span class="normal"><a href="#__codelineno-0-2451">2451</a></span>
+<span class="normal"><a href="#__codelineno-0-2452">2452</a></span>
+<span class="normal"><a href="#__codelineno-0-2453">2453</a></span>
+<span class="normal"><a href="#__codelineno-0-2454">2454</a></span>
+<span class="normal"><a href="#__codelineno-0-2455">2455</a></span>
+<span class="normal"><a href="#__codelineno-0-2456">2456</a></span>
+<span class="normal"><a href="#__codelineno-0-2457">2457</a></span>
+<span class="normal"><a href="#__codelineno-0-2458">2458</a></span>
+<span class="normal"><a href="#__codelineno-0-2459">2459</a></span>
+<span class="normal"><a href="#__codelineno-0-2460">2460</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2369"><a id="__codelineno-0-2369" name="__codelineno-0-2369"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">delete</span><span class="p">(</span>
+</span><span id="__span-0-2370"><a id="__codelineno-0-2370" name="__codelineno-0-2370"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2371"><a id="__codelineno-0-2371" name="__codelineno-0-2371"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2372"><a id="__codelineno-0-2372" name="__codelineno-0-2372"></a>    <span class="n">db_row</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2373"><a id="__codelineno-0-2373" name="__codelineno-0-2373"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2374"><a id="__codelineno-0-2374" name="__codelineno-0-2374"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2375"><a id="__codelineno-0-2375" name="__codelineno-0-2375"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2376"><a id="__codelineno-0-2376" name="__codelineno-0-2376"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-2377"><a id="__codelineno-0-2377" name="__codelineno-0-2377"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2378"><a id="__codelineno-0-2378" name="__codelineno-0-2378"></a><span class="sd">    Soft deletes a record or optionally multiple records if it has an `&quot;is_deleted&quot;` attribute, otherwise performs a hard delete, based on specified filters.</span>
+</span><span id="__span-0-2379"><a id="__codelineno-0-2379" name="__codelineno-0-2379"></a>
+</span><span id="__span-0-2380"><a id="__codelineno-0-2380" name="__codelineno-0-2380"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2381"><a id="__codelineno-0-2381" name="__codelineno-0-2381"></a>
+</span><span id="__span-0-2382"><a id="__codelineno-0-2382" name="__codelineno-0-2382"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-2383"><a id="__codelineno-0-2383" name="__codelineno-0-2383"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-2384"><a id="__codelineno-0-2384" name="__codelineno-0-2384"></a><span class="sd">        db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</span>
+</span><span id="__span-0-2385"><a id="__codelineno-0-2385" name="__codelineno-0-2385"></a><span class="sd">        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2386"><a id="__codelineno-0-2386" name="__codelineno-0-2386"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2387"><a id="__codelineno-0-2387" name="__codelineno-0-2387"></a><span class="sd">        **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-2388"><a id="__codelineno-0-2388" name="__codelineno-0-2388"></a>
+</span><span id="__span-0-2389"><a id="__codelineno-0-2389" name="__codelineno-0-2389"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-2390"><a id="__codelineno-0-2390" name="__codelineno-0-2390"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2391"><a id="__codelineno-0-2391" name="__codelineno-0-2391"></a><span class="sd">        NoResultFound: If no record matches the filters.</span>
 </span><span id="__span-0-2392"><a id="__codelineno-0-2392" name="__codelineno-0-2392"></a>
-</span><span id="__span-0-2393"><a id="__codelineno-0-2393" name="__codelineno-0-2393"></a><span class="sd">        Soft delete a user with a specific email, ensuring only one record is deleted:</span>
-</span><span id="__span-0-2394"><a id="__codelineno-0-2394" name="__codelineno-0-2394"></a>
-</span><span id="__span-0-2395"><a id="__codelineno-0-2395" name="__codelineno-0-2395"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2396"><a id="__codelineno-0-2396" name="__codelineno-0-2396"></a><span class="sd">        await user_crud.delete(</span>
-</span><span id="__span-0-2397"><a id="__codelineno-0-2397" name="__codelineno-0-2397"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2398"><a id="__codelineno-0-2398" name="__codelineno-0-2398"></a><span class="sd">            allow_multiple=False,</span>
-</span><span id="__span-0-2399"><a id="__codelineno-0-2399" name="__codelineno-0-2399"></a><span class="sd">            email=&#39;unique@example.com&#39;,</span>
-</span><span id="__span-0-2400"><a id="__codelineno-0-2400" name="__codelineno-0-2400"></a><span class="sd">        )</span>
+</span><span id="__span-0-2393"><a id="__codelineno-0-2393" name="__codelineno-0-2393"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-2394"><a id="__codelineno-0-2394" name="__codelineno-0-2394"></a><span class="sd">        None</span>
+</span><span id="__span-0-2395"><a id="__codelineno-0-2395" name="__codelineno-0-2395"></a>
+</span><span id="__span-0-2396"><a id="__codelineno-0-2396" name="__codelineno-0-2396"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-2397"><a id="__codelineno-0-2397" name="__codelineno-0-2397"></a><span class="sd">        Soft delete a specific user by ID:</span>
+</span><span id="__span-0-2398"><a id="__codelineno-0-2398" name="__codelineno-0-2398"></a>
+</span><span id="__span-0-2399"><a id="__codelineno-0-2399" name="__codelineno-0-2399"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2400"><a id="__codelineno-0-2400" name="__codelineno-0-2400"></a><span class="sd">        await user_crud.delete(db, id=1)</span>
 </span><span id="__span-0-2401"><a id="__codelineno-0-2401" name="__codelineno-0-2401"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2402"><a id="__codelineno-0-2402" name="__codelineno-0-2402"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-2403"><a id="__codelineno-0-2403" name="__codelineno-0-2403"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2404"><a id="__codelineno-0-2404" name="__codelineno-0-2404"></a>    <span class="k">if</span> <span class="n">db_row</span><span class="p">:</span>
-</span><span id="__span-0-2405"><a id="__codelineno-0-2405" name="__codelineno-0-2405"></a>        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span>
-</span><span id="__span-0-2406"><a id="__codelineno-0-2406" name="__codelineno-0-2406"></a>            <span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
-</span><span id="__span-0-2407"><a id="__codelineno-0-2407" name="__codelineno-0-2407"></a>        <span class="p">):</span>
-</span><span id="__span-0-2408"><a id="__codelineno-0-2408" name="__codelineno-0-2408"></a>            <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-2409"><a id="__codelineno-0-2409" name="__codelineno-0-2409"></a>            <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">,</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">))</span>
-</span><span id="__span-0-2410"><a id="__codelineno-0-2410" name="__codelineno-0-2410"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2411"><a id="__codelineno-0-2411" name="__codelineno-0-2411"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2412"><a id="__codelineno-0-2412" name="__codelineno-0-2412"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2413"><a id="__codelineno-0-2413" name="__codelineno-0-2413"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db_row</span><span class="p">)</span>
-</span><span id="__span-0-2414"><a id="__codelineno-0-2414" name="__codelineno-0-2414"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2415"><a id="__codelineno-0-2415" name="__codelineno-0-2415"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2416"><a id="__codelineno-0-2416" name="__codelineno-0-2416"></a>        <span class="k">return</span>
-</span><span id="__span-0-2417"><a id="__codelineno-0-2417" name="__codelineno-0-2417"></a>
-</span><span id="__span-0-2418"><a id="__codelineno-0-2418" name="__codelineno-0-2418"></a>    <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2419"><a id="__codelineno-0-2419" name="__codelineno-0-2419"></a>    <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-2420"><a id="__codelineno-0-2420" name="__codelineno-0-2420"></a>        <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to delete.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-2421"><a id="__codelineno-0-2421" name="__codelineno-0-2421"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2422"><a id="__codelineno-0-2422" name="__codelineno-0-2422"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2423"><a id="__codelineno-0-2423" name="__codelineno-0-2423"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2424"><a id="__codelineno-0-2424" name="__codelineno-0-2424"></a>        <span class="p">)</span>
-</span><span id="__span-0-2425"><a id="__codelineno-0-2425" name="__codelineno-0-2425"></a>
-</span><span id="__span-0-2426"><a id="__codelineno-0-2426" name="__codelineno-0-2426"></a>    <span class="n">update_values</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Union</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">datetime</span><span class="p">]]</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-2427"><a id="__codelineno-0-2427" name="__codelineno-0-2427"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
-</span><span id="__span-0-2428"><a id="__codelineno-0-2428" name="__codelineno-0-2428"></a>        <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
-</span><span id="__span-0-2429"><a id="__codelineno-0-2429" name="__codelineno-0-2429"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
-</span><span id="__span-0-2430"><a id="__codelineno-0-2430" name="__codelineno-0-2430"></a>        <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
-</span><span id="__span-0-2431"><a id="__codelineno-0-2431" name="__codelineno-0-2431"></a>
-</span><span id="__span-0-2432"><a id="__codelineno-0-2432" name="__codelineno-0-2432"></a>    <span class="k">if</span> <span class="n">update_values</span><span class="p">:</span>
-</span><span id="__span-0-2433"><a id="__codelineno-0-2433" name="__codelineno-0-2433"></a>        <span class="n">update_stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="o">**</span><span class="n">update_values</span><span class="p">)</span>
-</span><span id="__span-0-2434"><a id="__codelineno-0-2434" name="__codelineno-0-2434"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">update_stmt</span><span class="p">)</span>
-</span><span id="__span-0-2435"><a id="__codelineno-0-2435" name="__codelineno-0-2435"></a>
-</span><span id="__span-0-2436"><a id="__codelineno-0-2436" name="__codelineno-0-2436"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2437"><a id="__codelineno-0-2437" name="__codelineno-0-2437"></a>        <span class="n">delete_stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-2438"><a id="__codelineno-0-2438" name="__codelineno-0-2438"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">delete_stmt</span><span class="p">)</span>
-</span><span id="__span-0-2439"><a id="__codelineno-0-2439" name="__codelineno-0-2439"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2440"><a id="__codelineno-0-2440" name="__codelineno-0-2440"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2402"><a id="__codelineno-0-2402" name="__codelineno-0-2402"></a>
+</span><span id="__span-0-2403"><a id="__codelineno-0-2403" name="__codelineno-0-2403"></a><span class="sd">        Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</span>
+</span><span id="__span-0-2404"><a id="__codelineno-0-2404" name="__codelineno-0-2404"></a>
+</span><span id="__span-0-2405"><a id="__codelineno-0-2405" name="__codelineno-0-2405"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2406"><a id="__codelineno-0-2406" name="__codelineno-0-2406"></a><span class="sd">        await user_crud.delete(</span>
+</span><span id="__span-0-2407"><a id="__codelineno-0-2407" name="__codelineno-0-2407"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2408"><a id="__codelineno-0-2408" name="__codelineno-0-2408"></a><span class="sd">            allow_multiple=True,</span>
+</span><span id="__span-0-2409"><a id="__codelineno-0-2409" name="__codelineno-0-2409"></a><span class="sd">            creation_date__lt=datetime(2020, 1, 1),</span>
+</span><span id="__span-0-2410"><a id="__codelineno-0-2410" name="__codelineno-0-2410"></a><span class="sd">        )</span>
+</span><span id="__span-0-2411"><a id="__codelineno-0-2411" name="__codelineno-0-2411"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2412"><a id="__codelineno-0-2412" name="__codelineno-0-2412"></a>
+</span><span id="__span-0-2413"><a id="__codelineno-0-2413" name="__codelineno-0-2413"></a><span class="sd">        Soft delete a user with a specific email, ensuring only one record is deleted:</span>
+</span><span id="__span-0-2414"><a id="__codelineno-0-2414" name="__codelineno-0-2414"></a>
+</span><span id="__span-0-2415"><a id="__codelineno-0-2415" name="__codelineno-0-2415"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2416"><a id="__codelineno-0-2416" name="__codelineno-0-2416"></a><span class="sd">        await user_crud.delete(</span>
+</span><span id="__span-0-2417"><a id="__codelineno-0-2417" name="__codelineno-0-2417"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2418"><a id="__codelineno-0-2418" name="__codelineno-0-2418"></a><span class="sd">            allow_multiple=False,</span>
+</span><span id="__span-0-2419"><a id="__codelineno-0-2419" name="__codelineno-0-2419"></a><span class="sd">            email=&#39;unique@example.com&#39;,</span>
+</span><span id="__span-0-2420"><a id="__codelineno-0-2420" name="__codelineno-0-2420"></a><span class="sd">        )</span>
+</span><span id="__span-0-2421"><a id="__codelineno-0-2421" name="__codelineno-0-2421"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2422"><a id="__codelineno-0-2422" name="__codelineno-0-2422"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-2423"><a id="__codelineno-0-2423" name="__codelineno-0-2423"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2424"><a id="__codelineno-0-2424" name="__codelineno-0-2424"></a>    <span class="k">if</span> <span class="n">db_row</span><span class="p">:</span>
+</span><span id="__span-0-2425"><a id="__codelineno-0-2425" name="__codelineno-0-2425"></a>        <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">)</span> <span class="ow">and</span> <span class="nb">hasattr</span><span class="p">(</span>
+</span><span id="__span-0-2426"><a id="__codelineno-0-2426" name="__codelineno-0-2426"></a>            <span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span>
+</span><span id="__span-0-2427"><a id="__codelineno-0-2427" name="__codelineno-0-2427"></a>        <span class="p">):</span>
+</span><span id="__span-0-2428"><a id="__codelineno-0-2428" name="__codelineno-0-2428"></a>            <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">,</span> <span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-2429"><a id="__codelineno-0-2429" name="__codelineno-0-2429"></a>            <span class="nb">setattr</span><span class="p">(</span><span class="n">db_row</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">,</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">))</span>
+</span><span id="__span-0-2430"><a id="__codelineno-0-2430" name="__codelineno-0-2430"></a>            <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2431"><a id="__codelineno-0-2431" name="__codelineno-0-2431"></a>                <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2432"><a id="__codelineno-0-2432" name="__codelineno-0-2432"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2433"><a id="__codelineno-0-2433" name="__codelineno-0-2433"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">delete</span><span class="p">(</span><span class="n">db_row</span><span class="p">)</span>
+</span><span id="__span-0-2434"><a id="__codelineno-0-2434" name="__codelineno-0-2434"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2435"><a id="__codelineno-0-2435" name="__codelineno-0-2435"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2436"><a id="__codelineno-0-2436" name="__codelineno-0-2436"></a>        <span class="k">return</span>
+</span><span id="__span-0-2437"><a id="__codelineno-0-2437" name="__codelineno-0-2437"></a>
+</span><span id="__span-0-2438"><a id="__codelineno-0-2438" name="__codelineno-0-2438"></a>    <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2439"><a id="__codelineno-0-2439" name="__codelineno-0-2439"></a>    <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2440"><a id="__codelineno-0-2440" name="__codelineno-0-2440"></a>        <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to delete.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2441"><a id="__codelineno-0-2441" name="__codelineno-0-2441"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2442"><a id="__codelineno-0-2442" name="__codelineno-0-2442"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2443"><a id="__codelineno-0-2443" name="__codelineno-0-2443"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to delete, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2444"><a id="__codelineno-0-2444" name="__codelineno-0-2444"></a>        <span class="p">)</span>
+</span><span id="__span-0-2445"><a id="__codelineno-0-2445" name="__codelineno-0-2445"></a>
+</span><span id="__span-0-2446"><a id="__codelineno-0-2446" name="__codelineno-0-2446"></a>    <span class="n">update_values</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Union</span><span class="p">[</span><span class="nb">bool</span><span class="p">,</span> <span class="n">datetime</span><span class="p">]]</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-2447"><a id="__codelineno-0-2447" name="__codelineno-0-2447"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
+</span><span id="__span-0-2448"><a id="__codelineno-0-2448" name="__codelineno-0-2448"></a>        <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">deleted_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="__span-0-2449"><a id="__codelineno-0-2449" name="__codelineno-0-2449"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span><span class="p">:</span>
+</span><span id="__span-0-2450"><a id="__codelineno-0-2450" name="__codelineno-0-2450"></a>        <span class="n">update_values</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">is_deleted_column</span><span class="p">]</span> <span class="o">=</span> <span class="kc">True</span>
+</span><span id="__span-0-2451"><a id="__codelineno-0-2451" name="__codelineno-0-2451"></a>
+</span><span id="__span-0-2452"><a id="__codelineno-0-2452" name="__codelineno-0-2452"></a>    <span class="k">if</span> <span class="n">update_values</span><span class="p">:</span>
+</span><span id="__span-0-2453"><a id="__codelineno-0-2453" name="__codelineno-0-2453"></a>        <span class="n">update_stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="o">**</span><span class="n">update_values</span><span class="p">)</span>
+</span><span id="__span-0-2454"><a id="__codelineno-0-2454" name="__codelineno-0-2454"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">update_stmt</span><span class="p">)</span>
+</span><span id="__span-0-2455"><a id="__codelineno-0-2455" name="__codelineno-0-2455"></a>
+</span><span id="__span-0-2456"><a id="__codelineno-0-2456" name="__codelineno-0-2456"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2457"><a id="__codelineno-0-2457" name="__codelineno-0-2457"></a>        <span class="n">delete_stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__table__</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span><span class="o">.</span><span class="n">where</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-2458"><a id="__codelineno-0-2458" name="__codelineno-0-2458"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">delete_stmt</span><span class="p">)</span>
+</span><span id="__span-0-2459"><a id="__codelineno-0-2459" name="__codelineno-0-2459"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2460"><a id="__codelineno-0-2460" name="__codelineno-0-2460"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -8394,17 +8488,7 @@ <h2 id="fastcrud.FastCRUD.exists" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-968"> 968</a></span>
-<span class="normal"><a href="#__codelineno-0-969"> 969</a></span>
-<span class="normal"><a href="#__codelineno-0-970"> 970</a></span>
-<span class="normal"><a href="#__codelineno-0-971"> 971</a></span>
-<span class="normal"><a href="#__codelineno-0-972"> 972</a></span>
-<span class="normal"><a href="#__codelineno-0-973"> 973</a></span>
-<span class="normal"><a href="#__codelineno-0-974"> 974</a></span>
-<span class="normal"><a href="#__codelineno-0-975"> 975</a></span>
-<span class="normal"><a href="#__codelineno-0-976"> 976</a></span>
-<span class="normal"><a href="#__codelineno-0-977"> 977</a></span>
-<span class="normal"><a href="#__codelineno-0-978"> 978</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-978"> 978</a></span>
 <span class="normal"><a href="#__codelineno-0-979"> 979</a></span>
 <span class="normal"><a href="#__codelineno-0-980"> 980</a></span>
 <span class="normal"><a href="#__codelineno-0-981"> 981</a></span>
@@ -8436,49 +8520,59 @@ <h2 id="fastcrud.FastCRUD.exists" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-1007">1007</a></span>
 <span class="normal"><a href="#__codelineno-0-1008">1008</a></span>
 <span class="normal"><a href="#__codelineno-0-1009">1009</a></span>
-<span class="normal"><a href="#__codelineno-0-1010">1010</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-968"><a id="__codelineno-0-968" name="__codelineno-0-968"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
-</span><span id="__span-0-969"><a id="__codelineno-0-969" name="__codelineno-0-969"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-970"><a id="__codelineno-0-970" name="__codelineno-0-970"></a><span class="sd">    Checks if any records exist that match the given filter conditions.</span>
-</span><span id="__span-0-971"><a id="__codelineno-0-971" name="__codelineno-0-971"></a>
-</span><span id="__span-0-972"><a id="__codelineno-0-972" name="__codelineno-0-972"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-973"><a id="__codelineno-0-973" name="__codelineno-0-973"></a>
-</span><span id="__span-0-974"><a id="__codelineno-0-974" name="__codelineno-0-974"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-975"><a id="__codelineno-0-975" name="__codelineno-0-975"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-976"><a id="__codelineno-0-976" name="__codelineno-0-976"></a><span class="sd">        **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</span>
-</span><span id="__span-0-977"><a id="__codelineno-0-977" name="__codelineno-0-977"></a>
-</span><span id="__span-0-978"><a id="__codelineno-0-978" name="__codelineno-0-978"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-979"><a id="__codelineno-0-979" name="__codelineno-0-979"></a><span class="sd">        `True` if at least one record matches the filter conditions, `False` otherwise.</span>
-</span><span id="__span-0-980"><a id="__codelineno-0-980" name="__codelineno-0-980"></a>
-</span><span id="__span-0-981"><a id="__codelineno-0-981" name="__codelineno-0-981"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-982"><a id="__codelineno-0-982" name="__codelineno-0-982"></a><span class="sd">        Check if a user with a specific ID exists:</span>
+<span class="normal"><a href="#__codelineno-0-1010">1010</a></span>
+<span class="normal"><a href="#__codelineno-0-1011">1011</a></span>
+<span class="normal"><a href="#__codelineno-0-1012">1012</a></span>
+<span class="normal"><a href="#__codelineno-0-1013">1013</a></span>
+<span class="normal"><a href="#__codelineno-0-1014">1014</a></span>
+<span class="normal"><a href="#__codelineno-0-1015">1015</a></span>
+<span class="normal"><a href="#__codelineno-0-1016">1016</a></span>
+<span class="normal"><a href="#__codelineno-0-1017">1017</a></span>
+<span class="normal"><a href="#__codelineno-0-1018">1018</a></span>
+<span class="normal"><a href="#__codelineno-0-1019">1019</a></span>
+<span class="normal"><a href="#__codelineno-0-1020">1020</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-978"><a id="__codelineno-0-978" name="__codelineno-0-978"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">exists</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+</span><span id="__span-0-979"><a id="__codelineno-0-979" name="__codelineno-0-979"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-980"><a id="__codelineno-0-980" name="__codelineno-0-980"></a><span class="sd">    Checks if any records exist that match the given filter conditions.</span>
+</span><span id="__span-0-981"><a id="__codelineno-0-981" name="__codelineno-0-981"></a>
+</span><span id="__span-0-982"><a id="__codelineno-0-982" name="__codelineno-0-982"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-983"><a id="__codelineno-0-983" name="__codelineno-0-983"></a>
-</span><span id="__span-0-984"><a id="__codelineno-0-984" name="__codelineno-0-984"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-985"><a id="__codelineno-0-985" name="__codelineno-0-985"></a><span class="sd">        exists = await user_crud.exists(db, id=1)</span>
-</span><span id="__span-0-986"><a id="__codelineno-0-986" name="__codelineno-0-986"></a><span class="sd">        ```</span>
+</span><span id="__span-0-984"><a id="__codelineno-0-984" name="__codelineno-0-984"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-985"><a id="__codelineno-0-985" name="__codelineno-0-985"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-986"><a id="__codelineno-0-986" name="__codelineno-0-986"></a><span class="sd">        **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</span>
 </span><span id="__span-0-987"><a id="__codelineno-0-987" name="__codelineno-0-987"></a>
-</span><span id="__span-0-988"><a id="__codelineno-0-988" name="__codelineno-0-988"></a><span class="sd">        Check if any user is older than 30:</span>
-</span><span id="__span-0-989"><a id="__codelineno-0-989" name="__codelineno-0-989"></a>
-</span><span id="__span-0-990"><a id="__codelineno-0-990" name="__codelineno-0-990"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-991"><a id="__codelineno-0-991" name="__codelineno-0-991"></a><span class="sd">        exists = await user_crud.exists(db, age__gt=30)</span>
-</span><span id="__span-0-992"><a id="__codelineno-0-992" name="__codelineno-0-992"></a><span class="sd">        ```</span>
+</span><span id="__span-0-988"><a id="__codelineno-0-988" name="__codelineno-0-988"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-989"><a id="__codelineno-0-989" name="__codelineno-0-989"></a><span class="sd">        `True` if at least one record matches the filter conditions, `False` otherwise.</span>
+</span><span id="__span-0-990"><a id="__codelineno-0-990" name="__codelineno-0-990"></a>
+</span><span id="__span-0-991"><a id="__codelineno-0-991" name="__codelineno-0-991"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-992"><a id="__codelineno-0-992" name="__codelineno-0-992"></a><span class="sd">        Check if a user with a specific ID exists:</span>
 </span><span id="__span-0-993"><a id="__codelineno-0-993" name="__codelineno-0-993"></a>
-</span><span id="__span-0-994"><a id="__codelineno-0-994" name="__codelineno-0-994"></a><span class="sd">        Check if any user was registered before Jan 1, 2020:</span>
-</span><span id="__span-0-995"><a id="__codelineno-0-995" name="__codelineno-0-995"></a>
-</span><span id="__span-0-996"><a id="__codelineno-0-996" name="__codelineno-0-996"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-997"><a id="__codelineno-0-997" name="__codelineno-0-997"></a><span class="sd">        exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))</span>
-</span><span id="__span-0-998"><a id="__codelineno-0-998" name="__codelineno-0-998"></a><span class="sd">        ```</span>
+</span><span id="__span-0-994"><a id="__codelineno-0-994" name="__codelineno-0-994"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-995"><a id="__codelineno-0-995" name="__codelineno-0-995"></a><span class="sd">        exists = await user_crud.exists(db, id=1)</span>
+</span><span id="__span-0-996"><a id="__codelineno-0-996" name="__codelineno-0-996"></a><span class="sd">        ```</span>
+</span><span id="__span-0-997"><a id="__codelineno-0-997" name="__codelineno-0-997"></a>
+</span><span id="__span-0-998"><a id="__codelineno-0-998" name="__codelineno-0-998"></a><span class="sd">        Check if any user is older than 30:</span>
 </span><span id="__span-0-999"><a id="__codelineno-0-999" name="__codelineno-0-999"></a>
-</span><span id="__span-0-1000"><a id="__codelineno-0-1000" name="__codelineno-0-1000"></a><span class="sd">        Check if a username other than `admin` exists:</span>
-</span><span id="__span-0-1001"><a id="__codelineno-0-1001" name="__codelineno-0-1001"></a>
-</span><span id="__span-0-1002"><a id="__codelineno-0-1002" name="__codelineno-0-1002"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1003"><a id="__codelineno-0-1003" name="__codelineno-0-1003"></a><span class="sd">        exists = await user_crud.exists(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-1004"><a id="__codelineno-0-1004" name="__codelineno-0-1004"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1005"><a id="__codelineno-0-1005" name="__codelineno-0-1005"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-1006"><a id="__codelineno-0-1006" name="__codelineno-0-1006"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1007"><a id="__codelineno-0-1007" name="__codelineno-0-1007"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
-</span><span id="__span-0-1008"><a id="__codelineno-0-1008" name="__codelineno-0-1008"></a>
-</span><span id="__span-0-1009"><a id="__codelineno-0-1009" name="__codelineno-0-1009"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1010"><a id="__codelineno-0-1010" name="__codelineno-0-1010"></a>    <span class="k">return</span> <span class="n">result</span><span class="o">.</span><span class="n">first</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-1000"><a id="__codelineno-0-1000" name="__codelineno-0-1000"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1001"><a id="__codelineno-0-1001" name="__codelineno-0-1001"></a><span class="sd">        exists = await user_crud.exists(db, age__gt=30)</span>
+</span><span id="__span-0-1002"><a id="__codelineno-0-1002" name="__codelineno-0-1002"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1003"><a id="__codelineno-0-1003" name="__codelineno-0-1003"></a>
+</span><span id="__span-0-1004"><a id="__codelineno-0-1004" name="__codelineno-0-1004"></a><span class="sd">        Check if any user was registered before Jan 1, 2020:</span>
+</span><span id="__span-0-1005"><a id="__codelineno-0-1005" name="__codelineno-0-1005"></a>
+</span><span id="__span-0-1006"><a id="__codelineno-0-1006" name="__codelineno-0-1006"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1007"><a id="__codelineno-0-1007" name="__codelineno-0-1007"></a><span class="sd">        exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))</span>
+</span><span id="__span-0-1008"><a id="__codelineno-0-1008" name="__codelineno-0-1008"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1009"><a id="__codelineno-0-1009" name="__codelineno-0-1009"></a>
+</span><span id="__span-0-1010"><a id="__codelineno-0-1010" name="__codelineno-0-1010"></a><span class="sd">        Check if a username other than `admin` exists:</span>
+</span><span id="__span-0-1011"><a id="__codelineno-0-1011" name="__codelineno-0-1011"></a>
+</span><span id="__span-0-1012"><a id="__codelineno-0-1012" name="__codelineno-0-1012"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1013"><a id="__codelineno-0-1013" name="__codelineno-0-1013"></a><span class="sd">        exists = await user_crud.exists(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-1014"><a id="__codelineno-0-1014" name="__codelineno-0-1014"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1015"><a id="__codelineno-0-1015" name="__codelineno-0-1015"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-1016"><a id="__codelineno-0-1016" name="__codelineno-0-1016"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1017"><a id="__codelineno-0-1017" name="__codelineno-0-1017"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="mi">1</span><span class="p">)</span>
+</span><span id="__span-0-1018"><a id="__codelineno-0-1018" name="__codelineno-0-1018"></a>
+</span><span id="__span-0-1019"><a id="__codelineno-0-1019" name="__codelineno-0-1019"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1020"><a id="__codelineno-0-1020" name="__codelineno-0-1020"></a>    <span class="k">return</span> <span class="n">result</span><span class="o">.</span><span class="n">first</span><span class="p">()</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -8536,7 +8630,7 @@ <h2 id="fastcrud.FastCRUD.get" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -8629,7 +8723,7 @@ <h2 id="fastcrud.FastCRUD.get" class="doc doc-heading">
     <tbody>
         <tr>
           <td>
-                <code><span title="typing.Optional">Optional</span>[<span title="typing.Union">Union</span>[dict, <span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[<span title="typing.Union">Union</span>[dict, <span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -8658,11 +8752,7 @@ <h2 id="fastcrud.FastCRUD.get" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-715">715</a></span>
-<span class="normal"><a href="#__codelineno-0-716">716</a></span>
-<span class="normal"><a href="#__codelineno-0-717">717</a></span>
-<span class="normal"><a href="#__codelineno-0-718">718</a></span>
-<span class="normal"><a href="#__codelineno-0-719">719</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-719">719</a></span>
 <span class="normal"><a href="#__codelineno-0-720">720</a></span>
 <span class="normal"><a href="#__codelineno-0-721">721</a></span>
 <span class="normal"><a href="#__codelineno-0-722">722</a></span>
@@ -8724,73 +8814,77 @@ <h2 id="fastcrud.FastCRUD.get" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-778">778</a></span>
 <span class="normal"><a href="#__codelineno-0-779">779</a></span>
 <span class="normal"><a href="#__codelineno-0-780">780</a></span>
-<span class="normal"><a href="#__codelineno-0-781">781</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get</span><span class="p">(</span>
-</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-718"><a id="__codelineno-0-718" name="__codelineno-0-718"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a>    <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]:</span>
-</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a><span class="sd">    Fetches a single record based on specified filters.</span>
-</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a>
-</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a><span class="sd">    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
-</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a>
-</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+<span class="normal"><a href="#__codelineno-0-781">781</a></span>
+<span class="normal"><a href="#__codelineno-0-782">782</a></span>
+<span class="normal"><a href="#__codelineno-0-783">783</a></span>
+<span class="normal"><a href="#__codelineno-0-784">784</a></span>
+<span class="normal"><a href="#__codelineno-0-785">785</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-719"><a id="__codelineno-0-719" name="__codelineno-0-719"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get</span><span class="p">(</span>
+</span><span id="__span-0-720"><a id="__codelineno-0-720" name="__codelineno-0-720"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-721"><a id="__codelineno-0-721" name="__codelineno-0-721"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-722"><a id="__codelineno-0-722" name="__codelineno-0-722"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-723"><a id="__codelineno-0-723" name="__codelineno-0-723"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-724"><a id="__codelineno-0-724" name="__codelineno-0-724"></a>    <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-725"><a id="__codelineno-0-725" name="__codelineno-0-725"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-726"><a id="__codelineno-0-726" name="__codelineno-0-726"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]:</span>
+</span><span id="__span-0-727"><a id="__codelineno-0-727" name="__codelineno-0-727"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-728"><a id="__codelineno-0-728" name="__codelineno-0-728"></a><span class="sd">    Fetches a single record based on specified filters.</span>
 </span><span id="__span-0-729"><a id="__codelineno-0-729" name="__codelineno-0-729"></a>
-</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns.</span>
-</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">        one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.</span>
-</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">        **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</span>
-</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a>
-</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
-</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a>
-</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a><span class="sd">        A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.</span>
-</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a>
-</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a><span class="sd">        Fetch a user by ID:</span>
-</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a>
-</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a><span class="sd">        user = await user_crud.get(db, id=1)</span>
-</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a><span class="sd">        ```</span>
+</span><span id="__span-0-730"><a id="__codelineno-0-730" name="__codelineno-0-730"></a><span class="sd">    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
+</span><span id="__span-0-731"><a id="__codelineno-0-731" name="__codelineno-0-731"></a>
+</span><span id="__span-0-732"><a id="__codelineno-0-732" name="__codelineno-0-732"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-733"><a id="__codelineno-0-733" name="__codelineno-0-733"></a>
+</span><span id="__span-0-734"><a id="__codelineno-0-734" name="__codelineno-0-734"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-735"><a id="__codelineno-0-735" name="__codelineno-0-735"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-736"><a id="__codelineno-0-736" name="__codelineno-0-736"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns.</span>
+</span><span id="__span-0-737"><a id="__codelineno-0-737" name="__codelineno-0-737"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-738"><a id="__codelineno-0-738" name="__codelineno-0-738"></a><span class="sd">        one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.</span>
+</span><span id="__span-0-739"><a id="__codelineno-0-739" name="__codelineno-0-739"></a><span class="sd">        **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</span>
+</span><span id="__span-0-740"><a id="__codelineno-0-740" name="__codelineno-0-740"></a>
+</span><span id="__span-0-741"><a id="__codelineno-0-741" name="__codelineno-0-741"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-742"><a id="__codelineno-0-742" name="__codelineno-0-742"></a><span class="sd">        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
+</span><span id="__span-0-743"><a id="__codelineno-0-743" name="__codelineno-0-743"></a>
+</span><span id="__span-0-744"><a id="__codelineno-0-744" name="__codelineno-0-744"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-745"><a id="__codelineno-0-745" name="__codelineno-0-745"></a><span class="sd">        A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.</span>
+</span><span id="__span-0-746"><a id="__codelineno-0-746" name="__codelineno-0-746"></a>
+</span><span id="__span-0-747"><a id="__codelineno-0-747" name="__codelineno-0-747"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-748"><a id="__codelineno-0-748" name="__codelineno-0-748"></a><span class="sd">        Fetch a user by ID:</span>
 </span><span id="__span-0-749"><a id="__codelineno-0-749" name="__codelineno-0-749"></a>
-</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a><span class="sd">        Fetch a user with an age greater than 30:</span>
-</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a>
-</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-753"><a id="__codelineno-0-753" name="__codelineno-0-753"></a><span class="sd">        user = await user_crud.get(db, age__gt=30)</span>
-</span><span id="__span-0-754"><a id="__codelineno-0-754" name="__codelineno-0-754"></a><span class="sd">        ```</span>
+</span><span id="__span-0-750"><a id="__codelineno-0-750" name="__codelineno-0-750"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-751"><a id="__codelineno-0-751" name="__codelineno-0-751"></a><span class="sd">        user = await user_crud.get(db, id=1)</span>
+</span><span id="__span-0-752"><a id="__codelineno-0-752" name="__codelineno-0-752"></a><span class="sd">        ```</span>
+</span><span id="__span-0-753"><a id="__codelineno-0-753" name="__codelineno-0-753"></a>
+</span><span id="__span-0-754"><a id="__codelineno-0-754" name="__codelineno-0-754"></a><span class="sd">        Fetch a user with an age greater than 30:</span>
 </span><span id="__span-0-755"><a id="__codelineno-0-755" name="__codelineno-0-755"></a>
-</span><span id="__span-0-756"><a id="__codelineno-0-756" name="__codelineno-0-756"></a><span class="sd">        Fetch a user with a registration date before Jan 1, 2020:</span>
-</span><span id="__span-0-757"><a id="__codelineno-0-757" name="__codelineno-0-757"></a>
-</span><span id="__span-0-758"><a id="__codelineno-0-758" name="__codelineno-0-758"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-759"><a id="__codelineno-0-759" name="__codelineno-0-759"></a><span class="sd">        user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))</span>
-</span><span id="__span-0-760"><a id="__codelineno-0-760" name="__codelineno-0-760"></a><span class="sd">        ```</span>
+</span><span id="__span-0-756"><a id="__codelineno-0-756" name="__codelineno-0-756"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-757"><a id="__codelineno-0-757" name="__codelineno-0-757"></a><span class="sd">        user = await user_crud.get(db, age__gt=30)</span>
+</span><span id="__span-0-758"><a id="__codelineno-0-758" name="__codelineno-0-758"></a><span class="sd">        ```</span>
+</span><span id="__span-0-759"><a id="__codelineno-0-759" name="__codelineno-0-759"></a>
+</span><span id="__span-0-760"><a id="__codelineno-0-760" name="__codelineno-0-760"></a><span class="sd">        Fetch a user with a registration date before Jan 1, 2020:</span>
 </span><span id="__span-0-761"><a id="__codelineno-0-761" name="__codelineno-0-761"></a>
-</span><span id="__span-0-762"><a id="__codelineno-0-762" name="__codelineno-0-762"></a><span class="sd">        Fetch a user not equal to a specific username:</span>
-</span><span id="__span-0-763"><a id="__codelineno-0-763" name="__codelineno-0-763"></a>
-</span><span id="__span-0-764"><a id="__codelineno-0-764" name="__codelineno-0-764"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-765"><a id="__codelineno-0-765" name="__codelineno-0-765"></a><span class="sd">        user = await user_crud.get(db, username__ne=&#39;admin&#39;)</span>
-</span><span id="__span-0-766"><a id="__codelineno-0-766" name="__codelineno-0-766"></a><span class="sd">        ```</span>
-</span><span id="__span-0-767"><a id="__codelineno-0-767" name="__codelineno-0-767"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-768"><a id="__codelineno-0-768" name="__codelineno-0-768"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-769"><a id="__codelineno-0-769" name="__codelineno-0-769"></a>
-</span><span id="__span-0-770"><a id="__codelineno-0-770" name="__codelineno-0-770"></a>    <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-771"><a id="__codelineno-0-771" name="__codelineno-0-771"></a>    <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-</span><span id="__span-0-772"><a id="__codelineno-0-772" name="__codelineno-0-772"></a>    <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-773"><a id="__codelineno-0-773" name="__codelineno-0-773"></a>        <span class="k">return</span> <span class="kc">None</span>
-</span><span id="__span-0-774"><a id="__codelineno-0-774" name="__codelineno-0-774"></a>    <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
-</span><span id="__span-0-775"><a id="__codelineno-0-775" name="__codelineno-0-775"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-776"><a id="__codelineno-0-776" name="__codelineno-0-776"></a>        <span class="k">return</span> <span class="n">out</span>
-</span><span id="__span-0-777"><a id="__codelineno-0-777" name="__codelineno-0-777"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
-</span><span id="__span-0-778"><a id="__codelineno-0-778" name="__codelineno-0-778"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-779"><a id="__codelineno-0-779" name="__codelineno-0-779"></a>            <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-780"><a id="__codelineno-0-780" name="__codelineno-0-780"></a>        <span class="p">)</span>
-</span><span id="__span-0-781"><a id="__codelineno-0-781" name="__codelineno-0-781"></a>    <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
+</span><span id="__span-0-762"><a id="__codelineno-0-762" name="__codelineno-0-762"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-763"><a id="__codelineno-0-763" name="__codelineno-0-763"></a><span class="sd">        user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))</span>
+</span><span id="__span-0-764"><a id="__codelineno-0-764" name="__codelineno-0-764"></a><span class="sd">        ```</span>
+</span><span id="__span-0-765"><a id="__codelineno-0-765" name="__codelineno-0-765"></a>
+</span><span id="__span-0-766"><a id="__codelineno-0-766" name="__codelineno-0-766"></a><span class="sd">        Fetch a user not equal to a specific username:</span>
+</span><span id="__span-0-767"><a id="__codelineno-0-767" name="__codelineno-0-767"></a>
+</span><span id="__span-0-768"><a id="__codelineno-0-768" name="__codelineno-0-768"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-769"><a id="__codelineno-0-769" name="__codelineno-0-769"></a><span class="sd">        user = await user_crud.get(db, username__ne=&#39;admin&#39;)</span>
+</span><span id="__span-0-770"><a id="__codelineno-0-770" name="__codelineno-0-770"></a><span class="sd">        ```</span>
+</span><span id="__span-0-771"><a id="__codelineno-0-771" name="__codelineno-0-771"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-772"><a id="__codelineno-0-772" name="__codelineno-0-772"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-773"><a id="__codelineno-0-773" name="__codelineno-0-773"></a>
+</span><span id="__span-0-774"><a id="__codelineno-0-774" name="__codelineno-0-774"></a>    <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-775"><a id="__codelineno-0-775" name="__codelineno-0-775"></a>    <span class="n">result</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Row</span><span class="p">]</span> <span class="o">=</span> <span class="n">db_row</span><span class="o">.</span><span class="n">one_or_none</span><span class="p">()</span> <span class="k">if</span> <span class="n">one_or_none</span> <span class="k">else</span> <span class="n">db_row</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+</span><span id="__span-0-776"><a id="__codelineno-0-776" name="__codelineno-0-776"></a>    <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-777"><a id="__codelineno-0-777" name="__codelineno-0-777"></a>        <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-778"><a id="__codelineno-0-778" name="__codelineno-0-778"></a>    <span class="n">out</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span>
+</span><span id="__span-0-779"><a id="__codelineno-0-779" name="__codelineno-0-779"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-780"><a id="__codelineno-0-780" name="__codelineno-0-780"></a>        <span class="k">return</span> <span class="n">out</span>
+</span><span id="__span-0-781"><a id="__codelineno-0-781" name="__codelineno-0-781"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
+</span><span id="__span-0-782"><a id="__codelineno-0-782" name="__codelineno-0-782"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-783"><a id="__codelineno-0-783" name="__codelineno-0-783"></a>            <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-784"><a id="__codelineno-0-784" name="__codelineno-0-784"></a>        <span class="p">)</span>
+</span><span id="__span-0-785"><a id="__codelineno-0-785" name="__codelineno-0-785"></a>    <span class="k">return</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">out</span><span class="p">)</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -8849,7 +8943,7 @@ <h2 id="fastcrud.FastCRUD.get_joined" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -8905,7 +8999,7 @@ <h2 id="fastcrud.FastCRUD.get_joined" class="doc doc-heading">
         <tr>
           <td><code>join_schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -9263,20 +9357,7 @@ <h2 id="fastcrud.FastCRUD.get_joined" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1277">1277</a></span>
-<span class="normal"><a href="#__codelineno-0-1278">1278</a></span>
-<span class="normal"><a href="#__codelineno-0-1279">1279</a></span>
-<span class="normal"><a href="#__codelineno-0-1280">1280</a></span>
-<span class="normal"><a href="#__codelineno-0-1281">1281</a></span>
-<span class="normal"><a href="#__codelineno-0-1282">1282</a></span>
-<span class="normal"><a href="#__codelineno-0-1283">1283</a></span>
-<span class="normal"><a href="#__codelineno-0-1284">1284</a></span>
-<span class="normal"><a href="#__codelineno-0-1285">1285</a></span>
-<span class="normal"><a href="#__codelineno-0-1286">1286</a></span>
-<span class="normal"><a href="#__codelineno-0-1287">1287</a></span>
-<span class="normal"><a href="#__codelineno-0-1288">1288</a></span>
-<span class="normal"><a href="#__codelineno-0-1289">1289</a></span>
-<span class="normal"><a href="#__codelineno-0-1290">1290</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1290">1290</a></span>
 <span class="normal"><a href="#__codelineno-0-1291">1291</a></span>
 <span class="normal"><a href="#__codelineno-0-1292">1292</a></span>
 <span class="normal"><a href="#__codelineno-0-1293">1293</a></span>
@@ -9577,321 +9658,334 @@ <h2 id="fastcrud.FastCRUD.get_joined" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-1588">1588</a></span>
 <span class="normal"><a href="#__codelineno-0-1589">1589</a></span>
 <span class="normal"><a href="#__codelineno-0-1590">1590</a></span>
-<span class="normal"><a href="#__codelineno-0-1591">1591</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1277"><a id="__codelineno-0-1277" name="__codelineno-0-1277"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_joined</span><span class="p">(</span>
-</span><span id="__span-0-1278"><a id="__codelineno-0-1278" name="__codelineno-0-1278"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1279"><a id="__codelineno-0-1279" name="__codelineno-0-1279"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1280"><a id="__codelineno-0-1280" name="__codelineno-0-1280"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1281"><a id="__codelineno-0-1281" name="__codelineno-0-1281"></a>    <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1282"><a id="__codelineno-0-1282" name="__codelineno-0-1282"></a>    <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">Join</span><span class="p">,</span> <span class="n">BinaryExpression</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1283"><a id="__codelineno-0-1283" name="__codelineno-0-1283"></a>    <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1284"><a id="__codelineno-0-1284" name="__codelineno-0-1284"></a>    <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1285"><a id="__codelineno-0-1285" name="__codelineno-0-1285"></a>    <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
-</span><span id="__span-0-1286"><a id="__codelineno-0-1286" name="__codelineno-0-1286"></a>    <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1287"><a id="__codelineno-0-1287" name="__codelineno-0-1287"></a>    <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1288"><a id="__codelineno-0-1288" name="__codelineno-0-1288"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1289"><a id="__codelineno-0-1289" name="__codelineno-0-1289"></a>    <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1290"><a id="__codelineno-0-1290" name="__codelineno-0-1290"></a>    <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1291"><a id="__codelineno-0-1291" name="__codelineno-0-1291"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1292"><a id="__codelineno-0-1292" name="__codelineno-0-1292"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
-</span><span id="__span-0-1293"><a id="__codelineno-0-1293" name="__codelineno-0-1293"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1294"><a id="__codelineno-0-1294" name="__codelineno-0-1294"></a><span class="sd">    Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts</span>
-</span><span id="__span-0-1295"><a id="__codelineno-0-1295" name="__codelineno-0-1295"></a><span class="sd">    to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to</span>
-</span><span id="__span-0-1296"><a id="__codelineno-0-1296" name="__codelineno-0-1296"></a><span class="sd">    specify each join configuration.</span>
-</span><span id="__span-0-1297"><a id="__codelineno-0-1297" name="__codelineno-0-1297"></a>
-</span><span id="__span-0-1298"><a id="__codelineno-0-1298" name="__codelineno-0-1298"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1299"><a id="__codelineno-0-1299" name="__codelineno-0-1299"></a>
-</span><span id="__span-0-1300"><a id="__codelineno-0-1300" name="__codelineno-0-1300"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-1301"><a id="__codelineno-0-1301" name="__codelineno-0-1301"></a><span class="sd">        db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-1302"><a id="__codelineno-0-1302" name="__codelineno-0-1302"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1303"><a id="__codelineno-0-1303" name="__codelineno-0-1303"></a><span class="sd">        join_model: The model to join with.</span>
-</span><span id="__span-0-1304"><a id="__codelineno-0-1304" name="__codelineno-0-1304"></a><span class="sd">        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
-</span><span id="__span-0-1305"><a id="__codelineno-0-1305" name="__codelineno-0-1305"></a><span class="sd">        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
-</span><span id="__span-0-1306"><a id="__codelineno-0-1306" name="__codelineno-0-1306"></a><span class="sd">        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
-</span><span id="__span-0-1307"><a id="__codelineno-0-1307" name="__codelineno-0-1307"></a><span class="sd">        join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
-</span><span id="__span-0-1308"><a id="__codelineno-0-1308" name="__codelineno-0-1308"></a><span class="sd">        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
-</span><span id="__span-0-1309"><a id="__codelineno-0-1309" name="__codelineno-0-1309"></a><span class="sd">        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
-</span><span id="__span-0-1310"><a id="__codelineno-0-1310" name="__codelineno-0-1310"></a><span class="sd">        joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</span>
-</span><span id="__span-0-1311"><a id="__codelineno-0-1311" name="__codelineno-0-1311"></a><span class="sd">        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
-</span><span id="__span-0-1312"><a id="__codelineno-0-1312" name="__codelineno-0-1312"></a><span class="sd">        relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
-</span><span id="__span-0-1313"><a id="__codelineno-0-1313" name="__codelineno-0-1313"></a><span class="sd">        **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</span>
-</span><span id="__span-0-1314"><a id="__codelineno-0-1314" name="__codelineno-0-1314"></a>
-</span><span id="__span-0-1315"><a id="__codelineno-0-1315" name="__codelineno-0-1315"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-1316"><a id="__codelineno-0-1316" name="__codelineno-0-1316"></a><span class="sd">        A dictionary representing the joined record, or `None` if no record matches the criteria.</span>
-</span><span id="__span-0-1317"><a id="__codelineno-0-1317" name="__codelineno-0-1317"></a>
-</span><span id="__span-0-1318"><a id="__codelineno-0-1318" name="__codelineno-0-1318"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-1319"><a id="__codelineno-0-1319" name="__codelineno-0-1319"></a><span class="sd">        ValueError: If both single join parameters and `joins_config` are used simultaneously.</span>
-</span><span id="__span-0-1320"><a id="__codelineno-0-1320" name="__codelineno-0-1320"></a><span class="sd">        ArgumentError: If any provided model in `joins_config` is not recognized or invalid.</span>
-</span><span id="__span-0-1321"><a id="__codelineno-0-1321" name="__codelineno-0-1321"></a><span class="sd">        NoResultFound: If no record matches the criteria with the provided filters.</span>
-</span><span id="__span-0-1322"><a id="__codelineno-0-1322" name="__codelineno-0-1322"></a>
-</span><span id="__span-0-1323"><a id="__codelineno-0-1323" name="__codelineno-0-1323"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-1324"><a id="__codelineno-0-1324" name="__codelineno-0-1324"></a><span class="sd">        Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`</span>
-</span><span id="__span-0-1325"><a id="__codelineno-0-1325" name="__codelineno-0-1325"></a>
-</span><span id="__span-0-1326"><a id="__codelineno-0-1326" name="__codelineno-0-1326"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1327"><a id="__codelineno-0-1327" name="__codelineno-0-1327"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1328"><a id="__codelineno-0-1328" name="__codelineno-0-1328"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1329"><a id="__codelineno-0-1329" name="__codelineno-0-1329"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1330"><a id="__codelineno-0-1330" name="__codelineno-0-1330"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1331"><a id="__codelineno-0-1331" name="__codelineno-0-1331"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1332"><a id="__codelineno-0-1332" name="__codelineno-0-1332"></a><span class="sd">        )</span>
-</span><span id="__span-0-1333"><a id="__codelineno-0-1333" name="__codelineno-0-1333"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1334"><a id="__codelineno-0-1334" name="__codelineno-0-1334"></a>
-</span><span id="__span-0-1335"><a id="__codelineno-0-1335" name="__codelineno-0-1335"></a><span class="sd">        Fetch a user and their associated tier, filtering by user ID:</span>
-</span><span id="__span-0-1336"><a id="__codelineno-0-1336" name="__codelineno-0-1336"></a>
-</span><span id="__span-0-1337"><a id="__codelineno-0-1337" name="__codelineno-0-1337"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1338"><a id="__codelineno-0-1338" name="__codelineno-0-1338"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1339"><a id="__codelineno-0-1339" name="__codelineno-0-1339"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1340"><a id="__codelineno-0-1340" name="__codelineno-0-1340"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1341"><a id="__codelineno-0-1341" name="__codelineno-0-1341"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1342"><a id="__codelineno-0-1342" name="__codelineno-0-1342"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1343"><a id="__codelineno-0-1343" name="__codelineno-0-1343"></a><span class="sd">            id=1,</span>
-</span><span id="__span-0-1344"><a id="__codelineno-0-1344" name="__codelineno-0-1344"></a><span class="sd">        )</span>
-</span><span id="__span-0-1345"><a id="__codelineno-0-1345" name="__codelineno-0-1345"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1346"><a id="__codelineno-0-1346" name="__codelineno-0-1346"></a>
-</span><span id="__span-0-1347"><a id="__codelineno-0-1347" name="__codelineno-0-1347"></a><span class="sd">        Fetch a user and their associated tier, where the user&#39;s age is greater than 30:</span>
-</span><span id="__span-0-1348"><a id="__codelineno-0-1348" name="__codelineno-0-1348"></a>
-</span><span id="__span-0-1349"><a id="__codelineno-0-1349" name="__codelineno-0-1349"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1350"><a id="__codelineno-0-1350" name="__codelineno-0-1350"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1351"><a id="__codelineno-0-1351" name="__codelineno-0-1351"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1352"><a id="__codelineno-0-1352" name="__codelineno-0-1352"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1353"><a id="__codelineno-0-1353" name="__codelineno-0-1353"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1354"><a id="__codelineno-0-1354" name="__codelineno-0-1354"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1355"><a id="__codelineno-0-1355" name="__codelineno-0-1355"></a><span class="sd">            age__gt=30,</span>
-</span><span id="__span-0-1356"><a id="__codelineno-0-1356" name="__codelineno-0-1356"></a><span class="sd">        )</span>
-</span><span id="__span-0-1357"><a id="__codelineno-0-1357" name="__codelineno-0-1357"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1358"><a id="__codelineno-0-1358" name="__codelineno-0-1358"></a>
-</span><span id="__span-0-1359"><a id="__codelineno-0-1359" name="__codelineno-0-1359"></a><span class="sd">        Fetch a user and their associated tier, excluding users with the `admin` username:</span>
-</span><span id="__span-0-1360"><a id="__codelineno-0-1360" name="__codelineno-0-1360"></a>
-</span><span id="__span-0-1361"><a id="__codelineno-0-1361" name="__codelineno-0-1361"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1362"><a id="__codelineno-0-1362" name="__codelineno-0-1362"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1363"><a id="__codelineno-0-1363" name="__codelineno-0-1363"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1364"><a id="__codelineno-0-1364" name="__codelineno-0-1364"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1365"><a id="__codelineno-0-1365" name="__codelineno-0-1365"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1366"><a id="__codelineno-0-1366" name="__codelineno-0-1366"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1367"><a id="__codelineno-0-1367" name="__codelineno-0-1367"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
-</span><span id="__span-0-1368"><a id="__codelineno-0-1368" name="__codelineno-0-1368"></a><span class="sd">        )</span>
-</span><span id="__span-0-1369"><a id="__codelineno-0-1369" name="__codelineno-0-1369"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1370"><a id="__codelineno-0-1370" name="__codelineno-0-1370"></a>
-</span><span id="__span-0-1371"><a id="__codelineno-0-1371" name="__codelineno-0-1371"></a><span class="sd">        Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</span>
-</span><span id="__span-0-1372"><a id="__codelineno-0-1372" name="__codelineno-0-1372"></a>
-</span><span id="__span-0-1373"><a id="__codelineno-0-1373" name="__codelineno-0-1373"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1374"><a id="__codelineno-0-1374" name="__codelineno-0-1374"></a><span class="sd">        from sqlalchemy import and_</span>
+<span class="normal"><a href="#__codelineno-0-1591">1591</a></span>
+<span class="normal"><a href="#__codelineno-0-1592">1592</a></span>
+<span class="normal"><a href="#__codelineno-0-1593">1593</a></span>
+<span class="normal"><a href="#__codelineno-0-1594">1594</a></span>
+<span class="normal"><a href="#__codelineno-0-1595">1595</a></span>
+<span class="normal"><a href="#__codelineno-0-1596">1596</a></span>
+<span class="normal"><a href="#__codelineno-0-1597">1597</a></span>
+<span class="normal"><a href="#__codelineno-0-1598">1598</a></span>
+<span class="normal"><a href="#__codelineno-0-1599">1599</a></span>
+<span class="normal"><a href="#__codelineno-0-1600">1600</a></span>
+<span class="normal"><a href="#__codelineno-0-1601">1601</a></span>
+<span class="normal"><a href="#__codelineno-0-1602">1602</a></span>
+<span class="normal"><a href="#__codelineno-0-1603">1603</a></span>
+<span class="normal"><a href="#__codelineno-0-1604">1604</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1290"><a id="__codelineno-0-1290" name="__codelineno-0-1290"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_joined</span><span class="p">(</span>
+</span><span id="__span-0-1291"><a id="__codelineno-0-1291" name="__codelineno-0-1291"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1292"><a id="__codelineno-0-1292" name="__codelineno-0-1292"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1293"><a id="__codelineno-0-1293" name="__codelineno-0-1293"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1294"><a id="__codelineno-0-1294" name="__codelineno-0-1294"></a>    <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1295"><a id="__codelineno-0-1295" name="__codelineno-0-1295"></a>    <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">Join</span><span class="p">,</span> <span class="n">BinaryExpression</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1296"><a id="__codelineno-0-1296" name="__codelineno-0-1296"></a>    <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1297"><a id="__codelineno-0-1297" name="__codelineno-0-1297"></a>    <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1298"><a id="__codelineno-0-1298" name="__codelineno-0-1298"></a>    <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
+</span><span id="__span-0-1299"><a id="__codelineno-0-1299" name="__codelineno-0-1299"></a>    <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1300"><a id="__codelineno-0-1300" name="__codelineno-0-1300"></a>    <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1301"><a id="__codelineno-0-1301" name="__codelineno-0-1301"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1302"><a id="__codelineno-0-1302" name="__codelineno-0-1302"></a>    <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1303"><a id="__codelineno-0-1303" name="__codelineno-0-1303"></a>    <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1304"><a id="__codelineno-0-1304" name="__codelineno-0-1304"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1305"><a id="__codelineno-0-1305" name="__codelineno-0-1305"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
+</span><span id="__span-0-1306"><a id="__codelineno-0-1306" name="__codelineno-0-1306"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1307"><a id="__codelineno-0-1307" name="__codelineno-0-1307"></a><span class="sd">    Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts</span>
+</span><span id="__span-0-1308"><a id="__codelineno-0-1308" name="__codelineno-0-1308"></a><span class="sd">    to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to</span>
+</span><span id="__span-0-1309"><a id="__codelineno-0-1309" name="__codelineno-0-1309"></a><span class="sd">    specify each join configuration.</span>
+</span><span id="__span-0-1310"><a id="__codelineno-0-1310" name="__codelineno-0-1310"></a>
+</span><span id="__span-0-1311"><a id="__codelineno-0-1311" name="__codelineno-0-1311"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1312"><a id="__codelineno-0-1312" name="__codelineno-0-1312"></a>
+</span><span id="__span-0-1313"><a id="__codelineno-0-1313" name="__codelineno-0-1313"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-1314"><a id="__codelineno-0-1314" name="__codelineno-0-1314"></a><span class="sd">        db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-1315"><a id="__codelineno-0-1315" name="__codelineno-0-1315"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1316"><a id="__codelineno-0-1316" name="__codelineno-0-1316"></a><span class="sd">        join_model: The model to join with.</span>
+</span><span id="__span-0-1317"><a id="__codelineno-0-1317" name="__codelineno-0-1317"></a><span class="sd">        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
+</span><span id="__span-0-1318"><a id="__codelineno-0-1318" name="__codelineno-0-1318"></a><span class="sd">        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
+</span><span id="__span-0-1319"><a id="__codelineno-0-1319" name="__codelineno-0-1319"></a><span class="sd">        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
+</span><span id="__span-0-1320"><a id="__codelineno-0-1320" name="__codelineno-0-1320"></a><span class="sd">        join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
+</span><span id="__span-0-1321"><a id="__codelineno-0-1321" name="__codelineno-0-1321"></a><span class="sd">        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
+</span><span id="__span-0-1322"><a id="__codelineno-0-1322" name="__codelineno-0-1322"></a><span class="sd">        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
+</span><span id="__span-0-1323"><a id="__codelineno-0-1323" name="__codelineno-0-1323"></a><span class="sd">        joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</span>
+</span><span id="__span-0-1324"><a id="__codelineno-0-1324" name="__codelineno-0-1324"></a><span class="sd">        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
+</span><span id="__span-0-1325"><a id="__codelineno-0-1325" name="__codelineno-0-1325"></a><span class="sd">        relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
+</span><span id="__span-0-1326"><a id="__codelineno-0-1326" name="__codelineno-0-1326"></a><span class="sd">        **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</span>
+</span><span id="__span-0-1327"><a id="__codelineno-0-1327" name="__codelineno-0-1327"></a>
+</span><span id="__span-0-1328"><a id="__codelineno-0-1328" name="__codelineno-0-1328"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-1329"><a id="__codelineno-0-1329" name="__codelineno-0-1329"></a><span class="sd">        A dictionary representing the joined record, or `None` if no record matches the criteria.</span>
+</span><span id="__span-0-1330"><a id="__codelineno-0-1330" name="__codelineno-0-1330"></a>
+</span><span id="__span-0-1331"><a id="__codelineno-0-1331" name="__codelineno-0-1331"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-1332"><a id="__codelineno-0-1332" name="__codelineno-0-1332"></a><span class="sd">        ValueError: If both single join parameters and `joins_config` are used simultaneously.</span>
+</span><span id="__span-0-1333"><a id="__codelineno-0-1333" name="__codelineno-0-1333"></a><span class="sd">        ArgumentError: If any provided model in `joins_config` is not recognized or invalid.</span>
+</span><span id="__span-0-1334"><a id="__codelineno-0-1334" name="__codelineno-0-1334"></a><span class="sd">        NoResultFound: If no record matches the criteria with the provided filters.</span>
+</span><span id="__span-0-1335"><a id="__codelineno-0-1335" name="__codelineno-0-1335"></a>
+</span><span id="__span-0-1336"><a id="__codelineno-0-1336" name="__codelineno-0-1336"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-1337"><a id="__codelineno-0-1337" name="__codelineno-0-1337"></a><span class="sd">        Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`</span>
+</span><span id="__span-0-1338"><a id="__codelineno-0-1338" name="__codelineno-0-1338"></a>
+</span><span id="__span-0-1339"><a id="__codelineno-0-1339" name="__codelineno-0-1339"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1340"><a id="__codelineno-0-1340" name="__codelineno-0-1340"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1341"><a id="__codelineno-0-1341" name="__codelineno-0-1341"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1342"><a id="__codelineno-0-1342" name="__codelineno-0-1342"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1343"><a id="__codelineno-0-1343" name="__codelineno-0-1343"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1344"><a id="__codelineno-0-1344" name="__codelineno-0-1344"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1345"><a id="__codelineno-0-1345" name="__codelineno-0-1345"></a><span class="sd">        )</span>
+</span><span id="__span-0-1346"><a id="__codelineno-0-1346" name="__codelineno-0-1346"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1347"><a id="__codelineno-0-1347" name="__codelineno-0-1347"></a>
+</span><span id="__span-0-1348"><a id="__codelineno-0-1348" name="__codelineno-0-1348"></a><span class="sd">        Fetch a user and their associated tier, filtering by user ID:</span>
+</span><span id="__span-0-1349"><a id="__codelineno-0-1349" name="__codelineno-0-1349"></a>
+</span><span id="__span-0-1350"><a id="__codelineno-0-1350" name="__codelineno-0-1350"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1351"><a id="__codelineno-0-1351" name="__codelineno-0-1351"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1352"><a id="__codelineno-0-1352" name="__codelineno-0-1352"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1353"><a id="__codelineno-0-1353" name="__codelineno-0-1353"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1354"><a id="__codelineno-0-1354" name="__codelineno-0-1354"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1355"><a id="__codelineno-0-1355" name="__codelineno-0-1355"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1356"><a id="__codelineno-0-1356" name="__codelineno-0-1356"></a><span class="sd">            id=1,</span>
+</span><span id="__span-0-1357"><a id="__codelineno-0-1357" name="__codelineno-0-1357"></a><span class="sd">        )</span>
+</span><span id="__span-0-1358"><a id="__codelineno-0-1358" name="__codelineno-0-1358"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1359"><a id="__codelineno-0-1359" name="__codelineno-0-1359"></a>
+</span><span id="__span-0-1360"><a id="__codelineno-0-1360" name="__codelineno-0-1360"></a><span class="sd">        Fetch a user and their associated tier, where the user&#39;s age is greater than 30:</span>
+</span><span id="__span-0-1361"><a id="__codelineno-0-1361" name="__codelineno-0-1361"></a>
+</span><span id="__span-0-1362"><a id="__codelineno-0-1362" name="__codelineno-0-1362"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1363"><a id="__codelineno-0-1363" name="__codelineno-0-1363"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1364"><a id="__codelineno-0-1364" name="__codelineno-0-1364"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1365"><a id="__codelineno-0-1365" name="__codelineno-0-1365"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1366"><a id="__codelineno-0-1366" name="__codelineno-0-1366"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1367"><a id="__codelineno-0-1367" name="__codelineno-0-1367"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1368"><a id="__codelineno-0-1368" name="__codelineno-0-1368"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-1369"><a id="__codelineno-0-1369" name="__codelineno-0-1369"></a><span class="sd">        )</span>
+</span><span id="__span-0-1370"><a id="__codelineno-0-1370" name="__codelineno-0-1370"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1371"><a id="__codelineno-0-1371" name="__codelineno-0-1371"></a>
+</span><span id="__span-0-1372"><a id="__codelineno-0-1372" name="__codelineno-0-1372"></a><span class="sd">        Fetch a user and their associated tier, excluding users with the `admin` username:</span>
+</span><span id="__span-0-1373"><a id="__codelineno-0-1373" name="__codelineno-0-1373"></a>
+</span><span id="__span-0-1374"><a id="__codelineno-0-1374" name="__codelineno-0-1374"></a><span class="sd">        ```python</span>
 </span><span id="__span-0-1375"><a id="__codelineno-0-1375" name="__codelineno-0-1375"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1376"><a id="__codelineno-0-1376" name="__codelineno-0-1376"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1376"><a id="__codelineno-0-1376" name="__codelineno-0-1376"></a><span class="sd">            db,</span>
 </span><span id="__span-0-1377"><a id="__codelineno-0-1377" name="__codelineno-0-1377"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
 </span><span id="__span-0-1378"><a id="__codelineno-0-1378" name="__codelineno-0-1378"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1379"><a id="__codelineno-0-1379" name="__codelineno-0-1379"></a><span class="sd">            join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),</span>
-</span><span id="__span-0-1380"><a id="__codelineno-0-1380" name="__codelineno-0-1380"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1381"><a id="__codelineno-0-1381" name="__codelineno-0-1381"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1382"><a id="__codelineno-0-1382" name="__codelineno-0-1382"></a><span class="sd">            username=&quot;john_doe&quot;,</span>
-</span><span id="__span-0-1383"><a id="__codelineno-0-1383" name="__codelineno-0-1383"></a><span class="sd">        )</span>
-</span><span id="__span-0-1384"><a id="__codelineno-0-1384" name="__codelineno-0-1384"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1379"><a id="__codelineno-0-1379" name="__codelineno-0-1379"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1380"><a id="__codelineno-0-1380" name="__codelineno-0-1380"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1381"><a id="__codelineno-0-1381" name="__codelineno-0-1381"></a><span class="sd">        )</span>
+</span><span id="__span-0-1382"><a id="__codelineno-0-1382" name="__codelineno-0-1382"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1383"><a id="__codelineno-0-1383" name="__codelineno-0-1383"></a>
+</span><span id="__span-0-1384"><a id="__codelineno-0-1384" name="__codelineno-0-1384"></a><span class="sd">        Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</span>
 </span><span id="__span-0-1385"><a id="__codelineno-0-1385" name="__codelineno-0-1385"></a>
-</span><span id="__span-0-1386"><a id="__codelineno-0-1386" name="__codelineno-0-1386"></a><span class="sd">        Example of using `joins_config` for multiple joins:</span>
-</span><span id="__span-0-1387"><a id="__codelineno-0-1387" name="__codelineno-0-1387"></a>
-</span><span id="__span-0-1388"><a id="__codelineno-0-1388" name="__codelineno-0-1388"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1389"><a id="__codelineno-0-1389" name="__codelineno-0-1389"></a><span class="sd">        from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1390"><a id="__codelineno-0-1390" name="__codelineno-0-1390"></a>
-</span><span id="__span-0-1391"><a id="__codelineno-0-1391" name="__codelineno-0-1391"></a><span class="sd">        # Using same User/Tier/Department models/schemas as above.</span>
-</span><span id="__span-0-1392"><a id="__codelineno-0-1392" name="__codelineno-0-1392"></a>
-</span><span id="__span-0-1393"><a id="__codelineno-0-1393" name="__codelineno-0-1393"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1394"><a id="__codelineno-0-1394" name="__codelineno-0-1394"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1395"><a id="__codelineno-0-1395" name="__codelineno-0-1395"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1396"><a id="__codelineno-0-1396" name="__codelineno-0-1396"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1397"><a id="__codelineno-0-1397" name="__codelineno-0-1397"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1398"><a id="__codelineno-0-1398" name="__codelineno-0-1398"></a><span class="sd">                    model=Tier,</span>
-</span><span id="__span-0-1399"><a id="__codelineno-0-1399" name="__codelineno-0-1399"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1400"><a id="__codelineno-0-1400" name="__codelineno-0-1400"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1401"><a id="__codelineno-0-1401" name="__codelineno-0-1401"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1402"><a id="__codelineno-0-1402" name="__codelineno-0-1402"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1403"><a id="__codelineno-0-1403" name="__codelineno-0-1403"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1404"><a id="__codelineno-0-1404" name="__codelineno-0-1404"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1405"><a id="__codelineno-0-1405" name="__codelineno-0-1405"></a><span class="sd">                    model=Department,</span>
-</span><span id="__span-0-1406"><a id="__codelineno-0-1406" name="__codelineno-0-1406"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1407"><a id="__codelineno-0-1407" name="__codelineno-0-1407"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1408"><a id="__codelineno-0-1408" name="__codelineno-0-1408"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1409"><a id="__codelineno-0-1409" name="__codelineno-0-1409"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1410"><a id="__codelineno-0-1410" name="__codelineno-0-1410"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1411"><a id="__codelineno-0-1411" name="__codelineno-0-1411"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1412"><a id="__codelineno-0-1412" name="__codelineno-0-1412"></a><span class="sd">        )</span>
-</span><span id="__span-0-1413"><a id="__codelineno-0-1413" name="__codelineno-0-1413"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1414"><a id="__codelineno-0-1414" name="__codelineno-0-1414"></a>
-</span><span id="__span-0-1415"><a id="__codelineno-0-1415" name="__codelineno-0-1415"></a><span class="sd">        Using `alias` for joining the same model multiple times:</span>
-</span><span id="__span-0-1416"><a id="__codelineno-0-1416" name="__codelineno-0-1416"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1417"><a id="__codelineno-0-1417" name="__codelineno-0-1417"></a><span class="sd">        from fastcrud import aliased</span>
-</span><span id="__span-0-1418"><a id="__codelineno-0-1418" name="__codelineno-0-1418"></a>
-</span><span id="__span-0-1419"><a id="__codelineno-0-1419" name="__codelineno-0-1419"></a><span class="sd">        owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
-</span><span id="__span-0-1420"><a id="__codelineno-0-1420" name="__codelineno-0-1420"></a><span class="sd">        user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
-</span><span id="__span-0-1421"><a id="__codelineno-0-1421" name="__codelineno-0-1421"></a>
-</span><span id="__span-0-1422"><a id="__codelineno-0-1422" name="__codelineno-0-1422"></a><span class="sd">        result = await crud.get_joined(</span>
-</span><span id="__span-0-1423"><a id="__codelineno-0-1423" name="__codelineno-0-1423"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1424"><a id="__codelineno-0-1424" name="__codelineno-0-1424"></a><span class="sd">            schema_to_select=BookingSchema,</span>
-</span><span id="__span-0-1425"><a id="__codelineno-0-1425" name="__codelineno-0-1425"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1426"><a id="__codelineno-0-1426" name="__codelineno-0-1426"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1427"><a id="__codelineno-0-1427" name="__codelineno-0-1427"></a><span class="sd">                    model=ModelTest,</span>
-</span><span id="__span-0-1428"><a id="__codelineno-0-1428" name="__codelineno-0-1428"></a><span class="sd">                    join_on=BookingModel.owner_id == owner_alias.id,</span>
-</span><span id="__span-0-1429"><a id="__codelineno-0-1429" name="__codelineno-0-1429"></a><span class="sd">                    join_prefix=&quot;owner_&quot;,</span>
-</span><span id="__span-0-1430"><a id="__codelineno-0-1430" name="__codelineno-0-1430"></a><span class="sd">                    alias=owner_alias,</span>
-</span><span id="__span-0-1431"><a id="__codelineno-0-1431" name="__codelineno-0-1431"></a><span class="sd">                    schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1432"><a id="__codelineno-0-1432" name="__codelineno-0-1432"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1433"><a id="__codelineno-0-1433" name="__codelineno-0-1433"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1434"><a id="__codelineno-0-1434" name="__codelineno-0-1434"></a><span class="sd">                    model=ModelTest,</span>
-</span><span id="__span-0-1435"><a id="__codelineno-0-1435" name="__codelineno-0-1435"></a><span class="sd">                    join_on=BookingModel.user_id == user_alias.id,</span>
-</span><span id="__span-0-1436"><a id="__codelineno-0-1436" name="__codelineno-0-1436"></a><span class="sd">                    join_prefix=&quot;user_&quot;,</span>
-</span><span id="__span-0-1437"><a id="__codelineno-0-1437" name="__codelineno-0-1437"></a><span class="sd">                    alias=user_alias,</span>
-</span><span id="__span-0-1438"><a id="__codelineno-0-1438" name="__codelineno-0-1438"></a><span class="sd">                    schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1439"><a id="__codelineno-0-1439" name="__codelineno-0-1439"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1440"><a id="__codelineno-0-1440" name="__codelineno-0-1440"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1441"><a id="__codelineno-0-1441" name="__codelineno-0-1441"></a><span class="sd">            id=1,</span>
-</span><span id="__span-0-1442"><a id="__codelineno-0-1442" name="__codelineno-0-1442"></a><span class="sd">        )</span>
-</span><span id="__span-0-1443"><a id="__codelineno-0-1443" name="__codelineno-0-1443"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1444"><a id="__codelineno-0-1444" name="__codelineno-0-1444"></a>
-</span><span id="__span-0-1445"><a id="__codelineno-0-1445" name="__codelineno-0-1445"></a><span class="sd">        Fetching a single project and its associated participants where a participant has a specific role:</span>
-</span><span id="__span-0-1446"><a id="__codelineno-0-1446" name="__codelineno-0-1446"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1447"><a id="__codelineno-0-1447" name="__codelineno-0-1447"></a><span class="sd">        joins_config = [</span>
-</span><span id="__span-0-1448"><a id="__codelineno-0-1448" name="__codelineno-0-1448"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1449"><a id="__codelineno-0-1449" name="__codelineno-0-1449"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1450"><a id="__codelineno-0-1450" name="__codelineno-0-1450"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1451"><a id="__codelineno-0-1451" name="__codelineno-0-1451"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1452"><a id="__codelineno-0-1452" name="__codelineno-0-1452"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1453"><a id="__codelineno-0-1453" name="__codelineno-0-1453"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1454"><a id="__codelineno-0-1454" name="__codelineno-0-1454"></a><span class="sd">                model=Participant,</span>
-</span><span id="__span-0-1455"><a id="__codelineno-0-1455" name="__codelineno-0-1455"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1456"><a id="__codelineno-0-1456" name="__codelineno-0-1456"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1457"><a id="__codelineno-0-1457" name="__codelineno-0-1457"></a><span class="sd">                filters={&#39;role&#39;: &#39;Designer&#39;},</span>
-</span><span id="__span-0-1458"><a id="__codelineno-0-1458" name="__codelineno-0-1458"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1459"><a id="__codelineno-0-1459" name="__codelineno-0-1459"></a><span class="sd">        ]</span>
-</span><span id="__span-0-1460"><a id="__codelineno-0-1460" name="__codelineno-0-1460"></a><span class="sd">        project = await crud.get_joined(</span>
-</span><span id="__span-0-1461"><a id="__codelineno-0-1461" name="__codelineno-0-1461"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1462"><a id="__codelineno-0-1462" name="__codelineno-0-1462"></a><span class="sd">            schema_to_select=ProjectSchema,</span>
-</span><span id="__span-0-1463"><a id="__codelineno-0-1463" name="__codelineno-0-1463"></a><span class="sd">            joins_config=joins_config,</span>
-</span><span id="__span-0-1464"><a id="__codelineno-0-1464" name="__codelineno-0-1464"></a><span class="sd">        )</span>
-</span><span id="__span-0-1465"><a id="__codelineno-0-1465" name="__codelineno-0-1465"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1466"><a id="__codelineno-0-1466" name="__codelineno-0-1466"></a>
-</span><span id="__span-0-1467"><a id="__codelineno-0-1467" name="__codelineno-0-1467"></a><span class="sd">        Example of using `joins_config` for multiple joins with nested joins enabled:</span>
-</span><span id="__span-0-1468"><a id="__codelineno-0-1468" name="__codelineno-0-1468"></a>
-</span><span id="__span-0-1469"><a id="__codelineno-0-1469" name="__codelineno-0-1469"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1470"><a id="__codelineno-0-1470" name="__codelineno-0-1470"></a><span class="sd">        from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1471"><a id="__codelineno-0-1471" name="__codelineno-0-1471"></a>
-</span><span id="__span-0-1472"><a id="__codelineno-0-1472" name="__codelineno-0-1472"></a><span class="sd">        result = await user_crud.get_joined(</span>
-</span><span id="__span-0-1473"><a id="__codelineno-0-1473" name="__codelineno-0-1473"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1474"><a id="__codelineno-0-1474" name="__codelineno-0-1474"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1475"><a id="__codelineno-0-1475" name="__codelineno-0-1475"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1476"><a id="__codelineno-0-1476" name="__codelineno-0-1476"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1477"><a id="__codelineno-0-1477" name="__codelineno-0-1477"></a><span class="sd">                    model=Tier,</span>
-</span><span id="__span-0-1478"><a id="__codelineno-0-1478" name="__codelineno-0-1478"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1479"><a id="__codelineno-0-1479" name="__codelineno-0-1479"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1480"><a id="__codelineno-0-1480" name="__codelineno-0-1480"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1481"><a id="__codelineno-0-1481" name="__codelineno-0-1481"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1482"><a id="__codelineno-0-1482" name="__codelineno-0-1482"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1483"><a id="__codelineno-0-1483" name="__codelineno-0-1483"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1484"><a id="__codelineno-0-1484" name="__codelineno-0-1484"></a><span class="sd">                    model=Department,</span>
-</span><span id="__span-0-1485"><a id="__codelineno-0-1485" name="__codelineno-0-1485"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1486"><a id="__codelineno-0-1486" name="__codelineno-0-1486"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1487"><a id="__codelineno-0-1487" name="__codelineno-0-1487"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1488"><a id="__codelineno-0-1488" name="__codelineno-0-1488"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1489"><a id="__codelineno-0-1489" name="__codelineno-0-1489"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1490"><a id="__codelineno-0-1490" name="__codelineno-0-1490"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1491"><a id="__codelineno-0-1491" name="__codelineno-0-1491"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1492"><a id="__codelineno-0-1492" name="__codelineno-0-1492"></a><span class="sd">        )</span>
-</span><span id="__span-0-1493"><a id="__codelineno-0-1493" name="__codelineno-0-1493"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;tier&#39; and &#39;dept&#39; as nested dictionaries</span>
-</span><span id="__span-0-1494"><a id="__codelineno-0-1494" name="__codelineno-0-1494"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1495"><a id="__codelineno-0-1495" name="__codelineno-0-1495"></a>
-</span><span id="__span-0-1496"><a id="__codelineno-0-1496" name="__codelineno-0-1496"></a><span class="sd">        Example using one-to-one relationship:</span>
-</span><span id="__span-0-1497"><a id="__codelineno-0-1497" name="__codelineno-0-1497"></a>
-</span><span id="__span-0-1498"><a id="__codelineno-0-1498" name="__codelineno-0-1498"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1499"><a id="__codelineno-0-1499" name="__codelineno-0-1499"></a><span class="sd">        author_crud = FastCRUD(Author)</span>
-</span><span id="__span-0-1500"><a id="__codelineno-0-1500" name="__codelineno-0-1500"></a><span class="sd">        result = await author_crud.get_joined(</span>
-</span><span id="__span-0-1501"><a id="__codelineno-0-1501" name="__codelineno-0-1501"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1502"><a id="__codelineno-0-1502" name="__codelineno-0-1502"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1503"><a id="__codelineno-0-1503" name="__codelineno-0-1503"></a><span class="sd">            join_model=Profile,</span>
-</span><span id="__span-0-1504"><a id="__codelineno-0-1504" name="__codelineno-0-1504"></a><span class="sd">            join_on=Author.profile_id == Profile.id,</span>
-</span><span id="__span-0-1505"><a id="__codelineno-0-1505" name="__codelineno-0-1505"></a><span class="sd">            join_schema_to_select=ReadProfileSchema,</span>
-</span><span id="__span-0-1506"><a id="__codelineno-0-1506" name="__codelineno-0-1506"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1507"><a id="__codelineno-0-1507" name="__codelineno-0-1507"></a><span class="sd">            relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
-</span><span id="__span-0-1508"><a id="__codelineno-0-1508" name="__codelineno-0-1508"></a><span class="sd">        )</span>
-</span><span id="__span-0-1509"><a id="__codelineno-0-1509" name="__codelineno-0-1509"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;profile&#39; as a nested dictionary</span>
-</span><span id="__span-0-1510"><a id="__codelineno-0-1510" name="__codelineno-0-1510"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1511"><a id="__codelineno-0-1511" name="__codelineno-0-1511"></a>
-</span><span id="__span-0-1512"><a id="__codelineno-0-1512" name="__codelineno-0-1512"></a><span class="sd">        Example using one-to-many relationship:</span>
-</span><span id="__span-0-1513"><a id="__codelineno-0-1513" name="__codelineno-0-1513"></a>
-</span><span id="__span-0-1514"><a id="__codelineno-0-1514" name="__codelineno-0-1514"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1515"><a id="__codelineno-0-1515" name="__codelineno-0-1515"></a><span class="sd">        result = await author_crud.get_joined(</span>
-</span><span id="__span-0-1516"><a id="__codelineno-0-1516" name="__codelineno-0-1516"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1517"><a id="__codelineno-0-1517" name="__codelineno-0-1517"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1518"><a id="__codelineno-0-1518" name="__codelineno-0-1518"></a><span class="sd">            join_model=Article,</span>
-</span><span id="__span-0-1519"><a id="__codelineno-0-1519" name="__codelineno-0-1519"></a><span class="sd">            join_on=Author.id == Article.author_id,</span>
-</span><span id="__span-0-1520"><a id="__codelineno-0-1520" name="__codelineno-0-1520"></a><span class="sd">            join_schema_to_select=ReadArticleSchema,</span>
-</span><span id="__span-0-1521"><a id="__codelineno-0-1521" name="__codelineno-0-1521"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1522"><a id="__codelineno-0-1522" name="__codelineno-0-1522"></a><span class="sd">            relationship_type=&#39;one-to-many&#39;,</span>
-</span><span id="__span-0-1523"><a id="__codelineno-0-1523" name="__codelineno-0-1523"></a><span class="sd">        )</span>
-</span><span id="__span-0-1524"><a id="__codelineno-0-1524" name="__codelineno-0-1524"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;posts&#39; as a nested list of dictionaries</span>
-</span><span id="__span-0-1525"><a id="__codelineno-0-1525" name="__codelineno-0-1525"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1526"><a id="__codelineno-0-1526" name="__codelineno-0-1526"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-1527"><a id="__codelineno-0-1527" name="__codelineno-0-1527"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
-</span><span id="__span-0-1528"><a id="__codelineno-0-1528" name="__codelineno-0-1528"></a>        <span class="n">join_model</span> <span class="ow">or</span> <span class="n">join_prefix</span> <span class="ow">or</span> <span class="n">join_on</span> <span class="ow">or</span> <span class="n">join_schema_to_select</span> <span class="ow">or</span> <span class="n">alias</span>
-</span><span id="__span-0-1529"><a id="__codelineno-0-1529" name="__codelineno-0-1529"></a>    <span class="p">):</span>
-</span><span id="__span-0-1530"><a id="__codelineno-0-1530" name="__codelineno-0-1530"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1531"><a id="__codelineno-0-1531" name="__codelineno-0-1531"></a>            <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
-</span><span id="__span-0-1532"><a id="__codelineno-0-1532" name="__codelineno-0-1532"></a>        <span class="p">)</span>
-</span><span id="__span-0-1533"><a id="__codelineno-0-1533" name="__codelineno-0-1533"></a>    <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1534"><a id="__codelineno-0-1534" name="__codelineno-0-1534"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1535"><a id="__codelineno-0-1535" name="__codelineno-0-1535"></a>
-</span><span id="__span-0-1536"><a id="__codelineno-0-1536" name="__codelineno-0-1536"></a>    <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-1537"><a id="__codelineno-0-1537" name="__codelineno-0-1537"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
-</span><span id="__span-0-1538"><a id="__codelineno-0-1538" name="__codelineno-0-1538"></a>        <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1539"><a id="__codelineno-0-1539" name="__codelineno-0-1539"></a>    <span class="p">)</span>
-</span><span id="__span-0-1540"><a id="__codelineno-0-1540" name="__codelineno-0-1540"></a>    <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-</span><span id="__span-0-1541"><a id="__codelineno-0-1541" name="__codelineno-0-1541"></a>
-</span><span id="__span-0-1542"><a id="__codelineno-0-1542" name="__codelineno-0-1542"></a>    <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1543"><a id="__codelineno-0-1543" name="__codelineno-0-1543"></a>    <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1544"><a id="__codelineno-0-1544" name="__codelineno-0-1544"></a>        <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="__span-0-1545"><a id="__codelineno-0-1545" name="__codelineno-0-1545"></a>            <span class="n">JoinConfig</span><span class="p">(</span>
-</span><span id="__span-0-1546"><a id="__codelineno-0-1546" name="__codelineno-0-1546"></a>                <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
-</span><span id="__span-0-1547"><a id="__codelineno-0-1547" name="__codelineno-0-1547"></a>                <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span><span class="p">,</span>
-</span><span id="__span-0-1548"><a id="__codelineno-0-1548" name="__codelineno-0-1548"></a>                <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
-</span><span id="__span-0-1549"><a id="__codelineno-0-1549" name="__codelineno-0-1549"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1550"><a id="__codelineno-0-1550" name="__codelineno-0-1550"></a>                <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
-</span><span id="__span-0-1551"><a id="__codelineno-0-1551" name="__codelineno-0-1551"></a>                <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
-</span><span id="__span-0-1552"><a id="__codelineno-0-1552" name="__codelineno-0-1552"></a>                <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
-</span><span id="__span-0-1553"><a id="__codelineno-0-1553" name="__codelineno-0-1553"></a>                <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
-</span><span id="__span-0-1554"><a id="__codelineno-0-1554" name="__codelineno-0-1554"></a>            <span class="p">)</span>
-</span><span id="__span-0-1555"><a id="__codelineno-0-1555" name="__codelineno-0-1555"></a>        <span class="p">)</span>
-</span><span id="__span-0-1556"><a id="__codelineno-0-1556" name="__codelineno-0-1556"></a>
-</span><span id="__span-0-1557"><a id="__codelineno-0-1557" name="__codelineno-0-1557"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
-</span><span id="__span-0-1558"><a id="__codelineno-0-1558" name="__codelineno-0-1558"></a>        <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
-</span><span id="__span-0-1559"><a id="__codelineno-0-1559" name="__codelineno-0-1559"></a>    <span class="p">)</span>
-</span><span id="__span-0-1560"><a id="__codelineno-0-1560" name="__codelineno-0-1560"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1561"><a id="__codelineno-0-1561" name="__codelineno-0-1561"></a>    <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1562"><a id="__codelineno-0-1562" name="__codelineno-0-1562"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1563"><a id="__codelineno-0-1563" name="__codelineno-0-1563"></a>
-</span><span id="__span-0-1564"><a id="__codelineno-0-1564" name="__codelineno-0-1564"></a>    <span class="n">db_rows</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1565"><a id="__codelineno-0-1565" name="__codelineno-0-1565"></a>    <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span><span class="p">):</span>
-</span><span id="__span-0-1566"><a id="__codelineno-0-1566" name="__codelineno-0-1566"></a>        <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-1567"><a id="__codelineno-0-1567" name="__codelineno-0-1567"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1568"><a id="__codelineno-0-1568" name="__codelineno-0-1568"></a>                <span class="s2">&quot;Cannot use one-to-many relationship with nest_joins=False&quot;</span>
-</span><span id="__span-0-1569"><a id="__codelineno-0-1569" name="__codelineno-0-1569"></a>            <span class="p">)</span>
-</span><span id="__span-0-1570"><a id="__codelineno-0-1570" name="__codelineno-0-1570"></a>        <span class="n">results</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>
-</span><span id="__span-0-1571"><a id="__codelineno-0-1571" name="__codelineno-0-1571"></a>        <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
-</span><span id="__span-0-1572"><a id="__codelineno-0-1572" name="__codelineno-0-1572"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1573"><a id="__codelineno-0-1573" name="__codelineno-0-1573"></a>        <span class="n">result</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-</span><span id="__span-0-1574"><a id="__codelineno-0-1574" name="__codelineno-0-1574"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1575"><a id="__codelineno-0-1575" name="__codelineno-0-1575"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)]</span>
-</span><span id="__span-0-1576"><a id="__codelineno-0-1576" name="__codelineno-0-1576"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1577"><a id="__codelineno-0-1577" name="__codelineno-0-1577"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-1578"><a id="__codelineno-0-1578" name="__codelineno-0-1578"></a>
-</span><span id="__span-0-1579"><a id="__codelineno-0-1579" name="__codelineno-0-1579"></a>    <span class="k">if</span> <span class="n">data_list</span><span class="p">:</span>
-</span><span id="__span-0-1580"><a id="__codelineno-0-1580" name="__codelineno-0-1580"></a>        <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
-</span><span id="__span-0-1581"><a id="__codelineno-0-1581" name="__codelineno-0-1581"></a>            <span class="n">nested_data</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-1582"><a id="__codelineno-0-1582" name="__codelineno-0-1582"></a>            <span class="k">for</span> <span class="n">data</span> <span class="ow">in</span> <span class="n">data_list</span><span class="p">:</span>
-</span><span id="__span-0-1583"><a id="__codelineno-0-1583" name="__codelineno-0-1583"></a>                <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1584"><a id="__codelineno-0-1584" name="__codelineno-0-1584"></a>                    <span class="n">data</span><span class="p">,</span>
-</span><span id="__span-0-1585"><a id="__codelineno-0-1585" name="__codelineno-0-1585"></a>                    <span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1586"><a id="__codelineno-0-1586" name="__codelineno-0-1586"></a>                    <span class="n">nested_data</span><span class="o">=</span><span class="n">nested_data</span><span class="p">,</span>
-</span><span id="__span-0-1587"><a id="__codelineno-0-1587" name="__codelineno-0-1587"></a>                <span class="p">)</span>
-</span><span id="__span-0-1588"><a id="__codelineno-0-1588" name="__codelineno-0-1588"></a>            <span class="k">return</span> <span class="n">nested_data</span>
-</span><span id="__span-0-1589"><a id="__codelineno-0-1589" name="__codelineno-0-1589"></a>        <span class="k">return</span> <span class="n">data_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-</span><span id="__span-0-1590"><a id="__codelineno-0-1590" name="__codelineno-0-1590"></a>
-</span><span id="__span-0-1591"><a id="__codelineno-0-1591" name="__codelineno-0-1591"></a>    <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-1386"><a id="__codelineno-0-1386" name="__codelineno-0-1386"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1387"><a id="__codelineno-0-1387" name="__codelineno-0-1387"></a><span class="sd">        from sqlalchemy import and_</span>
+</span><span id="__span-0-1388"><a id="__codelineno-0-1388" name="__codelineno-0-1388"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1389"><a id="__codelineno-0-1389" name="__codelineno-0-1389"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1390"><a id="__codelineno-0-1390" name="__codelineno-0-1390"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1391"><a id="__codelineno-0-1391" name="__codelineno-0-1391"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1392"><a id="__codelineno-0-1392" name="__codelineno-0-1392"></a><span class="sd">            join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),</span>
+</span><span id="__span-0-1393"><a id="__codelineno-0-1393" name="__codelineno-0-1393"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1394"><a id="__codelineno-0-1394" name="__codelineno-0-1394"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1395"><a id="__codelineno-0-1395" name="__codelineno-0-1395"></a><span class="sd">            username=&quot;john_doe&quot;,</span>
+</span><span id="__span-0-1396"><a id="__codelineno-0-1396" name="__codelineno-0-1396"></a><span class="sd">        )</span>
+</span><span id="__span-0-1397"><a id="__codelineno-0-1397" name="__codelineno-0-1397"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1398"><a id="__codelineno-0-1398" name="__codelineno-0-1398"></a>
+</span><span id="__span-0-1399"><a id="__codelineno-0-1399" name="__codelineno-0-1399"></a><span class="sd">        Example of using `joins_config` for multiple joins:</span>
+</span><span id="__span-0-1400"><a id="__codelineno-0-1400" name="__codelineno-0-1400"></a>
+</span><span id="__span-0-1401"><a id="__codelineno-0-1401" name="__codelineno-0-1401"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1402"><a id="__codelineno-0-1402" name="__codelineno-0-1402"></a><span class="sd">        from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1403"><a id="__codelineno-0-1403" name="__codelineno-0-1403"></a>
+</span><span id="__span-0-1404"><a id="__codelineno-0-1404" name="__codelineno-0-1404"></a><span class="sd">        # Using same User/Tier/Department models/schemas as above.</span>
+</span><span id="__span-0-1405"><a id="__codelineno-0-1405" name="__codelineno-0-1405"></a>
+</span><span id="__span-0-1406"><a id="__codelineno-0-1406" name="__codelineno-0-1406"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1407"><a id="__codelineno-0-1407" name="__codelineno-0-1407"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1408"><a id="__codelineno-0-1408" name="__codelineno-0-1408"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1409"><a id="__codelineno-0-1409" name="__codelineno-0-1409"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1410"><a id="__codelineno-0-1410" name="__codelineno-0-1410"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1411"><a id="__codelineno-0-1411" name="__codelineno-0-1411"></a><span class="sd">                    model=Tier,</span>
+</span><span id="__span-0-1412"><a id="__codelineno-0-1412" name="__codelineno-0-1412"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1413"><a id="__codelineno-0-1413" name="__codelineno-0-1413"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1414"><a id="__codelineno-0-1414" name="__codelineno-0-1414"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1415"><a id="__codelineno-0-1415" name="__codelineno-0-1415"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1416"><a id="__codelineno-0-1416" name="__codelineno-0-1416"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1417"><a id="__codelineno-0-1417" name="__codelineno-0-1417"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1418"><a id="__codelineno-0-1418" name="__codelineno-0-1418"></a><span class="sd">                    model=Department,</span>
+</span><span id="__span-0-1419"><a id="__codelineno-0-1419" name="__codelineno-0-1419"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1420"><a id="__codelineno-0-1420" name="__codelineno-0-1420"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1421"><a id="__codelineno-0-1421" name="__codelineno-0-1421"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1422"><a id="__codelineno-0-1422" name="__codelineno-0-1422"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1423"><a id="__codelineno-0-1423" name="__codelineno-0-1423"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1424"><a id="__codelineno-0-1424" name="__codelineno-0-1424"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1425"><a id="__codelineno-0-1425" name="__codelineno-0-1425"></a><span class="sd">        )</span>
+</span><span id="__span-0-1426"><a id="__codelineno-0-1426" name="__codelineno-0-1426"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1427"><a id="__codelineno-0-1427" name="__codelineno-0-1427"></a>
+</span><span id="__span-0-1428"><a id="__codelineno-0-1428" name="__codelineno-0-1428"></a><span class="sd">        Using `alias` for joining the same model multiple times:</span>
+</span><span id="__span-0-1429"><a id="__codelineno-0-1429" name="__codelineno-0-1429"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1430"><a id="__codelineno-0-1430" name="__codelineno-0-1430"></a><span class="sd">        from fastcrud import aliased</span>
+</span><span id="__span-0-1431"><a id="__codelineno-0-1431" name="__codelineno-0-1431"></a>
+</span><span id="__span-0-1432"><a id="__codelineno-0-1432" name="__codelineno-0-1432"></a><span class="sd">        owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
+</span><span id="__span-0-1433"><a id="__codelineno-0-1433" name="__codelineno-0-1433"></a><span class="sd">        user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
+</span><span id="__span-0-1434"><a id="__codelineno-0-1434" name="__codelineno-0-1434"></a>
+</span><span id="__span-0-1435"><a id="__codelineno-0-1435" name="__codelineno-0-1435"></a><span class="sd">        result = await crud.get_joined(</span>
+</span><span id="__span-0-1436"><a id="__codelineno-0-1436" name="__codelineno-0-1436"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1437"><a id="__codelineno-0-1437" name="__codelineno-0-1437"></a><span class="sd">            schema_to_select=BookingSchema,</span>
+</span><span id="__span-0-1438"><a id="__codelineno-0-1438" name="__codelineno-0-1438"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1439"><a id="__codelineno-0-1439" name="__codelineno-0-1439"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1440"><a id="__codelineno-0-1440" name="__codelineno-0-1440"></a><span class="sd">                    model=ModelTest,</span>
+</span><span id="__span-0-1441"><a id="__codelineno-0-1441" name="__codelineno-0-1441"></a><span class="sd">                    join_on=BookingModel.owner_id == owner_alias.id,</span>
+</span><span id="__span-0-1442"><a id="__codelineno-0-1442" name="__codelineno-0-1442"></a><span class="sd">                    join_prefix=&quot;owner_&quot;,</span>
+</span><span id="__span-0-1443"><a id="__codelineno-0-1443" name="__codelineno-0-1443"></a><span class="sd">                    alias=owner_alias,</span>
+</span><span id="__span-0-1444"><a id="__codelineno-0-1444" name="__codelineno-0-1444"></a><span class="sd">                    schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1445"><a id="__codelineno-0-1445" name="__codelineno-0-1445"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1446"><a id="__codelineno-0-1446" name="__codelineno-0-1446"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1447"><a id="__codelineno-0-1447" name="__codelineno-0-1447"></a><span class="sd">                    model=ModelTest,</span>
+</span><span id="__span-0-1448"><a id="__codelineno-0-1448" name="__codelineno-0-1448"></a><span class="sd">                    join_on=BookingModel.user_id == user_alias.id,</span>
+</span><span id="__span-0-1449"><a id="__codelineno-0-1449" name="__codelineno-0-1449"></a><span class="sd">                    join_prefix=&quot;user_&quot;,</span>
+</span><span id="__span-0-1450"><a id="__codelineno-0-1450" name="__codelineno-0-1450"></a><span class="sd">                    alias=user_alias,</span>
+</span><span id="__span-0-1451"><a id="__codelineno-0-1451" name="__codelineno-0-1451"></a><span class="sd">                    schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1452"><a id="__codelineno-0-1452" name="__codelineno-0-1452"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1453"><a id="__codelineno-0-1453" name="__codelineno-0-1453"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1454"><a id="__codelineno-0-1454" name="__codelineno-0-1454"></a><span class="sd">            id=1,</span>
+</span><span id="__span-0-1455"><a id="__codelineno-0-1455" name="__codelineno-0-1455"></a><span class="sd">        )</span>
+</span><span id="__span-0-1456"><a id="__codelineno-0-1456" name="__codelineno-0-1456"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1457"><a id="__codelineno-0-1457" name="__codelineno-0-1457"></a>
+</span><span id="__span-0-1458"><a id="__codelineno-0-1458" name="__codelineno-0-1458"></a><span class="sd">        Fetching a single project and its associated participants where a participant has a specific role:</span>
+</span><span id="__span-0-1459"><a id="__codelineno-0-1459" name="__codelineno-0-1459"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1460"><a id="__codelineno-0-1460" name="__codelineno-0-1460"></a><span class="sd">        joins_config = [</span>
+</span><span id="__span-0-1461"><a id="__codelineno-0-1461" name="__codelineno-0-1461"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1462"><a id="__codelineno-0-1462" name="__codelineno-0-1462"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1463"><a id="__codelineno-0-1463" name="__codelineno-0-1463"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1464"><a id="__codelineno-0-1464" name="__codelineno-0-1464"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1465"><a id="__codelineno-0-1465" name="__codelineno-0-1465"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1466"><a id="__codelineno-0-1466" name="__codelineno-0-1466"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1467"><a id="__codelineno-0-1467" name="__codelineno-0-1467"></a><span class="sd">                model=Participant,</span>
+</span><span id="__span-0-1468"><a id="__codelineno-0-1468" name="__codelineno-0-1468"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1469"><a id="__codelineno-0-1469" name="__codelineno-0-1469"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1470"><a id="__codelineno-0-1470" name="__codelineno-0-1470"></a><span class="sd">                filters={&#39;role&#39;: &#39;Designer&#39;},</span>
+</span><span id="__span-0-1471"><a id="__codelineno-0-1471" name="__codelineno-0-1471"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1472"><a id="__codelineno-0-1472" name="__codelineno-0-1472"></a><span class="sd">        ]</span>
+</span><span id="__span-0-1473"><a id="__codelineno-0-1473" name="__codelineno-0-1473"></a><span class="sd">        project = await crud.get_joined(</span>
+</span><span id="__span-0-1474"><a id="__codelineno-0-1474" name="__codelineno-0-1474"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1475"><a id="__codelineno-0-1475" name="__codelineno-0-1475"></a><span class="sd">            schema_to_select=ProjectSchema,</span>
+</span><span id="__span-0-1476"><a id="__codelineno-0-1476" name="__codelineno-0-1476"></a><span class="sd">            joins_config=joins_config,</span>
+</span><span id="__span-0-1477"><a id="__codelineno-0-1477" name="__codelineno-0-1477"></a><span class="sd">        )</span>
+</span><span id="__span-0-1478"><a id="__codelineno-0-1478" name="__codelineno-0-1478"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1479"><a id="__codelineno-0-1479" name="__codelineno-0-1479"></a>
+</span><span id="__span-0-1480"><a id="__codelineno-0-1480" name="__codelineno-0-1480"></a><span class="sd">        Example of using `joins_config` for multiple joins with nested joins enabled:</span>
+</span><span id="__span-0-1481"><a id="__codelineno-0-1481" name="__codelineno-0-1481"></a>
+</span><span id="__span-0-1482"><a id="__codelineno-0-1482" name="__codelineno-0-1482"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1483"><a id="__codelineno-0-1483" name="__codelineno-0-1483"></a><span class="sd">        from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1484"><a id="__codelineno-0-1484" name="__codelineno-0-1484"></a>
+</span><span id="__span-0-1485"><a id="__codelineno-0-1485" name="__codelineno-0-1485"></a><span class="sd">        result = await user_crud.get_joined(</span>
+</span><span id="__span-0-1486"><a id="__codelineno-0-1486" name="__codelineno-0-1486"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1487"><a id="__codelineno-0-1487" name="__codelineno-0-1487"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1488"><a id="__codelineno-0-1488" name="__codelineno-0-1488"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1489"><a id="__codelineno-0-1489" name="__codelineno-0-1489"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1490"><a id="__codelineno-0-1490" name="__codelineno-0-1490"></a><span class="sd">                    model=Tier,</span>
+</span><span id="__span-0-1491"><a id="__codelineno-0-1491" name="__codelineno-0-1491"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1492"><a id="__codelineno-0-1492" name="__codelineno-0-1492"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1493"><a id="__codelineno-0-1493" name="__codelineno-0-1493"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1494"><a id="__codelineno-0-1494" name="__codelineno-0-1494"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1495"><a id="__codelineno-0-1495" name="__codelineno-0-1495"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1496"><a id="__codelineno-0-1496" name="__codelineno-0-1496"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1497"><a id="__codelineno-0-1497" name="__codelineno-0-1497"></a><span class="sd">                    model=Department,</span>
+</span><span id="__span-0-1498"><a id="__codelineno-0-1498" name="__codelineno-0-1498"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1499"><a id="__codelineno-0-1499" name="__codelineno-0-1499"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1500"><a id="__codelineno-0-1500" name="__codelineno-0-1500"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1501"><a id="__codelineno-0-1501" name="__codelineno-0-1501"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1502"><a id="__codelineno-0-1502" name="__codelineno-0-1502"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1503"><a id="__codelineno-0-1503" name="__codelineno-0-1503"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1504"><a id="__codelineno-0-1504" name="__codelineno-0-1504"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1505"><a id="__codelineno-0-1505" name="__codelineno-0-1505"></a><span class="sd">        )</span>
+</span><span id="__span-0-1506"><a id="__codelineno-0-1506" name="__codelineno-0-1506"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;tier&#39; and &#39;dept&#39; as nested dictionaries</span>
+</span><span id="__span-0-1507"><a id="__codelineno-0-1507" name="__codelineno-0-1507"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1508"><a id="__codelineno-0-1508" name="__codelineno-0-1508"></a>
+</span><span id="__span-0-1509"><a id="__codelineno-0-1509" name="__codelineno-0-1509"></a><span class="sd">        Example using one-to-one relationship:</span>
+</span><span id="__span-0-1510"><a id="__codelineno-0-1510" name="__codelineno-0-1510"></a>
+</span><span id="__span-0-1511"><a id="__codelineno-0-1511" name="__codelineno-0-1511"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1512"><a id="__codelineno-0-1512" name="__codelineno-0-1512"></a><span class="sd">        author_crud = FastCRUD(Author)</span>
+</span><span id="__span-0-1513"><a id="__codelineno-0-1513" name="__codelineno-0-1513"></a><span class="sd">        result = await author_crud.get_joined(</span>
+</span><span id="__span-0-1514"><a id="__codelineno-0-1514" name="__codelineno-0-1514"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1515"><a id="__codelineno-0-1515" name="__codelineno-0-1515"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1516"><a id="__codelineno-0-1516" name="__codelineno-0-1516"></a><span class="sd">            join_model=Profile,</span>
+</span><span id="__span-0-1517"><a id="__codelineno-0-1517" name="__codelineno-0-1517"></a><span class="sd">            join_on=Author.profile_id == Profile.id,</span>
+</span><span id="__span-0-1518"><a id="__codelineno-0-1518" name="__codelineno-0-1518"></a><span class="sd">            join_schema_to_select=ReadProfileSchema,</span>
+</span><span id="__span-0-1519"><a id="__codelineno-0-1519" name="__codelineno-0-1519"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1520"><a id="__codelineno-0-1520" name="__codelineno-0-1520"></a><span class="sd">            relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
+</span><span id="__span-0-1521"><a id="__codelineno-0-1521" name="__codelineno-0-1521"></a><span class="sd">        )</span>
+</span><span id="__span-0-1522"><a id="__codelineno-0-1522" name="__codelineno-0-1522"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;profile&#39; as a nested dictionary</span>
+</span><span id="__span-0-1523"><a id="__codelineno-0-1523" name="__codelineno-0-1523"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1524"><a id="__codelineno-0-1524" name="__codelineno-0-1524"></a>
+</span><span id="__span-0-1525"><a id="__codelineno-0-1525" name="__codelineno-0-1525"></a><span class="sd">        Example using one-to-many relationship:</span>
+</span><span id="__span-0-1526"><a id="__codelineno-0-1526" name="__codelineno-0-1526"></a>
+</span><span id="__span-0-1527"><a id="__codelineno-0-1527" name="__codelineno-0-1527"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1528"><a id="__codelineno-0-1528" name="__codelineno-0-1528"></a><span class="sd">        result = await author_crud.get_joined(</span>
+</span><span id="__span-0-1529"><a id="__codelineno-0-1529" name="__codelineno-0-1529"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1530"><a id="__codelineno-0-1530" name="__codelineno-0-1530"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1531"><a id="__codelineno-0-1531" name="__codelineno-0-1531"></a><span class="sd">            join_model=Article,</span>
+</span><span id="__span-0-1532"><a id="__codelineno-0-1532" name="__codelineno-0-1532"></a><span class="sd">            join_on=Author.id == Article.author_id,</span>
+</span><span id="__span-0-1533"><a id="__codelineno-0-1533" name="__codelineno-0-1533"></a><span class="sd">            join_schema_to_select=ReadArticleSchema,</span>
+</span><span id="__span-0-1534"><a id="__codelineno-0-1534" name="__codelineno-0-1534"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1535"><a id="__codelineno-0-1535" name="__codelineno-0-1535"></a><span class="sd">            relationship_type=&#39;one-to-many&#39;,</span>
+</span><span id="__span-0-1536"><a id="__codelineno-0-1536" name="__codelineno-0-1536"></a><span class="sd">        )</span>
+</span><span id="__span-0-1537"><a id="__codelineno-0-1537" name="__codelineno-0-1537"></a><span class="sd">        # Expect &#39;result&#39; to have &#39;posts&#39; as a nested list of dictionaries</span>
+</span><span id="__span-0-1538"><a id="__codelineno-0-1538" name="__codelineno-0-1538"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1539"><a id="__codelineno-0-1539" name="__codelineno-0-1539"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-1540"><a id="__codelineno-0-1540" name="__codelineno-0-1540"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
+</span><span id="__span-0-1541"><a id="__codelineno-0-1541" name="__codelineno-0-1541"></a>        <span class="n">join_model</span> <span class="ow">or</span> <span class="n">join_prefix</span> <span class="ow">or</span> <span class="n">join_on</span> <span class="ow">or</span> <span class="n">join_schema_to_select</span> <span class="ow">or</span> <span class="n">alias</span>
+</span><span id="__span-0-1542"><a id="__codelineno-0-1542" name="__codelineno-0-1542"></a>    <span class="p">):</span>
+</span><span id="__span-0-1543"><a id="__codelineno-0-1543" name="__codelineno-0-1543"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1544"><a id="__codelineno-0-1544" name="__codelineno-0-1544"></a>            <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
+</span><span id="__span-0-1545"><a id="__codelineno-0-1545" name="__codelineno-0-1545"></a>        <span class="p">)</span>
+</span><span id="__span-0-1546"><a id="__codelineno-0-1546" name="__codelineno-0-1546"></a>    <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1547"><a id="__codelineno-0-1547" name="__codelineno-0-1547"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1548"><a id="__codelineno-0-1548" name="__codelineno-0-1548"></a>
+</span><span id="__span-0-1549"><a id="__codelineno-0-1549" name="__codelineno-0-1549"></a>    <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-1550"><a id="__codelineno-0-1550" name="__codelineno-0-1550"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
+</span><span id="__span-0-1551"><a id="__codelineno-0-1551" name="__codelineno-0-1551"></a>        <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1552"><a id="__codelineno-0-1552" name="__codelineno-0-1552"></a>    <span class="p">)</span>
+</span><span id="__span-0-1553"><a id="__codelineno-0-1553" name="__codelineno-0-1553"></a>    <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span><span class="o">.</span><span class="n">select_from</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+</span><span id="__span-0-1554"><a id="__codelineno-0-1554" name="__codelineno-0-1554"></a>
+</span><span id="__span-0-1555"><a id="__codelineno-0-1555" name="__codelineno-0-1555"></a>    <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1556"><a id="__codelineno-0-1556" name="__codelineno-0-1556"></a>    <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1557"><a id="__codelineno-0-1557" name="__codelineno-0-1557"></a>        <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="__span-0-1558"><a id="__codelineno-0-1558" name="__codelineno-0-1558"></a>            <span class="n">JoinConfig</span><span class="p">(</span>
+</span><span id="__span-0-1559"><a id="__codelineno-0-1559" name="__codelineno-0-1559"></a>                <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
+</span><span id="__span-0-1560"><a id="__codelineno-0-1560" name="__codelineno-0-1560"></a>                <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span><span class="p">,</span>
+</span><span id="__span-0-1561"><a id="__codelineno-0-1561" name="__codelineno-0-1561"></a>                <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
+</span><span id="__span-0-1562"><a id="__codelineno-0-1562" name="__codelineno-0-1562"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1563"><a id="__codelineno-0-1563" name="__codelineno-0-1563"></a>                <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
+</span><span id="__span-0-1564"><a id="__codelineno-0-1564" name="__codelineno-0-1564"></a>                <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
+</span><span id="__span-0-1565"><a id="__codelineno-0-1565" name="__codelineno-0-1565"></a>                <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
+</span><span id="__span-0-1566"><a id="__codelineno-0-1566" name="__codelineno-0-1566"></a>                <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
+</span><span id="__span-0-1567"><a id="__codelineno-0-1567" name="__codelineno-0-1567"></a>            <span class="p">)</span>
+</span><span id="__span-0-1568"><a id="__codelineno-0-1568" name="__codelineno-0-1568"></a>        <span class="p">)</span>
+</span><span id="__span-0-1569"><a id="__codelineno-0-1569" name="__codelineno-0-1569"></a>
+</span><span id="__span-0-1570"><a id="__codelineno-0-1570" name="__codelineno-0-1570"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
+</span><span id="__span-0-1571"><a id="__codelineno-0-1571" name="__codelineno-0-1571"></a>        <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
+</span><span id="__span-0-1572"><a id="__codelineno-0-1572" name="__codelineno-0-1572"></a>    <span class="p">)</span>
+</span><span id="__span-0-1573"><a id="__codelineno-0-1573" name="__codelineno-0-1573"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1574"><a id="__codelineno-0-1574" name="__codelineno-0-1574"></a>    <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1575"><a id="__codelineno-0-1575" name="__codelineno-0-1575"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1576"><a id="__codelineno-0-1576" name="__codelineno-0-1576"></a>
+</span><span id="__span-0-1577"><a id="__codelineno-0-1577" name="__codelineno-0-1577"></a>    <span class="n">db_rows</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1578"><a id="__codelineno-0-1578" name="__codelineno-0-1578"></a>    <span class="k">if</span> <span class="nb">any</span><span class="p">(</span><span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span><span class="p">):</span>
+</span><span id="__span-0-1579"><a id="__codelineno-0-1579" name="__codelineno-0-1579"></a>        <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">is</span> <span class="kc">False</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1580"><a id="__codelineno-0-1580" name="__codelineno-0-1580"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1581"><a id="__codelineno-0-1581" name="__codelineno-0-1581"></a>                <span class="s2">&quot;Cannot use one-to-many relationship with nest_joins=False&quot;</span>
+</span><span id="__span-0-1582"><a id="__codelineno-0-1582" name="__codelineno-0-1582"></a>            <span class="p">)</span>
+</span><span id="__span-0-1583"><a id="__codelineno-0-1583" name="__codelineno-0-1583"></a>        <span class="n">results</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">fetchall</span><span class="p">()</span>
+</span><span id="__span-0-1584"><a id="__codelineno-0-1584" name="__codelineno-0-1584"></a>        <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">results</span><span class="p">]</span>
+</span><span id="__span-0-1585"><a id="__codelineno-0-1585" name="__codelineno-0-1585"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1586"><a id="__codelineno-0-1586" name="__codelineno-0-1586"></a>        <span class="n">result</span> <span class="o">=</span> <span class="n">db_rows</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+</span><span id="__span-0-1587"><a id="__codelineno-0-1587" name="__codelineno-0-1587"></a>        <span class="k">if</span> <span class="n">result</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1588"><a id="__codelineno-0-1588" name="__codelineno-0-1588"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">result</span><span class="o">.</span><span class="n">_mapping</span><span class="p">)]</span>
+</span><span id="__span-0-1589"><a id="__codelineno-0-1589" name="__codelineno-0-1589"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1590"><a id="__codelineno-0-1590" name="__codelineno-0-1590"></a>            <span class="n">data_list</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-1591"><a id="__codelineno-0-1591" name="__codelineno-0-1591"></a>
+</span><span id="__span-0-1592"><a id="__codelineno-0-1592" name="__codelineno-0-1592"></a>    <span class="k">if</span> <span class="n">data_list</span><span class="p">:</span>
+</span><span id="__span-0-1593"><a id="__codelineno-0-1593" name="__codelineno-0-1593"></a>        <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
+</span><span id="__span-0-1594"><a id="__codelineno-0-1594" name="__codelineno-0-1594"></a>            <span class="n">nested_data</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-1595"><a id="__codelineno-0-1595" name="__codelineno-0-1595"></a>            <span class="k">for</span> <span class="n">data</span> <span class="ow">in</span> <span class="n">data_list</span><span class="p">:</span>
+</span><span id="__span-0-1596"><a id="__codelineno-0-1596" name="__codelineno-0-1596"></a>                <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1597"><a id="__codelineno-0-1597" name="__codelineno-0-1597"></a>                    <span class="n">data</span><span class="p">,</span>
+</span><span id="__span-0-1598"><a id="__codelineno-0-1598" name="__codelineno-0-1598"></a>                    <span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1599"><a id="__codelineno-0-1599" name="__codelineno-0-1599"></a>                    <span class="n">nested_data</span><span class="o">=</span><span class="n">nested_data</span><span class="p">,</span>
+</span><span id="__span-0-1600"><a id="__codelineno-0-1600" name="__codelineno-0-1600"></a>                <span class="p">)</span>
+</span><span id="__span-0-1601"><a id="__codelineno-0-1601" name="__codelineno-0-1601"></a>            <span class="k">return</span> <span class="n">nested_data</span>
+</span><span id="__span-0-1602"><a id="__codelineno-0-1602" name="__codelineno-0-1602"></a>        <span class="k">return</span> <span class="n">data_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+</span><span id="__span-0-1603"><a id="__codelineno-0-1603" name="__codelineno-0-1603"></a>
+</span><span id="__span-0-1604"><a id="__codelineno-0-1604" name="__codelineno-0-1604"></a>    <span class="k">return</span> <span class="kc">None</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -9976,7 +10070,7 @@ <h2 id="fastcrud.FastCRUD.get_multi" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -10073,11 +10167,47 @@ <h2 id="fastcrud.FastCRUD.get_multi" class="doc doc-heading">
     <tbody>
         <tr>
           <td>
-                <code>dict[str, <span title="typing.Any">Any</span>]</code>
+                <code><span title="typing.Union">Union</span>[<span title="fastcrud.types.GetMultiResponseModel">GetMultiResponseModel</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>], <span title="fastcrud.types.GetMultiResponseDict">GetMultiResponseDict</span>]</code>
           </td>
           <td>
             <div class="doc-md-description">
-              <p>A dictionary containing <code>"data"</code> with fetched records and <code>"total_count"</code> indicating the total number of records matching the filters.</p>
+              <p>A dictionary containing the data list and optionally the total count:</p>
+            </div>
+          </td>
+        </tr>
+        <tr>
+          <td>
+                <code><span title="typing.Union">Union</span>[<span title="fastcrud.types.GetMultiResponseModel">GetMultiResponseModel</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>], <span title="fastcrud.types.GetMultiResponseDict">GetMultiResponseDict</span>]</code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <ul>
+<li>With return_as_model=True: Dict with "data": List[SelectSchemaType]</li>
+</ul>
+            </div>
+          </td>
+        </tr>
+        <tr>
+          <td>
+                <code><span title="typing.Union">Union</span>[<span title="fastcrud.types.GetMultiResponseModel">GetMultiResponseModel</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>], <span title="fastcrud.types.GetMultiResponseDict">GetMultiResponseDict</span>]</code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <ul>
+<li>With return_as_model=False: Dict with "data": List[Dict[str, Any]]</li>
+</ul>
+            </div>
+          </td>
+        </tr>
+        <tr>
+          <td>
+                <code><span title="typing.Union">Union</span>[<span title="fastcrud.types.GetMultiResponseModel">GetMultiResponseModel</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>], <span title="fastcrud.types.GetMultiResponseDict">GetMultiResponseDict</span>]</code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <ul>
+<li>If return_total_count=True, includes "total_count": int</li>
+</ul>
             </div>
           </td>
         </tr>
@@ -10168,17 +10298,7 @@ <h2 id="fastcrud.FastCRUD.get_multi" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1132">1132</a></span>
-<span class="normal"><a href="#__codelineno-0-1133">1133</a></span>
-<span class="normal"><a href="#__codelineno-0-1134">1134</a></span>
-<span class="normal"><a href="#__codelineno-0-1135">1135</a></span>
-<span class="normal"><a href="#__codelineno-0-1136">1136</a></span>
-<span class="normal"><a href="#__codelineno-0-1137">1137</a></span>
-<span class="normal"><a href="#__codelineno-0-1138">1138</a></span>
-<span class="normal"><a href="#__codelineno-0-1139">1139</a></span>
-<span class="normal"><a href="#__codelineno-0-1140">1140</a></span>
-<span class="normal"><a href="#__codelineno-0-1141">1141</a></span>
-<span class="normal"><a href="#__codelineno-0-1142">1142</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1142">1142</a></span>
 <span class="normal"><a href="#__codelineno-0-1143">1143</a></span>
 <span class="normal"><a href="#__codelineno-0-1144">1144</a></span>
 <span class="normal"><a href="#__codelineno-0-1145">1145</a></span>
@@ -10311,150 +10431,166 @@ <h2 id="fastcrud.FastCRUD.get_multi" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-1272">1272</a></span>
 <span class="normal"><a href="#__codelineno-0-1273">1273</a></span>
 <span class="normal"><a href="#__codelineno-0-1274">1274</a></span>
-<span class="normal"><a href="#__codelineno-0-1275">1275</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1132"><a id="__codelineno-0-1132" name="__codelineno-0-1132"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi</span><span class="p">(</span>
-</span><span id="__span-0-1133"><a id="__codelineno-0-1133" name="__codelineno-0-1133"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1134"><a id="__codelineno-0-1134" name="__codelineno-0-1134"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1135"><a id="__codelineno-0-1135" name="__codelineno-0-1135"></a>    <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
-</span><span id="__span-0-1136"><a id="__codelineno-0-1136" name="__codelineno-0-1136"></a>    <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-1137"><a id="__codelineno-0-1137" name="__codelineno-0-1137"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1138"><a id="__codelineno-0-1138" name="__codelineno-0-1138"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1139"><a id="__codelineno-0-1139" name="__codelineno-0-1139"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1140"><a id="__codelineno-0-1140" name="__codelineno-0-1140"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1141"><a id="__codelineno-0-1141" name="__codelineno-0-1141"></a>    <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-1142"><a id="__codelineno-0-1142" name="__codelineno-0-1142"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1143"><a id="__codelineno-0-1143" name="__codelineno-0-1143"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-1144"><a id="__codelineno-0-1144" name="__codelineno-0-1144"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1145"><a id="__codelineno-0-1145" name="__codelineno-0-1145"></a><span class="sd">    Fetches multiple records based on filters, supporting sorting, pagination.</span>
-</span><span id="__span-0-1146"><a id="__codelineno-0-1146" name="__codelineno-0-1146"></a>
-</span><span id="__span-0-1147"><a id="__codelineno-0-1147" name="__codelineno-0-1147"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1148"><a id="__codelineno-0-1148" name="__codelineno-0-1148"></a>
-</span><span id="__span-0-1149"><a id="__codelineno-0-1149" name="__codelineno-0-1149"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-1150"><a id="__codelineno-0-1150" name="__codelineno-0-1150"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-1151"><a id="__codelineno-0-1151" name="__codelineno-0-1151"></a><span class="sd">        offset: Starting index for records to fetch, useful for pagination.</span>
-</span><span id="__span-0-1152"><a id="__codelineno-0-1152" name="__codelineno-0-1152"></a><span class="sd">        limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
-</span><span id="__span-0-1153"><a id="__codelineno-0-1153" name="__codelineno-0-1153"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1154"><a id="__codelineno-0-1154" name="__codelineno-0-1154"></a><span class="sd">        sort_columns: Column names to sort the results by.</span>
-</span><span id="__span-0-1155"><a id="__codelineno-0-1155" name="__codelineno-0-1155"></a><span class="sd">        sort_orders: Corresponding sort orders (`&quot;asc&quot;`, `&quot;desc&quot;`) for each column in `sort_columns`.</span>
-</span><span id="__span-0-1156"><a id="__codelineno-0-1156" name="__codelineno-0-1156"></a><span class="sd">        return_as_model: If `True`, returns data as instances of the specified Pydantic model.</span>
-</span><span id="__span-0-1157"><a id="__codelineno-0-1157" name="__codelineno-0-1157"></a><span class="sd">        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
-</span><span id="__span-0-1158"><a id="__codelineno-0-1158" name="__codelineno-0-1158"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
-</span><span id="__span-0-1159"><a id="__codelineno-0-1159" name="__codelineno-0-1159"></a>
-</span><span id="__span-0-1160"><a id="__codelineno-0-1160" name="__codelineno-0-1160"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-1161"><a id="__codelineno-0-1161" name="__codelineno-0-1161"></a><span class="sd">        A dictionary containing `&quot;data&quot;` with fetched records and `&quot;total_count&quot;` indicating the total number of records matching the filters.</span>
-</span><span id="__span-0-1162"><a id="__codelineno-0-1162" name="__codelineno-0-1162"></a>
-</span><span id="__span-0-1163"><a id="__codelineno-0-1163" name="__codelineno-0-1163"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-1164"><a id="__codelineno-0-1164" name="__codelineno-0-1164"></a><span class="sd">        ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.</span>
-</span><span id="__span-0-1165"><a id="__codelineno-0-1165" name="__codelineno-0-1165"></a>
-</span><span id="__span-0-1166"><a id="__codelineno-0-1166" name="__codelineno-0-1166"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-1167"><a id="__codelineno-0-1167" name="__codelineno-0-1167"></a><span class="sd">        Fetch the first 10 users:</span>
-</span><span id="__span-0-1168"><a id="__codelineno-0-1168" name="__codelineno-0-1168"></a>
-</span><span id="__span-0-1169"><a id="__codelineno-0-1169" name="__codelineno-0-1169"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1170"><a id="__codelineno-0-1170" name="__codelineno-0-1170"></a><span class="sd">        users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1171"><a id="__codelineno-0-1171" name="__codelineno-0-1171"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1172"><a id="__codelineno-0-1172" name="__codelineno-0-1172"></a><span class="sd">            0,</span>
-</span><span id="__span-0-1173"><a id="__codelineno-0-1173" name="__codelineno-0-1173"></a><span class="sd">            10,</span>
-</span><span id="__span-0-1174"><a id="__codelineno-0-1174" name="__codelineno-0-1174"></a><span class="sd">        )</span>
-</span><span id="__span-0-1175"><a id="__codelineno-0-1175" name="__codelineno-0-1175"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1176"><a id="__codelineno-0-1176" name="__codelineno-0-1176"></a>
-</span><span id="__span-0-1177"><a id="__codelineno-0-1177" name="__codelineno-0-1177"></a><span class="sd">        Fetch next 10 users with sorted by username:</span>
+<span class="normal"><a href="#__codelineno-0-1275">1275</a></span>
+<span class="normal"><a href="#__codelineno-0-1276">1276</a></span>
+<span class="normal"><a href="#__codelineno-0-1277">1277</a></span>
+<span class="normal"><a href="#__codelineno-0-1278">1278</a></span>
+<span class="normal"><a href="#__codelineno-0-1279">1279</a></span>
+<span class="normal"><a href="#__codelineno-0-1280">1280</a></span>
+<span class="normal"><a href="#__codelineno-0-1281">1281</a></span>
+<span class="normal"><a href="#__codelineno-0-1282">1282</a></span>
+<span class="normal"><a href="#__codelineno-0-1283">1283</a></span>
+<span class="normal"><a href="#__codelineno-0-1284">1284</a></span>
+<span class="normal"><a href="#__codelineno-0-1285">1285</a></span>
+<span class="normal"><a href="#__codelineno-0-1286">1286</a></span>
+<span class="normal"><a href="#__codelineno-0-1287">1287</a></span>
+<span class="normal"><a href="#__codelineno-0-1288">1288</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1142"><a id="__codelineno-0-1142" name="__codelineno-0-1142"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi</span><span class="p">(</span>
+</span><span id="__span-0-1143"><a id="__codelineno-0-1143" name="__codelineno-0-1143"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1144"><a id="__codelineno-0-1144" name="__codelineno-0-1144"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1145"><a id="__codelineno-0-1145" name="__codelineno-0-1145"></a>    <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+</span><span id="__span-0-1146"><a id="__codelineno-0-1146" name="__codelineno-0-1146"></a>    <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-1147"><a id="__codelineno-0-1147" name="__codelineno-0-1147"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1148"><a id="__codelineno-0-1148" name="__codelineno-0-1148"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1149"><a id="__codelineno-0-1149" name="__codelineno-0-1149"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1150"><a id="__codelineno-0-1150" name="__codelineno-0-1150"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1151"><a id="__codelineno-0-1151" name="__codelineno-0-1151"></a>    <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-1152"><a id="__codelineno-0-1152" name="__codelineno-0-1152"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1153"><a id="__codelineno-0-1153" name="__codelineno-0-1153"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">GetMultiResponseModel</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">],</span> <span class="n">GetMultiResponseDict</span><span class="p">]:</span>
+</span><span id="__span-0-1154"><a id="__codelineno-0-1154" name="__codelineno-0-1154"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1155"><a id="__codelineno-0-1155" name="__codelineno-0-1155"></a><span class="sd">    Fetches multiple records based on filters, supporting sorting, pagination.</span>
+</span><span id="__span-0-1156"><a id="__codelineno-0-1156" name="__codelineno-0-1156"></a>
+</span><span id="__span-0-1157"><a id="__codelineno-0-1157" name="__codelineno-0-1157"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1158"><a id="__codelineno-0-1158" name="__codelineno-0-1158"></a>
+</span><span id="__span-0-1159"><a id="__codelineno-0-1159" name="__codelineno-0-1159"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-1160"><a id="__codelineno-0-1160" name="__codelineno-0-1160"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-1161"><a id="__codelineno-0-1161" name="__codelineno-0-1161"></a><span class="sd">        offset: Starting index for records to fetch, useful for pagination.</span>
+</span><span id="__span-0-1162"><a id="__codelineno-0-1162" name="__codelineno-0-1162"></a><span class="sd">        limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
+</span><span id="__span-0-1163"><a id="__codelineno-0-1163" name="__codelineno-0-1163"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1164"><a id="__codelineno-0-1164" name="__codelineno-0-1164"></a><span class="sd">        sort_columns: Column names to sort the results by.</span>
+</span><span id="__span-0-1165"><a id="__codelineno-0-1165" name="__codelineno-0-1165"></a><span class="sd">        sort_orders: Corresponding sort orders (`&quot;asc&quot;`, `&quot;desc&quot;`) for each column in `sort_columns`.</span>
+</span><span id="__span-0-1166"><a id="__codelineno-0-1166" name="__codelineno-0-1166"></a><span class="sd">        return_as_model: If `True`, returns data as instances of the specified Pydantic model.</span>
+</span><span id="__span-0-1167"><a id="__codelineno-0-1167" name="__codelineno-0-1167"></a><span class="sd">        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
+</span><span id="__span-0-1168"><a id="__codelineno-0-1168" name="__codelineno-0-1168"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
+</span><span id="__span-0-1169"><a id="__codelineno-0-1169" name="__codelineno-0-1169"></a>
+</span><span id="__span-0-1170"><a id="__codelineno-0-1170" name="__codelineno-0-1170"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-1171"><a id="__codelineno-0-1171" name="__codelineno-0-1171"></a><span class="sd">        A dictionary containing the data list and optionally the total count:</span>
+</span><span id="__span-0-1172"><a id="__codelineno-0-1172" name="__codelineno-0-1172"></a><span class="sd">        - With return_as_model=True: Dict with &quot;data&quot;: List[SelectSchemaType]</span>
+</span><span id="__span-0-1173"><a id="__codelineno-0-1173" name="__codelineno-0-1173"></a><span class="sd">        - With return_as_model=False: Dict with &quot;data&quot;: List[Dict[str, Any]]</span>
+</span><span id="__span-0-1174"><a id="__codelineno-0-1174" name="__codelineno-0-1174"></a><span class="sd">        - If return_total_count=True, includes &quot;total_count&quot;: int</span>
+</span><span id="__span-0-1175"><a id="__codelineno-0-1175" name="__codelineno-0-1175"></a>
+</span><span id="__span-0-1176"><a id="__codelineno-0-1176" name="__codelineno-0-1176"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-1177"><a id="__codelineno-0-1177" name="__codelineno-0-1177"></a><span class="sd">        ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.</span>
 </span><span id="__span-0-1178"><a id="__codelineno-0-1178" name="__codelineno-0-1178"></a>
-</span><span id="__span-0-1179"><a id="__codelineno-0-1179" name="__codelineno-0-1179"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1180"><a id="__codelineno-0-1180" name="__codelineno-0-1180"></a><span class="sd">        users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1181"><a id="__codelineno-0-1181" name="__codelineno-0-1181"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1182"><a id="__codelineno-0-1182" name="__codelineno-0-1182"></a><span class="sd">            10,</span>
-</span><span id="__span-0-1183"><a id="__codelineno-0-1183" name="__codelineno-0-1183"></a><span class="sd">            10,</span>
-</span><span id="__span-0-1184"><a id="__codelineno-0-1184" name="__codelineno-0-1184"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1185"><a id="__codelineno-0-1185" name="__codelineno-0-1185"></a><span class="sd">            sort_orders=&#39;desc&#39;,</span>
-</span><span id="__span-0-1186"><a id="__codelineno-0-1186" name="__codelineno-0-1186"></a><span class="sd">        )</span>
-</span><span id="__span-0-1187"><a id="__codelineno-0-1187" name="__codelineno-0-1187"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1188"><a id="__codelineno-0-1188" name="__codelineno-0-1188"></a>
-</span><span id="__span-0-1189"><a id="__codelineno-0-1189" name="__codelineno-0-1189"></a><span class="sd">        Fetch 10 users older than 30, sorted by age in descending order:</span>
-</span><span id="__span-0-1190"><a id="__codelineno-0-1190" name="__codelineno-0-1190"></a>
-</span><span id="__span-0-1191"><a id="__codelineno-0-1191" name="__codelineno-0-1191"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1192"><a id="__codelineno-0-1192" name="__codelineno-0-1192"></a><span class="sd">        users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1193"><a id="__codelineno-0-1193" name="__codelineno-0-1193"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1194"><a id="__codelineno-0-1194" name="__codelineno-0-1194"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1195"><a id="__codelineno-0-1195" name="__codelineno-0-1195"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1196"><a id="__codelineno-0-1196" name="__codelineno-0-1196"></a><span class="sd">            sort_columns=&#39;age&#39;,</span>
-</span><span id="__span-0-1197"><a id="__codelineno-0-1197" name="__codelineno-0-1197"></a><span class="sd">            sort_orders=&#39;desc&#39;,</span>
-</span><span id="__span-0-1198"><a id="__codelineno-0-1198" name="__codelineno-0-1198"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-1179"><a id="__codelineno-0-1179" name="__codelineno-0-1179"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-1180"><a id="__codelineno-0-1180" name="__codelineno-0-1180"></a><span class="sd">        Fetch the first 10 users:</span>
+</span><span id="__span-0-1181"><a id="__codelineno-0-1181" name="__codelineno-0-1181"></a>
+</span><span id="__span-0-1182"><a id="__codelineno-0-1182" name="__codelineno-0-1182"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1183"><a id="__codelineno-0-1183" name="__codelineno-0-1183"></a><span class="sd">        users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1184"><a id="__codelineno-0-1184" name="__codelineno-0-1184"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1185"><a id="__codelineno-0-1185" name="__codelineno-0-1185"></a><span class="sd">            0,</span>
+</span><span id="__span-0-1186"><a id="__codelineno-0-1186" name="__codelineno-0-1186"></a><span class="sd">            10,</span>
+</span><span id="__span-0-1187"><a id="__codelineno-0-1187" name="__codelineno-0-1187"></a><span class="sd">        )</span>
+</span><span id="__span-0-1188"><a id="__codelineno-0-1188" name="__codelineno-0-1188"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1189"><a id="__codelineno-0-1189" name="__codelineno-0-1189"></a>
+</span><span id="__span-0-1190"><a id="__codelineno-0-1190" name="__codelineno-0-1190"></a><span class="sd">        Fetch next 10 users with sorted by username:</span>
+</span><span id="__span-0-1191"><a id="__codelineno-0-1191" name="__codelineno-0-1191"></a>
+</span><span id="__span-0-1192"><a id="__codelineno-0-1192" name="__codelineno-0-1192"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1193"><a id="__codelineno-0-1193" name="__codelineno-0-1193"></a><span class="sd">        users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1194"><a id="__codelineno-0-1194" name="__codelineno-0-1194"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1195"><a id="__codelineno-0-1195" name="__codelineno-0-1195"></a><span class="sd">            10,</span>
+</span><span id="__span-0-1196"><a id="__codelineno-0-1196" name="__codelineno-0-1196"></a><span class="sd">            10,</span>
+</span><span id="__span-0-1197"><a id="__codelineno-0-1197" name="__codelineno-0-1197"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1198"><a id="__codelineno-0-1198" name="__codelineno-0-1198"></a><span class="sd">            sort_orders=&#39;desc&#39;,</span>
 </span><span id="__span-0-1199"><a id="__codelineno-0-1199" name="__codelineno-0-1199"></a><span class="sd">        )</span>
 </span><span id="__span-0-1200"><a id="__codelineno-0-1200" name="__codelineno-0-1200"></a><span class="sd">        ```</span>
 </span><span id="__span-0-1201"><a id="__codelineno-0-1201" name="__codelineno-0-1201"></a>
-</span><span id="__span-0-1202"><a id="__codelineno-0-1202" name="__codelineno-0-1202"></a><span class="sd">        Fetch 10 users with a registration date before Jan 1, 2020:</span>
-</span><span id="__span-0-1203"><a id="__codelineno-0-1203" name="__codelineno-0-1203"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1204"><a id="__codelineno-0-1204" name="__codelineno-0-1204"></a><span class="sd">        users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1205"><a id="__codelineno-0-1205" name="__codelineno-0-1205"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1206"><a id="__codelineno-0-1206" name="__codelineno-0-1206"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1207"><a id="__codelineno-0-1207" name="__codelineno-0-1207"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1208"><a id="__codelineno-0-1208" name="__codelineno-0-1208"></a><span class="sd">            registration_date__lt=datetime(2020, 1, 1),</span>
-</span><span id="__span-0-1209"><a id="__codelineno-0-1209" name="__codelineno-0-1209"></a><span class="sd">        )</span>
-</span><span id="__span-0-1210"><a id="__codelineno-0-1210" name="__codelineno-0-1210"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1211"><a id="__codelineno-0-1211" name="__codelineno-0-1211"></a>
-</span><span id="__span-0-1212"><a id="__codelineno-0-1212" name="__codelineno-0-1212"></a><span class="sd">        Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):</span>
-</span><span id="__span-0-1213"><a id="__codelineno-0-1213" name="__codelineno-0-1213"></a>
-</span><span id="__span-0-1214"><a id="__codelineno-0-1214" name="__codelineno-0-1214"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1215"><a id="__codelineno-0-1215" name="__codelineno-0-1215"></a><span class="sd">        users = await user_crud.get_multi(</span>
-</span><span id="__span-0-1216"><a id="__codelineno-0-1216" name="__codelineno-0-1216"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1217"><a id="__codelineno-0-1217" name="__codelineno-0-1217"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1218"><a id="__codelineno-0-1218" name="__codelineno-0-1218"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1219"><a id="__codelineno-0-1219" name="__codelineno-0-1219"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1220"><a id="__codelineno-0-1220" name="__codelineno-0-1220"></a><span class="sd">            return_as_model=True,</span>
-</span><span id="__span-0-1221"><a id="__codelineno-0-1221" name="__codelineno-0-1221"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1202"><a id="__codelineno-0-1202" name="__codelineno-0-1202"></a><span class="sd">        Fetch 10 users older than 30, sorted by age in descending order:</span>
+</span><span id="__span-0-1203"><a id="__codelineno-0-1203" name="__codelineno-0-1203"></a>
+</span><span id="__span-0-1204"><a id="__codelineno-0-1204" name="__codelineno-0-1204"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1205"><a id="__codelineno-0-1205" name="__codelineno-0-1205"></a><span class="sd">        users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1206"><a id="__codelineno-0-1206" name="__codelineno-0-1206"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1207"><a id="__codelineno-0-1207" name="__codelineno-0-1207"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1208"><a id="__codelineno-0-1208" name="__codelineno-0-1208"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1209"><a id="__codelineno-0-1209" name="__codelineno-0-1209"></a><span class="sd">            sort_columns=&#39;age&#39;,</span>
+</span><span id="__span-0-1210"><a id="__codelineno-0-1210" name="__codelineno-0-1210"></a><span class="sd">            sort_orders=&#39;desc&#39;,</span>
+</span><span id="__span-0-1211"><a id="__codelineno-0-1211" name="__codelineno-0-1211"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-1212"><a id="__codelineno-0-1212" name="__codelineno-0-1212"></a><span class="sd">        )</span>
+</span><span id="__span-0-1213"><a id="__codelineno-0-1213" name="__codelineno-0-1213"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1214"><a id="__codelineno-0-1214" name="__codelineno-0-1214"></a>
+</span><span id="__span-0-1215"><a id="__codelineno-0-1215" name="__codelineno-0-1215"></a><span class="sd">        Fetch 10 users with a registration date before Jan 1, 2020:</span>
+</span><span id="__span-0-1216"><a id="__codelineno-0-1216" name="__codelineno-0-1216"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1217"><a id="__codelineno-0-1217" name="__codelineno-0-1217"></a><span class="sd">        users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1218"><a id="__codelineno-0-1218" name="__codelineno-0-1218"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1219"><a id="__codelineno-0-1219" name="__codelineno-0-1219"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1220"><a id="__codelineno-0-1220" name="__codelineno-0-1220"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1221"><a id="__codelineno-0-1221" name="__codelineno-0-1221"></a><span class="sd">            registration_date__lt=datetime(2020, 1, 1),</span>
 </span><span id="__span-0-1222"><a id="__codelineno-0-1222" name="__codelineno-0-1222"></a><span class="sd">        )</span>
 </span><span id="__span-0-1223"><a id="__codelineno-0-1223" name="__codelineno-0-1223"></a><span class="sd">        ```</span>
 </span><span id="__span-0-1224"><a id="__codelineno-0-1224" name="__codelineno-0-1224"></a>
-</span><span id="__span-0-1225"><a id="__codelineno-0-1225" name="__codelineno-0-1225"></a><span class="sd">        Fetch users with filtering and multiple column sorting:</span>
+</span><span id="__span-0-1225"><a id="__codelineno-0-1225" name="__codelineno-0-1225"></a><span class="sd">        Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):</span>
 </span><span id="__span-0-1226"><a id="__codelineno-0-1226" name="__codelineno-0-1226"></a>
 </span><span id="__span-0-1227"><a id="__codelineno-0-1227" name="__codelineno-0-1227"></a><span class="sd">        ```python</span>
 </span><span id="__span-0-1228"><a id="__codelineno-0-1228" name="__codelineno-0-1228"></a><span class="sd">        users = await user_crud.get_multi(</span>
 </span><span id="__span-0-1229"><a id="__codelineno-0-1229" name="__codelineno-0-1229"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1230"><a id="__codelineno-0-1230" name="__codelineno-0-1230"></a><span class="sd">            0,</span>
-</span><span id="__span-0-1231"><a id="__codelineno-0-1231" name="__codelineno-0-1231"></a><span class="sd">            10,</span>
-</span><span id="__span-0-1232"><a id="__codelineno-0-1232" name="__codelineno-0-1232"></a><span class="sd">            sort_columns=[&#39;username&#39;, &#39;email&#39;],</span>
-</span><span id="__span-0-1233"><a id="__codelineno-0-1233" name="__codelineno-0-1233"></a><span class="sd">            sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
-</span><span id="__span-0-1234"><a id="__codelineno-0-1234" name="__codelineno-0-1234"></a><span class="sd">            is_active=True,</span>
+</span><span id="__span-0-1230"><a id="__codelineno-0-1230" name="__codelineno-0-1230"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1231"><a id="__codelineno-0-1231" name="__codelineno-0-1231"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1232"><a id="__codelineno-0-1232" name="__codelineno-0-1232"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1233"><a id="__codelineno-0-1233" name="__codelineno-0-1233"></a><span class="sd">            return_as_model=True,</span>
+</span><span id="__span-0-1234"><a id="__codelineno-0-1234" name="__codelineno-0-1234"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
 </span><span id="__span-0-1235"><a id="__codelineno-0-1235" name="__codelineno-0-1235"></a><span class="sd">        )</span>
 </span><span id="__span-0-1236"><a id="__codelineno-0-1236" name="__codelineno-0-1236"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1237"><a id="__codelineno-0-1237" name="__codelineno-0-1237"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-1238"><a id="__codelineno-0-1238" name="__codelineno-0-1238"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-1239"><a id="__codelineno-0-1239" name="__codelineno-0-1239"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1240"><a id="__codelineno-0-1240" name="__codelineno-0-1240"></a>
-</span><span id="__span-0-1241"><a id="__codelineno-0-1241" name="__codelineno-0-1241"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
-</span><span id="__span-0-1242"><a id="__codelineno-0-1242" name="__codelineno-0-1242"></a>        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1243"><a id="__codelineno-0-1243" name="__codelineno-0-1243"></a>        <span class="n">sort_columns</span><span class="o">=</span><span class="n">sort_columns</span><span class="p">,</span>
-</span><span id="__span-0-1244"><a id="__codelineno-0-1244" name="__codelineno-0-1244"></a>        <span class="n">sort_orders</span><span class="o">=</span><span class="n">sort_orders</span><span class="p">,</span>
-</span><span id="__span-0-1245"><a id="__codelineno-0-1245" name="__codelineno-0-1245"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
-</span><span id="__span-0-1246"><a id="__codelineno-0-1246" name="__codelineno-0-1246"></a>    <span class="p">)</span>
-</span><span id="__span-0-1247"><a id="__codelineno-0-1247" name="__codelineno-0-1247"></a>
-</span><span id="__span-0-1248"><a id="__codelineno-0-1248" name="__codelineno-0-1248"></a>    <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
-</span><span id="__span-0-1249"><a id="__codelineno-0-1249" name="__codelineno-0-1249"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
-</span><span id="__span-0-1250"><a id="__codelineno-0-1250" name="__codelineno-0-1250"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1251"><a id="__codelineno-0-1251" name="__codelineno-0-1251"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-1252"><a id="__codelineno-0-1252" name="__codelineno-0-1252"></a>
-</span><span id="__span-0-1253"><a id="__codelineno-0-1253" name="__codelineno-0-1253"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1254"><a id="__codelineno-0-1254" name="__codelineno-0-1254"></a>    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
-</span><span id="__span-0-1255"><a id="__codelineno-0-1255" name="__codelineno-0-1255"></a>
-</span><span id="__span-0-1256"><a id="__codelineno-0-1256" name="__codelineno-0-1256"></a>    <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
-</span><span id="__span-0-1257"><a id="__codelineno-0-1257" name="__codelineno-0-1257"></a>
-</span><span id="__span-0-1258"><a id="__codelineno-0-1258" name="__codelineno-0-1258"></a>    <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
-</span><span id="__span-0-1259"><a id="__codelineno-0-1259" name="__codelineno-0-1259"></a>        <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1260"><a id="__codelineno-0-1260" name="__codelineno-0-1260"></a>        <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
-</span><span id="__span-0-1261"><a id="__codelineno-0-1261" name="__codelineno-0-1261"></a>
-</span><span id="__span-0-1262"><a id="__codelineno-0-1262" name="__codelineno-0-1262"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-1263"><a id="__codelineno-0-1263" name="__codelineno-0-1263"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
-</span><span id="__span-0-1264"><a id="__codelineno-0-1264" name="__codelineno-0-1264"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1265"><a id="__codelineno-0-1265" name="__codelineno-0-1265"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-1266"><a id="__codelineno-0-1266" name="__codelineno-0-1266"></a>            <span class="p">)</span>
-</span><span id="__span-0-1267"><a id="__codelineno-0-1267" name="__codelineno-0-1267"></a>        <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-1268"><a id="__codelineno-0-1268" name="__codelineno-0-1268"></a>            <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
-</span><span id="__span-0-1269"><a id="__codelineno-0-1269" name="__codelineno-0-1269"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
-</span><span id="__span-0-1270"><a id="__codelineno-0-1270" name="__codelineno-0-1270"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-1271"><a id="__codelineno-0-1271" name="__codelineno-0-1271"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1272"><a id="__codelineno-0-1272" name="__codelineno-0-1272"></a>                <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-1273"><a id="__codelineno-0-1273" name="__codelineno-0-1273"></a>            <span class="p">)</span>
+</span><span id="__span-0-1237"><a id="__codelineno-0-1237" name="__codelineno-0-1237"></a>
+</span><span id="__span-0-1238"><a id="__codelineno-0-1238" name="__codelineno-0-1238"></a><span class="sd">        Fetch users with filtering and multiple column sorting:</span>
+</span><span id="__span-0-1239"><a id="__codelineno-0-1239" name="__codelineno-0-1239"></a>
+</span><span id="__span-0-1240"><a id="__codelineno-0-1240" name="__codelineno-0-1240"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1241"><a id="__codelineno-0-1241" name="__codelineno-0-1241"></a><span class="sd">        users = await user_crud.get_multi(</span>
+</span><span id="__span-0-1242"><a id="__codelineno-0-1242" name="__codelineno-0-1242"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1243"><a id="__codelineno-0-1243" name="__codelineno-0-1243"></a><span class="sd">            0,</span>
+</span><span id="__span-0-1244"><a id="__codelineno-0-1244" name="__codelineno-0-1244"></a><span class="sd">            10,</span>
+</span><span id="__span-0-1245"><a id="__codelineno-0-1245" name="__codelineno-0-1245"></a><span class="sd">            sort_columns=[&#39;username&#39;, &#39;email&#39;],</span>
+</span><span id="__span-0-1246"><a id="__codelineno-0-1246" name="__codelineno-0-1246"></a><span class="sd">            sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
+</span><span id="__span-0-1247"><a id="__codelineno-0-1247" name="__codelineno-0-1247"></a><span class="sd">            is_active=True,</span>
+</span><span id="__span-0-1248"><a id="__codelineno-0-1248" name="__codelineno-0-1248"></a><span class="sd">        )</span>
+</span><span id="__span-0-1249"><a id="__codelineno-0-1249" name="__codelineno-0-1249"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1250"><a id="__codelineno-0-1250" name="__codelineno-0-1250"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-1251"><a id="__codelineno-0-1251" name="__codelineno-0-1251"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-1252"><a id="__codelineno-0-1252" name="__codelineno-0-1252"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1253"><a id="__codelineno-0-1253" name="__codelineno-0-1253"></a>
+</span><span id="__span-0-1254"><a id="__codelineno-0-1254" name="__codelineno-0-1254"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
+</span><span id="__span-0-1255"><a id="__codelineno-0-1255" name="__codelineno-0-1255"></a>        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1256"><a id="__codelineno-0-1256" name="__codelineno-0-1256"></a>        <span class="n">sort_columns</span><span class="o">=</span><span class="n">sort_columns</span><span class="p">,</span>
+</span><span id="__span-0-1257"><a id="__codelineno-0-1257" name="__codelineno-0-1257"></a>        <span class="n">sort_orders</span><span class="o">=</span><span class="n">sort_orders</span><span class="p">,</span>
+</span><span id="__span-0-1258"><a id="__codelineno-0-1258" name="__codelineno-0-1258"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
+</span><span id="__span-0-1259"><a id="__codelineno-0-1259" name="__codelineno-0-1259"></a>    <span class="p">)</span>
+</span><span id="__span-0-1260"><a id="__codelineno-0-1260" name="__codelineno-0-1260"></a>
+</span><span id="__span-0-1261"><a id="__codelineno-0-1261" name="__codelineno-0-1261"></a>    <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
+</span><span id="__span-0-1262"><a id="__codelineno-0-1262" name="__codelineno-0-1262"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
+</span><span id="__span-0-1263"><a id="__codelineno-0-1263" name="__codelineno-0-1263"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1264"><a id="__codelineno-0-1264" name="__codelineno-0-1264"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-1265"><a id="__codelineno-0-1265" name="__codelineno-0-1265"></a>
+</span><span id="__span-0-1266"><a id="__codelineno-0-1266" name="__codelineno-0-1266"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1267"><a id="__codelineno-0-1267" name="__codelineno-0-1267"></a>    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
+</span><span id="__span-0-1268"><a id="__codelineno-0-1268" name="__codelineno-0-1268"></a>
+</span><span id="__span-0-1269"><a id="__codelineno-0-1269" name="__codelineno-0-1269"></a>    <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">}</span>
+</span><span id="__span-0-1270"><a id="__codelineno-0-1270" name="__codelineno-0-1270"></a>
+</span><span id="__span-0-1271"><a id="__codelineno-0-1271" name="__codelineno-0-1271"></a>    <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
+</span><span id="__span-0-1272"><a id="__codelineno-0-1272" name="__codelineno-0-1272"></a>        <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1273"><a id="__codelineno-0-1273" name="__codelineno-0-1273"></a>        <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
 </span><span id="__span-0-1274"><a id="__codelineno-0-1274" name="__codelineno-0-1274"></a>
-</span><span id="__span-0-1275"><a id="__codelineno-0-1275" name="__codelineno-0-1275"></a>    <span class="k">return</span> <span class="n">response</span>
+</span><span id="__span-0-1275"><a id="__codelineno-0-1275" name="__codelineno-0-1275"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-1276"><a id="__codelineno-0-1276" name="__codelineno-0-1276"></a>        <span class="k">if</span> <span class="ow">not</span> <span class="n">schema_to_select</span><span class="p">:</span>
+</span><span id="__span-0-1277"><a id="__codelineno-0-1277" name="__codelineno-0-1277"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1278"><a id="__codelineno-0-1278" name="__codelineno-0-1278"></a>                <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-1279"><a id="__codelineno-0-1279" name="__codelineno-0-1279"></a>            <span class="p">)</span>
+</span><span id="__span-0-1280"><a id="__codelineno-0-1280" name="__codelineno-0-1280"></a>        <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1281"><a id="__codelineno-0-1281" name="__codelineno-0-1281"></a>            <span class="n">model_data</span> <span class="o">=</span> <span class="p">[</span><span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">data</span><span class="p">]</span>
+</span><span id="__span-0-1282"><a id="__codelineno-0-1282" name="__codelineno-0-1282"></a>            <span class="n">response</span><span class="p">[</span><span class="s2">&quot;data&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">model_data</span>
+</span><span id="__span-0-1283"><a id="__codelineno-0-1283" name="__codelineno-0-1283"></a>        <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-1284"><a id="__codelineno-0-1284" name="__codelineno-0-1284"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1285"><a id="__codelineno-0-1285" name="__codelineno-0-1285"></a>                <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-1286"><a id="__codelineno-0-1286" name="__codelineno-0-1286"></a>            <span class="p">)</span>
+</span><span id="__span-0-1287"><a id="__codelineno-0-1287" name="__codelineno-0-1287"></a>
+</span><span id="__span-0-1288"><a id="__codelineno-0-1288" name="__codelineno-0-1288"></a>    <span class="k">return</span> <span class="n">response</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -10539,7 +10675,7 @@ <h2 id="fastcrud.FastCRUD.get_multi_by_cursor" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -10667,24 +10803,7 @@ <h2 id="fastcrud.FastCRUD.get_multi_by_cursor" class="doc doc-heading">
 </details>
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1998">1998</a></span>
-<span class="normal"><a href="#__codelineno-0-1999">1999</a></span>
-<span class="normal"><a href="#__codelineno-0-2000">2000</a></span>
-<span class="normal"><a href="#__codelineno-0-2001">2001</a></span>
-<span class="normal"><a href="#__codelineno-0-2002">2002</a></span>
-<span class="normal"><a href="#__codelineno-0-2003">2003</a></span>
-<span class="normal"><a href="#__codelineno-0-2004">2004</a></span>
-<span class="normal"><a href="#__codelineno-0-2005">2005</a></span>
-<span class="normal"><a href="#__codelineno-0-2006">2006</a></span>
-<span class="normal"><a href="#__codelineno-0-2007">2007</a></span>
-<span class="normal"><a href="#__codelineno-0-2008">2008</a></span>
-<span class="normal"><a href="#__codelineno-0-2009">2009</a></span>
-<span class="normal"><a href="#__codelineno-0-2010">2010</a></span>
-<span class="normal"><a href="#__codelineno-0-2011">2011</a></span>
-<span class="normal"><a href="#__codelineno-0-2012">2012</a></span>
-<span class="normal"><a href="#__codelineno-0-2013">2013</a></span>
-<span class="normal"><a href="#__codelineno-0-2014">2014</a></span>
-<span class="normal"><a href="#__codelineno-0-2015">2015</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2015">2015</a></span>
 <span class="normal"><a href="#__codelineno-0-2016">2016</a></span>
 <span class="normal"><a href="#__codelineno-0-2017">2017</a></span>
 <span class="normal"><a href="#__codelineno-0-2018">2018</a></span>
@@ -10776,116 +10895,127 @@ <h2 id="fastcrud.FastCRUD.get_multi_by_cursor" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-2104">2104</a></span>
 <span class="normal"><a href="#__codelineno-0-2105">2105</a></span>
 <span class="normal"><a href="#__codelineno-0-2106">2106</a></span>
-<span class="normal"><a href="#__codelineno-0-2107">2107</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1998"><a id="__codelineno-0-1998" name="__codelineno-0-1998"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_by_cursor</span><span class="p">(</span>
-</span><span id="__span-0-1999"><a id="__codelineno-0-1999" name="__codelineno-0-1999"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2000"><a id="__codelineno-0-2000" name="__codelineno-0-2000"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2001"><a id="__codelineno-0-2001" name="__codelineno-0-2001"></a>    <span class="n">cursor</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2002"><a id="__codelineno-0-2002" name="__codelineno-0-2002"></a>    <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-2003"><a id="__codelineno-0-2003" name="__codelineno-0-2003"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2004"><a id="__codelineno-0-2004" name="__codelineno-0-2004"></a>    <span class="n">sort_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;id&quot;</span><span class="p">,</span>
-</span><span id="__span-0-2005"><a id="__codelineno-0-2005" name="__codelineno-0-2005"></a>    <span class="n">sort_order</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;asc&quot;</span><span class="p">,</span>
-</span><span id="__span-0-2006"><a id="__codelineno-0-2006" name="__codelineno-0-2006"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2007"><a id="__codelineno-0-2007" name="__codelineno-0-2007"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-2008"><a id="__codelineno-0-2008" name="__codelineno-0-2008"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2009"><a id="__codelineno-0-2009" name="__codelineno-0-2009"></a><span class="sd">    Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</span>
-</span><span id="__span-0-2010"><a id="__codelineno-0-2010" name="__codelineno-0-2010"></a>
-</span><span id="__span-0-2011"><a id="__codelineno-0-2011" name="__codelineno-0-2011"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2012"><a id="__codelineno-0-2012" name="__codelineno-0-2012"></a>
-</span><span id="__span-0-2013"><a id="__codelineno-0-2013" name="__codelineno-0-2013"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-2014"><a id="__codelineno-0-2014" name="__codelineno-0-2014"></a><span class="sd">        db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-2015"><a id="__codelineno-0-2015" name="__codelineno-0-2015"></a><span class="sd">        cursor: The cursor value to start fetching records from. Defaults to `None`.</span>
-</span><span id="__span-0-2016"><a id="__codelineno-0-2016" name="__codelineno-0-2016"></a><span class="sd">        limit: Maximum number of rows to fetch.</span>
-</span><span id="__span-0-2017"><a id="__codelineno-0-2017" name="__codelineno-0-2017"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns.</span>
-</span><span id="__span-0-2018"><a id="__codelineno-0-2018" name="__codelineno-0-2018"></a><span class="sd">        sort_column: Column name to use for sorting and cursor pagination.</span>
-</span><span id="__span-0-2019"><a id="__codelineno-0-2019" name="__codelineno-0-2019"></a><span class="sd">        sort_order: Sorting direction, either `&quot;asc&quot;` or `&quot;desc&quot;`.</span>
-</span><span id="__span-0-2020"><a id="__codelineno-0-2020" name="__codelineno-0-2020"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.</span>
-</span><span id="__span-0-2021"><a id="__codelineno-0-2021" name="__codelineno-0-2021"></a>
-</span><span id="__span-0-2022"><a id="__codelineno-0-2022" name="__codelineno-0-2022"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-2023"><a id="__codelineno-0-2023" name="__codelineno-0-2023"></a><span class="sd">        A dictionary containing the fetched rows under `&quot;data&quot;` key and the next cursor value under `&quot;next_cursor&quot;`.</span>
-</span><span id="__span-0-2024"><a id="__codelineno-0-2024" name="__codelineno-0-2024"></a>
-</span><span id="__span-0-2025"><a id="__codelineno-0-2025" name="__codelineno-0-2025"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-2026"><a id="__codelineno-0-2026" name="__codelineno-0-2026"></a><span class="sd">        Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</span>
+<span class="normal"><a href="#__codelineno-0-2107">2107</a></span>
+<span class="normal"><a href="#__codelineno-0-2108">2108</a></span>
+<span class="normal"><a href="#__codelineno-0-2109">2109</a></span>
+<span class="normal"><a href="#__codelineno-0-2110">2110</a></span>
+<span class="normal"><a href="#__codelineno-0-2111">2111</a></span>
+<span class="normal"><a href="#__codelineno-0-2112">2112</a></span>
+<span class="normal"><a href="#__codelineno-0-2113">2113</a></span>
+<span class="normal"><a href="#__codelineno-0-2114">2114</a></span>
+<span class="normal"><a href="#__codelineno-0-2115">2115</a></span>
+<span class="normal"><a href="#__codelineno-0-2116">2116</a></span>
+<span class="normal"><a href="#__codelineno-0-2117">2117</a></span>
+<span class="normal"><a href="#__codelineno-0-2118">2118</a></span>
+<span class="normal"><a href="#__codelineno-0-2119">2119</a></span>
+<span class="normal"><a href="#__codelineno-0-2120">2120</a></span>
+<span class="normal"><a href="#__codelineno-0-2121">2121</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2015"><a id="__codelineno-0-2015" name="__codelineno-0-2015"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_by_cursor</span><span class="p">(</span>
+</span><span id="__span-0-2016"><a id="__codelineno-0-2016" name="__codelineno-0-2016"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2017"><a id="__codelineno-0-2017" name="__codelineno-0-2017"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2018"><a id="__codelineno-0-2018" name="__codelineno-0-2018"></a>    <span class="n">cursor</span><span class="p">:</span> <span class="n">Any</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2019"><a id="__codelineno-0-2019" name="__codelineno-0-2019"></a>    <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-2020"><a id="__codelineno-0-2020" name="__codelineno-0-2020"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2021"><a id="__codelineno-0-2021" name="__codelineno-0-2021"></a>    <span class="n">sort_column</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;id&quot;</span><span class="p">,</span>
+</span><span id="__span-0-2022"><a id="__codelineno-0-2022" name="__codelineno-0-2022"></a>    <span class="n">sort_order</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;asc&quot;</span><span class="p">,</span>
+</span><span id="__span-0-2023"><a id="__codelineno-0-2023" name="__codelineno-0-2023"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2024"><a id="__codelineno-0-2024" name="__codelineno-0-2024"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+</span><span id="__span-0-2025"><a id="__codelineno-0-2025" name="__codelineno-0-2025"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2026"><a id="__codelineno-0-2026" name="__codelineno-0-2026"></a><span class="sd">    Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</span>
 </span><span id="__span-0-2027"><a id="__codelineno-0-2027" name="__codelineno-0-2027"></a>
-</span><span id="__span-0-2028"><a id="__codelineno-0-2028" name="__codelineno-0-2028"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2029"><a id="__codelineno-0-2029" name="__codelineno-0-2029"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2030"><a id="__codelineno-0-2030" name="__codelineno-0-2030"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2031"><a id="__codelineno-0-2031" name="__codelineno-0-2031"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-2032"><a id="__codelineno-0-2032" name="__codelineno-0-2032"></a><span class="sd">            sort_column=&#39;registration_date&#39;,</span>
-</span><span id="__span-0-2033"><a id="__codelineno-0-2033" name="__codelineno-0-2033"></a><span class="sd">            sort_order=&#39;desc&#39;,</span>
-</span><span id="__span-0-2034"><a id="__codelineno-0-2034" name="__codelineno-0-2034"></a><span class="sd">        )</span>
-</span><span id="__span-0-2035"><a id="__codelineno-0-2035" name="__codelineno-0-2035"></a>
-</span><span id="__span-0-2036"><a id="__codelineno-0-2036" name="__codelineno-0-2036"></a><span class="sd">        # Fetch the next set of records using the cursor from the first page</span>
-</span><span id="__span-0-2037"><a id="__codelineno-0-2037" name="__codelineno-0-2037"></a><span class="sd">        next_cursor = first_page[&#39;next_cursor&#39;]</span>
-</span><span id="__span-0-2038"><a id="__codelineno-0-2038" name="__codelineno-0-2038"></a><span class="sd">        second_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2039"><a id="__codelineno-0-2039" name="__codelineno-0-2039"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2040"><a id="__codelineno-0-2040" name="__codelineno-0-2040"></a><span class="sd">            cursor=next_cursor,</span>
-</span><span id="__span-0-2041"><a id="__codelineno-0-2041" name="__codelineno-0-2041"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-2042"><a id="__codelineno-0-2042" name="__codelineno-0-2042"></a><span class="sd">            sort_column=&#39;registration_date&#39;,</span>
-</span><span id="__span-0-2043"><a id="__codelineno-0-2043" name="__codelineno-0-2043"></a><span class="sd">            sort_order=&#39;desc&#39;,</span>
-</span><span id="__span-0-2044"><a id="__codelineno-0-2044" name="__codelineno-0-2044"></a><span class="sd">        )</span>
-</span><span id="__span-0-2045"><a id="__codelineno-0-2045" name="__codelineno-0-2045"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2046"><a id="__codelineno-0-2046" name="__codelineno-0-2046"></a>
-</span><span id="__span-0-2047"><a id="__codelineno-0-2047" name="__codelineno-0-2047"></a><span class="sd">        Fetch records with age greater than 30 using cursor-based pagination:</span>
-</span><span id="__span-0-2048"><a id="__codelineno-0-2048" name="__codelineno-0-2048"></a>
-</span><span id="__span-0-2049"><a id="__codelineno-0-2049" name="__codelineno-0-2049"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2050"><a id="__codelineno-0-2050" name="__codelineno-0-2050"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2051"><a id="__codelineno-0-2051" name="__codelineno-0-2051"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2052"><a id="__codelineno-0-2052" name="__codelineno-0-2052"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-2053"><a id="__codelineno-0-2053" name="__codelineno-0-2053"></a><span class="sd">            sort_column=&#39;age&#39;,</span>
-</span><span id="__span-0-2054"><a id="__codelineno-0-2054" name="__codelineno-0-2054"></a><span class="sd">            sort_order=&#39;asc&#39;,</span>
-</span><span id="__span-0-2055"><a id="__codelineno-0-2055" name="__codelineno-0-2055"></a><span class="sd">            age__gt=30,</span>
-</span><span id="__span-0-2056"><a id="__codelineno-0-2056" name="__codelineno-0-2056"></a><span class="sd">        )</span>
-</span><span id="__span-0-2057"><a id="__codelineno-0-2057" name="__codelineno-0-2057"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2058"><a id="__codelineno-0-2058" name="__codelineno-0-2058"></a>
-</span><span id="__span-0-2059"><a id="__codelineno-0-2059" name="__codelineno-0-2059"></a><span class="sd">        Fetch records excluding a specific username using cursor-based pagination:</span>
-</span><span id="__span-0-2060"><a id="__codelineno-0-2060" name="__codelineno-0-2060"></a>
-</span><span id="__span-0-2061"><a id="__codelineno-0-2061" name="__codelineno-0-2061"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2062"><a id="__codelineno-0-2062" name="__codelineno-0-2062"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
-</span><span id="__span-0-2063"><a id="__codelineno-0-2063" name="__codelineno-0-2063"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2064"><a id="__codelineno-0-2064" name="__codelineno-0-2064"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-2065"><a id="__codelineno-0-2065" name="__codelineno-0-2065"></a><span class="sd">            sort_column=&#39;username&#39;,</span>
-</span><span id="__span-0-2066"><a id="__codelineno-0-2066" name="__codelineno-0-2066"></a><span class="sd">            sort_order=&#39;asc&#39;,</span>
-</span><span id="__span-0-2067"><a id="__codelineno-0-2067" name="__codelineno-0-2067"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
-</span><span id="__span-0-2068"><a id="__codelineno-0-2068" name="__codelineno-0-2068"></a><span class="sd">        )</span>
-</span><span id="__span-0-2069"><a id="__codelineno-0-2069" name="__codelineno-0-2069"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2070"><a id="__codelineno-0-2070" name="__codelineno-0-2070"></a>
-</span><span id="__span-0-2071"><a id="__codelineno-0-2071" name="__codelineno-0-2071"></a><span class="sd">    Note:</span>
-</span><span id="__span-0-2072"><a id="__codelineno-0-2072" name="__codelineno-0-2072"></a><span class="sd">        This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.</span>
-</span><span id="__span-0-2073"><a id="__codelineno-0-2073" name="__codelineno-0-2073"></a><span class="sd">        Make sure the column used for cursor pagination is indexed for performance.</span>
-</span><span id="__span-0-2074"><a id="__codelineno-0-2074" name="__codelineno-0-2074"></a><span class="sd">        This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).</span>
-</span><span id="__span-0-2075"><a id="__codelineno-0-2075" name="__codelineno-0-2075"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-2076"><a id="__codelineno-0-2076" name="__codelineno-0-2076"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-2077"><a id="__codelineno-0-2077" name="__codelineno-0-2077"></a>        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="p">[],</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">}</span>
-</span><span id="__span-0-2078"><a id="__codelineno-0-2078" name="__codelineno-0-2078"></a>
-</span><span id="__span-0-2079"><a id="__codelineno-0-2079" name="__codelineno-0-2079"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span>
-</span><span id="__span-0-2080"><a id="__codelineno-0-2080" name="__codelineno-0-2080"></a>        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2081"><a id="__codelineno-0-2081" name="__codelineno-0-2081"></a>        <span class="o">**</span><span class="n">kwargs</span><span class="p">,</span>
-</span><span id="__span-0-2082"><a id="__codelineno-0-2082" name="__codelineno-0-2082"></a>    <span class="p">)</span>
-</span><span id="__span-0-2083"><a id="__codelineno-0-2083" name="__codelineno-0-2083"></a>
-</span><span id="__span-0-2084"><a id="__codelineno-0-2084" name="__codelineno-0-2084"></a>    <span class="k">if</span> <span class="n">cursor</span><span class="p">:</span>
-</span><span id="__span-0-2085"><a id="__codelineno-0-2085" name="__codelineno-0-2085"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
-</span><span id="__span-0-2086"><a id="__codelineno-0-2086" name="__codelineno-0-2086"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">cursor</span><span class="p">)</span>
-</span><span id="__span-0-2087"><a id="__codelineno-0-2087" name="__codelineno-0-2087"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2088"><a id="__codelineno-0-2088" name="__codelineno-0-2088"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&lt;</span> <span class="n">cursor</span><span class="p">)</span>
-</span><span id="__span-0-2089"><a id="__codelineno-0-2089" name="__codelineno-0-2089"></a>
-</span><span id="__span-0-2090"><a id="__codelineno-0-2090" name="__codelineno-0-2090"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span>
-</span><span id="__span-0-2091"><a id="__codelineno-0-2091" name="__codelineno-0-2091"></a>        <span class="n">asc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
-</span><span id="__span-0-2092"><a id="__codelineno-0-2092" name="__codelineno-0-2092"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span>
-</span><span id="__span-0-2093"><a id="__codelineno-0-2093" name="__codelineno-0-2093"></a>        <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
-</span><span id="__span-0-2094"><a id="__codelineno-0-2094" name="__codelineno-0-2094"></a>    <span class="p">)</span>
-</span><span id="__span-0-2095"><a id="__codelineno-0-2095" name="__codelineno-0-2095"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-2096"><a id="__codelineno-0-2096" name="__codelineno-0-2096"></a>
-</span><span id="__span-0-2097"><a id="__codelineno-0-2097" name="__codelineno-0-2097"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2098"><a id="__codelineno-0-2098" name="__codelineno-0-2098"></a>    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
-</span><span id="__span-0-2099"><a id="__codelineno-0-2099" name="__codelineno-0-2099"></a>
-</span><span id="__span-0-2100"><a id="__codelineno-0-2100" name="__codelineno-0-2100"></a>    <span class="n">next_cursor</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-2101"><a id="__codelineno-0-2101" name="__codelineno-0-2101"></a>    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="n">limit</span><span class="p">:</span>
-</span><span id="__span-0-2102"><a id="__codelineno-0-2102" name="__codelineno-0-2102"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
-</span><span id="__span-0-2103"><a id="__codelineno-0-2103" name="__codelineno-0-2103"></a>            <span class="n">next_cursor</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
-</span><span id="__span-0-2104"><a id="__codelineno-0-2104" name="__codelineno-0-2104"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2105"><a id="__codelineno-0-2105" name="__codelineno-0-2105"></a>            <span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
-</span><span id="__span-0-2106"><a id="__codelineno-0-2106" name="__codelineno-0-2106"></a>
-</span><span id="__span-0-2107"><a id="__codelineno-0-2107" name="__codelineno-0-2107"></a>    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="n">next_cursor</span><span class="p">}</span>
+</span><span id="__span-0-2028"><a id="__codelineno-0-2028" name="__codelineno-0-2028"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-2029"><a id="__codelineno-0-2029" name="__codelineno-0-2029"></a>
+</span><span id="__span-0-2030"><a id="__codelineno-0-2030" name="__codelineno-0-2030"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-2031"><a id="__codelineno-0-2031" name="__codelineno-0-2031"></a><span class="sd">        db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-2032"><a id="__codelineno-0-2032" name="__codelineno-0-2032"></a><span class="sd">        cursor: The cursor value to start fetching records from. Defaults to `None`.</span>
+</span><span id="__span-0-2033"><a id="__codelineno-0-2033" name="__codelineno-0-2033"></a><span class="sd">        limit: Maximum number of rows to fetch.</span>
+</span><span id="__span-0-2034"><a id="__codelineno-0-2034" name="__codelineno-0-2034"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns.</span>
+</span><span id="__span-0-2035"><a id="__codelineno-0-2035" name="__codelineno-0-2035"></a><span class="sd">        sort_column: Column name to use for sorting and cursor pagination.</span>
+</span><span id="__span-0-2036"><a id="__codelineno-0-2036" name="__codelineno-0-2036"></a><span class="sd">        sort_order: Sorting direction, either `&quot;asc&quot;` or `&quot;desc&quot;`.</span>
+</span><span id="__span-0-2037"><a id="__codelineno-0-2037" name="__codelineno-0-2037"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.</span>
+</span><span id="__span-0-2038"><a id="__codelineno-0-2038" name="__codelineno-0-2038"></a>
+</span><span id="__span-0-2039"><a id="__codelineno-0-2039" name="__codelineno-0-2039"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-2040"><a id="__codelineno-0-2040" name="__codelineno-0-2040"></a><span class="sd">        A dictionary containing the fetched rows under `&quot;data&quot;` key and the next cursor value under `&quot;next_cursor&quot;`.</span>
+</span><span id="__span-0-2041"><a id="__codelineno-0-2041" name="__codelineno-0-2041"></a>
+</span><span id="__span-0-2042"><a id="__codelineno-0-2042" name="__codelineno-0-2042"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-2043"><a id="__codelineno-0-2043" name="__codelineno-0-2043"></a><span class="sd">        Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</span>
+</span><span id="__span-0-2044"><a id="__codelineno-0-2044" name="__codelineno-0-2044"></a>
+</span><span id="__span-0-2045"><a id="__codelineno-0-2045" name="__codelineno-0-2045"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2046"><a id="__codelineno-0-2046" name="__codelineno-0-2046"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2047"><a id="__codelineno-0-2047" name="__codelineno-0-2047"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2048"><a id="__codelineno-0-2048" name="__codelineno-0-2048"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-2049"><a id="__codelineno-0-2049" name="__codelineno-0-2049"></a><span class="sd">            sort_column=&#39;registration_date&#39;,</span>
+</span><span id="__span-0-2050"><a id="__codelineno-0-2050" name="__codelineno-0-2050"></a><span class="sd">            sort_order=&#39;desc&#39;,</span>
+</span><span id="__span-0-2051"><a id="__codelineno-0-2051" name="__codelineno-0-2051"></a><span class="sd">        )</span>
+</span><span id="__span-0-2052"><a id="__codelineno-0-2052" name="__codelineno-0-2052"></a>
+</span><span id="__span-0-2053"><a id="__codelineno-0-2053" name="__codelineno-0-2053"></a><span class="sd">        # Fetch the next set of records using the cursor from the first page</span>
+</span><span id="__span-0-2054"><a id="__codelineno-0-2054" name="__codelineno-0-2054"></a><span class="sd">        next_cursor = first_page[&#39;next_cursor&#39;]</span>
+</span><span id="__span-0-2055"><a id="__codelineno-0-2055" name="__codelineno-0-2055"></a><span class="sd">        second_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2056"><a id="__codelineno-0-2056" name="__codelineno-0-2056"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2057"><a id="__codelineno-0-2057" name="__codelineno-0-2057"></a><span class="sd">            cursor=next_cursor,</span>
+</span><span id="__span-0-2058"><a id="__codelineno-0-2058" name="__codelineno-0-2058"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-2059"><a id="__codelineno-0-2059" name="__codelineno-0-2059"></a><span class="sd">            sort_column=&#39;registration_date&#39;,</span>
+</span><span id="__span-0-2060"><a id="__codelineno-0-2060" name="__codelineno-0-2060"></a><span class="sd">            sort_order=&#39;desc&#39;,</span>
+</span><span id="__span-0-2061"><a id="__codelineno-0-2061" name="__codelineno-0-2061"></a><span class="sd">        )</span>
+</span><span id="__span-0-2062"><a id="__codelineno-0-2062" name="__codelineno-0-2062"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2063"><a id="__codelineno-0-2063" name="__codelineno-0-2063"></a>
+</span><span id="__span-0-2064"><a id="__codelineno-0-2064" name="__codelineno-0-2064"></a><span class="sd">        Fetch records with age greater than 30 using cursor-based pagination:</span>
+</span><span id="__span-0-2065"><a id="__codelineno-0-2065" name="__codelineno-0-2065"></a>
+</span><span id="__span-0-2066"><a id="__codelineno-0-2066" name="__codelineno-0-2066"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2067"><a id="__codelineno-0-2067" name="__codelineno-0-2067"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2068"><a id="__codelineno-0-2068" name="__codelineno-0-2068"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2069"><a id="__codelineno-0-2069" name="__codelineno-0-2069"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-2070"><a id="__codelineno-0-2070" name="__codelineno-0-2070"></a><span class="sd">            sort_column=&#39;age&#39;,</span>
+</span><span id="__span-0-2071"><a id="__codelineno-0-2071" name="__codelineno-0-2071"></a><span class="sd">            sort_order=&#39;asc&#39;,</span>
+</span><span id="__span-0-2072"><a id="__codelineno-0-2072" name="__codelineno-0-2072"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-2073"><a id="__codelineno-0-2073" name="__codelineno-0-2073"></a><span class="sd">        )</span>
+</span><span id="__span-0-2074"><a id="__codelineno-0-2074" name="__codelineno-0-2074"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2075"><a id="__codelineno-0-2075" name="__codelineno-0-2075"></a>
+</span><span id="__span-0-2076"><a id="__codelineno-0-2076" name="__codelineno-0-2076"></a><span class="sd">        Fetch records excluding a specific username using cursor-based pagination:</span>
+</span><span id="__span-0-2077"><a id="__codelineno-0-2077" name="__codelineno-0-2077"></a>
+</span><span id="__span-0-2078"><a id="__codelineno-0-2078" name="__codelineno-0-2078"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2079"><a id="__codelineno-0-2079" name="__codelineno-0-2079"></a><span class="sd">        first_page = await user_crud.get_multi_by_cursor(</span>
+</span><span id="__span-0-2080"><a id="__codelineno-0-2080" name="__codelineno-0-2080"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2081"><a id="__codelineno-0-2081" name="__codelineno-0-2081"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-2082"><a id="__codelineno-0-2082" name="__codelineno-0-2082"></a><span class="sd">            sort_column=&#39;username&#39;,</span>
+</span><span id="__span-0-2083"><a id="__codelineno-0-2083" name="__codelineno-0-2083"></a><span class="sd">            sort_order=&#39;asc&#39;,</span>
+</span><span id="__span-0-2084"><a id="__codelineno-0-2084" name="__codelineno-0-2084"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-2085"><a id="__codelineno-0-2085" name="__codelineno-0-2085"></a><span class="sd">        )</span>
+</span><span id="__span-0-2086"><a id="__codelineno-0-2086" name="__codelineno-0-2086"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2087"><a id="__codelineno-0-2087" name="__codelineno-0-2087"></a>
+</span><span id="__span-0-2088"><a id="__codelineno-0-2088" name="__codelineno-0-2088"></a><span class="sd">    Note:</span>
+</span><span id="__span-0-2089"><a id="__codelineno-0-2089" name="__codelineno-0-2089"></a><span class="sd">        This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.</span>
+</span><span id="__span-0-2090"><a id="__codelineno-0-2090" name="__codelineno-0-2090"></a><span class="sd">        Make sure the column used for cursor pagination is indexed for performance.</span>
+</span><span id="__span-0-2091"><a id="__codelineno-0-2091" name="__codelineno-0-2091"></a><span class="sd">        This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).</span>
+</span><span id="__span-0-2092"><a id="__codelineno-0-2092" name="__codelineno-0-2092"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-2093"><a id="__codelineno-0-2093" name="__codelineno-0-2093"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2094"><a id="__codelineno-0-2094" name="__codelineno-0-2094"></a>        <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="p">[],</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="kc">None</span><span class="p">}</span>
+</span><span id="__span-0-2095"><a id="__codelineno-0-2095" name="__codelineno-0-2095"></a>
+</span><span id="__span-0-2096"><a id="__codelineno-0-2096" name="__codelineno-0-2096"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">select</span><span class="p">(</span><span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2097"><a id="__codelineno-0-2097" name="__codelineno-0-2097"></a>
+</span><span id="__span-0-2098"><a id="__codelineno-0-2098" name="__codelineno-0-2098"></a>    <span class="k">if</span> <span class="n">cursor</span><span class="p">:</span>
+</span><span id="__span-0-2099"><a id="__codelineno-0-2099" name="__codelineno-0-2099"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
+</span><span id="__span-0-2100"><a id="__codelineno-0-2100" name="__codelineno-0-2100"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&gt;</span> <span class="n">cursor</span><span class="p">)</span>
+</span><span id="__span-0-2101"><a id="__codelineno-0-2101" name="__codelineno-0-2101"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2102"><a id="__codelineno-0-2102" name="__codelineno-0-2102"></a>            <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">)</span> <span class="o">&lt;</span> <span class="n">cursor</span><span class="p">)</span>
+</span><span id="__span-0-2103"><a id="__codelineno-0-2103" name="__codelineno-0-2103"></a>
+</span><span id="__span-0-2104"><a id="__codelineno-0-2104" name="__codelineno-0-2104"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span>
+</span><span id="__span-0-2105"><a id="__codelineno-0-2105" name="__codelineno-0-2105"></a>        <span class="n">asc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
+</span><span id="__span-0-2106"><a id="__codelineno-0-2106" name="__codelineno-0-2106"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span>
+</span><span id="__span-0-2107"><a id="__codelineno-0-2107" name="__codelineno-0-2107"></a>        <span class="k">else</span> <span class="n">desc</span><span class="p">(</span><span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">sort_column</span><span class="p">))</span>
+</span><span id="__span-0-2108"><a id="__codelineno-0-2108" name="__codelineno-0-2108"></a>    <span class="p">)</span>
+</span><span id="__span-0-2109"><a id="__codelineno-0-2109" name="__codelineno-0-2109"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-2110"><a id="__codelineno-0-2110" name="__codelineno-0-2110"></a>
+</span><span id="__span-0-2111"><a id="__codelineno-0-2111" name="__codelineno-0-2111"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2112"><a id="__codelineno-0-2112" name="__codelineno-0-2112"></a>    <span class="n">data</span> <span class="o">=</span> <span class="p">[</span><span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span> <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()]</span>
+</span><span id="__span-0-2113"><a id="__codelineno-0-2113" name="__codelineno-0-2113"></a>
+</span><span id="__span-0-2114"><a id="__codelineno-0-2114" name="__codelineno-0-2114"></a>    <span class="n">next_cursor</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-2115"><a id="__codelineno-0-2115" name="__codelineno-0-2115"></a>    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">)</span> <span class="o">==</span> <span class="n">limit</span><span class="p">:</span>
+</span><span id="__span-0-2116"><a id="__codelineno-0-2116" name="__codelineno-0-2116"></a>        <span class="k">if</span> <span class="n">sort_order</span> <span class="o">==</span> <span class="s2">&quot;asc&quot;</span><span class="p">:</span>
+</span><span id="__span-0-2117"><a id="__codelineno-0-2117" name="__codelineno-0-2117"></a>            <span class="n">next_cursor</span> <span class="o">=</span> <span class="n">data</span><span class="p">[</span><span class="o">-</span><span class="mi">1</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
+</span><span id="__span-0-2118"><a id="__codelineno-0-2118" name="__codelineno-0-2118"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2119"><a id="__codelineno-0-2119" name="__codelineno-0-2119"></a>            <span class="n">data</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="n">sort_column</span><span class="p">]</span>
+</span><span id="__span-0-2120"><a id="__codelineno-0-2120" name="__codelineno-0-2120"></a>
+</span><span id="__span-0-2121"><a id="__codelineno-0-2121" name="__codelineno-0-2121"></a>    <span class="k">return</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">data</span><span class="p">,</span> <span class="s2">&quot;next_cursor&quot;</span><span class="p">:</span> <span class="n">next_cursor</span><span class="p">}</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -10942,7 +11072,7 @@ <h2 id="fastcrud.FastCRUD.get_multi_joined" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -10998,7 +11128,7 @@ <h2 id="fastcrud.FastCRUD.get_multi_joined" class="doc doc-heading">
         <tr>
           <td><code>join_schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -11451,20 +11581,7 @@ <h2 id="fastcrud.FastCRUD.get_multi_joined" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1593">1593</a></span>
-<span class="normal"><a href="#__codelineno-0-1594">1594</a></span>
-<span class="normal"><a href="#__codelineno-0-1595">1595</a></span>
-<span class="normal"><a href="#__codelineno-0-1596">1596</a></span>
-<span class="normal"><a href="#__codelineno-0-1597">1597</a></span>
-<span class="normal"><a href="#__codelineno-0-1598">1598</a></span>
-<span class="normal"><a href="#__codelineno-0-1599">1599</a></span>
-<span class="normal"><a href="#__codelineno-0-1600">1600</a></span>
-<span class="normal"><a href="#__codelineno-0-1601">1601</a></span>
-<span class="normal"><a href="#__codelineno-0-1602">1602</a></span>
-<span class="normal"><a href="#__codelineno-0-1603">1603</a></span>
-<span class="normal"><a href="#__codelineno-0-1604">1604</a></span>
-<span class="normal"><a href="#__codelineno-0-1605">1605</a></span>
-<span class="normal"><a href="#__codelineno-0-1606">1606</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1606">1606</a></span>
 <span class="normal"><a href="#__codelineno-0-1607">1607</a></span>
 <span class="normal"><a href="#__codelineno-0-1608">1608</a></span>
 <span class="normal"><a href="#__codelineno-0-1609">1609</a></span>
@@ -11854,410 +11971,431 @@ <h2 id="fastcrud.FastCRUD.get_multi_joined" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-1993">1993</a></span>
 <span class="normal"><a href="#__codelineno-0-1994">1994</a></span>
 <span class="normal"><a href="#__codelineno-0-1995">1995</a></span>
-<span class="normal"><a href="#__codelineno-0-1996">1996</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1593"><a id="__codelineno-0-1593" name="__codelineno-0-1593"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_joined</span><span class="p">(</span>
-</span><span id="__span-0-1594"><a id="__codelineno-0-1594" name="__codelineno-0-1594"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-1595"><a id="__codelineno-0-1595" name="__codelineno-0-1595"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-1596"><a id="__codelineno-0-1596" name="__codelineno-0-1596"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1597"><a id="__codelineno-0-1597" name="__codelineno-0-1597"></a>    <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1598"><a id="__codelineno-0-1598" name="__codelineno-0-1598"></a>    <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1599"><a id="__codelineno-0-1599" name="__codelineno-0-1599"></a>    <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1600"><a id="__codelineno-0-1600" name="__codelineno-0-1600"></a>    <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1601"><a id="__codelineno-0-1601" name="__codelineno-0-1601"></a>    <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
-</span><span id="__span-0-1602"><a id="__codelineno-0-1602" name="__codelineno-0-1602"></a>    <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1603"><a id="__codelineno-0-1603" name="__codelineno-0-1603"></a>    <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1604"><a id="__codelineno-0-1604" name="__codelineno-0-1604"></a>    <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1605"><a id="__codelineno-0-1605" name="__codelineno-0-1605"></a>    <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
-</span><span id="__span-0-1606"><a id="__codelineno-0-1606" name="__codelineno-0-1606"></a>    <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
-</span><span id="__span-0-1607"><a id="__codelineno-0-1607" name="__codelineno-0-1607"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1608"><a id="__codelineno-0-1608" name="__codelineno-0-1608"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1609"><a id="__codelineno-0-1609" name="__codelineno-0-1609"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-1610"><a id="__codelineno-0-1610" name="__codelineno-0-1610"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1611"><a id="__codelineno-0-1611" name="__codelineno-0-1611"></a>    <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-1612"><a id="__codelineno-0-1612" name="__codelineno-0-1612"></a>    <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1613"><a id="__codelineno-0-1613" name="__codelineno-0-1613"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-1614"><a id="__codelineno-0-1614" name="__codelineno-0-1614"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
-</span><span id="__span-0-1615"><a id="__codelineno-0-1615" name="__codelineno-0-1615"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-1616"><a id="__codelineno-0-1616" name="__codelineno-0-1616"></a><span class="sd">    Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</span>
-</span><span id="__span-0-1617"><a id="__codelineno-0-1617" name="__codelineno-0-1617"></a>
-</span><span id="__span-0-1618"><a id="__codelineno-0-1618" name="__codelineno-0-1618"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-1619"><a id="__codelineno-0-1619" name="__codelineno-0-1619"></a>
-</span><span id="__span-0-1620"><a id="__codelineno-0-1620" name="__codelineno-0-1620"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-1621"><a id="__codelineno-0-1621" name="__codelineno-0-1621"></a><span class="sd">        db: The SQLAlchemy async session.</span>
-</span><span id="__span-0-1622"><a id="__codelineno-0-1622" name="__codelineno-0-1622"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
-</span><span id="__span-0-1623"><a id="__codelineno-0-1623" name="__codelineno-0-1623"></a><span class="sd">        join_model: The model to join with.</span>
-</span><span id="__span-0-1624"><a id="__codelineno-0-1624" name="__codelineno-0-1624"></a><span class="sd">        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
-</span><span id="__span-0-1625"><a id="__codelineno-0-1625" name="__codelineno-0-1625"></a><span class="sd">        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
-</span><span id="__span-0-1626"><a id="__codelineno-0-1626" name="__codelineno-0-1626"></a><span class="sd">        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
-</span><span id="__span-0-1627"><a id="__codelineno-0-1627" name="__codelineno-0-1627"></a><span class="sd">        join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
-</span><span id="__span-0-1628"><a id="__codelineno-0-1628" name="__codelineno-0-1628"></a><span class="sd">        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
-</span><span id="__span-0-1629"><a id="__codelineno-0-1629" name="__codelineno-0-1629"></a><span class="sd">        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
-</span><span id="__span-0-1630"><a id="__codelineno-0-1630" name="__codelineno-0-1630"></a><span class="sd">        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
-</span><span id="__span-0-1631"><a id="__codelineno-0-1631" name="__codelineno-0-1631"></a><span class="sd">        offset: The offset (number of records to skip) for pagination.</span>
-</span><span id="__span-0-1632"><a id="__codelineno-0-1632" name="__codelineno-0-1632"></a><span class="sd">        limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
-</span><span id="__span-0-1633"><a id="__codelineno-0-1633" name="__codelineno-0-1633"></a><span class="sd">        sort_columns: A single column name or a list of column names on which to apply sorting.</span>
-</span><span id="__span-0-1634"><a id="__codelineno-0-1634" name="__codelineno-0-1634"></a><span class="sd">        sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
-</span><span id="__span-0-1635"><a id="__codelineno-0-1635" name="__codelineno-0-1635"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-1636"><a id="__codelineno-0-1636" name="__codelineno-0-1636"></a><span class="sd">        joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</span>
-</span><span id="__span-0-1637"><a id="__codelineno-0-1637" name="__codelineno-0-1637"></a><span class="sd">        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
-</span><span id="__span-0-1638"><a id="__codelineno-0-1638" name="__codelineno-0-1638"></a><span class="sd">        relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
-</span><span id="__span-0-1639"><a id="__codelineno-0-1639" name="__codelineno-0-1639"></a><span class="sd">        **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.</span>
-</span><span id="__span-0-1640"><a id="__codelineno-0-1640" name="__codelineno-0-1640"></a>
-</span><span id="__span-0-1641"><a id="__codelineno-0-1641" name="__codelineno-0-1641"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-1642"><a id="__codelineno-0-1642" name="__codelineno-0-1642"></a><span class="sd">        A dictionary containing the fetched rows under `&quot;data&quot;` key and total count under `&quot;total_count&quot;`.</span>
-</span><span id="__span-0-1643"><a id="__codelineno-0-1643" name="__codelineno-0-1643"></a>
-</span><span id="__span-0-1644"><a id="__codelineno-0-1644" name="__codelineno-0-1644"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-1645"><a id="__codelineno-0-1645" name="__codelineno-0-1645"></a><span class="sd">        ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.</span>
-</span><span id="__span-0-1646"><a id="__codelineno-0-1646" name="__codelineno-0-1646"></a><span class="sd">                    Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.</span>
-</span><span id="__span-0-1647"><a id="__codelineno-0-1647" name="__codelineno-0-1647"></a>
-</span><span id="__span-0-1648"><a id="__codelineno-0-1648" name="__codelineno-0-1648"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-1649"><a id="__codelineno-0-1649" name="__codelineno-0-1649"></a><span class="sd">        Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:</span>
-</span><span id="__span-0-1650"><a id="__codelineno-0-1650" name="__codelineno-0-1650"></a>
-</span><span id="__span-0-1651"><a id="__codelineno-0-1651" name="__codelineno-0-1651"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1652"><a id="__codelineno-0-1652" name="__codelineno-0-1652"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1653"><a id="__codelineno-0-1653" name="__codelineno-0-1653"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1654"><a id="__codelineno-0-1654" name="__codelineno-0-1654"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1655"><a id="__codelineno-0-1655" name="__codelineno-0-1655"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1656"><a id="__codelineno-0-1656" name="__codelineno-0-1656"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1657"><a id="__codelineno-0-1657" name="__codelineno-0-1657"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1658"><a id="__codelineno-0-1658" name="__codelineno-0-1658"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1659"><a id="__codelineno-0-1659" name="__codelineno-0-1659"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1660"><a id="__codelineno-0-1660" name="__codelineno-0-1660"></a><span class="sd">        )</span>
-</span><span id="__span-0-1661"><a id="__codelineno-0-1661" name="__codelineno-0-1661"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1662"><a id="__codelineno-0-1662" name="__codelineno-0-1662"></a>
-</span><span id="__span-0-1663"><a id="__codelineno-0-1663" name="__codelineno-0-1663"></a><span class="sd">        Fetch users joined with their tiers, sorted by username, where user&#39;s age is greater than 30:</span>
-</span><span id="__span-0-1664"><a id="__codelineno-0-1664" name="__codelineno-0-1664"></a>
-</span><span id="__span-0-1665"><a id="__codelineno-0-1665" name="__codelineno-0-1665"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1666"><a id="__codelineno-0-1666" name="__codelineno-0-1666"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1667"><a id="__codelineno-0-1667" name="__codelineno-0-1667"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1668"><a id="__codelineno-0-1668" name="__codelineno-0-1668"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1669"><a id="__codelineno-0-1669" name="__codelineno-0-1669"></a><span class="sd">            join_model=Tier,</span>
+<span class="normal"><a href="#__codelineno-0-1996">1996</a></span>
+<span class="normal"><a href="#__codelineno-0-1997">1997</a></span>
+<span class="normal"><a href="#__codelineno-0-1998">1998</a></span>
+<span class="normal"><a href="#__codelineno-0-1999">1999</a></span>
+<span class="normal"><a href="#__codelineno-0-2000">2000</a></span>
+<span class="normal"><a href="#__codelineno-0-2001">2001</a></span>
+<span class="normal"><a href="#__codelineno-0-2002">2002</a></span>
+<span class="normal"><a href="#__codelineno-0-2003">2003</a></span>
+<span class="normal"><a href="#__codelineno-0-2004">2004</a></span>
+<span class="normal"><a href="#__codelineno-0-2005">2005</a></span>
+<span class="normal"><a href="#__codelineno-0-2006">2006</a></span>
+<span class="normal"><a href="#__codelineno-0-2007">2007</a></span>
+<span class="normal"><a href="#__codelineno-0-2008">2008</a></span>
+<span class="normal"><a href="#__codelineno-0-2009">2009</a></span>
+<span class="normal"><a href="#__codelineno-0-2010">2010</a></span>
+<span class="normal"><a href="#__codelineno-0-2011">2011</a></span>
+<span class="normal"><a href="#__codelineno-0-2012">2012</a></span>
+<span class="normal"><a href="#__codelineno-0-2013">2013</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1606"><a id="__codelineno-0-1606" name="__codelineno-0-1606"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_multi_joined</span><span class="p">(</span>
+</span><span id="__span-0-1607"><a id="__codelineno-0-1607" name="__codelineno-0-1607"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-1608"><a id="__codelineno-0-1608" name="__codelineno-0-1608"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-1609"><a id="__codelineno-0-1609" name="__codelineno-0-1609"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1610"><a id="__codelineno-0-1610" name="__codelineno-0-1610"></a>    <span class="n">join_model</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">ModelType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1611"><a id="__codelineno-0-1611" name="__codelineno-0-1611"></a>    <span class="n">join_on</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1612"><a id="__codelineno-0-1612" name="__codelineno-0-1612"></a>    <span class="n">join_prefix</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1613"><a id="__codelineno-0-1613" name="__codelineno-0-1613"></a>    <span class="n">join_schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1614"><a id="__codelineno-0-1614" name="__codelineno-0-1614"></a>    <span class="n">join_type</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">&quot;left&quot;</span><span class="p">,</span>
+</span><span id="__span-0-1615"><a id="__codelineno-0-1615" name="__codelineno-0-1615"></a>    <span class="n">alias</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">AliasedClass</span><span class="p">[</span><span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1616"><a id="__codelineno-0-1616" name="__codelineno-0-1616"></a>    <span class="n">join_filters</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1617"><a id="__codelineno-0-1617" name="__codelineno-0-1617"></a>    <span class="n">nest_joins</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1618"><a id="__codelineno-0-1618" name="__codelineno-0-1618"></a>    <span class="n">offset</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">0</span><span class="p">,</span>
+</span><span id="__span-0-1619"><a id="__codelineno-0-1619" name="__codelineno-0-1619"></a>    <span class="n">limit</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">int</span><span class="p">]</span> <span class="o">=</span> <span class="mi">100</span><span class="p">,</span>
+</span><span id="__span-0-1620"><a id="__codelineno-0-1620" name="__codelineno-0-1620"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1621"><a id="__codelineno-0-1621" name="__codelineno-0-1621"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1622"><a id="__codelineno-0-1622" name="__codelineno-0-1622"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-1623"><a id="__codelineno-0-1623" name="__codelineno-0-1623"></a>    <span class="n">joins_config</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="n">JoinConfig</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1624"><a id="__codelineno-0-1624" name="__codelineno-0-1624"></a>    <span class="n">return_total_count</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-1625"><a id="__codelineno-0-1625" name="__codelineno-0-1625"></a>    <span class="n">relationship_type</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1626"><a id="__codelineno-0-1626" name="__codelineno-0-1626"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-1627"><a id="__codelineno-0-1627" name="__codelineno-0-1627"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]:</span>
+</span><span id="__span-0-1628"><a id="__codelineno-0-1628" name="__codelineno-0-1628"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-1629"><a id="__codelineno-0-1629" name="__codelineno-0-1629"></a><span class="sd">    Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</span>
+</span><span id="__span-0-1630"><a id="__codelineno-0-1630" name="__codelineno-0-1630"></a>
+</span><span id="__span-0-1631"><a id="__codelineno-0-1631" name="__codelineno-0-1631"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-1632"><a id="__codelineno-0-1632" name="__codelineno-0-1632"></a>
+</span><span id="__span-0-1633"><a id="__codelineno-0-1633" name="__codelineno-0-1633"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-1634"><a id="__codelineno-0-1634" name="__codelineno-0-1634"></a><span class="sd">        db: The SQLAlchemy async session.</span>
+</span><span id="__span-0-1635"><a id="__codelineno-0-1635" name="__codelineno-0-1635"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.</span>
+</span><span id="__span-0-1636"><a id="__codelineno-0-1636" name="__codelineno-0-1636"></a><span class="sd">        join_model: The model to join with.</span>
+</span><span id="__span-0-1637"><a id="__codelineno-0-1637" name="__codelineno-0-1637"></a><span class="sd">        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.</span>
+</span><span id="__span-0-1638"><a id="__codelineno-0-1638" name="__codelineno-0-1638"></a><span class="sd">        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.</span>
+</span><span id="__span-0-1639"><a id="__codelineno-0-1639" name="__codelineno-0-1639"></a><span class="sd">        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.</span>
+</span><span id="__span-0-1640"><a id="__codelineno-0-1640" name="__codelineno-0-1640"></a><span class="sd">        join_type: Specifies the type of join operation to perform. Can be `&quot;left&quot;` for a left outer join or `&quot;inner&quot;` for an inner join.</span>
+</span><span id="__span-0-1641"><a id="__codelineno-0-1641" name="__codelineno-0-1641"></a><span class="sd">        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.</span>
+</span><span id="__span-0-1642"><a id="__codelineno-0-1642" name="__codelineno-0-1642"></a><span class="sd">        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</span>
+</span><span id="__span-0-1643"><a id="__codelineno-0-1643" name="__codelineno-0-1643"></a><span class="sd">        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.</span>
+</span><span id="__span-0-1644"><a id="__codelineno-0-1644" name="__codelineno-0-1644"></a><span class="sd">        offset: The offset (number of records to skip) for pagination.</span>
+</span><span id="__span-0-1645"><a id="__codelineno-0-1645" name="__codelineno-0-1645"></a><span class="sd">        limit: Maximum number of records to fetch in one call. Use `None` for &quot;no limit&quot;, fetching all matching rows. Note that in order to use `limit=None`, you&#39;ll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</span>
+</span><span id="__span-0-1646"><a id="__codelineno-0-1646" name="__codelineno-0-1646"></a><span class="sd">        sort_columns: A single column name or a list of column names on which to apply sorting.</span>
+</span><span id="__span-0-1647"><a id="__codelineno-0-1647" name="__codelineno-0-1647"></a><span class="sd">        sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `&quot;asc&quot;` for each column.</span>
+</span><span id="__span-0-1648"><a id="__codelineno-0-1648" name="__codelineno-0-1648"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-1649"><a id="__codelineno-0-1649" name="__codelineno-0-1649"></a><span class="sd">        joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</span>
+</span><span id="__span-0-1650"><a id="__codelineno-0-1650" name="__codelineno-0-1650"></a><span class="sd">        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.</span>
+</span><span id="__span-0-1651"><a id="__codelineno-0-1651" name="__codelineno-0-1651"></a><span class="sd">        relationship_type: Specifies the relationship type, such as `&quot;one-to-one&quot;` or `&quot;one-to-many&quot;`. Used to determine how to nest the joined data. If `None`, uses `&quot;one-to-one&quot;`.</span>
+</span><span id="__span-0-1652"><a id="__codelineno-0-1652" name="__codelineno-0-1652"></a><span class="sd">        **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.</span>
+</span><span id="__span-0-1653"><a id="__codelineno-0-1653" name="__codelineno-0-1653"></a>
+</span><span id="__span-0-1654"><a id="__codelineno-0-1654" name="__codelineno-0-1654"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-1655"><a id="__codelineno-0-1655" name="__codelineno-0-1655"></a><span class="sd">        A dictionary containing the fetched rows under `&quot;data&quot;` key and total count under `&quot;total_count&quot;`.</span>
+</span><span id="__span-0-1656"><a id="__codelineno-0-1656" name="__codelineno-0-1656"></a>
+</span><span id="__span-0-1657"><a id="__codelineno-0-1657" name="__codelineno-0-1657"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-1658"><a id="__codelineno-0-1658" name="__codelineno-0-1658"></a><span class="sd">        ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.</span>
+</span><span id="__span-0-1659"><a id="__codelineno-0-1659" name="__codelineno-0-1659"></a><span class="sd">                    Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.</span>
+</span><span id="__span-0-1660"><a id="__codelineno-0-1660" name="__codelineno-0-1660"></a>
+</span><span id="__span-0-1661"><a id="__codelineno-0-1661" name="__codelineno-0-1661"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-1662"><a id="__codelineno-0-1662" name="__codelineno-0-1662"></a><span class="sd">        Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:</span>
+</span><span id="__span-0-1663"><a id="__codelineno-0-1663" name="__codelineno-0-1663"></a>
+</span><span id="__span-0-1664"><a id="__codelineno-0-1664" name="__codelineno-0-1664"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1665"><a id="__codelineno-0-1665" name="__codelineno-0-1665"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1666"><a id="__codelineno-0-1666" name="__codelineno-0-1666"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1667"><a id="__codelineno-0-1667" name="__codelineno-0-1667"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1668"><a id="__codelineno-0-1668" name="__codelineno-0-1668"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1669"><a id="__codelineno-0-1669" name="__codelineno-0-1669"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
 </span><span id="__span-0-1670"><a id="__codelineno-0-1670" name="__codelineno-0-1670"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1671"><a id="__codelineno-0-1671" name="__codelineno-0-1671"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1672"><a id="__codelineno-0-1672" name="__codelineno-0-1672"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1673"><a id="__codelineno-0-1673" name="__codelineno-0-1673"></a><span class="sd">            age__gt=30,</span>
-</span><span id="__span-0-1674"><a id="__codelineno-0-1674" name="__codelineno-0-1674"></a><span class="sd">        )</span>
-</span><span id="__span-0-1675"><a id="__codelineno-0-1675" name="__codelineno-0-1675"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1676"><a id="__codelineno-0-1676" name="__codelineno-0-1676"></a>
-</span><span id="__span-0-1677"><a id="__codelineno-0-1677" name="__codelineno-0-1677"></a><span class="sd">        Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:</span>
-</span><span id="__span-0-1678"><a id="__codelineno-0-1678" name="__codelineno-0-1678"></a>
-</span><span id="__span-0-1679"><a id="__codelineno-0-1679" name="__codelineno-0-1679"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1680"><a id="__codelineno-0-1680" name="__codelineno-0-1680"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1681"><a id="__codelineno-0-1681" name="__codelineno-0-1681"></a><span class="sd">            db,</span>
-</span><span id="__span-0-1682"><a id="__codelineno-0-1682" name="__codelineno-0-1682"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1683"><a id="__codelineno-0-1683" name="__codelineno-0-1683"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1684"><a id="__codelineno-0-1684" name="__codelineno-0-1684"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1685"><a id="__codelineno-0-1685" name="__codelineno-0-1685"></a><span class="sd">            return_as_model=True,</span>
-</span><span id="__span-0-1686"><a id="__codelineno-0-1686" name="__codelineno-0-1686"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1671"><a id="__codelineno-0-1671" name="__codelineno-0-1671"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1672"><a id="__codelineno-0-1672" name="__codelineno-0-1672"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1673"><a id="__codelineno-0-1673" name="__codelineno-0-1673"></a><span class="sd">        )</span>
+</span><span id="__span-0-1674"><a id="__codelineno-0-1674" name="__codelineno-0-1674"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1675"><a id="__codelineno-0-1675" name="__codelineno-0-1675"></a>
+</span><span id="__span-0-1676"><a id="__codelineno-0-1676" name="__codelineno-0-1676"></a><span class="sd">        Fetch users joined with their tiers, sorted by username, where user&#39;s age is greater than 30:</span>
+</span><span id="__span-0-1677"><a id="__codelineno-0-1677" name="__codelineno-0-1677"></a>
+</span><span id="__span-0-1678"><a id="__codelineno-0-1678" name="__codelineno-0-1678"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1679"><a id="__codelineno-0-1679" name="__codelineno-0-1679"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1680"><a id="__codelineno-0-1680" name="__codelineno-0-1680"></a><span class="sd">            db,</span>
+</span><span id="__span-0-1681"><a id="__codelineno-0-1681" name="__codelineno-0-1681"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1682"><a id="__codelineno-0-1682" name="__codelineno-0-1682"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1683"><a id="__codelineno-0-1683" name="__codelineno-0-1683"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1684"><a id="__codelineno-0-1684" name="__codelineno-0-1684"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1685"><a id="__codelineno-0-1685" name="__codelineno-0-1685"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1686"><a id="__codelineno-0-1686" name="__codelineno-0-1686"></a><span class="sd">            age__gt=30,</span>
 </span><span id="__span-0-1687"><a id="__codelineno-0-1687" name="__codelineno-0-1687"></a><span class="sd">        )</span>
 </span><span id="__span-0-1688"><a id="__codelineno-0-1688" name="__codelineno-0-1688"></a><span class="sd">        ```</span>
 </span><span id="__span-0-1689"><a id="__codelineno-0-1689" name="__codelineno-0-1689"></a>
-</span><span id="__span-0-1690"><a id="__codelineno-0-1690" name="__codelineno-0-1690"></a><span class="sd">        Fetching and sorting by username in descending order, returning as Pydantic model:</span>
+</span><span id="__span-0-1690"><a id="__codelineno-0-1690" name="__codelineno-0-1690"></a><span class="sd">        Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:</span>
 </span><span id="__span-0-1691"><a id="__codelineno-0-1691" name="__codelineno-0-1691"></a>
 </span><span id="__span-0-1692"><a id="__codelineno-0-1692" name="__codelineno-0-1692"></a><span class="sd">        ```python</span>
 </span><span id="__span-0-1693"><a id="__codelineno-0-1693" name="__codelineno-0-1693"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1694"><a id="__codelineno-0-1694" name="__codelineno-0-1694"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1694"><a id="__codelineno-0-1694" name="__codelineno-0-1694"></a><span class="sd">            db,</span>
 </span><span id="__span-0-1695"><a id="__codelineno-0-1695" name="__codelineno-0-1695"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
 </span><span id="__span-0-1696"><a id="__codelineno-0-1696" name="__codelineno-0-1696"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1697"><a id="__codelineno-0-1697" name="__codelineno-0-1697"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1698"><a id="__codelineno-0-1698" name="__codelineno-0-1698"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1699"><a id="__codelineno-0-1699" name="__codelineno-0-1699"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1700"><a id="__codelineno-0-1700" name="__codelineno-0-1700"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1701"><a id="__codelineno-0-1701" name="__codelineno-0-1701"></a><span class="sd">            sort_columns=[&#39;username&#39;],</span>
-</span><span id="__span-0-1702"><a id="__codelineno-0-1702" name="__codelineno-0-1702"></a><span class="sd">            sort_orders=[&#39;desc&#39;],</span>
-</span><span id="__span-0-1703"><a id="__codelineno-0-1703" name="__codelineno-0-1703"></a><span class="sd">            return_as_model=True,</span>
-</span><span id="__span-0-1704"><a id="__codelineno-0-1704" name="__codelineno-0-1704"></a><span class="sd">        )</span>
-</span><span id="__span-0-1705"><a id="__codelineno-0-1705" name="__codelineno-0-1705"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1706"><a id="__codelineno-0-1706" name="__codelineno-0-1706"></a>
-</span><span id="__span-0-1707"><a id="__codelineno-0-1707" name="__codelineno-0-1707"></a><span class="sd">        Fetching with complex conditions and custom join, returning as Pydantic model:</span>
-</span><span id="__span-0-1708"><a id="__codelineno-0-1708" name="__codelineno-0-1708"></a>
-</span><span id="__span-0-1709"><a id="__codelineno-0-1709" name="__codelineno-0-1709"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1710"><a id="__codelineno-0-1710" name="__codelineno-0-1710"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1711"><a id="__codelineno-0-1711" name="__codelineno-0-1711"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1712"><a id="__codelineno-0-1712" name="__codelineno-0-1712"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1713"><a id="__codelineno-0-1713" name="__codelineno-0-1713"></a><span class="sd">            join_model=Tier,</span>
-</span><span id="__span-0-1714"><a id="__codelineno-0-1714" name="__codelineno-0-1714"></a><span class="sd">            join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1715"><a id="__codelineno-0-1715" name="__codelineno-0-1715"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1716"><a id="__codelineno-0-1716" name="__codelineno-0-1716"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1717"><a id="__codelineno-0-1717" name="__codelineno-0-1717"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1718"><a id="__codelineno-0-1718" name="__codelineno-0-1718"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1719"><a id="__codelineno-0-1719" name="__codelineno-0-1719"></a><span class="sd">            return_as_model=True,</span>
-</span><span id="__span-0-1720"><a id="__codelineno-0-1720" name="__codelineno-0-1720"></a><span class="sd">            is_active=True,</span>
-</span><span id="__span-0-1721"><a id="__codelineno-0-1721" name="__codelineno-0-1721"></a><span class="sd">        )</span>
-</span><span id="__span-0-1722"><a id="__codelineno-0-1722" name="__codelineno-0-1722"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1723"><a id="__codelineno-0-1723" name="__codelineno-0-1723"></a>
-</span><span id="__span-0-1724"><a id="__codelineno-0-1724" name="__codelineno-0-1724"></a><span class="sd">        Example using `joins_config` for multiple joins:</span>
-</span><span id="__span-0-1725"><a id="__codelineno-0-1725" name="__codelineno-0-1725"></a>
-</span><span id="__span-0-1726"><a id="__codelineno-0-1726" name="__codelineno-0-1726"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1727"><a id="__codelineno-0-1727" name="__codelineno-0-1727"></a><span class="sd">        from fastcrud import JoinConfig</span>
-</span><span id="__span-0-1728"><a id="__codelineno-0-1728" name="__codelineno-0-1728"></a>
-</span><span id="__span-0-1729"><a id="__codelineno-0-1729" name="__codelineno-0-1729"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
-</span><span id="__span-0-1730"><a id="__codelineno-0-1730" name="__codelineno-0-1730"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1731"><a id="__codelineno-0-1731" name="__codelineno-0-1731"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1732"><a id="__codelineno-0-1732" name="__codelineno-0-1732"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1733"><a id="__codelineno-0-1733" name="__codelineno-0-1733"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1734"><a id="__codelineno-0-1734" name="__codelineno-0-1734"></a><span class="sd">                    model=Tier,</span>
-</span><span id="__span-0-1735"><a id="__codelineno-0-1735" name="__codelineno-0-1735"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
-</span><span id="__span-0-1736"><a id="__codelineno-0-1736" name="__codelineno-0-1736"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
-</span><span id="__span-0-1737"><a id="__codelineno-0-1737" name="__codelineno-0-1737"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
-</span><span id="__span-0-1738"><a id="__codelineno-0-1738" name="__codelineno-0-1738"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1739"><a id="__codelineno-0-1739" name="__codelineno-0-1739"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1740"><a id="__codelineno-0-1740" name="__codelineno-0-1740"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1741"><a id="__codelineno-0-1741" name="__codelineno-0-1741"></a><span class="sd">                    model=Department,</span>
-</span><span id="__span-0-1742"><a id="__codelineno-0-1742" name="__codelineno-0-1742"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
-</span><span id="__span-0-1743"><a id="__codelineno-0-1743" name="__codelineno-0-1743"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
-</span><span id="__span-0-1744"><a id="__codelineno-0-1744" name="__codelineno-0-1744"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
-</span><span id="__span-0-1745"><a id="__codelineno-0-1745" name="__codelineno-0-1745"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1746"><a id="__codelineno-0-1746" name="__codelineno-0-1746"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1747"><a id="__codelineno-0-1747" name="__codelineno-0-1747"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1748"><a id="__codelineno-0-1748" name="__codelineno-0-1748"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1749"><a id="__codelineno-0-1749" name="__codelineno-0-1749"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1750"><a id="__codelineno-0-1750" name="__codelineno-0-1750"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
-</span><span id="__span-0-1751"><a id="__codelineno-0-1751" name="__codelineno-0-1751"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1752"><a id="__codelineno-0-1752" name="__codelineno-0-1752"></a><span class="sd">        )</span>
-</span><span id="__span-0-1753"><a id="__codelineno-0-1753" name="__codelineno-0-1753"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1754"><a id="__codelineno-0-1754" name="__codelineno-0-1754"></a>
-</span><span id="__span-0-1755"><a id="__codelineno-0-1755" name="__codelineno-0-1755"></a><span class="sd">        Example using `alias` for multiple joins, with pagination, sorting, and model conversion:</span>
-</span><span id="__span-0-1756"><a id="__codelineno-0-1756" name="__codelineno-0-1756"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1757"><a id="__codelineno-0-1757" name="__codelineno-0-1757"></a><span class="sd">        from fastcrud import JoinConfig, FastCRUD, aliased</span>
-</span><span id="__span-0-1758"><a id="__codelineno-0-1758" name="__codelineno-0-1758"></a>
-</span><span id="__span-0-1759"><a id="__codelineno-0-1759" name="__codelineno-0-1759"></a><span class="sd">        # Aliasing for self-joins or multiple joins on the same table</span>
-</span><span id="__span-0-1760"><a id="__codelineno-0-1760" name="__codelineno-0-1760"></a><span class="sd">        owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
-</span><span id="__span-0-1761"><a id="__codelineno-0-1761" name="__codelineno-0-1761"></a><span class="sd">        user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
-</span><span id="__span-0-1762"><a id="__codelineno-0-1762" name="__codelineno-0-1762"></a>
-</span><span id="__span-0-1763"><a id="__codelineno-0-1763" name="__codelineno-0-1763"></a><span class="sd">        # Initialize your FastCRUD instance for BookingModel</span>
-</span><span id="__span-0-1764"><a id="__codelineno-0-1764" name="__codelineno-0-1764"></a><span class="sd">        crud = FastCRUD(BookingModel)</span>
-</span><span id="__span-0-1765"><a id="__codelineno-0-1765" name="__codelineno-0-1765"></a>
-</span><span id="__span-0-1766"><a id="__codelineno-0-1766" name="__codelineno-0-1766"></a><span class="sd">        result = await crud.get_multi_joined(</span>
-</span><span id="__span-0-1767"><a id="__codelineno-0-1767" name="__codelineno-0-1767"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1768"><a id="__codelineno-0-1768" name="__codelineno-0-1768"></a><span class="sd">            schema_to_select=BookingSchema,  # Primary model schema</span>
-</span><span id="__span-0-1769"><a id="__codelineno-0-1769" name="__codelineno-0-1769"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1770"><a id="__codelineno-0-1770" name="__codelineno-0-1770"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1771"><a id="__codelineno-0-1771" name="__codelineno-0-1771"></a><span class="sd">                    model=ModelTest,</span>
-</span><span id="__span-0-1772"><a id="__codelineno-0-1772" name="__codelineno-0-1772"></a><span class="sd">                    join_on=BookingModel.owner_id == owner_alias.id,</span>
-</span><span id="__span-0-1773"><a id="__codelineno-0-1773" name="__codelineno-0-1773"></a><span class="sd">                    join_prefix=&quot;owner_&quot;,</span>
-</span><span id="__span-0-1774"><a id="__codelineno-0-1774" name="__codelineno-0-1774"></a><span class="sd">                    schema_to_select=UserSchema,  # Schema for the joined model</span>
-</span><span id="__span-0-1775"><a id="__codelineno-0-1775" name="__codelineno-0-1775"></a><span class="sd">                    alias=owner_alias,</span>
-</span><span id="__span-0-1776"><a id="__codelineno-0-1776" name="__codelineno-0-1776"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1777"><a id="__codelineno-0-1777" name="__codelineno-0-1777"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1778"><a id="__codelineno-0-1778" name="__codelineno-0-1778"></a><span class="sd">                    model=ModelTest,</span>
-</span><span id="__span-0-1779"><a id="__codelineno-0-1779" name="__codelineno-0-1779"></a><span class="sd">                    join_on=BookingModel.user_id == user_alias.id,</span>
-</span><span id="__span-0-1780"><a id="__codelineno-0-1780" name="__codelineno-0-1780"></a><span class="sd">                    join_prefix=&quot;user_&quot;,</span>
-</span><span id="__span-0-1781"><a id="__codelineno-0-1781" name="__codelineno-0-1781"></a><span class="sd">                    schema_to_select=UserSchema,</span>
-</span><span id="__span-0-1782"><a id="__codelineno-0-1782" name="__codelineno-0-1782"></a><span class="sd">                    alias=user_alias,</span>
-</span><span id="__span-0-1783"><a id="__codelineno-0-1783" name="__codelineno-0-1783"></a><span class="sd">                )</span>
-</span><span id="__span-0-1784"><a id="__codelineno-0-1784" name="__codelineno-0-1784"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1785"><a id="__codelineno-0-1785" name="__codelineno-0-1785"></a><span class="sd">            offset=10,  # Skip the first 10 records</span>
-</span><span id="__span-0-1786"><a id="__codelineno-0-1786" name="__codelineno-0-1786"></a><span class="sd">            limit=5,  # Fetch up to 5 records</span>
-</span><span id="__span-0-1787"><a id="__codelineno-0-1787" name="__codelineno-0-1787"></a><span class="sd">            sort_columns=[&#39;booking_date&#39;],  # Sort by booking_date</span>
-</span><span id="__span-0-1788"><a id="__codelineno-0-1788" name="__codelineno-0-1788"></a><span class="sd">            sort_orders=[&#39;desc&#39;],  # In descending order</span>
-</span><span id="__span-0-1789"><a id="__codelineno-0-1789" name="__codelineno-0-1789"></a><span class="sd">        )</span>
-</span><span id="__span-0-1790"><a id="__codelineno-0-1790" name="__codelineno-0-1790"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1791"><a id="__codelineno-0-1791" name="__codelineno-0-1791"></a>
-</span><span id="__span-0-1792"><a id="__codelineno-0-1792" name="__codelineno-0-1792"></a><span class="sd">        Fetching multiple project records and their associated participants where participants have a specific role:</span>
-</span><span id="__span-0-1793"><a id="__codelineno-0-1793" name="__codelineno-0-1793"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1794"><a id="__codelineno-0-1794" name="__codelineno-0-1794"></a><span class="sd">        joins_config = [</span>
-</span><span id="__span-0-1795"><a id="__codelineno-0-1795" name="__codelineno-0-1795"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1796"><a id="__codelineno-0-1796" name="__codelineno-0-1796"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
-</span><span id="__span-0-1797"><a id="__codelineno-0-1797" name="__codelineno-0-1797"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
-</span><span id="__span-0-1798"><a id="__codelineno-0-1798" name="__codelineno-0-1798"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1799"><a id="__codelineno-0-1799" name="__codelineno-0-1799"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1800"><a id="__codelineno-0-1800" name="__codelineno-0-1800"></a><span class="sd">            JoinConfig(</span>
-</span><span id="__span-0-1801"><a id="__codelineno-0-1801" name="__codelineno-0-1801"></a><span class="sd">                model=Participant,</span>
-</span><span id="__span-0-1802"><a id="__codelineno-0-1802" name="__codelineno-0-1802"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
-</span><span id="__span-0-1803"><a id="__codelineno-0-1803" name="__codelineno-0-1803"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
-</span><span id="__span-0-1804"><a id="__codelineno-0-1804" name="__codelineno-0-1804"></a><span class="sd">                filters={&#39;role&#39;: &#39;Developer&#39;},</span>
-</span><span id="__span-0-1805"><a id="__codelineno-0-1805" name="__codelineno-0-1805"></a><span class="sd">            ),</span>
-</span><span id="__span-0-1806"><a id="__codelineno-0-1806" name="__codelineno-0-1806"></a><span class="sd">        ]</span>
-</span><span id="__span-0-1807"><a id="__codelineno-0-1807" name="__codelineno-0-1807"></a><span class="sd">        projects = await crud.get_multi_joined(</span>
-</span><span id="__span-0-1808"><a id="__codelineno-0-1808" name="__codelineno-0-1808"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1809"><a id="__codelineno-0-1809" name="__codelineno-0-1809"></a><span class="sd">            schema_to_select=ProjectSchema,</span>
-</span><span id="__span-0-1810"><a id="__codelineno-0-1810" name="__codelineno-0-1810"></a><span class="sd">            joins_config=joins_config,</span>
-</span><span id="__span-0-1811"><a id="__codelineno-0-1811" name="__codelineno-0-1811"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1812"><a id="__codelineno-0-1812" name="__codelineno-0-1812"></a><span class="sd">        )</span>
-</span><span id="__span-0-1813"><a id="__codelineno-0-1813" name="__codelineno-0-1813"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1814"><a id="__codelineno-0-1814" name="__codelineno-0-1814"></a>
-</span><span id="__span-0-1815"><a id="__codelineno-0-1815" name="__codelineno-0-1815"></a><span class="sd">        Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</span>
-</span><span id="__span-0-1816"><a id="__codelineno-0-1816" name="__codelineno-0-1816"></a>
-</span><span id="__span-0-1817"><a id="__codelineno-0-1817" name="__codelineno-0-1817"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1818"><a id="__codelineno-0-1818" name="__codelineno-0-1818"></a><span class="sd">        story_crud = FastCRUD(Story)</span>
-</span><span id="__span-0-1819"><a id="__codelineno-0-1819" name="__codelineno-0-1819"></a><span class="sd">        stories = await story_crud.get_multi_joined(</span>
-</span><span id="__span-0-1820"><a id="__codelineno-0-1820" name="__codelineno-0-1820"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1821"><a id="__codelineno-0-1821" name="__codelineno-0-1821"></a><span class="sd">            schema_to_select=ReadStorySchema,</span>
-</span><span id="__span-0-1822"><a id="__codelineno-0-1822" name="__codelineno-0-1822"></a><span class="sd">            joins_config=[</span>
-</span><span id="__span-0-1823"><a id="__codelineno-0-1823" name="__codelineno-0-1823"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1824"><a id="__codelineno-0-1824" name="__codelineno-0-1824"></a><span class="sd">                    model=Task,</span>
-</span><span id="__span-0-1825"><a id="__codelineno-0-1825" name="__codelineno-0-1825"></a><span class="sd">                    join_on=Story.id == Task.story_id,</span>
-</span><span id="__span-0-1826"><a id="__codelineno-0-1826" name="__codelineno-0-1826"></a><span class="sd">                    join_prefix=&quot;task_&quot;,</span>
-</span><span id="__span-0-1827"><a id="__codelineno-0-1827" name="__codelineno-0-1827"></a><span class="sd">                    schema_to_select=ReadTaskSchema,</span>
-</span><span id="__span-0-1828"><a id="__codelineno-0-1828" name="__codelineno-0-1828"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1829"><a id="__codelineno-0-1829" name="__codelineno-0-1829"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1830"><a id="__codelineno-0-1830" name="__codelineno-0-1830"></a><span class="sd">                JoinConfig(</span>
-</span><span id="__span-0-1831"><a id="__codelineno-0-1831" name="__codelineno-0-1831"></a><span class="sd">                    model=User,</span>
-</span><span id="__span-0-1832"><a id="__codelineno-0-1832" name="__codelineno-0-1832"></a><span class="sd">                    join_on=Task.creator_id == User.id,</span>
-</span><span id="__span-0-1833"><a id="__codelineno-0-1833" name="__codelineno-0-1833"></a><span class="sd">                    join_prefix=&quot;creator_&quot;,</span>
-</span><span id="__span-0-1834"><a id="__codelineno-0-1834" name="__codelineno-0-1834"></a><span class="sd">                    schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-1835"><a id="__codelineno-0-1835" name="__codelineno-0-1835"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
-</span><span id="__span-0-1836"><a id="__codelineno-0-1836" name="__codelineno-0-1836"></a><span class="sd">                    alias=aliased(User, name=&quot;task_creator&quot;),</span>
-</span><span id="__span-0-1837"><a id="__codelineno-0-1837" name="__codelineno-0-1837"></a><span class="sd">                ),</span>
-</span><span id="__span-0-1838"><a id="__codelineno-0-1838" name="__codelineno-0-1838"></a><span class="sd">            ],</span>
-</span><span id="__span-0-1839"><a id="__codelineno-0-1839" name="__codelineno-0-1839"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1840"><a id="__codelineno-0-1840" name="__codelineno-0-1840"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1841"><a id="__codelineno-0-1841" name="__codelineno-0-1841"></a><span class="sd">            limit=5,</span>
-</span><span id="__span-0-1842"><a id="__codelineno-0-1842" name="__codelineno-0-1842"></a><span class="sd">            sort_columns=&#39;name&#39;,</span>
-</span><span id="__span-0-1843"><a id="__codelineno-0-1843" name="__codelineno-0-1843"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
-</span><span id="__span-0-1844"><a id="__codelineno-0-1844" name="__codelineno-0-1844"></a><span class="sd">        )</span>
-</span><span id="__span-0-1845"><a id="__codelineno-0-1845" name="__codelineno-0-1845"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1846"><a id="__codelineno-0-1846" name="__codelineno-0-1846"></a>
-</span><span id="__span-0-1847"><a id="__codelineno-0-1847" name="__codelineno-0-1847"></a><span class="sd">        Example using one-to-one relationship:</span>
-</span><span id="__span-0-1848"><a id="__codelineno-0-1848" name="__codelineno-0-1848"></a>
-</span><span id="__span-0-1849"><a id="__codelineno-0-1849" name="__codelineno-0-1849"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1850"><a id="__codelineno-0-1850" name="__codelineno-0-1850"></a><span class="sd">        author_crud = FastCRUD(Author)</span>
-</span><span id="__span-0-1851"><a id="__codelineno-0-1851" name="__codelineno-0-1851"></a><span class="sd">        results = await author_crud.get_multi_joined(</span>
-</span><span id="__span-0-1852"><a id="__codelineno-0-1852" name="__codelineno-0-1852"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1853"><a id="__codelineno-0-1853" name="__codelineno-0-1853"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1854"><a id="__codelineno-0-1854" name="__codelineno-0-1854"></a><span class="sd">            join_model=Profile,</span>
-</span><span id="__span-0-1855"><a id="__codelineno-0-1855" name="__codelineno-0-1855"></a><span class="sd">            join_on=Author.profile_id == Profile.id,</span>
-</span><span id="__span-0-1856"><a id="__codelineno-0-1856" name="__codelineno-0-1856"></a><span class="sd">            join_schema_to_select=ReadProfileSchema,</span>
-</span><span id="__span-0-1857"><a id="__codelineno-0-1857" name="__codelineno-0-1857"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1858"><a id="__codelineno-0-1858" name="__codelineno-0-1858"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1859"><a id="__codelineno-0-1859" name="__codelineno-0-1859"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1860"><a id="__codelineno-0-1860" name="__codelineno-0-1860"></a><span class="sd">            relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
-</span><span id="__span-0-1861"><a id="__codelineno-0-1861" name="__codelineno-0-1861"></a><span class="sd">        )</span>
-</span><span id="__span-0-1862"><a id="__codelineno-0-1862" name="__codelineno-0-1862"></a><span class="sd">        # Expect &#39;profile&#39; to be nested as a dictionary under each user</span>
-</span><span id="__span-0-1863"><a id="__codelineno-0-1863" name="__codelineno-0-1863"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1864"><a id="__codelineno-0-1864" name="__codelineno-0-1864"></a>
-</span><span id="__span-0-1865"><a id="__codelineno-0-1865" name="__codelineno-0-1865"></a><span class="sd">        Example using one-to-many relationship:</span>
-</span><span id="__span-0-1866"><a id="__codelineno-0-1866" name="__codelineno-0-1866"></a>
-</span><span id="__span-0-1867"><a id="__codelineno-0-1867" name="__codelineno-0-1867"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-1868"><a id="__codelineno-0-1868" name="__codelineno-0-1868"></a><span class="sd">        results = await author_crud.get_multi_joined(</span>
-</span><span id="__span-0-1869"><a id="__codelineno-0-1869" name="__codelineno-0-1869"></a><span class="sd">            db=session,</span>
-</span><span id="__span-0-1870"><a id="__codelineno-0-1870" name="__codelineno-0-1870"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
-</span><span id="__span-0-1871"><a id="__codelineno-0-1871" name="__codelineno-0-1871"></a><span class="sd">            join_model=Article,</span>
-</span><span id="__span-0-1872"><a id="__codelineno-0-1872" name="__codelineno-0-1872"></a><span class="sd">            join_on=Author.id == Article.author_id,</span>
-</span><span id="__span-0-1873"><a id="__codelineno-0-1873" name="__codelineno-0-1873"></a><span class="sd">            join_schema_to_select=ReadArticleSchema,</span>
-</span><span id="__span-0-1874"><a id="__codelineno-0-1874" name="__codelineno-0-1874"></a><span class="sd">            nest_joins=True,</span>
-</span><span id="__span-0-1875"><a id="__codelineno-0-1875" name="__codelineno-0-1875"></a><span class="sd">            offset=0,</span>
-</span><span id="__span-0-1876"><a id="__codelineno-0-1876" name="__codelineno-0-1876"></a><span class="sd">            limit=10,</span>
-</span><span id="__span-0-1877"><a id="__codelineno-0-1877" name="__codelineno-0-1877"></a><span class="sd">            relationship_type=&#39;one-to-many&#39;,</span>
-</span><span id="__span-0-1878"><a id="__codelineno-0-1878" name="__codelineno-0-1878"></a><span class="sd">        )</span>
-</span><span id="__span-0-1879"><a id="__codelineno-0-1879" name="__codelineno-0-1879"></a><span class="sd">        # Expect &#39;posts&#39; to be nested as a list of dictionaries under each user</span>
-</span><span id="__span-0-1880"><a id="__codelineno-0-1880" name="__codelineno-0-1880"></a><span class="sd">        ```</span>
-</span><span id="__span-0-1881"><a id="__codelineno-0-1881" name="__codelineno-0-1881"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-1882"><a id="__codelineno-0-1882" name="__codelineno-0-1882"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
-</span><span id="__span-0-1883"><a id="__codelineno-0-1883" name="__codelineno-0-1883"></a>        <span class="n">join_model</span>
-</span><span id="__span-0-1884"><a id="__codelineno-0-1884" name="__codelineno-0-1884"></a>        <span class="ow">or</span> <span class="n">join_prefix</span>
-</span><span id="__span-0-1885"><a id="__codelineno-0-1885" name="__codelineno-0-1885"></a>        <span class="ow">or</span> <span class="n">join_on</span>
-</span><span id="__span-0-1886"><a id="__codelineno-0-1886" name="__codelineno-0-1886"></a>        <span class="ow">or</span> <span class="n">join_schema_to_select</span>
-</span><span id="__span-0-1887"><a id="__codelineno-0-1887" name="__codelineno-0-1887"></a>        <span class="ow">or</span> <span class="n">alias</span>
-</span><span id="__span-0-1888"><a id="__codelineno-0-1888" name="__codelineno-0-1888"></a>        <span class="ow">or</span> <span class="n">relationship_type</span>
-</span><span id="__span-0-1889"><a id="__codelineno-0-1889" name="__codelineno-0-1889"></a>    <span class="p">):</span>
-</span><span id="__span-0-1890"><a id="__codelineno-0-1890" name="__codelineno-0-1890"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1891"><a id="__codelineno-0-1891" name="__codelineno-0-1891"></a>            <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
-</span><span id="__span-0-1892"><a id="__codelineno-0-1892" name="__codelineno-0-1892"></a>        <span class="p">)</span>
-</span><span id="__span-0-1893"><a id="__codelineno-0-1893" name="__codelineno-0-1893"></a>    <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1894"><a id="__codelineno-0-1894" name="__codelineno-0-1894"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1895"><a id="__codelineno-0-1895" name="__codelineno-0-1895"></a>
-</span><span id="__span-0-1896"><a id="__codelineno-0-1896" name="__codelineno-0-1896"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
-</span><span id="__span-0-1897"><a id="__codelineno-0-1897" name="__codelineno-0-1897"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1898"><a id="__codelineno-0-1898" name="__codelineno-0-1898"></a>
-</span><span id="__span-0-1899"><a id="__codelineno-0-1899" name="__codelineno-0-1899"></a>    <span class="k">if</span> <span class="n">relationship_type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1900"><a id="__codelineno-0-1900" name="__codelineno-0-1900"></a>        <span class="n">relationship_type</span> <span class="o">=</span> <span class="s2">&quot;one-to-one&quot;</span>
-</span><span id="__span-0-1901"><a id="__codelineno-0-1901" name="__codelineno-0-1901"></a>
-</span><span id="__span-0-1902"><a id="__codelineno-0-1902" name="__codelineno-0-1902"></a>    <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-1903"><a id="__codelineno-0-1903" name="__codelineno-0-1903"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1904"><a id="__codelineno-0-1904" name="__codelineno-0-1904"></a>    <span class="p">)</span>
-</span><span id="__span-0-1905"><a id="__codelineno-0-1905" name="__codelineno-0-1905"></a>    <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span>
-</span><span id="__span-0-1906"><a id="__codelineno-0-1906" name="__codelineno-0-1906"></a>
-</span><span id="__span-0-1907"><a id="__codelineno-0-1907" name="__codelineno-0-1907"></a>    <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
-</span><span id="__span-0-1908"><a id="__codelineno-0-1908" name="__codelineno-0-1908"></a>    <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
-</span><span id="__span-0-1909"><a id="__codelineno-0-1909" name="__codelineno-0-1909"></a>        <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-</span><span id="__span-0-1910"><a id="__codelineno-0-1910" name="__codelineno-0-1910"></a>            <span class="n">JoinConfig</span><span class="p">(</span>
-</span><span id="__span-0-1911"><a id="__codelineno-0-1911" name="__codelineno-0-1911"></a>                <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
-</span><span id="__span-0-1912"><a id="__codelineno-0-1912" name="__codelineno-0-1912"></a>                <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span>
-</span><span id="__span-0-1913"><a id="__codelineno-0-1913" name="__codelineno-0-1913"></a>                <span class="ow">or</span> <span class="n">_auto_detect_join_condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">join_model</span><span class="p">),</span>
-</span><span id="__span-0-1914"><a id="__codelineno-0-1914" name="__codelineno-0-1914"></a>                <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
-</span><span id="__span-0-1915"><a id="__codelineno-0-1915" name="__codelineno-0-1915"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-1916"><a id="__codelineno-0-1916" name="__codelineno-0-1916"></a>                <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
-</span><span id="__span-0-1917"><a id="__codelineno-0-1917" name="__codelineno-0-1917"></a>                <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
-</span><span id="__span-0-1918"><a id="__codelineno-0-1918" name="__codelineno-0-1918"></a>                <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
-</span><span id="__span-0-1919"><a id="__codelineno-0-1919" name="__codelineno-0-1919"></a>                <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
-</span><span id="__span-0-1920"><a id="__codelineno-0-1920" name="__codelineno-0-1920"></a>            <span class="p">)</span>
-</span><span id="__span-0-1921"><a id="__codelineno-0-1921" name="__codelineno-0-1921"></a>        <span class="p">)</span>
-</span><span id="__span-0-1922"><a id="__codelineno-0-1922" name="__codelineno-0-1922"></a>
-</span><span id="__span-0-1923"><a id="__codelineno-0-1923" name="__codelineno-0-1923"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
-</span><span id="__span-0-1924"><a id="__codelineno-0-1924" name="__codelineno-0-1924"></a>        <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
-</span><span id="__span-0-1925"><a id="__codelineno-0-1925" name="__codelineno-0-1925"></a>    <span class="p">)</span>
-</span><span id="__span-0-1926"><a id="__codelineno-0-1926" name="__codelineno-0-1926"></a>
-</span><span id="__span-0-1927"><a id="__codelineno-0-1927" name="__codelineno-0-1927"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-1928"><a id="__codelineno-0-1928" name="__codelineno-0-1928"></a>    <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
-</span><span id="__span-0-1929"><a id="__codelineno-0-1929" name="__codelineno-0-1929"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
-</span><span id="__span-0-1930"><a id="__codelineno-0-1930" name="__codelineno-0-1930"></a>
-</span><span id="__span-0-1931"><a id="__codelineno-0-1931" name="__codelineno-0-1931"></a>    <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-1932"><a id="__codelineno-0-1932" name="__codelineno-0-1932"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
-</span><span id="__span-0-1933"><a id="__codelineno-0-1933" name="__codelineno-0-1933"></a>
-</span><span id="__span-0-1934"><a id="__codelineno-0-1934" name="__codelineno-0-1934"></a>    <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
-</span><span id="__span-0-1935"><a id="__codelineno-0-1935" name="__codelineno-0-1935"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
-</span><span id="__span-0-1936"><a id="__codelineno-0-1936" name="__codelineno-0-1936"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1937"><a id="__codelineno-0-1937" name="__codelineno-0-1937"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
-</span><span id="__span-0-1938"><a id="__codelineno-0-1938" name="__codelineno-0-1938"></a>
-</span><span id="__span-0-1939"><a id="__codelineno-0-1939" name="__codelineno-0-1939"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-1940"><a id="__codelineno-0-1940" name="__codelineno-0-1940"></a>    <span class="n">data</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
-</span><span id="__span-0-1941"><a id="__codelineno-0-1941" name="__codelineno-0-1941"></a>
-</span><span id="__span-0-1942"><a id="__codelineno-0-1942" name="__codelineno-0-1942"></a>    <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()</span><span class="o">.</span><span class="n">all</span><span class="p">():</span>
-</span><span id="__span-0-1943"><a id="__codelineno-0-1943" name="__codelineno-0-1943"></a>        <span class="n">row_dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
-</span><span id="__span-0-1944"><a id="__codelineno-0-1944" name="__codelineno-0-1944"></a>
-</span><span id="__span-0-1945"><a id="__codelineno-0-1945" name="__codelineno-0-1945"></a>        <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
-</span><span id="__span-0-1946"><a id="__codelineno-0-1946" name="__codelineno-0-1946"></a>            <span class="n">row_dict</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1947"><a id="__codelineno-0-1947" name="__codelineno-0-1947"></a>                <span class="n">data</span><span class="o">=</span><span class="n">row_dict</span><span class="p">,</span>
-</span><span id="__span-0-1948"><a id="__codelineno-0-1948" name="__codelineno-0-1948"></a>                <span class="n">join_definitions</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1949"><a id="__codelineno-0-1949" name="__codelineno-0-1949"></a>            <span class="p">)</span>
+</span><span id="__span-0-1697"><a id="__codelineno-0-1697" name="__codelineno-0-1697"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1698"><a id="__codelineno-0-1698" name="__codelineno-0-1698"></a><span class="sd">            return_as_model=True,</span>
+</span><span id="__span-0-1699"><a id="__codelineno-0-1699" name="__codelineno-0-1699"></a><span class="sd">            username__ne=&#39;admin&#39;,</span>
+</span><span id="__span-0-1700"><a id="__codelineno-0-1700" name="__codelineno-0-1700"></a><span class="sd">        )</span>
+</span><span id="__span-0-1701"><a id="__codelineno-0-1701" name="__codelineno-0-1701"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1702"><a id="__codelineno-0-1702" name="__codelineno-0-1702"></a>
+</span><span id="__span-0-1703"><a id="__codelineno-0-1703" name="__codelineno-0-1703"></a><span class="sd">        Fetching and sorting by username in descending order, returning as Pydantic model:</span>
+</span><span id="__span-0-1704"><a id="__codelineno-0-1704" name="__codelineno-0-1704"></a>
+</span><span id="__span-0-1705"><a id="__codelineno-0-1705" name="__codelineno-0-1705"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1706"><a id="__codelineno-0-1706" name="__codelineno-0-1706"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1707"><a id="__codelineno-0-1707" name="__codelineno-0-1707"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1708"><a id="__codelineno-0-1708" name="__codelineno-0-1708"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1709"><a id="__codelineno-0-1709" name="__codelineno-0-1709"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1710"><a id="__codelineno-0-1710" name="__codelineno-0-1710"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1711"><a id="__codelineno-0-1711" name="__codelineno-0-1711"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1712"><a id="__codelineno-0-1712" name="__codelineno-0-1712"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1713"><a id="__codelineno-0-1713" name="__codelineno-0-1713"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1714"><a id="__codelineno-0-1714" name="__codelineno-0-1714"></a><span class="sd">            sort_columns=[&#39;username&#39;],</span>
+</span><span id="__span-0-1715"><a id="__codelineno-0-1715" name="__codelineno-0-1715"></a><span class="sd">            sort_orders=[&#39;desc&#39;],</span>
+</span><span id="__span-0-1716"><a id="__codelineno-0-1716" name="__codelineno-0-1716"></a><span class="sd">            return_as_model=True,</span>
+</span><span id="__span-0-1717"><a id="__codelineno-0-1717" name="__codelineno-0-1717"></a><span class="sd">        )</span>
+</span><span id="__span-0-1718"><a id="__codelineno-0-1718" name="__codelineno-0-1718"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1719"><a id="__codelineno-0-1719" name="__codelineno-0-1719"></a>
+</span><span id="__span-0-1720"><a id="__codelineno-0-1720" name="__codelineno-0-1720"></a><span class="sd">        Fetching with complex conditions and custom join, returning as Pydantic model:</span>
+</span><span id="__span-0-1721"><a id="__codelineno-0-1721" name="__codelineno-0-1721"></a>
+</span><span id="__span-0-1722"><a id="__codelineno-0-1722" name="__codelineno-0-1722"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1723"><a id="__codelineno-0-1723" name="__codelineno-0-1723"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1724"><a id="__codelineno-0-1724" name="__codelineno-0-1724"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1725"><a id="__codelineno-0-1725" name="__codelineno-0-1725"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1726"><a id="__codelineno-0-1726" name="__codelineno-0-1726"></a><span class="sd">            join_model=Tier,</span>
+</span><span id="__span-0-1727"><a id="__codelineno-0-1727" name="__codelineno-0-1727"></a><span class="sd">            join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1728"><a id="__codelineno-0-1728" name="__codelineno-0-1728"></a><span class="sd">            join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1729"><a id="__codelineno-0-1729" name="__codelineno-0-1729"></a><span class="sd">            join_schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1730"><a id="__codelineno-0-1730" name="__codelineno-0-1730"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1731"><a id="__codelineno-0-1731" name="__codelineno-0-1731"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1732"><a id="__codelineno-0-1732" name="__codelineno-0-1732"></a><span class="sd">            return_as_model=True,</span>
+</span><span id="__span-0-1733"><a id="__codelineno-0-1733" name="__codelineno-0-1733"></a><span class="sd">            is_active=True,</span>
+</span><span id="__span-0-1734"><a id="__codelineno-0-1734" name="__codelineno-0-1734"></a><span class="sd">        )</span>
+</span><span id="__span-0-1735"><a id="__codelineno-0-1735" name="__codelineno-0-1735"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1736"><a id="__codelineno-0-1736" name="__codelineno-0-1736"></a>
+</span><span id="__span-0-1737"><a id="__codelineno-0-1737" name="__codelineno-0-1737"></a><span class="sd">        Example using `joins_config` for multiple joins:</span>
+</span><span id="__span-0-1738"><a id="__codelineno-0-1738" name="__codelineno-0-1738"></a>
+</span><span id="__span-0-1739"><a id="__codelineno-0-1739" name="__codelineno-0-1739"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1740"><a id="__codelineno-0-1740" name="__codelineno-0-1740"></a><span class="sd">        from fastcrud import JoinConfig</span>
+</span><span id="__span-0-1741"><a id="__codelineno-0-1741" name="__codelineno-0-1741"></a>
+</span><span id="__span-0-1742"><a id="__codelineno-0-1742" name="__codelineno-0-1742"></a><span class="sd">        users = await user_crud.get_multi_joined(</span>
+</span><span id="__span-0-1743"><a id="__codelineno-0-1743" name="__codelineno-0-1743"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1744"><a id="__codelineno-0-1744" name="__codelineno-0-1744"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1745"><a id="__codelineno-0-1745" name="__codelineno-0-1745"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1746"><a id="__codelineno-0-1746" name="__codelineno-0-1746"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1747"><a id="__codelineno-0-1747" name="__codelineno-0-1747"></a><span class="sd">                    model=Tier,</span>
+</span><span id="__span-0-1748"><a id="__codelineno-0-1748" name="__codelineno-0-1748"></a><span class="sd">                    join_on=User.tier_id == Tier.id,</span>
+</span><span id="__span-0-1749"><a id="__codelineno-0-1749" name="__codelineno-0-1749"></a><span class="sd">                    join_prefix=&quot;tier_&quot;,</span>
+</span><span id="__span-0-1750"><a id="__codelineno-0-1750" name="__codelineno-0-1750"></a><span class="sd">                    schema_to_select=ReadTierSchema,</span>
+</span><span id="__span-0-1751"><a id="__codelineno-0-1751" name="__codelineno-0-1751"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1752"><a id="__codelineno-0-1752" name="__codelineno-0-1752"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1753"><a id="__codelineno-0-1753" name="__codelineno-0-1753"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1754"><a id="__codelineno-0-1754" name="__codelineno-0-1754"></a><span class="sd">                    model=Department,</span>
+</span><span id="__span-0-1755"><a id="__codelineno-0-1755" name="__codelineno-0-1755"></a><span class="sd">                    join_on=User.department_id == Department.id,</span>
+</span><span id="__span-0-1756"><a id="__codelineno-0-1756" name="__codelineno-0-1756"></a><span class="sd">                    join_prefix=&quot;dept_&quot;,</span>
+</span><span id="__span-0-1757"><a id="__codelineno-0-1757" name="__codelineno-0-1757"></a><span class="sd">                    schema_to_select=ReadDepartmentSchema,</span>
+</span><span id="__span-0-1758"><a id="__codelineno-0-1758" name="__codelineno-0-1758"></a><span class="sd">                    join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1759"><a id="__codelineno-0-1759" name="__codelineno-0-1759"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1760"><a id="__codelineno-0-1760" name="__codelineno-0-1760"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1761"><a id="__codelineno-0-1761" name="__codelineno-0-1761"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1762"><a id="__codelineno-0-1762" name="__codelineno-0-1762"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1763"><a id="__codelineno-0-1763" name="__codelineno-0-1763"></a><span class="sd">            sort_columns=&#39;username&#39;,</span>
+</span><span id="__span-0-1764"><a id="__codelineno-0-1764" name="__codelineno-0-1764"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1765"><a id="__codelineno-0-1765" name="__codelineno-0-1765"></a><span class="sd">        )</span>
+</span><span id="__span-0-1766"><a id="__codelineno-0-1766" name="__codelineno-0-1766"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1767"><a id="__codelineno-0-1767" name="__codelineno-0-1767"></a>
+</span><span id="__span-0-1768"><a id="__codelineno-0-1768" name="__codelineno-0-1768"></a><span class="sd">        Example using `alias` for multiple joins, with pagination, sorting, and model conversion:</span>
+</span><span id="__span-0-1769"><a id="__codelineno-0-1769" name="__codelineno-0-1769"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1770"><a id="__codelineno-0-1770" name="__codelineno-0-1770"></a><span class="sd">        from fastcrud import JoinConfig, FastCRUD, aliased</span>
+</span><span id="__span-0-1771"><a id="__codelineno-0-1771" name="__codelineno-0-1771"></a>
+</span><span id="__span-0-1772"><a id="__codelineno-0-1772" name="__codelineno-0-1772"></a><span class="sd">        # Aliasing for self-joins or multiple joins on the same table</span>
+</span><span id="__span-0-1773"><a id="__codelineno-0-1773" name="__codelineno-0-1773"></a><span class="sd">        owner_alias = aliased(ModelTest, name=&quot;owner&quot;)</span>
+</span><span id="__span-0-1774"><a id="__codelineno-0-1774" name="__codelineno-0-1774"></a><span class="sd">        user_alias = aliased(ModelTest, name=&quot;user&quot;)</span>
+</span><span id="__span-0-1775"><a id="__codelineno-0-1775" name="__codelineno-0-1775"></a>
+</span><span id="__span-0-1776"><a id="__codelineno-0-1776" name="__codelineno-0-1776"></a><span class="sd">        # Initialize your FastCRUD instance for BookingModel</span>
+</span><span id="__span-0-1777"><a id="__codelineno-0-1777" name="__codelineno-0-1777"></a><span class="sd">        crud = FastCRUD(BookingModel)</span>
+</span><span id="__span-0-1778"><a id="__codelineno-0-1778" name="__codelineno-0-1778"></a>
+</span><span id="__span-0-1779"><a id="__codelineno-0-1779" name="__codelineno-0-1779"></a><span class="sd">        result = await crud.get_multi_joined(</span>
+</span><span id="__span-0-1780"><a id="__codelineno-0-1780" name="__codelineno-0-1780"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1781"><a id="__codelineno-0-1781" name="__codelineno-0-1781"></a><span class="sd">            schema_to_select=BookingSchema,  # Primary model schema</span>
+</span><span id="__span-0-1782"><a id="__codelineno-0-1782" name="__codelineno-0-1782"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1783"><a id="__codelineno-0-1783" name="__codelineno-0-1783"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1784"><a id="__codelineno-0-1784" name="__codelineno-0-1784"></a><span class="sd">                    model=ModelTest,</span>
+</span><span id="__span-0-1785"><a id="__codelineno-0-1785" name="__codelineno-0-1785"></a><span class="sd">                    join_on=BookingModel.owner_id == owner_alias.id,</span>
+</span><span id="__span-0-1786"><a id="__codelineno-0-1786" name="__codelineno-0-1786"></a><span class="sd">                    join_prefix=&quot;owner_&quot;,</span>
+</span><span id="__span-0-1787"><a id="__codelineno-0-1787" name="__codelineno-0-1787"></a><span class="sd">                    schema_to_select=UserSchema,  # Schema for the joined model</span>
+</span><span id="__span-0-1788"><a id="__codelineno-0-1788" name="__codelineno-0-1788"></a><span class="sd">                    alias=owner_alias,</span>
+</span><span id="__span-0-1789"><a id="__codelineno-0-1789" name="__codelineno-0-1789"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1790"><a id="__codelineno-0-1790" name="__codelineno-0-1790"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1791"><a id="__codelineno-0-1791" name="__codelineno-0-1791"></a><span class="sd">                    model=ModelTest,</span>
+</span><span id="__span-0-1792"><a id="__codelineno-0-1792" name="__codelineno-0-1792"></a><span class="sd">                    join_on=BookingModel.user_id == user_alias.id,</span>
+</span><span id="__span-0-1793"><a id="__codelineno-0-1793" name="__codelineno-0-1793"></a><span class="sd">                    join_prefix=&quot;user_&quot;,</span>
+</span><span id="__span-0-1794"><a id="__codelineno-0-1794" name="__codelineno-0-1794"></a><span class="sd">                    schema_to_select=UserSchema,</span>
+</span><span id="__span-0-1795"><a id="__codelineno-0-1795" name="__codelineno-0-1795"></a><span class="sd">                    alias=user_alias,</span>
+</span><span id="__span-0-1796"><a id="__codelineno-0-1796" name="__codelineno-0-1796"></a><span class="sd">                )</span>
+</span><span id="__span-0-1797"><a id="__codelineno-0-1797" name="__codelineno-0-1797"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1798"><a id="__codelineno-0-1798" name="__codelineno-0-1798"></a><span class="sd">            offset=10,  # Skip the first 10 records</span>
+</span><span id="__span-0-1799"><a id="__codelineno-0-1799" name="__codelineno-0-1799"></a><span class="sd">            limit=5,  # Fetch up to 5 records</span>
+</span><span id="__span-0-1800"><a id="__codelineno-0-1800" name="__codelineno-0-1800"></a><span class="sd">            sort_columns=[&#39;booking_date&#39;],  # Sort by booking_date</span>
+</span><span id="__span-0-1801"><a id="__codelineno-0-1801" name="__codelineno-0-1801"></a><span class="sd">            sort_orders=[&#39;desc&#39;],  # In descending order</span>
+</span><span id="__span-0-1802"><a id="__codelineno-0-1802" name="__codelineno-0-1802"></a><span class="sd">        )</span>
+</span><span id="__span-0-1803"><a id="__codelineno-0-1803" name="__codelineno-0-1803"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1804"><a id="__codelineno-0-1804" name="__codelineno-0-1804"></a>
+</span><span id="__span-0-1805"><a id="__codelineno-0-1805" name="__codelineno-0-1805"></a><span class="sd">        Fetching multiple project records and their associated participants where participants have a specific role:</span>
+</span><span id="__span-0-1806"><a id="__codelineno-0-1806" name="__codelineno-0-1806"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1807"><a id="__codelineno-0-1807" name="__codelineno-0-1807"></a><span class="sd">        joins_config = [</span>
+</span><span id="__span-0-1808"><a id="__codelineno-0-1808" name="__codelineno-0-1808"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1809"><a id="__codelineno-0-1809" name="__codelineno-0-1809"></a><span class="sd">                model=ProjectsParticipantsAssociation,</span>
+</span><span id="__span-0-1810"><a id="__codelineno-0-1810" name="__codelineno-0-1810"></a><span class="sd">                join_on=Project.id == ProjectsParticipantsAssociation.project_id,</span>
+</span><span id="__span-0-1811"><a id="__codelineno-0-1811" name="__codelineno-0-1811"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1812"><a id="__codelineno-0-1812" name="__codelineno-0-1812"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1813"><a id="__codelineno-0-1813" name="__codelineno-0-1813"></a><span class="sd">            JoinConfig(</span>
+</span><span id="__span-0-1814"><a id="__codelineno-0-1814" name="__codelineno-0-1814"></a><span class="sd">                model=Participant,</span>
+</span><span id="__span-0-1815"><a id="__codelineno-0-1815" name="__codelineno-0-1815"></a><span class="sd">                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,</span>
+</span><span id="__span-0-1816"><a id="__codelineno-0-1816" name="__codelineno-0-1816"></a><span class="sd">                join_type=&quot;inner&quot;,</span>
+</span><span id="__span-0-1817"><a id="__codelineno-0-1817" name="__codelineno-0-1817"></a><span class="sd">                filters={&#39;role&#39;: &#39;Developer&#39;},</span>
+</span><span id="__span-0-1818"><a id="__codelineno-0-1818" name="__codelineno-0-1818"></a><span class="sd">            ),</span>
+</span><span id="__span-0-1819"><a id="__codelineno-0-1819" name="__codelineno-0-1819"></a><span class="sd">        ]</span>
+</span><span id="__span-0-1820"><a id="__codelineno-0-1820" name="__codelineno-0-1820"></a><span class="sd">        projects = await crud.get_multi_joined(</span>
+</span><span id="__span-0-1821"><a id="__codelineno-0-1821" name="__codelineno-0-1821"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1822"><a id="__codelineno-0-1822" name="__codelineno-0-1822"></a><span class="sd">            schema_to_select=ProjectSchema,</span>
+</span><span id="__span-0-1823"><a id="__codelineno-0-1823" name="__codelineno-0-1823"></a><span class="sd">            joins_config=joins_config,</span>
+</span><span id="__span-0-1824"><a id="__codelineno-0-1824" name="__codelineno-0-1824"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1825"><a id="__codelineno-0-1825" name="__codelineno-0-1825"></a><span class="sd">        )</span>
+</span><span id="__span-0-1826"><a id="__codelineno-0-1826" name="__codelineno-0-1826"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1827"><a id="__codelineno-0-1827" name="__codelineno-0-1827"></a>
+</span><span id="__span-0-1828"><a id="__codelineno-0-1828" name="__codelineno-0-1828"></a><span class="sd">        Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</span>
+</span><span id="__span-0-1829"><a id="__codelineno-0-1829" name="__codelineno-0-1829"></a>
+</span><span id="__span-0-1830"><a id="__codelineno-0-1830" name="__codelineno-0-1830"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1831"><a id="__codelineno-0-1831" name="__codelineno-0-1831"></a><span class="sd">        story_crud = FastCRUD(Story)</span>
+</span><span id="__span-0-1832"><a id="__codelineno-0-1832" name="__codelineno-0-1832"></a><span class="sd">        stories = await story_crud.get_multi_joined(</span>
+</span><span id="__span-0-1833"><a id="__codelineno-0-1833" name="__codelineno-0-1833"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1834"><a id="__codelineno-0-1834" name="__codelineno-0-1834"></a><span class="sd">            schema_to_select=ReadStorySchema,</span>
+</span><span id="__span-0-1835"><a id="__codelineno-0-1835" name="__codelineno-0-1835"></a><span class="sd">            joins_config=[</span>
+</span><span id="__span-0-1836"><a id="__codelineno-0-1836" name="__codelineno-0-1836"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1837"><a id="__codelineno-0-1837" name="__codelineno-0-1837"></a><span class="sd">                    model=Task,</span>
+</span><span id="__span-0-1838"><a id="__codelineno-0-1838" name="__codelineno-0-1838"></a><span class="sd">                    join_on=Story.id == Task.story_id,</span>
+</span><span id="__span-0-1839"><a id="__codelineno-0-1839" name="__codelineno-0-1839"></a><span class="sd">                    join_prefix=&quot;task_&quot;,</span>
+</span><span id="__span-0-1840"><a id="__codelineno-0-1840" name="__codelineno-0-1840"></a><span class="sd">                    schema_to_select=ReadTaskSchema,</span>
+</span><span id="__span-0-1841"><a id="__codelineno-0-1841" name="__codelineno-0-1841"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1842"><a id="__codelineno-0-1842" name="__codelineno-0-1842"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1843"><a id="__codelineno-0-1843" name="__codelineno-0-1843"></a><span class="sd">                JoinConfig(</span>
+</span><span id="__span-0-1844"><a id="__codelineno-0-1844" name="__codelineno-0-1844"></a><span class="sd">                    model=User,</span>
+</span><span id="__span-0-1845"><a id="__codelineno-0-1845" name="__codelineno-0-1845"></a><span class="sd">                    join_on=Task.creator_id == User.id,</span>
+</span><span id="__span-0-1846"><a id="__codelineno-0-1846" name="__codelineno-0-1846"></a><span class="sd">                    join_prefix=&quot;creator_&quot;,</span>
+</span><span id="__span-0-1847"><a id="__codelineno-0-1847" name="__codelineno-0-1847"></a><span class="sd">                    schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-1848"><a id="__codelineno-0-1848" name="__codelineno-0-1848"></a><span class="sd">                    join_type=&quot;left&quot;,</span>
+</span><span id="__span-0-1849"><a id="__codelineno-0-1849" name="__codelineno-0-1849"></a><span class="sd">                    alias=aliased(User, name=&quot;task_creator&quot;),</span>
+</span><span id="__span-0-1850"><a id="__codelineno-0-1850" name="__codelineno-0-1850"></a><span class="sd">                ),</span>
+</span><span id="__span-0-1851"><a id="__codelineno-0-1851" name="__codelineno-0-1851"></a><span class="sd">            ],</span>
+</span><span id="__span-0-1852"><a id="__codelineno-0-1852" name="__codelineno-0-1852"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1853"><a id="__codelineno-0-1853" name="__codelineno-0-1853"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1854"><a id="__codelineno-0-1854" name="__codelineno-0-1854"></a><span class="sd">            limit=5,</span>
+</span><span id="__span-0-1855"><a id="__codelineno-0-1855" name="__codelineno-0-1855"></a><span class="sd">            sort_columns=&#39;name&#39;,</span>
+</span><span id="__span-0-1856"><a id="__codelineno-0-1856" name="__codelineno-0-1856"></a><span class="sd">            sort_orders=&#39;asc&#39;,</span>
+</span><span id="__span-0-1857"><a id="__codelineno-0-1857" name="__codelineno-0-1857"></a><span class="sd">        )</span>
+</span><span id="__span-0-1858"><a id="__codelineno-0-1858" name="__codelineno-0-1858"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1859"><a id="__codelineno-0-1859" name="__codelineno-0-1859"></a>
+</span><span id="__span-0-1860"><a id="__codelineno-0-1860" name="__codelineno-0-1860"></a><span class="sd">        Example using one-to-one relationship:</span>
+</span><span id="__span-0-1861"><a id="__codelineno-0-1861" name="__codelineno-0-1861"></a>
+</span><span id="__span-0-1862"><a id="__codelineno-0-1862" name="__codelineno-0-1862"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1863"><a id="__codelineno-0-1863" name="__codelineno-0-1863"></a><span class="sd">        author_crud = FastCRUD(Author)</span>
+</span><span id="__span-0-1864"><a id="__codelineno-0-1864" name="__codelineno-0-1864"></a><span class="sd">        results = await author_crud.get_multi_joined(</span>
+</span><span id="__span-0-1865"><a id="__codelineno-0-1865" name="__codelineno-0-1865"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1866"><a id="__codelineno-0-1866" name="__codelineno-0-1866"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1867"><a id="__codelineno-0-1867" name="__codelineno-0-1867"></a><span class="sd">            join_model=Profile,</span>
+</span><span id="__span-0-1868"><a id="__codelineno-0-1868" name="__codelineno-0-1868"></a><span class="sd">            join_on=Author.profile_id == Profile.id,</span>
+</span><span id="__span-0-1869"><a id="__codelineno-0-1869" name="__codelineno-0-1869"></a><span class="sd">            join_schema_to_select=ReadProfileSchema,</span>
+</span><span id="__span-0-1870"><a id="__codelineno-0-1870" name="__codelineno-0-1870"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1871"><a id="__codelineno-0-1871" name="__codelineno-0-1871"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1872"><a id="__codelineno-0-1872" name="__codelineno-0-1872"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1873"><a id="__codelineno-0-1873" name="__codelineno-0-1873"></a><span class="sd">            relationship_type=&#39;one-to-one&#39;, # note that this is the default behavior</span>
+</span><span id="__span-0-1874"><a id="__codelineno-0-1874" name="__codelineno-0-1874"></a><span class="sd">        )</span>
+</span><span id="__span-0-1875"><a id="__codelineno-0-1875" name="__codelineno-0-1875"></a><span class="sd">        # Expect &#39;profile&#39; to be nested as a dictionary under each user</span>
+</span><span id="__span-0-1876"><a id="__codelineno-0-1876" name="__codelineno-0-1876"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1877"><a id="__codelineno-0-1877" name="__codelineno-0-1877"></a>
+</span><span id="__span-0-1878"><a id="__codelineno-0-1878" name="__codelineno-0-1878"></a><span class="sd">        Example using one-to-many relationship:</span>
+</span><span id="__span-0-1879"><a id="__codelineno-0-1879" name="__codelineno-0-1879"></a>
+</span><span id="__span-0-1880"><a id="__codelineno-0-1880" name="__codelineno-0-1880"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-1881"><a id="__codelineno-0-1881" name="__codelineno-0-1881"></a><span class="sd">        results = await author_crud.get_multi_joined(</span>
+</span><span id="__span-0-1882"><a id="__codelineno-0-1882" name="__codelineno-0-1882"></a><span class="sd">            db=session,</span>
+</span><span id="__span-0-1883"><a id="__codelineno-0-1883" name="__codelineno-0-1883"></a><span class="sd">            schema_to_select=ReadAuthorSchema,</span>
+</span><span id="__span-0-1884"><a id="__codelineno-0-1884" name="__codelineno-0-1884"></a><span class="sd">            join_model=Article,</span>
+</span><span id="__span-0-1885"><a id="__codelineno-0-1885" name="__codelineno-0-1885"></a><span class="sd">            join_on=Author.id == Article.author_id,</span>
+</span><span id="__span-0-1886"><a id="__codelineno-0-1886" name="__codelineno-0-1886"></a><span class="sd">            join_schema_to_select=ReadArticleSchema,</span>
+</span><span id="__span-0-1887"><a id="__codelineno-0-1887" name="__codelineno-0-1887"></a><span class="sd">            nest_joins=True,</span>
+</span><span id="__span-0-1888"><a id="__codelineno-0-1888" name="__codelineno-0-1888"></a><span class="sd">            offset=0,</span>
+</span><span id="__span-0-1889"><a id="__codelineno-0-1889" name="__codelineno-0-1889"></a><span class="sd">            limit=10,</span>
+</span><span id="__span-0-1890"><a id="__codelineno-0-1890" name="__codelineno-0-1890"></a><span class="sd">            relationship_type=&#39;one-to-many&#39;,</span>
+</span><span id="__span-0-1891"><a id="__codelineno-0-1891" name="__codelineno-0-1891"></a><span class="sd">        )</span>
+</span><span id="__span-0-1892"><a id="__codelineno-0-1892" name="__codelineno-0-1892"></a><span class="sd">        # Expect &#39;posts&#39; to be nested as a list of dictionaries under each user</span>
+</span><span id="__span-0-1893"><a id="__codelineno-0-1893" name="__codelineno-0-1893"></a><span class="sd">        ```</span>
+</span><span id="__span-0-1894"><a id="__codelineno-0-1894" name="__codelineno-0-1894"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-1895"><a id="__codelineno-0-1895" name="__codelineno-0-1895"></a>    <span class="k">if</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="p">(</span>
+</span><span id="__span-0-1896"><a id="__codelineno-0-1896" name="__codelineno-0-1896"></a>        <span class="n">join_model</span>
+</span><span id="__span-0-1897"><a id="__codelineno-0-1897" name="__codelineno-0-1897"></a>        <span class="ow">or</span> <span class="n">join_prefix</span>
+</span><span id="__span-0-1898"><a id="__codelineno-0-1898" name="__codelineno-0-1898"></a>        <span class="ow">or</span> <span class="n">join_on</span>
+</span><span id="__span-0-1899"><a id="__codelineno-0-1899" name="__codelineno-0-1899"></a>        <span class="ow">or</span> <span class="n">join_schema_to_select</span>
+</span><span id="__span-0-1900"><a id="__codelineno-0-1900" name="__codelineno-0-1900"></a>        <span class="ow">or</span> <span class="n">alias</span>
+</span><span id="__span-0-1901"><a id="__codelineno-0-1901" name="__codelineno-0-1901"></a>        <span class="ow">or</span> <span class="n">relationship_type</span>
+</span><span id="__span-0-1902"><a id="__codelineno-0-1902" name="__codelineno-0-1902"></a>    <span class="p">):</span>
+</span><span id="__span-0-1903"><a id="__codelineno-0-1903" name="__codelineno-0-1903"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1904"><a id="__codelineno-0-1904" name="__codelineno-0-1904"></a>            <span class="s2">&quot;Cannot use both single join parameters and joins_config simultaneously.&quot;</span>
+</span><span id="__span-0-1905"><a id="__codelineno-0-1905" name="__codelineno-0-1905"></a>        <span class="p">)</span>
+</span><span id="__span-0-1906"><a id="__codelineno-0-1906" name="__codelineno-0-1906"></a>    <span class="k">elif</span> <span class="ow">not</span> <span class="n">joins_config</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1907"><a id="__codelineno-0-1907" name="__codelineno-0-1907"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;You need one of join_model or joins_config.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1908"><a id="__codelineno-0-1908" name="__codelineno-0-1908"></a>
+</span><span id="__span-0-1909"><a id="__codelineno-0-1909" name="__codelineno-0-1909"></a>    <span class="k">if</span> <span class="p">(</span><span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">limit</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">)</span> <span class="ow">or</span> <span class="n">offset</span> <span class="o">&lt;</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-1910"><a id="__codelineno-0-1910" name="__codelineno-0-1910"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="s2">&quot;Limit and offset must be non-negative.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1911"><a id="__codelineno-0-1911" name="__codelineno-0-1911"></a>
+</span><span id="__span-0-1912"><a id="__codelineno-0-1912" name="__codelineno-0-1912"></a>    <span class="k">if</span> <span class="n">relationship_type</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1913"><a id="__codelineno-0-1913" name="__codelineno-0-1913"></a>        <span class="n">relationship_type</span> <span class="o">=</span> <span class="s2">&quot;one-to-one&quot;</span>
+</span><span id="__span-0-1914"><a id="__codelineno-0-1914" name="__codelineno-0-1914"></a>
+</span><span id="__span-0-1915"><a id="__codelineno-0-1915" name="__codelineno-0-1915"></a>    <span class="n">primary_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-1916"><a id="__codelineno-0-1916" name="__codelineno-0-1916"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-1917"><a id="__codelineno-0-1917" name="__codelineno-0-1917"></a>    <span class="p">)</span>
+</span><span id="__span-0-1918"><a id="__codelineno-0-1918" name="__codelineno-0-1918"></a>    <span class="n">stmt</span><span class="p">:</span> <span class="n">Select</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">primary_select</span><span class="p">)</span>
+</span><span id="__span-0-1919"><a id="__codelineno-0-1919" name="__codelineno-0-1919"></a>
+</span><span id="__span-0-1920"><a id="__codelineno-0-1920" name="__codelineno-0-1920"></a>    <span class="n">join_definitions</span> <span class="o">=</span> <span class="n">joins_config</span> <span class="k">if</span> <span class="n">joins_config</span> <span class="k">else</span> <span class="p">[]</span>
+</span><span id="__span-0-1921"><a id="__codelineno-0-1921" name="__codelineno-0-1921"></a>    <span class="k">if</span> <span class="n">join_model</span><span class="p">:</span>
+</span><span id="__span-0-1922"><a id="__codelineno-0-1922" name="__codelineno-0-1922"></a>        <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1923"><a id="__codelineno-0-1923" name="__codelineno-0-1923"></a>            <span class="n">join_definitions</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+</span><span id="__span-0-1924"><a id="__codelineno-0-1924" name="__codelineno-0-1924"></a>                <span class="n">JoinConfig</span><span class="p">(</span>
+</span><span id="__span-0-1925"><a id="__codelineno-0-1925" name="__codelineno-0-1925"></a>                    <span class="n">model</span><span class="o">=</span><span class="n">join_model</span><span class="p">,</span>
+</span><span id="__span-0-1926"><a id="__codelineno-0-1926" name="__codelineno-0-1926"></a>                    <span class="n">join_on</span><span class="o">=</span><span class="n">join_on</span>
+</span><span id="__span-0-1927"><a id="__codelineno-0-1927" name="__codelineno-0-1927"></a>                    <span class="k">if</span> <span class="n">join_on</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+</span><span id="__span-0-1928"><a id="__codelineno-0-1928" name="__codelineno-0-1928"></a>                    <span class="k">else</span> <span class="n">_auto_detect_join_condition</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">join_model</span><span class="p">),</span>
+</span><span id="__span-0-1929"><a id="__codelineno-0-1929" name="__codelineno-0-1929"></a>                    <span class="n">join_prefix</span><span class="o">=</span><span class="n">join_prefix</span><span class="p">,</span>
+</span><span id="__span-0-1930"><a id="__codelineno-0-1930" name="__codelineno-0-1930"></a>                    <span class="n">schema_to_select</span><span class="o">=</span><span class="n">join_schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-1931"><a id="__codelineno-0-1931" name="__codelineno-0-1931"></a>                    <span class="n">join_type</span><span class="o">=</span><span class="n">join_type</span><span class="p">,</span>
+</span><span id="__span-0-1932"><a id="__codelineno-0-1932" name="__codelineno-0-1932"></a>                    <span class="n">alias</span><span class="o">=</span><span class="n">alias</span><span class="p">,</span>
+</span><span id="__span-0-1933"><a id="__codelineno-0-1933" name="__codelineno-0-1933"></a>                    <span class="n">filters</span><span class="o">=</span><span class="n">join_filters</span><span class="p">,</span>
+</span><span id="__span-0-1934"><a id="__codelineno-0-1934" name="__codelineno-0-1934"></a>                    <span class="n">relationship_type</span><span class="o">=</span><span class="n">relationship_type</span><span class="p">,</span>
+</span><span id="__span-0-1935"><a id="__codelineno-0-1935" name="__codelineno-0-1935"></a>                <span class="p">)</span>
+</span><span id="__span-0-1936"><a id="__codelineno-0-1936" name="__codelineno-0-1936"></a>            <span class="p">)</span>
+</span><span id="__span-0-1937"><a id="__codelineno-0-1937" name="__codelineno-0-1937"></a>        <span class="k">except</span> <span class="ne">ValueError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-1938"><a id="__codelineno-0-1938" name="__codelineno-0-1938"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Could not configure join: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1939"><a id="__codelineno-0-1939" name="__codelineno-0-1939"></a>
+</span><span id="__span-0-1940"><a id="__codelineno-0-1940" name="__codelineno-0-1940"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_prepare_and_apply_joins</span><span class="p">(</span>
+</span><span id="__span-0-1941"><a id="__codelineno-0-1941" name="__codelineno-0-1941"></a>        <span class="n">stmt</span><span class="o">=</span><span class="n">stmt</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span> <span class="n">use_temporary_prefix</span><span class="o">=</span><span class="n">nest_joins</span>
+</span><span id="__span-0-1942"><a id="__codelineno-0-1942" name="__codelineno-0-1942"></a>    <span class="p">)</span>
+</span><span id="__span-0-1943"><a id="__codelineno-0-1943" name="__codelineno-0-1943"></a>
+</span><span id="__span-0-1944"><a id="__codelineno-0-1944" name="__codelineno-0-1944"></a>    <span class="n">primary_filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-1945"><a id="__codelineno-0-1945" name="__codelineno-0-1945"></a>    <span class="k">if</span> <span class="n">primary_filters</span><span class="p">:</span>
+</span><span id="__span-0-1946"><a id="__codelineno-0-1946" name="__codelineno-0-1946"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">primary_filters</span><span class="p">)</span>
+</span><span id="__span-0-1947"><a id="__codelineno-0-1947" name="__codelineno-0-1947"></a>
+</span><span id="__span-0-1948"><a id="__codelineno-0-1948" name="__codelineno-0-1948"></a>    <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-1949"><a id="__codelineno-0-1949" name="__codelineno-0-1949"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
 </span><span id="__span-0-1950"><a id="__codelineno-0-1950" name="__codelineno-0-1950"></a>
-</span><span id="__span-0-1951"><a id="__codelineno-0-1951" name="__codelineno-0-1951"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-1952"><a id="__codelineno-0-1952" name="__codelineno-0-1952"></a>            <span class="k">if</span> <span class="n">schema_to_select</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-1953"><a id="__codelineno-0-1953" name="__codelineno-0-1953"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1954"><a id="__codelineno-0-1954" name="__codelineno-0-1954"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
-</span><span id="__span-0-1955"><a id="__codelineno-0-1955" name="__codelineno-0-1955"></a>                <span class="p">)</span>
-</span><span id="__span-0-1956"><a id="__codelineno-0-1956" name="__codelineno-0-1956"></a>            <span class="k">try</span><span class="p">:</span>
-</span><span id="__span-0-1957"><a id="__codelineno-0-1957" name="__codelineno-0-1957"></a>                <span class="n">model_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row_dict</span><span class="p">)</span>
-</span><span id="__span-0-1958"><a id="__codelineno-0-1958" name="__codelineno-0-1958"></a>                <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">model_instance</span><span class="p">)</span>
-</span><span id="__span-0-1959"><a id="__codelineno-0-1959" name="__codelineno-0-1959"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
-</span><span id="__span-0-1960"><a id="__codelineno-0-1960" name="__codelineno-0-1960"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-1961"><a id="__codelineno-0-1961" name="__codelineno-0-1961"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-1962"><a id="__codelineno-0-1962" name="__codelineno-0-1962"></a>                <span class="p">)</span>
-</span><span id="__span-0-1963"><a id="__codelineno-0-1963" name="__codelineno-0-1963"></a>        <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1964"><a id="__codelineno-0-1964" name="__codelineno-0-1964"></a>            <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row_dict</span><span class="p">)</span>
-</span><span id="__span-0-1965"><a id="__codelineno-0-1965" name="__codelineno-0-1965"></a>
-</span><span id="__span-0-1966"><a id="__codelineno-0-1966" name="__codelineno-0-1966"></a>    <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span>
-</span><span id="__span-0-1967"><a id="__codelineno-0-1967" name="__codelineno-0-1967"></a>        <span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
-</span><span id="__span-0-1968"><a id="__codelineno-0-1968" name="__codelineno-0-1968"></a>    <span class="p">):</span>
-</span><span id="__span-0-1969"><a id="__codelineno-0-1969" name="__codelineno-0-1969"></a>        <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_multi_join_data</span><span class="p">(</span>
-</span><span id="__span-0-1970"><a id="__codelineno-0-1970" name="__codelineno-0-1970"></a>            <span class="n">base_primary_key</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>
-</span><span id="__span-0-1971"><a id="__codelineno-0-1971" name="__codelineno-0-1971"></a>            <span class="n">data</span><span class="o">=</span><span class="n">data</span><span class="p">,</span>
-</span><span id="__span-0-1972"><a id="__codelineno-0-1972" name="__codelineno-0-1972"></a>            <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
-</span><span id="__span-0-1973"><a id="__codelineno-0-1973" name="__codelineno-0-1973"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-1974"><a id="__codelineno-0-1974" name="__codelineno-0-1974"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span> <span class="k">if</span> <span class="n">return_as_model</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-1975"><a id="__codelineno-0-1975" name="__codelineno-0-1975"></a>            <span class="n">nested_schema_to_select</span><span class="o">=</span><span class="p">{</span>
-</span><span id="__span-0-1976"><a id="__codelineno-0-1976" name="__codelineno-0-1976"></a>                <span class="p">(</span>
-</span><span id="__span-0-1977"><a id="__codelineno-0-1977" name="__codelineno-0-1977"></a>                    <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">)</span>
-</span><span id="__span-0-1978"><a id="__codelineno-0-1978" name="__codelineno-0-1978"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span>
-</span><span id="__span-0-1979"><a id="__codelineno-0-1979" name="__codelineno-0-1979"></a>                    <span class="k">else</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="vm">__name__</span>
-</span><span id="__span-0-1980"><a id="__codelineno-0-1980" name="__codelineno-0-1980"></a>                <span class="p">):</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1981"><a id="__codelineno-0-1981" name="__codelineno-0-1981"></a>                <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
-</span><span id="__span-0-1982"><a id="__codelineno-0-1982" name="__codelineno-0-1982"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-1983"><a id="__codelineno-0-1983" name="__codelineno-0-1983"></a>            <span class="p">},</span>
-</span><span id="__span-0-1984"><a id="__codelineno-0-1984" name="__codelineno-0-1984"></a>        <span class="p">)</span>
-</span><span id="__span-0-1985"><a id="__codelineno-0-1985" name="__codelineno-0-1985"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-1986"><a id="__codelineno-0-1986" name="__codelineno-0-1986"></a>        <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_handle_null_primary_key_multi_join</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">join_definitions</span><span class="p">)</span>
-</span><span id="__span-0-1987"><a id="__codelineno-0-1987" name="__codelineno-0-1987"></a>
-</span><span id="__span-0-1988"><a id="__codelineno-0-1988" name="__codelineno-0-1988"></a>    <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">nested_data</span><span class="p">}</span>
-</span><span id="__span-0-1989"><a id="__codelineno-0-1989" name="__codelineno-0-1989"></a>
-</span><span id="__span-0-1990"><a id="__codelineno-0-1990" name="__codelineno-0-1990"></a>    <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
-</span><span id="__span-0-1991"><a id="__codelineno-0-1991" name="__codelineno-0-1991"></a>        <span class="n">total_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span>
-</span><span id="__span-0-1992"><a id="__codelineno-0-1992" name="__codelineno-0-1992"></a>            <span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">joins_config</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
-</span><span id="__span-0-1993"><a id="__codelineno-0-1993" name="__codelineno-0-1993"></a>        <span class="p">)</span>
-</span><span id="__span-0-1994"><a id="__codelineno-0-1994" name="__codelineno-0-1994"></a>        <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
-</span><span id="__span-0-1995"><a id="__codelineno-0-1995" name="__codelineno-0-1995"></a>
-</span><span id="__span-0-1996"><a id="__codelineno-0-1996" name="__codelineno-0-1996"></a>    <span class="k">return</span> <span class="n">response</span>
+</span><span id="__span-0-1951"><a id="__codelineno-0-1951" name="__codelineno-0-1951"></a>    <span class="k">if</span> <span class="n">offset</span><span class="p">:</span>
+</span><span id="__span-0-1952"><a id="__codelineno-0-1952" name="__codelineno-0-1952"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">offset</span><span class="p">(</span><span class="n">offset</span><span class="p">)</span>
+</span><span id="__span-0-1953"><a id="__codelineno-0-1953" name="__codelineno-0-1953"></a>    <span class="k">if</span> <span class="n">limit</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1954"><a id="__codelineno-0-1954" name="__codelineno-0-1954"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">limit</span><span class="p">(</span><span class="n">limit</span><span class="p">)</span>
+</span><span id="__span-0-1955"><a id="__codelineno-0-1955" name="__codelineno-0-1955"></a>
+</span><span id="__span-0-1956"><a id="__codelineno-0-1956" name="__codelineno-0-1956"></a>    <span class="n">result</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-1957"><a id="__codelineno-0-1957" name="__codelineno-0-1957"></a>    <span class="n">data</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="p">[]</span>
+</span><span id="__span-0-1958"><a id="__codelineno-0-1958" name="__codelineno-0-1958"></a>
+</span><span id="__span-0-1959"><a id="__codelineno-0-1959" name="__codelineno-0-1959"></a>    <span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">mappings</span><span class="p">()</span><span class="o">.</span><span class="n">all</span><span class="p">():</span>
+</span><span id="__span-0-1960"><a id="__codelineno-0-1960" name="__codelineno-0-1960"></a>        <span class="n">row_dict</span> <span class="o">=</span> <span class="nb">dict</span><span class="p">(</span><span class="n">row</span><span class="p">)</span>
+</span><span id="__span-0-1961"><a id="__codelineno-0-1961" name="__codelineno-0-1961"></a>
+</span><span id="__span-0-1962"><a id="__codelineno-0-1962" name="__codelineno-0-1962"></a>        <span class="k">if</span> <span class="n">nest_joins</span><span class="p">:</span>
+</span><span id="__span-0-1963"><a id="__codelineno-0-1963" name="__codelineno-0-1963"></a>            <span class="n">row_dict</span> <span class="o">=</span> <span class="n">_nest_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1964"><a id="__codelineno-0-1964" name="__codelineno-0-1964"></a>                <span class="n">data</span><span class="o">=</span><span class="n">row_dict</span><span class="p">,</span>
+</span><span id="__span-0-1965"><a id="__codelineno-0-1965" name="__codelineno-0-1965"></a>                <span class="n">join_definitions</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1966"><a id="__codelineno-0-1966" name="__codelineno-0-1966"></a>            <span class="p">)</span>
+</span><span id="__span-0-1967"><a id="__codelineno-0-1967" name="__codelineno-0-1967"></a>
+</span><span id="__span-0-1968"><a id="__codelineno-0-1968" name="__codelineno-0-1968"></a>        <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-1969"><a id="__codelineno-0-1969" name="__codelineno-0-1969"></a>            <span class="k">if</span> <span class="n">schema_to_select</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-1970"><a id="__codelineno-0-1970" name="__codelineno-0-1970"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1971"><a id="__codelineno-0-1971" name="__codelineno-0-1971"></a>                    <span class="s2">&quot;schema_to_select must be provided when return_as_model is True.&quot;</span>
+</span><span id="__span-0-1972"><a id="__codelineno-0-1972" name="__codelineno-0-1972"></a>                <span class="p">)</span>
+</span><span id="__span-0-1973"><a id="__codelineno-0-1973" name="__codelineno-0-1973"></a>            <span class="k">try</span><span class="p">:</span>
+</span><span id="__span-0-1974"><a id="__codelineno-0-1974" name="__codelineno-0-1974"></a>                <span class="n">model_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="p">(</span><span class="o">**</span><span class="n">row_dict</span><span class="p">)</span>
+</span><span id="__span-0-1975"><a id="__codelineno-0-1975" name="__codelineno-0-1975"></a>                <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">model_instance</span><span class="p">)</span>
+</span><span id="__span-0-1976"><a id="__codelineno-0-1976" name="__codelineno-0-1976"></a>            <span class="k">except</span> <span class="n">ValidationError</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+</span><span id="__span-0-1977"><a id="__codelineno-0-1977" name="__codelineno-0-1977"></a>                <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-1978"><a id="__codelineno-0-1978" name="__codelineno-0-1978"></a>                    <span class="sa">f</span><span class="s2">&quot;Data validation error for schema </span><span class="si">{</span><span class="n">schema_to_select</span><span class="o">.</span><span class="vm">__name__</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-1979"><a id="__codelineno-0-1979" name="__codelineno-0-1979"></a>                <span class="p">)</span>
+</span><span id="__span-0-1980"><a id="__codelineno-0-1980" name="__codelineno-0-1980"></a>        <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-1981"><a id="__codelineno-0-1981" name="__codelineno-0-1981"></a>            <span class="n">data</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">row_dict</span><span class="p">)</span>
+</span><span id="__span-0-1982"><a id="__codelineno-0-1982" name="__codelineno-0-1982"></a>
+</span><span id="__span-0-1983"><a id="__codelineno-0-1983" name="__codelineno-0-1983"></a>    <span class="k">if</span> <span class="n">nest_joins</span> <span class="ow">and</span> <span class="nb">any</span><span class="p">(</span>
+</span><span id="__span-0-1984"><a id="__codelineno-0-1984" name="__codelineno-0-1984"></a>        <span class="n">join</span><span class="o">.</span><span class="n">relationship_type</span> <span class="o">==</span> <span class="s2">&quot;one-to-many&quot;</span> <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
+</span><span id="__span-0-1985"><a id="__codelineno-0-1985" name="__codelineno-0-1985"></a>    <span class="p">):</span>
+</span><span id="__span-0-1986"><a id="__codelineno-0-1986" name="__codelineno-0-1986"></a>        <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_nest_multi_join_data</span><span class="p">(</span>
+</span><span id="__span-0-1987"><a id="__codelineno-0-1987" name="__codelineno-0-1987"></a>            <span class="n">base_primary_key</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">_primary_keys</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">name</span><span class="p">,</span>  <span class="c1"># type: ignore[misc]</span>
+</span><span id="__span-0-1988"><a id="__codelineno-0-1988" name="__codelineno-0-1988"></a>            <span class="n">data</span><span class="o">=</span><span class="n">data</span><span class="p">,</span>
+</span><span id="__span-0-1989"><a id="__codelineno-0-1989" name="__codelineno-0-1989"></a>            <span class="n">joins_config</span><span class="o">=</span><span class="n">join_definitions</span><span class="p">,</span>
+</span><span id="__span-0-1990"><a id="__codelineno-0-1990" name="__codelineno-0-1990"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-1991"><a id="__codelineno-0-1991" name="__codelineno-0-1991"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span> <span class="k">if</span> <span class="n">return_as_model</span> <span class="k">else</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-1992"><a id="__codelineno-0-1992" name="__codelineno-0-1992"></a>            <span class="n">nested_schema_to_select</span><span class="o">=</span><span class="p">{</span>
+</span><span id="__span-0-1993"><a id="__codelineno-0-1993" name="__codelineno-0-1993"></a>                <span class="p">(</span>
+</span><span id="__span-0-1994"><a id="__codelineno-0-1994" name="__codelineno-0-1994"></a>                    <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span><span class="o">.</span><span class="n">rstrip</span><span class="p">(</span><span class="s2">&quot;_&quot;</span><span class="p">)</span>
+</span><span id="__span-0-1995"><a id="__codelineno-0-1995" name="__codelineno-0-1995"></a>                    <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">join_prefix</span>
+</span><span id="__span-0-1996"><a id="__codelineno-0-1996" name="__codelineno-0-1996"></a>                    <span class="k">else</span> <span class="n">join</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">__tablename__</span>
+</span><span id="__span-0-1997"><a id="__codelineno-0-1997" name="__codelineno-0-1997"></a>                <span class="p">):</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-1998"><a id="__codelineno-0-1998" name="__codelineno-0-1998"></a>                <span class="k">for</span> <span class="n">join</span> <span class="ow">in</span> <span class="n">join_definitions</span>
+</span><span id="__span-0-1999"><a id="__codelineno-0-1999" name="__codelineno-0-1999"></a>                <span class="k">if</span> <span class="n">join</span><span class="o">.</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-2000"><a id="__codelineno-0-2000" name="__codelineno-0-2000"></a>            <span class="p">},</span>
+</span><span id="__span-0-2001"><a id="__codelineno-0-2001" name="__codelineno-0-2001"></a>        <span class="p">)</span>
+</span><span id="__span-0-2002"><a id="__codelineno-0-2002" name="__codelineno-0-2002"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2003"><a id="__codelineno-0-2003" name="__codelineno-0-2003"></a>        <span class="n">nested_data</span> <span class="o">=</span> <span class="n">_handle_null_primary_key_multi_join</span><span class="p">(</span><span class="n">data</span><span class="p">,</span> <span class="n">join_definitions</span><span class="p">)</span>
+</span><span id="__span-0-2004"><a id="__codelineno-0-2004" name="__codelineno-0-2004"></a>
+</span><span id="__span-0-2005"><a id="__codelineno-0-2005" name="__codelineno-0-2005"></a>    <span class="n">response</span><span class="p">:</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]</span> <span class="o">=</span> <span class="p">{</span><span class="s2">&quot;data&quot;</span><span class="p">:</span> <span class="n">nested_data</span><span class="p">}</span>
+</span><span id="__span-0-2006"><a id="__codelineno-0-2006" name="__codelineno-0-2006"></a>
+</span><span id="__span-0-2007"><a id="__codelineno-0-2007" name="__codelineno-0-2007"></a>    <span class="k">if</span> <span class="n">return_total_count</span><span class="p">:</span>
+</span><span id="__span-0-2008"><a id="__codelineno-0-2008" name="__codelineno-0-2008"></a>        <span class="n">total_count</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span>
+</span><span id="__span-0-2009"><a id="__codelineno-0-2009" name="__codelineno-0-2009"></a>            <span class="n">db</span><span class="o">=</span><span class="n">db</span><span class="p">,</span> <span class="n">joins_config</span><span class="o">=</span><span class="n">joins_config</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span>
+</span><span id="__span-0-2010"><a id="__codelineno-0-2010" name="__codelineno-0-2010"></a>        <span class="p">)</span>
+</span><span id="__span-0-2011"><a id="__codelineno-0-2011" name="__codelineno-0-2011"></a>        <span class="n">response</span><span class="p">[</span><span class="s2">&quot;total_count&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">total_count</span>
+</span><span id="__span-0-2012"><a id="__codelineno-0-2012" name="__codelineno-0-2012"></a>
+</span><span id="__span-0-2013"><a id="__codelineno-0-2013" name="__codelineno-0-2013"></a>    <span class="k">return</span> <span class="n">response</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -12301,7 +12439,7 @@ <h2 id="fastcrud.FastCRUD.select" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -12410,11 +12548,7 @@ <h2 id="fastcrud.FastCRUD.select" class="doc doc-heading">
 </details>
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-650">650</a></span>
-<span class="normal"><a href="#__codelineno-0-651">651</a></span>
-<span class="normal"><a href="#__codelineno-0-652">652</a></span>
-<span class="normal"><a href="#__codelineno-0-653">653</a></span>
-<span class="normal"><a href="#__codelineno-0-654">654</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-654">654</a></span>
 <span class="normal"><a href="#__codelineno-0-655">655</a></span>
 <span class="normal"><a href="#__codelineno-0-656">656</a></span>
 <span class="normal"><a href="#__codelineno-0-657">657</a></span>
@@ -12473,70 +12607,74 @@ <h2 id="fastcrud.FastCRUD.select" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-710">710</a></span>
 <span class="normal"><a href="#__codelineno-0-711">711</a></span>
 <span class="normal"><a href="#__codelineno-0-712">712</a></span>
-<span class="normal"><a href="#__codelineno-0-713">713</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-650"><a id="__codelineno-0-650" name="__codelineno-0-650"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">select</span><span class="p">(</span>
-</span><span id="__span-0-651"><a id="__codelineno-0-651" name="__codelineno-0-651"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-652"><a id="__codelineno-0-652" name="__codelineno-0-652"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-653"><a id="__codelineno-0-653" name="__codelineno-0-653"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
-</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a><span class="sd">    Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.</span>
-</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>
-</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a><span class="sd">    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
-</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a>
-</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+<span class="normal"><a href="#__codelineno-0-713">713</a></span>
+<span class="normal"><a href="#__codelineno-0-714">714</a></span>
+<span class="normal"><a href="#__codelineno-0-715">715</a></span>
+<span class="normal"><a href="#__codelineno-0-716">716</a></span>
+<span class="normal"><a href="#__codelineno-0-717">717</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-654"><a id="__codelineno-0-654" name="__codelineno-0-654"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">select</span><span class="p">(</span>
+</span><span id="__span-0-655"><a id="__codelineno-0-655" name="__codelineno-0-655"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-656"><a id="__codelineno-0-656" name="__codelineno-0-656"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-657"><a id="__codelineno-0-657" name="__codelineno-0-657"></a>    <span class="n">sort_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-658"><a id="__codelineno-0-658" name="__codelineno-0-658"></a>    <span class="n">sort_orders</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-659"><a id="__codelineno-0-659" name="__codelineno-0-659"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-660"><a id="__codelineno-0-660" name="__codelineno-0-660"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Select</span><span class="p">:</span>
+</span><span id="__span-0-661"><a id="__codelineno-0-661" name="__codelineno-0-661"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-662"><a id="__codelineno-0-662" name="__codelineno-0-662"></a><span class="sd">    Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.</span>
 </span><span id="__span-0-663"><a id="__codelineno-0-663" name="__codelineno-0-663"></a>
-</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a><span class="sd">        schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</span>
-</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a><span class="sd">        sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.</span>
-</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a><span class="sd">        sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.</span>
-</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
-</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a>
-</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a><span class="sd">        An SQL Alchemy `Select` statement object that can be executed or further modified.</span>
-</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a>
-</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a><span class="sd">        Selecting specific columns with filtering and sorting:</span>
-</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a>
-</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a><span class="sd">        stmt = await user_crud.select(</span>
-</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a><span class="sd">            sort_columns=[&#39;age&#39;, &#39;name&#39;],</span>
-</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a><span class="sd">            sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
-</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a><span class="sd">            age__gt=18,</span>
-</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a><span class="sd">        )</span>
-</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a><span class="sd">        ```</span>
-</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a>
-</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a><span class="sd">        Creating a statement to select all users without any filters:</span>
-</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a>
-</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a><span class="sd">        stmt = await user_crud.select()</span>
-</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a><span class="sd">        ```</span>
+</span><span id="__span-0-664"><a id="__codelineno-0-664" name="__codelineno-0-664"></a><span class="sd">    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</span>
+</span><span id="__span-0-665"><a id="__codelineno-0-665" name="__codelineno-0-665"></a>
+</span><span id="__span-0-666"><a id="__codelineno-0-666" name="__codelineno-0-666"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
+</span><span id="__span-0-667"><a id="__codelineno-0-667" name="__codelineno-0-667"></a>
+</span><span id="__span-0-668"><a id="__codelineno-0-668" name="__codelineno-0-668"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-669"><a id="__codelineno-0-669" name="__codelineno-0-669"></a><span class="sd">        schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</span>
+</span><span id="__span-0-670"><a id="__codelineno-0-670" name="__codelineno-0-670"></a><span class="sd">        sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.</span>
+</span><span id="__span-0-671"><a id="__codelineno-0-671" name="__codelineno-0-671"></a><span class="sd">        sort_orders: A single sort order (`&quot;asc&quot;` or `&quot;desc&quot;`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.</span>
+</span><span id="__span-0-672"><a id="__codelineno-0-672" name="__codelineno-0-672"></a><span class="sd">        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.</span>
+</span><span id="__span-0-673"><a id="__codelineno-0-673" name="__codelineno-0-673"></a>
+</span><span id="__span-0-674"><a id="__codelineno-0-674" name="__codelineno-0-674"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-675"><a id="__codelineno-0-675" name="__codelineno-0-675"></a><span class="sd">        An SQL Alchemy `Select` statement object that can be executed or further modified.</span>
+</span><span id="__span-0-676"><a id="__codelineno-0-676" name="__codelineno-0-676"></a>
+</span><span id="__span-0-677"><a id="__codelineno-0-677" name="__codelineno-0-677"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-678"><a id="__codelineno-0-678" name="__codelineno-0-678"></a><span class="sd">        Selecting specific columns with filtering and sorting:</span>
+</span><span id="__span-0-679"><a id="__codelineno-0-679" name="__codelineno-0-679"></a>
+</span><span id="__span-0-680"><a id="__codelineno-0-680" name="__codelineno-0-680"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-681"><a id="__codelineno-0-681" name="__codelineno-0-681"></a><span class="sd">        stmt = await user_crud.select(</span>
+</span><span id="__span-0-682"><a id="__codelineno-0-682" name="__codelineno-0-682"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-683"><a id="__codelineno-0-683" name="__codelineno-0-683"></a><span class="sd">            sort_columns=[&#39;age&#39;, &#39;name&#39;],</span>
+</span><span id="__span-0-684"><a id="__codelineno-0-684" name="__codelineno-0-684"></a><span class="sd">            sort_orders=[&#39;asc&#39;, &#39;desc&#39;],</span>
+</span><span id="__span-0-685"><a id="__codelineno-0-685" name="__codelineno-0-685"></a><span class="sd">            age__gt=18,</span>
+</span><span id="__span-0-686"><a id="__codelineno-0-686" name="__codelineno-0-686"></a><span class="sd">        )</span>
+</span><span id="__span-0-687"><a id="__codelineno-0-687" name="__codelineno-0-687"></a><span class="sd">        ```</span>
+</span><span id="__span-0-688"><a id="__codelineno-0-688" name="__codelineno-0-688"></a>
+</span><span id="__span-0-689"><a id="__codelineno-0-689" name="__codelineno-0-689"></a><span class="sd">        Creating a statement to select all users without any filters:</span>
 </span><span id="__span-0-690"><a id="__codelineno-0-690" name="__codelineno-0-690"></a>
-</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a><span class="sd">        Selecting users with a specific `role`, ordered by `name`:</span>
-</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a>
-</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a><span class="sd">        stmt = await user_crud.select(</span>
-</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a><span class="sd">            schema_to_select=UserReadSchema,</span>
-</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a><span class="sd">            sort_columns=&#39;name&#39;,</span>
-</span><span id="__span-0-697"><a id="__codelineno-0-697" name="__codelineno-0-697"></a><span class="sd">            role=&#39;admin&#39;,</span>
-</span><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a><span class="sd">        )</span>
-</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a><span class="sd">        ```</span>
-</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a>
-</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a><span class="sd">    Note:</span>
-</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a><span class="sd">        This method does not execute the generated SQL statement.</span>
-</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a><span class="sd">        Use `db.execute(stmt)` to run the query and fetch results.</span>
-</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a>    <span class="n">to_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
-</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
-</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a>    <span class="p">)</span>
-</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
-</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a>
-</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a>    <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
-</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
-</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a>    <span class="k">return</span> <span class="n">stmt</span>
+</span><span id="__span-0-691"><a id="__codelineno-0-691" name="__codelineno-0-691"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-692"><a id="__codelineno-0-692" name="__codelineno-0-692"></a><span class="sd">        stmt = await user_crud.select()</span>
+</span><span id="__span-0-693"><a id="__codelineno-0-693" name="__codelineno-0-693"></a><span class="sd">        ```</span>
+</span><span id="__span-0-694"><a id="__codelineno-0-694" name="__codelineno-0-694"></a>
+</span><span id="__span-0-695"><a id="__codelineno-0-695" name="__codelineno-0-695"></a><span class="sd">        Selecting users with a specific `role`, ordered by `name`:</span>
+</span><span id="__span-0-696"><a id="__codelineno-0-696" name="__codelineno-0-696"></a>
+</span><span id="__span-0-697"><a id="__codelineno-0-697" name="__codelineno-0-697"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-698"><a id="__codelineno-0-698" name="__codelineno-0-698"></a><span class="sd">        stmt = await user_crud.select(</span>
+</span><span id="__span-0-699"><a id="__codelineno-0-699" name="__codelineno-0-699"></a><span class="sd">            schema_to_select=UserReadSchema,</span>
+</span><span id="__span-0-700"><a id="__codelineno-0-700" name="__codelineno-0-700"></a><span class="sd">            sort_columns=&#39;name&#39;,</span>
+</span><span id="__span-0-701"><a id="__codelineno-0-701" name="__codelineno-0-701"></a><span class="sd">            role=&#39;admin&#39;,</span>
+</span><span id="__span-0-702"><a id="__codelineno-0-702" name="__codelineno-0-702"></a><span class="sd">        )</span>
+</span><span id="__span-0-703"><a id="__codelineno-0-703" name="__codelineno-0-703"></a><span class="sd">        ```</span>
+</span><span id="__span-0-704"><a id="__codelineno-0-704" name="__codelineno-0-704"></a>
+</span><span id="__span-0-705"><a id="__codelineno-0-705" name="__codelineno-0-705"></a><span class="sd">    Note:</span>
+</span><span id="__span-0-706"><a id="__codelineno-0-706" name="__codelineno-0-706"></a><span class="sd">        This method does not execute the generated SQL statement.</span>
+</span><span id="__span-0-707"><a id="__codelineno-0-707" name="__codelineno-0-707"></a><span class="sd">        Use `db.execute(stmt)` to run the query and fetch results.</span>
+</span><span id="__span-0-708"><a id="__codelineno-0-708" name="__codelineno-0-708"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-709"><a id="__codelineno-0-709" name="__codelineno-0-709"></a>    <span class="n">to_select</span> <span class="o">=</span> <span class="n">_extract_matching_columns_from_schema</span><span class="p">(</span>
+</span><span id="__span-0-710"><a id="__codelineno-0-710" name="__codelineno-0-710"></a>        <span class="n">model</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="n">schema</span><span class="o">=</span><span class="n">schema_to_select</span>
+</span><span id="__span-0-711"><a id="__codelineno-0-711" name="__codelineno-0-711"></a>    <span class="p">)</span>
+</span><span id="__span-0-712"><a id="__codelineno-0-712" name="__codelineno-0-712"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-713"><a id="__codelineno-0-713" name="__codelineno-0-713"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">select</span><span class="p">(</span><span class="o">*</span><span class="n">to_select</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span>
+</span><span id="__span-0-714"><a id="__codelineno-0-714" name="__codelineno-0-714"></a>
+</span><span id="__span-0-715"><a id="__codelineno-0-715" name="__codelineno-0-715"></a>    <span class="k">if</span> <span class="n">sort_columns</span><span class="p">:</span>
+</span><span id="__span-0-716"><a id="__codelineno-0-716" name="__codelineno-0-716"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_apply_sorting</span><span class="p">(</span><span class="n">stmt</span><span class="p">,</span> <span class="n">sort_columns</span><span class="p">,</span> <span class="n">sort_orders</span><span class="p">)</span>
+</span><span id="__span-0-717"><a id="__codelineno-0-717" name="__codelineno-0-717"></a>    <span class="k">return</span> <span class="n">stmt</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -12649,7 +12787,7 @@ <h2 id="fastcrud.FastCRUD.update" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -12718,7 +12856,7 @@ <h2 id="fastcrud.FastCRUD.update" class="doc doc-heading">
     <tbody>
         <tr>
           <td>
-                <code><span title="typing.Optional">Optional</span>[<span title="typing.Union">Union</span>[dict, <span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[<span title="typing.Union">Union</span>[dict, <span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -12750,6 +12888,16 @@ <h2 id="fastcrud.FastCRUD.update" class="doc doc-heading">
             </div>
           </td>
         </tr>
+        <tr>
+          <td>
+                <code><span title="sqlalchemy.exc.NoResultFound">NoResultFound</span></code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <p>If no record matches the filters. (on version 0.15.3)</p>
+            </div>
+          </td>
+        </tr>
         <tr>
           <td>
                 <code>ValueError</code>
@@ -12815,21 +12963,7 @@ <h2 id="fastcrud.FastCRUD.update" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2109">2109</a></span>
-<span class="normal"><a href="#__codelineno-0-2110">2110</a></span>
-<span class="normal"><a href="#__codelineno-0-2111">2111</a></span>
-<span class="normal"><a href="#__codelineno-0-2112">2112</a></span>
-<span class="normal"><a href="#__codelineno-0-2113">2113</a></span>
-<span class="normal"><a href="#__codelineno-0-2114">2114</a></span>
-<span class="normal"><a href="#__codelineno-0-2115">2115</a></span>
-<span class="normal"><a href="#__codelineno-0-2116">2116</a></span>
-<span class="normal"><a href="#__codelineno-0-2117">2117</a></span>
-<span class="normal"><a href="#__codelineno-0-2118">2118</a></span>
-<span class="normal"><a href="#__codelineno-0-2119">2119</a></span>
-<span class="normal"><a href="#__codelineno-0-2120">2120</a></span>
-<span class="normal"><a href="#__codelineno-0-2121">2121</a></span>
-<span class="normal"><a href="#__codelineno-0-2122">2122</a></span>
-<span class="normal"><a href="#__codelineno-0-2123">2123</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-2123">2123</a></span>
 <span class="normal"><a href="#__codelineno-0-2124">2124</a></span>
 <span class="normal"><a href="#__codelineno-0-2125">2125</a></span>
 <span class="normal"><a href="#__codelineno-0-2126">2126</a></span>
@@ -12947,139 +13081,165 @@ <h2 id="fastcrud.FastCRUD.update" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-2238">2238</a></span>
 <span class="normal"><a href="#__codelineno-0-2239">2239</a></span>
 <span class="normal"><a href="#__codelineno-0-2240">2240</a></span>
-<span class="normal"><a href="#__codelineno-0-2241">2241</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2109"><a id="__codelineno-0-2109" name="__codelineno-0-2109"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
-</span><span id="__span-0-2110"><a id="__codelineno-0-2110" name="__codelineno-0-2110"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-2111"><a id="__codelineno-0-2111" name="__codelineno-0-2111"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-2112"><a id="__codelineno-0-2112" name="__codelineno-0-2112"></a>    <span class="nb">object</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]],</span>
-</span><span id="__span-0-2113"><a id="__codelineno-0-2113" name="__codelineno-0-2113"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2114"><a id="__codelineno-0-2114" name="__codelineno-0-2114"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
-</span><span id="__span-0-2115"><a id="__codelineno-0-2115" name="__codelineno-0-2115"></a>    <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2116"><a id="__codelineno-0-2116" name="__codelineno-0-2116"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-2117"><a id="__codelineno-0-2117" name="__codelineno-0-2117"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2118"><a id="__codelineno-0-2118" name="__codelineno-0-2118"></a>    <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-2119"><a id="__codelineno-0-2119" name="__codelineno-0-2119"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-2120"><a id="__codelineno-0-2120" name="__codelineno-0-2120"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">BaseModel</span><span class="p">]]:</span>
-</span><span id="__span-0-2121"><a id="__codelineno-0-2121" name="__codelineno-0-2121"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-2122"><a id="__codelineno-0-2122" name="__codelineno-0-2122"></a><span class="sd">    Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</span>
-</span><span id="__span-0-2123"><a id="__codelineno-0-2123" name="__codelineno-0-2123"></a>
-</span><span id="__span-0-2124"><a id="__codelineno-0-2124" name="__codelineno-0-2124"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
-</span><span id="__span-0-2125"><a id="__codelineno-0-2125" name="__codelineno-0-2125"></a>
-</span><span id="__span-0-2126"><a id="__codelineno-0-2126" name="__codelineno-0-2126"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-2127"><a id="__codelineno-0-2127" name="__codelineno-0-2127"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-2128"><a id="__codelineno-0-2128" name="__codelineno-0-2128"></a><span class="sd">        object: A Pydantic schema or dictionary containing the update data.</span>
-</span><span id="__span-0-2129"><a id="__codelineno-0-2129" name="__codelineno-0-2129"></a><span class="sd">        allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
-</span><span id="__span-0-2130"><a id="__codelineno-0-2130" name="__codelineno-0-2130"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
-</span><span id="__span-0-2131"><a id="__codelineno-0-2131" name="__codelineno-0-2131"></a><span class="sd">        return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.</span>
-</span><span id="__span-0-2132"><a id="__codelineno-0-2132" name="__codelineno-0-2132"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.</span>
-</span><span id="__span-0-2133"><a id="__codelineno-0-2133" name="__codelineno-0-2133"></a><span class="sd">        return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.</span>
-</span><span id="__span-0-2134"><a id="__codelineno-0-2134" name="__codelineno-0-2134"></a><span class="sd">        one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.</span>
-</span><span id="__span-0-2135"><a id="__codelineno-0-2135" name="__codelineno-0-2135"></a><span class="sd">        **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</span>
-</span><span id="__span-0-2136"><a id="__codelineno-0-2136" name="__codelineno-0-2136"></a>
-</span><span id="__span-0-2137"><a id="__codelineno-0-2137" name="__codelineno-0-2137"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-2138"><a id="__codelineno-0-2138" name="__codelineno-0-2138"></a><span class="sd">        The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.</span>
+<span class="normal"><a href="#__codelineno-0-2241">2241</a></span>
+<span class="normal"><a href="#__codelineno-0-2242">2242</a></span>
+<span class="normal"><a href="#__codelineno-0-2243">2243</a></span>
+<span class="normal"><a href="#__codelineno-0-2244">2244</a></span>
+<span class="normal"><a href="#__codelineno-0-2245">2245</a></span>
+<span class="normal"><a href="#__codelineno-0-2246">2246</a></span>
+<span class="normal"><a href="#__codelineno-0-2247">2247</a></span>
+<span class="normal"><a href="#__codelineno-0-2248">2248</a></span>
+<span class="normal"><a href="#__codelineno-0-2249">2249</a></span>
+<span class="normal"><a href="#__codelineno-0-2250">2250</a></span>
+<span class="normal"><a href="#__codelineno-0-2251">2251</a></span>
+<span class="normal"><a href="#__codelineno-0-2252">2252</a></span>
+<span class="normal"><a href="#__codelineno-0-2253">2253</a></span>
+<span class="normal"><a href="#__codelineno-0-2254">2254</a></span>
+<span class="normal"><a href="#__codelineno-0-2255">2255</a></span>
+<span class="normal"><a href="#__codelineno-0-2256">2256</a></span>
+<span class="normal"><a href="#__codelineno-0-2257">2257</a></span>
+<span class="normal"><a href="#__codelineno-0-2258">2258</a></span>
+<span class="normal"><a href="#__codelineno-0-2259">2259</a></span>
+<span class="normal"><a href="#__codelineno-0-2260">2260</a></span>
+<span class="normal"><a href="#__codelineno-0-2261">2261</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-2123"><a id="__codelineno-0-2123" name="__codelineno-0-2123"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">update</span><span class="p">(</span>
+</span><span id="__span-0-2124"><a id="__codelineno-0-2124" name="__codelineno-0-2124"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-2125"><a id="__codelineno-0-2125" name="__codelineno-0-2125"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-2126"><a id="__codelineno-0-2126" name="__codelineno-0-2126"></a>    <span class="nb">object</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]],</span>
+</span><span id="__span-0-2127"><a id="__codelineno-0-2127" name="__codelineno-0-2127"></a>    <span class="n">allow_multiple</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2128"><a id="__codelineno-0-2128" name="__codelineno-0-2128"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">True</span><span class="p">,</span>
+</span><span id="__span-0-2129"><a id="__codelineno-0-2129" name="__codelineno-0-2129"></a>    <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2130"><a id="__codelineno-0-2130" name="__codelineno-0-2130"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-2131"><a id="__codelineno-0-2131" name="__codelineno-0-2131"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2132"><a id="__codelineno-0-2132" name="__codelineno-0-2132"></a>    <span class="n">one_or_none</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-2133"><a id="__codelineno-0-2133" name="__codelineno-0-2133"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-2134"><a id="__codelineno-0-2134" name="__codelineno-0-2134"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="nb">dict</span><span class="p">,</span> <span class="n">SelectSchemaType</span><span class="p">]]:</span>
+</span><span id="__span-0-2135"><a id="__codelineno-0-2135" name="__codelineno-0-2135"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-2136"><a id="__codelineno-0-2136" name="__codelineno-0-2136"></a><span class="sd">    Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</span>
+</span><span id="__span-0-2137"><a id="__codelineno-0-2137" name="__codelineno-0-2137"></a>
+</span><span id="__span-0-2138"><a id="__codelineno-0-2138" name="__codelineno-0-2138"></a><span class="sd">    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)</span>
 </span><span id="__span-0-2139"><a id="__codelineno-0-2139" name="__codelineno-0-2139"></a>
-</span><span id="__span-0-2140"><a id="__codelineno-0-2140" name="__codelineno-0-2140"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-2141"><a id="__codelineno-0-2141" name="__codelineno-0-2141"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
-</span><span id="__span-0-2142"><a id="__codelineno-0-2142" name="__codelineno-0-2142"></a><span class="sd">        ValueError: If extra fields not present in the model are provided in the update data.</span>
-</span><span id="__span-0-2143"><a id="__codelineno-0-2143" name="__codelineno-0-2143"></a><span class="sd">        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
-</span><span id="__span-0-2144"><a id="__codelineno-0-2144" name="__codelineno-0-2144"></a>
-</span><span id="__span-0-2145"><a id="__codelineno-0-2145" name="__codelineno-0-2145"></a><span class="sd">    Examples:</span>
-</span><span id="__span-0-2146"><a id="__codelineno-0-2146" name="__codelineno-0-2146"></a><span class="sd">        Update a user&#39;s email based on their ID:</span>
-</span><span id="__span-0-2147"><a id="__codelineno-0-2147" name="__codelineno-0-2147"></a>
-</span><span id="__span-0-2148"><a id="__codelineno-0-2148" name="__codelineno-0-2148"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2149"><a id="__codelineno-0-2149" name="__codelineno-0-2149"></a><span class="sd">        await user_crud.update(db, {&#39;email&#39;: &#39;new_email@example.com&#39;}, id=1)</span>
-</span><span id="__span-0-2150"><a id="__codelineno-0-2150" name="__codelineno-0-2150"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2151"><a id="__codelineno-0-2151" name="__codelineno-0-2151"></a>
-</span><span id="__span-0-2152"><a id="__codelineno-0-2152" name="__codelineno-0-2152"></a><span class="sd">        Update users to be inactive where age is greater than 30 and allow updates to multiple records:</span>
+</span><span id="__span-0-2140"><a id="__codelineno-0-2140" name="__codelineno-0-2140"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-2141"><a id="__codelineno-0-2141" name="__codelineno-0-2141"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-2142"><a id="__codelineno-0-2142" name="__codelineno-0-2142"></a><span class="sd">        object: A Pydantic schema or dictionary containing the update data.</span>
+</span><span id="__span-0-2143"><a id="__codelineno-0-2143" name="__codelineno-0-2143"></a><span class="sd">        allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.</span>
+</span><span id="__span-0-2144"><a id="__codelineno-0-2144" name="__codelineno-0-2144"></a><span class="sd">        commit: If `True`, commits the transaction immediately. Default is `True`.</span>
+</span><span id="__span-0-2145"><a id="__codelineno-0-2145" name="__codelineno-0-2145"></a><span class="sd">        return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.</span>
+</span><span id="__span-0-2146"><a id="__codelineno-0-2146" name="__codelineno-0-2146"></a><span class="sd">        schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.</span>
+</span><span id="__span-0-2147"><a id="__codelineno-0-2147" name="__codelineno-0-2147"></a><span class="sd">        return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.</span>
+</span><span id="__span-0-2148"><a id="__codelineno-0-2148" name="__codelineno-0-2148"></a><span class="sd">        one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.</span>
+</span><span id="__span-0-2149"><a id="__codelineno-0-2149" name="__codelineno-0-2149"></a><span class="sd">        **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-2150"><a id="__codelineno-0-2150" name="__codelineno-0-2150"></a>
+</span><span id="__span-0-2151"><a id="__codelineno-0-2151" name="__codelineno-0-2151"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-2152"><a id="__codelineno-0-2152" name="__codelineno-0-2152"></a><span class="sd">        The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.</span>
 </span><span id="__span-0-2153"><a id="__codelineno-0-2153" name="__codelineno-0-2153"></a>
-</span><span id="__span-0-2154"><a id="__codelineno-0-2154" name="__codelineno-0-2154"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2155"><a id="__codelineno-0-2155" name="__codelineno-0-2155"></a><span class="sd">        await user_crud.update(</span>
-</span><span id="__span-0-2156"><a id="__codelineno-0-2156" name="__codelineno-0-2156"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2157"><a id="__codelineno-0-2157" name="__codelineno-0-2157"></a><span class="sd">            {&#39;is_active&#39;: False},</span>
-</span><span id="__span-0-2158"><a id="__codelineno-0-2158" name="__codelineno-0-2158"></a><span class="sd">            allow_multiple=True,</span>
-</span><span id="__span-0-2159"><a id="__codelineno-0-2159" name="__codelineno-0-2159"></a><span class="sd">            age__gt=30,</span>
-</span><span id="__span-0-2160"><a id="__codelineno-0-2160" name="__codelineno-0-2160"></a><span class="sd">        )</span>
-</span><span id="__span-0-2161"><a id="__codelineno-0-2161" name="__codelineno-0-2161"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2154"><a id="__codelineno-0-2154" name="__codelineno-0-2154"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-2155"><a id="__codelineno-0-2155" name="__codelineno-0-2155"></a><span class="sd">        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.</span>
+</span><span id="__span-0-2156"><a id="__codelineno-0-2156" name="__codelineno-0-2156"></a><span class="sd">        NoResultFound: If no record matches the filters. (on version 0.15.3)</span>
+</span><span id="__span-0-2157"><a id="__codelineno-0-2157" name="__codelineno-0-2157"></a><span class="sd">        ValueError: If extra fields not present in the model are provided in the update data.</span>
+</span><span id="__span-0-2158"><a id="__codelineno-0-2158" name="__codelineno-0-2158"></a><span class="sd">        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.</span>
+</span><span id="__span-0-2159"><a id="__codelineno-0-2159" name="__codelineno-0-2159"></a>
+</span><span id="__span-0-2160"><a id="__codelineno-0-2160" name="__codelineno-0-2160"></a><span class="sd">    Examples:</span>
+</span><span id="__span-0-2161"><a id="__codelineno-0-2161" name="__codelineno-0-2161"></a><span class="sd">        Update a user&#39;s email based on their ID:</span>
 </span><span id="__span-0-2162"><a id="__codelineno-0-2162" name="__codelineno-0-2162"></a>
-</span><span id="__span-0-2163"><a id="__codelineno-0-2163" name="__codelineno-0-2163"></a><span class="sd">        Update a user&#39;s username excluding specific user ID and prevent multiple updates:</span>
-</span><span id="__span-0-2164"><a id="__codelineno-0-2164" name="__codelineno-0-2164"></a>
-</span><span id="__span-0-2165"><a id="__codelineno-0-2165" name="__codelineno-0-2165"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2166"><a id="__codelineno-0-2166" name="__codelineno-0-2166"></a><span class="sd">        await user_crud.update(</span>
-</span><span id="__span-0-2167"><a id="__codelineno-0-2167" name="__codelineno-0-2167"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2168"><a id="__codelineno-0-2168" name="__codelineno-0-2168"></a><span class="sd">            {&#39;username&#39;: &#39;new_username&#39;},</span>
-</span><span id="__span-0-2169"><a id="__codelineno-0-2169" name="__codelineno-0-2169"></a><span class="sd">            allow_multiple=False,</span>
-</span><span id="__span-0-2170"><a id="__codelineno-0-2170" name="__codelineno-0-2170"></a><span class="sd">            id__ne=1,</span>
-</span><span id="__span-0-2171"><a id="__codelineno-0-2171" name="__codelineno-0-2171"></a><span class="sd">        )</span>
-</span><span id="__span-0-2172"><a id="__codelineno-0-2172" name="__codelineno-0-2172"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2173"><a id="__codelineno-0-2173" name="__codelineno-0-2173"></a>
-</span><span id="__span-0-2174"><a id="__codelineno-0-2174" name="__codelineno-0-2174"></a><span class="sd">        Update a user&#39;s email and return the updated record as a Pydantic model instance:</span>
-</span><span id="__span-0-2175"><a id="__codelineno-0-2175" name="__codelineno-0-2175"></a>
-</span><span id="__span-0-2176"><a id="__codelineno-0-2176" name="__codelineno-0-2176"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2177"><a id="__codelineno-0-2177" name="__codelineno-0-2177"></a><span class="sd">        user = await user_crud.update(</span>
-</span><span id="__span-0-2178"><a id="__codelineno-0-2178" name="__codelineno-0-2178"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2179"><a id="__codelineno-0-2179" name="__codelineno-0-2179"></a><span class="sd">            {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
-</span><span id="__span-0-2180"><a id="__codelineno-0-2180" name="__codelineno-0-2180"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
-</span><span id="__span-0-2181"><a id="__codelineno-0-2181" name="__codelineno-0-2181"></a><span class="sd">            return_as_model=True,</span>
-</span><span id="__span-0-2182"><a id="__codelineno-0-2182" name="__codelineno-0-2182"></a><span class="sd">            id=1,</span>
-</span><span id="__span-0-2183"><a id="__codelineno-0-2183" name="__codelineno-0-2183"></a><span class="sd">        )</span>
-</span><span id="__span-0-2184"><a id="__codelineno-0-2184" name="__codelineno-0-2184"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2185"><a id="__codelineno-0-2185" name="__codelineno-0-2185"></a>
-</span><span id="__span-0-2186"><a id="__codelineno-0-2186" name="__codelineno-0-2186"></a><span class="sd">        Update a user&#39;s email and return the updated record as a dictionary:</span>
-</span><span id="__span-0-2187"><a id="__codelineno-0-2187" name="__codelineno-0-2187"></a><span class="sd">        ```python</span>
-</span><span id="__span-0-2188"><a id="__codelineno-0-2188" name="__codelineno-0-2188"></a><span class="sd">        user = await user_crud.update(</span>
-</span><span id="__span-0-2189"><a id="__codelineno-0-2189" name="__codelineno-0-2189"></a><span class="sd">            db,</span>
-</span><span id="__span-0-2190"><a id="__codelineno-0-2190" name="__codelineno-0-2190"></a><span class="sd">            {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
-</span><span id="__span-0-2191"><a id="__codelineno-0-2191" name="__codelineno-0-2191"></a><span class="sd">            return_columns=[&#39;id&#39;, &#39;email&#39;],</span>
-</span><span id="__span-0-2192"><a id="__codelineno-0-2192" name="__codelineno-0-2192"></a><span class="sd">            id=1,</span>
-</span><span id="__span-0-2193"><a id="__codelineno-0-2193" name="__codelineno-0-2193"></a><span class="sd">        )</span>
-</span><span id="__span-0-2194"><a id="__codelineno-0-2194" name="__codelineno-0-2194"></a><span class="sd">        ```</span>
-</span><span id="__span-0-2195"><a id="__codelineno-0-2195" name="__codelineno-0-2195"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-2196"><a id="__codelineno-0-2196" name="__codelineno-0-2196"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="p">(</span><span class="n">total_count</span> <span class="o">:=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">))</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-</span><span id="__span-0-2197"><a id="__codelineno-0-2197" name="__codelineno-0-2197"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
-</span><span id="__span-0-2198"><a id="__codelineno-0-2198" name="__codelineno-0-2198"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to update, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
-</span><span id="__span-0-2199"><a id="__codelineno-0-2199" name="__codelineno-0-2199"></a>        <span class="p">)</span>
+</span><span id="__span-0-2163"><a id="__codelineno-0-2163" name="__codelineno-0-2163"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2164"><a id="__codelineno-0-2164" name="__codelineno-0-2164"></a><span class="sd">        await user_crud.update(db, {&#39;email&#39;: &#39;new_email@example.com&#39;}, id=1)</span>
+</span><span id="__span-0-2165"><a id="__codelineno-0-2165" name="__codelineno-0-2165"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2166"><a id="__codelineno-0-2166" name="__codelineno-0-2166"></a>
+</span><span id="__span-0-2167"><a id="__codelineno-0-2167" name="__codelineno-0-2167"></a><span class="sd">        Update users to be inactive where age is greater than 30 and allow updates to multiple records:</span>
+</span><span id="__span-0-2168"><a id="__codelineno-0-2168" name="__codelineno-0-2168"></a>
+</span><span id="__span-0-2169"><a id="__codelineno-0-2169" name="__codelineno-0-2169"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2170"><a id="__codelineno-0-2170" name="__codelineno-0-2170"></a><span class="sd">        await user_crud.update(</span>
+</span><span id="__span-0-2171"><a id="__codelineno-0-2171" name="__codelineno-0-2171"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2172"><a id="__codelineno-0-2172" name="__codelineno-0-2172"></a><span class="sd">            {&#39;is_active&#39;: False},</span>
+</span><span id="__span-0-2173"><a id="__codelineno-0-2173" name="__codelineno-0-2173"></a><span class="sd">            allow_multiple=True,</span>
+</span><span id="__span-0-2174"><a id="__codelineno-0-2174" name="__codelineno-0-2174"></a><span class="sd">            age__gt=30,</span>
+</span><span id="__span-0-2175"><a id="__codelineno-0-2175" name="__codelineno-0-2175"></a><span class="sd">        )</span>
+</span><span id="__span-0-2176"><a id="__codelineno-0-2176" name="__codelineno-0-2176"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2177"><a id="__codelineno-0-2177" name="__codelineno-0-2177"></a>
+</span><span id="__span-0-2178"><a id="__codelineno-0-2178" name="__codelineno-0-2178"></a><span class="sd">        Update a user&#39;s username excluding specific user ID and prevent multiple updates:</span>
+</span><span id="__span-0-2179"><a id="__codelineno-0-2179" name="__codelineno-0-2179"></a>
+</span><span id="__span-0-2180"><a id="__codelineno-0-2180" name="__codelineno-0-2180"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2181"><a id="__codelineno-0-2181" name="__codelineno-0-2181"></a><span class="sd">        await user_crud.update(</span>
+</span><span id="__span-0-2182"><a id="__codelineno-0-2182" name="__codelineno-0-2182"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2183"><a id="__codelineno-0-2183" name="__codelineno-0-2183"></a><span class="sd">            {&#39;username&#39;: &#39;new_username&#39;},</span>
+</span><span id="__span-0-2184"><a id="__codelineno-0-2184" name="__codelineno-0-2184"></a><span class="sd">            allow_multiple=False,</span>
+</span><span id="__span-0-2185"><a id="__codelineno-0-2185" name="__codelineno-0-2185"></a><span class="sd">            id__ne=1,</span>
+</span><span id="__span-0-2186"><a id="__codelineno-0-2186" name="__codelineno-0-2186"></a><span class="sd">        )</span>
+</span><span id="__span-0-2187"><a id="__codelineno-0-2187" name="__codelineno-0-2187"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2188"><a id="__codelineno-0-2188" name="__codelineno-0-2188"></a>
+</span><span id="__span-0-2189"><a id="__codelineno-0-2189" name="__codelineno-0-2189"></a><span class="sd">        Update a user&#39;s email and return the updated record as a Pydantic model instance:</span>
+</span><span id="__span-0-2190"><a id="__codelineno-0-2190" name="__codelineno-0-2190"></a>
+</span><span id="__span-0-2191"><a id="__codelineno-0-2191" name="__codelineno-0-2191"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2192"><a id="__codelineno-0-2192" name="__codelineno-0-2192"></a><span class="sd">        user = await user_crud.update(</span>
+</span><span id="__span-0-2193"><a id="__codelineno-0-2193" name="__codelineno-0-2193"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2194"><a id="__codelineno-0-2194" name="__codelineno-0-2194"></a><span class="sd">            {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
+</span><span id="__span-0-2195"><a id="__codelineno-0-2195" name="__codelineno-0-2195"></a><span class="sd">            schema_to_select=ReadUserSchema,</span>
+</span><span id="__span-0-2196"><a id="__codelineno-0-2196" name="__codelineno-0-2196"></a><span class="sd">            return_as_model=True,</span>
+</span><span id="__span-0-2197"><a id="__codelineno-0-2197" name="__codelineno-0-2197"></a><span class="sd">            id=1,</span>
+</span><span id="__span-0-2198"><a id="__codelineno-0-2198" name="__codelineno-0-2198"></a><span class="sd">        )</span>
+</span><span id="__span-0-2199"><a id="__codelineno-0-2199" name="__codelineno-0-2199"></a><span class="sd">        ```</span>
 </span><span id="__span-0-2200"><a id="__codelineno-0-2200" name="__codelineno-0-2200"></a>
-</span><span id="__span-0-2201"><a id="__codelineno-0-2201" name="__codelineno-0-2201"></a>    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">object</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
-</span><span id="__span-0-2202"><a id="__codelineno-0-2202" name="__codelineno-0-2202"></a>        <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span>
-</span><span id="__span-0-2203"><a id="__codelineno-0-2203" name="__codelineno-0-2203"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-2204"><a id="__codelineno-0-2204" name="__codelineno-0-2204"></a>        <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">(</span><span class="n">exclude_unset</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-2205"><a id="__codelineno-0-2205" name="__codelineno-0-2205"></a>
-</span><span id="__span-0-2206"><a id="__codelineno-0-2206" name="__codelineno-0-2206"></a>    <span class="n">updated_at_col</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-</span><span id="__span-0-2207"><a id="__codelineno-0-2207" name="__codelineno-0-2207"></a>    <span class="k">if</span> <span class="n">updated_at_col</span><span class="p">:</span>
-</span><span id="__span-0-2208"><a id="__codelineno-0-2208" name="__codelineno-0-2208"></a>        <span class="n">update_data</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
-</span><span id="__span-0-2209"><a id="__codelineno-0-2209" name="__codelineno-0-2209"></a>
-</span><span id="__span-0-2210"><a id="__codelineno-0-2210" name="__codelineno-0-2210"></a>    <span class="n">update_data_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">update_data</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
-</span><span id="__span-0-2211"><a id="__codelineno-0-2211" name="__codelineno-0-2211"></a>    <span class="n">model_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">_column</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">_column</span> <span class="ow">in</span> <span class="n">inspect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">c</span><span class="p">}</span>
-</span><span id="__span-0-2212"><a id="__codelineno-0-2212" name="__codelineno-0-2212"></a>    <span class="n">extra_fields</span> <span class="o">=</span> <span class="n">update_data_keys</span> <span class="o">-</span> <span class="n">model_columns</span>
-</span><span id="__span-0-2213"><a id="__codelineno-0-2213" name="__codelineno-0-2213"></a>    <span class="k">if</span> <span class="n">extra_fields</span><span class="p">:</span>
-</span><span id="__span-0-2214"><a id="__codelineno-0-2214" name="__codelineno-0-2214"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Extra fields provided: </span><span class="si">{</span><span class="n">extra_fields</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-</span><span id="__span-0-2215"><a id="__codelineno-0-2215" name="__codelineno-0-2215"></a>
-</span><span id="__span-0-2216"><a id="__codelineno-0-2216" name="__codelineno-0-2216"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-2217"><a id="__codelineno-0-2217" name="__codelineno-0-2217"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="n">update_data</span><span class="p">)</span>
+</span><span id="__span-0-2201"><a id="__codelineno-0-2201" name="__codelineno-0-2201"></a><span class="sd">        Update a user&#39;s email and return the updated record as a dictionary:</span>
+</span><span id="__span-0-2202"><a id="__codelineno-0-2202" name="__codelineno-0-2202"></a><span class="sd">        ```python</span>
+</span><span id="__span-0-2203"><a id="__codelineno-0-2203" name="__codelineno-0-2203"></a><span class="sd">        user = await user_crud.update(</span>
+</span><span id="__span-0-2204"><a id="__codelineno-0-2204" name="__codelineno-0-2204"></a><span class="sd">            db,</span>
+</span><span id="__span-0-2205"><a id="__codelineno-0-2205" name="__codelineno-0-2205"></a><span class="sd">            {&#39;email&#39;: &#39;new_email@example.com&#39;},</span>
+</span><span id="__span-0-2206"><a id="__codelineno-0-2206" name="__codelineno-0-2206"></a><span class="sd">            return_columns=[&#39;id&#39;, &#39;email&#39;],</span>
+</span><span id="__span-0-2207"><a id="__codelineno-0-2207" name="__codelineno-0-2207"></a><span class="sd">            id=1,</span>
+</span><span id="__span-0-2208"><a id="__codelineno-0-2208" name="__codelineno-0-2208"></a><span class="sd">        )</span>
+</span><span id="__span-0-2209"><a id="__codelineno-0-2209" name="__codelineno-0-2209"></a><span class="sd">        ```</span>
+</span><span id="__span-0-2210"><a id="__codelineno-0-2210" name="__codelineno-0-2210"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-2211"><a id="__codelineno-0-2211" name="__codelineno-0-2211"></a>    <span class="n">total_count</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">count</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2212"><a id="__codelineno-0-2212" name="__codelineno-0-2212"></a>    <span class="k">if</span> <span class="n">total_count</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+</span><span id="__span-0-2213"><a id="__codelineno-0-2213" name="__codelineno-0-2213"></a>        <span class="k">raise</span> <span class="n">NoResultFound</span><span class="p">(</span><span class="s2">&quot;No record found to update.&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2214"><a id="__codelineno-0-2214" name="__codelineno-0-2214"></a>    <span class="k">if</span> <span class="ow">not</span> <span class="n">allow_multiple</span> <span class="ow">and</span> <span class="n">total_count</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+</span><span id="__span-0-2215"><a id="__codelineno-0-2215" name="__codelineno-0-2215"></a>        <span class="k">raise</span> <span class="n">MultipleResultsFound</span><span class="p">(</span>
+</span><span id="__span-0-2216"><a id="__codelineno-0-2216" name="__codelineno-0-2216"></a>            <span class="sa">f</span><span class="s2">&quot;Expected exactly one record to update, found </span><span class="si">{</span><span class="n">total_count</span><span class="si">}</span><span class="s2">.&quot;</span>
+</span><span id="__span-0-2217"><a id="__codelineno-0-2217" name="__codelineno-0-2217"></a>        <span class="p">)</span>
 </span><span id="__span-0-2218"><a id="__codelineno-0-2218" name="__codelineno-0-2218"></a>
-</span><span id="__span-0-2219"><a id="__codelineno-0-2219" name="__codelineno-0-2219"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-2220"><a id="__codelineno-0-2220" name="__codelineno-0-2220"></a>        <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
-</span><span id="__span-0-2221"><a id="__codelineno-0-2221" name="__codelineno-0-2221"></a>
-</span><span id="__span-0-2222"><a id="__codelineno-0-2222" name="__codelineno-0-2222"></a>    <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
-</span><span id="__span-0-2223"><a id="__codelineno-0-2223" name="__codelineno-0-2223"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
-</span><span id="__span-0-2224"><a id="__codelineno-0-2224" name="__codelineno-0-2224"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2225"><a id="__codelineno-0-2225" name="__codelineno-0-2225"></a>        <span class="k">if</span> <span class="n">allow_multiple</span><span class="p">:</span>
-</span><span id="__span-0-2226"><a id="__codelineno-0-2226" name="__codelineno-0-2226"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
-</span><span id="__span-0-2227"><a id="__codelineno-0-2227" name="__codelineno-0-2227"></a>                <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-2228"><a id="__codelineno-0-2228" name="__codelineno-0-2228"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2229"><a id="__codelineno-0-2229" name="__codelineno-0-2229"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-2230"><a id="__codelineno-0-2230" name="__codelineno-0-2230"></a>            <span class="p">)</span>
-</span><span id="__span-0-2231"><a id="__codelineno-0-2231" name="__codelineno-0-2231"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_single_response</span><span class="p">(</span>
-</span><span id="__span-0-2232"><a id="__codelineno-0-2232" name="__codelineno-0-2232"></a>            <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-2233"><a id="__codelineno-0-2233" name="__codelineno-0-2233"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-2234"><a id="__codelineno-0-2234" name="__codelineno-0-2234"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-2235"><a id="__codelineno-0-2235" name="__codelineno-0-2235"></a>            <span class="n">one_or_none</span><span class="o">=</span><span class="n">one_or_none</span><span class="p">,</span>
-</span><span id="__span-0-2236"><a id="__codelineno-0-2236" name="__codelineno-0-2236"></a>        <span class="p">)</span>
-</span><span id="__span-0-2237"><a id="__codelineno-0-2237" name="__codelineno-0-2237"></a>
-</span><span id="__span-0-2238"><a id="__codelineno-0-2238" name="__codelineno-0-2238"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
-</span><span id="__span-0-2239"><a id="__codelineno-0-2239" name="__codelineno-0-2239"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-</span><span id="__span-0-2240"><a id="__codelineno-0-2240" name="__codelineno-0-2240"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
-</span><span id="__span-0-2241"><a id="__codelineno-0-2241" name="__codelineno-0-2241"></a>    <span class="k">return</span> <span class="kc">None</span>
+</span><span id="__span-0-2219"><a id="__codelineno-0-2219" name="__codelineno-0-2219"></a>    <span class="k">if</span> <span class="nb">isinstance</span><span class="p">(</span><span class="nb">object</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
+</span><span id="__span-0-2220"><a id="__codelineno-0-2220" name="__codelineno-0-2220"></a>        <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span>
+</span><span id="__span-0-2221"><a id="__codelineno-0-2221" name="__codelineno-0-2221"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-2222"><a id="__codelineno-0-2222" name="__codelineno-0-2222"></a>        <span class="n">update_data</span> <span class="o">=</span> <span class="nb">object</span><span class="o">.</span><span class="n">model_dump</span><span class="p">(</span><span class="n">exclude_unset</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-2223"><a id="__codelineno-0-2223" name="__codelineno-0-2223"></a>
+</span><span id="__span-0-2224"><a id="__codelineno-0-2224" name="__codelineno-0-2224"></a>    <span class="n">updated_at_col</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
+</span><span id="__span-0-2225"><a id="__codelineno-0-2225" name="__codelineno-0-2225"></a>    <span class="k">if</span> <span class="n">updated_at_col</span><span class="p">:</span>
+</span><span id="__span-0-2226"><a id="__codelineno-0-2226" name="__codelineno-0-2226"></a>        <span class="n">update_data</span><span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">updated_at_column</span><span class="p">]</span> <span class="o">=</span> <span class="n">datetime</span><span class="o">.</span><span class="n">now</span><span class="p">(</span><span class="n">timezone</span><span class="o">.</span><span class="n">utc</span><span class="p">)</span>
+</span><span id="__span-0-2227"><a id="__codelineno-0-2227" name="__codelineno-0-2227"></a>
+</span><span id="__span-0-2228"><a id="__codelineno-0-2228" name="__codelineno-0-2228"></a>    <span class="n">update_data_keys</span> <span class="o">=</span> <span class="nb">set</span><span class="p">(</span><span class="n">update_data</span><span class="o">.</span><span class="n">keys</span><span class="p">())</span>
+</span><span id="__span-0-2229"><a id="__codelineno-0-2229" name="__codelineno-0-2229"></a>    <span class="n">model_columns</span> <span class="o">=</span> <span class="p">{</span><span class="n">_column</span><span class="o">.</span><span class="n">name</span> <span class="k">for</span> <span class="n">_column</span> <span class="ow">in</span> <span class="n">inspect</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">c</span><span class="p">}</span>
+</span><span id="__span-0-2230"><a id="__codelineno-0-2230" name="__codelineno-0-2230"></a>    <span class="n">extra_fields</span> <span class="o">=</span> <span class="n">update_data_keys</span> <span class="o">-</span> <span class="n">model_columns</span>
+</span><span id="__span-0-2231"><a id="__codelineno-0-2231" name="__codelineno-0-2231"></a>    <span class="k">if</span> <span class="n">extra_fields</span><span class="p">:</span>
+</span><span id="__span-0-2232"><a id="__codelineno-0-2232" name="__codelineno-0-2232"></a>        <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Extra fields provided: </span><span class="si">{</span><span class="n">extra_fields</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+</span><span id="__span-0-2233"><a id="__codelineno-0-2233" name="__codelineno-0-2233"></a>
+</span><span id="__span-0-2234"><a id="__codelineno-0-2234" name="__codelineno-0-2234"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-2235"><a id="__codelineno-0-2235" name="__codelineno-0-2235"></a>    <span class="n">stmt</span> <span class="o">=</span> <span class="n">update</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">*</span><span class="n">filters</span><span class="p">)</span><span class="o">.</span><span class="n">values</span><span class="p">(</span><span class="n">update_data</span><span class="p">)</span>
+</span><span id="__span-0-2236"><a id="__codelineno-0-2236" name="__codelineno-0-2236"></a>
+</span><span id="__span-0-2237"><a id="__codelineno-0-2237" name="__codelineno-0-2237"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-2238"><a id="__codelineno-0-2238" name="__codelineno-0-2238"></a>        <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
+</span><span id="__span-0-2239"><a id="__codelineno-0-2239" name="__codelineno-0-2239"></a>
+</span><span id="__span-0-2240"><a id="__codelineno-0-2240" name="__codelineno-0-2240"></a>    <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
+</span><span id="__span-0-2241"><a id="__codelineno-0-2241" name="__codelineno-0-2241"></a>        <span class="n">stmt</span> <span class="o">=</span> <span class="n">stmt</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
+</span><span id="__span-0-2242"><a id="__codelineno-0-2242" name="__codelineno-0-2242"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2243"><a id="__codelineno-0-2243" name="__codelineno-0-2243"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2244"><a id="__codelineno-0-2244" name="__codelineno-0-2244"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2245"><a id="__codelineno-0-2245" name="__codelineno-0-2245"></a>        <span class="k">if</span> <span class="n">allow_multiple</span><span class="p">:</span>
+</span><span id="__span-0-2246"><a id="__codelineno-0-2246" name="__codelineno-0-2246"></a>            <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
+</span><span id="__span-0-2247"><a id="__codelineno-0-2247" name="__codelineno-0-2247"></a>                <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-2248"><a id="__codelineno-0-2248" name="__codelineno-0-2248"></a>                <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-2249"><a id="__codelineno-0-2249" name="__codelineno-0-2249"></a>                <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-2250"><a id="__codelineno-0-2250" name="__codelineno-0-2250"></a>            <span class="p">)</span>
+</span><span id="__span-0-2251"><a id="__codelineno-0-2251" name="__codelineno-0-2251"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_single_response</span><span class="p">(</span>
+</span><span id="__span-0-2252"><a id="__codelineno-0-2252" name="__codelineno-0-2252"></a>            <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-2253"><a id="__codelineno-0-2253" name="__codelineno-0-2253"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-2254"><a id="__codelineno-0-2254" name="__codelineno-0-2254"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-2255"><a id="__codelineno-0-2255" name="__codelineno-0-2255"></a>            <span class="n">one_or_none</span><span class="o">=</span><span class="n">one_or_none</span><span class="p">,</span>
+</span><span id="__span-0-2256"><a id="__codelineno-0-2256" name="__codelineno-0-2256"></a>        <span class="p">)</span>
+</span><span id="__span-0-2257"><a id="__codelineno-0-2257" name="__codelineno-0-2257"></a>
+</span><span id="__span-0-2258"><a id="__codelineno-0-2258" name="__codelineno-0-2258"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">stmt</span><span class="p">)</span>
+</span><span id="__span-0-2259"><a id="__codelineno-0-2259" name="__codelineno-0-2259"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-2260"><a id="__codelineno-0-2260" name="__codelineno-0-2260"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-2261"><a id="__codelineno-0-2261" name="__codelineno-0-2261"></a>    <span class="k">return</span> <span class="kc">None</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -13150,7 +13310,7 @@ <h2 id="fastcrud.FastCRUD.upsert" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -13191,7 +13351,7 @@ <h2 id="fastcrud.FastCRUD.upsert" class="doc doc-heading">
     <tbody>
         <tr>
           <td>
-                <code><span title="typing.Union">Union</span>[<span title="pydantic.BaseModel">BaseModel</span>, <span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>], None]</code>
+                <code><span title="typing.Union">Union</span>[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>, dict[str, <span title="typing.Any">Any</span>], None]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -13204,11 +13364,7 @@ <h2 id="fastcrud.FastCRUD.upsert" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-786">786</a></span>
-<span class="normal"><a href="#__codelineno-0-787">787</a></span>
-<span class="normal"><a href="#__codelineno-0-788">788</a></span>
-<span class="normal"><a href="#__codelineno-0-789">789</a></span>
-<span class="normal"><a href="#__codelineno-0-790">790</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-790">790</a></span>
 <span class="normal"><a href="#__codelineno-0-791">791</a></span>
 <span class="normal"><a href="#__codelineno-0-792">792</a></span>
 <span class="normal"><a href="#__codelineno-0-793">793</a></span>
@@ -13246,49 +13402,53 @@ <h2 id="fastcrud.FastCRUD.upsert" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-825">825</a></span>
 <span class="normal"><a href="#__codelineno-0-826">826</a></span>
 <span class="normal"><a href="#__codelineno-0-827">827</a></span>
-<span class="normal"><a href="#__codelineno-0-828">828</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-786"><a id="__codelineno-0-786" name="__codelineno-0-786"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">upsert</span><span class="p">(</span>
-</span><span id="__span-0-787"><a id="__codelineno-0-787" name="__codelineno-0-787"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-788"><a id="__codelineno-0-788" name="__codelineno-0-788"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-789"><a id="__codelineno-0-789" name="__codelineno-0-789"></a>    <span class="n">instance</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">],</span>
-</span><span id="__span-0-790"><a id="__codelineno-0-790" name="__codelineno-0-790"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-791"><a id="__codelineno-0-791" name="__codelineno-0-791"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-792"><a id="__codelineno-0-792" name="__codelineno-0-792"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">,</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="kc">None</span><span class="p">]:</span>
-</span><span id="__span-0-793"><a id="__codelineno-0-793" name="__codelineno-0-793"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Update the instance or create it if it doesn&#39;t exists.</span>
-</span><span id="__span-0-794"><a id="__codelineno-0-794" name="__codelineno-0-794"></a>
-</span><span id="__span-0-795"><a id="__codelineno-0-795" name="__codelineno-0-795"></a><span class="sd">    Note: This method will perform two transactions to the database (get and create or update).</span>
-</span><span id="__span-0-796"><a id="__codelineno-0-796" name="__codelineno-0-796"></a>
-</span><span id="__span-0-797"><a id="__codelineno-0-797" name="__codelineno-0-797"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-798"><a id="__codelineno-0-798" name="__codelineno-0-798"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-799"><a id="__codelineno-0-799" name="__codelineno-0-799"></a><span class="sd">        instance: A Pydantic schema representing the instance.</span>
-</span><span id="__span-0-800"><a id="__codelineno-0-800" name="__codelineno-0-800"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.</span>
-</span><span id="__span-0-801"><a id="__codelineno-0-801" name="__codelineno-0-801"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
-</span><span id="__span-0-802"><a id="__codelineno-0-802" name="__codelineno-0-802"></a>
-</span><span id="__span-0-803"><a id="__codelineno-0-803" name="__codelineno-0-803"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-804"><a id="__codelineno-0-804" name="__codelineno-0-804"></a><span class="sd">        The created or updated instance</span>
-</span><span id="__span-0-805"><a id="__codelineno-0-805" name="__codelineno-0-805"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-806"><a id="__codelineno-0-806" name="__codelineno-0-806"></a>    <span class="n">_pks</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pk_dict</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
-</span><span id="__span-0-807"><a id="__codelineno-0-807" name="__codelineno-0-807"></a>    <span class="n">schema_to_select</span> <span class="o">=</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="nb">type</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
-</span><span id="__span-0-808"><a id="__codelineno-0-808" name="__codelineno-0-808"></a>    <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="__span-0-809"><a id="__codelineno-0-809" name="__codelineno-0-809"></a>        <span class="n">db</span><span class="p">,</span>
-</span><span id="__span-0-810"><a id="__codelineno-0-810" name="__codelineno-0-810"></a>        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-811"><a id="__codelineno-0-811" name="__codelineno-0-811"></a>        <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-812"><a id="__codelineno-0-812" name="__codelineno-0-812"></a>        <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
-</span><span id="__span-0-813"><a id="__codelineno-0-813" name="__codelineno-0-813"></a>    <span class="p">)</span>
-</span><span id="__span-0-814"><a id="__codelineno-0-814" name="__codelineno-0-814"></a>    <span class="k">if</span> <span class="n">db_instance</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-815"><a id="__codelineno-0-815" name="__codelineno-0-815"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-816"><a id="__codelineno-0-816" name="__codelineno-0-816"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="o">.</span><span class="n">model_validate</span><span class="p">(</span>
-</span><span id="__span-0-817"><a id="__codelineno-0-817" name="__codelineno-0-817"></a>            <span class="n">db_instance</span><span class="p">,</span> <span class="n">from_attributes</span><span class="o">=</span><span class="kc">True</span>
-</span><span id="__span-0-818"><a id="__codelineno-0-818" name="__codelineno-0-818"></a>        <span class="p">)</span>
-</span><span id="__span-0-819"><a id="__codelineno-0-819" name="__codelineno-0-819"></a>    <span class="k">else</span><span class="p">:</span>
-</span><span id="__span-0-820"><a id="__codelineno-0-820" name="__codelineno-0-820"></a>        <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
-</span><span id="__span-0-821"><a id="__codelineno-0-821" name="__codelineno-0-821"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
-</span><span id="__span-0-822"><a id="__codelineno-0-822" name="__codelineno-0-822"></a>            <span class="n">db</span><span class="p">,</span>
-</span><span id="__span-0-823"><a id="__codelineno-0-823" name="__codelineno-0-823"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-824"><a id="__codelineno-0-824" name="__codelineno-0-824"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-825"><a id="__codelineno-0-825" name="__codelineno-0-825"></a>            <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
-</span><span id="__span-0-826"><a id="__codelineno-0-826" name="__codelineno-0-826"></a>        <span class="p">)</span>
-</span><span id="__span-0-827"><a id="__codelineno-0-827" name="__codelineno-0-827"></a>
-</span><span id="__span-0-828"><a id="__codelineno-0-828" name="__codelineno-0-828"></a>    <span class="k">return</span> <span class="n">db_instance</span>
+<span class="normal"><a href="#__codelineno-0-828">828</a></span>
+<span class="normal"><a href="#__codelineno-0-829">829</a></span>
+<span class="normal"><a href="#__codelineno-0-830">830</a></span>
+<span class="normal"><a href="#__codelineno-0-831">831</a></span>
+<span class="normal"><a href="#__codelineno-0-832">832</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-790"><a id="__codelineno-0-790" name="__codelineno-0-790"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">upsert</span><span class="p">(</span>
+</span><span id="__span-0-791"><a id="__codelineno-0-791" name="__codelineno-0-791"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-792"><a id="__codelineno-0-792" name="__codelineno-0-792"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-793"><a id="__codelineno-0-793" name="__codelineno-0-793"></a>    <span class="n">instance</span><span class="p">:</span> <span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">],</span>
+</span><span id="__span-0-794"><a id="__codelineno-0-794" name="__codelineno-0-794"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-795"><a id="__codelineno-0-795" name="__codelineno-0-795"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-796"><a id="__codelineno-0-796" name="__codelineno-0-796"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Union</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">,</span> <span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">],</span> <span class="kc">None</span><span class="p">]:</span>
+</span><span id="__span-0-797"><a id="__codelineno-0-797" name="__codelineno-0-797"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Update the instance or create it if it doesn&#39;t exists.</span>
+</span><span id="__span-0-798"><a id="__codelineno-0-798" name="__codelineno-0-798"></a>
+</span><span id="__span-0-799"><a id="__codelineno-0-799" name="__codelineno-0-799"></a><span class="sd">    Note: This method will perform two transactions to the database (get and create or update).</span>
+</span><span id="__span-0-800"><a id="__codelineno-0-800" name="__codelineno-0-800"></a>
+</span><span id="__span-0-801"><a id="__codelineno-0-801" name="__codelineno-0-801"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-802"><a id="__codelineno-0-802" name="__codelineno-0-802"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-803"><a id="__codelineno-0-803" name="__codelineno-0-803"></a><span class="sd">        instance: A Pydantic schema representing the instance.</span>
+</span><span id="__span-0-804"><a id="__codelineno-0-804" name="__codelineno-0-804"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.</span>
+</span><span id="__span-0-805"><a id="__codelineno-0-805" name="__codelineno-0-805"></a><span class="sd">        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.</span>
+</span><span id="__span-0-806"><a id="__codelineno-0-806" name="__codelineno-0-806"></a>
+</span><span id="__span-0-807"><a id="__codelineno-0-807" name="__codelineno-0-807"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-808"><a id="__codelineno-0-808" name="__codelineno-0-808"></a><span class="sd">        The created or updated instance</span>
+</span><span id="__span-0-809"><a id="__codelineno-0-809" name="__codelineno-0-809"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-810"><a id="__codelineno-0-810" name="__codelineno-0-810"></a>    <span class="n">_pks</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_get_pk_dict</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>
+</span><span id="__span-0-811"><a id="__codelineno-0-811" name="__codelineno-0-811"></a>    <span class="n">schema_to_select</span> <span class="o">=</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="nb">type</span><span class="p">(</span><span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-812"><a id="__codelineno-0-812" name="__codelineno-0-812"></a>    <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-813"><a id="__codelineno-0-813" name="__codelineno-0-813"></a>        <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-814"><a id="__codelineno-0-814" name="__codelineno-0-814"></a>        <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-815"><a id="__codelineno-0-815" name="__codelineno-0-815"></a>        <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-816"><a id="__codelineno-0-816" name="__codelineno-0-816"></a>        <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
+</span><span id="__span-0-817"><a id="__codelineno-0-817" name="__codelineno-0-817"></a>    <span class="p">)</span>
+</span><span id="__span-0-818"><a id="__codelineno-0-818" name="__codelineno-0-818"></a>    <span class="k">if</span> <span class="n">db_instance</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-819"><a id="__codelineno-0-819" name="__codelineno-0-819"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">create</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-820"><a id="__codelineno-0-820" name="__codelineno-0-820"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="n">schema_to_select</span><span class="o">.</span><span class="n">model_validate</span><span class="p">(</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-821"><a id="__codelineno-0-821" name="__codelineno-0-821"></a>            <span class="n">db_instance</span><span class="p">,</span> <span class="n">from_attributes</span><span class="o">=</span><span class="kc">True</span>
+</span><span id="__span-0-822"><a id="__codelineno-0-822" name="__codelineno-0-822"></a>        <span class="p">)</span>
+</span><span id="__span-0-823"><a id="__codelineno-0-823" name="__codelineno-0-823"></a>    <span class="k">else</span><span class="p">:</span>
+</span><span id="__span-0-824"><a id="__codelineno-0-824" name="__codelineno-0-824"></a>        <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-825"><a id="__codelineno-0-825" name="__codelineno-0-825"></a>        <span class="n">db_instance</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">get</span><span class="p">(</span>
+</span><span id="__span-0-826"><a id="__codelineno-0-826" name="__codelineno-0-826"></a>            <span class="n">db</span><span class="p">,</span>
+</span><span id="__span-0-827"><a id="__codelineno-0-827" name="__codelineno-0-827"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>  <span class="c1"># type: ignore</span>
+</span><span id="__span-0-828"><a id="__codelineno-0-828" name="__codelineno-0-828"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-829"><a id="__codelineno-0-829" name="__codelineno-0-829"></a>            <span class="o">**</span><span class="n">_pks</span><span class="p">,</span>
+</span><span id="__span-0-830"><a id="__codelineno-0-830" name="__codelineno-0-830"></a>        <span class="p">)</span>
+</span><span id="__span-0-831"><a id="__codelineno-0-831" name="__codelineno-0-831"></a>
+</span><span id="__span-0-832"><a id="__codelineno-0-832" name="__codelineno-0-832"></a>    <span class="k">return</span> <span class="n">db_instance</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -13301,7 +13461,7 @@ <h2 id="fastcrud.FastCRUD.upsert" class="doc doc-heading">
 
 
 <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
-          <code class="highlight language-python"><span class="n">upsert_multi</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instances</span><span class="p">,</span> <span class="n">return_columns</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">schema_to_select</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">return_as_model</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">update_override</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
+          <code class="highlight language-python"><span class="n">upsert_multi</span><span class="p">(</span><span class="n">db</span><span class="p">,</span> <span class="n">instances</span><span class="p">,</span> <span class="n">commit</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">return_columns</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">schema_to_select</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="n">return_as_model</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span> <span class="n">update_override</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span></code>
   
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-async"><code>async</code></small>
@@ -13355,6 +13515,20 @@ <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
               <em>required</em>
           </td>
         </tr>
+        <tr>
+          <td><code>commit</code></td>
+          <td>
+                <code>bool</code>
+          </td>
+          <td>
+            <div class="doc-md-description">
+              <p>If True, commits the transaction immediately. Default is False.</p>
+            </div>
+          </td>
+          <td>
+                <code>False</code>
+          </td>
+        </tr>
         <tr>
           <td><code>return_columns</code></td>
           <td>
@@ -13372,7 +13546,7 @@ <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
         <tr>
           <td><code>schema_to_select</code></td>
           <td>
-                <code><span title="typing.Optional">Optional</span>[type[<span title="pydantic.BaseModel">BaseModel</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[type[<span title="fastcrud.types.SelectSchemaType">SelectSchemaType</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -13441,7 +13615,7 @@ <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
     <tbody>
         <tr>
           <td>
-                <code><span title="typing.Optional">Optional</span>[<span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>]]</code>
+                <code><span title="typing.Optional">Optional</span>[dict[str, <span title="typing.Any">Any</span>]]</code>
           </td>
           <td>
             <div class="doc-md-description">
@@ -13488,11 +13662,7 @@ <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
 
           <details class="quote">
             <summary>Source code in <code>fastcrud/crud/fast_crud.py</code></summary>
-            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-830">830</a></span>
-<span class="normal"><a href="#__codelineno-0-831">831</a></span>
-<span class="normal"><a href="#__codelineno-0-832">832</a></span>
-<span class="normal"><a href="#__codelineno-0-833">833</a></span>
-<span class="normal"><a href="#__codelineno-0-834">834</a></span>
+            <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-834">834</a></span>
 <span class="normal"><a href="#__codelineno-0-835">835</a></span>
 <span class="normal"><a href="#__codelineno-0-836">836</a></span>
 <span class="normal"><a href="#__codelineno-0-837">837</a></span>
@@ -13559,78 +13729,94 @@ <h2 id="fastcrud.FastCRUD.upsert_multi" class="doc doc-heading">
 <span class="normal"><a href="#__codelineno-0-898">898</a></span>
 <span class="normal"><a href="#__codelineno-0-899">899</a></span>
 <span class="normal"><a href="#__codelineno-0-900">900</a></span>
-<span class="normal"><a href="#__codelineno-0-901">901</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-830"><a id="__codelineno-0-830" name="__codelineno-0-830"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">upsert_multi</span><span class="p">(</span>
-</span><span id="__span-0-831"><a id="__codelineno-0-831" name="__codelineno-0-831"></a>    <span class="bp">self</span><span class="p">,</span>
-</span><span id="__span-0-832"><a id="__codelineno-0-832" name="__codelineno-0-832"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
-</span><span id="__span-0-833"><a id="__codelineno-0-833" name="__codelineno-0-833"></a>    <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
-</span><span id="__span-0-834"><a id="__codelineno-0-834" name="__codelineno-0-834"></a>    <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-835"><a id="__codelineno-0-835" name="__codelineno-0-835"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">BaseModel</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-836"><a id="__codelineno-0-836" name="__codelineno-0-836"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
-</span><span id="__span-0-837"><a id="__codelineno-0-837" name="__codelineno-0-837"></a>    <span class="n">update_override</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
-</span><span id="__span-0-838"><a id="__codelineno-0-838" name="__codelineno-0-838"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
-</span><span id="__span-0-839"><a id="__codelineno-0-839" name="__codelineno-0-839"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
-</span><span id="__span-0-840"><a id="__codelineno-0-840" name="__codelineno-0-840"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-</span><span id="__span-0-841"><a id="__codelineno-0-841" name="__codelineno-0-841"></a><span class="sd">    Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</span>
-</span><span id="__span-0-842"><a id="__codelineno-0-842" name="__codelineno-0-842"></a>
-</span><span id="__span-0-843"><a id="__codelineno-0-843" name="__codelineno-0-843"></a><span class="sd">    Args:</span>
-</span><span id="__span-0-844"><a id="__codelineno-0-844" name="__codelineno-0-844"></a><span class="sd">        db: The database session to use for the operation.</span>
-</span><span id="__span-0-845"><a id="__codelineno-0-845" name="__codelineno-0-845"></a><span class="sd">        instances: A list of Pydantic schemas representing the instances to upsert.</span>
-</span><span id="__span-0-846"><a id="__codelineno-0-846" name="__codelineno-0-846"></a><span class="sd">        return_columns: Optional list of column names to return after the upsert operation.</span>
-</span><span id="__span-0-847"><a id="__codelineno-0-847" name="__codelineno-0-847"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</span>
-</span><span id="__span-0-848"><a id="__codelineno-0-848" name="__codelineno-0-848"></a><span class="sd">        return_as_model: If True, returns data as instances of the specified Pydantic model.</span>
-</span><span id="__span-0-849"><a id="__codelineno-0-849" name="__codelineno-0-849"></a><span class="sd">        update_override: Optional dictionary to override the update values for the upsert operation.</span>
-</span><span id="__span-0-850"><a id="__codelineno-0-850" name="__codelineno-0-850"></a><span class="sd">        **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</span>
-</span><span id="__span-0-851"><a id="__codelineno-0-851" name="__codelineno-0-851"></a>
-</span><span id="__span-0-852"><a id="__codelineno-0-852" name="__codelineno-0-852"></a><span class="sd">    Returns:</span>
-</span><span id="__span-0-853"><a id="__codelineno-0-853" name="__codelineno-0-853"></a><span class="sd">        The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.</span>
-</span><span id="__span-0-854"><a id="__codelineno-0-854" name="__codelineno-0-854"></a>
-</span><span id="__span-0-855"><a id="__codelineno-0-855" name="__codelineno-0-855"></a><span class="sd">    Raises:</span>
-</span><span id="__span-0-856"><a id="__codelineno-0-856" name="__codelineno-0-856"></a><span class="sd">        ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</span>
-</span><span id="__span-0-857"><a id="__codelineno-0-857" name="__codelineno-0-857"></a><span class="sd">        NotImplementedError: If the database dialect is not supported for upsert multi.</span>
-</span><span id="__span-0-858"><a id="__codelineno-0-858" name="__codelineno-0-858"></a><span class="sd">    &quot;&quot;&quot;</span>
-</span><span id="__span-0-859"><a id="__codelineno-0-859" name="__codelineno-0-859"></a>    <span class="k">if</span> <span class="n">update_override</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
-</span><span id="__span-0-860"><a id="__codelineno-0-860" name="__codelineno-0-860"></a>        <span class="n">update_override</span> <span class="o">=</span> <span class="p">{}</span>
-</span><span id="__span-0-861"><a id="__codelineno-0-861" name="__codelineno-0-861"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-</span><span id="__span-0-862"><a id="__codelineno-0-862" name="__codelineno-0-862"></a>
-</span><span id="__span-0-863"><a id="__codelineno-0-863" name="__codelineno-0-863"></a>    <span class="k">if</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;postgresql&quot;</span><span class="p">:</span>
-</span><span id="__span-0-864"><a id="__codelineno-0-864" name="__codelineno-0-864"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_postgresql</span><span class="p">(</span>
-</span><span id="__span-0-865"><a id="__codelineno-0-865" name="__codelineno-0-865"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-866"><a id="__codelineno-0-866" name="__codelineno-0-866"></a>        <span class="p">)</span>
-</span><span id="__span-0-867"><a id="__codelineno-0-867" name="__codelineno-0-867"></a>    <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;sqlite&quot;</span><span class="p">:</span>
-</span><span id="__span-0-868"><a id="__codelineno-0-868" name="__codelineno-0-868"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_sqlite</span><span class="p">(</span>
-</span><span id="__span-0-869"><a id="__codelineno-0-869" name="__codelineno-0-869"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-870"><a id="__codelineno-0-870" name="__codelineno-0-870"></a>        <span class="p">)</span>
-</span><span id="__span-0-871"><a id="__codelineno-0-871" name="__codelineno-0-871"></a>    <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;mysql&quot;</span><span class="p">,</span> <span class="s2">&quot;mariadb&quot;</span><span class="p">]:</span>
-</span><span id="__span-0-872"><a id="__codelineno-0-872" name="__codelineno-0-872"></a>        <span class="k">if</span> <span class="n">filters</span><span class="p">:</span>
-</span><span id="__span-0-873"><a id="__codelineno-0-873" name="__codelineno-0-873"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-874"><a id="__codelineno-0-874" name="__codelineno-0-874"></a>                <span class="s2">&quot;MySQL does not support filtering on insert operations.&quot;</span>
-</span><span id="__span-0-875"><a id="__codelineno-0-875" name="__codelineno-0-875"></a>            <span class="p">)</span>
-</span><span id="__span-0-876"><a id="__codelineno-0-876" name="__codelineno-0-876"></a>        <span class="k">if</span> <span class="n">return_columns</span> <span class="ow">or</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-877"><a id="__codelineno-0-877" name="__codelineno-0-877"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
-</span><span id="__span-0-878"><a id="__codelineno-0-878" name="__codelineno-0-878"></a>                <span class="s2">&quot;MySQL does not support the returning clause for insert operations.&quot;</span>
-</span><span id="__span-0-879"><a id="__codelineno-0-879" name="__codelineno-0-879"></a>            <span class="p">)</span>
-</span><span id="__span-0-880"><a id="__codelineno-0-880" name="__codelineno-0-880"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_mysql</span><span class="p">(</span>
-</span><span id="__span-0-881"><a id="__codelineno-0-881" name="__codelineno-0-881"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">update_override</span>
-</span><span id="__span-0-882"><a id="__codelineno-0-882" name="__codelineno-0-882"></a>        <span class="p">)</span>
-</span><span id="__span-0-883"><a id="__codelineno-0-883" name="__codelineno-0-883"></a>    <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
-</span><span id="__span-0-884"><a id="__codelineno-0-884" name="__codelineno-0-884"></a>        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
-</span><span id="__span-0-885"><a id="__codelineno-0-885" name="__codelineno-0-885"></a>            <span class="sa">f</span><span class="s2">&quot;Upsert multi is not implemented for </span><span class="si">{</span><span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span>
-</span><span id="__span-0-886"><a id="__codelineno-0-886" name="__codelineno-0-886"></a>        <span class="p">)</span>
-</span><span id="__span-0-887"><a id="__codelineno-0-887" name="__codelineno-0-887"></a>
-</span><span id="__span-0-888"><a id="__codelineno-0-888" name="__codelineno-0-888"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
-</span><span id="__span-0-889"><a id="__codelineno-0-889" name="__codelineno-0-889"></a>        <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
-</span><span id="__span-0-890"><a id="__codelineno-0-890" name="__codelineno-0-890"></a>
-</span><span id="__span-0-891"><a id="__codelineno-0-891" name="__codelineno-0-891"></a>    <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
-</span><span id="__span-0-892"><a id="__codelineno-0-892" name="__codelineno-0-892"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
-</span><span id="__span-0-893"><a id="__codelineno-0-893" name="__codelineno-0-893"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
-</span><span id="__span-0-894"><a id="__codelineno-0-894" name="__codelineno-0-894"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
-</span><span id="__span-0-895"><a id="__codelineno-0-895" name="__codelineno-0-895"></a>            <span class="n">db_row</span><span class="p">,</span>
-</span><span id="__span-0-896"><a id="__codelineno-0-896" name="__codelineno-0-896"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
-</span><span id="__span-0-897"><a id="__codelineno-0-897" name="__codelineno-0-897"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
-</span><span id="__span-0-898"><a id="__codelineno-0-898" name="__codelineno-0-898"></a>        <span class="p">)</span>
-</span><span id="__span-0-899"><a id="__codelineno-0-899" name="__codelineno-0-899"></a>
-</span><span id="__span-0-900"><a id="__codelineno-0-900" name="__codelineno-0-900"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
-</span><span id="__span-0-901"><a id="__codelineno-0-901" name="__codelineno-0-901"></a>    <span class="k">return</span> <span class="kc">None</span>
+<span class="normal"><a href="#__codelineno-0-901">901</a></span>
+<span class="normal"><a href="#__codelineno-0-902">902</a></span>
+<span class="normal"><a href="#__codelineno-0-903">903</a></span>
+<span class="normal"><a href="#__codelineno-0-904">904</a></span>
+<span class="normal"><a href="#__codelineno-0-905">905</a></span>
+<span class="normal"><a href="#__codelineno-0-906">906</a></span>
+<span class="normal"><a href="#__codelineno-0-907">907</a></span>
+<span class="normal"><a href="#__codelineno-0-908">908</a></span>
+<span class="normal"><a href="#__codelineno-0-909">909</a></span>
+<span class="normal"><a href="#__codelineno-0-910">910</a></span>
+<span class="normal"><a href="#__codelineno-0-911">911</a></span></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-834"><a id="__codelineno-0-834" name="__codelineno-0-834"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">upsert_multi</span><span class="p">(</span>
+</span><span id="__span-0-835"><a id="__codelineno-0-835" name="__codelineno-0-835"></a>    <span class="bp">self</span><span class="p">,</span>
+</span><span id="__span-0-836"><a id="__codelineno-0-836" name="__codelineno-0-836"></a>    <span class="n">db</span><span class="p">:</span> <span class="n">AsyncSession</span><span class="p">,</span>
+</span><span id="__span-0-837"><a id="__codelineno-0-837" name="__codelineno-0-837"></a>    <span class="n">instances</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">Union</span><span class="p">[</span><span class="n">UpdateSchemaType</span><span class="p">,</span> <span class="n">CreateSchemaType</span><span class="p">]],</span>
+</span><span id="__span-0-838"><a id="__codelineno-0-838" name="__codelineno-0-838"></a>    <span class="n">commit</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-839"><a id="__codelineno-0-839" name="__codelineno-0-839"></a>    <span class="n">return_columns</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-840"><a id="__codelineno-0-840" name="__codelineno-0-840"></a>    <span class="n">schema_to_select</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">type</span><span class="p">[</span><span class="n">SelectSchemaType</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-841"><a id="__codelineno-0-841" name="__codelineno-0-841"></a>    <span class="n">return_as_model</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>
+</span><span id="__span-0-842"><a id="__codelineno-0-842" name="__codelineno-0-842"></a>    <span class="n">update_override</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>
+</span><span id="__span-0-843"><a id="__codelineno-0-843" name="__codelineno-0-843"></a>    <span class="o">**</span><span class="n">kwargs</span><span class="p">:</span> <span class="n">Any</span><span class="p">,</span>
+</span><span id="__span-0-844"><a id="__codelineno-0-844" name="__codelineno-0-844"></a><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]:</span>
+</span><span id="__span-0-845"><a id="__codelineno-0-845" name="__codelineno-0-845"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+</span><span id="__span-0-846"><a id="__codelineno-0-846" name="__codelineno-0-846"></a><span class="sd">    Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</span>
+</span><span id="__span-0-847"><a id="__codelineno-0-847" name="__codelineno-0-847"></a>
+</span><span id="__span-0-848"><a id="__codelineno-0-848" name="__codelineno-0-848"></a><span class="sd">    Args:</span>
+</span><span id="__span-0-849"><a id="__codelineno-0-849" name="__codelineno-0-849"></a><span class="sd">        db: The database session to use for the operation.</span>
+</span><span id="__span-0-850"><a id="__codelineno-0-850" name="__codelineno-0-850"></a><span class="sd">        instances: A list of Pydantic schemas representing the instances to upsert.</span>
+</span><span id="__span-0-851"><a id="__codelineno-0-851" name="__codelineno-0-851"></a><span class="sd">        commit: If True, commits the transaction immediately. Default is False.</span>
+</span><span id="__span-0-852"><a id="__codelineno-0-852" name="__codelineno-0-852"></a><span class="sd">        return_columns: Optional list of column names to return after the upsert operation.</span>
+</span><span id="__span-0-853"><a id="__codelineno-0-853" name="__codelineno-0-853"></a><span class="sd">        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</span>
+</span><span id="__span-0-854"><a id="__codelineno-0-854" name="__codelineno-0-854"></a><span class="sd">        return_as_model: If True, returns data as instances of the specified Pydantic model.</span>
+</span><span id="__span-0-855"><a id="__codelineno-0-855" name="__codelineno-0-855"></a><span class="sd">        update_override: Optional dictionary to override the update values for the upsert operation.</span>
+</span><span id="__span-0-856"><a id="__codelineno-0-856" name="__codelineno-0-856"></a><span class="sd">        **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</span>
+</span><span id="__span-0-857"><a id="__codelineno-0-857" name="__codelineno-0-857"></a>
+</span><span id="__span-0-858"><a id="__codelineno-0-858" name="__codelineno-0-858"></a><span class="sd">    Returns:</span>
+</span><span id="__span-0-859"><a id="__codelineno-0-859" name="__codelineno-0-859"></a><span class="sd">        The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.</span>
+</span><span id="__span-0-860"><a id="__codelineno-0-860" name="__codelineno-0-860"></a>
+</span><span id="__span-0-861"><a id="__codelineno-0-861" name="__codelineno-0-861"></a><span class="sd">    Raises:</span>
+</span><span id="__span-0-862"><a id="__codelineno-0-862" name="__codelineno-0-862"></a><span class="sd">        ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</span>
+</span><span id="__span-0-863"><a id="__codelineno-0-863" name="__codelineno-0-863"></a><span class="sd">        NotImplementedError: If the database dialect is not supported for upsert multi.</span>
+</span><span id="__span-0-864"><a id="__codelineno-0-864" name="__codelineno-0-864"></a><span class="sd">    &quot;&quot;&quot;</span>
+</span><span id="__span-0-865"><a id="__codelineno-0-865" name="__codelineno-0-865"></a>    <span class="k">if</span> <span class="n">update_override</span> <span class="ow">is</span> <span class="kc">None</span><span class="p">:</span>
+</span><span id="__span-0-866"><a id="__codelineno-0-866" name="__codelineno-0-866"></a>        <span class="n">update_override</span> <span class="o">=</span> <span class="p">{}</span>
+</span><span id="__span-0-867"><a id="__codelineno-0-867" name="__codelineno-0-867"></a>    <span class="n">filters</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_parse_filters</span><span class="p">(</span><span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+</span><span id="__span-0-868"><a id="__codelineno-0-868" name="__codelineno-0-868"></a>
+</span><span id="__span-0-869"><a id="__codelineno-0-869" name="__codelineno-0-869"></a>    <span class="k">if</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;postgresql&quot;</span><span class="p">:</span>
+</span><span id="__span-0-870"><a id="__codelineno-0-870" name="__codelineno-0-870"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_postgresql</span><span class="p">(</span>
+</span><span id="__span-0-871"><a id="__codelineno-0-871" name="__codelineno-0-871"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-872"><a id="__codelineno-0-872" name="__codelineno-0-872"></a>        <span class="p">)</span>
+</span><span id="__span-0-873"><a id="__codelineno-0-873" name="__codelineno-0-873"></a>    <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="o">==</span> <span class="s2">&quot;sqlite&quot;</span><span class="p">:</span>
+</span><span id="__span-0-874"><a id="__codelineno-0-874" name="__codelineno-0-874"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_sqlite</span><span class="p">(</span>
+</span><span id="__span-0-875"><a id="__codelineno-0-875" name="__codelineno-0-875"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">filters</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-876"><a id="__codelineno-0-876" name="__codelineno-0-876"></a>        <span class="p">)</span>
+</span><span id="__span-0-877"><a id="__codelineno-0-877" name="__codelineno-0-877"></a>    <span class="k">elif</span> <span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span> <span class="ow">in</span> <span class="p">[</span><span class="s2">&quot;mysql&quot;</span><span class="p">,</span> <span class="s2">&quot;mariadb&quot;</span><span class="p">]:</span>
+</span><span id="__span-0-878"><a id="__codelineno-0-878" name="__codelineno-0-878"></a>        <span class="k">if</span> <span class="n">filters</span><span class="p">:</span>
+</span><span id="__span-0-879"><a id="__codelineno-0-879" name="__codelineno-0-879"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-880"><a id="__codelineno-0-880" name="__codelineno-0-880"></a>                <span class="s2">&quot;MySQL does not support filtering on insert operations.&quot;</span>
+</span><span id="__span-0-881"><a id="__codelineno-0-881" name="__codelineno-0-881"></a>            <span class="p">)</span>
+</span><span id="__span-0-882"><a id="__codelineno-0-882" name="__codelineno-0-882"></a>        <span class="k">if</span> <span class="n">return_columns</span> <span class="ow">or</span> <span class="n">schema_to_select</span> <span class="ow">or</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-883"><a id="__codelineno-0-883" name="__codelineno-0-883"></a>            <span class="k">raise</span> <span class="ne">ValueError</span><span class="p">(</span>
+</span><span id="__span-0-884"><a id="__codelineno-0-884" name="__codelineno-0-884"></a>                <span class="s2">&quot;MySQL does not support the returning clause for insert operations.&quot;</span>
+</span><span id="__span-0-885"><a id="__codelineno-0-885" name="__codelineno-0-885"></a>            <span class="p">)</span>
+</span><span id="__span-0-886"><a id="__codelineno-0-886" name="__codelineno-0-886"></a>        <span class="n">statement</span><span class="p">,</span> <span class="n">params</span> <span class="o">=</span> <span class="k">await</span> <span class="bp">self</span><span class="o">.</span><span class="n">_upsert_multi_mysql</span><span class="p">(</span>
+</span><span id="__span-0-887"><a id="__codelineno-0-887" name="__codelineno-0-887"></a>            <span class="n">instances</span><span class="p">,</span> <span class="n">update_override</span>
+</span><span id="__span-0-888"><a id="__codelineno-0-888" name="__codelineno-0-888"></a>        <span class="p">)</span>
+</span><span id="__span-0-889"><a id="__codelineno-0-889" name="__codelineno-0-889"></a>    <span class="k">else</span><span class="p">:</span>  <span class="c1"># pragma: no cover</span>
+</span><span id="__span-0-890"><a id="__codelineno-0-890" name="__codelineno-0-890"></a>        <span class="k">raise</span> <span class="ne">NotImplementedError</span><span class="p">(</span>
+</span><span id="__span-0-891"><a id="__codelineno-0-891" name="__codelineno-0-891"></a>            <span class="sa">f</span><span class="s2">&quot;Upsert multi is not implemented for </span><span class="si">{</span><span class="n">db</span><span class="o">.</span><span class="n">bind</span><span class="o">.</span><span class="n">dialect</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">&quot;</span>
+</span><span id="__span-0-892"><a id="__codelineno-0-892" name="__codelineno-0-892"></a>        <span class="p">)</span>
+</span><span id="__span-0-893"><a id="__codelineno-0-893" name="__codelineno-0-893"></a>
+</span><span id="__span-0-894"><a id="__codelineno-0-894" name="__codelineno-0-894"></a>    <span class="k">if</span> <span class="n">return_as_model</span><span class="p">:</span>
+</span><span id="__span-0-895"><a id="__codelineno-0-895" name="__codelineno-0-895"></a>        <span class="n">return_columns</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model_col_names</span>
+</span><span id="__span-0-896"><a id="__codelineno-0-896" name="__codelineno-0-896"></a>
+</span><span id="__span-0-897"><a id="__codelineno-0-897" name="__codelineno-0-897"></a>    <span class="k">if</span> <span class="n">return_columns</span><span class="p">:</span>
+</span><span id="__span-0-898"><a id="__codelineno-0-898" name="__codelineno-0-898"></a>        <span class="n">statement</span> <span class="o">=</span> <span class="n">statement</span><span class="o">.</span><span class="n">returning</span><span class="p">(</span><span class="o">*</span><span class="p">[</span><span class="n">column</span><span class="p">(</span><span class="n">name</span><span class="p">)</span> <span class="k">for</span> <span class="n">name</span> <span class="ow">in</span> <span class="n">return_columns</span><span class="p">])</span>
+</span><span id="__span-0-899"><a id="__codelineno-0-899" name="__codelineno-0-899"></a>        <span class="n">db_row</span> <span class="o">=</span> <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
+</span><span id="__span-0-900"><a id="__codelineno-0-900" name="__codelineno-0-900"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-901"><a id="__codelineno-0-901" name="__codelineno-0-901"></a>            <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-902"><a id="__codelineno-0-902" name="__codelineno-0-902"></a>        <span class="k">return</span> <span class="bp">self</span><span class="o">.</span><span class="n">_as_multi_response</span><span class="p">(</span>
+</span><span id="__span-0-903"><a id="__codelineno-0-903" name="__codelineno-0-903"></a>            <span class="n">db_row</span><span class="p">,</span>
+</span><span id="__span-0-904"><a id="__codelineno-0-904" name="__codelineno-0-904"></a>            <span class="n">schema_to_select</span><span class="o">=</span><span class="n">schema_to_select</span><span class="p">,</span>
+</span><span id="__span-0-905"><a id="__codelineno-0-905" name="__codelineno-0-905"></a>            <span class="n">return_as_model</span><span class="o">=</span><span class="n">return_as_model</span><span class="p">,</span>
+</span><span id="__span-0-906"><a id="__codelineno-0-906" name="__codelineno-0-906"></a>        <span class="p">)</span>
+</span><span id="__span-0-907"><a id="__codelineno-0-907" name="__codelineno-0-907"></a>
+</span><span id="__span-0-908"><a id="__codelineno-0-908" name="__codelineno-0-908"></a>    <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">statement</span><span class="p">,</span> <span class="n">params</span><span class="p">)</span>
+</span><span id="__span-0-909"><a id="__codelineno-0-909" name="__codelineno-0-909"></a>    <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+</span><span id="__span-0-910"><a id="__codelineno-0-910" name="__codelineno-0-910"></a>        <span class="k">await</span> <span class="n">db</span><span class="o">.</span><span class="n">commit</span><span class="p">()</span>
+</span><span id="__span-0-911"><a id="__codelineno-0-911" name="__codelineno-0-911"></a>    <span class="k">return</span> <span class="kc">None</span>
 </span></code></pre></div></td></tr></table></div>
           </details>
   </div>
diff --git a/api/overview/index.html b/api/overview/index.html
index 19ada2c..809d456 100644
--- a/api/overview/index.html
+++ b/api/overview/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1014,6 +1031,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1024,6 +1061,8 @@
       
         
       
+        
+      
         
       
     
@@ -1038,10 +1077,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1052,8 +1091,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1107,6 +1146,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/api/paginated/index.html b/api/paginated/index.html
index 2797f79..7207854 100644
--- a/api/paginated/index.html
+++ b/api/paginated/index.html
@@ -18,7 +18,7 @@
         <link rel="prev" href="../crud_router/">
       
       
-        <link rel="next" href="../../community/overview/">
+        <link rel="next" href="../../showcase/">
       
       
       <link rel="icon" href="../../assets/logo.png">
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1014,6 +1031,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1024,6 +1061,8 @@
       
         
       
+        
+      
         
       
     
@@ -1038,10 +1077,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1052,8 +1091,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1107,6 +1146,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/changelog/index.html b/changelog/index.html
index 64b5a0c..390aecf 100644
--- a/changelog/index.html
+++ b/changelog/index.html
@@ -347,6 +347,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -934,6 +951,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -944,6 +981,8 @@
       
         
       
+        
+      
         
       
     
@@ -958,10 +997,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -972,8 +1011,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1027,6 +1066,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/community/CODE_OF_CONDUCT/index.html b/community/CODE_OF_CONDUCT/index.html
index 5f35e64..2b23999 100644
--- a/community/CODE_OF_CONDUCT/index.html
+++ b/community/CODE_OF_CONDUCT/index.html
@@ -15,7 +15,7 @@
         <link rel="canonical" href="https://github.com/igorbenav/fastcrud/community/CODE_OF_CONDUCT/">
       
       
-        <link rel="prev" href="../CONTRIBUTING/">
+        <link rel="prev" href="../showcase_submission/">
       
       
         <link rel="next" href="../LICENSE/">
@@ -348,6 +348,23 @@
         
   
   
+  
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
     
   
   
@@ -935,6 +952,26 @@
       
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
     
   
   
@@ -947,6 +984,8 @@
         
       
         
+      
+        
       
         
       
@@ -962,10 +1001,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -976,8 +1015,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1029,6 +1068,27 @@
                 
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
     
   
   
diff --git a/community/CONTRIBUTING/index.html b/community/CONTRIBUTING/index.html
index 858826c..594728a 100644
--- a/community/CONTRIBUTING/index.html
+++ b/community/CONTRIBUTING/index.html
@@ -18,7 +18,7 @@
         <link rel="prev" href="../overview/">
       
       
-        <link rel="next" href="../CODE_OF_CONDUCT/">
+        <link rel="next" href="../showcase_submission/">
       
       
       <link rel="icon" href="../../assets/logo.png">
@@ -348,6 +348,23 @@
         
   
   
+  
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
     
   
   
@@ -935,6 +952,26 @@
       
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
     
   
   
@@ -947,6 +984,8 @@
         
       
         
+      
+        
       
         
       
@@ -962,10 +1001,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -976,8 +1015,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1197,6 +1236,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/community/LICENSE/index.html b/community/LICENSE/index.html
index 984874d..96c4d80 100644
--- a/community/LICENSE/index.html
+++ b/community/LICENSE/index.html
@@ -343,6 +343,23 @@
         
   
   
+  
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
     
   
   
@@ -930,6 +947,26 @@
       
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
     
   
   
@@ -942,6 +979,8 @@
         
       
         
+      
+        
       
         
       
@@ -957,10 +996,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -971,8 +1010,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1026,6 +1065,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/community/overview/index.html b/community/overview/index.html
index 00107dc..49c7c95 100644
--- a/community/overview/index.html
+++ b/community/overview/index.html
@@ -15,7 +15,7 @@
         <link rel="canonical" href="https://github.com/igorbenav/fastcrud/community/overview/">
       
       
-        <link rel="prev" href="../../api/paginated/">
+        <link rel="prev" href="../../showcase/">
       
       
         <link rel="next" href="../CONTRIBUTING/">
@@ -348,6 +348,23 @@
         
   
   
+  
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
     
   
   
@@ -935,6 +952,26 @@
       
   
   
+  
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
     
   
   
@@ -947,6 +984,8 @@
         
       
         
+      
+        
       
         
       
@@ -962,10 +1001,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" checked>
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -976,8 +1015,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="true">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1107,6 +1146,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/community/showcase_submission/index.html b/community/showcase_submission/index.html
new file mode 100644
index 0000000..78f5d34
--- /dev/null
+++ b/community/showcase_submission/index.html
@@ -0,0 +1,1420 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Powerful CRUD methods and automatic endpoint creation for FastAPI.">
+      
+      
+        <meta name="author" content="Igor Magalhaes">
+      
+      
+        <link rel="canonical" href="https://github.com/igorbenav/fastcrud/community/showcase_submission/">
+      
+      
+        <link rel="prev" href="../CONTRIBUTING/">
+      
+      
+        <link rel="next" href="../CODE_OF_CONDUCT/">
+      
+      
+      <link rel="icon" href="../../assets/logo.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.5">
+    
+    
+      
+        <title>Showcase Submission - FastCRUD</title>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/stylesheets/main.50c56a3b.min.css">
+      
+        
+        <link rel="stylesheet" href="../../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Ubuntu:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Ubuntu";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../../assets/_mkdocstrings.css">
+    
+    <script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#submit-your-project" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+<header class="md-header" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href="../.." title="FastCRUD" class="md-header__button md-logo" aria-label="FastCRUD" data-md-component="logo">
+      
+  <img src="../../assets/logo.png" alt="logo">
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            FastCRUD
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Showcase Submission
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/igorbenav/fastcrud" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    igorbenav/fastcrud
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+            
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
+  <div class="md-grid">
+    <ul class="md-tabs__list">
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../.." class="md-tabs__link">
+        
+  
+    
+  
+  FastCRUD
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../../installing/" class="md-tabs__link">
+        
+  
+    
+  
+  Installing
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../../quick-start/" class="md-tabs__link">
+        
+  
+    
+  
+  Quick-Start
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../../sqlmodel/" class="md-tabs__link">
+        
+  
+    
+  
+  Using SQLModel
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../../usage/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Usage
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../../advanced/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Advanced
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../../api/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  API Reference
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+    
+  
+  
+    
+    
+      <li class="md-tabs__item md-tabs__item--active">
+        <a href="../overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Community
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../../changelog/" class="md-tabs__link">
+        
+  
+    
+  
+  Changelog
+
+      </a>
+    </li>
+  
+
+      
+    </ul>
+  </div>
+</nav>
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+  
+
+
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href="../.." title="FastCRUD" class="md-nav__button md-logo" aria-label="FastCRUD" data-md-component="logo">
+      
+  <img src="../../assets/logo.png" alt="logo">
+
+    </a>
+    FastCRUD
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/igorbenav/fastcrud" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    igorbenav/fastcrud
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../.." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastCRUD
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../installing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Installing
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../quick-start/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Quick-Start
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../sqlmodel/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Using SQLModel
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            Usage
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/endpoint/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Automatic Endpoints
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../usage/crud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    CRUD Utilities
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Advanced
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            Advanced
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../advanced/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../advanced/endpoint/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Custom Endpoints
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../advanced/crud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Advanced CRUD Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../advanced/joins/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Joining Models
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
+        
+          
+          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    API Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_7">
+            <span class="md-nav__icon md-icon"></span>
+            API Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../api/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../api/fastcrud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastCRUD
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../api/endpoint_creator/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    EndpointCreator
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../api/crud_router/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    crud_router
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../api/paginated/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    paginated
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" checked>
+        
+          
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Community
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="true">
+          <label class="md-nav__title" for="__nav_9">
+            <span class="md-nav__icon md-icon"></span>
+            Community
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../CONTRIBUTING/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Contributing
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#project-categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      Project Categories
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#how-to-submit" class="md-nav__link">
+    <span class="md-ellipsis">
+      How to Submit
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#requirements-by-category" class="md-nav__link">
+    <span class="md-ellipsis">
+      Requirements by Category
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#need-help" class="md-nav__link">
+    <span class="md-ellipsis">
+      Need Help?
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../CODE_OF_CONDUCT/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Code of Conduct
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../LICENSE/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    License
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../../changelog/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Changelog
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#project-categories" class="md-nav__link">
+    <span class="md-ellipsis">
+      Project Categories
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#how-to-submit" class="md-nav__link">
+    <span class="md-ellipsis">
+      How to Submit
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#requirements-by-category" class="md-nav__link">
+    <span class="md-ellipsis">
+      Requirements by Category
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#need-help" class="md-nav__link">
+    <span class="md-ellipsis">
+      Need Help?
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+<h1 id="submit-your-project">Submit Your Project<a class="headerlink" href="#submit-your-project" title="Permanent link">&para;</a></h1>
+<div class="admonition tip">
+<p class="admonition-title">Share Your Work</p>
+<p>Have you built something with FastCRUD? We'd love to feature it in our showcase!</p>
+</div>
+<h2 id="project-categories">Project Categories<a class="headerlink" href="#project-categories" title="Permanent link">&para;</a></h2>
+<div class="admonition example">
+<p class="admonition-title">What You Can Submit</p>
+<ul>
+<li><strong>Tutorials</strong>: Step-by-step guides teaching others how to build with FastCRUD</li>
+<li><strong>Open Source Projects</strong>: Libraries, tools, or applications others can use and learn from</li>
+<li><strong>Applications</strong>: Web apps, desktop tools, or services built with FastCRUD</li>
+<li><strong>Commercial Services</strong>: Products or services powered by FastCRUD</li>
+</ul>
+</div>
+<h2 id="how-to-submit">How to Submit<a class="headerlink" href="#how-to-submit" title="Permanent link">&para;</a></h2>
+<div class="admonition info">
+<p class="admonition-title">Submission Steps</p>
+<ol>
+<li>Create a new issue using our <a href="https://github.com/igorbenav/fastcrud/issues/new?assignees=&amp;labels=showcase&amp;projects=&amp;template=showcase-submission.md&amp;title=Showcase%3A+">Showcase Submission Template</a></li>
+<li>Fill in the relevant information for your project type</li>
+<li>We'll review your submission and add it to the showcase!</li>
+</ol>
+</div>
+<h2 id="requirements-by-category">Requirements by Category<a class="headerlink" href="#requirements-by-category" title="Permanent link">&para;</a></h2>
+<div class="admonition success">
+<p class="admonition-title">What We Look For</p>
+<p><strong>For Tutorials:</strong></p>
+<ul>
+<li>Clear step-by-step instructions</li>
+<li>Working code examples</li>
+<li>Explanation of concepts used</li>
+</ul>
+<p><strong>For Open Source Projects:</strong></p>
+<ul>
+<li>Public repository</li>
+<li>Basic documentation</li>
+<li>Installation/usage instructions</li>
+</ul>
+<p><strong>For Applications/Services:</strong></p>
+<ul>
+<li>Public demo or screenshots</li>
+<li>Description of FastCRUD features used</li>
+<li>Link to live service (if applicable)</li>
+</ul>
+</div>
+<h2 id="need-help">Need Help?<a class="headerlink" href="#need-help" title="Permanent link">&para;</a></h2>
+<div class="admonition question">
+<p class="admonition-title">Questions?</p>
+<p>Need help with your submission? We're here to help!</p>
+<ul>
+<li>Open a discussion on <a href="https://github.com/igorbenav/fastcrud/discussions">GitHub</a></li>
+</ul>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.instant", "navigation.instant.prefetch", "navigation.tabs", "navigation.indexes", "search.suggest", "content.code.copy"], "search": "../../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../../assets/javascripts/bundle.c18c5fb9.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/index.html b/index.html
index b4f7b82..739c5af 100644
--- a/index.html
+++ b/index.html
@@ -349,6 +349,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1072,6 +1089,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1082,6 +1119,8 @@
       
         
       
+        
+      
         
       
     
@@ -1096,10 +1135,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1110,8 +1149,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1165,6 +1204,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/installing/index.html b/installing/index.html
index cb2719f..c1605e4 100644
--- a/installing/index.html
+++ b/installing/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -990,6 +1007,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1000,6 +1037,8 @@
       
         
       
+        
+      
         
       
     
@@ -1014,10 +1053,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1028,8 +1067,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1083,6 +1122,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/quick-start/index.html b/quick-start/index.html
index 59dbd5d..74ac821 100644
--- a/quick-start/index.html
+++ b/quick-start/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1005,6 +1022,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1015,6 +1052,8 @@
       
         
       
+        
+      
         
       
     
@@ -1029,10 +1068,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1043,8 +1082,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1098,6 +1137,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
@@ -1243,135 +1303,144 @@ <h2 id="minimal-example">Minimal Example<a class="headerlink" href="#minimal-exa
 <p>Assuming you have your SQLAlchemy model, Pydantic schemas and database connection, just skip to <a href="#using-fastcrud">Using FastCRUD</a></p>
 <h3 id="basic-setup">Basic Setup<a class="headerlink" href="#basic-setup" title="Permanent link">&para;</a></h3>
 <p>Define your SQLAlchemy model</p>
-<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">String</span>
-</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
-</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span>
-</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
-</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a>
+<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="kn">import</span> <span class="nn">datetime</span>
+</span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">DateTime</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">Numeric</span><span class="p">,</span> <span class="n">String</span><span class="p">,</span> <span class="n">func</span>
+</span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
+</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4" href="#__codelineno-0-4"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="n">create_async_engine</span>
+</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5" href="#__codelineno-0-5"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
 </span><span id="__span-0-6"><a id="__codelineno-0-6" name="__codelineno-0-6" href="#__codelineno-0-6"></a>
-</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
-</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a>    <span class="k">pass</span>
-</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>
+</span><span id="__span-0-7"><a id="__codelineno-0-7" name="__codelineno-0-7" href="#__codelineno-0-7"></a>
+</span><span id="__span-0-8"><a id="__codelineno-0-8" name="__codelineno-0-8" href="#__codelineno-0-8"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
+</span><span id="__span-0-9"><a id="__codelineno-0-9" name="__codelineno-0-9" href="#__codelineno-0-9"></a>    <span class="k">pass</span>
 </span><span id="__span-0-10"><a id="__codelineno-0-10" name="__codelineno-0-10" href="#__codelineno-0-10"></a>
-</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a><span class="hll"><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
-</span></span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="hll">    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
-</span></span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="hll">    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span></span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="hll">    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span></span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="hll">    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span></span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="hll">    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span></span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="hll">    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
-</span></span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="hll">    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
-</span></span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="hll">    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
-</span></span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a>
-</span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>
-</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
-</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a>    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a>    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>
+</span><span id="__span-0-11"><a id="__codelineno-0-11" name="__codelineno-0-11" href="#__codelineno-0-11"></a>
+</span><span id="__span-0-12"><a id="__codelineno-0-12" name="__codelineno-0-12" href="#__codelineno-0-12"></a><span class="hll"><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
+</span></span><span id="__span-0-13"><a id="__codelineno-0-13" name="__codelineno-0-13" href="#__codelineno-0-13"></a><span class="hll">    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
+</span></span><span id="__span-0-14"><a id="__codelineno-0-14" name="__codelineno-0-14" href="#__codelineno-0-14"></a><span class="hll">    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span></span><span id="__span-0-15"><a id="__codelineno-0-15" name="__codelineno-0-15" href="#__codelineno-0-15"></a><span class="hll">    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span></span><span id="__span-0-16"><a id="__codelineno-0-16" name="__codelineno-0-16" href="#__codelineno-0-16"></a><span class="hll">    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span></span><span id="__span-0-17"><a id="__codelineno-0-17" name="__codelineno-0-17" href="#__codelineno-0-17"></a><span class="hll">    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span></span><span id="__span-0-18"><a id="__codelineno-0-18" name="__codelineno-0-18" href="#__codelineno-0-18"></a><span class="hll">    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
+</span></span><span id="__span-0-19"><a id="__codelineno-0-19" name="__codelineno-0-19" href="#__codelineno-0-19"></a><span class="hll">    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
+</span></span><span id="__span-0-20"><a id="__codelineno-0-20" name="__codelineno-0-20" href="#__codelineno-0-20"></a><span class="hll">    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
+</span></span><span id="__span-0-21"><a id="__codelineno-0-21" name="__codelineno-0-21" href="#__codelineno-0-21"></a>
+</span><span id="__span-0-22"><a id="__codelineno-0-22" name="__codelineno-0-22" href="#__codelineno-0-22"></a>
+</span><span id="__span-0-23"><a id="__codelineno-0-23" name="__codelineno-0-23" href="#__codelineno-0-23"></a><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
+</span><span id="__span-0-24"><a id="__codelineno-0-24" name="__codelineno-0-24" href="#__codelineno-0-24"></a>    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-25"><a id="__codelineno-0-25" name="__codelineno-0-25" href="#__codelineno-0-25"></a>    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-26"><a id="__codelineno-0-26" name="__codelineno-0-26" href="#__codelineno-0-26"></a>    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-27"><a id="__codelineno-0-27" name="__codelineno-0-27" href="#__codelineno-0-27"></a>    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-0-28"><a id="__codelineno-0-28" name="__codelineno-0-28" href="#__codelineno-0-28"></a>    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
 </span><span id="__span-0-29"><a id="__codelineno-0-29" name="__codelineno-0-29" href="#__codelineno-0-29"></a>
-</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
-</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</span><span id="__span-0-30"><a id="__codelineno-0-30" name="__codelineno-0-30" href="#__codelineno-0-30"></a>
+</span><span id="__span-0-31"><a id="__codelineno-0-31" name="__codelineno-0-31" href="#__codelineno-0-31"></a><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
+</span><span id="__span-0-32"><a id="__codelineno-0-32" name="__codelineno-0-32" href="#__codelineno-0-32"></a><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-0-33"><a id="__codelineno-0-33" name="__codelineno-0-33" href="#__codelineno-0-33"></a><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 </span></code></pre></div>
 <p>Then your Pydantic schemas</p>
-<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">String</span>
-</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
-</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span>
-</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
-</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a>
+<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-1-1"><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="kn">import</span> <span class="nn">datetime</span>
+</span><span id="__span-1-2"><a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">DateTime</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">Numeric</span><span class="p">,</span> <span class="n">String</span><span class="p">,</span> <span class="n">func</span>
+</span><span id="__span-1-3"><a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
+</span><span id="__span-1-4"><a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="n">create_async_engine</span>
+</span><span id="__span-1-5"><a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
 </span><span id="__span-1-6"><a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a>
-</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
-</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a>    <span class="k">pass</span>
-</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>
+</span><span id="__span-1-7"><a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>
+</span><span id="__span-1-8"><a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
+</span><span id="__span-1-9"><a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a>    <span class="k">pass</span>
 </span><span id="__span-1-10"><a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a>
-</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
-</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a>    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
-</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
-</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a>    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
-</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
-</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a>
+</span><span id="__span-1-11"><a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a>
+</span><span id="__span-1-12"><a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
+</span><span id="__span-1-13"><a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
+</span><span id="__span-1-14"><a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a>    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-1-15"><a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a>    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-1-16"><a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a>    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-1-17"><a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a>    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-1-18"><a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a>    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
+</span><span id="__span-1-19"><a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
+</span><span id="__span-1-20"><a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a>    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
 </span><span id="__span-1-21"><a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a>
-</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a><span class="hll"><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
-</span></span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="hll">    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span></span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="hll">    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span></span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="hll">    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span></span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="hll">    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span></span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="hll">    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span></span><span id="__span-1-28"><a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a>
-</span><span id="__span-1-29"><a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a>
-</span><span id="__span-1-30"><a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
-</span><span id="__span-1-31"><a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-1-32"><a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</span><span id="__span-1-22"><a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a>
+</span><span id="__span-1-23"><a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a><span class="hll"><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
+</span></span><span id="__span-1-24"><a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></a><span class="hll">    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span></span><span id="__span-1-25"><a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a><span class="hll">    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span></span><span id="__span-1-26"><a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a><span class="hll">    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span></span><span id="__span-1-27"><a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a><span class="hll">    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span></span><span id="__span-1-28"><a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a><span class="hll">    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span></span><span id="__span-1-29"><a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a>
+</span><span id="__span-1-30"><a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a>
+</span><span id="__span-1-31"><a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
+</span><span id="__span-1-32"><a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></a><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-1-33"><a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 </span></code></pre></div>
 <p>And, finally, your database connection</p>
-<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">String</span>
-</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
-</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span>
-</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
-</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a>
+<div class="language-python highlight"><span class="filename">setup.py</span><pre><span></span><code><span id="__span-2-1"><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="kn">import</span> <span class="nn">datetime</span>
+</span><span id="__span-2-2"><a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="kn">from</span> <span class="nn">sqlalchemy</span> <span class="kn">import</span> <span class="n">Column</span><span class="p">,</span> <span class="n">DateTime</span><span class="p">,</span> <span class="n">Integer</span><span class="p">,</span> <span class="n">Numeric</span><span class="p">,</span> <span class="n">String</span><span class="p">,</span> <span class="n">func</span>
+</span><span id="__span-2-3"><a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="kn">from</span> <span class="nn">sqlalchemy.orm</span> <span class="kn">import</span> <span class="n">DeclarativeBase</span><span class="p">,</span> <span class="n">sessionmaker</span>
+</span><span id="__span-2-4"><a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span><span class="p">,</span> <span class="n">create_async_engine</span>
+</span><span id="__span-2-5"><a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></a><span class="kn">from</span> <span class="nn">pydantic</span> <span class="kn">import</span> <span class="n">BaseModel</span>
 </span><span id="__span-2-6"><a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>
-</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
-</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a>    <span class="k">pass</span>
-</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>
+</span><span id="__span-2-7"><a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a>
+</span><span id="__span-2-8"><a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></a><span class="k">class</span> <span class="nc">Base</span><span class="p">(</span><span class="n">DeclarativeBase</span><span class="p">):</span>
+</span><span id="__span-2-9"><a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a>    <span class="k">pass</span>
 </span><span id="__span-2-10"><a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a>
-</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
-</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
-</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a>    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a>    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a>    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
-</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a>    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
-</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a>    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
-</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a>    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
-</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a>
+</span><span id="__span-2-11"><a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a>
+</span><span id="__span-2-12"><a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a><span class="k">class</span> <span class="nc">Item</span><span class="p">(</span><span class="n">Base</span><span class="p">):</span>
+</span><span id="__span-2-13"><a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a>    <span class="n">__tablename__</span> <span class="o">=</span> <span class="s2">&quot;items&quot;</span>
+</span><span id="__span-2-14"><a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a>    <span class="nb">id</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Integer</span><span class="p">,</span> <span class="n">primary_key</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span><span id="__span-2-15"><a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a>    <span class="n">name</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-2-16"><a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a>    <span class="n">description</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-2-17"><a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a>    <span class="n">category</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">String</span><span class="p">)</span>
+</span><span id="__span-2-18"><a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a>    <span class="n">price</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">Numeric</span><span class="p">)</span>
+</span><span id="__span-2-19"><a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a>    <span class="n">last_sold</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">)</span>
+</span><span id="__span-2-20"><a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a>    <span class="n">created_at</span> <span class="o">=</span> <span class="n">Column</span><span class="p">(</span><span class="n">DateTime</span><span class="p">,</span> <span class="n">default</span><span class="o">=</span><span class="n">func</span><span class="o">.</span><span class="n">now</span><span class="p">())</span>
 </span><span id="__span-2-21"><a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a>
-</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
-</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a>    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a>    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a>    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a>    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-2-27"><a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a>    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
-</span><span id="__span-2-28"><a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a>
+</span><span id="__span-2-22"><a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a>
+</span><span id="__span-2-23"><a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a><span class="k">class</span> <span class="nc">ItemSchema</span><span class="p">(</span><span class="n">BaseModel</span><span class="p">):</span>
+</span><span id="__span-2-24"><a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a>    <span class="n">name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-2-25"><a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a>    <span class="n">description</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-2-26"><a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a>    <span class="n">category</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-2-27"><a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a>    <span class="n">price</span><span class="p">:</span> <span class="nb">float</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
+</span><span id="__span-2-28"><a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a>    <span class="n">last_sold</span><span class="p">:</span> <span class="n">datetime</span><span class="o">.</span><span class="n">datetime</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span>
 </span><span id="__span-2-29"><a id="__codelineno-2-29" name="__codelineno-2-29" href="#__codelineno-2-29"></a>
-</span><span id="__span-2-30"><a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a><span class="hll"><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
-</span></span><span id="__span-2-31"><a id="__codelineno-2-31" name="__codelineno-2-31" href="#__codelineno-2-31"></a><span class="hll"><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-</span></span><span id="__span-2-32"><a id="__codelineno-2-32" name="__codelineno-2-32" href="#__codelineno-2-32"></a><span class="hll"><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+</span><span id="__span-2-30"><a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a>
+</span><span id="__span-2-31"><a id="__codelineno-2-31" name="__codelineno-2-31" href="#__codelineno-2-31"></a><span class="hll"><span class="n">DATABASE_URL</span> <span class="o">=</span> <span class="s2">&quot;sqlite+aiosqlite:///./test.db&quot;</span>
+</span></span><span id="__span-2-32"><a id="__codelineno-2-32" name="__codelineno-2-32" href="#__codelineno-2-32"></a><span class="hll"><span class="n">engine</span> <span class="o">=</span> <span class="n">create_async_engine</span><span class="p">(</span><span class="n">DATABASE_URL</span><span class="p">,</span> <span class="n">echo</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+</span></span><span id="__span-2-33"><a id="__codelineno-2-33" name="__codelineno-2-33" href="#__codelineno-2-33"></a><span class="hll"><span class="n">async_session</span> <span class="o">=</span> <span class="n">sessionmaker</span><span class="p">(</span><span class="n">engine</span><span class="p">,</span> <span class="n">class_</span><span class="o">=</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="n">expire_on_commit</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
 </span></span></code></pre></div>
 <h3 id="using-fastcrud">Using FastCRUD<a class="headerlink" href="#using-fastcrud" title="Permanent link">&para;</a></h3>
 <p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p>
-<div class="language-python highlight"><span class="filename">main.py</span><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="kn">from</span> <span class="nn">fastcrud</span> <span class="kn">import</span> <span class="n">crud_router</span>
+<div class="language-python highlight"><span class="filename">main.py</span><pre><span></span><code><span id="__span-3-1"><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="kn">from</span> <span class="nn">typing</span> <span class="kn">import</span> <span class="n">AsyncGenerator</span>
 </span><span id="__span-3-2"><a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>
-</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="c1"># Database session dependency</span>
-</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_session</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">AsyncGenerator</span><span class="p">[</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="kc">None</span><span class="p">]:</span>
-</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>    <span class="k">async</span> <span class="k">with</span> <span class="n">async_session</span><span class="p">()</span> <span class="k">as</span> <span class="n">session</span><span class="p">:</span>
-</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a>        <span class="k">yield</span> <span class="n">session</span>
-</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a>
-</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="c1"># Create tables before the app start</span>
-</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">lifespan</span><span class="p">(</span><span class="n">app</span><span class="p">:</span> <span class="n">FastAPI</span><span class="p">):</span>
-</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a>    <span class="k">async</span> <span class="k">with</span> <span class="n">engine</span><span class="o">.</span><span class="n">begin</span><span class="p">()</span> <span class="k">as</span> <span class="n">conn</span><span class="p">:</span>
-</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a>        <span class="k">await</span> <span class="n">conn</span><span class="o">.</span><span class="n">run_sync</span><span class="p">(</span><span class="n">Base</span><span class="o">.</span><span class="n">metadata</span><span class="o">.</span><span class="n">create_all</span><span class="p">)</span>
-</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>    <span class="k">yield</span>
+</span><span id="__span-3-3"><a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="kn">from</span> <span class="nn">fastapi</span> <span class="kn">import</span> <span class="n">FastAPI</span>
+</span><span id="__span-3-4"><a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="kn">from</span> <span class="nn">sqlalchemy.ext.asyncio</span> <span class="kn">import</span> <span class="n">AsyncSession</span>
+</span><span id="__span-3-5"><a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a>
+</span><span id="__span-3-6"><a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="kn">from</span> <span class="nn">fastcrud</span> <span class="kn">import</span> <span class="n">crud_router</span>
+</span><span id="__span-3-7"><a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="kn">import</span> <span class="nn">setup</span>
+</span><span id="__span-3-8"><a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a>
+</span><span id="__span-3-9"><a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="c1"># Database session dependency</span>
+</span><span id="__span-3-10"><a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">get_session</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">AsyncGenerator</span><span class="p">[</span><span class="n">AsyncSession</span><span class="p">,</span> <span class="kc">None</span><span class="p">]:</span>
+</span><span id="__span-3-11"><a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a>    <span class="k">async</span> <span class="k">with</span> <span class="n">setup</span><span class="o">.</span><span class="n">async_session</span><span class="p">()</span> <span class="k">as</span> <span class="n">session</span><span class="p">:</span>
+</span><span id="__span-3-12"><a id="__codelineno-3-12" name="__codelineno-3-12" href="#__codelineno-3-12"></a>        <span class="k">yield</span> <span class="n">session</span>
 </span><span id="__span-3-13"><a id="__codelineno-3-13" name="__codelineno-3-13" href="#__codelineno-3-13"></a>
-</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="c1"># FastAPI app</span>
-</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">(</span><span class="n">lifespan</span><span class="o">=</span><span class="n">lifespan</span><span class="p">)</span>
-</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a>
-</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a><span class="hll"><span class="n">item_router</span> <span class="o">=</span> <span class="n">crud_router</span><span class="p">(</span>
-</span></span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a><span class="hll">    <span class="n">session</span><span class="o">=</span><span class="n">session</span><span class="p">,</span>
-</span></span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a><span class="hll">    <span class="n">model</span><span class="o">=</span><span class="n">Item</span><span class="p">,</span>
-</span></span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="hll">    <span class="n">create_schema</span><span class="o">=</span><span class="n">ItemSchema</span><span class="p">,</span>
-</span></span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="hll">    <span class="n">update_schema</span><span class="o">=</span><span class="n">ItemSchema</span><span class="p">,</span>
-</span></span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a><span class="hll">    <span class="n">path</span><span class="o">=</span><span class="s2">&quot;/items&quot;</span><span class="p">,</span>
-</span></span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="hll">    <span class="n">tags</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;Items&quot;</span><span class="p">]</span>
-</span></span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="hll"><span class="p">)</span>
-</span></span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a>
-</span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="hll"><span class="n">app</span><span class="o">.</span><span class="n">include_router</span><span class="p">(</span><span class="n">item_router</span><span class="p">)</span>
+</span><span id="__span-3-14"><a id="__codelineno-3-14" name="__codelineno-3-14" href="#__codelineno-3-14"></a><span class="c1"># Create tables before the app start</span>
+</span><span id="__span-3-15"><a id="__codelineno-3-15" name="__codelineno-3-15" href="#__codelineno-3-15"></a><span class="k">async</span> <span class="k">def</span> <span class="nf">lifespan</span><span class="p">(</span><span class="n">app</span><span class="p">:</span> <span class="n">FastAPI</span><span class="p">):</span>
+</span><span id="__span-3-16"><a id="__codelineno-3-16" name="__codelineno-3-16" href="#__codelineno-3-16"></a>    <span class="k">async</span> <span class="k">with</span> <span class="n">setup</span><span class="o">.</span><span class="n">engine</span><span class="o">.</span><span class="n">begin</span><span class="p">()</span> <span class="k">as</span> <span class="n">conn</span><span class="p">:</span>
+</span><span id="__span-3-17"><a id="__codelineno-3-17" name="__codelineno-3-17" href="#__codelineno-3-17"></a>        <span class="k">await</span> <span class="n">conn</span><span class="o">.</span><span class="n">run_sync</span><span class="p">(</span><span class="n">setup</span><span class="o">.</span><span class="n">Base</span><span class="o">.</span><span class="n">metadata</span><span class="o">.</span><span class="n">create_all</span><span class="p">)</span>
+</span><span id="__span-3-18"><a id="__codelineno-3-18" name="__codelineno-3-18" href="#__codelineno-3-18"></a>    <span class="k">yield</span>
+</span><span id="__span-3-19"><a id="__codelineno-3-19" name="__codelineno-3-19" href="#__codelineno-3-19"></a>
+</span><span id="__span-3-20"><a id="__codelineno-3-20" name="__codelineno-3-20" href="#__codelineno-3-20"></a><span class="c1"># FastAPI app</span>
+</span><span id="__span-3-21"><a id="__codelineno-3-21" name="__codelineno-3-21" href="#__codelineno-3-21"></a><span class="n">app</span> <span class="o">=</span> <span class="n">FastAPI</span><span class="p">(</span><span class="n">lifespan</span><span class="o">=</span><span class="n">lifespan</span><span class="p">)</span>
+</span><span id="__span-3-22"><a id="__codelineno-3-22" name="__codelineno-3-22" href="#__codelineno-3-22"></a>
+</span><span id="__span-3-23"><a id="__codelineno-3-23" name="__codelineno-3-23" href="#__codelineno-3-23"></a><span class="hll"><span class="n">item_router</span> <span class="o">=</span> <span class="n">crud_router</span><span class="p">(</span>
+</span></span><span id="__span-3-24"><a id="__codelineno-3-24" name="__codelineno-3-24" href="#__codelineno-3-24"></a><span class="hll">    <span class="n">session</span><span class="o">=</span><span class="n">get_session</span><span class="p">,</span>
+</span></span><span id="__span-3-25"><a id="__codelineno-3-25" name="__codelineno-3-25" href="#__codelineno-3-25"></a><span class="hll">    <span class="n">model</span><span class="o">=</span><span class="n">setup</span><span class="o">.</span><span class="n">Item</span><span class="p">,</span>
+</span></span><span id="__span-3-26"><a id="__codelineno-3-26" name="__codelineno-3-26" href="#__codelineno-3-26"></a><span class="hll">    <span class="n">create_schema</span><span class="o">=</span><span class="n">setup</span><span class="o">.</span><span class="n">ItemSchema</span><span class="p">,</span>
+</span></span><span id="__span-3-27"><a id="__codelineno-3-27" name="__codelineno-3-27" href="#__codelineno-3-27"></a><span class="hll">    <span class="n">update_schema</span><span class="o">=</span><span class="n">setup</span><span class="o">.</span><span class="n">ItemSchema</span><span class="p">,</span>
+</span></span><span id="__span-3-28"><a id="__codelineno-3-28" name="__codelineno-3-28" href="#__codelineno-3-28"></a><span class="hll">    <span class="n">path</span><span class="o">=</span><span class="s2">&quot;/items&quot;</span><span class="p">,</span>
+</span></span><span id="__span-3-29"><a id="__codelineno-3-29" name="__codelineno-3-29" href="#__codelineno-3-29"></a><span class="hll">    <span class="n">tags</span><span class="o">=</span><span class="p">[</span><span class="s2">&quot;Items&quot;</span><span class="p">]</span>
+</span></span><span id="__span-3-30"><a id="__codelineno-3-30" name="__codelineno-3-30" href="#__codelineno-3-30"></a><span class="hll"><span class="p">)</span>
+</span></span><span id="__span-3-31"><a id="__codelineno-3-31" name="__codelineno-3-31" href="#__codelineno-3-31"></a>
+</span><span id="__span-3-32"><a id="__codelineno-3-32" name="__codelineno-3-32" href="#__codelineno-3-32"></a><span class="hll"><span class="n">app</span><span class="o">.</span><span class="n">include_router</span><span class="p">(</span><span class="n">item_router</span><span class="p">)</span>
 </span></span></code></pre></div>
 <p>And it's all done, just go to <code>/docs</code> and the crud endpoints are created.</p>
 
diff --git a/search/search_index.json b/search/search_index.json
index 9fe58f3..aec464a 100644
--- a/search/search_index.json
+++ b/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"FastCRUD","text":"<p> Powerful CRUD methods and automatic endpoint creation for FastAPI. </p> <p> </p> <p> FastCRUD is a Python package for FastAPI, offering robust async CRUD operations and flexible endpoint creation utilities, streamlined through advanced features like auto-detected join conditions, dynamic sorting, and offset and cursor pagination. </p>"},{"location":"#features","title":"Features","text":"<ul> <li>Fully Async: Leverages Python's async capabilities for non-blocking database operations.</li> <li>SQLAlchemy 2.0: Works with the latest SQLAlchemy version for robust database interactions.</li> <li>SQLModel Support: You can optionally use SQLModel 0.14 or newer instead of SQLAlchemy.</li> <li>Powerful CRUD Functionality: Full suite of efficient CRUD operations with support for joins.</li> <li>Dynamic Query Building: Supports building complex queries dynamically, including filtering, sorting, and pagination.</li> <li>Advanced Join Operations: Facilitates performing SQL joins with other models with automatic join condition detection.</li> <li>Built-in Offset Pagination: Comes with ready-to-use offset pagination.</li> <li>Cursor-based Pagination: Implements efficient pagination for large datasets, ideal for infinite scrolling interfaces.</li> <li>Modular and Extensible: Designed for easy extension and customization to fit your requirements.</li> <li>Auto-generated Endpoints: Streamlines the process of adding CRUD endpoints with custom dependencies and configurations.</li> </ul>"},{"location":"#minimal-example","title":"Minimal Example","text":"<p>Assuming you have your model, schemas and database connection:</p> <pre><code># imports here\n\n# define your model\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\n\n# your schemas\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\n\n# database connection\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> <pre><code>from fastcrud import crud_router\n\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=ItemSchema,\n    update_schema=ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>And it's all done, just go to <code>/docs</code> and the crud endpoints are created.</p>"},{"location":"#requirements","title":"Requirements","text":"<p>Before installing FastCRUD, ensure you have the following prerequisites:</p> <ul> <li>Python: Version 3.9 or newer.</li> <li>FastAPI: FastCRUD is built to work with FastAPI, so having FastAPI in your project is essential.</li> <li>SQLAlchemy or SQLModel: FastCRUD uses SQLAlchemy 2.0 for database operations, so you need SQLAlchemy 2.0 or newer or SQLModel 0.14 or newer.</li> <li>Pydantic V2 or SQLModel: FastCRUD leverages Pydantic models for data validation and serialization, so you need Pydantic 2.0 or newer or SQLModel 0.14 or newer.</li> </ul>"},{"location":"#installing","title":"Installing","text":"<p>To install, just run:</p> <pre><code>pip install fastcrud\n</code></pre> <p>Or, if using poetry:</p> <pre><code>poetry add fastcrud\n</code></pre>"},{"location":"#usage","title":"Usage","text":"<p>FastCRUD offers two primary ways to use its functionalities:</p> <ol> <li>By using <code>crud_router</code> for automatic endpoint creation.</li> <li>By integrating <code>FastCRUD</code> directly into your FastAPI endpoints for more control.</li> </ol> <p>Below are examples demonstrating both approaches:</p>"},{"location":"#using-crud_router-for-automatic-endpoint-creation","title":"Using <code>crud_router</code> for Automatic Endpoint Creation","text":"<p>Here's a quick example to get you started:</p>"},{"location":"#define-your-model-and-schemas","title":"Define Your Model and Schemas","text":"item/model.py<pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> item/schemas.py<pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre>"},{"location":"#set-up-fastapi-and-fastcrud","title":"Set Up FastAPI and FastCRUD","text":"main.py<pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import crud_router\nfrom fastcrud import FastCRUD\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\nfrom .item.model import Base, Item\nfrom .item.schemas import CreateItemSchema, UpdateItemSchema\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\n# CRUD operations setup\nitem_crud = FastCRUD(Item)\n\n# CRUD router setup\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    crud=item_crud,\n    path=\"/items\",\n    tags=[\"Items\"],\n)\n\napp.include_router(item_router)\n</code></pre>"},{"location":"#using-fastcrud-in-user-defined-fastapi-endpoints","title":"Using FastCRUD in User-Defined FastAPI Endpoints","text":"<p>For more control over your endpoints, you can use FastCRUD directly within your custom FastAPI route functions. Here's an example:</p> api/v1/items.py<pre><code>from fastapi import FastAPI, Depends, HTTPException\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom fastcrud import FastCRUD\n\nfrom .item.model import Item\nfrom .item.schemas import CreateItemSchema, UpdateItemSchema\n\n# Assume async_session is already set up as per the previous example\n\n# Instantiate FastCRUD with your model\nitem_crud = FastCRUD(Item)\n\n@app.post(\"/custom/items/\")\nasync def create_item(item_data: CreateItemSchema, db: AsyncSession = Depends(get_session)):\n    return await item_crud.create(db, item_data)\n\n@app.get(\"/custom/items/{item_id}\")\nasync def read_item(item_id: int, db: AsyncSession = Depends(get_session)):\n    item = await item_crud.get(db, id=item_id)\n    if not item:\n        raise HTTPException(status_code=404, detail=\"Item not found\")\n    return item\n\n# You can add more routes for update and delete operations in a similar fashion\n</code></pre>"},{"location":"#license","title":"License","text":"<p><code>MIT</code></p>"},{"location":"changelog/","title":"FastCRUD Changelog","text":""},{"location":"changelog/#introduction","title":"Introduction","text":"<p>The Changelog documents all notable changes made to FastCRUD. This includes new features, bug fixes, and improvements. It's organized by version and date, providing a clear history of the library's development.</p>"},{"location":"changelog/#0151-sep-18-2024","title":"[0.15.1] - Sep 18, 2024","text":""},{"location":"changelog/#added","title":"Added","text":"<ul> <li>Support for fastapi &gt;=0.100</li> </ul>"},{"location":"changelog/#whats-changed","title":"What's Changed","text":"<ul> <li>now supporting fastapi &gt;= 0.100.0 by @igorbenav in https://github.com/igorbenav/fastcrud/pull/166</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.15.0...v0.15.1</p>"},{"location":"changelog/#0150-sep-18-2024","title":"[0.15.0] - Sep 18, 2024","text":""},{"location":"changelog/#added_1","title":"Added","text":"<ul> <li>Models and Schemas for Task Management (Batch 3) by @slaarti</li> <li>Models and Schemas for Articles, Authors, and Profiles (Batch 4) by @slaarti</li> <li><code>update_override</code> Argument to <code>upsert_multi</code> Method by @feluelle</li> <li>Configurable <code>is_deleted</code> Field in Soft Delete Logic by @gal-dahan</li> </ul>"},{"location":"changelog/#improved","title":"Improved","text":"<ul> <li>Fixed Complex Parameter Filter with <code>between</code> Operator by @wu-clan</li> <li>Fixed Cryptography Package Vulnerability</li> <li>Resolved Update Column Name Collision in Update Method</li> </ul>"},{"location":"changelog/#fixed","title":"Fixed","text":"<ul> <li>Vulnerability in <code>cryptography</code> Package updated to <code>cryptography = \"^43.0.1\"</code></li> <li>Update Column Name Collision in the <code>update</code> method</li> </ul>"},{"location":"changelog/#documentation-updates","title":"Documentation Updates","text":"<ul> <li>Added Documentation for New Models and Schemas by @slaarti</li> <li>Updated <code>upsert_multi</code> Method Documentation with <code>update_override</code> Usage by @feluelle</li> <li>Clarified Endpoint Simplification and Deprecation Notices</li> </ul>"},{"location":"changelog/#warnings","title":"Warnings","text":"<ul> <li>Deprecation Notice: The <code>_read_paginated</code> endpoint has been removed. Please transition to using <code>_read_items</code> with pagination parameters. Docs here.</li> <li>Deprecation Notice: Handling of <code>Depends</code> is now only callable within <code>_inject_depend</code>. Update your code accordingly.</li> <li>Configuration Change Alert: Endpoints are simplified by default. Adjust your configurations to align with the new defaults. Docs here.</li> </ul>"},{"location":"changelog/#detailed-changes","title":"Detailed Changes","text":""},{"location":"changelog/#endpoint-simplification-and-deprecation-of-_read_paginated","title":"Endpoint Simplification and Deprecation of <code>_read_paginated</code>","text":""},{"location":"changelog/#description","title":"Description","text":"<p>To streamline API endpoint configurations, endpoints with empty strings as names are now the standard. Additionally, the <code>_read_paginated</code> endpoint has been removed, with its functionality merged into <code>_read_items</code>.</p>"},{"location":"changelog/#changes","title":"Changes","text":"<ul> <li>Simplified Endpoint Configuration: Endpoints can now be defined with empty strings to create cleaner paths.</li> <li>Removed <code>_read_paginated</code> Endpoint: Pagination is now handled via optional parameters in <code>_read_items</code>.</li> </ul>"},{"location":"changelog/#usage-examples","title":"Usage Examples","text":"<p>Paginated Read Example:</p> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/items?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre> <p>Non-Paginated Read Example:</p> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/items?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre>"},{"location":"changelog/#warnings_1","title":"Warnings","text":"<p>Warning</p> <p>The <code>_read_paginated</code> endpoint is deprecated. Use <code>_read_items</code> with pagination parameters instead.</p> <p>Warning</p> <p>Default endpoint names are now empty strings. Adjust your configurations to match the new defaults.</p>"},{"location":"changelog/#update_override-argument-in-upsert_multi-method","title":"<code>update_override</code> Argument in <code>upsert_multi</code> Method","text":""},{"location":"changelog/#description_1","title":"Description","text":"<p>The <code>upsert_multi</code> method now includes an <code>update_override</code> argument, giving developers the ability to override the default update logic during upsert operations. This enhancement provides greater flexibility for custom update scenarios, such as utilizing SQL <code>CASE</code> statements or other complex expressions.</p>"},{"location":"changelog/#changes_1","title":"Changes","text":"<ul> <li><code>update_override</code> Argument: Allows custom update logic in <code>upsert_multi</code>.</li> <li>Dialect Support: Implemented for PostgreSQL, SQLite, and MySQL.</li> <li>Tests: Added comprehensive tests to ensure functionality across different SQL dialects.</li> </ul>"},{"location":"changelog/#usage-example","title":"Usage Example","text":"<pre><code>from fastcrud import FastCRUD\nfrom sqlalchemy import case\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\n\nawait crud_items.upsert_multi(\n    db=db,\n    instances=[\n        ItemCreateSchema(id=1, name=\"Item A\", price=10),\n        ItemCreateSchema(id=2, name=\"Item B\", price=20),\n    ],\n    update_override={\n        \"price\": case(\n            (Item.price.is_(None), db.excluded.price),\n            else_=Item.price,\n        )\n    }\n)\n</code></pre>"},{"location":"changelog/#configurable-is_deleted-field-in-soft-delete-logic","title":"Configurable <code>is_deleted</code> Field in Soft Delete Logic","text":""},{"location":"changelog/#description_2","title":"Description","text":"<p>The <code>is_deleted</code> field in the soft delete logic is now optional and configurable. This change allows developers to customize the soft delete behavior per model, providing flexibility in how deletion states are handled.</p>"},{"location":"changelog/#new-contributors","title":"New Contributors","text":"<ul> <li>@wu-clan made their first contribution \ud83c\udf1f</li> <li>@gal-dahan made their first contribution \ud83c\udf1f</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0140-jul-29-2024","title":"[0.14.0] - Jul 29, 2024","text":""},{"location":"changelog/#added_2","title":"Added","text":"<ul> <li>Type-checking support for SQLModel types by @kdcokenny \ud83d\ude80</li> <li>Returning clause to update operations by @feluelle</li> <li>Upsert_multi functionality by @feluelle</li> <li>Simplified endpoint configurations by @JakNowy, streamlining path generation and merging pagination functionalities into a unified <code>_read_items</code> endpoint, promoting more efficient API structure and usage. Details in https://github.com/igorbenav/fastcrud/pull/105</li> </ul>"},{"location":"changelog/#improved_1","title":"Improved","text":"<ul> <li>Comprehensive tests for paginated retrieval of items, maintaining 100% coverage</li> <li>Docker client check before running tests that require Docker by @feluelle</li> </ul>"},{"location":"changelog/#fixed_1","title":"Fixed","text":"<ul> <li>Vulnerability associated with an outdated cryptography package</li> <li>Return type inconsistency in async session fixtures by @slaarti</li> </ul>"},{"location":"changelog/#documentation-updates_1","title":"Documentation Updates","text":"<ul> <li>Cleanup of documentation formatting by @slaarti</li> <li>Replacement of the Contributing section in docs with an include to file in repo root by @slaarti</li> <li>Correction of links to advanced filters in docstrings by @slaarti</li> <li>Backfill of docstring fixes across various modules by @slaarti</li> <li>Enhanced filter documentation with new AND and OR clause examples, making complex queries more accessible and understandable.</li> </ul>"},{"location":"changelog/#models-and-schemas-enhancements","title":"Models and Schemas Enhancements","text":"<ul> <li>Introduction of simple and one-off models (Batch 1) by @slaarti</li> <li>Expansion to include models and schemas for Customers, Products, and Orders (Batch 2) by @slaarti</li> </ul>"},{"location":"changelog/#code-refinements","title":"Code Refinements","text":"<ul> <li>Resolution of missing type specifications in kwargs by @slaarti</li> <li>Collapsed space adjustments for models/schemas in <code>fast_crud.py</code> by @slaarti</li> </ul>"},{"location":"changelog/#warnings_2","title":"Warnings","text":"<ul> <li>Deprecation Notice: <code>_read_paginated</code> endpoint is set to be deprecated and merged into <code>_read_items</code>. Users are encouraged to transition to the latter, utilizing optional pagination parameters. Full details and usage instructions provided to ensure a smooth transition.</li> <li>Future Changes Alert: Default endpoint names in <code>EndpointCreator</code> are anticipated to be set to empty strings in a forthcoming major release, aligning with simplification efforts. Refer to https://github.com/igorbenav/fastcrud/issues/67 for more information.</li> </ul>"},{"location":"changelog/#detailed-changes_1","title":"Detailed Changes","text":""},{"location":"changelog/#simplified-endpoint-configurations","title":"Simplified Endpoint Configurations","text":"<p>In an effort to streamline FastCRUD\u2019s API, we have reconfigured endpoint paths to avoid redundancy (great work by @JakNowy). This change allows developers to specify empty strings for endpoint names in the <code>crud_router</code> setup, which prevents the generation of unnecessary <code>//</code> in the paths. The following configurations illustrate how endpoints can now be defined more succinctly:</p> <pre><code>endpoint_names = {\n    \"create\": \"\",\n    \"read\": \"\",\n    \"update\": \"\",\n    \"delete\": \"\",\n    \"db_delete\": \"\",\n    \"read_multi\": \"\",\n    \"read_paginated\": \"get_paginated\",\n}\n</code></pre> <p>Moreover, the <code>_read_paginated</code> logic has been integrated into the <code>_read_items</code> endpoint. This integration means that pagination can now be controlled via <code>page</code> and <code>items_per_page</code> query parameters, offering a unified method for both paginated and non-paginated reads:</p> <ul> <li>Paginated read example:</li> </ul> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/users/get_multi?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre> <ul> <li>Non-paginated read example:</li> </ul> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/users/get_multi?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre>"},{"location":"changelog/#warnings_3","title":"Warnings","text":"<ul> <li>Deprecation Warning: The <code>_read_paginated</code> endpoint is slated for deprecation. Developers should transition to using <code>_read_items</code> with the relevant pagination parameters.</li> <li>Configuration Change Alert: In a future major release, default endpoint names in <code>EndpointCreator</code> will be empty strings by default, as discussed in Issue #67.</li> </ul>"},{"location":"changelog/#advanced-filters-documentation-update","title":"Advanced Filters Documentation Update","text":"<p>Documentation for advanced filters has been expanded to include comprehensive examples of AND and OR clauses, enhancing the utility and accessibility of complex query constructions.</p> <ul> <li>OR clause example:</li> </ul> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre> <ul> <li>AND clause example:</li> </ul> <pre><code># Fetch items priced under $20 and over 2 years of warranty\nitems = await item_crud.get_multi(\n    db=db,\n    price__lt=20,\n    warranty_years__gt=2,\n)\n</code></pre>"},{"location":"changelog/#returning-clauses-in-update-operations","title":"Returning Clauses in Update Operations","text":""},{"location":"changelog/#description_3","title":"Description","text":"<p>Users can now retrieve updated records immediately following an update operation. This feature streamlines the process, reducing the need for subsequent retrieval calls and increasing efficiency.</p>"},{"location":"changelog/#changes_2","title":"Changes","text":"<ul> <li>Return Columns: Specify the columns to be returned after the update via the <code>return_columns</code> argument.</li> <li>Schema Selection: Optionally select a Pydantic schema to format the returned data using the <code>schema_to_select</code> argument.</li> <li>Return as Model: Decide if the returned data should be converted into a model using the <code>return_as_model</code> argument.</li> <li>Single or None: Utilize the <code>one_or_none</code> argument to ensure that either a single record is returned or none, in case the conditions do not match any records.</li> </ul> <p>These additions are aligned with existing CRUD API functions, enhancing consistency across the library and making the new features intuitive for users.</p>"},{"location":"changelog/#usage-example_1","title":"Usage Example","text":""},{"location":"changelog/#returning-updated-fields","title":"Returning Updated Fields","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nupdated_item = await crud_items.update(\n    db=db,\n    object={\"price\": 9.99},\n    price__lt=10,\n    return_columns=[\"price\"]\n)\n# This returns the updated price of the item directly.\n</code></pre>"},{"location":"changelog/#returning-data-as-a-model","title":"Returning Data as a Model","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .schemas.item import ItemSchema\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nupdated_item_schema = await crud_items.update(\n    db=db,\n    object={\"price\": 9.99},\n    price__lt=10,\n    schema_to_select=ItemSchema,\n    return_as_model=True\n)\n# This returns the updated item data formatted as an ItemSchema model.\n</code></pre>"},{"location":"changelog/#bulk-upsert-operations-with-upsert_multi","title":"Bulk Upsert Operations with <code>upsert_multi</code>","text":"<p>The <code>upsert_multi</code> method provides the ability to perform bulk upsert operations, which are optimized for different SQL dialects.</p>"},{"location":"changelog/#changes_3","title":"Changes","text":"<ul> <li>Dialect-Optimized SQL: Uses the most efficient SQL commands based on the database's SQL dialect.</li> <li>Support for Multiple Dialects: Includes custom implementations for PostgreSQL, SQLite, and MySQL, with appropriate handling for each's capabilities and limitations.</li> </ul>"},{"location":"changelog/#usage-example_2","title":"Usage Example","text":""},{"location":"changelog/#upserting-multiple-records","title":"Upserting Multiple Records","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .schemas.item import ItemCreateSchema, ItemSchema\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nitems = await crud_items.upsert_multi(\n    db=db,\n    instances=[\n        ItemCreateSchema(price=9.99),\n    ],\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n# This will return the upserted data in the form of ItemSchema.\n</code></pre>"},{"location":"changelog/#implementation-details","title":"Implementation Details","text":"<p><code>upsert_multi</code> handles different database dialects: - PostgreSQL: Uses <code>ON CONFLICT DO UPDATE</code>. - SQLite: Utilizes <code>ON CONFLICT DO UPDATE</code>. - MySQL: Implements <code>ON DUPLICATE KEY UPDATE</code>.</p>"},{"location":"changelog/#notes","title":"Notes","text":"<ul> <li>MySQL and MariaDB do not support certain advanced features used in other dialects, such as returning values directly after an insert or update operation. This limitation is clearly documented to prevent misuse.</li> </ul>"},{"location":"changelog/#new-contributors_1","title":"New Contributors","text":"<ul> <li>@kdcokenny made their first contribution \ud83c\udf1f</li> <li>@feluelle made their first contribution \ud83c\udf1f</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0131-jun-22-2024","title":"[0.13.1] - Jun 22, 2024","text":""},{"location":"changelog/#added_3","title":"Added","text":"<ul> <li>More Advanced Filters by @JakNowy \ud83c\udf89</li> </ul>"},{"location":"changelog/#fixed_2","title":"Fixed","text":"<ul> <li>Bug where objects with null primary key are returned with all fields set to None in nested joins #102 </li> </ul>"},{"location":"changelog/#detailed-changes_2","title":"Detailed Changes","text":""},{"location":"changelog/#advanced-filters","title":"Advanced Filters","text":"<p>FastCRUD supports advanced filtering options, allowing you to query records using operators such as greater than (<code>__gt</code>), less than (<code>__lt</code>), and their inclusive counterparts (<code>__gte</code>, <code>__lte</code>). These filters can be used in any method that retrieves or operates on records, including <code>get</code>, <code>get_multi</code>, <code>exists</code>, <code>count</code>, <code>update</code>, and <code>delete</code>.</p>"},{"location":"changelog/#single-parameter-filters","title":"Single parameter filters","text":"<p>Most filter operators require a single string or integer value.</p> <pre><code># Fetch items priced above $5\nitems = await item_crud.get_multi(\n    db=db,\n    price__gte=5,\n)\n</code></pre> <p>Currently supported single parameter filters are: - __gt - greater than - __lt - less than - __gte - greater than or equal to - __lte - less than or equal to - __ne - not equal - __is - used to test True, False, and None identity - __is_not - negation of \"is\" - __like - SQL \"like\" search for specific text pattern - __notlike - negation of \"like\" - __ilike - case insensitive \"like\" - __notilike - case insensitive \"notlike\" - __startswith - text starts with given string - __endswith - text ends with given string - __contains - text contains given string - __match - database-specific match expression</p>"},{"location":"changelog/#complex-parameter-filters","title":"Complex parameter filters","text":"<p>Some operators require multiple values. They must be passed as a python tuple, list, or set.</p> <p><pre><code># Fetch items priced between $5 and $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__between=(5, 20),\n)\n</code></pre> - __between - between 2 numeric values - __in - included in - __not_in - not included in</p>"},{"location":"changelog/#or-parameter-filters","title":"OR parameter filters","text":"<p>More complex OR filters are supported. They must be passed as a dictionary, where each key is a library-supported operator to be used in OR expression and values are what get's passed as the parameter.</p> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre>"},{"location":"changelog/#whats-changed_1","title":"What's Changed","text":"<ul> <li>Missing sqlalchemy operators by @JakNowy in https://github.com/igorbenav/fastcrud/pull/85</li> <li>Null primary key bug fixed in https://github.com/igorbenav/fastcrud/pull/107</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.13.0...v0.13.1</p>"},{"location":"changelog/#0130-may-28-2024","title":"[0.13.0] - May 28, 2024","text":""},{"location":"changelog/#added_4","title":"Added","text":"<ul> <li>Filters in Automatic Endpoints \ud83c\udf89</li> <li>One-to-many support in joins</li> <li>Upsert method in FastCRUD class by @dubusster </li> </ul>"},{"location":"changelog/#detailed-changes_3","title":"Detailed Changes","text":""},{"location":"changelog/#using-filters-in-fastcrud","title":"Using Filters in FastCRUD","text":"<p>FastCRUD provides filtering capabilities, allowing you to filter query results based on various conditions. Filters can be applied to <code>read_multi</code> and <code>read_paginated</code> endpoints. This section explains how to configure and use filters in FastCRUD.</p>"},{"location":"changelog/#defining-filters","title":"Defining Filters","text":"<p>Filters are either defined using the <code>FilterConfig</code> class or just passed as a dictionary. This class allows you to specify default filter values and validate filter types. Here's an example of how to define filters for a model:</p> <pre><code>from fastcrud import FilterConfig\n\n# Define filter configuration for a model\nfilter_config = FilterConfig(\n    tier_id=None,  # Default filter value for tier_id\n    name=None  # Default filter value for name\n)\n</code></pre> <p>And the same thing using a <code>dict</code>: <pre><code>filter_config = {\n    \"tier_id\": None,  # Default filter value for tier_id\n    \"name\": None,  # Default filter value for name\n}\n</code></pre></p> <p>By using <code>FilterConfig</code> you get better error messages.</p>"},{"location":"changelog/#applying-filters-to-endpoints","title":"Applying Filters to Endpoints","text":"<p>You can apply filters to your endpoints by passing the <code>filter_config</code> to the <code>crud_router</code> or <code>EndpointCreator</code>. Here's an example:</p> <pre><code>from fastcrud import crud_router\nfrom yourapp.models import YourModel\nfrom yourapp.schemas import CreateYourModelSchema, UpdateYourModelSchema\nfrom yourapp.database import async_session\n\n# Apply filters using crud_router\napp.include_router(\n    crud_router(\n        session=async_session,\n        model=YourModel,\n        create_schema=CreateYourModelSchema,\n        update_schema=UpdateYourModelSchema,\n        filter_config=filter_config,  # Apply the filter configuration\n        path=\"/yourmodel\",\n        tags=[\"YourModel\"]\n    )\n)\n</code></pre>"},{"location":"changelog/#using-filters-in-requests","title":"Using Filters in Requests","text":"<p>Once filters are configured, you can use them in your API requests. Filters are passed as query parameters. Here's an example of how to use filters in a request to a paginated endpoint:</p> <pre><code>GET /yourmodel/get_paginated?page=1&amp;itemsPerPage=3&amp;tier_id=1&amp;name=Alice\n</code></pre>"},{"location":"changelog/#custom-filter-validation","title":"Custom Filter Validation","text":"<p>The <code>FilterConfig</code> class includes a validator to check filter types. If an invalid filter type is provided, a <code>ValueError</code> is raised. You can customize the validation logic by extending the <code>FilterConfig</code> class:</p> <pre><code>from fastcrud import FilterConfig\nfrom pydantic import ValidationError\n\nclass CustomFilterConfig(FilterConfig):\n    @field_validator(\"filters\")\n    def check_filter_types(cls, filters: dict[str, Any]) -&gt; dict[str, Any]:\n        for key, value in filters.items():\n            if not isinstance(value, (type(None), str, int, float, bool)):\n                raise ValueError(f\"Invalid default value for '{key}': {value}\")\n        return filters\n\ntry:\n    # Example of invalid filter configuration\n    invalid_filter_config = CustomFilterConfig(invalid_field=[])\nexcept ValidationError as e:\n    print(e)\n</code></pre>"},{"location":"changelog/#handling-invalid-filter-columns","title":"Handling Invalid Filter Columns","text":"<p>FastCRUD ensures that filters are applied only to valid columns in your model. If an invalid filter column is specified, a <code>ValueError</code> is raised:</p> <pre><code>try:\n    # Example of invalid filter column\n    invalid_filter_config = FilterConfig(non_existent_column=None)\nexcept ValueError as e:\n    print(e)  # Output: Invalid filter column 'non_existent_column': not found in model\n</code></pre>"},{"location":"changelog/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>one-to-one</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"changelog/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul> <p>Example</p> <p>Let's define two tables:</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <p>Fetch a user and their tier:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre> <p>One-to-One Relationship with Nested Joins</p> <p>To get the joined data in a nested dictionary:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    nest_joins=True,\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre>"},{"location":"changelog/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>Warning</p> <p>When using <code>nest_joins=True</code>, the performance will always be a bit worse than when using <code>nest_joins=False</code>. For cases where more performance is necessary, consider using <code>nest_joins=False</code> and remodeling your database.</p> <p>Example</p> <p>To demonstrate a one-to-many relationship, let's assume <code>User</code> and <code>Post</code> tables:</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n\nclass Post(Base):\n    __tablename__ = \"post\"\n    id = Column(Integer, primary key=True)\n    user_id = Column(Integer, ForeignKey(\"user.id\"))\n    content = Column(String)\n</code></pre> <p>Fetch a user and all their posts:</p> <pre><code>user_posts = await user_crud.get_joined(\n    db=db,\n    join_model=Post,\n    join_on=User.id == Post.user_id,\n    join_type=\"left\",\n    join_prefix=\"post_\",\n    nest_joins=True,\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example User\",\n    \"posts\": [\n        {\n            \"id\": 101,\n            \"user_id\": 1,\n            \"content\": \"First post content\"\n        },\n        {\n            \"id\": 102,\n            \"user_id\": 1,\n            \"content\": \"Second post content\"\n        }\n    ]\n}\n</code></pre>"},{"location":"changelog/#whats-changed_2","title":"What's Changed","text":"<ul> <li>feat: \u2728 add upsert method in FastCRUD class by @dubusster</li> <li>Filters in Automatic Endpoints</li> <li>One-to-many support in joins</li> <li>tests fixed by @igorbenav</li> <li>Using the same session for all tests</li> <li>warning added to docs</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.12.1...v0.13.0</p>"},{"location":"changelog/#0121-may-10-2024","title":"[0.12.1] - May 10, 2024","text":""},{"location":"changelog/#added_5","title":"Added","text":"<ul> <li>Deprecation Warning for dependency handling.</li> </ul>"},{"location":"changelog/#detailed-changes_4","title":"Detailed Changes","text":"<p>If you pass a sequence of <code>params.Depends</code> type variables to any <code>*_deps</code> parameter in <code>EndpointCreator</code> and <code>crud_router</code>, you'll get a warning. Support will be completely removed in 0.15.0.</p> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.12.0...v0.12.1</p>"},{"location":"changelog/#0120-may-8-2024","title":"[0.12.0] - May 8, 2024","text":""},{"location":"changelog/#added_6","title":"Added","text":"<ul> <li>Unpaginated versions of multi-row get methods by @slaarti in #62  \ud83c\udf89</li> <li>Nested Join bug fixes</li> <li>Dependency handling now working as docs say</li> <li>Option to Skip commit in some fastcrud methods</li> <li>Docstring example fixes</li> <li><code>__in</code> and <code>__not_in</code> filters by @JakNowy \ud83c\udf89</li> <li>Fastapi 0.111.0 support</li> </ul>"},{"location":"changelog/#detailed-changes_5","title":"Detailed Changes","text":""},{"location":"changelog/#unpaginated-versions-of-multi-row-get-methods","title":"Unpaginated versions of multi-row get methods","text":"<p>Now, if you pass <code>None</code> to <code>limit</code> in <code>get_multi</code> and <code>get_multi_joined</code>, you get the whole unpaginated set of data that matches the filters. Use this with caution.</p> <pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nitems = await crud_items.get_multi(db=db, limit=None)\n# this will return all items in the db\n</code></pre>"},{"location":"changelog/#dependency-handling-now-working-as-docs-say","title":"Dependency handling now working as docs say","text":"<p>Now, you may pass dependencies to <code>crud_router</code> or <code>EndpointCreator</code> as simple functions instead of needing to wrap them in <code>fastapi.Depends</code>.</p> <pre><code>from .dependencies import get_superuser\napp.include_router(\n    crud_router(\n        session=db,\n        model=Item,\n        create_schema=ItemCreate,\n        update_schema=ItemUpdate,\n        delete_schema=ItemDelete,\n        create_deps=[get_superuser],\n        update_deps=[get_superuser],\n        delete_deps=[get_superuser],\n        path=\"/item\",\n        tags=[\"item\"],\n    )\n)\n</code></pre>"},{"location":"changelog/#option-to-skip-commit-in-some-fastcrud-methods","title":"Option to Skip commit in some fastcrud methods","text":"<p>For <code>create</code>, <code>update</code>, <code>db_delete</code> and <code>delete</code> methods of <code>FastCRUD</code>, now you have the option of passing <code>commit=False</code> so you don't commit the operations immediately.</p> <pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\n\nawait crud_items.delete(\n    db=db, \n    commit=False, \n    id=1\n)\n# this will not actually delete until you run a db.commit()\n</code></pre>"},{"location":"changelog/#__in-and-__not_in-filters","title":"<code>__in</code> and <code>__not_in</code> filters","text":"<p>You may now pass <code>__in</code> and <code>__not_in</code> to methods that accept advanced queries:</p> <ul> <li><code>__gt</code>: greater than,</li> <li><code>__lt</code>: less than,</li> <li><code>__gte</code>: greater than or equal to,</li> <li><code>__lte</code>: less than or equal to,</li> <li><code>__ne</code>: not equal,</li> <li><code>__in</code>: included in [tuple, list or set],</li> <li><code>__not_in</code>: not included in [tuple, list or set].</li> </ul>"},{"location":"changelog/#whats-changed_3","title":"What's Changed","text":"<ul> <li>Add unpaginated versions of multi-row get methods (w/tests) by @slaarti \ud83c\udf89</li> <li>Join fixes</li> <li>Dependencies</li> <li>Skip commit</li> <li>Docstring fix</li> <li>feat: filter __in by @JakNowy \ud83c\udf89</li> <li>python support for 0.111.0 added</li> <li>version bump in pyproject.toml for 0.12.0</li> </ul>"},{"location":"changelog/#new-contributors_2","title":"New Contributors","text":"<ul> <li>@slaarti made their first contribution in https://github.com/igorbenav/fastcrud/pull/62 \ud83c\udf89</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.11.1...v0.12.0</p>"},{"location":"changelog/#0111-apr-22-2024","title":"[0.11.1] - Apr 22, 2024","text":""},{"location":"changelog/#added_7","title":"Added","text":"<ul> <li><code>one_or_none</code> parameter to FastCRUD <code>get</code> method (default <code>False</code>)</li> <li><code>nest_joins</code> parameter to FastCRUD <code>get_joined</code> and <code>get_multi_joined</code> (default <code>False</code>)</li> </ul>"},{"location":"changelog/#detailed-changes_6","title":"Detailed Changes","text":""},{"location":"changelog/#get","title":"<code>get</code>","text":"<p>By default, the <code>get</code> method in <code>FastCRUD</code> returns the <code>first</code> object matching all the filters it finds.</p> <p>If you want to ensure the <code>one_or_none</code> behavior, you may pass the parameter as <code>True</code>:</p> <pre><code>crud.get(\n    async_session, \n    one_or_none=True, \n    category_id=1\n)\n</code></pre>"},{"location":"changelog/#get_joined-and-get_multi_joined","title":"<code>get_joined</code> and <code>get_multi_joined</code>","text":"<p>By default, <code>FastCRUD</code> joins all the data and returns it in a single dictionary. Let's define two tables: <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre></p> <p>And join them with <code>FastCRUD</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",,\n    id=1\n)\n</code></pre> <p>We'll get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\",\n}\n</code></pre> <p>Now, if you want the joined data in a nested dictionary instead, you may just pass <code>nest_joins=True</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>And you will get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\",\n    },\n}\n</code></pre> <p>This works for both <code>get_joined</code> and <code>get_multi_joined</code>.</p> <p>Warning</p> <p>Note that the final <code>\"_\"</code> in the passed <code>\"tier_\"</code> is stripped.</p>"},{"location":"changelog/#whats-changed_4","title":"What's Changed","text":"<ul> <li>Reuse of <code>select</code> method in <code>FastCRUD</code></li> <li>Skip count call when possible</li> <li>Add <code>one_or_none</code> parameter to FastCRUD <code>get</code> method</li> <li>Add <code>nest_joins</code> parameter to FastCRUD <code>get_joined</code> and <code>get_multi_joined</code></li> </ul>"},{"location":"changelog/#new-contributors_3","title":"New Contributors","text":"<ul> <li>@JakNowy made their first contribution in PR #51.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0110-apr-7-2024","title":"[0.11.0] - Apr 7, 2024","text":""},{"location":"changelog/#added_8","title":"Added","text":"<ul> <li>Multiple primary keys support, a significant enhancement by @dubusster in #31 \ud83c\udf89.</li> <li>Option to disable the count in <code>get_multi</code> and <code>get_multi_joined</code> methods for performance optimization.</li> <li>Fixes for a validation bug when <code>return_as_model</code> is set to <code>True</code>.</li> <li>Resolution of a bug concerning incorrect handling of <code>db_row</code> in methods.</li> <li>Correction of the <code>valid_methods</code> bug, which previously raised the wrong error type.</li> <li>Upgrade of <code>FastAPI</code> dependency to version <code>0.111.0</code>, ensuring compatibility with the latest FastAPI features.</li> <li>Achievement of 100% test coverage, with the addition of a workflow and badge to showcase this milestone.</li> <li>Inclusion of the changelog within the project documentation, providing a comprehensive history of changes directly to users.</li> </ul>"},{"location":"changelog/#detailed-changes_7","title":"Detailed Changes","text":""},{"location":"changelog/#multiple-primary-keys-support","title":"Multiple Primary Keys Support","text":"<p>FastCRUD now accommodates models with multiple primary keys, facilitating more complex database designs. For models defined with more than one primary key, the endpoint creator automatically generates paths reflecting the primary keys' order. This feature extends support to primary keys named differently than <code>id</code>, enhancing the flexibility of FastCRUD's routing capabilities.</p>"},{"location":"changelog/#example","title":"Example:","text":"<p>For a model with multiple primary keys, FastCRUD generates specific endpoints such as <code>/multi_pk/get/{id}/{uuid}</code>, accommodating the unique identification needs of complex data models.</p>"},{"location":"changelog/#optional-count","title":"Optional Count","text":"<p>The <code>get_multi</code> and <code>get_multi_joined</code> methods now feature an <code>return_total_count=False</code> parameter, allowing users to opt-out of receiving the total count in responses. This option can enhance performance by skipping potentially expensive count operations.</p>"},{"location":"changelog/#behavior","title":"Behavior:","text":"<ul> <li>By default, <code>return_total_count=True</code> is assumed, returning both data and a total count.</li> <li>When set to <code>False</code>, responses contain only the data array, omitting the total count for efficiency.</li> </ul>"},{"location":"changelog/#whats-changed_5","title":"What's Changed","text":"<ul> <li>Implementation of multiple primary keys support, addressing a significant flexibility requirement for advanced use cases.</li> <li>Introduction of optional count retrieval in multi-get methods, optimizing performance by eliminating unnecessary database queries.</li> <li>Several critical bug fixes, improving the stability and reliability of FastCRUD.</li> <li>Documentation enhancements, including the addition of a changelog section, ensuring users have access to detailed release information.</li> <li>Update to FastAPI <code>0.111.0</code>, ensuring compatibility with the latest enhancements in the FastAPI ecosystem.</li> <li>Achievement of 100% test coverage, marking a significant milestone in the project's commitment to reliability and quality assurance.</li> </ul>"},{"location":"changelog/#relevant-contributors","title":"Relevant Contributors","text":"<ul> <li>@dubusster made a notable contribution with the implementation of multiple primary keys support in PR #31.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0100-mar-30-2024","title":"[0.10.0] - Mar 30, 2024","text":""},{"location":"changelog/#added_9","title":"Added","text":"<ul> <li><code>select</code> statement functionality, thanks to @dubusster's contribution in PR #28 \ud83d\ude80.</li> <li>Support for joined models in the <code>count</code> method through the <code>joins_config</code> parameter.</li> <li>Filters for joined models via the <code>filters</code> parameter in <code>JoinConfig</code>.</li> <li>Type checking workflow integrated with <code>mypy</code> alongside fixes for typing issues.</li> <li>Linting workflow established with <code>ruff</code>.</li> </ul>"},{"location":"changelog/#detailed-changes_8","title":"Detailed Changes","text":""},{"location":"changelog/#select","title":"Select","text":"<p>The <code>select</code> method constructs a SQL Alchemy <code>Select</code> statement, offering flexibility in column selection, filtering, and sorting. It is designed to chain additional SQLAlchemy methods for complex queries. Docs here and here.</p>"},{"location":"changelog/#features","title":"Features:","text":"<ul> <li>Column Selection: Choose columns via a Pydantic schema.</li> <li>Sorting: Define columns and their order for sorting.</li> <li>Filtering: Directly apply filters through keyword arguments.</li> <li>Chaining: Allow for chaining with other SQLAlchemy methods for advanced query construction.</li> </ul>"},{"location":"changelog/#improved-joins","title":"Improved Joins","text":"<p><code>JoinConfig</code> enhances FastCRUD queries by detailing join operations between models, offering configurations like model joining, conditions, prefixes, column selection through schemas, join types, aliases, and direct filtering. Docs here.</p>"},{"location":"changelog/#applying-joins-in-fastcrud-methods","title":"Applying Joins in FastCRUD Methods","text":"<p>Detailed explanations and examples are provided for using joins in <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code> methods to achieve complex data retrieval, including handling of many-to-many relationships.</p>"},{"location":"changelog/#whats-changed_6","title":"What's Changed","text":"<ul> <li>New <code>select</code> statement functionality added.</li> <li>Documentation and method improvements for select and joins.</li> <li>Integration of type checking and linting workflows.</li> <li>Version bump in pyproject.toml.</li> </ul>"},{"location":"changelog/#new-contributors_4","title":"New Contributors","text":"<ul> <li>@dubusster made their first contribution in PR #28.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#091-mar-19-2024","title":"[0.9.1] - Mar 19, 2024","text":""},{"location":"changelog/#added_10","title":"Added","text":"<ul> <li>Enhanced <code>get_joined</code> and <code>get_multi_joined</code> methods to support aliases, enabling multiple joins on the same model. This improvement addresses issue #27.</li> </ul>"},{"location":"changelog/#detailed-changes_9","title":"Detailed Changes","text":""},{"location":"changelog/#alias-support-for-complex-joins","title":"Alias Support for Complex Joins","text":"<p>With the introduction of alias support, <code>get_joined</code> and <code>get_multi_joined</code> methods now allow for more complex queries, particularly beneficial in scenarios requiring self-joins or multiple joins on the same table. Aliases help to avoid conflicts and ambiguity by providing unique identifiers for the same model in different join contexts. Docs here.</p>"},{"location":"changelog/#example-multiple-joins-with-aliases","title":"Example: Multiple Joins with Aliases","text":"<p>To demonstrate the use of aliases, consider a task management system where tasks are associated with both an owner and an assigned user from the same <code>UserModel</code>. Aliases enable joining the <code>UserModel</code> twice under different contexts - as an owner and an assigned user. This example showcases how to set up aliases using the <code>aliased</code> function and incorporate them into your <code>JoinConfig</code> for clear and conflict-free query construction. Docs here.</p>"},{"location":"changelog/#whats-changed_7","title":"What's Changed","text":"<ul> <li>Introduction of aliases in joins, improving query flexibility and expressiveness, as detailed by @igorbenav in PR #29.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#090-mar-14-2024","title":"[0.9.0] - Mar 14, 2024","text":""},{"location":"changelog/#added_11","title":"Added","text":"<ul> <li>Enhanced <code>get_joined</code> and <code>get_multi_joined</code> methods now support handling joins with multiple models.</li> </ul>"},{"location":"changelog/#detailed-changes_10","title":"Detailed Changes","text":""},{"location":"changelog/#multi-model-join-capabilities","title":"Multi-Model Join Capabilities","text":"<p>The <code>get_joined</code> and <code>get_multi_joined</code> methods have been upgraded to accommodate joins involving multiple models. This functionality is facilitated through the <code>joins_config</code> parameter, allowing for the specification of multiple <code>JoinConfig</code> instances. Each instance represents a unique join configuration, broadening the scope for complex data relationship management within FastCRUD. Docs here.</p>"},{"location":"changelog/#example-multi-model-join","title":"Example: Multi-Model Join","text":"<p>A practical example involves retrieving users alongside their corresponding tier and department details. By configuring <code>joins_config</code> with appropriate <code>JoinConfig</code> instances for the <code>Tier</code> and <code>Department</code> models, users can efficiently gather comprehensive data across related models, enhancing data retrieval operations' depth and flexibility.</p> <p>Warning</p> <p>An error will occur if both single join parameters and <code>joins_config</code> are used simultaneously. It's crucial to ensure that your join configurations are correctly set to avoid conflicts.</p>"},{"location":"changelog/#whats-changed_8","title":"What's Changed","text":"<ul> <li>Introduction of multi-model join support in <code>get_joined</code> and <code>get_multi_joined</code>, enabling more complex and detailed data retrieval strategies.</li> <li>Several minor updates and fixes, including package import corrections and <code>pyproject.toml</code> updates, to improve the library's usability and stability.</li> </ul>"},{"location":"changelog/#new-contributors_5","title":"New Contributors","text":"<ul> <li>@iridescentGray</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#080-mar-4-2024","title":"[0.8.0] - Mar 4, 2024","text":""},{"location":"changelog/#added_12","title":"Added","text":"<ul> <li>Feature to customize names of auto-generated endpoints using the <code>endpoint_names</code> parameter, applicable in both <code>crud_router</code> function and <code>EndpointCreator</code>.</li> </ul>"},{"location":"changelog/#detailed-changes_11","title":"Detailed Changes","text":""},{"location":"changelog/#custom-endpoint-naming","title":"Custom Endpoint Naming","text":"<p>The introduction of the <code>endpoint_names</code> parameter offers flexibility in defining endpoint names for CRUD operations. This enhancement caters to the need for more descriptive or project-specific naming conventions, enabling developers to align the API's interface with their domain language or organizational standards. </p>"},{"location":"changelog/#example-customizing-endpoint-names-with-crud_router","title":"Example: Customizing Endpoint Names with <code>crud_router</code>","text":"<p>Customizing endpoint names is straightforward with the <code>crud_router</code> function. By providing a dictionary mapping CRUD operation names to desired endpoint names, developers can easily tailor their API's paths to fit their application's unique requirements.</p>"},{"location":"changelog/#example-customizing-endpoint-names-with-endpointcreator","title":"Example: Customizing Endpoint Names with <code>EndpointCreator</code>","text":"<p>Similarly, when using the <code>EndpointCreator</code>, the <code>endpoint_names</code> parameter allows for the same level of customization, ensuring consistency across different parts of the application or service.</p> <p>Tip</p> <p>It's not necessary to specify all endpoint names; only those you wish to change need to be included in the <code>endpoint_names</code> dictionary. This flexibility ensures minimal configuration effort for maximum impact.</p>"},{"location":"changelog/#whats-changed_9","title":"What's Changed","text":"<ul> <li>Enhanced endpoint customization capabilities through <code>endpoint_names</code> parameter, supporting a more tailored and intuitive API design.</li> <li>Documentation updates to guide users through the process of customizing endpoint names.</li> </ul>"},{"location":"changelog/#070-feb-20-2024","title":"[0.7.0] - Feb 20, 2024","text":""},{"location":"changelog/#added_13","title":"Added","text":"<ul> <li>The <code>get_paginated</code> endpoint for retrieving items with pagination support.</li> <li>The <code>paginated</code> module to offer utility functions for pagination.</li> </ul>"},{"location":"changelog/#detailed-changes_12","title":"Detailed Changes","text":""},{"location":"changelog/#get_paginated-endpoint","title":"<code>get_paginated</code> Endpoint","text":"<p>This new endpoint enhances data retrieval capabilities by introducing pagination, an essential feature for handling large datasets efficiently. It supports customizable query parameters for page number and items per page, facilitating flexible data access patterns. Docs here.</p>"},{"location":"changelog/#features_1","title":"Features:","text":"<ul> <li>Endpoint and Method: A <code>GET</code> request to <code>/get_paginated</code>.</li> <li>Query Parameters: Includes <code>page</code> for the page number and <code>itemsPerPage</code> for controlling the number of items per page.</li> <li>Example Usage: Demonstrated with a request for retrieving items with specified pagination settings.</li> </ul>"},{"location":"changelog/#paginated-module","title":"<code>paginated</code> Module","text":"<p>The introduction of the <code>paginated</code> module brings two key utility functions, <code>paginated_response</code> and <code>compute_offset</code>, which streamline the implementation of paginated responses in the application.</p>"},{"location":"changelog/#functions","title":"Functions:","text":"<ul> <li>paginated_response: Constructs a paginated response based on the input data, page number, and items per page.</li> <li>compute_offset: Calculates the offset for database queries, based on the current page number and the number of items per page.</li> </ul>"},{"location":"changelog/#whats-changed_10","title":"What's Changed","text":"<ul> <li>Deployment of pagination functionality, embodied in the <code>get_paginated</code> endpoint and the <code>paginated</code> module, to facilitate efficient data handling and retrieval.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#060-feb-11-2024","title":"[0.6.0] - Feb 11, 2024","text":""},{"location":"changelog/#added_14","title":"Added","text":"<ul> <li>The ability to use a custom <code>updated_at</code> column name in models.</li> <li>Making the passing of the <code>crud</code> parameter to <code>crud_router</code> and <code>EndpointCreator</code> optional.</li> <li>Inclusion of exceptions in the <code>http_exceptions</code> module within the broader <code>exceptions</code> module for better organization and accessibility.</li> </ul>"},{"location":"changelog/#detailed-changes_13","title":"Detailed Changes","text":""},{"location":"changelog/#custom-updated_at-column","title":"Custom <code>updated_at</code> Column","text":"<p>FastCRUD now supports the customization of the <code>updated_at</code> column name, providing flexibility for applications with different database schema conventions or naming practices. Docs here.</p>"},{"location":"changelog/#example-configuration","title":"Example Configuration:","text":"<p>The example demonstrates how to specify a custom column name for <code>updated_at</code> when setting up the router for an endpoint, allowing for seamless integration with existing database schemas.</p>"},{"location":"changelog/#whats-changed_11","title":"What's Changed","text":"<ul> <li>Introduction of features enhancing flexibility and usability, such as custom <code>updated_at</code> column names and the optional CRUD parameter in routing configurations.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#050-feb-3-2024","title":"[0.5.0] - Feb 3, 2024","text":""},{"location":"changelog/#added_15","title":"Added","text":"<ul> <li>Advanced filters inspired by Django ORM for enhanced querying capabilities.</li> <li>Optional bulk operations for update and delete methods.</li> <li>Custom soft delete mechanisms integrated into <code>FastCRUD</code>, <code>EndpointCreator</code>, and <code>crud_router</code>.</li> <li>Comprehensive test suite for the newly introduced features.</li> </ul>"},{"location":"changelog/#detailed-changes_14","title":"Detailed Changes","text":""},{"location":"changelog/#advanced-filters_1","title":"Advanced Filters","text":"<p>The advanced filtering system allows for sophisticated querying with support for operators like <code>__gt</code>, <code>__lt</code>, <code>__gte</code>, and <code>__lte</code>, applicable across various CRUD operations. This feature significantly enhances the flexibility and power of data retrieval and manipulation within FastCRUD. Docs here.</p>"},{"location":"changelog/#examples","title":"Examples:","text":"<ul> <li>Utilization of advanced filters for precise data fetching and aggregation.</li> <li>Implementation examples for fetching records within specific criteria and counting records based on date ranges.</li> </ul>"},{"location":"changelog/#custom-soft-delete-mechanisms","title":"Custom Soft Delete Mechanisms","text":"<p>FastCRUD's soft delete functionality now supports customization, allowing developers to specify alternative column names for <code>is_deleted</code> and <code>deleted_at</code> fields. This adaptation enables seamless integration with existing database schemas that employ different naming conventions for soft deletion tracking. Docs here.</p>"},{"location":"changelog/#example-configuration_1","title":"Example Configuration:","text":"<ul> <li>Setting up <code>crud_router</code> with custom soft delete column names, demonstrating the flexibility in adapting FastCRUD to various database schema requirements.</li> </ul>"},{"location":"changelog/#bulk-operations","title":"Bulk Operations","text":"<p>The introduction of optional bulk operations for updating and deleting records provides a more efficient way to handle large datasets, enabling mass modifications or removals with single method calls. This feature is particularly useful for applications that require frequent bulk data management tasks. Docs here.</p>"},{"location":"changelog/#examples_1","title":"Examples:","text":"<ul> <li>Demonstrating bulk update and delete operations, highlighting the capability to apply changes to multiple records based on specific criteria.</li> </ul>"},{"location":"changelog/#whats-changed_12","title":"What's Changed","text":"<ul> <li>Addition of advanced filters, bulk operations, and custom soft delete functionalities.</li> </ul>"},{"location":"changelog/#new-contributors_6","title":"New Contributors","text":"<ul> <li>@YuriiMotov</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#040-jan-31-2024","title":"[0.4.0] - Jan 31, 2024","text":""},{"location":"changelog/#added_16","title":"Added","text":"<ul> <li>Documentation and tests for SQLModel support.</li> <li><code>py.typed</code> file for better typing support.</li> </ul>"},{"location":"changelog/#detailed","title":"Detailed","text":"<p>Check the docs for SQLModel support.</p>"},{"location":"changelog/#whats-changed_13","title":"What's Changed","text":"<ul> <li>SQLModel support.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#030-jan-28-2024","title":"[0.3.0] - Jan 28, 2024","text":""},{"location":"changelog/#added_17","title":"Added","text":"<ul> <li>The <code>CustomEndpointCreator</code> for advanced route creation and customization.</li> <li>The ability to selectively include or exclude CRUD operations in the <code>crud_router</code> using <code>included_methods</code> and <code>deleted_methods</code>.</li> <li>Comprehensive tests for the new features.</li> <li>Detailed documentation on utilizing the <code>CustomEndpointCreator</code> and selectively including or excluding endpoints.</li> </ul>"},{"location":"changelog/#customendpointcreator","title":"CustomEndpointCreator","text":"<p>This feature introduces the capability to extend the <code>EndpointCreator</code> class, enabling developers to define custom routes and incorporate complex logic into API endpoints. The documentation has been updated to include detailed examples and guidelines on implementing and using <code>CustomEndpointCreator</code> in projects. Docs here.</p>"},{"location":"changelog/#selective-crud-operations","title":"Selective CRUD Operations","text":"<p>The <code>crud_router</code> function has been enhanced with <code>included_methods</code> and <code>deleted_methods</code> parameters, offering developers precise control over which CRUD methods are included or excluded when configuring routers. This addition provides flexibility in API design, allowing for the creation of tailored endpoint setups that meet specific project requirements. Docs here.</p>"},{"location":"changelog/#detailed-changes_15","title":"Detailed Changes","text":""},{"location":"changelog/#extending-endpointcreator","title":"Extending EndpointCreator","text":"<p>Developers can now create a subclass of <code>EndpointCreator</code> to define custom routes or override existing methods, adding a layer of flexibility and customization to FastCRUD's routing capabilities.</p>"},{"location":"changelog/#creating-a-custom-endpointcreator","title":"Creating a Custom EndpointCreator","text":"<p>An example demonstrates how to subclass <code>EndpointCreator</code> and add custom routes or override existing methods, further illustrating how to incorporate custom endpoint logic and route configurations into the FastAPI application.</p>"},{"location":"changelog/#adding-custom-routes","title":"Adding Custom Routes","text":"<p>The process involves overriding the <code>add_routes_to_router</code> method to include both standard CRUD routes and custom routes, showcasing how developers can extend FastCRUD's functionality to suit their application's unique needs.</p>"},{"location":"changelog/#using-the-custom-endpointcreator","title":"Using the Custom EndpointCreator","text":"<p>An example highlights how to use the custom <code>EndpointCreator</code> with <code>crud_router</code>, specifying selective methods to be included in the router setup, thereby demonstrating the practical application of custom endpoint creation and selective method inclusion.</p>"},{"location":"changelog/#selective-crud-operations_1","title":"Selective CRUD Operations","text":"<p>Examples for using <code>included_methods</code> and <code>deleted_methods</code> illustrate how to specify exactly which CRUD methods should be included or excluded when setting up the router, offering developers precise control over their API's exposed functionality.</p> <p>Warning</p> <p>Providing both <code>included_methods</code> and <code>deleted_methods</code> will result in a ValueError.</p> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#021-jan-27-2024","title":"[0.2.1] - Jan 27, 2024","text":""},{"location":"changelog/#whats-changed_14","title":"What's Changed","text":"<ul> <li>Improved type hints across the codebase, enhancing the clarity and reliability of type checking within FastCRUD.</li> <li>Documentation has been thoroughly updated and refined, including fixes for previous inaccuracies and the addition of more detailed explanations and examples.</li> <li>Descriptions have been added to automatically generated endpoints, making the API documentation more informative and user-friendly.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#020-jan-25-2024","title":"[0.2.0] - Jan 25, 2024","text":""},{"location":"changelog/#added_18","title":"Added","text":"<ul> <li>Docs Published!</li> </ul>"},{"location":"changelog/#015-jan-24-2024","title":"[0.1.5] - Jan 24, 2024","text":"<p>Readme updates, pyproject requirements</p>"},{"location":"changelog/#012-jan-23-2024","title":"[0.1.2] - Jan 23, 2024","text":"<p>First public release.</p>"},{"location":"installing/","title":"Installing","text":""},{"location":"installing/#requirements","title":"Requirements","text":"<p>Before installing FastCRUD, ensure you have the following prerequisites:</p> <ul> <li>Python: Version 3.9 or newer.</li> <li>FastAPI: FastCRUD is built to work with FastAPI, so having FastAPI in your project is essential.</li> <li>SQLAlchemy or SQLModel: FastCRUD uses SQLAlchemy 2.0 for database operations, so you need SQLAlchemy 2.0 or newer or SQLModel 0.14 or newer.</li> <li>Pydantic V2 or SQLModel: FastCRUD leverages Pydantic models for data validation and serialization, so you need Pydantic 2.0 or newer or SQLModel 0.14 or newer.</li> </ul>"},{"location":"installing/#installing","title":"Installing","text":"<p>To install, just run:</p> <pre><code>pip install fastcrud\n</code></pre> <p>Or, if using poetry:</p> <pre><code>poetry add fastcrud\n</code></pre>"},{"location":"quick-start/","title":"Quick-Start","text":"<p>If you are using SQLModel, go to Using SQLModel instead.</p>"},{"location":"quick-start/#minimal-example","title":"Minimal Example","text":"<p>Assuming you have your SQLAlchemy model, Pydantic schemas and database connection, just skip to Using FastCRUD</p>"},{"location":"quick-start/#basic-setup","title":"Basic Setup","text":"<p>Define your SQLAlchemy model</p> setup.py<pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Then your Pydantic schemas</p> setup.py<pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>And, finally, your database connection</p> setup.py<pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre>"},{"location":"quick-start/#using-fastcrud","title":"Using FastCRUD","text":"<p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> main.py<pre><code>from fastcrud import crud_router\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=session,\n    model=Item,\n    create_schema=ItemSchema,\n    update_schema=ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>And it's all done, just go to <code>/docs</code> and the crud endpoints are created.</p>"},{"location":"sqlmodel/","title":"Using FastCRUD with SQLModel","text":"<p>Since SQLModel is just a combination of SQLAlchemy and Pydantic, the process simplifies as SQLModel combines the model and schema definitions.</p> <p>Wherever in the docs you see a SQLAlchemy model or Pydantic schema being used, you may just replace it with SQLModel and it will work. For the quick start:</p> <p>Define your SQLModel model</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Then your schemas</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>And, finally, your database connection</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> main.py<pre><code>from fastcrud import crud_router\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=ItemSchema,\n    update_schema=ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>By following the above setup, FastCRUD auto-generates CRUD endpoints for your model, accessible through the <code>/docs</code> route of your FastAPI application.</p>"},{"location":"advanced/crud/","title":"Advanced Use of FastCRUD","text":"<p>FastCRUD offers a flexible and powerful approach to handling CRUD operations in FastAPI applications, leveraging the SQLAlchemy ORM. Beyond basic CRUD functionality, FastCRUD provides advanced features like <code>allow_multiple</code> for updates and deletes, and support for advanced filters (e.g., less than, greater than). These features enable more complex and fine-grained data manipulation and querying capabilities.</p>"},{"location":"advanced/crud/#typing-options-for-fastcrud","title":"Typing Options for <code>FastCRUD</code>","text":"<p>Note that when initializing <code>FastCRUD</code>, assuming you have a model like:</p> Simplified <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <p>Warning</p> <p>Note that naive <code>datetime</code> such as <code>datetime.utcnow</code> is not supported by <code>FastCRUD</code> as it was deprecated.</p> <p>Use timezone aware <code>datetime</code>, such as <code>datetime.now(UTC)</code> instead.</p> <p>You could just pass it to <code>FastCRUD</code>:</p> <pre><code>from fastcrud import FastCRUD\n\nuser_crud = FastCRUD(User)\n</code></pre> <p>But you also may want a more robust typing, for that purpose, you may also pass the relevant pydantic schemas in the following way:</p> Simplified <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <pre><code>from .user.model import User\nfrom .user.schemas import CreateUserSchema, ReadUserSchema, UpdateUserSchema, DeleteUserSchema\n\n# Just pass None if you don't have one of the schemas\nUserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\n</code></pre> <p>Then you can initialize <code>UserCRUD</code> like you would any <code>FastCRUD</code> instance, but with the relevant types:</p> <pre><code>from .user.model import User\n\nuser_crud = UserCRUD(User)\n</code></pre>"},{"location":"advanced/crud/#allow-multiple-updates-and-deletes","title":"Allow Multiple Updates and Deletes","text":"<p>One of FastCRUD's advanced features is the ability to update or delete multiple records at once based on specified conditions. This is particularly useful for batch operations where you need to modify or remove several records that match certain criteria.</p>"},{"location":"advanced/crud/#updating-multiple-records","title":"Updating Multiple Records","text":"<p>To update multiple records, you can set the <code>allow_multiple=True</code> parameter in the <code>update</code> method. This allows FastCRUD to apply the update to all records matching the given filters.</p> <pre><code># Assuming setup for FastCRUD instance `item_crud` and SQLAlchemy async session `db`\n\n# Update all items priced below $10 to a new price\nawait item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    allow_multiple=True,\n    price__lt=10,\n)\n</code></pre>"},{"location":"advanced/crud/#deleting-multiple-records","title":"Deleting Multiple Records","text":"<p>Similarly, you can delete multiple records by using the <code>allow_multiple=True</code> parameter in the <code>delete</code> or <code>db_delete</code> method, depending on whether you're performing a soft or hard delete.</p> <pre><code># Soft delete all items not sold in the last year\nawait item_crud.delete(\n    db=db,\n    allow_multiple=True,\n    last_sold__lt=datetime.datetime.now() - datetime.timedelta(days=365),\n)\n</code></pre>"},{"location":"advanced/crud/#advanced-filters","title":"Advanced Filters","text":"<p>FastCRUD supports advanced filtering options, allowing you to query records using operators such as greater than (<code>__gt</code>), less than (<code>__lt</code>), and their inclusive counterparts (<code>__gte</code>, <code>__lte</code>). These filters can be used in any method that retrieves or operates on records, including <code>get</code>, <code>get_multi</code>, <code>exists</code>, <code>count</code>, <code>update</code>, and <code>delete</code>.</p>"},{"location":"advanced/crud/#single-parameter-filters","title":"Single parameter filters","text":"<p>Most filter operators require a single string or integer value.</p> <pre><code># Fetch items priced between above $5\nitems = await item_crud.get_multi(\n    db=db,\n    price__gte=5,\n)\n</code></pre> <p>Currently supported single parameter filters are:</p> <ul> <li><code>__gt</code> - greater than</li> <li><code>__lt</code> - less than</li> <li><code>__gte</code> - greater than or equal to</li> <li><code>__lte</code> - less than or equal to</li> <li><code>__ne</code> - not equal</li> <li><code>__is</code> - used to test True, False and None identity</li> <li><code>__is_not</code> - negation of \"is\"</li> <li><code>__like</code> - SQL \"like\" search for specific text pattern</li> <li><code>__notlike</code> - negation of \"like\"</li> <li><code>__ilike</code> - case insensitive \"like\"</li> <li><code>__notilike</code> - case insensitive \"notlike\"</li> <li><code>__startswith</code> - text starts with given string</li> <li><code>__endswith</code> - text ends with given string</li> <li><code>__contains</code> - text contains given string</li> <li><code>__match</code> - database-specific match expression</li> </ul>"},{"location":"advanced/crud/#complex-parameter-filters","title":"Complex parameter filters","text":"<p>Some operators require multiple values. They must be passed as a python tuple, list or set.</p> <pre><code># Fetch items priced between $5 and $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__between=(5, 20),\n)\n</code></pre> <ul> <li><code>__between</code> - between 2 numeric values</li> <li><code>__in</code> - included in</li> <li><code>__not_in</code> - not included in</li> </ul>"},{"location":"advanced/crud/#or-clauses","title":"OR clauses","text":"<p>More complex OR filters are supported. They must be passed as dictionary, where each key is a library-supported operator to be used in OR expression and values is what get's passed as the parameter.</p> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre>"},{"location":"advanced/crud/#and-clauses","title":"AND clauses","text":"<p>AND clauses can be achieved by chaining multiple filters together.</p> <pre><code># Fetch items priced under $20 and over 2 years of warranty.\nitems = await item_crud.get_multi(\n    db=db,\n    price__lt=20,\n    warranty_years__gt=2,\n)\n</code></pre>"},{"location":"advanced/crud/#counting-records","title":"Counting Records","text":"<pre><code># Count items created in the last month\nitem_count = await item_crud.count(\n    db=db,\n    created_at__gte=datetime.datetime.now() - datetime.timedelta(days=30),\n)\n</code></pre>"},{"location":"advanced/crud/#skipping-database-commit","title":"Skipping Database Commit","text":"<p>For <code>create</code>, <code>update</code>, <code>db_delete</code> and <code>delete</code> methods of <code>FastCRUD</code>, you have the option of passing <code>commit=False</code> so you don't commit the operations immediately.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nawait item_crud.delete(\n    db=db, \n    commit=False, \n    id=1,\n)\n# this will not actually delete until you run a db.commit()\n</code></pre>"},{"location":"advanced/crud/#returning-clause-in-update","title":"Returning clause in <code>update</code>","text":"<p>In <code>update</code> method, you can pass <code>return_columns</code> parameter containing a list of columns you want to return after the update.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nitem = await item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    return_columns=[\"price\"],\n    price__lt=10,\n)\n# this will return the updated price\n</code></pre> <p>You can also pass <code>schema_to_select</code> parameter and <code>return_as_model</code> to return the updated data in the form of a Pydantic schema.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Base, Item\nfrom .item.schemas import ItemSchema\n\nitem_crud = FastCRUD(Item)\n\nitem = await item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n    price__lt=10,\n)\n# this will return the updated data in the form of ItemSchema\n</code></pre>"},{"location":"advanced/crud/#unpaginated-get_multi-and-get_multi_joined","title":"Unpaginated <code>get_multi</code> and <code>get_multi_joined</code>","text":"<p>If you pass <code>None</code> to <code>limit</code> in <code>get_multi</code> and <code>get_multi_joined</code>, you get the whole unpaginated set of data that matches the filters. Use this with caution.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nitems = await item_crud.get_multi(db=db, limit=None)\n# this will return all items in the db\n</code></pre> <p>Caution</p> <p>Be cautious when returning all the data in your database, and you should almost never allow your user API to do this.</p>"},{"location":"advanced/crud/#using-get_joined-and-get_multi_joined-for-multiple-models","title":"Using <code>get_joined</code> and <code>get_multi_joined</code> for multiple models","text":"<p>To facilitate complex data relationships, <code>get_joined</code> and <code>get_multi_joined</code> can be configured to handle joins with multiple models. This is achieved using the <code>joins_config</code> parameter, where you can specify a list of <code>JoinConfig</code> instances, each representing a distinct join configuration.</p>"},{"location":"advanced/crud/#upserting-multiple-records-using-upsert_multi","title":"Upserting multiple records using <code>upsert_multi</code>","text":"<p>FastCRUD provides an <code>upsert_multi</code> method to efficiently upsert multiple records in a single operation. This method is particularly useful when you need to insert new records or update existing ones based on a unique constraint.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\nfrom .item.schemas import CreateItemSchema, ItemSchema\n\nitem_crud = FastCRUD(Item)\nitems = await item_crud.upsert_multi(\n    db=db,\n    instances=[\n        CreateItemSchema(price=9.99),\n    ],\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n# this will return the upserted data in the form of ItemSchema\n</code></pre>"},{"location":"advanced/crud/#customizing-the-update-logic","title":"Customizing the Update Logic","text":"<p>To allow more granular control over the SQL <code>UPDATE</code> operation during an upsert, <code>upsert_multi</code> can accept an <code>update_override</code> argument. This allows for the specification of custom update logic using SQL expressions, like the <code>case</code> statement, to handle complex conditions.</p> <pre><code>from sqlalchemy.sql import case\n\nupdate_override = {\n    \"name\": case(\n        (Item.name.is_(None), stmt.excluded.name),\n        else_=Item.name\n    )\n}\n\nitems = await item_crud.upsert_multi(\n    db=db,\n    instances=[\n        CreateItemSchema(name=\"Gadget\", price=15.99),\n    ],\n    update_override=update_override,\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n</code></pre> <p>In the example above, the <code>name</code> field of the <code>Item</code> model will be updated to the new value only if the existing <code>name</code> field is <code>None</code>. Otherwise, it retains the existing <code>name</code>.</p>"},{"location":"advanced/crud/#example-joining-user-tier-and-department-models","title":"Example: Joining <code>User</code>, <code>Tier</code>, and <code>Department</code> Models","text":"<p>Consider a scenario where you want to retrieve users along with their associated tier and department information. Here's how you can achieve this using <code>get_multi_joined</code>.</p> <p>Start by creating the models and schemas, followed by a description of how they're to be joined:</p> Models and Schemas <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> Join Configurations<pre><code>from fastcrud import JoinConfig\n\njoins_config = [\n    JoinConfig(\n        model=Tier,\n        join_on=User.tier_id == Tier.id,\n        join_prefix=\"tier_\",\n        schema_to_select=ReadTierSchema,\n        join_type=\"left\",\n    ),\n\n    JoinConfig(\n        model=Department,\n        join_on=User.department_id == Department.id,\n        join_prefix=\"dept_\",\n        schema_to_select=ReadDepartmentSchema,\n        join_type=\"inner\",\n    ),\n]\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n    joins_config=joins_config,\n)\n</code></pre> <p>Then just pass this list to <code>joins_config</code>:</p> Passing to get_multi_joined<pre><code>from fastcrud import JoinConfig\n\njoins_config = [\n    ...\n]\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n    joins_config=joins_config,\n)\n</code></pre> <p>In this example, users are joined with the <code>Tier</code> and <code>Department</code> models. The <code>join_on</code> parameter specifies the condition for the join, <code>join_prefix</code> assigns a prefix to columns from the joined models (to avoid naming conflicts), and <code>join_type</code> determines whether it's a left or inner join.</p> <p>Warning</p> <p>If both single join parameters and <code>joins_config</code> are used simultaneously, an error will be raised.</p>"},{"location":"advanced/crud/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through its <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>one-to-one</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"advanced/crud/#one-to-one-joins","title":"One-to-One Joins","text":"<p>One-to-one relationships can be efficiently managed using either <code>get_joined</code> or <code>get_multi_joined</code>. The <code>get_joined</code> method is typically used when you want to fetch a single record from the database along with its associated record from another table, such as a user and their corresponding profile details. If you're retrieving multiple records, <code>get_multi_joined</code> can also be used for one-to-one joins. The parameter that deals with it, <code>relationship_type</code>, defaults to <code>one-on-one</code>.</p>"},{"location":"advanced/crud/#one-to-many-joins","title":"One-to-Many Joins","text":"<p>For one-to-many relationships, where a single record can be associated with multiple records in another table, <code>get_joined</code> can be used with <code>nest_joins</code> set to <code>True</code>. This setup allows the primary record to include a nested list of associated records, making it suitable for scenarios such as retrieving a user and all their blog posts. Alternatively, <code>get_multi_joined</code> is also applicable here for fetching multiple primary records, each with their nested lists of related records.</p> <p>Warning</p> <p>When using <code>nested_joins=True</code>, the performance will always be a bit worse than when using <code>nested_joins=False</code>. For cases where more performance is necessary, consider using <code>nested_joins=False</code> and remodeling your database.</p>"},{"location":"advanced/crud/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul>"},{"location":"advanced/crud/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>For a more detailed explanation, you may check the joins docs.</p>"},{"location":"advanced/crud/#using-aliases","title":"Using aliases","text":"<p>In complex query scenarios, particularly when you need to join a table to itself or perform multiple joins on the same table for different purposes, aliasing becomes crucial. Aliasing allows you to refer to the same table in different contexts with unique identifiers, avoiding conflicts and ambiguity in your queries.</p> <p>For both <code>get_joined</code> and <code>get_multi_joined</code> methods, when you need to join the same model multiple times, you can utilize the <code>alias</code> parameter within your <code>JoinConfig</code> to differentiate between the joins. This parameter expects an instance of <code>AliasedClass</code>, which can be created using the <code>aliased</code> function from SQLAlchemy (also in FastCRUD for convenience).</p>"},{"location":"advanced/crud/#example-joining-the-same-model-multiple-times","title":"Example: Joining the Same Model Multiple Times","text":"<p>Consider a task management application where tasks have both an owner and an assigned user, represented by the same <code>User</code> model. To fetch tasks with details of both users, we use aliases to join the <code>User</code> model twice, distinguishing between owners and assigned users.</p> <p>Let's start by creating the aliases and passing them to the join configuration. Don't forget to use the alias for <code>join_on</code>:</p> Join Configurations with Aliases<pre><code>from fastcrud import FastCRUD, JoinConfig, aliased\n\n# Create aliases for User to distinguish between the owner and the assigned user\nowner_alias = aliased(User, name=\"owner\")\nassigned_user_alias = aliased(User, name=\"assigned_user\")\n\n# Configure joins with aliases\njoins_config = [\n    JoinConfig(\n        model=User,\n        join_on=Task.owner_id == owner_alias.id,\n        join_prefix=\"owner_\",\n        schema_to_select=ReadUserSchema,\n        join_type=\"inner\",\n        alias=owner_alias,  # Pass the aliased class instance\n    ),\n    JoinConfig(\n        model=User,\n        join_on=Task.assigned_user_id == assigned_user_alias.id,\n        join_prefix=\"assigned_\",\n        schema_to_select=ReadUserSchema,\n        join_type=\"inner\",\n        alias=assigned_user_alias,  # Pass the aliased class instance\n    ),\n]\n\n# Initialize your FastCRUD instance for Task\ntask_crud = FastCRUD(Task)\n\n# Fetch tasks with joined user details\ntasks = await task_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadTaskSchema,\n    offset=0,\n    limit=10,\n    joins_config=joins_config,\n)\n</code></pre> <p>Then just pass this <code>joins_config</code> to <code>get_multi_joined</code>:</p> Passing joins_config to get_multi_joined<pre><code>from fastcrud import FastCRUD, JoinConfig, aliased\n\n...\n\n# Configure joins with aliases\njoins_config = [\n    ...\n]\n\n# Initialize your FastCRUD instance for Task\ntask_crud = FastCRUD(Task)\n\n# Fetch tasks with joined user details\ntasks = await task_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadTaskSchema,\n    offset=0,\n    limit=10,\n    joins_config=joins_config,\n)\n</code></pre> <p>In this example, <code>owner_alias</code> and <code>assigned_user_alias</code> are created from <code>User</code> to distinguish between the task's owner and the assigned user within the task management system. By using aliases, you can join the same model multiple times for different purposes in your queries, enhancing expressiveness and eliminating ambiguity.</p>"},{"location":"advanced/crud/#many-to-many-relationships-with-get_multi_joined","title":"Many-to-Many Relationships with <code>get_multi_joined</code>","text":"<p>FastCRUD simplifies dealing with many-to-many relationships by allowing easy fetch operations with joined models. Here, we demonstrate using <code>get_multi_joined</code> to handle a many-to-many relationship between <code>Project</code> and <code>Participant</code> models, linked through an association table.</p> <p>Note on Handling Many-to-Many Relationships:</p> <p>When using <code>get_multi_joined</code> for many-to-many relationships, it's essential to maintain a specific order in your <code>joins_config</code>: </p> <ol> <li>First, specify the main table you're querying from.</li> <li>Next, include the association table that links your main table to the other table involved in the many-to-many relationship.</li> <li>Finally, specify the other table that is connected via the association table.</li> </ol> <p>This order ensures that the SQL joins are structured correctly to reflect the many-to-many relationship and retrieve the desired data accurately.</p> <p>Tip</p> <p>Note that the first one can be the model defined in <code>FastCRUD(Model)</code>.</p> <pre><code># Fetch projects with their participants via a many-to-many relationship\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    ),\n]\n\ncrud_project = FastCRUD(Project)\n\nprojects_with_participants = await project_crud.get_multi_joined(\n    db=db,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n)\n</code></pre> <p>For a more detailed explanation, read this part of the docs.</p>"},{"location":"advanced/crud/#enhanced-query-capabilities-with-method-chaining","title":"Enhanced Query Capabilities with Method Chaining","text":"<p>The <code>select</code> method in FastCRUD is designed for flexibility, enabling you to build complex queries through method chaining.</p>"},{"location":"advanced/crud/#the-select-method","title":"The <code>select</code> Method","text":"<pre><code>async def select(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any\n) -&gt; Selectable\n</code></pre> <p>This method constructs a SQL Alchemy <code>Select</code> statement, offering optional column selection, filtering, and sorting. It's designed for flexibility, allowing you to chain additional SQLAlchemy methods for even more complex queries.</p>"},{"location":"advanced/crud/#features","title":"Features:","text":"<ul> <li>Column Selection: Specify columns with a Pydantic schema.</li> <li>Sorting: Define one or more columns for sorting, along with their sort order.</li> <li>Filtering: Apply filters directly through keyword arguments.</li> <li>Chaining: Chain with other SQLAlchemy methods for advanced query construction.</li> </ul>"},{"location":"advanced/crud/#usage-example","title":"Usage Example:","text":"<pre><code>class ReadMyModelSchema(BaseModel):\n    id: int\n    name: str | None = None\n    archived: bool\n    archived_at: datetime.datetime\n    date_updated: datetime.datetime\n\n\nstmt = await my_model_crud.select(\n    schema_to_select=ReadMyModelSchema,\n    sort_columns='name',\n    name__like='%example%',\n)\nstmt = stmt.where(additional_conditions).limit(10)\nresults = await db.execute(stmt)\n</code></pre> <p>This example demonstrates selecting a subset of columns, applying a filter, and chaining additional conditions like <code>where</code> and <code>limit</code>. Note that <code>select</code> returns a <code>Select</code> object, allowing for further modifications before execution.</p>"},{"location":"advanced/crud/#conclusion","title":"Conclusion","text":"<p>The advanced features of FastCRUD, such as <code>allow_multiple</code> and support for advanced filters, empower developers to efficiently manage database records with complex conditions. By leveraging these capabilities, you can build more dynamic, robust, and scalable FastAPI applications that effectively interact with your data model.</p>"},{"location":"advanced/endpoint/","title":"Advanced Use of EndpointCreator","text":""},{"location":"advanced/endpoint/#available-automatic-endpoints","title":"Available Automatic Endpoints","text":"<p>FastCRUD automates the creation of CRUD (Create, Read, Update, Delete) endpoints for your FastAPI application. Here's an overview of the available automatic endpoints and how they work, based on the automatic endpoints we've generated before:</p>"},{"location":"advanced/endpoint/#create","title":"Create","text":"<ul> <li>Endpoint: <code>/{model}</code></li> <li>Method: <code>POST</code></li> <li>Description: Creates a new item in the database.</li> <li>Request Body: JSON object based on the <code>create_schema</code>.</li> <li>Example Request: <code>POST /items</code> with JSON body.</li> </ul>"},{"location":"advanced/endpoint/#read","title":"Read","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>GET</code></li> <li>Description: Retrieves a single item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to retrieve.</li> <li>Example Request: <code>GET /items/1</code>.</li> <li>Example Return: <pre><code>{\n    \"id\": 1,\n    \"name\": \"Item 1\",\n    \"description\": \"Description of item 1\",\n    \"category\": \"Movies\",\n    \"price\": 5.99,\n    \"last_sold\": null,\n    \"created_at\": \"2024-01-01 12:00:00\"\n}\n</code></pre></li> </ul>"},{"location":"advanced/endpoint/#read-multiple","title":"Read Multiple","text":"<ul> <li>Endpoint: <code>/{model}</code></li> <li>Method: <code>GET</code></li> <li>Description: Retrieves multiple items with optional pagination.</li> <li>Query Parameters:<ul> <li><code>offset</code> (optional): The offset from where to start fetching items.</li> <li><code>limit</code> (optional): The maximum number of items to return.</li> <li><code>page</code> (optional): The page number, starting from 1.</li> <li><code>itemsPerPage</code> (optional): The number of items per page.</li> </ul> </li> <li>Example Request: <code>GET /items?offset=3&amp;limit=4</code>.</li> <li>Example Return: <pre><code>{\n  \"data\": [\n    {\n        \"id\": 4,\n        \"name\": \"Item 4\",\n        \"description\": \"Description of item 4\",\n        \"category\": \"Books\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:01:00\"\n    },\n    {\n        \"id\": 5,\n        \"name\": \"Item 5\",\n        \"description\": \"Description of item 5\",\n        \"category\": \"Music\",\n        \"price\": 5.99,\n        \"last_sold\": \"2024-04-01 00:00:00\",\n        \"created_at\": \"2024-01-01 12:10:00\"\n    },\n    {\n        \"id\": 6,\n        \"name\": \"Item 6\",\n        \"description\": \"Description of item 6\",\n        \"category\": \"TV\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:15:00\"\n    },\n    {\n        \"id\": 7,\n        \"name\": \"Item 7\",\n        \"description\": \"Description of item 7\",\n        \"category\": \"Books\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 13:00:30\"\n    }\n  ],\n  \"total_count\": 50\n}\n</code></pre></li> <li>Example Paginated Request: <code>GET /items?page=1&amp;itemsPerPage=3</code>.</li> <li>Example Paginated Return: <pre><code>{\n  \"data\": [\n    {\n        \"id\": 1,\n        \"name\": \"Item 1\",\n        \"description\": \"Description of item 1\",\n        \"category\": \"Movies\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:01\"\n    },\n    {\n        \"id\": 2,\n        \"name\": \"Item 2\",\n        \"description\": \"Description of item 2\",\n        \"category\": \"TV\",\n        \"price\": 19.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:15\"\n    },\n    {\n        \"id\": 3,\n        \"name\": \"Item 3\",\n        \"description\": \"Description of item 3\",\n        \"category\": \"Books\",\n        \"price\": 4.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:16\"\n    }\n  ],\n  \"total_count\": 50,\n  \"has_more\": true,\n  \"page\": 1,\n  \"items_per_page\": 3\n}\n</code></pre></li> </ul> <p>Note</p> <p><code>_read_paginated</code> endpoint was deprecated and mixed into <code>_read_items</code> in the release <code>0.15.0</code>. Simple <code>_read_items</code> behaviour persists with no breaking changes.</p> <p>Read items paginated: <pre><code>$ curl -X 'GET' \\\n  'http://localhost:8000/users?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre></p> <p>Read items unpaginated: <pre><code>$ curl -X 'GET' \\\n  'http://localhost:8000/users?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre></p>"},{"location":"advanced/endpoint/#update","title":"Update","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>PATCH</code></li> <li>Description: Updates an existing item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to update.</li> <li>Request Body: JSON object based on the <code>update_schema</code>.</li> <li>Example Request: <code>PATCH /items/1</code> with JSON body.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#delete","title":"Delete","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>DELETE</code></li> <li>Description: Deletes (soft delete if configured) an item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to delete.</li> <li>Example Request: <code>DELETE /items/1</code>.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#db-delete-hard-delete","title":"DB Delete (Hard Delete)","text":"<ul> <li>Endpoint: <code>/{model}/db_delete/{id}</code> (Available if a <code>delete_schema</code> is provided)</li> <li>Method: <code>DELETE</code></li> <li>Description: Permanently deletes an item by its ID, bypassing the soft delete mechanism.</li> <li>Path Parameters: <code>id</code> - The ID of the item to hard delete.</li> <li>Example Request: <code>DELETE /items/db_delete/1</code>.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#selective-crud-operations","title":"Selective CRUD Operations","text":"<p>You can control which CRUD operations are exposed by using <code>included_methods</code> and <code>deleted_methods</code>. These parameters allow you to specify exactly which CRUD methods should be included or excluded when setting up the router. By default, all CRUD endpoints are included.</p> <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n</code></pre>"},{"location":"advanced/endpoint/#using-included_methods","title":"Using <code>included_methods</code>","text":"<p>Using <code>included_methods</code> you may define exactly the methods you want to be included.</p> <pre><code># Using crud_router with selective CRUD methods\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\", \"update\"],  # Only these methods will be included\n)\n\napp.include_router(my_router)\n</code></pre>"},{"location":"advanced/endpoint/#using-deleted_methods","title":"Using <code>deleted_methods</code>","text":"<p>Using <code>deleted_methods</code> you define the methods that will not be included.</p> <pre><code># Using crud_router with selective CRUD methods\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    deleted_methods=[\"update\", \"delete\"],  # All but these methods will be included\n)\n\napp.include_router(my_router)\n</code></pre> <p>Warning</p> <p>If <code>included_methods</code> and <code>deleted_methods</code> are both provided, a <code>ValueError</code> will be raised.</p>"},{"location":"advanced/endpoint/#customizing-endpoint-names","title":"Customizing Endpoint Names","text":"<p>You can customize the names of the auto generated endpoints by passing an <code>endpoint_names</code> dictionary when initializing the <code>EndpointCreator</code> or calling the <code>crud_router</code> function. This dictionary should map the CRUD operation names (<code>create</code>, <code>read</code>, <code>update</code>, <code>delete</code>, <code>db_delete</code>, <code>read_multi</code>) to your desired endpoint names.</p>"},{"location":"advanced/endpoint/#example-using-crud_router","title":"Example: Using <code>crud_router</code>","text":"<p>Here's how you can customize endpoint names using the <code>crud_router</code> function:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\n# Custom endpoint names\ncustom_endpoint_names = {\n    \"create\": \"add\",\n    \"read\": \"fetch\",\n    \"update\": \"modify\",\n    \"delete\": \"remove\",\n    \"read_multi\": \"list\",\n}\n\n# Setup CRUD router with custom endpoint names\napp.include_router(crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names=custom_endpoint_names,\n))\n</code></pre> <p>In this example, the standard CRUD endpoints will be replaced with <code>/add</code>, <code>/fetch/{id}</code>, <code>/modify/{id}</code>, <code>/remove/{id}</code>, <code>/list</code>, and <code>/paginate</code>.</p>"},{"location":"advanced/endpoint/#example-using-endpointcreator","title":"Example: Using <code>EndpointCreator</code>","text":"<p>If you are using <code>EndpointCreator</code>, you can also pass the <code>endpoint_names</code> dictionary to customize the endpoint names similarly:</p> <pre><code># Custom endpoint names\ncustom_endpoint_names = {\n    \"create\": \"add_new\",\n    \"read\": \"get_single\",\n    \"update\": \"change\",\n    \"delete\": \"erase\",\n    \"db_delete\": \"hard_erase\",\n    \"read_multi\": \"get_all\",\n    \"read_paginated\": \"get_page\",\n}\n\n# Initialize and use the custom EndpointCreator\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names=custom_endpoint_names,\n)\n\nendpoint_creator.add_routes_to_router()\napp.include_router(endpoint_creator.router)\n</code></pre> <p>Tip</p> <p>You only need to pass the names of the endpoints you want to change in the <code>endpoint_names</code> <code>dict</code>.</p> <p>Note</p> <p><code>default_endpoint_names</code> for <code>EndpointCreator</code> were changed to empty strings in <code>0.15.0</code>. See this issue for more details.</p>"},{"location":"advanced/endpoint/#extending-endpointcreator","title":"Extending <code>EndpointCreator</code>","text":"<p>You can create a subclass of <code>EndpointCreator</code> and override or add new methods to define custom routes. Here's an example:</p>"},{"location":"advanced/endpoint/#creating-a-custom-endpointcreator","title":"Creating a Custom <code>EndpointCreator</code>","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#adding-custom-routes","title":"Adding custom routes","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#overriding-add_routes_to_router","title":"Overriding <code>add_routes_to_router</code>","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#using-the-custom-endpointcreator","title":"Using the Custom EndpointCreator","text":"<pre><code># Assuming MyCustomEndpointCreator was created\n\n...\n\n# Use the custom EndpointCreator with crud_router\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\", \"update\"],  # Including selective methods\n    endpoint_creator=MyCustomEndpointCreator,\n)\n\napp.include_router(my_router)\n</code></pre>"},{"location":"advanced/endpoint/#custom-soft-delete","title":"Custom Soft Delete","text":"<p>To implement custom soft delete columns using <code>EndpointCreator</code> and <code>crud_router</code> in FastCRUD, you need to specify the names of the columns used for indicating deletion status and the deletion timestamp in your model. FastCRUD provides flexibility in handling soft deletes by allowing you to configure these column names directly when setting up CRUD operations or API endpoints.</p> <p>Here's how to specify custom soft delete columns when utilizing <code>EndpointCreator</code> and <code>crud_router</code>:</p>"},{"location":"advanced/endpoint/#defining-models-with-custom-soft-delete-columns","title":"Defining Models with Custom Soft Delete Columns","text":"<p>First, ensure your SQLAlchemy model is equipped with the custom soft delete columns. Here's an example model with custom columns for soft deletion:</p> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    archived = Column(Boolean, default=False)  # Custom soft delete column\n    archived_at = Column(DateTime)  # Custom timestamp column for soft delete\n</code></pre> <p>And a schema necessary to activate the soft delete endpoint:</p> <pre><code>class DeleteMyModelSchema(BaseModel):\n    pass\n</code></pre>"},{"location":"advanced/endpoint/#using-endpointcreator-and-crud_router-with-custom-soft-delete-or-update-columns","title":"Using <code>EndpointCreator</code> and <code>crud_router</code> with Custom Soft Delete or Update Columns","text":"<p>When initializing <code>crud_router</code> or creating a custom <code>EndpointCreator</code>, you can pass the names of your custom soft delete columns through the <code>FastCRUD</code> initialization. This informs FastCRUD which columns to check and update for soft deletion operations.</p> <p>Here's an example of using <code>crud_router</code> with custom soft delete columns:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\napp = FastAPI()\n\n# Assuming async_session is your AsyncSession generator\n# and MyModel is your SQLAlchemy model\n\n# Initialize FastCRUD with custom soft delete columns\nmy_model_crud = FastCRUD(\n    MyModel,\n    is_deleted_column='archived',  # Custom 'is_deleted' column name\n    deleted_at_column='archived_at',  # Custom 'deleted_at' column name\n)\n\n# Setup CRUD router with the FastCRUD instance\napp.include_router(crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=my_model_crud,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n))\n</code></pre> <p>You may also directly pass the names of the columns to <code>crud_router</code> or <code>EndpointCreator</code>:</p> <pre><code>app.include_router(endpoint_creator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    is_deleted_column='archived',\n    deleted_at_column='archived_at',\n))\n</code></pre> <p>This setup ensures that the soft delete functionality within your application utilizes the <code>archived</code> and <code>archived_at</code> columns for marking records as deleted, rather than the default <code>is_deleted</code> and <code>deleted_at</code> fields.</p> <p>By specifying custom column names for soft deletion, you can adapt FastCRUD to fit the design of your database models, providing a flexible solution for handling deleted records in a way that best suits your application's needs.</p> <p>You can also customize your <code>updated_at</code> column:</p> <pre><code>class MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    archived = Column(Boolean, default=False)  # Custom soft delete column\n    archived_at = Column(DateTime)  # Custom timestamp column for soft delete\n    date_updated = Column(DateTime)  # Custom timestamp column for update\n\n\napp.include_router(endpoint_creator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    is_deleted_column='archived',\n    deleted_at_column='archived_at',\n    updated_at_column='date_updated',\n))\n</code></pre>"},{"location":"advanced/endpoint/#using-filters-in-fastcrud","title":"Using Filters in FastCRUD","text":"<p>FastCRUD provides filtering capabilities, allowing you to filter query results based on various conditions. Filters can be applied to <code>read_multi</code> endpoint. This section explains how to configure and use filters in FastCRUD.</p>"},{"location":"advanced/endpoint/#defining-filters","title":"Defining Filters","text":"<p>Filters are either defined using the <code>FilterConfig</code> class or just passed as a dictionary. This class allows you to specify default filter values and validate filter types. Here's an example of how to define filters for a model:</p> <pre><code>from fastcrud import FilterConfig\n\n# Define filter configuration for a model\nfilter_config = FilterConfig(\n    tier_id=None,  # Default filter value for tier_id\n    name=None,  # Default filter value for name\n)\n</code></pre> <p>And the same thing using a <code>dict</code>: <pre><code>filter_config = {\n    \"tier_id\": None,  # Default filter value for tier_id\n    \"name\": None,  # Default filter value for name\n}\n</code></pre></p> <p>By using <code>FilterConfig</code> you get better error messages.</p>"},{"location":"advanced/endpoint/#applying-filters-to-endpoints","title":"Applying Filters to Endpoints","text":"<p>You can apply filters to your endpoints by passing the <code>filter_config</code> to the <code>crud_router</code> or <code>EndpointCreator</code>. Here's an example:</p> <pre><code>from fastcrud import crud_router\n\nfrom .database import async_session\nfrom .yourmodel.model import YourModel\nfrom .yourmodel.schemas import CreateYourModelSchema, UpdateYourModelSchema\n\n# Apply filters using crud_router\napp.include_router(\n    crud_router(\n        session=async_session,\n        model=YourModel,\n        create_schema=CreateYourModelSchema,\n        update_schema=UpdateYourModelSchema,\n        path=\"/yourmodel\",\n        tags=[\"YourModel\"],\n        filter_config=filter_config,  # Apply the filter configuration\n    ),\n)\n</code></pre>"},{"location":"advanced/endpoint/#using-filters-in-requests","title":"Using Filters in Requests","text":"<p>Once filters are configured, you can use them in your API requests. Filters are passed as query parameters. Here's an example of how to use filters in a request to a paginated endpoint:</p> <pre><code>GET /yourmodel?page=1&amp;itemsPerPage=3&amp;tier_id=1&amp;name=Alice\n</code></pre>"},{"location":"advanced/endpoint/#custom-filter-validation","title":"Custom Filter Validation","text":"<p>The <code>FilterConfig</code> class includes a validator to check filter types. If an invalid filter type is provided, a <code>ValueError</code> is raised. You can customize the validation logic by extending the <code>FilterConfig</code> class:</p> <pre><code>from fastcrud import FilterConfig\nfrom pydantic import ValidationError\n\nclass CustomFilterConfig(FilterConfig):\n    @field_validator(\"filters\")\n    def check_filter_types(cls, filters: dict[str, Any]) -&gt; dict[str, Any]:\n        for key, value in filters.items():\n            if not isinstance(value, (type(None), str, int, float, bool)):\n                raise ValueError(f\"Invalid default value for '{key}': {value}\")\n        return filters\n\ntry:\n    # Example of invalid filter configuration\n    invalid_filter_config = CustomFilterConfig(invalid_field=[])\nexcept ValidationError as e:\n    print(e)\n</code></pre>"},{"location":"advanced/endpoint/#handling-invalid-filter-columns","title":"Handling Invalid Filter Columns","text":"<p>FastCRUD ensures that filters are applied only to valid columns in your model. If an invalid filter column is specified, a <code>ValueError</code> is raised:</p> <pre><code>try:\n    # Example of invalid filter column\n    invalid_filter_config = FilterConfig(non_existent_column=None)\nexcept ValueError as e:\n    print(e)  # Output: Invalid filter column 'non_existent_column': not found in model\n</code></pre>"},{"location":"advanced/endpoint/#conclusion","title":"Conclusion","text":"<p>The <code>EndpointCreator</code> class in FastCRUD offers flexibility and control over CRUD operations and custom endpoint creation. By extending this class or using the <code>included_methods</code> and <code>deleted_methods</code> parameters, you can tailor your API's functionality to your specific requirements, ensuring a more customizable and streamlined experience.</p>"},{"location":"advanced/joins/","title":"Comprehensive Guide to Joins in FastCRUD","text":"<p>FastCRUD simplifies CRUD operations while offering capabilities for handling complex data relationships. This guide thoroughly explores the use of <code>JoinConfig</code> for executing join operations in FastCRUD methods such as <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code>, alongside simplified join techniques for straightforward scenarios.</p>"},{"location":"advanced/joins/#understanding-joinconfig","title":"Understanding <code>JoinConfig</code>","text":"<p><code>JoinConfig</code> is a detailed configuration mechanism for specifying joins between models in FastCRUD queries. It contains the following key attributes:</p> <ul> <li><code>model</code>: The SQLAlchemy model to join.</li> <li><code>join_on</code>: The condition defining how the join connects to other models.</li> <li><code>join_prefix</code>: An optional prefix for the joined columns to avoid column name conflicts.</li> <li><code>schema_to_select</code>: An optional Pydantic schema for selecting specific columns from the joined model.</li> <li><code>join_type</code>: The type of join (e.g., <code>\"left\"</code>, <code>\"inner\"</code>).</li> <li><code>alias</code>: An optional SQLAlchemy <code>AliasedClass</code> for complex scenarios like self-referential joins or multiple joins on the same model.</li> <li><code>filters</code>: An optional dictionary to apply filters directly to the joined model.</li> <li><code>relationship_type</code>: Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Default is <code>\"one-to-one\"</code>.</li> </ul> <p>Tip</p> <p>For <code>\"many-to-many\"</code>, you don't need to pass a <code>relationship_type</code>.</p>"},{"location":"advanced/joins/#applying-joins-in-fastcrud-methods","title":"Applying Joins in FastCRUD Methods","text":"Models - <code>Tier</code>, <code>Department</code>, <code>User</code>, <code>Story</code>, <code>Task</code> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre>"},{"location":"advanced/joins/#the-count-method-with-joins","title":"The <code>count</code> Method with Joins","text":"<p>The <code>count</code> method can be enhanced with join operations to perform complex aggregate queries. While <code>count</code> primarily returns the number of records matching a given condition, introducing joins allows for counting records across related models based on specific relationships and conditions.</p>"},{"location":"advanced/joins/#using-joinconfig","title":"Using <code>JoinConfig</code>","text":"<p>For join requirements, the <code>count</code> method can be invoked with join parameters passed as a list of <code>JoinConfig</code> to the <code>joins_config</code> parameter:</p> <pre><code>from fastcrud import JoinConfig\n\ntask_crud = FastCRUD(Task)\n\n# Count the number of tasks assigned to users in a specific department\ntask_count = await task_crud.count(\n    db=db,\n    joins_config=[\n        JoinConfig(\n            model=User, \n            join_on=Task.assigned_user_id == User.id,\n        ),\n        JoinConfig(\n            model=Department, \n            join_on=User.department_id == Department.id, \n            filters={\"name\": \"Engineering\"},\n        ),\n    ],\n)\n</code></pre>"},{"location":"advanced/joins/#fetching-data-with-get_joined-and-get_multi_joined","title":"Fetching Data with <code>get_joined</code> and <code>get_multi_joined</code>","text":"<p>These methods are essential for retrieving records from a primary model while including related data from one or more joined models. They support both simple and complex joining scenarios, including self-referential joins and many-to-many relationships.</p>"},{"location":"advanced/joins/#simple-joins-using-base-parameters","title":"Simple Joins Using Base Parameters","text":"<p>For simpler join requirements, FastCRUD allows specifying join parameters directly:</p> <ul> <li><code>join_model</code>: The target model to join.</li> <li><code>join_on</code>: The join condition.</li> <li><code>join_prefix</code>: Optional prefix for columns from the joined model.</li> <li><code>join_schema_to_select</code>: An optional Pydantic schema for selecting specific columns from the joined model.</li> <li><code>join_type</code>: Specifies the SQL join type.</li> <li><code>alias</code>: An optional SQLAlchemy <code>AliasedClass</code> for complex scenarios like self-referential joins or multiple joins on the same model.</li> <li><code>join_filters</code>: Additional filters for the joined model.</li> </ul>"},{"location":"advanced/joins/#examples-of-simple-joining","title":"Examples of Simple Joining","text":"<pre><code># Fetch tasks with assigned user details, specifying a left join\ntasks_with_users = await task_crud.get_joined(\n    db=db,\n    join_model=User,\n    join_on=Task.assigned_user_id == User.id,\n    join_type=\"left\",\n)\n</code></pre>"},{"location":"advanced/joins/#getting-joined-data-nested","title":"Getting Joined Data Nested","text":"<p>Note that by default, <code>FastCRUD</code> joins all the data and returns it in a single dictionary.</p> <p>Let's take two of the tables from above and join them with <code>FastCRUD</code>:</p> <pre><code>user_crud = FastCRUD(User)\nuser_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    id=1,\n)\n</code></pre> <p>We'll get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre> <p>If you want the joined data in a nested dictionary instead, you may just pass <code>nest_joins=True</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>And you will get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre> <p>This works for both <code>get_joined</code> and <code>get_multi_joined</code>.</p> <p>Warning</p> <p>Note that the final <code>\"_\"</code> in the passed <code>\"tier_\"</code> is stripped.</p>"},{"location":"advanced/joins/#complex-joins-using-joinconfig","title":"Complex Joins Using <code>JoinConfig</code>","text":"<p>When dealing with more complex join conditions, such as multiple joins, self-referential joins, or needing to specify aliases and filters, <code>JoinConfig</code> instances become the norm. They offer granular control over each join's aspects, enabling precise and efficient data retrieval.</p> <p>Example:</p> <code>user/schemas.py</code> Excerpt <pre><code>class ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n</code></pre> <pre><code># Fetch users with details from related departments and tiers, using aliases for self-referential joins\nfrom fastcrud import aliased\n\nmanager_alias = aliased(User)\n\nusers = await user_crud.get_multi_joined(\n    db=db,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Department, \n            join_on=User.department_id == Department.id, \n            join_prefix=\"dept_\",\n        ),\n        JoinConfig(\n            model=Tier, \n            join_on=User.tier_id == Tier.id, \n            join_prefix=\"tier_\",\n        ),\n        JoinConfig(\n            model=User, \n            alias=manager_alias, \n            join_on=User.manager_id == manager_alias.id, \n            join_prefix=\"manager_\",\n        ),\n    ],\n)\n</code></pre>"},{"location":"advanced/joins/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>\"one-to-one\"</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"advanced/joins/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul>"},{"location":"advanced/joins/#example","title":"Example","text":"<p>Let's take two of the tables from above and join them with <code>FastCRUD</code>:</p> <pre><code>user_crud = FastCRUD(User)\nuser_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre>"},{"location":"advanced/joins/#one-to-one-relationship-with-nested-joins","title":"One-to-One Relationship with Nested Joins","text":"<p>To get the joined data in a nested dictionary:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre>"},{"location":"advanced/joins/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>Warning</p> <p>When using <code>nest_joins=True</code>, the performance will always be a bit worse than when using <code>nest_joins=False</code>. For cases where more performance is necessary, consider using <code>nest_joins=False</code> and remodeling your database.</p>"},{"location":"advanced/joins/#example_1","title":"Example","text":"<p>To demonstrate a one-to-many relationship, let's assume <code>Author</code> and <code>Article</code> tables:</p> <pre><code>class Author(Base):\n    __tablename__ = \"author\"\n    id = Column(Integer, primary_key=True)\n    profile_id = Column(Integer, ForeignKey(\"profile.id\"))\n    name = Column(String)\n\n\nclass Article(Base):\n    __tablename__ = \"article\"\n    id = Column(Integer, primary_key=True)\n    author_id = Column(Integer, ForeignKey(\"author.id\"))\n    title = Column(String)\n    content = Column(String)\n</code></pre> <p>Fetch a user and all their posts:</p> <pre><code>author_crud = FastCRUD(Author)\nauthor_articles = await author_crud.get_joined(\n    db=db,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_prefix=\"article_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example Author\",\n    \"articles\": [\n        {\n            \"id\": 101,\n            \"author_id\": 1,\n            \"title\": \"First Article!\",\n            \"content\": \"First article content\"\n        },\n        {\n            \"id\": 102,\n            \"author_id\": 1,\n            \"title\": \"Second Article?\",\n            \"content\": \"Second article content\"\n        }\n    ]\n}\n</code></pre>"},{"location":"advanced/joins/#many-to-many-relationships-with-get_multi_joined","title":"Many-to-Many Relationships with <code>get_multi_joined</code>","text":"<p>FastCRUD simplifies dealing with many-to-many relationships by allowing easy fetch operations with joined models. Here, we demonstrate using <code>get_multi_joined</code> to handle a many-to-many relationship between <code>Project</code> and <code>Participant</code> models, linked through an association table.</p> <p>Note on Handling Many-to-Many Relationships:</p> <p>When using <code>get_multi_joined</code> for many-to-many relationships, it's essential to maintain a specific order in your <code>joins_config</code>: </p> <ol> <li>First, specify the main table you're querying from.</li> <li>Next, include the association table that links your main table to the other table involved in the many-to-many relationship.</li> <li>Finally, specify the other table that is connected via the association table.</li> </ol> <p>This order ensures that the SQL joins are structured correctly to reflect the many-to-many relationship and retrieve the desired data accurately.</p> <p>Tip</p> <p>Note that the first one can be the model defined in <code>FastCRUD(Model)</code>.</p>"},{"location":"advanced/joins/#scenario","title":"Scenario","text":"<p>Imagine a scenario where projects have multiple participants, and participants can be involved in multiple projects. This many-to-many relationship is facilitated through an association table.</p>"},{"location":"advanced/joins/#models","title":"Models","text":"<p>Our models include <code>Project</code>, <code>Participant</code>, and an association model <code>ProjectsParticipantsAssociation</code>:</p> <pre><code>from sqlalchemy import Column, Integer, String, ForeignKey, Table\nfrom sqlalchemy.orm import declarative_base, relationship\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Project(Base):\n    __tablename__ = 'projects'\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    # Relationship to Participant through the association table\n    participants = relationship(\"Participant\", secondary=projects_participants_association)\n\n\nclass Participant(Base):\n    __tablename__ = 'participants'\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    role = Column(String)\n    # Relationship to Project through the association table\n    projects = relationship(\"Project\", secondary=projects_participants_association)\n\n\n# Association table for the many-to-many relationship\nclass ProjectsParticipantsAssociation(Base):\n    __tablename__ = \"projects_participants_association\"\n    project_id = Column(Integer, ForeignKey(\"projects.id\"), primary_key=True)\n    participant_id = Column(Integer, ForeignKey(\"participants.id\"), primary_key=True)\n</code></pre>"},{"location":"advanced/joins/#fetching-data-with-get_multi_joined","title":"Fetching Data with <code>get_multi_joined</code>","text":"<p>To fetch projects along with their participants, we utilize <code>get_multi_joined</code> with appropriate <code>JoinConfig</code> settings:</p> <pre><code>from fastcrud import FastCRUD, JoinConfig\n\n# Initialize FastCRUD for the Project model\ncrud_project = FastCRUD(Project)\n\n# Define join conditions and configuration\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    ),\n]\n\n# Fetch projects with their participants\nprojects_with_participants = await crud_project.get_multi_joined(\n    db_session, \n    joins_config=joins_config,\n)\n\n# Now, `projects_with_participants['data']` will contain projects along with their participant information.\n</code></pre>"},{"location":"advanced/joins/#example_2","title":"Example","text":"<p>Imagine a scenario where projects have multiple participants, and participants can be involved in multiple projects. This many-to-many relationship is facilitated through an association table.</p> <p>Define the models:</p> <pre><code>class Project(Base):\n    __tablename__ = 'projects'\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n    description = Column(String)\n    participants = relationship(\"Participant\", secondary=projects_participants_association)\n\n\nclass Participant(Base):\n    __tablename__ = 'participants'\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n    role = Column(String)\n    projects = relationship(\"Project\", secondary=projects_participants_association)\n\n\nclass ProjectsParticipantsAssociation(Base):\n    __tablename__ = \"projects_participants_association\"\n    project_id = Column(Integer, ForeignKey(\"projects.id\"), primary key=True)\n    participant_id = Column(Integer, ForeignKey(\"participants.id\"), primary key=True)\n</code></pre> <p>Fetch projects along with their participants:</p> <pre><code>from fastcrud import FastCRUD, JoinConfig\n\ncrud_project = FastCRUD(Project)\n\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    )\n]\n\nprojects_with_participants = await crud_project.get_multi_joined(\n    db_session, \n    joins_config=joins_config,\n)\n</code></pre> <p>The result will be:</p> <pre><code>[\n    {\n        \"id\": 1,\n        \"name\": \"Project A\",\n        \"description\": \"Description of Project A\",\n        \"participants\": [\n            {\n                \"id\": 1,\n                \"name\": \"Participant 1\",\n                \"role\": \"Developer\"\n            },\n            {\n                \"id\": 2,\n                \"name\": \"Participant 2\",\n                \"role\": \"Designer\"\n            }\n        ]\n    },\n    {\n        \"id\": 2,\n        \"name\": \"Project B\",\n        \"description\": \"Description of Project B\",\n        \"participants\": [\n            {\n                \"id\": 3,\n                \"name\": \"Participant 3\",\n                \"role\": \"Manager\"\n            },\n            {\n                \"id\": 4,\n                \"name\": \"Participant 4\",\n                \"role\": \"Tester\"\n            }\n        ]\n    }\n]\n</code></pre>"},{"location":"advanced/joins/#practical-tips-for-advanced-joins","title":"Practical Tips for Advanced Joins","text":"<ul> <li>Prefixing: Always use the <code>join_prefix</code> attribute to avoid column name collisions, especially in complex joins involving multiple models or self-referential joins.</li> <li>Aliasing: Utilize the <code>alias</code> attribute for disambiguating joins on the same model or for self-referential joins.</li> <li>Filtering Joined Models: Apply filters directly to joined models using the <code>filters</code> attribute in <code>JoinConfig</code> to refine the data set returned by the query.</li> <li>Ordering Joins: In many-to-many relationships or complex join scenarios, carefully sequence your <code>JoinConfig</code> entries to ensure logical and efficient SQL join construction.</li> </ul>"},{"location":"advanced/joins/#conclusion","title":"Conclusion","text":"<p>FastCRUD's support for join operations enhances the ability to perform complex queries across related models in FastAPI applications. By understanding and utilizing the <code>JoinConfig</code> class within the <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code> methods, developers can craft powerful data retrieval queries.</p>"},{"location":"advanced/overview/","title":"Advanced Usage Overview","text":"<p>The Advanced section of our documentation delves into the sophisticated capabilities and features of our application, tailored for users looking to leverage advanced functionalities. This part of our guide aims to unlock deeper insights and efficiencies through more complex use cases and configurations.</p>"},{"location":"advanced/overview/#key-topics","title":"Key Topics","text":""},{"location":"advanced/overview/#1-advanced-filtering-and-searching","title":"1. Advanced Filtering and Searching","text":"<p>Explore how to implement advanced filtering and searching capabilities in your application. This guide covers the use of comparison operators (such as greater than, less than, etc.), pattern matching, and more to perform complex queries.</p> <ul> <li>Advanced Filtering Guide</li> </ul>"},{"location":"advanced/overview/#2-bulk-operations-and-batch-processing","title":"2. Bulk Operations and Batch Processing","text":"<p>Learn how to efficiently handle bulk operations and batch processing. This section provides insights into performing mass updates, deletes, and inserts, optimizing performance for large datasets.</p> <ul> <li>Bulk Operations Guide</li> </ul>"},{"location":"advanced/overview/#3-soft-delete-mechanisms-and-strategies","title":"3. Soft Delete Mechanisms and Strategies","text":"<p>Understand the implementation of soft delete mechanisms within our application. This guide covers configuring and using custom columns for soft deletes, restoring deleted records, and filtering queries to exclude soft-deleted entries.</p> <ul> <li>Soft Delete Strategies Guide</li> </ul>"},{"location":"advanced/overview/#4-advanced-use-of-endpointcreator-and-crud_router","title":"4. Advanced Use of EndpointCreator and crud_router","text":"<p>This topic extends the use of <code>EndpointCreator</code> and <code>crud_router</code> for advanced endpoint management, including creating custom routes, selective method exposure, and integrating soft delete functionalities.</p> <ul> <li>Advanced Endpoint Management Guide</li> </ul>"},{"location":"advanced/overview/#5-using-get_joined-and-get_multi_joined-for-multiple-models","title":"5. Using <code>get_joined</code> and <code>get_multi_joined</code> for multiple models","text":"<p>Explore the use of <code>get_joined</code> and <code>get_multi_joined</code> functions for complex queries that involve joining multiple models, including self-joins and scenarios requiring multiple joins on the same model.</p> <ul> <li>Joining Multiple Models Guide</li> </ul>"},{"location":"advanced/overview/#6-method-chaining-with-select","title":"6. Method Chaining with <code>select</code>","text":"<p>FastCRUD's <code>select</code> method introduces method chaining, allowing for the construction of detailed queries with a focus on precision. It simplifies the process of dynamically applying filters, sorting, and conditions, making it easier to manage complex query requirements.</p> <ul> <li>Method Chaining Guide</li> </ul>"},{"location":"advanced/overview/#7-in-depth-explanation-of-joined-methods","title":"7. In depth explanation of Joined methods","text":"<p>Explore different ways of joining models in FastCRUD with examples and tips.</p> <ul> <li>Joining Models</li> </ul>"},{"location":"advanced/overview/#8-filters-in-automatic-endpoints","title":"8. Filters in Automatic Endpoints","text":"<p>Learn how to add query parameters to your <code>get_multi</code> and <code>get_paginated</code> endpoints.</p> <ul> <li>Filters in Endpoints</li> </ul>"},{"location":"advanced/overview/#prerequisites","title":"Prerequisites","text":"<p>Advanced usage assumes a solid understanding of the basic features and functionalities of our application. Knowledge of FastAPI, SQLAlchemy, and Pydantic is highly recommended to fully grasp the concepts discussed.</p>"},{"location":"api/crud_router/","title":"CRUD Router API Reference","text":"<p><code>crud_router</code> is a utility function for creating and configuring a FastAPI router with CRUD endpoints for a given model.</p>"},{"location":"api/crud_router/#function-definition","title":"Function Definition","text":"<p>Creates and configures a FastAPI router with CRUD endpoints for a given model.</p> <p>This utility function streamlines the process of setting up a router for CRUD operations, using a custom <code>EndpointCreator</code> if provided, and managing dependency injections as well as selective method inclusions or exclusions.</p> <p>Parameters:</p> Name Type Description Default <code>session</code> <code>Callable</code> <p>The SQLAlchemy async session.</p> required <code>model</code> <code>ModelType</code> <p>The SQLAlchemy model.</p> required <code>create_schema</code> <code>Type[CreateSchemaType]</code> <p>Pydantic schema for creating an item.</p> required <code>update_schema</code> <code>Type[UpdateSchemaType]</code> <p>Pydantic schema for updating an item.</p> required <code>crud</code> <code>Optional[FastCRUD]</code> <p>An optional <code>FastCRUD</code> instance. If not provided, uses <code>FastCRUD(model)</code>.</p> <code>None</code> <code>delete_schema</code> <code>Optional[Type[DeleteSchemaType]]</code> <p>Optional Pydantic schema for deleting an item.</p> <code>None</code> <code>path</code> <code>str</code> <p>Base path for the CRUD endpoints.</p> <code>''</code> <code>tags</code> <code>Optional[list[Union[str, Enum]]]</code> <p>Optional list of tags for grouping endpoints in the documentation.</p> <code>None</code> <code>include_in_schema</code> <code>bool</code> <p>Whether to include the created endpoints in the OpenAPI schema.</p> <code>True</code> <code>create_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the create endpoint.</p> <code>[]</code> <code>read_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the read endpoint.</p> <code>[]</code> <code>read_multi_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the read multiple items endpoint.</p> <code>[]</code> <code>update_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the update endpoint.</p> <code>[]</code> <code>delete_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the delete endpoint.</p> <code>[]</code> <code>db_delete_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the hard delete endpoint.</p> <code>[]</code> <code>included_methods</code> <code>Optional[list[str]]</code> <p>Optional list of CRUD methods to include. If <code>None</code>, all methods are included.</p> <code>None</code> <code>deleted_methods</code> <code>Optional[list[str]]</code> <p>Optional list of CRUD methods to exclude.</p> <code>None</code> <code>endpoint_creator</code> <code>Optional[Type[EndpointCreator]]</code> <p>Optional custom class derived from <code>EndpointCreator</code> for advanced customization.</p> <code>None</code> <code>is_deleted_column</code> <code>str</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>'is_deleted'</code> <code>deleted_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>'deleted_at'</code> <code>updated_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>'updated_at'</code> <code>endpoint_names</code> <code>Optional[dict[str, str]]</code> <p>Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types             (<code>\"create\"</code>, <code>\"read\"</code>, <code>\"update\"</code>, <code>\"delete\"</code>, <code>\"db_delete\"</code>, <code>\"read_multi\"</code>), and             values are the custom names to use. Unspecified operations will use default names.</p> <code>None</code> <code>filter_config</code> <code>Optional[Union[FilterConfig, dict]]</code> <p>Optional <code>FilterConfig</code> instance or dictionary to configure filters for the <code>read_multi</code> endpoint.</p> <code>None</code> <p>Returns:</p> Type Description <code>APIRouter</code> <p>Configured <code>APIRouter</code> instance with the CRUD endpoints.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> Models and Schemas Used Below <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteMyModelSchema(BaseModel):\n    pass\n</code></pre> <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>customer/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateCustomerSchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadCustomerSchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateCustomerSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteCustomerSchema(BaseModel):\n    pass\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>product/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateProductSchema(BaseModel):\n    name: str | None = None\n    price: float | None = None\n\n\nclass ReadProductSchema(BaseModel):\n    id: int\n    name: str | None = None\n    price: float | None = None\n\n\nclass UpdateProductSchema(BaseModel):\n    name: str | None = None\n    price: float | None = None\n\n\nclass DeleteProductSchema(BaseModel):\n    pass\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateOrderSchema(BaseModel):\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass UpdateOrderSchema(BaseModel):\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass DeleteOrderSchema(BaseModel):\n    pass\n</code></pre> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> <p>Basic Setup:</p> <pre><code>mymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n)\n</code></pre> <p>With Custom Dependencies:</p> <pre><code>def get_current_user(token: str = Depends(oauth2_scheme)):\n    # Implement user retrieval logic\n    return ...\n\nuser_router = crud_router(\n    session=async_session,\n    model=User,\n    create_schema=CreateUserSchema,\n    update_schema=UpdateUserSchema,\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n    path=\"/users\",\n    tags=[\"Users\"],\n)\n</code></pre> <p>Adding Delete Endpoints: <pre><code>product_router = crud_router(\n    session=async_session,\n    model=Product,\n    create_schema=CreateProductSchema,\n    update_schema=UpdateProductSchema,\n    delete_schema=DeleteProductSchema,\n    path=\"/products\",\n    tags=[\"Products\"],\n)\n</code></pre></p> <p>Customizing Path and Tags: <pre><code>OrderCRUD = FastCRUD[\n    Order,\n    CreateOrderSchema,\n    UpdateOrderSchema,\n    UpdateOrderSchema,\n    DeleteOrderSchema,\n]\norder_router = crud_router(\n    session=async_session,\n    model=Order,\n    create_schema=CreateOrderSchema,\n    update_schema=UpdateOrderSchema,\n    crud=OrderCRUD(Order),\n    path=\"/orders\",\n    tags=[\"Orders\", \"Sales\"],\n)\n</code></pre></p> <p>Integrating Multiple Models: <pre><code>ProductCRUD = FastCRUD[\n    Product,\n    CreateProductSchema,\n    UpdateProductSchema,\n    UpdateProductSchema,\n    DeleteProductSchema,\n]\nproduct_router = crud_router(\n    session=async_session,\n    model=Product,\n    create_schema=CreateProductSchema,\n    update_schema=UpdateProductSchema,\n    crud=ProductCRUD(Product),\n    path=\"/products\",\n    tags=[\"Inventory\"],\n)\n\nCustomerCRUD = FastCRUD[\n    Customer,\n    CreateCustomerSchema,\n    UpdateCustomerSchema,\n    UpdateCustomerSchema,\n    DeleteCustomerSchema,\n]\ncustomer_router = crud_router(\n    session=async_session,\n    model=Customer,\n    create_schema=CreateCustomerSchema,\n    update_schema=UpdateCustomerSchema,\n    crud=CustomerCRUD(Customer),\n    path=\"/customers\",\n    tags=[\"CRM\"],\n)\n</code></pre></p> <p>With Selective CRUD Methods:</p> <pre><code>MyModelCRUD = FastCRUD[\n    MyModel,\n    CreateMyModelSchema,\n    UpdateMyModelSchema,\n    UpdateMyModelSchema,\n    DeleteMyModelSchema,\n]\n# Only include 'create' and 'read' methods\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=MyModelCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Using a Custom <code>EndpointCreator</code>:</p> <pre><code>class CustomEndpointCreator(EndpointCreator):\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n        async def add_routes_to_router(self, ...):\n            # First, add standard CRUD routes\n            super().add_routes_to_router(...)\n\n            # Now, add custom routes\n            self.router.add_api_route(\n                path=\"/custom\",\n                endpoint=self._custom_route(),\n                methods=[\"GET\"],\n                tags=self.tags,\n                # Other parameters as needed\n            )\n\nMyModelCRUD = FastCRUD[\n    MyModel,\n    CreateMyModelSchema,\n    UpdateMyModelSchema,\n    UpdateMyModelSchema,\n    DeleteMyModelSchema,\n]\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=MyModelCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_creator=CustomEndpointCreator,\n)\n\napp.include_router(mymodel_router)\n</code></pre> <p>Customizing Endpoint Names:</p> <pre><code>task_router = crud_router(\n    session=async_session,\n    model=Task,\n    create_schema=CreateTaskSchema,\n    update_schema=UpdateTaskSchema,\n    path=\"/tasks\",\n    tags=[\"Task Management\"],\n    endpoint_names={\n        \"create\": \"add_task\",\n        \"read\": \"get_task\",\n        \"update\": \"modify_task\",\n        \"delete\": \"remove_task\",\n        \"db_delete\": \"permanently_remove_task\",\n        \"read_multi\": \"list_tasks\",\n    },\n)\n</code></pre> <p>Using <code>FilterConfig</code> with <code>dict</code>:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n)\n# Adds CRUD routes with filtering capabilities\napp.include_router(mymodel_router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> <p>Using <code>FilterConfig</code> with keyword arguments:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(id=None, name=\"default\"),\n)\n# Adds CRUD routes with filtering capabilities\napp.include_router(mymodel_router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> Source code in <code>fastcrud/endpoint/crud_router.py</code> <pre><code>def crud_router(\n    session: Callable,\n    model: ModelType,\n    create_schema: Type[CreateSchemaType],\n    update_schema: Type[UpdateSchemaType],\n    crud: Optional[FastCRUD] = None,\n    delete_schema: Optional[Type[DeleteSchemaType]] = None,\n    path: str = \"\",\n    tags: Optional[list[Union[str, Enum]]] = None,\n    include_in_schema: bool = True,\n    create_deps: Sequence[Callable] = [],\n    read_deps: Sequence[Callable] = [],\n    read_multi_deps: Sequence[Callable] = [],\n    update_deps: Sequence[Callable] = [],\n    delete_deps: Sequence[Callable] = [],\n    db_delete_deps: Sequence[Callable] = [],\n    included_methods: Optional[list[str]] = None,\n    deleted_methods: Optional[list[str]] = None,\n    endpoint_creator: Optional[Type[EndpointCreator]] = None,\n    is_deleted_column: str = \"is_deleted\",\n    deleted_at_column: str = \"deleted_at\",\n    updated_at_column: str = \"updated_at\",\n    endpoint_names: Optional[dict[str, str]] = None,\n    filter_config: Optional[Union[FilterConfig, dict]] = None,\n) -&gt; APIRouter:\n    \"\"\"\n    Creates and configures a FastAPI router with CRUD endpoints for a given model.\n\n    This utility function streamlines the process of setting up a router for CRUD operations,\n    using a custom `EndpointCreator` if provided, and managing dependency injections as well\n    as selective method inclusions or exclusions.\n\n    Args:\n        session: The SQLAlchemy async session.\n        model: The SQLAlchemy model.\n        create_schema: Pydantic schema for creating an item.\n        update_schema: Pydantic schema for updating an item.\n        crud: An optional `FastCRUD` instance. If not provided, uses `FastCRUD(model)`.\n        delete_schema: Optional Pydantic schema for deleting an item.\n        path: Base path for the CRUD endpoints.\n        tags: Optional list of tags for grouping endpoints in the documentation.\n        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.\n        create_deps: Optional list of functions to be injected as dependencies for the create endpoint.\n        read_deps: Optional list of functions to be injected as dependencies for the read endpoint.\n        read_multi_deps: Optional list of functions to be injected as dependencies for the read multiple items endpoint.\n        update_deps: Optional list of functions to be injected as dependencies for the update endpoint.\n        delete_deps: Optional list of functions to be injected as dependencies for the delete endpoint.\n        db_delete_deps: Optional list of functions to be injected as dependencies for the hard delete endpoint.\n        included_methods: Optional list of CRUD methods to include. If `None`, all methods are included.\n        deleted_methods: Optional list of CRUD methods to exclude.\n        endpoint_creator: Optional custom class derived from `EndpointCreator` for advanced customization.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types\n                        (`\"create\"`, `\"read\"`, `\"update\"`, `\"delete\"`, `\"db_delete\"`, `\"read_multi\"`), and\n                        values are the custom names to use. Unspecified operations will use default names.\n        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.\n\n    Returns:\n        Configured `APIRouter` instance with the CRUD endpoints.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        ??? example \"Models and Schemas Used Below\"\n\n            ??? example \"`mymodel/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/mymodel/model.py:imports\n                fastcrud/examples/mymodel/model.py:model_simple\n                --8&lt;--\n                ```\n\n            ??? example \"`mymodel/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/mymodel/schemas.py:imports\n                fastcrud/examples/mymodel/schemas.py:createschema\n                fastcrud/examples/mymodel/schemas.py:updateschema\n                fastcrud/examples/mymodel/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`customer/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/model.py:imports\n                fastcrud/examples/customer/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`customer/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/schemas.py:imports\n                fastcrud/examples/customer/schemas.py:createschema\n                fastcrud/examples/customer/schemas.py:readschema\n                fastcrud/examples/customer/schemas.py:updateschema\n                fastcrud/examples/customer/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`product/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/model.py:imports\n                fastcrud/examples/product/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/schemas.py:imports\n                fastcrud/examples/product/schemas.py:createschema\n                fastcrud/examples/product/schemas.py:readschema\n                fastcrud/examples/product/schemas.py:updateschema\n                fastcrud/examples/product/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`order/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/model.py:imports\n                fastcrud/examples/order/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`order/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/schemas.py:imports\n                fastcrud/examples/order/schemas.py:createschema\n                fastcrud/examples/order/schemas.py:readschema\n                fastcrud/examples/order/schemas.py:updateschema\n                fastcrud/examples/order/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`tier/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/model.py:imports\n                fastcrud/examples/tier/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`tier/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/schemas.py:imports\n                fastcrud/examples/tier/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`department/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/model.py:imports\n                fastcrud/examples/department/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`department/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/schemas.py:imports\n                fastcrud/examples/department/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`user/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/model.py:imports\n                fastcrud/examples/user/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`user/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/schemas.py:imports\n                fastcrud/examples/user/schemas.py:createschema\n                fastcrud/examples/user/schemas.py:readschema\n                fastcrud/examples/user/schemas.py:updateschema\n                fastcrud/examples/user/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`story/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/model.py:imports\n                fastcrud/examples/story/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`story/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/schemas.py:imports\n                fastcrud/examples/story/schemas.py:createschema\n                fastcrud/examples/story/schemas.py:readschema\n                fastcrud/examples/story/schemas.py:updateschema\n                fastcrud/examples/story/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`task/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/model.py:imports\n                fastcrud/examples/task/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`task/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/schemas.py:imports\n                fastcrud/examples/task/schemas.py:createschema\n                fastcrud/examples/task/schemas.py:readschema\n                fastcrud/examples/task/schemas.py:updateschema\n                fastcrud/examples/task/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n        Basic Setup:\n\n        ```python\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n        )\n        ```\n\n        With Custom Dependencies:\n\n        ```python\n        def get_current_user(token: str = Depends(oauth2_scheme)):\n            # Implement user retrieval logic\n            return ...\n\n        user_router = crud_router(\n            session=async_session,\n            model=User,\n            create_schema=CreateUserSchema,\n            update_schema=UpdateUserSchema,\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n            path=\"/users\",\n            tags=[\"Users\"],\n        )\n        ```\n\n        Adding Delete Endpoints:\n        ```python\n        product_router = crud_router(\n            session=async_session,\n            model=Product,\n            create_schema=CreateProductSchema,\n            update_schema=UpdateProductSchema,\n            delete_schema=DeleteProductSchema,\n            path=\"/products\",\n            tags=[\"Products\"],\n        )\n        ```\n\n        Customizing Path and Tags:\n        ```python\n        OrderCRUD = FastCRUD[\n            Order,\n            CreateOrderSchema,\n            UpdateOrderSchema,\n            UpdateOrderSchema,\n            DeleteOrderSchema,\n        ]\n        order_router = crud_router(\n            session=async_session,\n            model=Order,\n            create_schema=CreateOrderSchema,\n            update_schema=UpdateOrderSchema,\n            crud=OrderCRUD(Order),\n            path=\"/orders\",\n            tags=[\"Orders\", \"Sales\"],\n        )\n        ```\n\n        Integrating Multiple Models:\n        ```python\n        ProductCRUD = FastCRUD[\n            Product,\n            CreateProductSchema,\n            UpdateProductSchema,\n            UpdateProductSchema,\n            DeleteProductSchema,\n        ]\n        product_router = crud_router(\n            session=async_session,\n            model=Product,\n            create_schema=CreateProductSchema,\n            update_schema=UpdateProductSchema,\n            crud=ProductCRUD(Product),\n            path=\"/products\",\n            tags=[\"Inventory\"],\n        )\n\n        CustomerCRUD = FastCRUD[\n            Customer,\n            CreateCustomerSchema,\n            UpdateCustomerSchema,\n            UpdateCustomerSchema,\n            DeleteCustomerSchema,\n        ]\n        customer_router = crud_router(\n            session=async_session,\n            model=Customer,\n            create_schema=CreateCustomerSchema,\n            update_schema=UpdateCustomerSchema,\n            crud=CustomerCRUD(Customer),\n            path=\"/customers\",\n            tags=[\"CRM\"],\n        )\n        ```\n\n        With Selective CRUD Methods:\n\n        ```python\n        MyModelCRUD = FastCRUD[\n            MyModel,\n            CreateMyModelSchema,\n            UpdateMyModelSchema,\n            UpdateMyModelSchema,\n            DeleteMyModelSchema,\n        ]\n        # Only include 'create' and 'read' methods\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            crud=MyModelCRUD(MyModel),\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Using a Custom `EndpointCreator`:\n\n        ```python\n        class CustomEndpointCreator(EndpointCreator):\n            def _custom_route(self):\n                async def custom_endpoint():\n                    # Custom endpoint logic\n                    return {\"message\": \"Custom route\"}\n\n                return custom_endpoint\n\n                async def add_routes_to_router(self, ...):\n                    # First, add standard CRUD routes\n                    super().add_routes_to_router(...)\n\n                    # Now, add custom routes\n                    self.router.add_api_route(\n                        path=\"/custom\",\n                        endpoint=self._custom_route(),\n                        methods=[\"GET\"],\n                        tags=self.tags,\n                        # Other parameters as needed\n                    )\n\n        MyModelCRUD = FastCRUD[\n            MyModel,\n            CreateMyModelSchema,\n            UpdateMyModelSchema,\n            UpdateMyModelSchema,\n            DeleteMyModelSchema,\n        ]\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            crud=MyModelCRUD(MyModel),\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            endpoint_creator=CustomEndpointCreator,\n        )\n\n        app.include_router(mymodel_router)\n        ```\n\n        Customizing Endpoint Names:\n\n        ```python\n        task_router = crud_router(\n            session=async_session,\n            model=Task,\n            create_schema=CreateTaskSchema,\n            update_schema=UpdateTaskSchema,\n            path=\"/tasks\",\n            tags=[\"Task Management\"],\n            endpoint_names={\n                \"create\": \"add_task\",\n                \"read\": \"get_task\",\n                \"update\": \"modify_task\",\n                \"delete\": \"remove_task\",\n                \"db_delete\": \"permanently_remove_task\",\n                \"read_multi\": \"list_tasks\",\n            },\n        )\n        ```\n\n        Using `FilterConfig` with `dict`:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import crud_router\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n        )\n        # Adds CRUD routes with filtering capabilities\n        app.include_router(mymodel_router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n\n        Using `FilterConfig` with keyword arguments:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import crud_router\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(id=None, name=\"default\"),\n        )\n        # Adds CRUD routes with filtering capabilities\n        app.include_router(mymodel_router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n    \"\"\"\n\n    crud = crud or FastCRUD(\n        model=model,\n        is_deleted_column=is_deleted_column,\n        deleted_at_column=deleted_at_column,\n        updated_at_column=updated_at_column,\n    )\n\n    endpoint_creator_class = endpoint_creator or EndpointCreator\n    endpoint_creator_instance = endpoint_creator_class(\n        session=session,\n        model=model,\n        crud=crud,\n        create_schema=create_schema,  # type: ignore\n        update_schema=update_schema,  # type: ignore\n        include_in_schema=include_in_schema,\n        delete_schema=delete_schema,  # type: ignore\n        path=path,\n        tags=tags,\n        is_deleted_column=is_deleted_column,\n        deleted_at_column=deleted_at_column,\n        updated_at_column=updated_at_column,\n        endpoint_names=endpoint_names,\n        filter_config=filter_config,\n    )\n\n    endpoint_creator_instance.add_routes_to_router(\n        create_deps=create_deps,\n        read_deps=read_deps,\n        read_multi_deps=read_multi_deps,\n        update_deps=update_deps,\n        delete_deps=delete_deps,\n        db_delete_deps=db_delete_deps,\n        included_methods=included_methods,\n        deleted_methods=deleted_methods,\n    )\n\n    return endpoint_creator_instance.router\n</code></pre>"},{"location":"api/endpoint_creator/","title":"EndpointCreator API Reference","text":"<p><code>EndpointCreator</code> is a class designed to create and register CRUD endpoints for a FastAPI application. It simplifies the process of adding CRUD (Create, Read, Update, Delete) endpoints to a FastAPI router.</p>"},{"location":"api/endpoint_creator/#class-definition","title":"Class Definition","text":"<p>A class to create and register CRUD endpoints for a FastAPI application.</p> <p>This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations, and Pydantic schemas, and allows for custom dependency injection for each endpoint. The method assumes <code>id</code> is the primary key for path parameters.</p> <p>Attributes:</p> Name Type Description <code>session</code> <p>The SQLAlchemy async session.</p> <code>model</code> <p>The SQLAlchemy model.</p> <code>create_schema</code> <p>Pydantic schema for creating an item.</p> <code>update_schema</code> <p>Pydantic schema for updating an item.</p> <code>crud</code> <p>An optional FastCRUD instance. If not provided, uses <code>FastCRUD(model)</code>.</p> <code>include_in_schema</code> <p>Whether to include the created endpoints in the OpenAPI schema.</p> <code>delete_schema</code> <p>Optional Pydantic schema for deleting an item.</p> <code>path</code> <p>Base path for the CRUD endpoints.</p> <code>tags</code> <p>List of tags for grouping endpoints in the documentation.</p> <code>is_deleted_column</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>deleted_at_column</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>updated_at_column</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>endpoint_names</code> <p>Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types             (<code>\"create\"</code>, <code>\"read\"</code>, <code>\"update\"</code>, <code>\"delete\"</code>, <code>\"db_delete\"</code>, <code>\"read_multi\"</code>), and             values are the custom names to use. Unspecified operations will use default names.</p> <code>filter_config</code> <p>Optional <code>FilterConfig</code> instance or dictionary to configure filters for the <code>read_multi</code> endpoint.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> <p>Basic Setup:</p> <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n</code></pre> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n)\nendpoint_creator.add_routes_to_router()\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n</code></pre> <p>With Custom Dependencies:</p> <pre><code>from fastapi.security import OAuth2PasswordBearer\n\noauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"token\")\n\ndef get_current_user(token: str = Depends(oauth2_scheme)):\n    return ...\n\nendpoint_creator.add_routes_to_router(\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n)\n</code></pre> <p>Selective Endpoint Creation (inclusion):</p> <pre><code># Only create 'create' and 'read' endpoints\nendpoint_creator.add_routes_to_router(\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Selective Endpoint Creation (deletion):</p> <pre><code># Create all but 'update' and 'delete' endpoints\nendpoint_creator.add_routes_to_router(\n    deleted_methods=[\"update\", \"delete\"],\n)\n</code></pre> <p>Integrating with Multiple Models:</p> <pre><code># Assuming definitions for OtherModel, OtherModelCRUD, etc.\n\nother_model_crud = OtherModelCRUD(OtherModel)\nother_endpoint_creator = EndpointCreator(\n    session=async_session,\n    model=OtherModel,\n    create_schema=CreateOtherModelSchema,\n    update_schema=UpdateOtherModelSchema,\n    crud=other_model_crud,\n)\nother_endpoint_creator.add_routes_to_router()\napp.include_router(other_endpoint_creator.router, prefix=\"/othermodel\")\n</code></pre> <p>Customizing Endpoint Names:</p> <pre><code>endpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names={\n        \"create\": \"add\",  # Custom endpoint name for creating items\n        \"read\": \"fetch\",  # Custom endpoint name for reading a single item\n        \"update\": \"change\",  # Custom endpoint name for updating items\n        # The delete operation will use the default name \"delete\"\n    },\n)\nendpoint_creator.add_routes_to_router()\n</code></pre> <p>Using <code>filter_config</code> with <code>dict</code>:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator, FilterConfig\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n)\n# Adds CRUD routes with filtering capabilities\nendpoint_creator.add_routes_to_router()\n# Include the internal router into the FastAPI app\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> <p>Using <code>filter_config</code> with keyword arguments:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator, FilterConfig\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(id=None, name=\"default\"),\n)\n# Adds CRUD routes with filtering capabilities\nendpoint_creator.add_routes_to_router()\n# Include the internal router into the FastAPI app\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>class EndpointCreator:\n    \"\"\"\n    A class to create and register CRUD endpoints for a FastAPI application.\n\n    This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints\n    to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations,\n    and Pydantic schemas, and allows for custom dependency injection for each endpoint.\n    The method assumes `id` is the primary key for path parameters.\n\n    Attributes:\n        session: The SQLAlchemy async session.\n        model: The SQLAlchemy model.\n        create_schema: Pydantic schema for creating an item.\n        update_schema: Pydantic schema for updating an item.\n        crud: An optional FastCRUD instance. If not provided, uses `FastCRUD(model)`.\n        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.\n        delete_schema: Optional Pydantic schema for deleting an item.\n        path: Base path for the CRUD endpoints.\n        tags: List of tags for grouping endpoints in the documentation.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types\n                        (`\"create\"`, `\"read\"`, `\"update\"`, `\"delete\"`, `\"db_delete\"`, `\"read_multi\"`), and\n                        values are the custom names to use. Unspecified operations will use default names.\n        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        Basic Setup:\n\n        ??? example \"`mymodel/model.py`\"\n\n            ```python\n            --8&lt;--\n            fastcrud/examples/mymodel/model.py:imports\n            fastcrud/examples/mymodel/model.py:model_simple\n            --8&lt;--\n            ```\n\n        ??? example \"`mymodel/schemas.py`\"\n\n            ```python\n            --8&lt;--\n            fastcrud/examples/mymodel/schemas.py:imports\n            fastcrud/examples/mymodel/schemas.py:createschema\n            fastcrud/examples/mymodel/schemas.py:updateschema\n            --8&lt;--\n            ```\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n        )\n        endpoint_creator.add_routes_to_router()\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n        ```\n\n        With Custom Dependencies:\n\n        ```python\n        from fastapi.security import OAuth2PasswordBearer\n\n        oauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"token\")\n\n        def get_current_user(token: str = Depends(oauth2_scheme)):\n            return ...\n\n        endpoint_creator.add_routes_to_router(\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n        )\n        ```\n\n        Selective Endpoint Creation (inclusion):\n\n        ```python\n        # Only create 'create' and 'read' endpoints\n        endpoint_creator.add_routes_to_router(\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Selective Endpoint Creation (deletion):\n\n        ```python\n        # Create all but 'update' and 'delete' endpoints\n        endpoint_creator.add_routes_to_router(\n            deleted_methods=[\"update\", \"delete\"],\n        )\n        ```\n\n        Integrating with Multiple Models:\n\n        ```python\n        # Assuming definitions for OtherModel, OtherModelCRUD, etc.\n\n        other_model_crud = OtherModelCRUD(OtherModel)\n        other_endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=OtherModel,\n            create_schema=CreateOtherModelSchema,\n            update_schema=UpdateOtherModelSchema,\n            crud=other_model_crud,\n        )\n        other_endpoint_creator.add_routes_to_router()\n        app.include_router(other_endpoint_creator.router, prefix=\"/othermodel\")\n        ```\n\n        Customizing Endpoint Names:\n\n        ```python\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            endpoint_names={\n                \"create\": \"add\",  # Custom endpoint name for creating items\n                \"read\": \"fetch\",  # Custom endpoint name for reading a single item\n                \"update\": \"change\",  # Custom endpoint name for updating items\n                # The delete operation will use the default name \"delete\"\n            },\n        )\n        endpoint_creator.add_routes_to_router()\n        ```\n\n        Using `filter_config` with `dict`:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator, FilterConfig\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n        )\n        # Adds CRUD routes with filtering capabilities\n        endpoint_creator.add_routes_to_router()\n        # Include the internal router into the FastAPI app\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n\n        Using `filter_config` with keyword arguments:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator, FilterConfig\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(id=None, name=\"default\"),\n        )\n        # Adds CRUD routes with filtering capabilities\n        endpoint_creator.add_routes_to_router()\n        # Include the internal router into the FastAPI app\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n    \"\"\"\n\n    def __init__(\n        self,\n        session: Callable,\n        model: ModelType,\n        create_schema: Type[CreateSchemaType],\n        update_schema: Type[UpdateSchemaType],\n        crud: Optional[FastCRUD] = None,\n        include_in_schema: bool = True,\n        delete_schema: Optional[Type[DeleteSchemaType]] = None,\n        path: str = \"\",\n        tags: Optional[list[Union[str, Enum]]] = None,\n        is_deleted_column: str = \"is_deleted\",\n        deleted_at_column: str = \"deleted_at\",\n        updated_at_column: str = \"updated_at\",\n        endpoint_names: Optional[dict[str, str]] = None,\n        filter_config: Optional[Union[FilterConfig, dict]] = None,\n    ) -&gt; None:\n        self._primary_keys = _get_primary_keys(model)\n        self._primary_keys_types = {\n            pk.name: _get_python_type(pk) for pk in self._primary_keys\n        }\n        self.primary_key_names = [pk.name for pk in self._primary_keys]\n        self.session = session\n        self.crud = crud or FastCRUD(\n            model=model,\n            is_deleted_column=is_deleted_column,\n            deleted_at_column=deleted_at_column,\n            updated_at_column=updated_at_column,\n        )\n        self.model = model\n        self.create_schema = create_schema\n        self.update_schema = update_schema\n        self.delete_schema = delete_schema\n        self.include_in_schema = include_in_schema\n        self.path = path\n        self.tags = tags or []\n        self.router = APIRouter()\n        self.is_deleted_column = is_deleted_column\n        self.deleted_at_column = deleted_at_column\n        self.updated_at_column = updated_at_column\n        self.default_endpoint_names = {\n            \"create\": \"\",\n            \"read\": \"\",\n            \"update\": \"\",\n            \"delete\": \"\",\n            \"db_delete\": \"db_delete\",\n            \"read_multi\": \"\",\n        }\n        self.endpoint_names = {**self.default_endpoint_names, **(endpoint_names or {})}\n        if filter_config:\n            if isinstance(filter_config, dict):\n                filter_config = FilterConfig(**filter_config)\n            self._validate_filter_config(filter_config)\n        self.filter_config = filter_config\n        self.column_types = _get_column_types(model)\n\n    def _validate_filter_config(self, filter_config: FilterConfig) -&gt; None:\n        model_columns = self.crud.model_col_names\n        for key in filter_config.filters.keys():\n            if key not in model_columns:\n                raise ValueError(\n                    f\"Invalid filter column '{key}': not found in model '{self.model.__name__}' columns\"\n                )\n\n    def _create_item(self):\n        \"\"\"Creates an endpoint for creating items in the database.\"\"\"\n\n        async def endpoint(\n            db: AsyncSession = Depends(self.session),\n            item: self.create_schema = Body(...),  # type: ignore\n        ):\n            unique_columns = _extract_unique_columns(self.model)\n\n            for column in unique_columns:\n                col_name = column.name\n                if hasattr(item, col_name):\n                    value = getattr(item, col_name)\n                    exists = await self.crud.exists(db, **{col_name: value})\n                    if exists:  # pragma: no cover\n                        raise DuplicateValueException(\n                            f\"Value {value} is already registered\"\n                        )\n\n            return await self.crud.create(db, item)\n\n        return endpoint\n\n    def _read_item(self):\n        \"\"\"Creates an endpoint for reading a single item from the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            item = await self.crud.get(db, **pkeys)\n            if not item:  # pragma: no cover\n                raise NotFoundException(detail=\"Item not found\")\n            return item  # pragma: no cover\n\n        return endpoint\n\n    def _read_items(self):\n        \"\"\"Creates an endpoint for reading multiple items from the database.\"\"\"\n        dynamic_filters = _create_dynamic_filters(self.filter_config, self.column_types)\n\n        async def endpoint(\n            db: AsyncSession = Depends(self.session),\n            offset: Optional[int] = Query(\n                None, description=\"Offset for unpaginated queries\"\n            ),\n            limit: Optional[int] = Query(\n                None, description=\"Limit for unpaginated queries\"\n            ),\n            page: Optional[int] = Query(None, alias=\"page\", description=\"Page number\"),\n            items_per_page: Optional[int] = Query(\n                None, alias=\"itemsPerPage\", description=\"Number of items per page\"\n            ),\n            filters: dict = Depends(dynamic_filters),\n        ):\n            is_paginated = (page is not None) and (items_per_page is not None)\n            has_offset_limit = (offset is not None) and (limit is not None)\n\n            if is_paginated and has_offset_limit:\n                raise BadRequestException(\n                    detail=\"Conflicting parameters: Use either 'page' and 'itemsPerPage' for paginated results or 'offset' and 'limit' for specific range queries.\"\n                )\n\n            if is_paginated:\n                offset = compute_offset(page=page, items_per_page=items_per_page)  # type: ignore\n                limit = items_per_page\n                crud_data = await self.crud.get_multi(\n                    db, offset=offset, limit=limit, **filters\n                )\n                return paginated_response(\n                    crud_data=crud_data,\n                    page=page, # type: ignore\n                    items_per_page=items_per_page,  # type: ignore\n                )\n\n            if not has_offset_limit:\n                offset = 0\n                limit = 100\n\n            crud_data = await self.crud.get_multi(\n                db,\n                offset=offset, # type: ignore\n                limit=limit, # type: ignore\n                **filters,\n            )\n            return crud_data  # pragma: no cover\n\n        return endpoint\n\n    def _update_item(self):\n        \"\"\"Creates an endpoint for updating an existing item in the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(\n            item: self.update_schema = Body(...),  # type: ignore\n            db: AsyncSession = Depends(self.session),\n            **pkeys,\n        ):\n            return await self.crud.update(db, item, **pkeys)\n\n        return endpoint\n\n    def _delete_item(self):\n        \"\"\"Creates an endpoint for deleting an item from the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            await self.crud.delete(db, **pkeys)\n            return {\"message\": \"Item deleted successfully\"}  # pragma: no cover\n\n        return endpoint\n\n    def _db_delete(self):\n        \"\"\"\n        Creates an endpoint for hard deleting an item from the database.\n\n        This endpoint is only added if the `delete_schema` is provided during initialization.\n        The endpoint expects an item ID as a path parameter and uses the provided SQLAlchemy\n        async session to permanently delete the item from the database.\n        \"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            await self.crud.db_delete(db, **pkeys)\n            return {\n                \"message\": \"Item permanently deleted from the database\"\n            }  # pragma: no cover\n\n        return endpoint\n\n    def _get_endpoint_path(self, operation: str):\n        endpoint_name = self.endpoint_names.get(\n            operation, self.default_endpoint_names.get(operation, operation)\n        )\n        path = f\"{self.path}/{endpoint_name}\" if endpoint_name else self.path\n\n        if operation in {\"read\", \"update\", \"delete\", \"db_delete\"}:\n            _primary_keys_path_suffix = \"/\".join(\n                f\"{{{n}}}\" for n in self.primary_key_names\n            )\n            path = f\"{path}/{_primary_keys_path_suffix}\"\n\n        return path\n\n    def add_routes_to_router(\n        self,\n        create_deps: Sequence[Callable] = [],\n        read_deps: Sequence[Callable] = [],\n        read_multi_deps: Sequence[Callable] = [],\n        update_deps: Sequence[Callable] = [],\n        delete_deps: Sequence[Callable] = [],\n        db_delete_deps: Sequence[Callable] = [],\n        included_methods: Optional[Sequence[str]] = None,\n        deleted_methods: Optional[Sequence[str]] = None,\n    ):\n        \"\"\"\n        Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.\n\n        This method registers routes for create, read, update, and delete operations with the FastAPI router,\n        allowing for custom dependency injection for each type of operation.\n\n        Args:\n            create_deps: List of functions to be injected as dependencies for the create endpoint.\n            read_deps: List of functions to be injected as dependencies for the read endpoint.\n            read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.\n            update_deps: List of functions to be injected as dependencies for the update endpoint.\n            delete_deps: List of functions to be injected as dependencies for the delete endpoint.\n            db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.\n            included_methods: Optional list of methods to include. Defaults to all CRUD methods.\n            deleted_methods: Optional list of methods to exclude. Defaults to `None`.\n\n        Raises:\n            ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n        Examples:\n            Selective Endpoint Creation:\n\n            ```python\n            # Only create 'create' and 'read' endpoints\n            endpoint_creator.add_routes_to_router(\n                included_methods=[\"create\", \"read\"],\n            )\n            ```\n\n            Excluding Specific Endpoints:\n\n            ```python\n            # Create all endpoints except 'delete' and 'db_delete'\n            endpoint_creator.add_routes_to_router(\n                deleted_methods=[\"delete\", \"db_delete\"],\n            )\n            ```\n\n            With Custom Dependencies and Selective Endpoints:\n\n            ```python\n            def get_current_user(...):\n                ...\n\n            # Create only 'read' and 'update' endpoints with custom dependencies\n            endpoint_creator.add_routes_to_router(\n                read_deps=[get_current_user],\n                update_deps=[get_current_user],\n                included_methods=[\"read\", \"update\"],\n            )\n            ```\n\n        Note:\n            This method should be called to register the endpoints with the FastAPI application.\n            If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.\n            This method assumes `id` is the primary key for path parameters.\n        \"\"\"\n        if (included_methods is not None) and (deleted_methods is not None):\n            raise ValueError(\n                \"Cannot use both 'included_methods' and 'deleted_methods' simultaneously.\"\n            )\n\n        if included_methods is None:\n            included_methods = [\n                \"create\",\n                \"read\",\n                \"read_multi\",\n                \"update\",\n                \"delete\",\n                \"db_delete\",\n            ]\n        else:\n            try:\n                included_methods = CRUDMethods(\n                    valid_methods=included_methods\n                ).valid_methods\n            except ValidationError as e:\n                raise ValueError(f\"Invalid CRUD methods in included_methods: {e}\")\n\n        if deleted_methods is None:\n            deleted_methods = []\n        else:\n            try:\n                deleted_methods = CRUDMethods(\n                    valid_methods=deleted_methods\n                ).valid_methods\n            except ValidationError as e:\n                raise ValueError(f\"Invalid CRUD methods in deleted_methods: {e}\")\n\n        delete_description = \"Delete a\"\n        if self.delete_schema:\n            delete_description = \"Soft delete a\"\n\n        if (\"create\" in included_methods) and (\"create\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"create\"),\n                self._create_item(),\n                methods=[\"POST\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(create_deps),\n                description=f\"Create a new {self.model.__name__} row in the database.\",\n            )\n\n        if (\"read\" in included_methods) and (\"read\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"read\"),\n                self._read_item(),\n                methods=[\"GET\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(read_deps),\n                description=f\"Read a single {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\"read_multi\" in included_methods) and (\"read_multi\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"read_multi\"),\n                self._read_items(),\n                methods=[\"GET\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(read_multi_deps),\n                description=f\"Read multiple {self.model.__name__} rows from the database with a limit and an offset.\",\n            )\n\n        if (\"update\" in included_methods) and (\"update\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"update\"),\n                self._update_item(),\n                methods=[\"PATCH\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(update_deps),\n                description=f\"Update an existing {self.model.__name__} row in the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\"delete\" in included_methods) and (\"delete\" not in deleted_methods):\n            path = self._get_endpoint_path(operation=\"delete\")\n            self.router.add_api_route(\n                path,\n                self._delete_item(),\n                methods=[\"DELETE\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(delete_deps),\n                description=f\"{delete_description} {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\n            (\"db_delete\" in included_methods)\n            and (\"db_delete\" not in deleted_methods)\n            and self.delete_schema\n        ):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"db_delete\"),\n                self._db_delete(),\n                methods=[\"DELETE\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(db_delete_deps),\n                description=f\"Permanently delete a {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n    def add_custom_route(\n        self,\n        endpoint: Callable,\n        methods: Optional[Union[set[str], list[str]]],\n        path: Optional[str] = None,\n        dependencies: Optional[Sequence[Callable]] = None,\n        include_in_schema: bool = True,\n        tags: Optional[list[Union[str, Enum]]] = None,\n        summary: Optional[str] = None,\n        description: Optional[str] = None,\n        response_description: str = \"Successful Response\",\n    ) -&gt; None:\n        \"\"\"\n        Adds a custom route to the FastAPI router.\n\n        Args:\n            endpoint: The endpoint function to execute when the route is called.\n            methods: A list of HTTP methods for the route (e.g., `['GET', 'POST']`).\n            path: URL path for the custom route.\n            dependencies: A list of functions to be injected as dependencies for the route.\n            include_in_schema: Whether to include this route in the OpenAPI schema.\n            tags: Tags for grouping and categorizing the route in documentation.\n            summary: A short summary of the route, for documentation.\n            description: A detailed description of the route, for documentation.\n            response_description: A description of the response, for documentation.\n\n        Example:\n            ```python\n            async def custom_endpoint(foo: int, bar: str):\n                # custom logic here\n                return {\"foo\": foo, \"bar\": bar}\n\n            endpoint_creator.add_custom_route(\n                endpoint=custom_endpoint,\n                methods=[\"GET\"],\n                path=\"/custom\",\n                tags=[\"custom\"],\n                summary=\"Custom Endpoint\",\n                description=\"This is a custom endpoint.\",\n            )\n            ```\n        \"\"\"\n        path = path or self.path\n        full_path = f\"{self.path}{path}\"\n        self.router.add_api_route(\n            path=full_path,\n            endpoint=endpoint,\n            methods=methods,\n            dependencies=_inject_dependencies(dependencies) or [],\n            include_in_schema=include_in_schema,\n            tags=tags or self.tags,\n            summary=summary,\n            description=description,\n            response_description=response_description,\n        )\n</code></pre>"},{"location":"api/endpoint_creator/#fastcrud.EndpointCreator.add_custom_route","title":"<code>add_custom_route(endpoint, methods, path=None, dependencies=None, include_in_schema=True, tags=None, summary=None, description=None, response_description='Successful Response')</code>","text":"<p>Adds a custom route to the FastAPI router.</p> <p>Parameters:</p> Name Type Description Default <code>endpoint</code> <code>Callable</code> <p>The endpoint function to execute when the route is called.</p> required <code>methods</code> <code>Optional[Union[set[str], list[str]]]</code> <p>A list of HTTP methods for the route (e.g., <code>['GET', 'POST']</code>).</p> required <code>path</code> <code>Optional[str]</code> <p>URL path for the custom route.</p> <code>None</code> <code>dependencies</code> <code>Optional[Sequence[Callable]]</code> <p>A list of functions to be injected as dependencies for the route.</p> <code>None</code> <code>include_in_schema</code> <code>bool</code> <p>Whether to include this route in the OpenAPI schema.</p> <code>True</code> <code>tags</code> <code>Optional[list[Union[str, Enum]]]</code> <p>Tags for grouping and categorizing the route in documentation.</p> <code>None</code> <code>summary</code> <code>Optional[str]</code> <p>A short summary of the route, for documentation.</p> <code>None</code> <code>description</code> <code>Optional[str]</code> <p>A detailed description of the route, for documentation.</p> <code>None</code> <code>response_description</code> <code>str</code> <p>A description of the response, for documentation.</p> <code>'Successful Response'</code> Example <pre><code>async def custom_endpoint(foo: int, bar: str):\n    # custom logic here\n    return {\"foo\": foo, \"bar\": bar}\n\nendpoint_creator.add_custom_route(\n    endpoint=custom_endpoint,\n    methods=[\"GET\"],\n    path=\"/custom\",\n    tags=[\"custom\"],\n    summary=\"Custom Endpoint\",\n    description=\"This is a custom endpoint.\",\n)\n</code></pre> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>def add_custom_route(\n    self,\n    endpoint: Callable,\n    methods: Optional[Union[set[str], list[str]]],\n    path: Optional[str] = None,\n    dependencies: Optional[Sequence[Callable]] = None,\n    include_in_schema: bool = True,\n    tags: Optional[list[Union[str, Enum]]] = None,\n    summary: Optional[str] = None,\n    description: Optional[str] = None,\n    response_description: str = \"Successful Response\",\n) -&gt; None:\n    \"\"\"\n    Adds a custom route to the FastAPI router.\n\n    Args:\n        endpoint: The endpoint function to execute when the route is called.\n        methods: A list of HTTP methods for the route (e.g., `['GET', 'POST']`).\n        path: URL path for the custom route.\n        dependencies: A list of functions to be injected as dependencies for the route.\n        include_in_schema: Whether to include this route in the OpenAPI schema.\n        tags: Tags for grouping and categorizing the route in documentation.\n        summary: A short summary of the route, for documentation.\n        description: A detailed description of the route, for documentation.\n        response_description: A description of the response, for documentation.\n\n    Example:\n        ```python\n        async def custom_endpoint(foo: int, bar: str):\n            # custom logic here\n            return {\"foo\": foo, \"bar\": bar}\n\n        endpoint_creator.add_custom_route(\n            endpoint=custom_endpoint,\n            methods=[\"GET\"],\n            path=\"/custom\",\n            tags=[\"custom\"],\n            summary=\"Custom Endpoint\",\n            description=\"This is a custom endpoint.\",\n        )\n        ```\n    \"\"\"\n    path = path or self.path\n    full_path = f\"{self.path}{path}\"\n    self.router.add_api_route(\n        path=full_path,\n        endpoint=endpoint,\n        methods=methods,\n        dependencies=_inject_dependencies(dependencies) or [],\n        include_in_schema=include_in_schema,\n        tags=tags or self.tags,\n        summary=summary,\n        description=description,\n        response_description=response_description,\n    )\n</code></pre>"},{"location":"api/endpoint_creator/#fastcrud.EndpointCreator.add_routes_to_router","title":"<code>add_routes_to_router(create_deps=[], read_deps=[], read_multi_deps=[], update_deps=[], delete_deps=[], db_delete_deps=[], included_methods=None, deleted_methods=None)</code>","text":"<p>Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</p> <p>This method registers routes for create, read, update, and delete operations with the FastAPI router, allowing for custom dependency injection for each type of operation.</p> <p>Parameters:</p> Name Type Description Default <code>create_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the create endpoint.</p> <code>[]</code> <code>read_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the read endpoint.</p> <code>[]</code> <code>read_multi_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the read multiple items endpoint.</p> <code>[]</code> <code>update_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the update endpoint.</p> <code>[]</code> <code>delete_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the delete endpoint.</p> <code>[]</code> <code>db_delete_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the hard delete endpoint.</p> <code>[]</code> <code>included_methods</code> <code>Optional[Sequence[str]]</code> <p>Optional list of methods to include. Defaults to all CRUD methods.</p> <code>None</code> <code>deleted_methods</code> <code>Optional[Sequence[str]]</code> <p>Optional list of methods to exclude. Defaults to <code>None</code>.</p> <code>None</code> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> <p>Selective Endpoint Creation:</p> <pre><code># Only create 'create' and 'read' endpoints\nendpoint_creator.add_routes_to_router(\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Excluding Specific Endpoints:</p> <pre><code># Create all endpoints except 'delete' and 'db_delete'\nendpoint_creator.add_routes_to_router(\n    deleted_methods=[\"delete\", \"db_delete\"],\n)\n</code></pre> <p>With Custom Dependencies and Selective Endpoints:</p> <pre><code>def get_current_user(...):\n    ...\n\n# Create only 'read' and 'update' endpoints with custom dependencies\nendpoint_creator.add_routes_to_router(\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n    included_methods=[\"read\", \"update\"],\n)\n</code></pre> Note <p>This method should be called to register the endpoints with the FastAPI application. If <code>delete_schema</code> is provided on class instantiation, a hard delete endpoint is also registered. This method assumes <code>id</code> is the primary key for path parameters.</p> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>def add_routes_to_router(\n    self,\n    create_deps: Sequence[Callable] = [],\n    read_deps: Sequence[Callable] = [],\n    read_multi_deps: Sequence[Callable] = [],\n    update_deps: Sequence[Callable] = [],\n    delete_deps: Sequence[Callable] = [],\n    db_delete_deps: Sequence[Callable] = [],\n    included_methods: Optional[Sequence[str]] = None,\n    deleted_methods: Optional[Sequence[str]] = None,\n):\n    \"\"\"\n    Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.\n\n    This method registers routes for create, read, update, and delete operations with the FastAPI router,\n    allowing for custom dependency injection for each type of operation.\n\n    Args:\n        create_deps: List of functions to be injected as dependencies for the create endpoint.\n        read_deps: List of functions to be injected as dependencies for the read endpoint.\n        read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.\n        update_deps: List of functions to be injected as dependencies for the update endpoint.\n        delete_deps: List of functions to be injected as dependencies for the delete endpoint.\n        db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.\n        included_methods: Optional list of methods to include. Defaults to all CRUD methods.\n        deleted_methods: Optional list of methods to exclude. Defaults to `None`.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        Selective Endpoint Creation:\n\n        ```python\n        # Only create 'create' and 'read' endpoints\n        endpoint_creator.add_routes_to_router(\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Excluding Specific Endpoints:\n\n        ```python\n        # Create all endpoints except 'delete' and 'db_delete'\n        endpoint_creator.add_routes_to_router(\n            deleted_methods=[\"delete\", \"db_delete\"],\n        )\n        ```\n\n        With Custom Dependencies and Selective Endpoints:\n\n        ```python\n        def get_current_user(...):\n            ...\n\n        # Create only 'read' and 'update' endpoints with custom dependencies\n        endpoint_creator.add_routes_to_router(\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n            included_methods=[\"read\", \"update\"],\n        )\n        ```\n\n    Note:\n        This method should be called to register the endpoints with the FastAPI application.\n        If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.\n        This method assumes `id` is the primary key for path parameters.\n    \"\"\"\n    if (included_methods is not None) and (deleted_methods is not None):\n        raise ValueError(\n            \"Cannot use both 'included_methods' and 'deleted_methods' simultaneously.\"\n        )\n\n    if included_methods is None:\n        included_methods = [\n            \"create\",\n            \"read\",\n            \"read_multi\",\n            \"update\",\n            \"delete\",\n            \"db_delete\",\n        ]\n    else:\n        try:\n            included_methods = CRUDMethods(\n                valid_methods=included_methods\n            ).valid_methods\n        except ValidationError as e:\n            raise ValueError(f\"Invalid CRUD methods in included_methods: {e}\")\n\n    if deleted_methods is None:\n        deleted_methods = []\n    else:\n        try:\n            deleted_methods = CRUDMethods(\n                valid_methods=deleted_methods\n            ).valid_methods\n        except ValidationError as e:\n            raise ValueError(f\"Invalid CRUD methods in deleted_methods: {e}\")\n\n    delete_description = \"Delete a\"\n    if self.delete_schema:\n        delete_description = \"Soft delete a\"\n\n    if (\"create\" in included_methods) and (\"create\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"create\"),\n            self._create_item(),\n            methods=[\"POST\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(create_deps),\n            description=f\"Create a new {self.model.__name__} row in the database.\",\n        )\n\n    if (\"read\" in included_methods) and (\"read\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"read\"),\n            self._read_item(),\n            methods=[\"GET\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(read_deps),\n            description=f\"Read a single {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\"read_multi\" in included_methods) and (\"read_multi\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"read_multi\"),\n            self._read_items(),\n            methods=[\"GET\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(read_multi_deps),\n            description=f\"Read multiple {self.model.__name__} rows from the database with a limit and an offset.\",\n        )\n\n    if (\"update\" in included_methods) and (\"update\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"update\"),\n            self._update_item(),\n            methods=[\"PATCH\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(update_deps),\n            description=f\"Update an existing {self.model.__name__} row in the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\"delete\" in included_methods) and (\"delete\" not in deleted_methods):\n        path = self._get_endpoint_path(operation=\"delete\")\n        self.router.add_api_route(\n            path,\n            self._delete_item(),\n            methods=[\"DELETE\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(delete_deps),\n            description=f\"{delete_description} {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\n        (\"db_delete\" in included_methods)\n        and (\"db_delete\" not in deleted_methods)\n        and self.delete_schema\n    ):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"db_delete\"),\n            self._db_delete(),\n            methods=[\"DELETE\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(db_delete_deps),\n            description=f\"Permanently delete a {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n</code></pre>"},{"location":"api/fastcrud/","title":"FastCRUD API Reference","text":"<p><code>FastCRUD</code> is a base class for CRUD operations on a model, utilizing Pydantic schemas for data validation and serialization.</p>"},{"location":"api/fastcrud/#class-definition","title":"Class Definition","text":"<p>             Bases: <code>Generic[ModelType, CreateSchemaType, UpdateSchemaType, UpdateSchemaInternalType, DeleteSchemaType]</code></p> <p>Base class for CRUD operations on a model.</p> <p>This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model, utilizing Pydantic schemas for data validation and serialization.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>type[ModelType]</code> <p>The SQLAlchemy model type.</p> required <code>is_deleted_column</code> <code>str</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>'is_deleted'</code> <code>deleted_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>'deleted_at'</code> <code>updated_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>'updated_at'</code> <p>Methods:</p> Name Description <code>create</code> <p>Creates a new record in the database from the provided Pydantic schema.</p> <code>select</code> <p>Generates a SQL Alchemy <code>Select</code> statement with optional filtering and sorting.</p> <code>get</code> <p>Retrieves a single record based on filters. Supports advanced filtering through comparison operators like <code>__gt</code>, <code>__lt</code>, etc.</p> <code>exists</code> <p>Checks if a record exists based on the provided filters.</p> <code>count</code> <p>Counts the number of records matching the provided filters.</p> <code>get_multi</code> <p>Fetches multiple records with optional sorting, pagination, and model conversion.</p> <code>get_joined</code> <p>Performs a join operation with another model, supporting custom join conditions and selection of specific columns.</p> <code>get_multi_joined</code> <p>Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.</p> <code>get_multi_by_cursor</code> <p>Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.</p> <code>update</code> <p>Updates an existing record or multiple records based on specified filters.</p> <code>db_delete</code> <p>Hard deletes a record or multiple records from the database based on provided filters.</p> <code>delete</code> <p>Soft deletes a record if it has an <code>\"is_deleted\"</code> attribute (or other attribute as defined by <code>is_deleted_column</code>); otherwise, performs a hard delete.</p> <p>Examples:</p> Models and Schemas Used Below <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>product/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadProductSchema(BaseModel):\n    id: int\n    name: str | None = None\n    price: float | None = None\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n</code></pre> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> <code>profile/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Profile(Base):\n    __tablename__ = \"profile\"\n    id = Column(Integer, primary_key=True)\n    bio = Column(String)\n</code></pre> <code>profile/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadProfileSchema(BaseModel):\n    id: int\n    bio: str | None = None\n</code></pre> <code>author/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Author(Base):\n    __tablename__ = \"author\"\n    id = Column(Integer, primary_key=True)\n    profile_id = Column(Integer, ForeignKey(\"profile.id\"))\n    name = Column(String)\n</code></pre> <code>author/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadAuthorSchema(BaseModel):\n    id: int\n    profile_id: int | None = None\n    name: str | None = None\n</code></pre> <code>article/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Article(Base):\n    __tablename__ = \"article\"\n    id = Column(Integer, primary_key=True)\n    author_id = Column(Integer, ForeignKey(\"author.id\"))\n    title = Column(String)\n    content = Column(String)\n</code></pre> <code>article/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadArticleSchema(BaseModel):\n    id: int\n    author_id: int | None = None\n    title: str | None = None\n    content: str | None = None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-1-basic-usage","title":"Example 1: Basic Usage","text":"<p>Create a FastCRUD instance for a <code>User</code> model and perform basic CRUD operations.</p> <pre><code># Assuming you have a User model (either SQLAlchemy or SQLModel)\n# pydantic schemas for creation, update and deletion and an async session `db`\nUserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\nuser_crud = UserCRUD(User)\n\n# If you don't care about typing, you can also just ignore the UserCRUD part\n# Straight up define user_crud with FastCRUD\nuser_crud = FastCRUD(User)\n\n# Create a new user\nnew_user = await user_crud.create(db, CreateUserSchema(name=\"Alice\"))\n# Read a user\nuser = await user_crud.get(db, id=new_user.id)\n# Update a user\nawait user_crud.update(db, UpdateUserSchema(email=\"alice@example.com\"), id=new_user.id)\n# Delete a user\nawait user_crud.delete(db, id=new_user.id)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-2-advanced-filtering-and-pagination","title":"Example 2: Advanced Filtering and Pagination","text":"<p>Use advanced filtering, sorting, and pagination for fetching records.</p> <pre><code>product_crud = FastCRUD(Product)\nproducts = await product_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns=['price'],\n    sort_orders=['asc'],\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-3-join-operations-with-custom-schemas","title":"Example 3: Join Operations with Custom Schemas","text":"<p>Perform join operations between two models using custom schemas for selection.</p> <pre><code>order_crud = FastCRUD(Order)\norders = await order_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Product,\n    join_prefix=\"product_\",\n    join_schema_to_select=ReadProductSchema,\n    offset=0,\n    limit=5,\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-4-cursor-pagination","title":"Example 4: Cursor Pagination","text":"<p>Implement cursor-based pagination for efficient data retrieval in large datasets.</p> <pre><code>class Comment(Base):\n    id = Column(Integer, primary_key=True)\n    user_id = Column(Integer, ForeignKey(\"user.id\"))\n    subject = Column(String)\n    body = Column(String)\n\ncomment_crud = FastCRUD(Comment)\n\nfirst_page = await comment_crud.get_multi_by_cursor(db, limit=10)\nnext_cursor = first_page['next_cursor']\nsecond_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-5-dynamic-filtering-and-counting","title":"Example 5: Dynamic Filtering and Counting","text":"<p>Dynamically filter records based on various criteria and count the results.</p> <pre><code>task_crud = FastCRUD(Task)\ncompleted_tasks = await task_crud.get_multi(\n    db,\n    status='completed',\n)\nhigh_priority_task_count = await task_crud.count(\n    db,\n    priority='high',\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-6-using-custom-column-names-for-soft-delete","title":"Example 6: Using Custom Column Names for Soft Delete","text":"<p>If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the <code>FastCRUD</code> instance.</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    ...\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n\n\ncustom_user_crud = FastCRUD(\n    User,\n    is_deleted_column=\"archived\",\n    deleted_at_column=\"archived_at\",\n)\n# Now 'archived' and 'archived_at' will be used for soft delete operations.\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>class FastCRUD(\n    Generic[\n        ModelType,\n        CreateSchemaType,\n        UpdateSchemaType,\n        UpdateSchemaInternalType,\n        DeleteSchemaType,\n    ]\n):\n    \"\"\"\n    Base class for CRUD operations on a model.\n\n    This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model,\n    utilizing Pydantic schemas for data validation and serialization.\n\n    Args:\n        model: The SQLAlchemy model type.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n\n    Methods:\n        create:\n            Creates a new record in the database from the provided Pydantic schema.\n\n        select:\n            Generates a SQL Alchemy `Select` statement with optional filtering and sorting.\n\n        get:\n            Retrieves a single record based on filters. Supports advanced filtering through comparison operators like `__gt`, `__lt`, etc.\n\n        exists:\n            Checks if a record exists based on the provided filters.\n\n        count:\n            Counts the number of records matching the provided filters.\n\n        get_multi:\n            Fetches multiple records with optional sorting, pagination, and model conversion.\n\n        get_joined:\n            Performs a join operation with another model, supporting custom join conditions and selection of specific columns.\n\n        get_multi_joined:\n            Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.\n\n        get_multi_by_cursor:\n            Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.\n\n        update:\n            Updates an existing record or multiple records based on specified filters.\n\n        db_delete:\n            Hard deletes a record or multiple records from the database based on provided filters.\n\n        delete:\n            Soft deletes a record if it has an `\"is_deleted\"` attribute (or other attribute as defined by `is_deleted_column`); otherwise, performs a hard delete.\n\n    Examples:\n        ??? example \"Models and Schemas Used Below\"\n\n            ??? example \"`customer/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/model.py:imports\n                fastcrud/examples/customer/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/model.py:imports\n                fastcrud/examples/product/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/schemas.py:imports\n                fastcrud/examples/product/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`order/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/model.py:imports\n                fastcrud/examples/order/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`order/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/schemas.py:imports\n                fastcrud/examples/order/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`tier/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/model.py:imports\n                fastcrud/examples/tier/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`tier/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/schemas.py:imports\n                fastcrud/examples/tier/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`department/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/model.py:imports\n                fastcrud/examples/department/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`department/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/schemas.py:imports\n                fastcrud/examples/department/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`user/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/model.py:imports\n                fastcrud/examples/user/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`user/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/schemas.py:imports\n                fastcrud/examples/user/schemas.py:createschema\n                fastcrud/examples/user/schemas.py:readschema\n                fastcrud/examples/user/schemas.py:updateschema\n                fastcrud/examples/user/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`story/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/model.py:imports\n                fastcrud/examples/story/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`story/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/schemas.py:imports\n                fastcrud/examples/story/schemas.py:createschema\n                fastcrud/examples/story/schemas.py:readschema\n                fastcrud/examples/story/schemas.py:updateschema\n                fastcrud/examples/story/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`task/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/model.py:imports\n                fastcrud/examples/task/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`task/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/schemas.py:imports\n                fastcrud/examples/task/schemas.py:createschema\n                fastcrud/examples/task/schemas.py:readschema\n                fastcrud/examples/task/schemas.py:updateschema\n                fastcrud/examples/task/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`profile/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/profile/model.py:imports\n                fastcrud/examples/profile/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`profile/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/profile/schemas.py:imports\n                fastcrud/examples/profile/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`author/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/author/model.py:imports\n                fastcrud/examples/author/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`author/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/author/schemas.py:imports\n                fastcrud/examples/author/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`article/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/article/model.py:imports\n                fastcrud/examples/article/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`article/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/article/schemas.py:imports\n                fastcrud/examples/article/schemas.py:readschema\n                --8&lt;--\n                ```\n\n        Example 1: Basic Usage\n        ----------------------\n\n        Create a FastCRUD instance for a `User` model and perform basic CRUD operations.\n\n        ```python\n        # Assuming you have a User model (either SQLAlchemy or SQLModel)\n        # pydantic schemas for creation, update and deletion and an async session `db`\n        UserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\n        user_crud = UserCRUD(User)\n\n        # If you don't care about typing, you can also just ignore the UserCRUD part\n        # Straight up define user_crud with FastCRUD\n        user_crud = FastCRUD(User)\n\n        # Create a new user\n        new_user = await user_crud.create(db, CreateUserSchema(name=\"Alice\"))\n        # Read a user\n        user = await user_crud.get(db, id=new_user.id)\n        # Update a user\n        await user_crud.update(db, UpdateUserSchema(email=\"alice@example.com\"), id=new_user.id)\n        # Delete a user\n        await user_crud.delete(db, id=new_user.id)\n        ```\n\n        Example 2: Advanced Filtering and Pagination\n        --------------------------------------------\n\n        Use advanced filtering, sorting, and pagination for fetching records.\n\n        ```python\n        product_crud = FastCRUD(Product)\n        products = await product_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            sort_columns=['price'],\n            sort_orders=['asc'],\n        )\n        ```\n\n        Example 3: Join Operations with Custom Schemas\n        ----------------------------------------------\n\n        Perform join operations between two models using custom schemas for selection.\n\n        ```python\n        order_crud = FastCRUD(Order)\n        orders = await order_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadOrderSchema,\n            join_model=Product,\n            join_prefix=\"product_\",\n            join_schema_to_select=ReadProductSchema,\n            offset=0,\n            limit=5,\n        )\n        ```\n\n        Example 4: Cursor Pagination\n        ----------------------------\n\n        Implement cursor-based pagination for efficient data retrieval in large datasets.\n\n        ```python\n        class Comment(Base):\n            id = Column(Integer, primary_key=True)\n            user_id = Column(Integer, ForeignKey(\"user.id\"))\n            subject = Column(String)\n            body = Column(String)\n\n        comment_crud = FastCRUD(Comment)\n\n        first_page = await comment_crud.get_multi_by_cursor(db, limit=10)\n        next_cursor = first_page['next_cursor']\n        second_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)\n        ```\n\n        Example 5: Dynamic Filtering and Counting\n        -----------------------------------------\n        Dynamically filter records based on various criteria and count the results.\n\n        ```python\n        task_crud = FastCRUD(Task)\n        completed_tasks = await task_crud.get_multi(\n            db,\n            status='completed',\n        )\n        high_priority_task_count = await task_crud.count(\n            db,\n            priority='high',\n        )\n        ```\n\n        Example 6: Using Custom Column Names for Soft Delete\n        ----------------------------------------------------\n\n        If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the `FastCRUD` instance.\n\n        ```python\n        --8&lt;--\n        fastcrud/examples/user/model.py:model_common\n        --8&lt;--\n            ...\n        --8&lt;--\n        fastcrud/examples/user/model.py:model_archived\n        --8&lt;--\n\n\n        custom_user_crud = FastCRUD(\n            User,\n            is_deleted_column=\"archived\",\n            deleted_at_column=\"archived_at\",\n        )\n        # Now 'archived' and 'archived_at' will be used for soft delete operations.\n        ```\n    \"\"\"\n\n    _SUPPORTED_FILTERS = {\n        \"gt\": lambda column: column.__gt__,\n        \"lt\": lambda column: column.__lt__,\n        \"gte\": lambda column: column.__ge__,\n        \"lte\": lambda column: column.__le__,\n        \"ne\": lambda column: column.__ne__,\n        \"is\": lambda column: column.is_,\n        \"is_not\": lambda column: column.is_not,\n        \"like\": lambda column: column.like,\n        \"notlike\": lambda column: column.notlike,\n        \"ilike\": lambda column: column.ilike,\n        \"notilike\": lambda column: column.notilike,\n        \"startswith\": lambda column: column.startswith,\n        \"endswith\": lambda column: column.endswith,\n        \"contains\": lambda column: column.contains,\n        \"match\": lambda column: column.match,\n        \"between\": lambda column: column.between,\n        \"in\": lambda column: column.in_,\n        \"not_in\": lambda column: column.not_in,\n    }\n\n    def __init__(\n        self,\n        model: type[ModelType],\n        is_deleted_column: str = \"is_deleted\",\n        deleted_at_column: str = \"deleted_at\",\n        updated_at_column: str = \"updated_at\",\n    ) -&gt; None:\n        self.model = model\n        self.model_col_names = [col.key for col in model.__table__.columns]\n        self.is_deleted_column = is_deleted_column\n        self.deleted_at_column = deleted_at_column\n        self.updated_at_column = updated_at_column\n        self._primary_keys = _get_primary_keys(self.model)\n\n    def _get_sqlalchemy_filter(\n        self,\n        operator: str,\n        value: Any,\n    ) -&gt; Optional[Callable[[str], Callable]]:\n        if operator in {\"in\", \"not_in\", \"between\"}:\n            if not isinstance(value, (tuple, list, set)):\n                raise ValueError(f\"&lt;{operator}&gt; filter must be tuple, list or set\")\n        return self._SUPPORTED_FILTERS.get(operator)\n\n    def _parse_filters(\n        self, model: Optional[Union[type[ModelType], AliasedClass]] = None, **kwargs\n    ) -&gt; list[ColumnElement]:\n        model = model or self.model\n        filters = []\n\n        for key, value in kwargs.items():\n            if \"__\" in key:\n                field_name, op = key.rsplit(\"__\", 1)\n                column = getattr(model, field_name, None)\n                if column is None:\n                    raise ValueError(f\"Invalid filter column: {field_name}\")\n                if op == \"or\":\n                    or_filters = [\n                        sqlalchemy_filter(column)(or_value)\n                        for or_key, or_value in value.items()\n                        if (\n                            sqlalchemy_filter := self._get_sqlalchemy_filter(\n                                or_key, or_value\n                            )\n                        )\n                        is not None\n                    ]\n                    filters.append(or_(*or_filters))\n                else:\n                    sqlalchemy_filter = self._get_sqlalchemy_filter(op, value)\n                    if sqlalchemy_filter:\n                        filters.append(\n                            sqlalchemy_filter(column)(value)\n                            if op != \"between\"\n                            else sqlalchemy_filter(column)(*value)\n                        )\n            else:\n                column = getattr(model, key, None)\n                if column is not None:\n                    filters.append(column == value)\n\n        return filters\n\n    def _apply_sorting(\n        self,\n        stmt: Select,\n        sort_columns: Union[str, list[str]],\n        sort_orders: Optional[Union[str, list[str]]] = None,\n    ) -&gt; Select:\n        \"\"\"\n        Apply sorting to a SQLAlchemy query based on specified column names and sort orders.\n\n        Args:\n            stmt: The SQLAlchemy `Select` statement to which sorting will be applied.\n            sort_columns: A single column name or a list of column names on which to apply sorting.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding\n                to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n\n        Raises:\n            ValueError: Raised if sort orders are provided without corresponding sort columns,\n                or if an invalid sort order is provided (not `\"asc\"` or `\"desc\"`).\n            ArgumentError: Raised if an invalid column name is provided that does not exist in the model.\n\n        Returns:\n            The modified `Select` statement with sorting applied.\n\n        Examples:\n            Applying ascending sort on a single column:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, 'name')\n\n            Applying descending sort on a single column:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, 'age', 'desc')\n\n            Applying mixed sort orders on multiple columns:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, ['name', 'age'], ['asc', 'desc'])\n\n            Applying ascending sort on multiple columns:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, ['name', 'age'])\n\n        Note:\n            This method modifies the passed `Select` statement in-place by applying the `order_by` clause\n            based on the provided column names and sort orders.\n        \"\"\"\n        if sort_orders and not sort_columns:\n            raise ValueError(\"Sort orders provided without corresponding sort columns.\")\n\n        if sort_columns:\n            if not isinstance(sort_columns, list):\n                sort_columns = [sort_columns]\n\n            if sort_orders:\n                if not isinstance(sort_orders, list):\n                    sort_orders = [sort_orders] * len(sort_columns)\n                if len(sort_columns) != len(sort_orders):\n                    raise ValueError(\n                        \"The length of sort_columns and sort_orders must match.\"\n                    )\n\n                for idx, order in enumerate(sort_orders):\n                    if order not in [\"asc\", \"desc\"]:\n                        raise ValueError(\n                            f\"Invalid sort order: {order}. Only 'asc' or 'desc' are allowed.\"\n                        )\n\n            validated_sort_orders = (\n                [\"asc\"] * len(sort_columns) if not sort_orders else sort_orders\n            )\n\n            for idx, column_name in enumerate(sort_columns):\n                column = getattr(self.model, column_name, None)\n                if not column:\n                    raise ArgumentError(f\"Invalid column name: {column_name}\")\n\n                order = validated_sort_orders[idx]\n                stmt = stmt.order_by(asc(column) if order == \"asc\" else desc(column))\n\n        return stmt\n\n    def _prepare_and_apply_joins(\n        self,\n        stmt: Select,\n        joins_config: list[JoinConfig],\n        use_temporary_prefix: bool = False,\n    ):\n        \"\"\"\n        Applies joins to the given SQL statement based on a list of `JoinConfig` objects.\n\n        Args:\n            stmt: The initial SQL statement.\n            joins_config: Configurations for all joins.\n            use_temporary_prefix: Whether to use or not an additional prefix for joins. Default `False`.\n\n        Returns:\n            The modified SQL statement with joins applied.\n        \"\"\"\n        for join in joins_config:\n            model = join.alias or join.model\n            join_select = _extract_matching_columns_from_schema(\n                model,\n                join.schema_to_select,\n                join.join_prefix,\n                join.alias,\n                use_temporary_prefix,\n            )\n            joined_model_filters = self._parse_filters(\n                model=model, **(join.filters or {})\n            )\n\n            if join.join_type == \"left\":\n                stmt = stmt.outerjoin(model, join.join_on).add_columns(*join_select)\n            elif join.join_type == \"inner\":\n                stmt = stmt.join(model, join.join_on).add_columns(*join_select)\n            else:  # pragma: no cover\n                raise ValueError(f\"Unsupported join type: {join.join_type}.\")\n            if joined_model_filters:\n                stmt = stmt.filter(*joined_model_filters)\n\n        return stmt\n\n    async def create(\n        self, db: AsyncSession, object: CreateSchemaType, commit: bool = True\n    ) -&gt; ModelType:\n        \"\"\"\n        Create a new record in the database.\n\n        Args:\n            db: The SQLAlchemy async session.\n            object: The Pydantic schema containing the data to be saved.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n\n        Returns:\n            The created database object.\n        \"\"\"\n        object_dict = object.model_dump()\n        db_object: ModelType = self.model(**object_dict)\n        db.add(db_object)\n        if commit:\n            await db.commit()\n        return db_object\n\n    async def select(\n        self,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        **kwargs: Any,\n    ) -&gt; Select:\n        \"\"\"\n        Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.\n\n        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.\n            sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n        Returns:\n            An SQL Alchemy `Select` statement object that can be executed or further modified.\n\n        Examples:\n            Selecting specific columns with filtering and sorting:\n\n            ```python\n            stmt = await user_crud.select(\n                schema_to_select=ReadUserSchema,\n                sort_columns=['age', 'name'],\n                sort_orders=['asc', 'desc'],\n                age__gt=18,\n            )\n            ```\n\n            Creating a statement to select all users without any filters:\n\n            ```python\n            stmt = await user_crud.select()\n            ```\n\n            Selecting users with a specific `role`, ordered by `name`:\n\n            ```python\n            stmt = await user_crud.select(\n                schema_to_select=UserReadSchema,\n                sort_columns='name',\n                role='admin',\n            )\n            ```\n\n        Note:\n            This method does not execute the generated SQL statement.\n            Use `db.execute(stmt)` to run the query and fetch results.\n        \"\"\"\n        to_select = _extract_matching_columns_from_schema(\n            model=self.model, schema=schema_to_select\n        )\n        filters = self._parse_filters(**kwargs)\n        stmt = select(*to_select).filter(*filters)\n\n        if sort_columns:\n            stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n        return stmt\n\n    async def get(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n        **kwargs: Any,\n    ) -&gt; Optional[Union[dict, BaseModel]]:\n        \"\"\"\n        Fetches a single record based on specified filters.\n\n        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            schema_to_select: Optional Pydantic schema for selecting specific columns.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n            one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.\n            **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.\n\n        Raises:\n            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n        Returns:\n            A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.\n\n        Examples:\n            Fetch a user by ID:\n\n            ```python\n            user = await user_crud.get(db, id=1)\n            ```\n\n            Fetch a user with an age greater than 30:\n\n            ```python\n            user = await user_crud.get(db, age__gt=30)\n            ```\n\n            Fetch a user with a registration date before Jan 1, 2020:\n\n            ```python\n            user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n            ```\n\n            Fetch a user not equal to a specific username:\n\n            ```python\n            user = await user_crud.get(db, username__ne='admin')\n            ```\n        \"\"\"\n        stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n        db_row = await db.execute(stmt)\n        result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n        if result is None:\n            return None\n        out: dict = dict(result._mapping)\n        if not return_as_model:\n            return out\n        if not schema_to_select:\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        return schema_to_select(**out)\n\n    def _get_pk_dict(self, instance):\n        return {pk.name: getattr(instance, pk.name) for pk in self._primary_keys}\n\n    async def upsert(\n        self,\n        db: AsyncSession,\n        instance: Union[UpdateSchemaType, CreateSchemaType],\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n    ) -&gt; Union[BaseModel, Dict[str, Any], None]:\n        \"\"\"Update the instance or create it if it doesn't exists.\n\n        Note: This method will perform two transactions to the database (get and create or update).\n\n        Args:\n            db: The database session to use for the operation.\n            instance: A Pydantic schema representing the instance.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n\n        Returns:\n            The created or updated instance\n        \"\"\"\n        _pks = self._get_pk_dict(instance)\n        schema_to_select = schema_to_select or type(instance)\n        db_instance = await self.get(\n            db,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n            **_pks,\n        )\n        if db_instance is None:\n            db_instance = await self.create(db, instance)  # type: ignore\n            db_instance = schema_to_select.model_validate(\n                db_instance, from_attributes=True\n            )\n        else:\n            await self.update(db, instance)  # type: ignore\n            db_instance = await self.get(\n                db,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n                **_pks,\n            )\n\n        return db_instance\n\n    async def upsert_multi(\n        self,\n        db: AsyncSession,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        return_columns: Optional[list[str]] = None,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n        update_override: Optional[dict[str, Any]] = None,\n        **kwargs: Any,\n    ) -&gt; Optional[Dict[str, Any]]:\n        \"\"\"\n        Upsert multiple records in the database. The underlying implementation varies based on the database dialect.\n\n        Args:\n            db: The database session to use for the operation.\n            instances: A list of Pydantic schemas representing the instances to upsert.\n            return_columns: Optional list of column names to return after the upsert operation.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.\n            return_as_model: If True, returns data as instances of the specified Pydantic model.\n            update_override: Optional dictionary to override the update values for the upsert operation.\n            **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.\n\n        Returns:\n            The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.\n\n        Raises:\n            ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.\n            NotImplementedError: If the database dialect is not supported for upsert multi.\n        \"\"\"\n        if update_override is None:\n            update_override = {}\n        filters = self._parse_filters(**kwargs)\n\n        if db.bind.dialect.name == \"postgresql\":\n            statement, params = await self._upsert_multi_postgresql(\n                instances, filters, update_override\n            )\n        elif db.bind.dialect.name == \"sqlite\":\n            statement, params = await self._upsert_multi_sqlite(\n                instances, filters, update_override\n            )\n        elif db.bind.dialect.name in [\"mysql\", \"mariadb\"]:\n            if filters:\n                raise ValueError(\n                    \"MySQL does not support filtering on insert operations.\"\n                )\n            if return_columns or schema_to_select or return_as_model:\n                raise ValueError(\n                    \"MySQL does not support the returning clause for insert operations.\"\n                )\n            statement, params = await self._upsert_multi_mysql(\n                instances, update_override\n            )\n        else:  # pragma: no cover\n            raise NotImplementedError(\n                f\"Upsert multi is not implemented for {db.bind.dialect.name}\"\n            )\n\n        if return_as_model:\n            return_columns = self.model_col_names\n\n        if return_columns:\n            statement = statement.returning(*[column(name) for name in return_columns])\n            db_row = await db.execute(statement, params)\n            return self._as_multi_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n            )\n\n        await db.execute(statement, params)\n        return None\n\n    async def _upsert_multi_postgresql(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        filters: list[ColumnElement],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = postgresql.insert(self.model)\n        statement = statement.on_conflict_do_update(\n            index_elements=self._primary_keys,\n            set_={\n                column.name: getattr(statement.excluded, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key and not column.unique\n            }\n            | update_set_override,\n            where=and_(*filters) if filters else None,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def _upsert_multi_sqlite(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        filters: list[ColumnElement],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = sqlite.insert(self.model)\n        statement = statement.on_conflict_do_update(\n            index_elements=self._primary_keys,\n            set_={\n                column.name: getattr(statement.excluded, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key and not column.unique\n            }\n            | update_set_override,\n            where=and_(*filters) if filters else None,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def _upsert_multi_mysql(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = mysql.insert(self.model)\n        statement = statement.on_duplicate_key_update(\n            {\n                column.name: getattr(statement.inserted, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key\n                and not column.unique\n                and column.name != self.deleted_at_column\n            }\n            | update_set_override,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def exists(self, db: AsyncSession, **kwargs: Any) -&gt; bool:\n        \"\"\"\n        Checks if any records exist that match the given filter conditions.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.\n\n        Returns:\n            `True` if at least one record matches the filter conditions, `False` otherwise.\n\n        Examples:\n            Check if a user with a specific ID exists:\n\n            ```python\n            exists = await user_crud.exists(db, id=1)\n            ```\n\n            Check if any user is older than 30:\n\n            ```python\n            exists = await user_crud.exists(db, age__gt=30)\n            ```\n\n            Check if any user was registered before Jan 1, 2020:\n\n            ```python\n            exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n            ```\n\n            Check if a username other than `admin` exists:\n\n            ```python\n            exists = await user_crud.exists(db, username__ne='admin')\n            ```\n        \"\"\"\n        filters = self._parse_filters(**kwargs)\n        stmt = select(self.model).filter(*filters).limit(1)\n\n        result = await db.execute(stmt)\n        return result.first() is not None\n\n    async def count(\n        self,\n        db: AsyncSession,\n        joins_config: Optional[list[JoinConfig]] = None,\n        **kwargs: Any,\n    ) -&gt; int:\n        \"\"\"\n        Counts records that match specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Can also count records based on a configuration of joins, useful for complex queries involving relationships.\n\n        Args:\n            db: The database session to use for the operation.\n            joins_config: Optional configuration for applying joins in the count query.\n            **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.\n\n        Returns:\n            The total number of records matching the filter conditions.\n\n        Examples:\n            Count users by ID:\n\n            ```python\n            count = await user_crud.count(db, id=1)\n            ```\n\n            Count users older than 30:\n\n            ```python\n            count = await user_crud.count(db, age__gt=30)\n            ```\n\n            Count users with a username other than `admin`:\n\n            ```python\n            count = await user_crud.count(db, username__ne='admin')\n            ```\n\n            Count projects with at least one participant (many-to-many relationship):\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                ),\n            ]\n            count = await crud.count(db, joins_config=joins_config)\n            ```\n\n            Count projects by a specific participant name (filter applied on a joined model):\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'name': 'Jane Doe'},\n                ),\n            ]\n            count = await crud.count(db, joins_config=joins_config)\n            ```\n        \"\"\"\n        primary_filters = self._parse_filters(**kwargs)\n\n        if joins_config is not None:\n            primary_keys = [p.name for p in _get_primary_keys(self.model)]\n            if not any(primary_keys):  # pragma: no cover\n                raise ValueError(\n                    f\"The model '{self.model.__name__}' does not have a primary key defined, which is required for counting with joins.\"\n                )\n            to_select = [\n                getattr(self.model, pk).label(f\"distinct_{pk}\") for pk in primary_keys\n            ]\n            base_query = select(*to_select)\n\n            for join in joins_config:\n                join_model = join.alias or join.model\n                join_filters = (\n                    self._parse_filters(model=join_model, **join.filters)\n                    if join.filters\n                    else []\n                )\n\n                if join.join_type == \"inner\":\n                    base_query = base_query.join(join_model, join.join_on)\n                else:\n                    base_query = base_query.outerjoin(join_model, join.join_on)\n\n                if join_filters:\n                    base_query = base_query.where(*join_filters)\n\n            if primary_filters:\n                base_query = base_query.where(*primary_filters)\n\n            subquery = base_query.subquery()\n            count_query = select(func.count()).select_from(subquery)\n        else:\n            count_query = select(func.count()).select_from(self.model)\n            if primary_filters:\n                count_query = count_query.where(*primary_filters)\n\n        total_count: Optional[int] = await db.scalar(count_query)\n        if total_count is None:\n            raise ValueError(\"Could not find the count.\")\n\n        return total_count\n\n    async def get_multi(\n        self,\n        db: AsyncSession,\n        offset: int = 0,\n        limit: Optional[int] = 100,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        return_as_model: bool = False,\n        return_total_count: bool = True,\n        **kwargs: Any,\n    ) -&gt; dict[str, Any]:\n        \"\"\"\n        Fetches multiple records based on filters, supporting sorting, pagination.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            offset: Starting index for records to fetch, useful for pagination.\n            limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.\n            sort_columns: Column names to sort the results by.\n            sort_orders: Corresponding sort orders (`\"asc\"`, `\"desc\"`) for each column in `sort_columns`.\n            return_as_model: If `True`, returns data as instances of the specified Pydantic model.\n            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n        Returns:\n            A dictionary containing `\"data\"` with fetched records and `\"total_count\"` indicating the total number of records matching the filters.\n\n        Raises:\n            ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.\n\n        Examples:\n            Fetch the first 10 users:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                0,\n                10,\n            )\n            ```\n\n            Fetch next 10 users with sorted by username:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                10,\n                10,\n                sort_columns='username',\n                sort_orders='desc',\n            )\n            ```\n\n            Fetch 10 users older than 30, sorted by age in descending order:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                sort_columns='age',\n                sort_orders='desc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch 10 users with a registration date before Jan 1, 2020:\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                registration_date__lt=datetime(2020, 1, 1),\n            )\n            ```\n\n            Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                schema_to_select=ReadUserSchema,\n                return_as_model=True,\n                username__ne='admin',\n            )\n            ```\n\n            Fetch users with filtering and multiple column sorting:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                0,\n                10,\n                sort_columns=['username', 'email'],\n                sort_orders=['asc', 'desc'],\n                is_active=True,\n            )\n            ```\n        \"\"\"\n        if (limit is not None and limit &lt; 0) or offset &lt; 0:\n            raise ValueError(\"Limit and offset must be non-negative.\")\n\n        stmt = await self.select(\n            schema_to_select=schema_to_select,\n            sort_columns=sort_columns,\n            sort_orders=sort_orders,\n            **kwargs,\n        )\n\n        if offset:\n            stmt = stmt.offset(offset)\n        if limit is not None:\n            stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data = [dict(row) for row in result.mappings()]\n\n        response: dict[str, Any] = {\"data\": data}\n\n        if return_total_count:\n            total_count = await self.count(db=db, **kwargs)\n            response[\"total_count\"] = total_count\n\n        if return_as_model:\n            if not schema_to_select:\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_data = [schema_to_select(**row) for row in data]\n                response[\"data\"] = model_data\n            except ValidationError as e:\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n\n        return response\n\n    async def get_joined(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        join_model: Optional[ModelType] = None,\n        join_on: Optional[Union[Join, BinaryExpression]] = None,\n        join_prefix: Optional[str] = None,\n        join_schema_to_select: Optional[type[BaseModel]] = None,\n        join_type: str = \"left\",\n        alias: Optional[AliasedClass] = None,\n        join_filters: Optional[dict] = None,\n        joins_config: Optional[list[JoinConfig]] = None,\n        nest_joins: bool = False,\n        relationship_type: Optional[str] = None,\n        **kwargs: Any,\n    ) -&gt; Optional[dict[str, Any]]:\n        \"\"\"\n        Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts\n        to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to\n        specify each join configuration.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n            join_model: The model to join with.\n            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n            join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n            joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.\n            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n            relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n            **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.\n\n        Returns:\n            A dictionary representing the joined record, or `None` if no record matches the criteria.\n\n        Raises:\n            ValueError: If both single join parameters and `joins_config` are used simultaneously.\n            ArgumentError: If any provided model in `joins_config` is not recognized or invalid.\n            NoResultFound: If no record matches the criteria with the provided filters.\n\n        Examples:\n            Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`\n\n            ```python\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n            )\n            ```\n\n            Fetch a user and their associated tier, filtering by user ID:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                id=1,\n            )\n            ```\n\n            Fetch a user and their associated tier, where the user's age is greater than 30:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                age__gt=30,\n            )\n            ```\n\n            Fetch a user and their associated tier, excluding users with the `admin` username:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                username__ne='admin',\n            )\n            ```\n\n            Complex example: Joining with a custom join condition, additional filter parameters, and a prefix\n\n            ```python\n            from sqlalchemy import and_\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                username=\"john_doe\",\n            )\n            ```\n\n            Example of using `joins_config` for multiple joins:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            # Using same User/Tier/Department models/schemas as above.\n\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n            )\n            ```\n\n            Using `alias` for joining the same model multiple times:\n            ```python\n            from fastcrud import aliased\n\n            owner_alias = aliased(ModelTest, name=\"owner\")\n            user_alias = aliased(ModelTest, name=\"user\")\n\n            result = await crud.get_joined(\n                db=session,\n                schema_to_select=BookingSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.owner_id == owner_alias.id,\n                        join_prefix=\"owner_\",\n                        alias=owner_alias,\n                        schema_to_select=UserSchema,\n                    ),\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.user_id == user_alias.id,\n                        join_prefix=\"user_\",\n                        alias=user_alias,\n                        schema_to_select=UserSchema,\n                    ),\n                ],\n                id=1,\n            )\n            ```\n\n            Fetching a single project and its associated participants where a participant has a specific role:\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'role': 'Designer'},\n                ),\n            ]\n            project = await crud.get_joined(\n                db=session,\n                schema_to_select=ProjectSchema,\n                joins_config=joins_config,\n            )\n            ```\n\n            Example of using `joins_config` for multiple joins with nested joins enabled:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n                nest_joins=True,\n            )\n            # Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n            ```\n\n            Example using one-to-one relationship:\n\n            ```python\n            author_crud = FastCRUD(Author)\n            result = await author_crud.get_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Profile,\n                join_on=Author.profile_id == Profile.id,\n                join_schema_to_select=ReadProfileSchema,\n                nest_joins=True,\n                relationship_type='one-to-one', # note that this is the default behavior\n            )\n            # Expect 'result' to have 'profile' as a nested dictionary\n            ```\n\n            Example using one-to-many relationship:\n\n            ```python\n            result = await author_crud.get_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Article,\n                join_on=Author.id == Article.author_id,\n                join_schema_to_select=ReadArticleSchema,\n                nest_joins=True,\n                relationship_type='one-to-many',\n            )\n            # Expect 'result' to have 'posts' as a nested list of dictionaries\n            ```\n        \"\"\"\n        if joins_config and (\n            join_model or join_prefix or join_on or join_schema_to_select or alias\n        ):\n            raise ValueError(\n                \"Cannot use both single join parameters and joins_config simultaneously.\"\n            )\n        elif not joins_config and not join_model:\n            raise ValueError(\"You need one of join_model or joins_config.\")\n\n        primary_select = _extract_matching_columns_from_schema(\n            model=self.model,\n            schema=schema_to_select,\n        )\n        stmt: Select = select(*primary_select).select_from(self.model)\n\n        join_definitions = joins_config if joins_config else []\n        if join_model:\n            join_definitions.append(\n                JoinConfig(\n                    model=join_model,\n                    join_on=join_on,\n                    join_prefix=join_prefix,\n                    schema_to_select=join_schema_to_select,\n                    join_type=join_type,\n                    alias=alias,\n                    filters=join_filters,\n                    relationship_type=relationship_type,\n                )\n            )\n\n        stmt = self._prepare_and_apply_joins(\n            stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n        )\n        primary_filters = self._parse_filters(**kwargs)\n        if primary_filters:\n            stmt = stmt.filter(*primary_filters)\n\n        db_rows = await db.execute(stmt)\n        if any(join.relationship_type == \"one-to-many\" for join in join_definitions):\n            if nest_joins is False:  # pragma: no cover\n                raise ValueError(\n                    \"Cannot use one-to-many relationship with nest_joins=False\"\n                )\n            results = db_rows.fetchall()\n            data_list = [dict(row._mapping) for row in results]\n        else:\n            result = db_rows.first()\n            if result is not None:\n                data_list = [dict(result._mapping)]\n            else:\n                data_list = []\n\n        if data_list:\n            if nest_joins:\n                nested_data: dict = {}\n                for data in data_list:\n                    nested_data = _nest_join_data(\n                        data,\n                        join_definitions,\n                        nested_data=nested_data,\n                    )\n                return nested_data\n            return data_list[0]\n\n        return None\n\n    async def get_multi_joined(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        join_model: Optional[type[ModelType]] = None,\n        join_on: Optional[Any] = None,\n        join_prefix: Optional[str] = None,\n        join_schema_to_select: Optional[type[BaseModel]] = None,\n        join_type: str = \"left\",\n        alias: Optional[AliasedClass[Any]] = None,\n        join_filters: Optional[dict] = None,\n        nest_joins: bool = False,\n        offset: int = 0,\n        limit: Optional[int] = 100,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        return_as_model: bool = False,\n        joins_config: Optional[list[JoinConfig]] = None,\n        return_total_count: bool = True,\n        relationship_type: Optional[str] = None,\n        **kwargs: Any,\n    ) -&gt; dict[str, Any]:\n        \"\"\"\n        Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n            join_model: The model to join with.\n            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n            join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n            offset: The offset (number of records to skip) for pagination.\n            limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n            sort_columns: A single column name or a list of column names on which to apply sorting.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n            joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.\n            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n            relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n            **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.\n\n        Returns:\n            A dictionary containing the fetched rows under `\"data\"` key and total count under `\"total_count\"`.\n\n        Raises:\n            ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.\n                        Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.\n\n        Examples:\n            Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n            )\n            ```\n\n            Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                sort_columns='username',\n                sort_orders='asc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                return_as_model=True,\n                username__ne='admin',\n            )\n            ```\n\n            Fetching and sorting by username in descending order, returning as Pydantic model:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n                sort_columns=['username'],\n                sort_orders=['desc'],\n                return_as_model=True,\n            )\n            ```\n\n            Fetching with complex conditions and custom join, returning as Pydantic model:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_on=User.tier_id == Tier.id,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n                return_as_model=True,\n                is_active=True,\n            )\n            ```\n\n            Example using `joins_config` for multiple joins:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n                offset=0,\n                limit=10,\n                sort_columns='username',\n                sort_orders='asc',\n            )\n            ```\n\n            Example using `alias` for multiple joins, with pagination, sorting, and model conversion:\n            ```python\n            from fastcrud import JoinConfig, FastCRUD, aliased\n\n            # Aliasing for self-joins or multiple joins on the same table\n            owner_alias = aliased(ModelTest, name=\"owner\")\n            user_alias = aliased(ModelTest, name=\"user\")\n\n            # Initialize your FastCRUD instance for BookingModel\n            crud = FastCRUD(BookingModel)\n\n            result = await crud.get_multi_joined(\n                db=session,\n                schema_to_select=BookingSchema,  # Primary model schema\n                joins_config=[\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.owner_id == owner_alias.id,\n                        join_prefix=\"owner_\",\n                        schema_to_select=UserSchema,  # Schema for the joined model\n                        alias=owner_alias,\n                    ),\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.user_id == user_alias.id,\n                        join_prefix=\"user_\",\n                        schema_to_select=UserSchema,\n                        alias=user_alias,\n                    )\n                ],\n                offset=10,  # Skip the first 10 records\n                limit=5,  # Fetch up to 5 records\n                sort_columns=['booking_date'],  # Sort by booking_date\n                sort_orders=['desc'],  # In descending order\n            )\n            ```\n\n            Fetching multiple project records and their associated participants where participants have a specific role:\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'role': 'Developer'},\n                ),\n            ]\n            projects = await crud.get_multi_joined(\n                db=session,\n                schema_to_select=ProjectSchema,\n                joins_config=joins_config,\n                limit=10,\n            )\n            ```\n\n            Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:\n\n            ```python\n            story_crud = FastCRUD(Story)\n            stories = await story_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadStorySchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Task,\n                        join_on=Story.id == Task.story_id,\n                        join_prefix=\"task_\",\n                        schema_to_select=ReadTaskSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=User,\n                        join_on=Task.creator_id == User.id,\n                        join_prefix=\"creator_\",\n                        schema_to_select=ReadUserSchema,\n                        join_type=\"left\",\n                        alias=aliased(User, name=\"task_creator\"),\n                    ),\n                ],\n                nest_joins=True,\n                offset=0,\n                limit=5,\n                sort_columns='name',\n                sort_orders='asc',\n            )\n            ```\n\n            Example using one-to-one relationship:\n\n            ```python\n            author_crud = FastCRUD(Author)\n            results = await author_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Profile,\n                join_on=Author.profile_id == Profile.id,\n                join_schema_to_select=ReadProfileSchema,\n                nest_joins=True,\n                offset=0,\n                limit=10,\n                relationship_type='one-to-one', # note that this is the default behavior\n            )\n            # Expect 'profile' to be nested as a dictionary under each user\n            ```\n\n            Example using one-to-many relationship:\n\n            ```python\n            results = await author_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Article,\n                join_on=Author.id == Article.author_id,\n                join_schema_to_select=ReadArticleSchema,\n                nest_joins=True,\n                offset=0,\n                limit=10,\n                relationship_type='one-to-many',\n            )\n            # Expect 'posts' to be nested as a list of dictionaries under each user\n            ```\n        \"\"\"\n        if joins_config and (\n            join_model\n            or join_prefix\n            or join_on\n            or join_schema_to_select\n            or alias\n            or relationship_type\n        ):\n            raise ValueError(\n                \"Cannot use both single join parameters and joins_config simultaneously.\"\n            )\n        elif not joins_config and not join_model:\n            raise ValueError(\"You need one of join_model or joins_config.\")\n\n        if (limit is not None and limit &lt; 0) or offset &lt; 0:\n            raise ValueError(\"Limit and offset must be non-negative.\")\n\n        if relationship_type is None:\n            relationship_type = \"one-to-one\"\n\n        primary_select = _extract_matching_columns_from_schema(\n            model=self.model, schema=schema_to_select\n        )\n        stmt: Select = select(*primary_select)\n\n        join_definitions = joins_config if joins_config else []\n        if join_model:\n            join_definitions.append(\n                JoinConfig(\n                    model=join_model,\n                    join_on=join_on\n                    or _auto_detect_join_condition(self.model, join_model),\n                    join_prefix=join_prefix,\n                    schema_to_select=join_schema_to_select,\n                    join_type=join_type,\n                    alias=alias,\n                    filters=join_filters,\n                    relationship_type=relationship_type,\n                )\n            )\n\n        stmt = self._prepare_and_apply_joins(\n            stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n        )\n\n        primary_filters = self._parse_filters(**kwargs)\n        if primary_filters:\n            stmt = stmt.filter(*primary_filters)\n\n        if sort_columns:\n            stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n\n        if offset:\n            stmt = stmt.offset(offset)\n        if limit is not None:\n            stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data: list[Union[dict, BaseModel]] = []\n\n        for row in result.mappings().all():\n            row_dict = dict(row)\n\n            if nest_joins:\n                row_dict = _nest_join_data(\n                    data=row_dict,\n                    join_definitions=join_definitions,\n                )\n\n            if return_as_model:\n                if schema_to_select is None:\n                    raise ValueError(\n                        \"schema_to_select must be provided when return_as_model is True.\"\n                    )\n                try:\n                    model_instance = schema_to_select(**row_dict)\n                    data.append(model_instance)\n                except ValidationError as e:\n                    raise ValueError(\n                        f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                    )\n            else:\n                data.append(row_dict)\n\n        if nest_joins and any(\n            join.relationship_type == \"one-to-many\" for join in join_definitions\n        ):\n            nested_data = _nest_multi_join_data(\n                base_primary_key=self._primary_keys[0].name,\n                data=data,\n                joins_config=join_definitions,\n                return_as_model=return_as_model,\n                schema_to_select=schema_to_select if return_as_model else None,\n                nested_schema_to_select={\n                    (\n                        join.join_prefix.rstrip(\"_\")\n                        if join.join_prefix\n                        else join.model.__name__\n                    ): join.schema_to_select\n                    for join in join_definitions\n                    if join.schema_to_select\n                },\n            )\n        else:\n            nested_data = _handle_null_primary_key_multi_join(data, join_definitions)\n\n        response: dict[str, Any] = {\"data\": nested_data}\n\n        if return_total_count:\n            total_count: int = await self.count(\n                db=db, joins_config=joins_config, **kwargs\n            )\n            response[\"total_count\"] = total_count\n\n        return response\n\n    async def get_multi_by_cursor(\n        self,\n        db: AsyncSession,\n        cursor: Any = None,\n        limit: int = 100,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        sort_column: str = \"id\",\n        sort_order: str = \"asc\",\n        **kwargs: Any,\n    ) -&gt; dict[str, Any]:\n        \"\"\"\n        Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            cursor: The cursor value to start fetching records from. Defaults to `None`.\n            limit: Maximum number of rows to fetch.\n            schema_to_select: Pydantic schema for selecting specific columns.\n            sort_column: Column name to use for sorting and cursor pagination.\n            sort_order: Sorting direction, either `\"asc\"` or `\"desc\"`.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.\n\n        Returns:\n            A dictionary containing the fetched rows under `\"data\"` key and the next cursor value under `\"next_cursor\"`.\n\n        Examples:\n            Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='registration_date',\n                sort_order='desc',\n            )\n\n            # Fetch the next set of records using the cursor from the first page\n            next_cursor = first_page['next_cursor']\n            second_page = await user_crud.get_multi_by_cursor(\n                db,\n                cursor=next_cursor,\n                limit=10,\n                sort_column='registration_date',\n                sort_order='desc',\n            )\n            ```\n\n            Fetch records with age greater than 30 using cursor-based pagination:\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='age',\n                sort_order='asc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch records excluding a specific username using cursor-based pagination:\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='username',\n                sort_order='asc',\n                username__ne='admin',\n            )\n            ```\n\n        Note:\n            This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.\n            Make sure the column used for cursor pagination is indexed for performance.\n            This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).\n        \"\"\"\n        if limit == 0:\n            return {\"data\": [], \"next_cursor\": None}\n\n        stmt = await self.select(\n            schema_to_select=schema_to_select,\n            **kwargs,\n        )\n\n        if cursor:\n            if sort_order == \"asc\":\n                stmt = stmt.filter(getattr(self.model, sort_column) &gt; cursor)\n            else:\n                stmt = stmt.filter(getattr(self.model, sort_column) &lt; cursor)\n\n        stmt = stmt.order_by(\n            asc(getattr(self.model, sort_column))\n            if sort_order == \"asc\"\n            else desc(getattr(self.model, sort_column))\n        )\n        stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data = [dict(row) for row in result.mappings()]\n\n        next_cursor = None\n        if len(data) == limit:\n            if sort_order == \"asc\":\n                next_cursor = data[-1][sort_column]\n            else:\n                data[0][sort_column]\n\n        return {\"data\": data, \"next_cursor\": next_cursor}\n\n    async def update(\n        self,\n        db: AsyncSession,\n        object: Union[UpdateSchemaType, dict[str, Any]],\n        allow_multiple: bool = False,\n        commit: bool = True,\n        return_columns: Optional[list[str]] = None,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n        **kwargs: Any,\n    ) -&gt; Optional[Union[dict, BaseModel]]:\n        \"\"\"\n        Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            object: A Pydantic schema or dictionary containing the update data.\n            allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.\n            schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.\n            return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.\n            one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.\n            **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.\n\n        Returns:\n            The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n            ValueError: If extra fields not present in the model are provided in the update data.\n            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n        Examples:\n            Update a user's email based on their ID:\n\n            ```python\n            await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n            ```\n\n            Update users to be inactive where age is greater than 30 and allow updates to multiple records:\n\n            ```python\n            await user_crud.update(\n                db,\n                {'is_active': False},\n                allow_multiple=True,\n                age__gt=30,\n            )\n            ```\n\n            Update a user's username excluding specific user ID and prevent multiple updates:\n\n            ```python\n            await user_crud.update(\n                db,\n                {'username': 'new_username'},\n                allow_multiple=False,\n                id__ne=1,\n            )\n            ```\n\n            Update a user's email and return the updated record as a Pydantic model instance:\n\n            ```python\n            user = await user_crud.update(\n                db,\n                {'email': 'new_email@example.com'},\n                schema_to_select=ReadUserSchema,\n                return_as_model=True,\n                id=1,\n            )\n            ```\n\n            Update a user's email and return the updated record as a dictionary:\n            ```python\n            user = await user_crud.update(\n                db,\n                {'email': 'new_email@example.com'},\n                return_columns=['id', 'email'],\n                id=1,\n            )\n            ```\n        \"\"\"\n        if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to update, found {total_count}.\"\n            )\n\n        if isinstance(object, dict):\n            update_data = object\n        else:\n            update_data = object.model_dump(exclude_unset=True)\n\n        updated_at_col = getattr(self.model, self.updated_at_column, None)\n        if updated_at_col:\n            update_data[self.updated_at_column] = datetime.now(timezone.utc)\n\n        update_data_keys = set(update_data.keys())\n        model_columns = {_column.name for _column in inspect(self.model).c}\n        extra_fields = update_data_keys - model_columns\n        if extra_fields:\n            raise ValueError(f\"Extra fields provided: {extra_fields}\")\n\n        filters = self._parse_filters(**kwargs)\n        stmt = update(self.model).filter(*filters).values(update_data)\n\n        if return_as_model:\n            return_columns = self.model_col_names\n\n        if return_columns:\n            stmt = stmt.returning(*[column(name) for name in return_columns])\n            db_row = await db.execute(stmt)\n            if allow_multiple:\n                return self._as_multi_response(\n                    db_row,\n                    schema_to_select=schema_to_select,\n                    return_as_model=return_as_model,\n                )\n            return self._as_single_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n                one_or_none=one_or_none,\n            )\n\n        await db.execute(stmt)\n        if commit:\n            await db.commit()\n        return None\n\n    def _as_single_response(\n        self,\n        db_row: Result,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n    ) -&gt; Optional[Union[dict, BaseModel]]:\n        result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n        if result is None:  # pragma: no cover\n            return None\n        out: dict = dict(result._mapping)\n        if not return_as_model:\n            return out\n        if not schema_to_select:  # pragma: no cover\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        return schema_to_select(**out)\n\n    def _as_multi_response(\n        self,\n        db_row: Result,\n        schema_to_select: Optional[type[BaseModel]] = None,\n        return_as_model: bool = False,\n    ) -&gt; dict:\n        data = [dict(row) for row in db_row.mappings()]\n\n        response: dict[str, Any] = {\"data\": data}\n\n        if return_as_model:\n            if not schema_to_select:  # pragma: no cover\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_data = [schema_to_select(**row) for row in data]\n                response[\"data\"] = model_data\n            except ValidationError as e:  # pragma: no cover\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n\n        return response\n\n    async def db_delete(\n        self,\n        db: AsyncSession,\n        allow_multiple: bool = False,\n        commit: bool = True,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Deletes a record or multiple records from the database based on specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.\n\n        Returns:\n            None\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n\n        Examples:\n            Delete a user based on their ID:\n\n            ```python\n            await user_crud.db_delete(db, id=1)\n            ```\n\n            Delete users older than 30 years and allow deletion of multiple records:\n\n            ```python\n            await user_crud.db_delete(\n                db,\n                allow_multiple=True,\n                age__gt=30,\n            )\n            ```\n\n            Delete a user with a specific username, ensuring only one record is deleted:\n\n            ```python\n            await user_crud.db_delete(\n                db,\n                allow_multiple=False,\n                username='unique_username',\n            )\n            ```\n        \"\"\"\n        if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to delete, found {total_count}.\"\n            )\n\n        filters = self._parse_filters(**kwargs)\n        stmt = delete(self.model).filter(*filters)\n        await db.execute(stmt)\n        if commit:\n            await db.commit()\n\n    async def delete(\n        self,\n        db: AsyncSession,\n        db_row: Optional[Row] = None,\n        allow_multiple: bool = False,\n        commit: bool = True,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Soft deletes a record or optionally multiple records if it has an `\"is_deleted\"` attribute, otherwise performs a hard delete, based on specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.\n            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n            NoResultFound: If no record matches the filters.\n\n        Returns:\n            None\n\n        Examples:\n            Soft delete a specific user by ID:\n\n            ```python\n            await user_crud.delete(db, id=1)\n            ```\n\n            Soft delete users with account registration dates before 2020, allowing deletion of multiple records:\n\n            ```python\n            await user_crud.delete(\n                db,\n                allow_multiple=True,\n                creation_date__lt=datetime(2020, 1, 1),\n            )\n            ```\n\n            Soft delete a user with a specific email, ensuring only one record is deleted:\n\n            ```python\n            await user_crud.delete(\n                db,\n                allow_multiple=False,\n                email='unique@example.com',\n            )\n            ```\n        \"\"\"\n        filters = self._parse_filters(**kwargs)\n        if db_row:\n            if hasattr(db_row, self.is_deleted_column) and hasattr(\n                db_row, self.deleted_at_column\n            ):\n                setattr(db_row, self.is_deleted_column, True)\n                setattr(db_row, self.deleted_at_column, datetime.now(timezone.utc))\n                if commit:\n                    await db.commit()\n            else:\n                await db.delete(db_row)\n            if commit:\n                await db.commit()\n            return\n\n        total_count = await self.count(db, **kwargs)\n        if total_count == 0:\n            raise NoResultFound(\"No record found to delete.\")\n        if not allow_multiple and total_count &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to delete, found {total_count}.\"\n            )\n\n        update_values: dict[str, Union[bool, datetime]] = {}\n        if self.deleted_at_column in self.model_col_names:\n            update_values[self.deleted_at_column] = datetime.now(timezone.utc)\n        if self.is_deleted_column in self.model_col_names:\n            update_values[self.is_deleted_column] = True\n\n        if update_values:\n            update_stmt = update(self.model).filter(*filters).values(**update_values)\n            await db.execute(update_stmt)\n\n        else:\n            delete_stmt = self.model.__table__.delete().where(*filters)\n            await db.execute(delete_stmt)\n        if commit:\n            await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.count","title":"<code>count(db, joins_config=None, **kwargs)</code>  <code>async</code>","text":"<p>Counts records that match specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Can also count records based on a configuration of joins, useful for complex queries involving relationships.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>Optional configuration for applying joins in the count query.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</p> <code>{}</code> <p>Returns:</p> Type Description <code>int</code> <p>The total number of records matching the filter conditions.</p> <p>Examples:</p> <p>Count users by ID:</p> <pre><code>count = await user_crud.count(db, id=1)\n</code></pre> <p>Count users older than 30:</p> <pre><code>count = await user_crud.count(db, age__gt=30)\n</code></pre> <p>Count users with a username other than <code>admin</code>:</p> <pre><code>count = await user_crud.count(db, username__ne='admin')\n</code></pre> <p>Count projects with at least one participant (many-to-many relationship): <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n    ),\n]\ncount = await crud.count(db, joins_config=joins_config)\n</code></pre></p> <p>Count projects by a specific participant name (filter applied on a joined model): <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'name': 'Jane Doe'},\n    ),\n]\ncount = await crud.count(db, joins_config=joins_config)\n</code></pre></p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def count(\n    self,\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int:\n    \"\"\"\n    Counts records that match specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Can also count records based on a configuration of joins, useful for complex queries involving relationships.\n\n    Args:\n        db: The database session to use for the operation.\n        joins_config: Optional configuration for applying joins in the count query.\n        **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.\n\n    Returns:\n        The total number of records matching the filter conditions.\n\n    Examples:\n        Count users by ID:\n\n        ```python\n        count = await user_crud.count(db, id=1)\n        ```\n\n        Count users older than 30:\n\n        ```python\n        count = await user_crud.count(db, age__gt=30)\n        ```\n\n        Count users with a username other than `admin`:\n\n        ```python\n        count = await user_crud.count(db, username__ne='admin')\n        ```\n\n        Count projects with at least one participant (many-to-many relationship):\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n            ),\n        ]\n        count = await crud.count(db, joins_config=joins_config)\n        ```\n\n        Count projects by a specific participant name (filter applied on a joined model):\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'name': 'Jane Doe'},\n            ),\n        ]\n        count = await crud.count(db, joins_config=joins_config)\n        ```\n    \"\"\"\n    primary_filters = self._parse_filters(**kwargs)\n\n    if joins_config is not None:\n        primary_keys = [p.name for p in _get_primary_keys(self.model)]\n        if not any(primary_keys):  # pragma: no cover\n            raise ValueError(\n                f\"The model '{self.model.__name__}' does not have a primary key defined, which is required for counting with joins.\"\n            )\n        to_select = [\n            getattr(self.model, pk).label(f\"distinct_{pk}\") for pk in primary_keys\n        ]\n        base_query = select(*to_select)\n\n        for join in joins_config:\n            join_model = join.alias or join.model\n            join_filters = (\n                self._parse_filters(model=join_model, **join.filters)\n                if join.filters\n                else []\n            )\n\n            if join.join_type == \"inner\":\n                base_query = base_query.join(join_model, join.join_on)\n            else:\n                base_query = base_query.outerjoin(join_model, join.join_on)\n\n            if join_filters:\n                base_query = base_query.where(*join_filters)\n\n        if primary_filters:\n            base_query = base_query.where(*primary_filters)\n\n        subquery = base_query.subquery()\n        count_query = select(func.count()).select_from(subquery)\n    else:\n        count_query = select(func.count()).select_from(self.model)\n        if primary_filters:\n            count_query = count_query.where(*primary_filters)\n\n    total_count: Optional[int] = await db.scalar(count_query)\n    if total_count is None:\n        raise ValueError(\"Could not find the count.\")\n\n    return total_count\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.create","title":"<code>create(db, object, commit=True)</code>  <code>async</code>","text":"<p>Create a new record in the database.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>object</code> <code>CreateSchemaType</code> <p>The Pydantic schema containing the data to be saved.</p> required <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <p>Returns:</p> Type Description <code>ModelType</code> <p>The created database object.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def create(\n    self, db: AsyncSession, object: CreateSchemaType, commit: bool = True\n) -&gt; ModelType:\n    \"\"\"\n    Create a new record in the database.\n\n    Args:\n        db: The SQLAlchemy async session.\n        object: The Pydantic schema containing the data to be saved.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n\n    Returns:\n        The created database object.\n    \"\"\"\n    object_dict = object.model_dump()\n    db_object: ModelType = self.model(**object_dict)\n    db.add(db_object)\n    if commit:\n        await db.commit()\n    return db_object\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.db_delete","title":"<code>db_delete(db, allow_multiple=False, commit=True, **kwargs)</code>  <code>async</code>","text":"<p>Deletes a record or multiple records from the database based on specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows deleting multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <p>Examples:</p> <p>Delete a user based on their ID:</p> <pre><code>await user_crud.db_delete(db, id=1)\n</code></pre> <p>Delete users older than 30 years and allow deletion of multiple records:</p> <pre><code>await user_crud.db_delete(\n    db,\n    allow_multiple=True,\n    age__gt=30,\n)\n</code></pre> <p>Delete a user with a specific username, ensuring only one record is deleted:</p> <pre><code>await user_crud.db_delete(\n    db,\n    allow_multiple=False,\n    username='unique_username',\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def db_delete(\n    self,\n    db: AsyncSession,\n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Deletes a record or multiple records from the database based on specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.\n\n    Returns:\n        None\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n\n    Examples:\n        Delete a user based on their ID:\n\n        ```python\n        await user_crud.db_delete(db, id=1)\n        ```\n\n        Delete users older than 30 years and allow deletion of multiple records:\n\n        ```python\n        await user_crud.db_delete(\n            db,\n            allow_multiple=True,\n            age__gt=30,\n        )\n        ```\n\n        Delete a user with a specific username, ensuring only one record is deleted:\n\n        ```python\n        await user_crud.db_delete(\n            db,\n            allow_multiple=False,\n            username='unique_username',\n        )\n        ```\n    \"\"\"\n    if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to delete, found {total_count}.\"\n        )\n\n    filters = self._parse_filters(**kwargs)\n    stmt = delete(self.model).filter(*filters)\n    await db.execute(stmt)\n    if commit:\n        await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.delete","title":"<code>delete(db, db_row=None, allow_multiple=False, commit=True, **kwargs)</code>  <code>async</code>","text":"<p>Soft deletes a record or optionally multiple records if it has an <code>\"is_deleted\"</code> attribute, otherwise performs a hard delete, based on specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>db_row</code> <code>Optional[Row]</code> <p>Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</p> <code>None</code> <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows deleting multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <code>NoResultFound</code> <p>If no record matches the filters.</p> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Examples:</p> <p>Soft delete a specific user by ID:</p> <pre><code>await user_crud.delete(db, id=1)\n</code></pre> <p>Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</p> <pre><code>await user_crud.delete(\n    db,\n    allow_multiple=True,\n    creation_date__lt=datetime(2020, 1, 1),\n)\n</code></pre> <p>Soft delete a user with a specific email, ensuring only one record is deleted:</p> <pre><code>await user_crud.delete(\n    db,\n    allow_multiple=False,\n    email='unique@example.com',\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def delete(\n    self,\n    db: AsyncSession,\n    db_row: Optional[Row] = None,\n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Soft deletes a record or optionally multiple records if it has an `\"is_deleted\"` attribute, otherwise performs a hard delete, based on specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.\n        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n        NoResultFound: If no record matches the filters.\n\n    Returns:\n        None\n\n    Examples:\n        Soft delete a specific user by ID:\n\n        ```python\n        await user_crud.delete(db, id=1)\n        ```\n\n        Soft delete users with account registration dates before 2020, allowing deletion of multiple records:\n\n        ```python\n        await user_crud.delete(\n            db,\n            allow_multiple=True,\n            creation_date__lt=datetime(2020, 1, 1),\n        )\n        ```\n\n        Soft delete a user with a specific email, ensuring only one record is deleted:\n\n        ```python\n        await user_crud.delete(\n            db,\n            allow_multiple=False,\n            email='unique@example.com',\n        )\n        ```\n    \"\"\"\n    filters = self._parse_filters(**kwargs)\n    if db_row:\n        if hasattr(db_row, self.is_deleted_column) and hasattr(\n            db_row, self.deleted_at_column\n        ):\n            setattr(db_row, self.is_deleted_column, True)\n            setattr(db_row, self.deleted_at_column, datetime.now(timezone.utc))\n            if commit:\n                await db.commit()\n        else:\n            await db.delete(db_row)\n        if commit:\n            await db.commit()\n        return\n\n    total_count = await self.count(db, **kwargs)\n    if total_count == 0:\n        raise NoResultFound(\"No record found to delete.\")\n    if not allow_multiple and total_count &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to delete, found {total_count}.\"\n        )\n\n    update_values: dict[str, Union[bool, datetime]] = {}\n    if self.deleted_at_column in self.model_col_names:\n        update_values[self.deleted_at_column] = datetime.now(timezone.utc)\n    if self.is_deleted_column in self.model_col_names:\n        update_values[self.is_deleted_column] = True\n\n    if update_values:\n        update_stmt = update(self.model).filter(*filters).values(**update_values)\n        await db.execute(update_stmt)\n\n    else:\n        delete_stmt = self.model.__table__.delete().where(*filters)\n        await db.execute(delete_stmt)\n    if commit:\n        await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.exists","title":"<code>exists(db, **kwargs)</code>  <code>async</code>","text":"<p>Checks if any records exist that match the given filter conditions.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</p> <code>{}</code> <p>Returns:</p> Type Description <code>bool</code> <p><code>True</code> if at least one record matches the filter conditions, <code>False</code> otherwise.</p> <p>Examples:</p> <p>Check if a user with a specific ID exists:</p> <pre><code>exists = await user_crud.exists(db, id=1)\n</code></pre> <p>Check if any user is older than 30:</p> <pre><code>exists = await user_crud.exists(db, age__gt=30)\n</code></pre> <p>Check if any user was registered before Jan 1, 2020:</p> <pre><code>exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n</code></pre> <p>Check if a username other than <code>admin</code> exists:</p> <pre><code>exists = await user_crud.exists(db, username__ne='admin')\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def exists(self, db: AsyncSession, **kwargs: Any) -&gt; bool:\n    \"\"\"\n    Checks if any records exist that match the given filter conditions.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.\n\n    Returns:\n        `True` if at least one record matches the filter conditions, `False` otherwise.\n\n    Examples:\n        Check if a user with a specific ID exists:\n\n        ```python\n        exists = await user_crud.exists(db, id=1)\n        ```\n\n        Check if any user is older than 30:\n\n        ```python\n        exists = await user_crud.exists(db, age__gt=30)\n        ```\n\n        Check if any user was registered before Jan 1, 2020:\n\n        ```python\n        exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n        ```\n\n        Check if a username other than `admin` exists:\n\n        ```python\n        exists = await user_crud.exists(db, username__ne='admin')\n        ```\n    \"\"\"\n    filters = self._parse_filters(**kwargs)\n    stmt = select(self.model).filter(*filters).limit(1)\n\n    result = await db.execute(stmt)\n    return result.first() is not None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get","title":"<code>get(db, schema_to_select=None, return_as_model=False, one_or_none=False, **kwargs)</code>  <code>async</code>","text":"<p>Fetches a single record based on specified filters.</p> <p>This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Optional Pydantic schema for selecting specific columns.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <code>one_or_none</code> <code>bool</code> <p>Flag to get strictly one or no result. Multiple results are not allowed.</p> <code>False</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</p> <code>{}</code> <p>Raises:</p> Type Description <code>ValueError</code> <p>If <code>return_as_model</code> is <code>True</code> but <code>schema_to_select</code> is not provided.</p> <p>Returns:</p> Type Description <code>Optional[Union[dict, BaseModel]]</code> <p>A dictionary or a Pydantic model instance of the fetched database row, or <code>None</code> if no match is found.</p> <p>Examples:</p> <p>Fetch a user by ID:</p> <pre><code>user = await user_crud.get(db, id=1)\n</code></pre> <p>Fetch a user with an age greater than 30:</p> <pre><code>user = await user_crud.get(db, age__gt=30)\n</code></pre> <p>Fetch a user with a registration date before Jan 1, 2020:</p> <pre><code>user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n</code></pre> <p>Fetch a user not equal to a specific username:</p> <pre><code>user = await user_crud.get(db, username__ne='admin')\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]:\n    \"\"\"\n    Fetches a single record based on specified filters.\n\n    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        schema_to_select: Optional Pydantic schema for selecting specific columns.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n        one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.\n        **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.\n\n    Raises:\n        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n    Returns:\n        A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.\n\n    Examples:\n        Fetch a user by ID:\n\n        ```python\n        user = await user_crud.get(db, id=1)\n        ```\n\n        Fetch a user with an age greater than 30:\n\n        ```python\n        user = await user_crud.get(db, age__gt=30)\n        ```\n\n        Fetch a user with a registration date before Jan 1, 2020:\n\n        ```python\n        user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n        ```\n\n        Fetch a user not equal to a specific username:\n\n        ```python\n        user = await user_crud.get(db, username__ne='admin')\n        ```\n    \"\"\"\n    stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n    db_row = await db.execute(stmt)\n    result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n    if result is None:\n        return None\n    out: dict = dict(result._mapping)\n    if not return_as_model:\n        return out\n    if not schema_to_select:\n        raise ValueError(\n            \"schema_to_select must be provided when return_as_model is True.\"\n        )\n    return schema_to_select(**out)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_joined","title":"<code>get_joined(db, schema_to_select=None, join_model=None, join_on=None, join_prefix=None, join_schema_to_select=None, join_type='left', alias=None, join_filters=None, joins_config=None, nest_joins=False, relationship_type=None, **kwargs)</code>  <code>async</code>","text":"<p>Fetches a single record with one or multiple joins on other models. If <code>join_on</code> is not provided, the method attempts to automatically detect the join condition using foreign key relationships. For multiple joins, use <code>joins_config</code> to specify each join configuration.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns from the primary model. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>join_model</code> <code>Optional[ModelType]</code> <p>The model to join with.</p> <code>None</code> <code>join_on</code> <code>Optional[Union[Join, BinaryExpression]]</code> <p>SQLAlchemy Join object for specifying the <code>ON</code> clause of the join. If <code>None</code>, the join condition is auto-detected based on foreign keys.</p> <code>None</code> <code>join_prefix</code> <code>Optional[str]</code> <p>Optional prefix to be added to all columns of the joined model. If <code>None</code>, no prefix is added.</p> <code>None</code> <code>join_schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns from the joined model.</p> <code>None</code> <code>join_type</code> <code>str</code> <p>Specifies the type of join operation to perform. Can be <code>\"left\"</code> for a left outer join or <code>\"inner\"</code> for an inner join.</p> <code>'left'</code> <code>alias</code> <code>Optional[AliasedClass]</code> <p>An instance of <code>AliasedClass</code> for the join model, useful for self-joins or multiple joins on the same model. Result of <code>aliased(join_model)</code>.</p> <code>None</code> <code>join_filters</code> <code>Optional[dict]</code> <p>Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</p> <code>None</code> <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>A list of <code>JoinConfig</code> instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</p> <code>None</code> <code>nest_joins</code> <code>bool</code> <p>If <code>True</code>, nested data structures will be returned where joined model data are nested under the <code>join_prefix</code> as a dictionary.</p> <code>False</code> <code>relationship_type</code> <code>Optional[str]</code> <p>Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Used to determine how to nest the joined data. If <code>None</code>, uses <code>\"one-to-one\"</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[dict[str, Any]]</code> <p>A dictionary representing the joined record, or <code>None</code> if no record matches the criteria.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both single join parameters and <code>joins_config</code> are used simultaneously.</p> <code>ArgumentError</code> <p>If any provided model in <code>joins_config</code> is not recognized or invalid.</p> <code>NoResultFound</code> <p>If no record matches the criteria with the provided filters.</p> <p>Examples:</p> <p>Simple example: Joining <code>User</code> and <code>Tier</code> models without explicitly providing <code>join_on</code></p> <pre><code>result = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n)\n</code></pre> <p>Fetch a user and their associated tier, filtering by user ID:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    id=1,\n)\n</code></pre> <p>Fetch a user and their associated tier, where the user's age is greater than 30:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    age__gt=30,\n)\n</code></pre> <p>Fetch a user and their associated tier, excluding users with the <code>admin</code> username:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    username__ne='admin',\n)\n</code></pre> <p>Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</p> <pre><code>from sqlalchemy import and_\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    username=\"john_doe\",\n)\n</code></pre> <p>Example of using <code>joins_config</code> for multiple joins:</p> <pre><code>from fastcrud import JoinConfig\n\n# Using same User/Tier/Department models/schemas as above.\n\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n)\n</code></pre> <p>Using <code>alias</code> for joining the same model multiple times: <pre><code>from fastcrud import aliased\n\nowner_alias = aliased(ModelTest, name=\"owner\")\nuser_alias = aliased(ModelTest, name=\"user\")\n\nresult = await crud.get_joined(\n    db=session,\n    schema_to_select=BookingSchema,\n    joins_config=[\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.owner_id == owner_alias.id,\n            join_prefix=\"owner_\",\n            alias=owner_alias,\n            schema_to_select=UserSchema,\n        ),\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.user_id == user_alias.id,\n            join_prefix=\"user_\",\n            alias=user_alias,\n            schema_to_select=UserSchema,\n        ),\n    ],\n    id=1,\n)\n</code></pre></p> <p>Fetching a single project and its associated participants where a participant has a specific role: <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'role': 'Designer'},\n    ),\n]\nproject = await crud.get_joined(\n    db=session,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n)\n</code></pre></p> <p>Example of using <code>joins_config</code> for multiple joins with nested joins enabled:</p> <pre><code>from fastcrud import JoinConfig\n\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n    nest_joins=True,\n)\n# Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n</code></pre> <p>Example using one-to-one relationship:</p> <pre><code>author_crud = FastCRUD(Author)\nresult = await author_crud.get_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Profile,\n    join_on=Author.profile_id == Profile.id,\n    join_schema_to_select=ReadProfileSchema,\n    nest_joins=True,\n    relationship_type='one-to-one', # note that this is the default behavior\n)\n# Expect 'result' to have 'profile' as a nested dictionary\n</code></pre> <p>Example using one-to-many relationship:</p> <pre><code>result = await author_crud.get_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_schema_to_select=ReadArticleSchema,\n    nest_joins=True,\n    relationship_type='one-to-many',\n)\n# Expect 'result' to have 'posts' as a nested list of dictionaries\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_joined(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[ModelType] = None,\n    join_on: Optional[Union[Join, BinaryExpression]] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass] = None,\n    join_filters: Optional[dict] = None,\n    joins_config: Optional[list[JoinConfig]] = None,\n    nest_joins: bool = False,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; Optional[dict[str, Any]]:\n    \"\"\"\n    Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts\n    to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to\n    specify each join configuration.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n        join_model: The model to join with.\n        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n        join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n        joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.\n        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n        relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n        **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.\n\n    Returns:\n        A dictionary representing the joined record, or `None` if no record matches the criteria.\n\n    Raises:\n        ValueError: If both single join parameters and `joins_config` are used simultaneously.\n        ArgumentError: If any provided model in `joins_config` is not recognized or invalid.\n        NoResultFound: If no record matches the criteria with the provided filters.\n\n    Examples:\n        Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`\n\n        ```python\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n        )\n        ```\n\n        Fetch a user and their associated tier, filtering by user ID:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            id=1,\n        )\n        ```\n\n        Fetch a user and their associated tier, where the user's age is greater than 30:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            age__gt=30,\n        )\n        ```\n\n        Fetch a user and their associated tier, excluding users with the `admin` username:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            username__ne='admin',\n        )\n        ```\n\n        Complex example: Joining with a custom join condition, additional filter parameters, and a prefix\n\n        ```python\n        from sqlalchemy import and_\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            username=\"john_doe\",\n        )\n        ```\n\n        Example of using `joins_config` for multiple joins:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        # Using same User/Tier/Department models/schemas as above.\n\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n        )\n        ```\n\n        Using `alias` for joining the same model multiple times:\n        ```python\n        from fastcrud import aliased\n\n        owner_alias = aliased(ModelTest, name=\"owner\")\n        user_alias = aliased(ModelTest, name=\"user\")\n\n        result = await crud.get_joined(\n            db=session,\n            schema_to_select=BookingSchema,\n            joins_config=[\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.owner_id == owner_alias.id,\n                    join_prefix=\"owner_\",\n                    alias=owner_alias,\n                    schema_to_select=UserSchema,\n                ),\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.user_id == user_alias.id,\n                    join_prefix=\"user_\",\n                    alias=user_alias,\n                    schema_to_select=UserSchema,\n                ),\n            ],\n            id=1,\n        )\n        ```\n\n        Fetching a single project and its associated participants where a participant has a specific role:\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'role': 'Designer'},\n            ),\n        ]\n        project = await crud.get_joined(\n            db=session,\n            schema_to_select=ProjectSchema,\n            joins_config=joins_config,\n        )\n        ```\n\n        Example of using `joins_config` for multiple joins with nested joins enabled:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n            nest_joins=True,\n        )\n        # Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n        ```\n\n        Example using one-to-one relationship:\n\n        ```python\n        author_crud = FastCRUD(Author)\n        result = await author_crud.get_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Profile,\n            join_on=Author.profile_id == Profile.id,\n            join_schema_to_select=ReadProfileSchema,\n            nest_joins=True,\n            relationship_type='one-to-one', # note that this is the default behavior\n        )\n        # Expect 'result' to have 'profile' as a nested dictionary\n        ```\n\n        Example using one-to-many relationship:\n\n        ```python\n        result = await author_crud.get_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Article,\n            join_on=Author.id == Article.author_id,\n            join_schema_to_select=ReadArticleSchema,\n            nest_joins=True,\n            relationship_type='one-to-many',\n        )\n        # Expect 'result' to have 'posts' as a nested list of dictionaries\n        ```\n    \"\"\"\n    if joins_config and (\n        join_model or join_prefix or join_on or join_schema_to_select or alias\n    ):\n        raise ValueError(\n            \"Cannot use both single join parameters and joins_config simultaneously.\"\n        )\n    elif not joins_config and not join_model:\n        raise ValueError(\"You need one of join_model or joins_config.\")\n\n    primary_select = _extract_matching_columns_from_schema(\n        model=self.model,\n        schema=schema_to_select,\n    )\n    stmt: Select = select(*primary_select).select_from(self.model)\n\n    join_definitions = joins_config if joins_config else []\n    if join_model:\n        join_definitions.append(\n            JoinConfig(\n                model=join_model,\n                join_on=join_on,\n                join_prefix=join_prefix,\n                schema_to_select=join_schema_to_select,\n                join_type=join_type,\n                alias=alias,\n                filters=join_filters,\n                relationship_type=relationship_type,\n            )\n        )\n\n    stmt = self._prepare_and_apply_joins(\n        stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n    )\n    primary_filters = self._parse_filters(**kwargs)\n    if primary_filters:\n        stmt = stmt.filter(*primary_filters)\n\n    db_rows = await db.execute(stmt)\n    if any(join.relationship_type == \"one-to-many\" for join in join_definitions):\n        if nest_joins is False:  # pragma: no cover\n            raise ValueError(\n                \"Cannot use one-to-many relationship with nest_joins=False\"\n            )\n        results = db_rows.fetchall()\n        data_list = [dict(row._mapping) for row in results]\n    else:\n        result = db_rows.first()\n        if result is not None:\n            data_list = [dict(result._mapping)]\n        else:\n            data_list = []\n\n    if data_list:\n        if nest_joins:\n            nested_data: dict = {}\n            for data in data_list:\n                nested_data = _nest_join_data(\n                    data,\n                    join_definitions,\n                    nested_data=nested_data,\n                )\n            return nested_data\n        return data_list[0]\n\n    return None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi","title":"<code>get_multi(db, offset=0, limit=100, schema_to_select=None, sort_columns=None, sort_orders=None, return_as_model=False, return_total_count=True, **kwargs)</code>  <code>async</code>","text":"<p>Fetches multiple records based on filters, supporting sorting, pagination.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>offset</code> <code>int</code> <p>Starting index for records to fetch, useful for pagination.</p> <code>0</code> <code>limit</code> <code>Optional[int]</code> <p>Maximum number of records to fetch in one call. Use <code>None</code> for \"no limit\", fetching all matching rows. Note that in order to use <code>limit=None</code>, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</p> <code>100</code> <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Optional Pydantic schema for selecting specific columns. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>Column names to sort the results by.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>Corresponding sort orders (<code>\"asc\"</code>, <code>\"desc\"</code>) for each column in <code>sort_columns</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, returns data as instances of the specified Pydantic model.</p> <code>False</code> <code>return_total_count</code> <code>bool</code> <p>If <code>True</code>, also returns the total count of rows with the selected filters. Useful for pagination.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for more detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A dictionary containing <code>\"data\"</code> with fetched records and <code>\"total_count\"</code> indicating the total number of records matching the filters.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If <code>limit</code> or <code>offset</code> is negative, or if <code>schema_to_select</code> is required but not provided or invalid.</p> <p>Examples:</p> <p>Fetch the first 10 users:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    0,\n    10,\n)\n</code></pre> <p>Fetch next 10 users with sorted by username:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    10,\n    10,\n    sort_columns='username',\n    sort_orders='desc',\n)\n</code></pre> <p>Fetch 10 users older than 30, sorted by age in descending order:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns='age',\n    sort_orders='desc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch 10 users with a registration date before Jan 1, 2020: <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    registration_date__lt=datetime(2020, 1, 1),\n)\n</code></pre></p> <p>Fetch 10 users with a username other than <code>admin</code>, returning as model instances (ensure appropriate schema is passed):</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    schema_to_select=ReadUserSchema,\n    return_as_model=True,\n    username__ne='admin',\n)\n</code></pre> <p>Fetch users with filtering and multiple column sorting:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    0,\n    10,\n    sort_columns=['username', 'email'],\n    sort_orders=['asc', 'desc'],\n    is_active=True,\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi(\n    self,\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; dict[str, Any]:\n    \"\"\"\n    Fetches multiple records based on filters, supporting sorting, pagination.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        offset: Starting index for records to fetch, useful for pagination.\n        limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.\n        sort_columns: Column names to sort the results by.\n        sort_orders: Corresponding sort orders (`\"asc\"`, `\"desc\"`) for each column in `sort_columns`.\n        return_as_model: If `True`, returns data as instances of the specified Pydantic model.\n        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n    Returns:\n        A dictionary containing `\"data\"` with fetched records and `\"total_count\"` indicating the total number of records matching the filters.\n\n    Raises:\n        ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.\n\n    Examples:\n        Fetch the first 10 users:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            0,\n            10,\n        )\n        ```\n\n        Fetch next 10 users with sorted by username:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            10,\n            10,\n            sort_columns='username',\n            sort_orders='desc',\n        )\n        ```\n\n        Fetch 10 users older than 30, sorted by age in descending order:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            sort_columns='age',\n            sort_orders='desc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch 10 users with a registration date before Jan 1, 2020:\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            registration_date__lt=datetime(2020, 1, 1),\n        )\n        ```\n\n        Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            schema_to_select=ReadUserSchema,\n            return_as_model=True,\n            username__ne='admin',\n        )\n        ```\n\n        Fetch users with filtering and multiple column sorting:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            0,\n            10,\n            sort_columns=['username', 'email'],\n            sort_orders=['asc', 'desc'],\n            is_active=True,\n        )\n        ```\n    \"\"\"\n    if (limit is not None and limit &lt; 0) or offset &lt; 0:\n        raise ValueError(\"Limit and offset must be non-negative.\")\n\n    stmt = await self.select(\n        schema_to_select=schema_to_select,\n        sort_columns=sort_columns,\n        sort_orders=sort_orders,\n        **kwargs,\n    )\n\n    if offset:\n        stmt = stmt.offset(offset)\n    if limit is not None:\n        stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data = [dict(row) for row in result.mappings()]\n\n    response: dict[str, Any] = {\"data\": data}\n\n    if return_total_count:\n        total_count = await self.count(db=db, **kwargs)\n        response[\"total_count\"] = total_count\n\n    if return_as_model:\n        if not schema_to_select:\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        try:\n            model_data = [schema_to_select(**row) for row in data]\n            response[\"data\"] = model_data\n        except ValidationError as e:\n            raise ValueError(\n                f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n            )\n\n    return response\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi_by_cursor","title":"<code>get_multi_by_cursor(db, cursor=None, limit=100, schema_to_select=None, sort_column='id', sort_order='asc', **kwargs)</code>  <code>async</code>","text":"<p>Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>cursor</code> <code>Any</code> <p>The cursor value to start fetching records from. Defaults to <code>None</code>.</p> <code>None</code> <code>limit</code> <code>int</code> <p>Maximum number of rows to fetch.</p> <code>100</code> <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns.</p> <code>None</code> <code>sort_column</code> <code>str</code> <p>Column name to use for sorting and cursor pagination.</p> <code>'id'</code> <code>sort_order</code> <code>str</code> <p>Sorting direction, either <code>\"asc\"</code> or <code>\"desc\"</code>.</p> <code>'asc'</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A dictionary containing the fetched rows under <code>\"data\"</code> key and the next cursor value under <code>\"next_cursor\"</code>.</p> <p>Examples:</p> <p>Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='registration_date',\n    sort_order='desc',\n)\n\n# Fetch the next set of records using the cursor from the first page\nnext_cursor = first_page['next_cursor']\nsecond_page = await user_crud.get_multi_by_cursor(\n    db,\n    cursor=next_cursor,\n    limit=10,\n    sort_column='registration_date',\n    sort_order='desc',\n)\n</code></pre> <p>Fetch records with age greater than 30 using cursor-based pagination:</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='age',\n    sort_order='asc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch records excluding a specific username using cursor-based pagination:</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='username',\n    sort_order='asc',\n    username__ne='admin',\n)\n</code></pre> Note <p>This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features. Make sure the column used for cursor pagination is indexed for performance. This method assumes that your records can be ordered by a unique, sequential field (like <code>id</code> or <code>created_at</code>).</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi_by_cursor(\n    self,\n    db: AsyncSession,\n    cursor: Any = None,\n    limit: int = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_column: str = \"id\",\n    sort_order: str = \"asc\",\n    **kwargs: Any,\n) -&gt; dict[str, Any]:\n    \"\"\"\n    Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        cursor: The cursor value to start fetching records from. Defaults to `None`.\n        limit: Maximum number of rows to fetch.\n        schema_to_select: Pydantic schema for selecting specific columns.\n        sort_column: Column name to use for sorting and cursor pagination.\n        sort_order: Sorting direction, either `\"asc\"` or `\"desc\"`.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.\n\n    Returns:\n        A dictionary containing the fetched rows under `\"data\"` key and the next cursor value under `\"next_cursor\"`.\n\n    Examples:\n        Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='registration_date',\n            sort_order='desc',\n        )\n\n        # Fetch the next set of records using the cursor from the first page\n        next_cursor = first_page['next_cursor']\n        second_page = await user_crud.get_multi_by_cursor(\n            db,\n            cursor=next_cursor,\n            limit=10,\n            sort_column='registration_date',\n            sort_order='desc',\n        )\n        ```\n\n        Fetch records with age greater than 30 using cursor-based pagination:\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='age',\n            sort_order='asc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch records excluding a specific username using cursor-based pagination:\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='username',\n            sort_order='asc',\n            username__ne='admin',\n        )\n        ```\n\n    Note:\n        This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.\n        Make sure the column used for cursor pagination is indexed for performance.\n        This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).\n    \"\"\"\n    if limit == 0:\n        return {\"data\": [], \"next_cursor\": None}\n\n    stmt = await self.select(\n        schema_to_select=schema_to_select,\n        **kwargs,\n    )\n\n    if cursor:\n        if sort_order == \"asc\":\n            stmt = stmt.filter(getattr(self.model, sort_column) &gt; cursor)\n        else:\n            stmt = stmt.filter(getattr(self.model, sort_column) &lt; cursor)\n\n    stmt = stmt.order_by(\n        asc(getattr(self.model, sort_column))\n        if sort_order == \"asc\"\n        else desc(getattr(self.model, sort_column))\n    )\n    stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data = [dict(row) for row in result.mappings()]\n\n    next_cursor = None\n    if len(data) == limit:\n        if sort_order == \"asc\":\n            next_cursor = data[-1][sort_column]\n        else:\n            data[0][sort_column]\n\n    return {\"data\": data, \"next_cursor\": next_cursor}\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi_joined","title":"<code>get_multi_joined(db, schema_to_select=None, join_model=None, join_on=None, join_prefix=None, join_schema_to_select=None, join_type='left', alias=None, join_filters=None, nest_joins=False, offset=0, limit=100, sort_columns=None, sort_orders=None, return_as_model=False, joins_config=None, return_total_count=True, relationship_type=None, **kwargs)</code>  <code>async</code>","text":"<p>Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns from the primary model. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>join_model</code> <code>Optional[type[ModelType]]</code> <p>The model to join with.</p> <code>None</code> <code>join_on</code> <code>Optional[Any]</code> <p>SQLAlchemy Join object for specifying the <code>ON</code> clause of the join. If <code>None</code>, the join condition is auto-detected based on foreign keys.</p> <code>None</code> <code>join_prefix</code> <code>Optional[str]</code> <p>Optional prefix to be added to all columns of the joined model. If <code>None</code>, no prefix is added.</p> <code>None</code> <code>join_schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns from the joined model.</p> <code>None</code> <code>join_type</code> <code>str</code> <p>Specifies the type of join operation to perform. Can be <code>\"left\"</code> for a left outer join or <code>\"inner\"</code> for an inner join.</p> <code>'left'</code> <code>alias</code> <code>Optional[AliasedClass[Any]]</code> <p>An instance of <code>AliasedClass</code> for the join model, useful for self-joins or multiple joins on the same model. Result of <code>aliased(join_model)</code>.</p> <code>None</code> <code>join_filters</code> <code>Optional[dict]</code> <p>Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</p> <code>None</code> <code>nest_joins</code> <code>bool</code> <p>If <code>True</code>, nested data structures will be returned where joined model data are nested under the <code>join_prefix</code> as a dictionary.</p> <code>False</code> <code>offset</code> <code>int</code> <p>The offset (number of records to skip) for pagination.</p> <code>0</code> <code>limit</code> <code>Optional[int]</code> <p>Maximum number of records to fetch in one call. Use <code>None</code> for \"no limit\", fetching all matching rows. Note that in order to use <code>limit=None</code>, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</p> <code>100</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>A single column name or a list of column names on which to apply sorting.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>A single sort order (<code>\"asc\"</code> or <code>\"desc\"</code>) or a list of sort orders corresponding to the columns in <code>sort_columns</code>. If not provided, defaults to <code>\"asc\"</code> for each column.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>List of <code>JoinConfig</code> instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</p> <code>None</code> <code>return_total_count</code> <code>bool</code> <p>If <code>True</code>, also returns the total count of rows with the selected filters. Useful for pagination.</p> <code>True</code> <code>relationship_type</code> <code>Optional[str]</code> <p>Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Used to determine how to nest the joined data. If <code>None</code>, uses <code>\"one-to-one\"</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the primary query, including advanced comparison operators for refined searching.</p> <code>{}</code> <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A dictionary containing the fetched rows under <code>\"data\"</code> key and total count under <code>\"total_count\"</code>.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If either <code>limit</code> or <code>offset</code> are negative, or if <code>schema_to_select</code> is required but not provided or invalid.         Also if both <code>joins_config</code> and any of the single join parameters are provided or none of <code>joins_config</code> and <code>join_model</code> is provided.</p> <p>Examples:</p> <p>Fetching multiple <code>User</code> records joined with <code>Tier</code> records, using left join, returning raw data:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n)\n</code></pre> <p>Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    sort_columns='username',\n    sort_orders='asc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch users joined with their tiers, excluding users with <code>admin</code> username, returning as model instances:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    return_as_model=True,\n    username__ne='admin',\n)\n</code></pre> <p>Fetching and sorting by username in descending order, returning as Pydantic model:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n    sort_columns=['username'],\n    sort_orders=['desc'],\n    return_as_model=True,\n)\n</code></pre> <p>Fetching with complex conditions and custom join, returning as Pydantic model:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n    return_as_model=True,\n    is_active=True,\n)\n</code></pre> <p>Example using <code>joins_config</code> for multiple joins:</p> <pre><code>from fastcrud import JoinConfig\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n)\n</code></pre> <p>Example using <code>alias</code> for multiple joins, with pagination, sorting, and model conversion: <pre><code>from fastcrud import JoinConfig, FastCRUD, aliased\n\n# Aliasing for self-joins or multiple joins on the same table\nowner_alias = aliased(ModelTest, name=\"owner\")\nuser_alias = aliased(ModelTest, name=\"user\")\n\n# Initialize your FastCRUD instance for BookingModel\ncrud = FastCRUD(BookingModel)\n\nresult = await crud.get_multi_joined(\n    db=session,\n    schema_to_select=BookingSchema,  # Primary model schema\n    joins_config=[\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.owner_id == owner_alias.id,\n            join_prefix=\"owner_\",\n            schema_to_select=UserSchema,  # Schema for the joined model\n            alias=owner_alias,\n        ),\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.user_id == user_alias.id,\n            join_prefix=\"user_\",\n            schema_to_select=UserSchema,\n            alias=user_alias,\n        )\n    ],\n    offset=10,  # Skip the first 10 records\n    limit=5,  # Fetch up to 5 records\n    sort_columns=['booking_date'],  # Sort by booking_date\n    sort_orders=['desc'],  # In descending order\n)\n</code></pre></p> <p>Fetching multiple project records and their associated participants where participants have a specific role: <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'role': 'Developer'},\n    ),\n]\nprojects = await crud.get_multi_joined(\n    db=session,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n    limit=10,\n)\n</code></pre></p> <p>Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</p> <pre><code>story_crud = FastCRUD(Story)\nstories = await story_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadStorySchema,\n    joins_config=[\n        JoinConfig(\n            model=Task,\n            join_on=Story.id == Task.story_id,\n            join_prefix=\"task_\",\n            schema_to_select=ReadTaskSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=User,\n            join_on=Task.creator_id == User.id,\n            join_prefix=\"creator_\",\n            schema_to_select=ReadUserSchema,\n            join_type=\"left\",\n            alias=aliased(User, name=\"task_creator\"),\n        ),\n    ],\n    nest_joins=True,\n    offset=0,\n    limit=5,\n    sort_columns='name',\n    sort_orders='asc',\n)\n</code></pre> <p>Example using one-to-one relationship:</p> <pre><code>author_crud = FastCRUD(Author)\nresults = await author_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Profile,\n    join_on=Author.profile_id == Profile.id,\n    join_schema_to_select=ReadProfileSchema,\n    nest_joins=True,\n    offset=0,\n    limit=10,\n    relationship_type='one-to-one', # note that this is the default behavior\n)\n# Expect 'profile' to be nested as a dictionary under each user\n</code></pre> <p>Example using one-to-many relationship:</p> <pre><code>results = await author_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_schema_to_select=ReadArticleSchema,\n    nest_joins=True,\n    offset=0,\n    limit=10,\n    relationship_type='one-to-many',\n)\n# Expect 'posts' to be nested as a list of dictionaries under each user\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi_joined(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[type[ModelType]] = None,\n    join_on: Optional[Any] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass[Any]] = None,\n    join_filters: Optional[dict] = None,\n    nest_joins: bool = False,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    joins_config: Optional[list[JoinConfig]] = None,\n    return_total_count: bool = True,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; dict[str, Any]:\n    \"\"\"\n    Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n        join_model: The model to join with.\n        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n        join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n        offset: The offset (number of records to skip) for pagination.\n        limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n        sort_columns: A single column name or a list of column names on which to apply sorting.\n        sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n        joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.\n        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n        relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n        **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.\n\n    Returns:\n        A dictionary containing the fetched rows under `\"data\"` key and total count under `\"total_count\"`.\n\n    Raises:\n        ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.\n                    Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.\n\n    Examples:\n        Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n        )\n        ```\n\n        Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            sort_columns='username',\n            sort_orders='asc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            return_as_model=True,\n            username__ne='admin',\n        )\n        ```\n\n        Fetching and sorting by username in descending order, returning as Pydantic model:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n            sort_columns=['username'],\n            sort_orders=['desc'],\n            return_as_model=True,\n        )\n        ```\n\n        Fetching with complex conditions and custom join, returning as Pydantic model:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n            return_as_model=True,\n            is_active=True,\n        )\n        ```\n\n        Example using `joins_config` for multiple joins:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n            offset=0,\n            limit=10,\n            sort_columns='username',\n            sort_orders='asc',\n        )\n        ```\n\n        Example using `alias` for multiple joins, with pagination, sorting, and model conversion:\n        ```python\n        from fastcrud import JoinConfig, FastCRUD, aliased\n\n        # Aliasing for self-joins or multiple joins on the same table\n        owner_alias = aliased(ModelTest, name=\"owner\")\n        user_alias = aliased(ModelTest, name=\"user\")\n\n        # Initialize your FastCRUD instance for BookingModel\n        crud = FastCRUD(BookingModel)\n\n        result = await crud.get_multi_joined(\n            db=session,\n            schema_to_select=BookingSchema,  # Primary model schema\n            joins_config=[\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.owner_id == owner_alias.id,\n                    join_prefix=\"owner_\",\n                    schema_to_select=UserSchema,  # Schema for the joined model\n                    alias=owner_alias,\n                ),\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.user_id == user_alias.id,\n                    join_prefix=\"user_\",\n                    schema_to_select=UserSchema,\n                    alias=user_alias,\n                )\n            ],\n            offset=10,  # Skip the first 10 records\n            limit=5,  # Fetch up to 5 records\n            sort_columns=['booking_date'],  # Sort by booking_date\n            sort_orders=['desc'],  # In descending order\n        )\n        ```\n\n        Fetching multiple project records and their associated participants where participants have a specific role:\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'role': 'Developer'},\n            ),\n        ]\n        projects = await crud.get_multi_joined(\n            db=session,\n            schema_to_select=ProjectSchema,\n            joins_config=joins_config,\n            limit=10,\n        )\n        ```\n\n        Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:\n\n        ```python\n        story_crud = FastCRUD(Story)\n        stories = await story_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadStorySchema,\n            joins_config=[\n                JoinConfig(\n                    model=Task,\n                    join_on=Story.id == Task.story_id,\n                    join_prefix=\"task_\",\n                    schema_to_select=ReadTaskSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=User,\n                    join_on=Task.creator_id == User.id,\n                    join_prefix=\"creator_\",\n                    schema_to_select=ReadUserSchema,\n                    join_type=\"left\",\n                    alias=aliased(User, name=\"task_creator\"),\n                ),\n            ],\n            nest_joins=True,\n            offset=0,\n            limit=5,\n            sort_columns='name',\n            sort_orders='asc',\n        )\n        ```\n\n        Example using one-to-one relationship:\n\n        ```python\n        author_crud = FastCRUD(Author)\n        results = await author_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Profile,\n            join_on=Author.profile_id == Profile.id,\n            join_schema_to_select=ReadProfileSchema,\n            nest_joins=True,\n            offset=0,\n            limit=10,\n            relationship_type='one-to-one', # note that this is the default behavior\n        )\n        # Expect 'profile' to be nested as a dictionary under each user\n        ```\n\n        Example using one-to-many relationship:\n\n        ```python\n        results = await author_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Article,\n            join_on=Author.id == Article.author_id,\n            join_schema_to_select=ReadArticleSchema,\n            nest_joins=True,\n            offset=0,\n            limit=10,\n            relationship_type='one-to-many',\n        )\n        # Expect 'posts' to be nested as a list of dictionaries under each user\n        ```\n    \"\"\"\n    if joins_config and (\n        join_model\n        or join_prefix\n        or join_on\n        or join_schema_to_select\n        or alias\n        or relationship_type\n    ):\n        raise ValueError(\n            \"Cannot use both single join parameters and joins_config simultaneously.\"\n        )\n    elif not joins_config and not join_model:\n        raise ValueError(\"You need one of join_model or joins_config.\")\n\n    if (limit is not None and limit &lt; 0) or offset &lt; 0:\n        raise ValueError(\"Limit and offset must be non-negative.\")\n\n    if relationship_type is None:\n        relationship_type = \"one-to-one\"\n\n    primary_select = _extract_matching_columns_from_schema(\n        model=self.model, schema=schema_to_select\n    )\n    stmt: Select = select(*primary_select)\n\n    join_definitions = joins_config if joins_config else []\n    if join_model:\n        join_definitions.append(\n            JoinConfig(\n                model=join_model,\n                join_on=join_on\n                or _auto_detect_join_condition(self.model, join_model),\n                join_prefix=join_prefix,\n                schema_to_select=join_schema_to_select,\n                join_type=join_type,\n                alias=alias,\n                filters=join_filters,\n                relationship_type=relationship_type,\n            )\n        )\n\n    stmt = self._prepare_and_apply_joins(\n        stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n    )\n\n    primary_filters = self._parse_filters(**kwargs)\n    if primary_filters:\n        stmt = stmt.filter(*primary_filters)\n\n    if sort_columns:\n        stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n\n    if offset:\n        stmt = stmt.offset(offset)\n    if limit is not None:\n        stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data: list[Union[dict, BaseModel]] = []\n\n    for row in result.mappings().all():\n        row_dict = dict(row)\n\n        if nest_joins:\n            row_dict = _nest_join_data(\n                data=row_dict,\n                join_definitions=join_definitions,\n            )\n\n        if return_as_model:\n            if schema_to_select is None:\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_instance = schema_to_select(**row_dict)\n                data.append(model_instance)\n            except ValidationError as e:\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n        else:\n            data.append(row_dict)\n\n    if nest_joins and any(\n        join.relationship_type == \"one-to-many\" for join in join_definitions\n    ):\n        nested_data = _nest_multi_join_data(\n            base_primary_key=self._primary_keys[0].name,\n            data=data,\n            joins_config=join_definitions,\n            return_as_model=return_as_model,\n            schema_to_select=schema_to_select if return_as_model else None,\n            nested_schema_to_select={\n                (\n                    join.join_prefix.rstrip(\"_\")\n                    if join.join_prefix\n                    else join.model.__name__\n                ): join.schema_to_select\n                for join in join_definitions\n                if join.schema_to_select\n            },\n        )\n    else:\n        nested_data = _handle_null_primary_key_multi_join(data, join_definitions)\n\n    response: dict[str, Any] = {\"data\": nested_data}\n\n    if return_total_count:\n        total_count: int = await self.count(\n            db=db, joins_config=joins_config, **kwargs\n        )\n        response[\"total_count\"] = total_count\n\n    return response\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.select","title":"<code>select(schema_to_select=None, sort_columns=None, sort_orders=None, **kwargs)</code>  <code>async</code>","text":"<p>Constructs a SQL Alchemy <code>Select</code> statement with optional column selection, filtering, and sorting.</p> <p>This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</p> <code>None</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>A single column name or list of column names to sort the query results by. Must be used in conjunction with <code>sort_orders</code>.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>A single sort order (<code>\"asc\"</code> or <code>\"desc\"</code>) or a list of sort orders, corresponding to each column in <code>sort_columns</code>. If not specified, defaults to ascending order for all <code>sort_columns</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for more detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Select</code> <p>An SQL Alchemy <code>Select</code> statement object that can be executed or further modified.</p> <p>Examples:</p> <p>Selecting specific columns with filtering and sorting:</p> <pre><code>stmt = await user_crud.select(\n    schema_to_select=ReadUserSchema,\n    sort_columns=['age', 'name'],\n    sort_orders=['asc', 'desc'],\n    age__gt=18,\n)\n</code></pre> <p>Creating a statement to select all users without any filters:</p> <pre><code>stmt = await user_crud.select()\n</code></pre> <p>Selecting users with a specific <code>role</code>, ordered by <code>name</code>:</p> <pre><code>stmt = await user_crud.select(\n    schema_to_select=UserReadSchema,\n    sort_columns='name',\n    role='admin',\n)\n</code></pre> Note <p>This method does not execute the generated SQL statement. Use <code>db.execute(stmt)</code> to run the query and fetch results.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def select(\n    self,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any,\n) -&gt; Select:\n    \"\"\"\n    Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.\n\n    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.\n        sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.\n        sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n    Returns:\n        An SQL Alchemy `Select` statement object that can be executed or further modified.\n\n    Examples:\n        Selecting specific columns with filtering and sorting:\n\n        ```python\n        stmt = await user_crud.select(\n            schema_to_select=ReadUserSchema,\n            sort_columns=['age', 'name'],\n            sort_orders=['asc', 'desc'],\n            age__gt=18,\n        )\n        ```\n\n        Creating a statement to select all users without any filters:\n\n        ```python\n        stmt = await user_crud.select()\n        ```\n\n        Selecting users with a specific `role`, ordered by `name`:\n\n        ```python\n        stmt = await user_crud.select(\n            schema_to_select=UserReadSchema,\n            sort_columns='name',\n            role='admin',\n        )\n        ```\n\n    Note:\n        This method does not execute the generated SQL statement.\n        Use `db.execute(stmt)` to run the query and fetch results.\n    \"\"\"\n    to_select = _extract_matching_columns_from_schema(\n        model=self.model, schema=schema_to_select\n    )\n    filters = self._parse_filters(**kwargs)\n    stmt = select(*to_select).filter(*filters)\n\n    if sort_columns:\n        stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n    return stmt\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.update","title":"<code>update(db, object, allow_multiple=False, commit=True, return_columns=None, schema_to_select=None, return_as_model=False, one_or_none=False, **kwargs)</code>  <code>async</code>","text":"<p>Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>object</code> <code>Union[UpdateSchemaType, dict[str, Any]]</code> <p>A Pydantic schema or dictionary containing the update data.</p> required <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows updating multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>return_columns</code> <code>Optional[list[str]]</code> <p>A list of column names to return after the update. If <code>return_as_model</code> is True, all columns are returned.</p> <code>None</code> <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Pydantic schema for selecting specific columns from the updated record(s). Required if <code>return_as_model</code> is <code>True</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, returns the updated record(s) as Pydantic model instances based on <code>schema_to_select</code>. Default is False.</p> <code>False</code> <code>one_or_none</code> <code>bool</code> <p>If <code>True</code>, returns a single record if only one record matches the filters. Default is <code>False</code>.</p> <code>False</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[Union[dict, BaseModel]]</code> <p>The updated record(s) as a dictionary or Pydantic model instance or <code>None</code>, depending on the value of <code>return_as_model</code> and <code>return_columns</code>.</p> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <code>ValueError</code> <p>If extra fields not present in the model are provided in the update data.</p> <code>ValueError</code> <p>If <code>return_as_model</code> is <code>True</code> but <code>schema_to_select</code> is not provided.</p> <p>Examples:</p> <p>Update a user's email based on their ID:</p> <pre><code>await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n</code></pre> <p>Update users to be inactive where age is greater than 30 and allow updates to multiple records:</p> <pre><code>await user_crud.update(\n    db,\n    {'is_active': False},\n    allow_multiple=True,\n    age__gt=30,\n)\n</code></pre> <p>Update a user's username excluding specific user ID and prevent multiple updates:</p> <pre><code>await user_crud.update(\n    db,\n    {'username': 'new_username'},\n    allow_multiple=False,\n    id__ne=1,\n)\n</code></pre> <p>Update a user's email and return the updated record as a Pydantic model instance:</p> <pre><code>user = await user_crud.update(\n    db,\n    {'email': 'new_email@example.com'},\n    schema_to_select=ReadUserSchema,\n    return_as_model=True,\n    id=1,\n)\n</code></pre> <p>Update a user's email and return the updated record as a dictionary: <pre><code>user = await user_crud.update(\n    db,\n    {'email': 'new_email@example.com'},\n    return_columns=['id', 'email'],\n    id=1,\n)\n</code></pre></p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def update(\n    self,\n    db: AsyncSession,\n    object: Union[UpdateSchemaType, dict[str, Any]],\n    allow_multiple: bool = False,\n    commit: bool = True,\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]:\n    \"\"\"\n    Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        object: A Pydantic schema or dictionary containing the update data.\n        allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.\n        schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.\n        return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.\n        one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.\n        **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.\n\n    Returns:\n        The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n        ValueError: If extra fields not present in the model are provided in the update data.\n        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n    Examples:\n        Update a user's email based on their ID:\n\n        ```python\n        await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n        ```\n\n        Update users to be inactive where age is greater than 30 and allow updates to multiple records:\n\n        ```python\n        await user_crud.update(\n            db,\n            {'is_active': False},\n            allow_multiple=True,\n            age__gt=30,\n        )\n        ```\n\n        Update a user's username excluding specific user ID and prevent multiple updates:\n\n        ```python\n        await user_crud.update(\n            db,\n            {'username': 'new_username'},\n            allow_multiple=False,\n            id__ne=1,\n        )\n        ```\n\n        Update a user's email and return the updated record as a Pydantic model instance:\n\n        ```python\n        user = await user_crud.update(\n            db,\n            {'email': 'new_email@example.com'},\n            schema_to_select=ReadUserSchema,\n            return_as_model=True,\n            id=1,\n        )\n        ```\n\n        Update a user's email and return the updated record as a dictionary:\n        ```python\n        user = await user_crud.update(\n            db,\n            {'email': 'new_email@example.com'},\n            return_columns=['id', 'email'],\n            id=1,\n        )\n        ```\n    \"\"\"\n    if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to update, found {total_count}.\"\n        )\n\n    if isinstance(object, dict):\n        update_data = object\n    else:\n        update_data = object.model_dump(exclude_unset=True)\n\n    updated_at_col = getattr(self.model, self.updated_at_column, None)\n    if updated_at_col:\n        update_data[self.updated_at_column] = datetime.now(timezone.utc)\n\n    update_data_keys = set(update_data.keys())\n    model_columns = {_column.name for _column in inspect(self.model).c}\n    extra_fields = update_data_keys - model_columns\n    if extra_fields:\n        raise ValueError(f\"Extra fields provided: {extra_fields}\")\n\n    filters = self._parse_filters(**kwargs)\n    stmt = update(self.model).filter(*filters).values(update_data)\n\n    if return_as_model:\n        return_columns = self.model_col_names\n\n    if return_columns:\n        stmt = stmt.returning(*[column(name) for name in return_columns])\n        db_row = await db.execute(stmt)\n        if allow_multiple:\n            return self._as_multi_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n            )\n        return self._as_single_response(\n            db_row,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n            one_or_none=one_or_none,\n        )\n\n    await db.execute(stmt)\n    if commit:\n        await db.commit()\n    return None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.upsert","title":"<code>upsert(db, instance, schema_to_select=None, return_as_model=False)</code>  <code>async</code>","text":"<p>Update the instance or create it if it doesn't exists.</p> <p>Note: This method will perform two transactions to the database (get and create or update).</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>instance</code> <code>Union[UpdateSchemaType, CreateSchemaType]</code> <p>A Pydantic schema representing the instance.</p> required <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Optional Pydantic schema for selecting specific columns. Defaults to <code>None</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <p>Returns:</p> Type Description <code>Union[BaseModel, Dict[str, Any], None]</code> <p>The created or updated instance</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def upsert(\n    self,\n    db: AsyncSession,\n    instance: Union[UpdateSchemaType, CreateSchemaType],\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n) -&gt; Union[BaseModel, Dict[str, Any], None]:\n    \"\"\"Update the instance or create it if it doesn't exists.\n\n    Note: This method will perform two transactions to the database (get and create or update).\n\n    Args:\n        db: The database session to use for the operation.\n        instance: A Pydantic schema representing the instance.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n\n    Returns:\n        The created or updated instance\n    \"\"\"\n    _pks = self._get_pk_dict(instance)\n    schema_to_select = schema_to_select or type(instance)\n    db_instance = await self.get(\n        db,\n        schema_to_select=schema_to_select,\n        return_as_model=return_as_model,\n        **_pks,\n    )\n    if db_instance is None:\n        db_instance = await self.create(db, instance)  # type: ignore\n        db_instance = schema_to_select.model_validate(\n            db_instance, from_attributes=True\n        )\n    else:\n        await self.update(db, instance)  # type: ignore\n        db_instance = await self.get(\n            db,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n            **_pks,\n        )\n\n    return db_instance\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.upsert_multi","title":"<code>upsert_multi(db, instances, return_columns=None, schema_to_select=None, return_as_model=False, update_override=None, **kwargs)</code>  <code>async</code>","text":"<p>Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>instances</code> <code>list[Union[UpdateSchemaType, CreateSchemaType]]</code> <p>A list of Pydantic schemas representing the instances to upsert.</p> required <code>return_columns</code> <code>Optional[list[str]]</code> <p>Optional list of column names to return after the upsert operation.</p> <code>None</code> <code>schema_to_select</code> <code>Optional[type[BaseModel]]</code> <p>Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If True, returns data as instances of the specified Pydantic model.</p> <code>False</code> <code>update_override</code> <code>Optional[dict[str, Any]]</code> <p>Optional dictionary to override the update values for the upsert operation.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[Dict[str, Any]]</code> <p>The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of <code>return_as_model</code> and <code>return_columns</code>.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</p> <code>NotImplementedError</code> <p>If the database dialect is not supported for upsert multi.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def upsert_multi(\n    self,\n    db: AsyncSession,\n    instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    update_override: Optional[dict[str, Any]] = None,\n    **kwargs: Any,\n) -&gt; Optional[Dict[str, Any]]:\n    \"\"\"\n    Upsert multiple records in the database. The underlying implementation varies based on the database dialect.\n\n    Args:\n        db: The database session to use for the operation.\n        instances: A list of Pydantic schemas representing the instances to upsert.\n        return_columns: Optional list of column names to return after the upsert operation.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.\n        return_as_model: If True, returns data as instances of the specified Pydantic model.\n        update_override: Optional dictionary to override the update values for the upsert operation.\n        **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.\n\n    Returns:\n        The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.\n\n    Raises:\n        ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.\n        NotImplementedError: If the database dialect is not supported for upsert multi.\n    \"\"\"\n    if update_override is None:\n        update_override = {}\n    filters = self._parse_filters(**kwargs)\n\n    if db.bind.dialect.name == \"postgresql\":\n        statement, params = await self._upsert_multi_postgresql(\n            instances, filters, update_override\n        )\n    elif db.bind.dialect.name == \"sqlite\":\n        statement, params = await self._upsert_multi_sqlite(\n            instances, filters, update_override\n        )\n    elif db.bind.dialect.name in [\"mysql\", \"mariadb\"]:\n        if filters:\n            raise ValueError(\n                \"MySQL does not support filtering on insert operations.\"\n            )\n        if return_columns or schema_to_select or return_as_model:\n            raise ValueError(\n                \"MySQL does not support the returning clause for insert operations.\"\n            )\n        statement, params = await self._upsert_multi_mysql(\n            instances, update_override\n        )\n    else:  # pragma: no cover\n        raise NotImplementedError(\n            f\"Upsert multi is not implemented for {db.bind.dialect.name}\"\n        )\n\n    if return_as_model:\n        return_columns = self.model_col_names\n\n    if return_columns:\n        statement = statement.returning(*[column(name) for name in return_columns])\n        db_row = await db.execute(statement, params)\n        return self._as_multi_response(\n            db_row,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n        )\n\n    await db.execute(statement, params)\n    return None\n</code></pre>"},{"location":"api/overview/","title":"API Reference Overview","text":"<p>Welcome to the API Reference section of our documentation. This section provides detailed information about the various classes, functions, and modules that make up our application. Whether you are looking to extend the application, integrate with it, or simply explore its capabilities, this section will guide you through the intricacies of our codebase.</p>"},{"location":"api/overview/#key-components","title":"Key Components","text":"<p>Our application's API is comprised of several key components, each serving a specific purpose:</p> <ol> <li> <p>FastCRUD Class: This class is at the heart of our CRUD (Create, Read, Update, Delete) operations. It provides a convenient and efficient way to interact with our database models.</p> <ul> <li>FastCRUD Class Reference</li> </ul> </li> <li> <p>EndpointCreator Class: A utility class for creating and registering CRUD endpoints in a FastAPI application. It simplifies the addition of standard CRUD endpoints to your FastAPI router.</p> <ul> <li>EndpointCreator Class Reference</li> </ul> </li> <li> <p>crud_router Function: A function that creates and configures a FastAPI router with CRUD endpoints for a specific model. It's a quick way to add standard CRUD operations to your models.</p> <ul> <li>CRUD Router Function Reference</li> </ul> </li> <li> <p>paginated Module: A a utility module for offset pagination related functions.</p> <ul> <li>Pagination Module Reference</li> </ul> </li> </ol>"},{"location":"api/overview/#usage","title":"Usage","text":"<p>Each component is documented with its own dedicated page, where you can find detailed information about its methods, parameters, return types, and usage examples. These pages are designed to provide you with all the information you need to understand and work with our API effectively.</p>"},{"location":"api/overview/#contribution","title":"Contribution","text":"<p>If you wish to contribute to the development of our API, please refer to our Contributing Guidelines. We welcome contributions of all forms, from bug fixes to feature development.</p>"},{"location":"api/overview/#feedback","title":"Feedback","text":"<p>Your feedback is crucial in helping us improve this documentation. If you have any suggestions, corrections, or queries, please reach out to us.</p> <p>Navigate through each section for detailed documentation of our API components.</p>"},{"location":"api/paginated/","title":"Paginated Module Reference","text":"<p><code>paginated</code> is a utility module for offset pagination related functions.</p>"},{"location":"api/paginated/#function-definition","title":"Function Definition","text":""},{"location":"api/paginated/#fastcrud.paginated.compute_offset","title":"<code>compute_offset(page, items_per_page)</code>","text":"<p>Calculate the offset for pagination based on the given page number and items per page.</p> <p>The offset represents the starting point in a dataset for the items on a given page. For example, if each page displays 10 items and you want to display page 3, the offset will be 20, meaning the display should start with the 21st item.</p> <p>Parameters:</p> Name Type Description Default <code>page</code> <code>int</code> <p>The current page number. Page numbers should start from 1.</p> required <code>items_per_page</code> <code>int</code> <p>The number of items to be displayed on each page.</p> required <p>Returns:</p> Type Description <code>int</code> <p>The calculated offset.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; offset(1, 10)\n0\n&gt;&gt;&gt; offset(3, 10)\n20\n</code></pre> Source code in <code>fastcrud/paginated/helper.py</code> <pre><code>def compute_offset(page: int, items_per_page: int) -&gt; int:\n    \"\"\"Calculate the offset for pagination based on the given page number and items per page.\n\n    The offset represents the starting point in a dataset for the items on a given page.\n    For example, if each page displays 10 items and you want to display page 3, the offset will be 20,\n    meaning the display should start with the 21st item.\n\n    Args:\n        page: The current page number. Page numbers should start from 1.\n        items_per_page: The number of items to be displayed on each page.\n\n    Returns:\n        The calculated offset.\n\n    Examples:\n        &gt;&gt;&gt; offset(1, 10)\n        0\n        &gt;&gt;&gt; offset(3, 10)\n        20\n    \"\"\"\n    return (page - 1) * items_per_page\n</code></pre>"},{"location":"api/paginated/#fastcrud.paginated.paginated_response","title":"<code>paginated_response(crud_data, page, items_per_page)</code>","text":"<p>Create a paginated response based on the provided data and pagination parameters.</p> <p>Parameters:</p> Name Type Description Default <code>crud_data</code> <code>dict</code> <p>Data to be paginated, including the list of items and total count.</p> required <code>page</code> <code>int</code> <p>Current page number.</p> required <code>items_per_page</code> <code>int</code> <p>Number of items per page.</p> required <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A structured paginated response dict containing the list of items, total count, pagination flags, and numbers.</p> Note <p>The function does not actually paginate the data but formats the response to indicate pagination metadata.</p> Source code in <code>fastcrud/paginated/response.py</code> <pre><code>def paginated_response(\n    crud_data: dict, page: int, items_per_page: int\n) -&gt; dict[str, Any]:\n    \"\"\"Create a paginated response based on the provided data and pagination parameters.\n\n    Args:\n        crud_data: Data to be paginated, including the list of items and total count.\n        page: Current page number.\n        items_per_page: Number of items per page.\n\n    Returns:\n        A structured paginated response dict containing the list of items, total count, pagination flags, and numbers.\n\n    Note:\n        The function does not actually paginate the data but formats the response to indicate pagination metadata.\n    \"\"\"\n    return {\n        \"data\": crud_data[\"data\"],\n        \"total_count\": crud_data[\"total_count\"],\n        \"has_more\": (page * items_per_page) &lt; crud_data[\"total_count\"],\n        \"page\": page,\n        \"items_per_page\": items_per_page,\n    }\n</code></pre>"},{"location":"community/CODE_OF_CONDUCT/","title":"Contributor Covenant Code of Conduct","text":""},{"location":"community/CODE_OF_CONDUCT/#our-pledge","title":"Our Pledge","text":"<p>We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.</p> <p>We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.</p>"},{"location":"community/CODE_OF_CONDUCT/#our-standards","title":"Our Standards","text":"<p>Examples of behavior that contributes to a positive environment for our community include:</p> <ul> <li>Demonstrating empathy and kindness toward other people</li> <li>Being respectful of differing opinions, viewpoints, and experiences</li> <li>Giving and gracefully accepting constructive feedback</li> <li>Accepting responsibility and apologizing to those affected by our mistakes,   and learning from the experience</li> <li>Focusing on what is best not just for us as individuals, but for the   overall community</li> </ul> <p>Examples of unacceptable behavior include:</p> <ul> <li>The use of sexualized language or imagery, and sexual attention or   advances of any kind</li> <li>Trolling, insulting or derogatory comments, and personal or political attacks</li> <li>Public or private harassment</li> <li>Publishing others' private information, such as a physical or email   address, without their explicit permission</li> <li>Other conduct which could reasonably be considered inappropriate in a   professional setting</li> </ul>"},{"location":"community/CODE_OF_CONDUCT/#enforcement-responsibilities","title":"Enforcement Responsibilities","text":"<p>Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.</p> <p>Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.</p>"},{"location":"community/CODE_OF_CONDUCT/#scope","title":"Scope","text":"<p>This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.</p>"},{"location":"community/CODE_OF_CONDUCT/#enforcement","title":"Enforcement","text":"<p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at igor.magalhaes.r@gmail.com. All complaints will be reviewed and investigated promptly and fairly.</p> <p>All community leaders are obligated to respect the privacy and security of the reporter of any incident.</p>"},{"location":"community/CODE_OF_CONDUCT/#enforcement-guidelines","title":"Enforcement Guidelines","text":"<p>Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:</p>"},{"location":"community/CODE_OF_CONDUCT/#1-correction","title":"1. Correction","text":"<p>Community Impact: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.</p> <p>Consequence: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.</p>"},{"location":"community/CODE_OF_CONDUCT/#2-warning","title":"2. Warning","text":"<p>Community Impact: A violation through a single incident or series of actions.</p> <p>Consequence: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.</p>"},{"location":"community/CODE_OF_CONDUCT/#3-temporary-ban","title":"3. Temporary Ban","text":"<p>Community Impact: A serious violation of community standards, including sustained inappropriate behavior.</p> <p>Consequence: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.</p>"},{"location":"community/CODE_OF_CONDUCT/#4-permanent-ban","title":"4. Permanent Ban","text":"<p>Community Impact: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.</p> <p>Consequence: A permanent ban from any sort of public interaction within the community.</p>"},{"location":"community/CODE_OF_CONDUCT/#attribution","title":"Attribution","text":"<p>This Code of Conduct is adapted from the Contributor Covenant, version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.</p> <p>Community Impact Guidelines were inspired by Mozilla's code of conduct enforcement ladder.</p> <p>For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.</p>"},{"location":"community/CONTRIBUTING/","title":"Contributing to FastCRUD","text":"<p>Thank you for your interest in contributing to FastCRUD! This guide is meant to make it easy for you to get started.</p>"},{"location":"community/CONTRIBUTING/#setting-up-your-development-environment","title":"Setting Up Your Development Environment","text":""},{"location":"community/CONTRIBUTING/#cloning-the-repository","title":"Cloning the Repository","text":"<p>Start by forking and cloning the FastCRUD repository:</p> <pre><code>git clone https://github.com/YOUR-GITHUB-USERNAME/fastcrud.git\n</code></pre>"},{"location":"community/CONTRIBUTING/#using-poetry-for-dependency-management","title":"Using Poetry for Dependency Management","text":"<p>FastCRUD uses Poetry for managing dependencies. If you don't have Poetry installed, follow the instructions on the official Poetry website.</p> <p>Once Poetry is installed, navigate to the cloned repository and install the dependencies: <pre><code>cd fastcrud\npoetry install\n</code></pre></p>"},{"location":"community/CONTRIBUTING/#activating-the-virtual-environment","title":"Activating the Virtual Environment","text":"<p>Poetry creates a virtual environment for your project. Activate it using:</p> <pre><code>poetry shell\n</code></pre>"},{"location":"community/CONTRIBUTING/#making-contributions","title":"Making Contributions","text":""},{"location":"community/CONTRIBUTING/#coding-standards","title":"Coding Standards","text":"<ul> <li>Follow PEP 8 guidelines.</li> <li>Write meaningful tests for new features or bug fixes.</li> </ul>"},{"location":"community/CONTRIBUTING/#testing-with-pytest","title":"Testing with Pytest","text":"<p>FastCRUD uses pytest for testing. Run tests using: <pre><code>poetry run pytest\n</code></pre></p>"},{"location":"community/CONTRIBUTING/#linting","title":"Linting","text":"<p>Use mypy for type checking: <pre><code>mypy fastcrud\n</code></pre></p> <p>Use ruff for style: <pre><code>ruff check --fix\nruff format\n</code></pre></p> <p>Ensure your code passes linting before submitting.</p>"},{"location":"community/CONTRIBUTING/#submitting-your-contributions","title":"Submitting Your Contributions","text":""},{"location":"community/CONTRIBUTING/#creating-a-pull-request","title":"Creating a Pull Request","text":"<p>After making your changes:</p> <ul> <li>Push your changes to your fork.</li> <li>Open a pull request with a clear description of your changes.</li> <li>Update the README.md if necessary.</li> </ul>"},{"location":"community/CONTRIBUTING/#code-reviews","title":"Code Reviews","text":"<ul> <li>Address any feedback from code reviews.</li> <li>Once approved, your contributions will be merged into the main branch.</li> </ul>"},{"location":"community/CONTRIBUTING/#code-of-conduct","title":"Code of Conduct","text":"<p>Please adhere to our Code of Conduct to maintain a welcoming and inclusive environment.</p> <p>Thank you for contributing to FastCRUD\ud83d\ude80</p>"},{"location":"community/LICENSE/","title":"License","text":"<p>MIT License</p> <p>Copyright (c) 2023 Igor Magalh\u00e3es</p> <p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p> <p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> <p>THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>"},{"location":"community/overview/","title":"Community Overview","text":"<p>Welcome to the project's community hub. Here, you'll find essential resources and guidelines that are crucial for contributing to and participating in the project. Please take the time to familiarize yourself with the following documents:</p>"},{"location":"community/overview/#table-of-contents","title":"Table of Contents","text":"<ul> <li>Contributing</li> <li>Code of Conduct</li> <li>License</li> </ul>"},{"location":"community/overview/#contributing","title":"Contributing","text":"<p>View the Contributing Guidelines</p> <p>Interested in contributing to the project? Great! The contributing guidelines will provide you with all the information you need to get started. This includes how to submit issues, propose changes, and the process for submitting pull requests.</p>"},{"location":"community/overview/#code-of-conduct","title":"Code of Conduct","text":"<p>View the Code of Conduct</p> <p>The Code of Conduct outlines the standards and behaviors expected of our community members. It's crucial to ensure a welcoming and inclusive environment for everyone. Please take the time to read and adhere to these guidelines.</p>"},{"location":"community/overview/#license","title":"License","text":"<p>View the License</p> <p>The license document outlines the terms under which our project can be used, modified, and distributed. Understanding the licensing is important for both users and contributors of the project.</p> <p>Thank you for being a part of our community and for contributing to our project's success!</p>"},{"location":"usage/crud/","title":"Using FastCRUD for Enhanced CRUD Operations","text":"<p>FastCRUD is a versatile tool for handling CRUD (Create, Read, Update, Delete) operations in FastAPI applications with SQLAlchemy models. It leverages Pydantic schemas for data validation and serialization, offering a streamlined approach to database interactions.</p>"},{"location":"usage/crud/#key-features","title":"Key Features","text":"<ul> <li>Simplified CRUD operations with SQLAlchemy models.</li> <li>Data validation and serialization using Pydantic.</li> <li>Support for complex queries including joins and pagination.</li> </ul>"},{"location":"usage/crud/#getting-started","title":"Getting Started","text":""},{"location":"usage/crud/#step-1-define-models-and-schemas","title":"Step 1: Define Models and Schemas","text":"<p>Define your SQLAlchemy models and Pydantic schemas for data representation.</p> Models and Schemas Used Below <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre> <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>customer/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadCustomerSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n</code></pre>"},{"location":"usage/crud/#step-2-initialize-fastcrud","title":"Step 2: Initialize FastCRUD","text":"<p>Create a <code>FastCRUD</code> instance for your model to handle CRUD operations.</p> <pre><code>from fastcrud import FastCRUD\n\n# Creating a FastCRUD instance\nitem_crud = FastCRUD(Item)\norder_crud = FastCRUD(Order)\n</code></pre>"},{"location":"usage/crud/#step-3-pick-your-method","title":"Step 3: Pick your Method","text":"<p>Then you just pick the method you need and use it like this:</p> <pre><code># Creating a new record\nnew_record = await item_crud.create(db_session, create_schema_instance)\n</code></pre> <p>More on available methods below.</p>"},{"location":"usage/crud/#understanding-fastcrud-methods","title":"Understanding FastCRUD Methods","text":"<p>FastCRUD offers a comprehensive suite of methods for CRUD operations, each designed to handle different aspects of database interactions efficiently.</p>"},{"location":"usage/crud/#1-create","title":"1. Create","text":"<pre><code>create(\n    db: AsyncSession,\n    object: CreateSchemaType,\n    commit: bool = True,\n) -&gt; ModelType\n</code></pre> <p>Purpose: To create a new record in the database. Usage Example: Creates an item with name <code>\"New Item\"</code>.</p> <pre><code>new_item = await item_crud.create(db, CreateItemSchema(name=\"New Item\"))\n</code></pre> <p>Warning</p> <p>Note that naive <code>datetime</code> such as <code>datetime.utcnow</code> is not supported by <code>FastCRUD</code> as it was deprecated.</p> <p>Use timezone aware <code>datetime</code>, such as <code>datetime.now(UTC)</code> instead.</p>"},{"location":"usage/crud/#2-get","title":"2. Get","text":"<pre><code>get(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]\n</code></pre> <p>Purpose: To fetch a single record based on filters, with an option to select specific columns using a Pydantic schema. Usage Example: Fetches the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>item = await item_crud.get(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#3-exists","title":"3. Exists","text":"<pre><code>exists(\n    db: AsyncSession,\n    **kwargs: Any,\n) -&gt; bool\n</code></pre> <p>Purpose: To check if a record exists based on provided filters. Usage Example: Checks whether an item with name <code>\"Existing Item\"</code> exists.</p> <pre><code>exists = await item_crud.exists(db, name=\"Existing Item\")\n</code></pre>"},{"location":"usage/crud/#4-count","title":"4. Count","text":"<pre><code>count(\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int\n</code></pre> <p>Purpose: To count the number of records matching provided filters. Usage Example: Counts the number of items with the <code>\"Books\"</code> category.</p> <pre><code>count = await item_crud.count(db, category=\"Books\")\n</code></pre>"},{"location":"usage/crud/#5-get-multi","title":"5. Get Multi","text":"<pre><code>get_multi(\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: To fetch multiple records with optional sorting, pagination, and model conversion. Usage Example: Fetches a subset of 5 items, starting from the 11th item in the database.</p> <pre><code>items = await item_crud.get_multi(db, offset=10, limit=5)\n</code></pre>"},{"location":"usage/crud/#6-update","title":"6. Update","text":"<pre><code>update(\n    db: AsyncSession, \n    object: Union[UpdateSchemaType, dict[str, Any]], \n    allow_multiple: bool = False,\n    commit: bool = True,\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]\n</code></pre> <p>Purpose: To update an existing record in the database. Usage Example: Updates the description of the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>await item_crud.update(\n    db,\n    UpdateItemSchema(description=\"Updated\"),\n    id=item_id,\n)\n</code></pre>"},{"location":"usage/crud/#7-delete","title":"7. Delete","text":"<pre><code>delete(\n    db: AsyncSession, \n    db_row: Optional[Row] = None, \n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None\n</code></pre> <p>Purpose: To delete a record from the database, with support for soft delete. Usage Example: Deletes the item with <code>item_id</code> as its <code>id</code>, performs a soft delete if the model has the <code>is_deleted</code> column.</p> <pre><code>await item_crud.delete(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#8-hard-delete","title":"8. Hard Delete","text":"<pre><code>db_delete(\n    db: AsyncSession, \n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None\n</code></pre> <p>Purpose: To hard delete a record from the database. Usage Example: Hard deletes the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>await item_crud.db_delete(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#advanced-methods-for-complex-queries-and-joins","title":"Advanced Methods for Complex Queries and Joins","text":"<p>FastCRUD extends its functionality with advanced methods tailored for complex query operations and handling joins. These methods cater to specific use cases where more sophisticated data retrieval and manipulation are required.</p>"},{"location":"usage/crud/#1-get-multi","title":"1. Get Multi","text":"<pre><code>get_multi(\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: To fetch multiple records based on specified filters, with options for sorting and pagination. Usage Example: Gets the first 10 items sorted by <code>name</code> in ascending order.</p> <pre><code>items = await item_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns=['name'],\n    sort_orders=['asc'],\n)\n</code></pre>"},{"location":"usage/crud/#2-get-joined","title":"2. Get Joined","text":"<pre><code>get_joined(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[ModelType] = None,\n    join_on: Optional[Union[Join, BinaryExpression]] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass] = None,\n    join_filters: Optional[dict] = None,\n    joins_config: Optional[list[JoinConfig]] = None,\n    nest_joins: bool = False,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; Optional[dict[str, Any]]\n</code></pre> <p>Purpose: To fetch a single record with one or multiple joins on other models. Usage Example: Fetches order details for a specific order by joining with the <code>Customer</code> table, selecting specific columns as defined in <code>ReadOrderSchema</code> and <code>ReadCustomerSchema</code>.</p> <pre><code>order_details = await order_crud.get_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Customer,\n    join_schema_to_select=ReadCustomerSchema,\n    id=order_id,\n)\n</code></pre>"},{"location":"usage/crud/#3-get-multi-joined","title":"3. Get Multi Joined","text":"<pre><code>get_multi_joined(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[type[ModelType]] = None,\n    join_on: Optional[Any] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass[Any]] = None,\n    join_filters: Optional[dict] = None,\n    nest_joins: bool = False,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    joins_config: Optional[list[JoinConfig]] = None,\n    return_total_count: bool = True,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: Similar to <code>get_joined</code>, but for fetching multiple records. Usage Example: Retrieves a paginated list of orders (up to 5), joined with the <code>Customer</code> table, using specified schemas for selective column retrieval from both tables.</p> <pre><code>orders = await order_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Customer,\n    join_schema_to_select=ReadCustomerSchema,\n    offset=0,\n    limit=5,\n)\n</code></pre>"},{"location":"usage/crud/#4-get-multi-by-cursor","title":"4. Get Multi By Cursor","text":"<pre><code>get_multi_by_cursor(\n    db: AsyncSession,\n    cursor: Any = None,\n    limit: int = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_column: str = \"id\",\n    sort_order: str = \"asc\",\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: Implements cursor-based pagination for efficient data retrieval in large datasets. Usage Example: Fetches the next 10 items after the last cursor for efficient pagination, sorted by creation date in descending order.</p> <pre><code>paginated_items = await item_crud.get_multi_by_cursor(\n    db,\n    cursor=last_cursor,\n    limit=10,\n    sort_column='created_at',\n    sort_order='desc',\n)\n</code></pre>"},{"location":"usage/crud/#5-select","title":"5. Select","text":"<pre><code>async def select(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any,\n) -&gt; Select\n</code></pre> <p>Purpose: Constructs a SQL Alchemy <code>Select</code> statement with optional column selection, filtering, and sorting. Usage Example: Selects all items, filtering by <code>name</code> and sorting by <code>id</code>. Returns the <code>Select</code> statement.</p> <pre><code>stmt = await item_crud.select(\n    schema_to_select=ItemSchema,\n    sort_columns='id',\n    name='John',\n)\n# Note: This method returns a SQL Alchemy Select object, not the actual query result.\n</code></pre>"},{"location":"usage/crud/#6-count-for-joined-models","title":"6. Count for Joined Models","text":"<pre><code>count(\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int\n</code></pre> <p>Purpose: To count records that match specified filters, especially useful in scenarios involving joins between models. This method supports counting unique entities across relationships, a common requirement in many-to-many or complex relationships. Usage Example: Count the number of unique projects a participant is involved in, considering a many-to-many relationship between <code>Project</code> and <code>Participant</code> models.</p> <pre><code># Assuming a Project model related to a Participant model through a many-to-many relationship\nprojects_count = await project_crud.count(\n    db=session,\n    joins_config=[\n        JoinConfig(\n            model=Participant,\n            join_on=ProjectsParticipantsAssociation.project_id == Project.id,\n            join_type=\"inner\",\n        ),\n    ],\n    participant_id=specific_participant_id,\n)\n</code></pre>"},{"location":"usage/crud/#error-handling","title":"Error Handling","text":"<p>FastCRUD provides mechanisms to handle common database errors, ensuring robust API behavior.</p>"},{"location":"usage/endpoint/","title":"Automatic Endpoint Creation with <code>crud_router</code>","text":"<p>This section of the documentation explains how to use the <code>crud_router</code> utility function from the FastCRUD package for automatic endpoint creation in a FastAPI application. The <code>crud_router</code> simplifies the process of creating standard CRUD (Create, Read, Update, Delete) endpoints for your models.</p>"},{"location":"usage/endpoint/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure you have FastAPI and FastCRUD installed in your environment. FastCRUD streamlines interactions with the database using SQLAlchemy models and Pydantic schemas.</p>"},{"location":"usage/endpoint/#using-crud_router","title":"Using <code>crud_router</code>","text":""},{"location":"usage/endpoint/#step-1-define-your-model-and-schema","title":"Step 1: Define Your Model and Schema","text":"<p>First, define your SQLAlchemy model and corresponding Pydantic schemas for creating and updating data.</p> <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre>"},{"location":"usage/endpoint/#step-2-set-up-fastapi-and-fastcrud","title":"Step 2: Set Up FastAPI and FastCRUD","text":"<p>Next, set up your FastAPI application, you can optionally set up a custom FastCRUD instance as well. This involves configuring the database connection.</p> <pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n</code></pre>"},{"location":"usage/endpoint/#step-3-use-crud_router-to-create-endpoints","title":"Step 3: Use <code>crud_router</code> to Create Endpoints","text":"<pre><code># CRUD router setup\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"],\n)\n\napp.include_router(item_router)\n</code></pre>"},{"location":"usage/endpoint/#available-endpoints","title":"Available Endpoints","text":"<p>For a comprehensive list of all available endpoints, read the advanced section.</p>"},{"location":"usage/endpoint/#usage-and-testing","title":"Usage and Testing","text":"<p>Once the application is running, you can test the automatically created endpoints using tools like Swagger UI, which FastAPI provides by default. The endpoints for creating, reading, updating, and deleting Item instances are now accessible at <code>/items</code>.</p>"},{"location":"usage/endpoint/#using-endpointcreator-directly","title":"Using <code>EndpointCreator</code> Directly","text":"<p>Using the <code>EndpointCreator</code> class in FastCRUD is a more flexible way to add CRUD endpoints to a FastAPI application.</p>"},{"location":"usage/endpoint/#step-1-define-your-model-and-schema_1","title":"Step 1: Define Your Model and Schema","text":"<p>Define your SQLAlchemy models and corresponding Pydantic schemas for data validation.</p> <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass DeleteItemSchema(BaseModel):\n    pass\n</code></pre>"},{"location":"usage/endpoint/#step-2-set-up-fastapi-and-fastcrud_1","title":"Step 2: Set Up FastAPI and FastCRUD","text":"<p>Next, set up your FastAPI application and FastCRUD instances. This involves configuring the database connection and creating a CRUD instance for your model.</p> <pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\n# CRUD operations setup\nitem_crud = FastCRUD(Item)\n</code></pre>"},{"location":"usage/endpoint/#step-3-initialize-endpointcreator","title":"Step 3: Initialize <code>EndpointCreator</code>","text":"<p>Create an instance of <code>EndpointCreator</code> by passing the necessary parameters, including your model, session, CRUD instance, and schemas.</p> <pre><code>from fastcrud import EndpointCreator\n\n# Initialize EndpointCreator\nendpoint_creator = EndpointCreator(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    crud=item_crud,\n    delete_schema=DeleteItemSchema,\n    path=\"/itempath\",\n    tags=[\"ItemTag\"]\n)\n</code></pre>"},{"location":"usage/endpoint/#step-4-add-custom-endpoints","title":"Step 4: Add Custom Endpoints","text":"<p>Add custom endpoints using <code>EndpointCreator</code>. You can inject dependencies as needed.</p> <pre><code># Example of adding custom dependencies\nendpoint_creator.add_routes_to_router(\n    read_deps=[custom_dependency],\n    update_deps=[another_custom_dependency],\n)\n</code></pre>"},{"location":"usage/endpoint/#step-5-include-the-router-in-your-application","title":"Step 5: Include the Router in Your Application","text":"<p>Finally, include the router from the <code>EndpointCreator</code> in your FastAPI application.</p> <pre><code>app.include_router(endpoint_creator.router)\n</code></pre>"},{"location":"usage/endpoint/#advanced-customization","title":"Advanced Customization","text":"<p>You can override the default methods in <code>EndpointCreator</code> for more control over the CRUD operations. You can also specify the operations you want to include. Read more in the advanced section.</p>"},{"location":"usage/endpoint/#conclusion","title":"Conclusion","text":"<p>By following these steps, you can quickly set up CRUD endpoints for your models in a FastAPI application using <code>crud_router</code> or <code>EndpointCreator</code>. This utility function reduces boilerplate code and increases development efficiency by automating the creation of standard API endpoints.</p>"},{"location":"usage/overview/","title":"Usage Overview","text":"<p>The Usage section of our documentation provides comprehensive guides on how to effectively use key features of our application. This section is divided into various topics, each focusing on a specific aspect of usage, ensuring that you have all the information you need to leverage the full potential of our tools and functionalities.</p>"},{"location":"usage/overview/#key-topics","title":"Key Topics","text":""},{"location":"usage/overview/#1-automatic-endpoint-creation-with-crud_router","title":"1. Automatic Endpoint Creation with <code>crud_router</code>","text":"<p>This guide covers the use of <code>crud_router</code> for automatic endpoint creation in FastAPI applications. It provides a step-by-step approach to streamline the creation of standard CRUD endpoints.</p> <ul> <li>Automatic Endpoint Creation Guide</li> </ul>"},{"location":"usage/overview/#2-enhanced-crud-operations-with-fastcrud","title":"2. Enhanced CRUD Operations with FastCRUD","text":"<p>Learn how to use the <code>FastCRUD</code> class for enhanced CRUD operations. This guide delves into the functionalities offered by <code>FastCRUD</code>, including advanced query capabilities, pagination, and error handling.</p> <ul> <li>FastCRUD Usage Guide</li> </ul>"},{"location":"usage/overview/#getting-started","title":"Getting Started","text":"<p>To make the most out of these guides, we recommend familiarizing yourself with FastAPI and SQLAlchemy basics, as our application leverages these frameworks extensively.</p>"},{"location":"usage/overview/#contribution","title":"Contribution","text":"<p>If you have suggestions or contributions to these guides, please refer to our Contributing Guidelines. We appreciate your input in improving our documentation.</p>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"FastCRUD","text":"<p> Powerful CRUD methods and automatic endpoint creation for FastAPI. </p> <p> </p> <p> FastCRUD is a Python package for FastAPI, offering robust async CRUD operations and flexible endpoint creation utilities, streamlined through advanced features like auto-detected join conditions, dynamic sorting, and offset and cursor pagination. </p>"},{"location":"#features","title":"Features","text":"<ul> <li>Fully Async: Leverages Python's async capabilities for non-blocking database operations.</li> <li>SQLAlchemy 2.0: Works with the latest SQLAlchemy version for robust database interactions.</li> <li>SQLModel Support: You can optionally use SQLModel 0.14 or newer instead of SQLAlchemy.</li> <li>Powerful CRUD Functionality: Full suite of efficient CRUD operations with support for joins.</li> <li>Dynamic Query Building: Supports building complex queries dynamically, including filtering, sorting, and pagination.</li> <li>Advanced Join Operations: Facilitates performing SQL joins with other models with automatic join condition detection.</li> <li>Built-in Offset Pagination: Comes with ready-to-use offset pagination.</li> <li>Cursor-based Pagination: Implements efficient pagination for large datasets, ideal for infinite scrolling interfaces.</li> <li>Modular and Extensible: Designed for easy extension and customization to fit your requirements.</li> <li>Auto-generated Endpoints: Streamlines the process of adding CRUD endpoints with custom dependencies and configurations.</li> </ul>"},{"location":"#minimal-example","title":"Minimal Example","text":"<p>Assuming you have your model, schemas and database connection:</p> <pre><code># imports here\n\n# define your model\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\n\n# your schemas\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\n\n# database connection\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> <pre><code>from fastcrud import crud_router\n\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=ItemSchema,\n    update_schema=ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>And it's all done, just go to <code>/docs</code> and the crud endpoints are created.</p>"},{"location":"#requirements","title":"Requirements","text":"<p>Before installing FastCRUD, ensure you have the following prerequisites:</p> <ul> <li>Python: Version 3.9 or newer.</li> <li>FastAPI: FastCRUD is built to work with FastAPI, so having FastAPI in your project is essential.</li> <li>SQLAlchemy or SQLModel: FastCRUD uses SQLAlchemy 2.0 for database operations, so you need SQLAlchemy 2.0 or newer or SQLModel 0.14 or newer.</li> <li>Pydantic V2 or SQLModel: FastCRUD leverages Pydantic models for data validation and serialization, so you need Pydantic 2.0 or newer or SQLModel 0.14 or newer.</li> </ul>"},{"location":"#installing","title":"Installing","text":"<p>To install, just run:</p> <pre><code>pip install fastcrud\n</code></pre> <p>Or, if using poetry:</p> <pre><code>poetry add fastcrud\n</code></pre>"},{"location":"#usage","title":"Usage","text":"<p>FastCRUD offers two primary ways to use its functionalities:</p> <ol> <li>By using <code>crud_router</code> for automatic endpoint creation.</li> <li>By integrating <code>FastCRUD</code> directly into your FastAPI endpoints for more control.</li> </ol> <p>Below are examples demonstrating both approaches:</p>"},{"location":"#using-crud_router-for-automatic-endpoint-creation","title":"Using <code>crud_router</code> for Automatic Endpoint Creation","text":"<p>Here's a quick example to get you started:</p>"},{"location":"#define-your-model-and-schemas","title":"Define Your Model and Schemas","text":"item/model.py<pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> item/schemas.py<pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre>"},{"location":"#set-up-fastapi-and-fastcrud","title":"Set Up FastAPI and FastCRUD","text":"main.py<pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import crud_router\nfrom fastcrud import FastCRUD\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\nfrom .item.model import Base, Item\nfrom .item.schemas import CreateItemSchema, UpdateItemSchema\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\n# CRUD operations setup\nitem_crud = FastCRUD(Item)\n\n# CRUD router setup\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    crud=item_crud,\n    path=\"/items\",\n    tags=[\"Items\"],\n)\n\napp.include_router(item_router)\n</code></pre>"},{"location":"#using-fastcrud-in-user-defined-fastapi-endpoints","title":"Using FastCRUD in User-Defined FastAPI Endpoints","text":"<p>For more control over your endpoints, you can use FastCRUD directly within your custom FastAPI route functions. Here's an example:</p> api/v1/items.py<pre><code>from fastapi import FastAPI, Depends, HTTPException\nfrom sqlalchemy.ext.asyncio import AsyncSession\nfrom fastcrud import FastCRUD\n\nfrom .item.model import Item\nfrom .item.schemas import CreateItemSchema, UpdateItemSchema\n\n# Assume async_session is already set up as per the previous example\n\n# Instantiate FastCRUD with your model\nitem_crud = FastCRUD(Item)\n\n@app.post(\"/custom/items/\")\nasync def create_item(item_data: CreateItemSchema, db: AsyncSession = Depends(get_session)):\n    return await item_crud.create(db, item_data)\n\n@app.get(\"/custom/items/{item_id}\")\nasync def read_item(item_id: int, db: AsyncSession = Depends(get_session)):\n    item = await item_crud.get(db, id=item_id)\n    if not item:\n        raise HTTPException(status_code=404, detail=\"Item not found\")\n    return item\n\n# You can add more routes for update and delete operations in a similar fashion\n</code></pre>"},{"location":"#license","title":"License","text":"<p><code>MIT</code></p>"},{"location":"changelog/","title":"FastCRUD Changelog","text":""},{"location":"changelog/#introduction","title":"Introduction","text":"<p>The Changelog documents all notable changes made to FastCRUD. This includes new features, bug fixes, and improvements. It's organized by version and date, providing a clear history of the library's development.</p>"},{"location":"changelog/#0151-sep-18-2024","title":"[0.15.1] - Sep 18, 2024","text":""},{"location":"changelog/#added","title":"Added","text":"<ul> <li>Support for fastapi &gt;=0.100</li> </ul>"},{"location":"changelog/#whats-changed","title":"What's Changed","text":"<ul> <li>now supporting fastapi &gt;= 0.100.0 by @igorbenav in https://github.com/igorbenav/fastcrud/pull/166</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.15.0...v0.15.1</p>"},{"location":"changelog/#0150-sep-18-2024","title":"[0.15.0] - Sep 18, 2024","text":""},{"location":"changelog/#added_1","title":"Added","text":"<ul> <li>Models and Schemas for Task Management (Batch 3) by @slaarti</li> <li>Models and Schemas for Articles, Authors, and Profiles (Batch 4) by @slaarti</li> <li><code>update_override</code> Argument to <code>upsert_multi</code> Method by @feluelle</li> <li>Configurable <code>is_deleted</code> Field in Soft Delete Logic by @gal-dahan</li> </ul>"},{"location":"changelog/#improved","title":"Improved","text":"<ul> <li>Fixed Complex Parameter Filter with <code>between</code> Operator by @wu-clan</li> <li>Fixed Cryptography Package Vulnerability</li> <li>Resolved Update Column Name Collision in Update Method</li> </ul>"},{"location":"changelog/#fixed","title":"Fixed","text":"<ul> <li>Vulnerability in <code>cryptography</code> Package updated to <code>cryptography = \"^43.0.1\"</code></li> <li>Update Column Name Collision in the <code>update</code> method</li> </ul>"},{"location":"changelog/#documentation-updates","title":"Documentation Updates","text":"<ul> <li>Added Documentation for New Models and Schemas by @slaarti</li> <li>Updated <code>upsert_multi</code> Method Documentation with <code>update_override</code> Usage by @feluelle</li> <li>Clarified Endpoint Simplification and Deprecation Notices</li> </ul>"},{"location":"changelog/#warnings","title":"Warnings","text":"<ul> <li>Deprecation Notice: The <code>_read_paginated</code> endpoint has been removed. Please transition to using <code>_read_items</code> with pagination parameters. Docs here.</li> <li>Deprecation Notice: Handling of <code>Depends</code> is now only callable within <code>_inject_depend</code>. Update your code accordingly.</li> <li>Configuration Change Alert: Endpoints are simplified by default. Adjust your configurations to align with the new defaults. Docs here.</li> </ul>"},{"location":"changelog/#detailed-changes","title":"Detailed Changes","text":""},{"location":"changelog/#endpoint-simplification-and-deprecation-of-_read_paginated","title":"Endpoint Simplification and Deprecation of <code>_read_paginated</code>","text":""},{"location":"changelog/#description","title":"Description","text":"<p>To streamline API endpoint configurations, endpoints with empty strings as names are now the standard. Additionally, the <code>_read_paginated</code> endpoint has been removed, with its functionality merged into <code>_read_items</code>.</p>"},{"location":"changelog/#changes","title":"Changes","text":"<ul> <li>Simplified Endpoint Configuration: Endpoints can now be defined with empty strings to create cleaner paths.</li> <li>Removed <code>_read_paginated</code> Endpoint: Pagination is now handled via optional parameters in <code>_read_items</code>.</li> </ul>"},{"location":"changelog/#usage-examples","title":"Usage Examples","text":"<p>Paginated Read Example:</p> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/items?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre> <p>Non-Paginated Read Example:</p> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/items?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre>"},{"location":"changelog/#warnings_1","title":"Warnings","text":"<p>Warning</p> <p>The <code>_read_paginated</code> endpoint is deprecated. Use <code>_read_items</code> with pagination parameters instead.</p> <p>Warning</p> <p>Default endpoint names are now empty strings. Adjust your configurations to match the new defaults.</p>"},{"location":"changelog/#update_override-argument-in-upsert_multi-method","title":"<code>update_override</code> Argument in <code>upsert_multi</code> Method","text":""},{"location":"changelog/#description_1","title":"Description","text":"<p>The <code>upsert_multi</code> method now includes an <code>update_override</code> argument, giving developers the ability to override the default update logic during upsert operations. This enhancement provides greater flexibility for custom update scenarios, such as utilizing SQL <code>CASE</code> statements or other complex expressions.</p>"},{"location":"changelog/#changes_1","title":"Changes","text":"<ul> <li><code>update_override</code> Argument: Allows custom update logic in <code>upsert_multi</code>.</li> <li>Dialect Support: Implemented for PostgreSQL, SQLite, and MySQL.</li> <li>Tests: Added comprehensive tests to ensure functionality across different SQL dialects.</li> </ul>"},{"location":"changelog/#usage-example","title":"Usage Example","text":"<pre><code>from fastcrud import FastCRUD\nfrom sqlalchemy import case\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\n\nawait crud_items.upsert_multi(\n    db=db,\n    instances=[\n        ItemCreateSchema(id=1, name=\"Item A\", price=10),\n        ItemCreateSchema(id=2, name=\"Item B\", price=20),\n    ],\n    update_override={\n        \"price\": case(\n            (Item.price.is_(None), db.excluded.price),\n            else_=Item.price,\n        )\n    }\n)\n</code></pre>"},{"location":"changelog/#configurable-is_deleted-field-in-soft-delete-logic","title":"Configurable <code>is_deleted</code> Field in Soft Delete Logic","text":""},{"location":"changelog/#description_2","title":"Description","text":"<p>The <code>is_deleted</code> field in the soft delete logic is now optional and configurable. This change allows developers to customize the soft delete behavior per model, providing flexibility in how deletion states are handled.</p>"},{"location":"changelog/#new-contributors","title":"New Contributors","text":"<ul> <li>@wu-clan made their first contribution \ud83c\udf1f</li> <li>@gal-dahan made their first contribution \ud83c\udf1f</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0140-jul-29-2024","title":"[0.14.0] - Jul 29, 2024","text":""},{"location":"changelog/#added_2","title":"Added","text":"<ul> <li>Type-checking support for SQLModel types by @kdcokenny \ud83d\ude80</li> <li>Returning clause to update operations by @feluelle</li> <li>Upsert_multi functionality by @feluelle</li> <li>Simplified endpoint configurations by @JakNowy, streamlining path generation and merging pagination functionalities into a unified <code>_read_items</code> endpoint, promoting more efficient API structure and usage. Details in https://github.com/igorbenav/fastcrud/pull/105</li> </ul>"},{"location":"changelog/#improved_1","title":"Improved","text":"<ul> <li>Comprehensive tests for paginated retrieval of items, maintaining 100% coverage</li> <li>Docker client check before running tests that require Docker by @feluelle</li> </ul>"},{"location":"changelog/#fixed_1","title":"Fixed","text":"<ul> <li>Vulnerability associated with an outdated cryptography package</li> <li>Return type inconsistency in async session fixtures by @slaarti</li> </ul>"},{"location":"changelog/#documentation-updates_1","title":"Documentation Updates","text":"<ul> <li>Cleanup of documentation formatting by @slaarti</li> <li>Replacement of the Contributing section in docs with an include to file in repo root by @slaarti</li> <li>Correction of links to advanced filters in docstrings by @slaarti</li> <li>Backfill of docstring fixes across various modules by @slaarti</li> <li>Enhanced filter documentation with new AND and OR clause examples, making complex queries more accessible and understandable.</li> </ul>"},{"location":"changelog/#models-and-schemas-enhancements","title":"Models and Schemas Enhancements","text":"<ul> <li>Introduction of simple and one-off models (Batch 1) by @slaarti</li> <li>Expansion to include models and schemas for Customers, Products, and Orders (Batch 2) by @slaarti</li> </ul>"},{"location":"changelog/#code-refinements","title":"Code Refinements","text":"<ul> <li>Resolution of missing type specifications in kwargs by @slaarti</li> <li>Collapsed space adjustments for models/schemas in <code>fast_crud.py</code> by @slaarti</li> </ul>"},{"location":"changelog/#warnings_2","title":"Warnings","text":"<ul> <li>Deprecation Notice: <code>_read_paginated</code> endpoint is set to be deprecated and merged into <code>_read_items</code>. Users are encouraged to transition to the latter, utilizing optional pagination parameters. Full details and usage instructions provided to ensure a smooth transition.</li> <li>Future Changes Alert: Default endpoint names in <code>EndpointCreator</code> are anticipated to be set to empty strings in a forthcoming major release, aligning with simplification efforts. Refer to https://github.com/igorbenav/fastcrud/issues/67 for more information.</li> </ul>"},{"location":"changelog/#detailed-changes_1","title":"Detailed Changes","text":""},{"location":"changelog/#simplified-endpoint-configurations","title":"Simplified Endpoint Configurations","text":"<p>In an effort to streamline FastCRUD\u2019s API, we have reconfigured endpoint paths to avoid redundancy (great work by @JakNowy). This change allows developers to specify empty strings for endpoint names in the <code>crud_router</code> setup, which prevents the generation of unnecessary <code>//</code> in the paths. The following configurations illustrate how endpoints can now be defined more succinctly:</p> <pre><code>endpoint_names = {\n    \"create\": \"\",\n    \"read\": \"\",\n    \"update\": \"\",\n    \"delete\": \"\",\n    \"db_delete\": \"\",\n    \"read_multi\": \"\",\n    \"read_paginated\": \"get_paginated\",\n}\n</code></pre> <p>Moreover, the <code>_read_paginated</code> logic has been integrated into the <code>_read_items</code> endpoint. This integration means that pagination can now be controlled via <code>page</code> and <code>items_per_page</code> query parameters, offering a unified method for both paginated and non-paginated reads:</p> <ul> <li>Paginated read example:</li> </ul> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/users/get_multi?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre> <ul> <li>Non-paginated read example:</li> </ul> <pre><code>curl -X 'GET' \\\n  'http://localhost:8000/users/get_multi?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre>"},{"location":"changelog/#warnings_3","title":"Warnings","text":"<ul> <li>Deprecation Warning: The <code>_read_paginated</code> endpoint is slated for deprecation. Developers should transition to using <code>_read_items</code> with the relevant pagination parameters.</li> <li>Configuration Change Alert: In a future major release, default endpoint names in <code>EndpointCreator</code> will be empty strings by default, as discussed in Issue #67.</li> </ul>"},{"location":"changelog/#advanced-filters-documentation-update","title":"Advanced Filters Documentation Update","text":"<p>Documentation for advanced filters has been expanded to include comprehensive examples of AND and OR clauses, enhancing the utility and accessibility of complex query constructions.</p> <ul> <li>OR clause example:</li> </ul> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre> <ul> <li>AND clause example:</li> </ul> <pre><code># Fetch items priced under $20 and over 2 years of warranty\nitems = await item_crud.get_multi(\n    db=db,\n    price__lt=20,\n    warranty_years__gt=2,\n)\n</code></pre>"},{"location":"changelog/#returning-clauses-in-update-operations","title":"Returning Clauses in Update Operations","text":""},{"location":"changelog/#description_3","title":"Description","text":"<p>Users can now retrieve updated records immediately following an update operation. This feature streamlines the process, reducing the need for subsequent retrieval calls and increasing efficiency.</p>"},{"location":"changelog/#changes_2","title":"Changes","text":"<ul> <li>Return Columns: Specify the columns to be returned after the update via the <code>return_columns</code> argument.</li> <li>Schema Selection: Optionally select a Pydantic schema to format the returned data using the <code>schema_to_select</code> argument.</li> <li>Return as Model: Decide if the returned data should be converted into a model using the <code>return_as_model</code> argument.</li> <li>Single or None: Utilize the <code>one_or_none</code> argument to ensure that either a single record is returned or none, in case the conditions do not match any records.</li> </ul> <p>These additions are aligned with existing CRUD API functions, enhancing consistency across the library and making the new features intuitive for users.</p>"},{"location":"changelog/#usage-example_1","title":"Usage Example","text":""},{"location":"changelog/#returning-updated-fields","title":"Returning Updated Fields","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nupdated_item = await crud_items.update(\n    db=db,\n    object={\"price\": 9.99},\n    price__lt=10,\n    return_columns=[\"price\"]\n)\n# This returns the updated price of the item directly.\n</code></pre>"},{"location":"changelog/#returning-data-as-a-model","title":"Returning Data as a Model","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .schemas.item import ItemSchema\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nupdated_item_schema = await crud_items.update(\n    db=db,\n    object={\"price\": 9.99},\n    price__lt=10,\n    schema_to_select=ItemSchema,\n    return_as_model=True\n)\n# This returns the updated item data formatted as an ItemSchema model.\n</code></pre>"},{"location":"changelog/#bulk-upsert-operations-with-upsert_multi","title":"Bulk Upsert Operations with <code>upsert_multi</code>","text":"<p>The <code>upsert_multi</code> method provides the ability to perform bulk upsert operations, which are optimized for different SQL dialects.</p>"},{"location":"changelog/#changes_3","title":"Changes","text":"<ul> <li>Dialect-Optimized SQL: Uses the most efficient SQL commands based on the database's SQL dialect.</li> <li>Support for Multiple Dialects: Includes custom implementations for PostgreSQL, SQLite, and MySQL, with appropriate handling for each's capabilities and limitations.</li> </ul>"},{"location":"changelog/#usage-example_2","title":"Usage Example","text":""},{"location":"changelog/#upserting-multiple-records","title":"Upserting Multiple Records","text":"<pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .schemas.item import ItemCreateSchema, ItemSchema\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nitems = await crud_items.upsert_multi(\n    db=db,\n    instances=[\n        ItemCreateSchema(price=9.99),\n    ],\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n# This will return the upserted data in the form of ItemSchema.\n</code></pre>"},{"location":"changelog/#implementation-details","title":"Implementation Details","text":"<p><code>upsert_multi</code> handles different database dialects: - PostgreSQL: Uses <code>ON CONFLICT DO UPDATE</code>. - SQLite: Utilizes <code>ON CONFLICT DO UPDATE</code>. - MySQL: Implements <code>ON DUPLICATE KEY UPDATE</code>.</p>"},{"location":"changelog/#notes","title":"Notes","text":"<ul> <li>MySQL and MariaDB do not support certain advanced features used in other dialects, such as returning values directly after an insert or update operation. This limitation is clearly documented to prevent misuse.</li> </ul>"},{"location":"changelog/#new-contributors_1","title":"New Contributors","text":"<ul> <li>@kdcokenny made their first contribution \ud83c\udf1f</li> <li>@feluelle made their first contribution \ud83c\udf1f</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0131-jun-22-2024","title":"[0.13.1] - Jun 22, 2024","text":""},{"location":"changelog/#added_3","title":"Added","text":"<ul> <li>More Advanced Filters by @JakNowy \ud83c\udf89</li> </ul>"},{"location":"changelog/#fixed_2","title":"Fixed","text":"<ul> <li>Bug where objects with null primary key are returned with all fields set to None in nested joins #102 </li> </ul>"},{"location":"changelog/#detailed-changes_2","title":"Detailed Changes","text":""},{"location":"changelog/#advanced-filters","title":"Advanced Filters","text":"<p>FastCRUD supports advanced filtering options, allowing you to query records using operators such as greater than (<code>__gt</code>), less than (<code>__lt</code>), and their inclusive counterparts (<code>__gte</code>, <code>__lte</code>). These filters can be used in any method that retrieves or operates on records, including <code>get</code>, <code>get_multi</code>, <code>exists</code>, <code>count</code>, <code>update</code>, and <code>delete</code>.</p>"},{"location":"changelog/#single-parameter-filters","title":"Single parameter filters","text":"<p>Most filter operators require a single string or integer value.</p> <pre><code># Fetch items priced above $5\nitems = await item_crud.get_multi(\n    db=db,\n    price__gte=5,\n)\n</code></pre> <p>Currently supported single parameter filters are: - __gt - greater than - __lt - less than - __gte - greater than or equal to - __lte - less than or equal to - __ne - not equal - __is - used to test True, False, and None identity - __is_not - negation of \"is\" - __like - SQL \"like\" search for specific text pattern - __notlike - negation of \"like\" - __ilike - case insensitive \"like\" - __notilike - case insensitive \"notlike\" - __startswith - text starts with given string - __endswith - text ends with given string - __contains - text contains given string - __match - database-specific match expression</p>"},{"location":"changelog/#complex-parameter-filters","title":"Complex parameter filters","text":"<p>Some operators require multiple values. They must be passed as a python tuple, list, or set.</p> <p><pre><code># Fetch items priced between $5 and $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__between=(5, 20),\n)\n</code></pre> - __between - between 2 numeric values - __in - included in - __not_in - not included in</p>"},{"location":"changelog/#or-parameter-filters","title":"OR parameter filters","text":"<p>More complex OR filters are supported. They must be passed as a dictionary, where each key is a library-supported operator to be used in OR expression and values are what get's passed as the parameter.</p> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre>"},{"location":"changelog/#whats-changed_1","title":"What's Changed","text":"<ul> <li>Missing sqlalchemy operators by @JakNowy in https://github.com/igorbenav/fastcrud/pull/85</li> <li>Null primary key bug fixed in https://github.com/igorbenav/fastcrud/pull/107</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.13.0...v0.13.1</p>"},{"location":"changelog/#0130-may-28-2024","title":"[0.13.0] - May 28, 2024","text":""},{"location":"changelog/#added_4","title":"Added","text":"<ul> <li>Filters in Automatic Endpoints \ud83c\udf89</li> <li>One-to-many support in joins</li> <li>Upsert method in FastCRUD class by @dubusster </li> </ul>"},{"location":"changelog/#detailed-changes_3","title":"Detailed Changes","text":""},{"location":"changelog/#using-filters-in-fastcrud","title":"Using Filters in FastCRUD","text":"<p>FastCRUD provides filtering capabilities, allowing you to filter query results based on various conditions. Filters can be applied to <code>read_multi</code> and <code>read_paginated</code> endpoints. This section explains how to configure and use filters in FastCRUD.</p>"},{"location":"changelog/#defining-filters","title":"Defining Filters","text":"<p>Filters are either defined using the <code>FilterConfig</code> class or just passed as a dictionary. This class allows you to specify default filter values and validate filter types. Here's an example of how to define filters for a model:</p> <pre><code>from fastcrud import FilterConfig\n\n# Define filter configuration for a model\nfilter_config = FilterConfig(\n    tier_id=None,  # Default filter value for tier_id\n    name=None  # Default filter value for name\n)\n</code></pre> <p>And the same thing using a <code>dict</code>: <pre><code>filter_config = {\n    \"tier_id\": None,  # Default filter value for tier_id\n    \"name\": None,  # Default filter value for name\n}\n</code></pre></p> <p>By using <code>FilterConfig</code> you get better error messages.</p>"},{"location":"changelog/#applying-filters-to-endpoints","title":"Applying Filters to Endpoints","text":"<p>You can apply filters to your endpoints by passing the <code>filter_config</code> to the <code>crud_router</code> or <code>EndpointCreator</code>. Here's an example:</p> <pre><code>from fastcrud import crud_router\nfrom yourapp.models import YourModel\nfrom yourapp.schemas import CreateYourModelSchema, UpdateYourModelSchema\nfrom yourapp.database import async_session\n\n# Apply filters using crud_router\napp.include_router(\n    crud_router(\n        session=async_session,\n        model=YourModel,\n        create_schema=CreateYourModelSchema,\n        update_schema=UpdateYourModelSchema,\n        filter_config=filter_config,  # Apply the filter configuration\n        path=\"/yourmodel\",\n        tags=[\"YourModel\"]\n    )\n)\n</code></pre>"},{"location":"changelog/#using-filters-in-requests","title":"Using Filters in Requests","text":"<p>Once filters are configured, you can use them in your API requests. Filters are passed as query parameters. Here's an example of how to use filters in a request to a paginated endpoint:</p> <pre><code>GET /yourmodel/get_paginated?page=1&amp;itemsPerPage=3&amp;tier_id=1&amp;name=Alice\n</code></pre>"},{"location":"changelog/#custom-filter-validation","title":"Custom Filter Validation","text":"<p>The <code>FilterConfig</code> class includes a validator to check filter types. If an invalid filter type is provided, a <code>ValueError</code> is raised. You can customize the validation logic by extending the <code>FilterConfig</code> class:</p> <pre><code>from fastcrud import FilterConfig\nfrom pydantic import ValidationError\n\nclass CustomFilterConfig(FilterConfig):\n    @field_validator(\"filters\")\n    def check_filter_types(cls, filters: dict[str, Any]) -&gt; dict[str, Any]:\n        for key, value in filters.items():\n            if not isinstance(value, (type(None), str, int, float, bool)):\n                raise ValueError(f\"Invalid default value for '{key}': {value}\")\n        return filters\n\ntry:\n    # Example of invalid filter configuration\n    invalid_filter_config = CustomFilterConfig(invalid_field=[])\nexcept ValidationError as e:\n    print(e)\n</code></pre>"},{"location":"changelog/#handling-invalid-filter-columns","title":"Handling Invalid Filter Columns","text":"<p>FastCRUD ensures that filters are applied only to valid columns in your model. If an invalid filter column is specified, a <code>ValueError</code> is raised:</p> <pre><code>try:\n    # Example of invalid filter column\n    invalid_filter_config = FilterConfig(non_existent_column=None)\nexcept ValueError as e:\n    print(e)  # Output: Invalid filter column 'non_existent_column': not found in model\n</code></pre>"},{"location":"changelog/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>one-to-one</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"changelog/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul> <p>Example</p> <p>Let's define two tables:</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <p>Fetch a user and their tier:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre> <p>One-to-One Relationship with Nested Joins</p> <p>To get the joined data in a nested dictionary:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    nest_joins=True,\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre>"},{"location":"changelog/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>Warning</p> <p>When using <code>nest_joins=True</code>, the performance will always be a bit worse than when using <code>nest_joins=False</code>. For cases where more performance is necessary, consider using <code>nest_joins=False</code> and remodeling your database.</p> <p>Example</p> <p>To demonstrate a one-to-many relationship, let's assume <code>User</code> and <code>Post</code> tables:</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n\nclass Post(Base):\n    __tablename__ = \"post\"\n    id = Column(Integer, primary key=True)\n    user_id = Column(Integer, ForeignKey(\"user.id\"))\n    content = Column(String)\n</code></pre> <p>Fetch a user and all their posts:</p> <pre><code>user_posts = await user_crud.get_joined(\n    db=db,\n    join_model=Post,\n    join_on=User.id == Post.user_id,\n    join_type=\"left\",\n    join_prefix=\"post_\",\n    nest_joins=True,\n    id=1\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example User\",\n    \"posts\": [\n        {\n            \"id\": 101,\n            \"user_id\": 1,\n            \"content\": \"First post content\"\n        },\n        {\n            \"id\": 102,\n            \"user_id\": 1,\n            \"content\": \"Second post content\"\n        }\n    ]\n}\n</code></pre>"},{"location":"changelog/#whats-changed_2","title":"What's Changed","text":"<ul> <li>feat: \u2728 add upsert method in FastCRUD class by @dubusster</li> <li>Filters in Automatic Endpoints</li> <li>One-to-many support in joins</li> <li>tests fixed by @igorbenav</li> <li>Using the same session for all tests</li> <li>warning added to docs</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.12.1...v0.13.0</p>"},{"location":"changelog/#0121-may-10-2024","title":"[0.12.1] - May 10, 2024","text":""},{"location":"changelog/#added_5","title":"Added","text":"<ul> <li>Deprecation Warning for dependency handling.</li> </ul>"},{"location":"changelog/#detailed-changes_4","title":"Detailed Changes","text":"<p>If you pass a sequence of <code>params.Depends</code> type variables to any <code>*_deps</code> parameter in <code>EndpointCreator</code> and <code>crud_router</code>, you'll get a warning. Support will be completely removed in 0.15.0.</p> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.12.0...v0.12.1</p>"},{"location":"changelog/#0120-may-8-2024","title":"[0.12.0] - May 8, 2024","text":""},{"location":"changelog/#added_6","title":"Added","text":"<ul> <li>Unpaginated versions of multi-row get methods by @slaarti in #62  \ud83c\udf89</li> <li>Nested Join bug fixes</li> <li>Dependency handling now working as docs say</li> <li>Option to Skip commit in some fastcrud methods</li> <li>Docstring example fixes</li> <li><code>__in</code> and <code>__not_in</code> filters by @JakNowy \ud83c\udf89</li> <li>Fastapi 0.111.0 support</li> </ul>"},{"location":"changelog/#detailed-changes_5","title":"Detailed Changes","text":""},{"location":"changelog/#unpaginated-versions-of-multi-row-get-methods","title":"Unpaginated versions of multi-row get methods","text":"<p>Now, if you pass <code>None</code> to <code>limit</code> in <code>get_multi</code> and <code>get_multi_joined</code>, you get the whole unpaginated set of data that matches the filters. Use this with caution.</p> <pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\nitems = await crud_items.get_multi(db=db, limit=None)\n# this will return all items in the db\n</code></pre>"},{"location":"changelog/#dependency-handling-now-working-as-docs-say","title":"Dependency handling now working as docs say","text":"<p>Now, you may pass dependencies to <code>crud_router</code> or <code>EndpointCreator</code> as simple functions instead of needing to wrap them in <code>fastapi.Depends</code>.</p> <pre><code>from .dependencies import get_superuser\napp.include_router(\n    crud_router(\n        session=db,\n        model=Item,\n        create_schema=ItemCreate,\n        update_schema=ItemUpdate,\n        delete_schema=ItemDelete,\n        create_deps=[get_superuser],\n        update_deps=[get_superuser],\n        delete_deps=[get_superuser],\n        path=\"/item\",\n        tags=[\"item\"],\n    )\n)\n</code></pre>"},{"location":"changelog/#option-to-skip-commit-in-some-fastcrud-methods","title":"Option to Skip commit in some fastcrud methods","text":"<p>For <code>create</code>, <code>update</code>, <code>db_delete</code> and <code>delete</code> methods of <code>FastCRUD</code>, now you have the option of passing <code>commit=False</code> so you don't commit the operations immediately.</p> <pre><code>from fastcrud import FastCRUD\nfrom .models.item import Item\nfrom .database import session as db\n\ncrud_items = FastCRUD(Item)\n\nawait crud_items.delete(\n    db=db, \n    commit=False, \n    id=1\n)\n# this will not actually delete until you run a db.commit()\n</code></pre>"},{"location":"changelog/#__in-and-__not_in-filters","title":"<code>__in</code> and <code>__not_in</code> filters","text":"<p>You may now pass <code>__in</code> and <code>__not_in</code> to methods that accept advanced queries:</p> <ul> <li><code>__gt</code>: greater than,</li> <li><code>__lt</code>: less than,</li> <li><code>__gte</code>: greater than or equal to,</li> <li><code>__lte</code>: less than or equal to,</li> <li><code>__ne</code>: not equal,</li> <li><code>__in</code>: included in [tuple, list or set],</li> <li><code>__not_in</code>: not included in [tuple, list or set].</li> </ul>"},{"location":"changelog/#whats-changed_3","title":"What's Changed","text":"<ul> <li>Add unpaginated versions of multi-row get methods (w/tests) by @slaarti \ud83c\udf89</li> <li>Join fixes</li> <li>Dependencies</li> <li>Skip commit</li> <li>Docstring fix</li> <li>feat: filter __in by @JakNowy \ud83c\udf89</li> <li>python support for 0.111.0 added</li> <li>version bump in pyproject.toml for 0.12.0</li> </ul>"},{"location":"changelog/#new-contributors_2","title":"New Contributors","text":"<ul> <li>@slaarti made their first contribution in https://github.com/igorbenav/fastcrud/pull/62 \ud83c\udf89</li> </ul> <p>Full Changelog: https://github.com/igorbenav/fastcrud/compare/v0.11.1...v0.12.0</p>"},{"location":"changelog/#0111-apr-22-2024","title":"[0.11.1] - Apr 22, 2024","text":""},{"location":"changelog/#added_7","title":"Added","text":"<ul> <li><code>one_or_none</code> parameter to FastCRUD <code>get</code> method (default <code>False</code>)</li> <li><code>nest_joins</code> parameter to FastCRUD <code>get_joined</code> and <code>get_multi_joined</code> (default <code>False</code>)</li> </ul>"},{"location":"changelog/#detailed-changes_6","title":"Detailed Changes","text":""},{"location":"changelog/#get","title":"<code>get</code>","text":"<p>By default, the <code>get</code> method in <code>FastCRUD</code> returns the <code>first</code> object matching all the filters it finds.</p> <p>If you want to ensure the <code>one_or_none</code> behavior, you may pass the parameter as <code>True</code>:</p> <pre><code>crud.get(\n    async_session, \n    one_or_none=True, \n    category_id=1\n)\n</code></pre>"},{"location":"changelog/#get_joined-and-get_multi_joined","title":"<code>get_joined</code> and <code>get_multi_joined</code>","text":"<p>By default, <code>FastCRUD</code> joins all the data and returns it in a single dictionary. Let's define two tables: <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre></p> <p>And join them with <code>FastCRUD</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",,\n    id=1\n)\n</code></pre> <p>We'll get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\",\n}\n</code></pre> <p>Now, if you want the joined data in a nested dictionary instead, you may just pass <code>nest_joins=True</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_type=\"left\",\n    join_prefix=\"tier_\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>And you will get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\",\n    },\n}\n</code></pre> <p>This works for both <code>get_joined</code> and <code>get_multi_joined</code>.</p> <p>Warning</p> <p>Note that the final <code>\"_\"</code> in the passed <code>\"tier_\"</code> is stripped.</p>"},{"location":"changelog/#whats-changed_4","title":"What's Changed","text":"<ul> <li>Reuse of <code>select</code> method in <code>FastCRUD</code></li> <li>Skip count call when possible</li> <li>Add <code>one_or_none</code> parameter to FastCRUD <code>get</code> method</li> <li>Add <code>nest_joins</code> parameter to FastCRUD <code>get_joined</code> and <code>get_multi_joined</code></li> </ul>"},{"location":"changelog/#new-contributors_3","title":"New Contributors","text":"<ul> <li>@JakNowy made their first contribution in PR #51.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0110-apr-7-2024","title":"[0.11.0] - Apr 7, 2024","text":""},{"location":"changelog/#added_8","title":"Added","text":"<ul> <li>Multiple primary keys support, a significant enhancement by @dubusster in #31 \ud83c\udf89.</li> <li>Option to disable the count in <code>get_multi</code> and <code>get_multi_joined</code> methods for performance optimization.</li> <li>Fixes for a validation bug when <code>return_as_model</code> is set to <code>True</code>.</li> <li>Resolution of a bug concerning incorrect handling of <code>db_row</code> in methods.</li> <li>Correction of the <code>valid_methods</code> bug, which previously raised the wrong error type.</li> <li>Upgrade of <code>FastAPI</code> dependency to version <code>0.111.0</code>, ensuring compatibility with the latest FastAPI features.</li> <li>Achievement of 100% test coverage, with the addition of a workflow and badge to showcase this milestone.</li> <li>Inclusion of the changelog within the project documentation, providing a comprehensive history of changes directly to users.</li> </ul>"},{"location":"changelog/#detailed-changes_7","title":"Detailed Changes","text":""},{"location":"changelog/#multiple-primary-keys-support","title":"Multiple Primary Keys Support","text":"<p>FastCRUD now accommodates models with multiple primary keys, facilitating more complex database designs. For models defined with more than one primary key, the endpoint creator automatically generates paths reflecting the primary keys' order. This feature extends support to primary keys named differently than <code>id</code>, enhancing the flexibility of FastCRUD's routing capabilities.</p>"},{"location":"changelog/#example","title":"Example:","text":"<p>For a model with multiple primary keys, FastCRUD generates specific endpoints such as <code>/multi_pk/get/{id}/{uuid}</code>, accommodating the unique identification needs of complex data models.</p>"},{"location":"changelog/#optional-count","title":"Optional Count","text":"<p>The <code>get_multi</code> and <code>get_multi_joined</code> methods now feature an <code>return_total_count=False</code> parameter, allowing users to opt-out of receiving the total count in responses. This option can enhance performance by skipping potentially expensive count operations.</p>"},{"location":"changelog/#behavior","title":"Behavior:","text":"<ul> <li>By default, <code>return_total_count=True</code> is assumed, returning both data and a total count.</li> <li>When set to <code>False</code>, responses contain only the data array, omitting the total count for efficiency.</li> </ul>"},{"location":"changelog/#whats-changed_5","title":"What's Changed","text":"<ul> <li>Implementation of multiple primary keys support, addressing a significant flexibility requirement for advanced use cases.</li> <li>Introduction of optional count retrieval in multi-get methods, optimizing performance by eliminating unnecessary database queries.</li> <li>Several critical bug fixes, improving the stability and reliability of FastCRUD.</li> <li>Documentation enhancements, including the addition of a changelog section, ensuring users have access to detailed release information.</li> <li>Update to FastAPI <code>0.111.0</code>, ensuring compatibility with the latest enhancements in the FastAPI ecosystem.</li> <li>Achievement of 100% test coverage, marking a significant milestone in the project's commitment to reliability and quality assurance.</li> </ul>"},{"location":"changelog/#relevant-contributors","title":"Relevant Contributors","text":"<ul> <li>@dubusster made a notable contribution with the implementation of multiple primary keys support in PR #31.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#0100-mar-30-2024","title":"[0.10.0] - Mar 30, 2024","text":""},{"location":"changelog/#added_9","title":"Added","text":"<ul> <li><code>select</code> statement functionality, thanks to @dubusster's contribution in PR #28 \ud83d\ude80.</li> <li>Support for joined models in the <code>count</code> method through the <code>joins_config</code> parameter.</li> <li>Filters for joined models via the <code>filters</code> parameter in <code>JoinConfig</code>.</li> <li>Type checking workflow integrated with <code>mypy</code> alongside fixes for typing issues.</li> <li>Linting workflow established with <code>ruff</code>.</li> </ul>"},{"location":"changelog/#detailed-changes_8","title":"Detailed Changes","text":""},{"location":"changelog/#select","title":"Select","text":"<p>The <code>select</code> method constructs a SQL Alchemy <code>Select</code> statement, offering flexibility in column selection, filtering, and sorting. It is designed to chain additional SQLAlchemy methods for complex queries. Docs here and here.</p>"},{"location":"changelog/#features","title":"Features:","text":"<ul> <li>Column Selection: Choose columns via a Pydantic schema.</li> <li>Sorting: Define columns and their order for sorting.</li> <li>Filtering: Directly apply filters through keyword arguments.</li> <li>Chaining: Allow for chaining with other SQLAlchemy methods for advanced query construction.</li> </ul>"},{"location":"changelog/#improved-joins","title":"Improved Joins","text":"<p><code>JoinConfig</code> enhances FastCRUD queries by detailing join operations between models, offering configurations like model joining, conditions, prefixes, column selection through schemas, join types, aliases, and direct filtering. Docs here.</p>"},{"location":"changelog/#applying-joins-in-fastcrud-methods","title":"Applying Joins in FastCRUD Methods","text":"<p>Detailed explanations and examples are provided for using joins in <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code> methods to achieve complex data retrieval, including handling of many-to-many relationships.</p>"},{"location":"changelog/#whats-changed_6","title":"What's Changed","text":"<ul> <li>New <code>select</code> statement functionality added.</li> <li>Documentation and method improvements for select and joins.</li> <li>Integration of type checking and linting workflows.</li> <li>Version bump in pyproject.toml.</li> </ul>"},{"location":"changelog/#new-contributors_4","title":"New Contributors","text":"<ul> <li>@dubusster made their first contribution in PR #28.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#091-mar-19-2024","title":"[0.9.1] - Mar 19, 2024","text":""},{"location":"changelog/#added_10","title":"Added","text":"<ul> <li>Enhanced <code>get_joined</code> and <code>get_multi_joined</code> methods to support aliases, enabling multiple joins on the same model. This improvement addresses issue #27.</li> </ul>"},{"location":"changelog/#detailed-changes_9","title":"Detailed Changes","text":""},{"location":"changelog/#alias-support-for-complex-joins","title":"Alias Support for Complex Joins","text":"<p>With the introduction of alias support, <code>get_joined</code> and <code>get_multi_joined</code> methods now allow for more complex queries, particularly beneficial in scenarios requiring self-joins or multiple joins on the same table. Aliases help to avoid conflicts and ambiguity by providing unique identifiers for the same model in different join contexts. Docs here.</p>"},{"location":"changelog/#example-multiple-joins-with-aliases","title":"Example: Multiple Joins with Aliases","text":"<p>To demonstrate the use of aliases, consider a task management system where tasks are associated with both an owner and an assigned user from the same <code>UserModel</code>. Aliases enable joining the <code>UserModel</code> twice under different contexts - as an owner and an assigned user. This example showcases how to set up aliases using the <code>aliased</code> function and incorporate them into your <code>JoinConfig</code> for clear and conflict-free query construction. Docs here.</p>"},{"location":"changelog/#whats-changed_7","title":"What's Changed","text":"<ul> <li>Introduction of aliases in joins, improving query flexibility and expressiveness, as detailed by @igorbenav in PR #29.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#090-mar-14-2024","title":"[0.9.0] - Mar 14, 2024","text":""},{"location":"changelog/#added_11","title":"Added","text":"<ul> <li>Enhanced <code>get_joined</code> and <code>get_multi_joined</code> methods now support handling joins with multiple models.</li> </ul>"},{"location":"changelog/#detailed-changes_10","title":"Detailed Changes","text":""},{"location":"changelog/#multi-model-join-capabilities","title":"Multi-Model Join Capabilities","text":"<p>The <code>get_joined</code> and <code>get_multi_joined</code> methods have been upgraded to accommodate joins involving multiple models. This functionality is facilitated through the <code>joins_config</code> parameter, allowing for the specification of multiple <code>JoinConfig</code> instances. Each instance represents a unique join configuration, broadening the scope for complex data relationship management within FastCRUD. Docs here.</p>"},{"location":"changelog/#example-multi-model-join","title":"Example: Multi-Model Join","text":"<p>A practical example involves retrieving users alongside their corresponding tier and department details. By configuring <code>joins_config</code> with appropriate <code>JoinConfig</code> instances for the <code>Tier</code> and <code>Department</code> models, users can efficiently gather comprehensive data across related models, enhancing data retrieval operations' depth and flexibility.</p> <p>Warning</p> <p>An error will occur if both single join parameters and <code>joins_config</code> are used simultaneously. It's crucial to ensure that your join configurations are correctly set to avoid conflicts.</p>"},{"location":"changelog/#whats-changed_8","title":"What's Changed","text":"<ul> <li>Introduction of multi-model join support in <code>get_joined</code> and <code>get_multi_joined</code>, enabling more complex and detailed data retrieval strategies.</li> <li>Several minor updates and fixes, including package import corrections and <code>pyproject.toml</code> updates, to improve the library's usability and stability.</li> </ul>"},{"location":"changelog/#new-contributors_5","title":"New Contributors","text":"<ul> <li>@iridescentGray</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#080-mar-4-2024","title":"[0.8.0] - Mar 4, 2024","text":""},{"location":"changelog/#added_12","title":"Added","text":"<ul> <li>Feature to customize names of auto-generated endpoints using the <code>endpoint_names</code> parameter, applicable in both <code>crud_router</code> function and <code>EndpointCreator</code>.</li> </ul>"},{"location":"changelog/#detailed-changes_11","title":"Detailed Changes","text":""},{"location":"changelog/#custom-endpoint-naming","title":"Custom Endpoint Naming","text":"<p>The introduction of the <code>endpoint_names</code> parameter offers flexibility in defining endpoint names for CRUD operations. This enhancement caters to the need for more descriptive or project-specific naming conventions, enabling developers to align the API's interface with their domain language or organizational standards. </p>"},{"location":"changelog/#example-customizing-endpoint-names-with-crud_router","title":"Example: Customizing Endpoint Names with <code>crud_router</code>","text":"<p>Customizing endpoint names is straightforward with the <code>crud_router</code> function. By providing a dictionary mapping CRUD operation names to desired endpoint names, developers can easily tailor their API's paths to fit their application's unique requirements.</p>"},{"location":"changelog/#example-customizing-endpoint-names-with-endpointcreator","title":"Example: Customizing Endpoint Names with <code>EndpointCreator</code>","text":"<p>Similarly, when using the <code>EndpointCreator</code>, the <code>endpoint_names</code> parameter allows for the same level of customization, ensuring consistency across different parts of the application or service.</p> <p>Tip</p> <p>It's not necessary to specify all endpoint names; only those you wish to change need to be included in the <code>endpoint_names</code> dictionary. This flexibility ensures minimal configuration effort for maximum impact.</p>"},{"location":"changelog/#whats-changed_9","title":"What's Changed","text":"<ul> <li>Enhanced endpoint customization capabilities through <code>endpoint_names</code> parameter, supporting a more tailored and intuitive API design.</li> <li>Documentation updates to guide users through the process of customizing endpoint names.</li> </ul>"},{"location":"changelog/#070-feb-20-2024","title":"[0.7.0] - Feb 20, 2024","text":""},{"location":"changelog/#added_13","title":"Added","text":"<ul> <li>The <code>get_paginated</code> endpoint for retrieving items with pagination support.</li> <li>The <code>paginated</code> module to offer utility functions for pagination.</li> </ul>"},{"location":"changelog/#detailed-changes_12","title":"Detailed Changes","text":""},{"location":"changelog/#get_paginated-endpoint","title":"<code>get_paginated</code> Endpoint","text":"<p>This new endpoint enhances data retrieval capabilities by introducing pagination, an essential feature for handling large datasets efficiently. It supports customizable query parameters for page number and items per page, facilitating flexible data access patterns. Docs here.</p>"},{"location":"changelog/#features_1","title":"Features:","text":"<ul> <li>Endpoint and Method: A <code>GET</code> request to <code>/get_paginated</code>.</li> <li>Query Parameters: Includes <code>page</code> for the page number and <code>itemsPerPage</code> for controlling the number of items per page.</li> <li>Example Usage: Demonstrated with a request for retrieving items with specified pagination settings.</li> </ul>"},{"location":"changelog/#paginated-module","title":"<code>paginated</code> Module","text":"<p>The introduction of the <code>paginated</code> module brings two key utility functions, <code>paginated_response</code> and <code>compute_offset</code>, which streamline the implementation of paginated responses in the application.</p>"},{"location":"changelog/#functions","title":"Functions:","text":"<ul> <li>paginated_response: Constructs a paginated response based on the input data, page number, and items per page.</li> <li>compute_offset: Calculates the offset for database queries, based on the current page number and the number of items per page.</li> </ul>"},{"location":"changelog/#whats-changed_10","title":"What's Changed","text":"<ul> <li>Deployment of pagination functionality, embodied in the <code>get_paginated</code> endpoint and the <code>paginated</code> module, to facilitate efficient data handling and retrieval.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#060-feb-11-2024","title":"[0.6.0] - Feb 11, 2024","text":""},{"location":"changelog/#added_14","title":"Added","text":"<ul> <li>The ability to use a custom <code>updated_at</code> column name in models.</li> <li>Making the passing of the <code>crud</code> parameter to <code>crud_router</code> and <code>EndpointCreator</code> optional.</li> <li>Inclusion of exceptions in the <code>http_exceptions</code> module within the broader <code>exceptions</code> module for better organization and accessibility.</li> </ul>"},{"location":"changelog/#detailed-changes_13","title":"Detailed Changes","text":""},{"location":"changelog/#custom-updated_at-column","title":"Custom <code>updated_at</code> Column","text":"<p>FastCRUD now supports the customization of the <code>updated_at</code> column name, providing flexibility for applications with different database schema conventions or naming practices. Docs here.</p>"},{"location":"changelog/#example-configuration","title":"Example Configuration:","text":"<p>The example demonstrates how to specify a custom column name for <code>updated_at</code> when setting up the router for an endpoint, allowing for seamless integration with existing database schemas.</p>"},{"location":"changelog/#whats-changed_11","title":"What's Changed","text":"<ul> <li>Introduction of features enhancing flexibility and usability, such as custom <code>updated_at</code> column names and the optional CRUD parameter in routing configurations.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#050-feb-3-2024","title":"[0.5.0] - Feb 3, 2024","text":""},{"location":"changelog/#added_15","title":"Added","text":"<ul> <li>Advanced filters inspired by Django ORM for enhanced querying capabilities.</li> <li>Optional bulk operations for update and delete methods.</li> <li>Custom soft delete mechanisms integrated into <code>FastCRUD</code>, <code>EndpointCreator</code>, and <code>crud_router</code>.</li> <li>Comprehensive test suite for the newly introduced features.</li> </ul>"},{"location":"changelog/#detailed-changes_14","title":"Detailed Changes","text":""},{"location":"changelog/#advanced-filters_1","title":"Advanced Filters","text":"<p>The advanced filtering system allows for sophisticated querying with support for operators like <code>__gt</code>, <code>__lt</code>, <code>__gte</code>, and <code>__lte</code>, applicable across various CRUD operations. This feature significantly enhances the flexibility and power of data retrieval and manipulation within FastCRUD. Docs here.</p>"},{"location":"changelog/#examples","title":"Examples:","text":"<ul> <li>Utilization of advanced filters for precise data fetching and aggregation.</li> <li>Implementation examples for fetching records within specific criteria and counting records based on date ranges.</li> </ul>"},{"location":"changelog/#custom-soft-delete-mechanisms","title":"Custom Soft Delete Mechanisms","text":"<p>FastCRUD's soft delete functionality now supports customization, allowing developers to specify alternative column names for <code>is_deleted</code> and <code>deleted_at</code> fields. This adaptation enables seamless integration with existing database schemas that employ different naming conventions for soft deletion tracking. Docs here.</p>"},{"location":"changelog/#example-configuration_1","title":"Example Configuration:","text":"<ul> <li>Setting up <code>crud_router</code> with custom soft delete column names, demonstrating the flexibility in adapting FastCRUD to various database schema requirements.</li> </ul>"},{"location":"changelog/#bulk-operations","title":"Bulk Operations","text":"<p>The introduction of optional bulk operations for updating and deleting records provides a more efficient way to handle large datasets, enabling mass modifications or removals with single method calls. This feature is particularly useful for applications that require frequent bulk data management tasks. Docs here.</p>"},{"location":"changelog/#examples_1","title":"Examples:","text":"<ul> <li>Demonstrating bulk update and delete operations, highlighting the capability to apply changes to multiple records based on specific criteria.</li> </ul>"},{"location":"changelog/#whats-changed_12","title":"What's Changed","text":"<ul> <li>Addition of advanced filters, bulk operations, and custom soft delete functionalities.</li> </ul>"},{"location":"changelog/#new-contributors_6","title":"New Contributors","text":"<ul> <li>@YuriiMotov</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#040-jan-31-2024","title":"[0.4.0] - Jan 31, 2024","text":""},{"location":"changelog/#added_16","title":"Added","text":"<ul> <li>Documentation and tests for SQLModel support.</li> <li><code>py.typed</code> file for better typing support.</li> </ul>"},{"location":"changelog/#detailed","title":"Detailed","text":"<p>Check the docs for SQLModel support.</p>"},{"location":"changelog/#whats-changed_13","title":"What's Changed","text":"<ul> <li>SQLModel support.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#030-jan-28-2024","title":"[0.3.0] - Jan 28, 2024","text":""},{"location":"changelog/#added_17","title":"Added","text":"<ul> <li>The <code>CustomEndpointCreator</code> for advanced route creation and customization.</li> <li>The ability to selectively include or exclude CRUD operations in the <code>crud_router</code> using <code>included_methods</code> and <code>deleted_methods</code>.</li> <li>Comprehensive tests for the new features.</li> <li>Detailed documentation on utilizing the <code>CustomEndpointCreator</code> and selectively including or excluding endpoints.</li> </ul>"},{"location":"changelog/#customendpointcreator","title":"CustomEndpointCreator","text":"<p>This feature introduces the capability to extend the <code>EndpointCreator</code> class, enabling developers to define custom routes and incorporate complex logic into API endpoints. The documentation has been updated to include detailed examples and guidelines on implementing and using <code>CustomEndpointCreator</code> in projects. Docs here.</p>"},{"location":"changelog/#selective-crud-operations","title":"Selective CRUD Operations","text":"<p>The <code>crud_router</code> function has been enhanced with <code>included_methods</code> and <code>deleted_methods</code> parameters, offering developers precise control over which CRUD methods are included or excluded when configuring routers. This addition provides flexibility in API design, allowing for the creation of tailored endpoint setups that meet specific project requirements. Docs here.</p>"},{"location":"changelog/#detailed-changes_15","title":"Detailed Changes","text":""},{"location":"changelog/#extending-endpointcreator","title":"Extending EndpointCreator","text":"<p>Developers can now create a subclass of <code>EndpointCreator</code> to define custom routes or override existing methods, adding a layer of flexibility and customization to FastCRUD's routing capabilities.</p>"},{"location":"changelog/#creating-a-custom-endpointcreator","title":"Creating a Custom EndpointCreator","text":"<p>An example demonstrates how to subclass <code>EndpointCreator</code> and add custom routes or override existing methods, further illustrating how to incorporate custom endpoint logic and route configurations into the FastAPI application.</p>"},{"location":"changelog/#adding-custom-routes","title":"Adding Custom Routes","text":"<p>The process involves overriding the <code>add_routes_to_router</code> method to include both standard CRUD routes and custom routes, showcasing how developers can extend FastCRUD's functionality to suit their application's unique needs.</p>"},{"location":"changelog/#using-the-custom-endpointcreator","title":"Using the Custom EndpointCreator","text":"<p>An example highlights how to use the custom <code>EndpointCreator</code> with <code>crud_router</code>, specifying selective methods to be included in the router setup, thereby demonstrating the practical application of custom endpoint creation and selective method inclusion.</p>"},{"location":"changelog/#selective-crud-operations_1","title":"Selective CRUD Operations","text":"<p>Examples for using <code>included_methods</code> and <code>deleted_methods</code> illustrate how to specify exactly which CRUD methods should be included or excluded when setting up the router, offering developers precise control over their API's exposed functionality.</p> <p>Warning</p> <p>Providing both <code>included_methods</code> and <code>deleted_methods</code> will result in a ValueError.</p> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#021-jan-27-2024","title":"[0.2.1] - Jan 27, 2024","text":""},{"location":"changelog/#whats-changed_14","title":"What's Changed","text":"<ul> <li>Improved type hints across the codebase, enhancing the clarity and reliability of type checking within FastCRUD.</li> <li>Documentation has been thoroughly updated and refined, including fixes for previous inaccuracies and the addition of more detailed explanations and examples.</li> <li>Descriptions have been added to automatically generated endpoints, making the API documentation more informative and user-friendly.</li> </ul> <p>Full Changelog: View the full changelog</p>"},{"location":"changelog/#020-jan-25-2024","title":"[0.2.0] - Jan 25, 2024","text":""},{"location":"changelog/#added_18","title":"Added","text":"<ul> <li>Docs Published!</li> </ul>"},{"location":"changelog/#015-jan-24-2024","title":"[0.1.5] - Jan 24, 2024","text":"<p>Readme updates, pyproject requirements</p>"},{"location":"changelog/#012-jan-23-2024","title":"[0.1.2] - Jan 23, 2024","text":"<p>First public release.</p>"},{"location":"installing/","title":"Installing","text":""},{"location":"installing/#requirements","title":"Requirements","text":"<p>Before installing FastCRUD, ensure you have the following prerequisites:</p> <ul> <li>Python: Version 3.9 or newer.</li> <li>FastAPI: FastCRUD is built to work with FastAPI, so having FastAPI in your project is essential.</li> <li>SQLAlchemy or SQLModel: FastCRUD uses SQLAlchemy 2.0 for database operations, so you need SQLAlchemy 2.0 or newer or SQLModel 0.14 or newer.</li> <li>Pydantic V2 or SQLModel: FastCRUD leverages Pydantic models for data validation and serialization, so you need Pydantic 2.0 or newer or SQLModel 0.14 or newer.</li> </ul>"},{"location":"installing/#installing","title":"Installing","text":"<p>To install, just run:</p> <pre><code>pip install fastcrud\n</code></pre> <p>Or, if using poetry:</p> <pre><code>poetry add fastcrud\n</code></pre>"},{"location":"quick-start/","title":"Quick-Start","text":"<p>If you are using SQLModel, go to Using SQLModel instead.</p>"},{"location":"quick-start/#minimal-example","title":"Minimal Example","text":"<p>Assuming you have your SQLAlchemy model, Pydantic schemas and database connection, just skip to Using FastCRUD</p>"},{"location":"quick-start/#basic-setup","title":"Basic Setup","text":"<p>Define your SQLAlchemy model</p> setup.py<pre><code>import datetime\nfrom sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Then your Pydantic schemas</p> setup.py<pre><code>import datetime\nfrom sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>And, finally, your database connection</p> setup.py<pre><code>import datetime\nfrom sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase, sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom pydantic import BaseModel\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n\n\nclass ItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre>"},{"location":"quick-start/#using-fastcrud","title":"Using FastCRUD","text":"<p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> main.py<pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\nfrom fastcrud import crud_router\nimport setup\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with setup.async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with setup.engine.begin() as conn:\n        await conn.run_sync(setup.Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=get_session,\n    model=setup.Item,\n    create_schema=setup.ItemSchema,\n    update_schema=setup.ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>And it's all done, just go to <code>/docs</code> and the crud endpoints are created.</p>"},{"location":"showcase/","title":"Showcase","text":"<p>Categories</p> <p>Browse by type: Applications \u00b7 Tutorials</p>"},{"location":"showcase/#applications","title":"Applications","text":"<p>Be the First!</p> <p>No applications yet. Have you built something with FastCRUD? We'd love to feature it here!</p> <p>Submit Your Project</p>"},{"location":"showcase/#open-source","title":"Open Source","text":"<p>FastAPI Boilerplate</p> <p>By FastCRUD Team \u00b7 Source</p> <p>FastAPI boilerplate creates an extendable async API using FastAPI, Pydantic V2, SQLAlchemy 2.0 and PostgreSQL.</p> <p><code>Template</code> <code>FastAPI</code> <code>Boilerplate</code></p> <p>Email Assistant API</p> <p>By FastCRUD Team \u00b7 Source</p> <p>A personalized email writing assistant built with FastAPI, OpenAI's API, and FastCRUD.</p> <p><code>OpenAI</code> <code>LLM</code> <code>AI</code></p> <p>SQLModel Boilerplate</p> <p>By FastCRUD Team \u00b7 Source</p> <p>SQLModel boilerplate creates an extendable async API using FastAPI, SQLModel and PostgreSQL.</p> <p><code>Template</code> <code>SQLModel</code> <code>Boilerplate</code></p>"},{"location":"showcase/#tutorials","title":"Tutorials","text":"<p>Creating LLM Powered APIs with FastAPI</p> <p>By FastCRUD Team \u00b7 View Tutorial</p> <p>Learn the basics of creating LLM powered APIs with FastCRUD.</p> <p><code>FastAPI</code> <code>AI</code> <code>Beginner</code> <code>LLM</code></p> <p>Add Your Project</p> <p>Built something with FastCRUD? We'd love to showcase it!</p> <p>Submit Your Project</p>"},{"location":"sqlmodel/","title":"Using FastCRUD with SQLModel","text":"<p>Since SQLModel is just a combination of SQLAlchemy and Pydantic, the process simplifies as SQLModel combines the model and schema definitions.</p> <p>Wherever in the docs you see a SQLAlchemy model or Pydantic schema being used, you may just replace it with SQLModel and it will work. For the quick start:</p> <p>Define your SQLModel model</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Then your schemas</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>And, finally, your database connection</p> setup.py<pre><code>from sqlmodel import SQLModel, Field\nfrom sqlalchemy.orm import sessionmaker\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\n\nclass Item(SQLModel, table=True):\n    id: int | None = Field(default=None, primary_key=True)\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n    created_at: datetime.datetime = Field(\n        nullable=False, sa_column_kwargs={\"default\": func.now()}\n    )\n\n\nclass ItemSchema(SQLModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n</code></pre> <p>Use <code>crud_router</code> and include it in your <code>FastAPI</code> application</p> main.py<pre><code>from fastcrud import crud_router\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=ItemSchema,\n    update_schema=ItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"]\n)\n\napp.include_router(item_router)\n</code></pre> <p>By following the above setup, FastCRUD auto-generates CRUD endpoints for your model, accessible through the <code>/docs</code> route of your FastAPI application.</p>"},{"location":"advanced/crud/","title":"Advanced Use of FastCRUD","text":"<p>FastCRUD offers a flexible and powerful approach to handling CRUD operations in FastAPI applications, leveraging the SQLAlchemy ORM. Beyond basic CRUD functionality, FastCRUD provides advanced features like <code>allow_multiple</code> for updates and deletes, and support for advanced filters (e.g., less than, greater than). These features enable more complex and fine-grained data manipulation and querying capabilities.</p>"},{"location":"advanced/crud/#typing-options-for-fastcrud","title":"Typing Options for <code>FastCRUD</code>","text":"<p>Note that when initializing <code>FastCRUD</code>, assuming you have a model like:</p> Simplified <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <p>Warning</p> <p>Note that naive <code>datetime</code> such as <code>datetime.utcnow</code> is not supported by <code>FastCRUD</code> as it was deprecated.</p> <p>Use timezone aware <code>datetime</code>, such as <code>datetime.now(UTC)</code> instead.</p> <p>You could just pass it to <code>FastCRUD</code>:</p> <pre><code>from fastcrud import FastCRUD\n\nuser_crud = FastCRUD(User)\n</code></pre> <p>But you also may want a more robust typing, for that purpose, you may also pass the relevant pydantic schemas in the following way:</p> Simplified <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <pre><code>from .user.model import User\nfrom .user.schemas import CreateUserSchema, ReadUserSchema, UpdateUserSchema, DeleteUserSchema\n\n# Just pass None if you don't have one of the schemas\nUserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\n</code></pre> <p>Then you can initialize <code>UserCRUD</code> like you would any <code>FastCRUD</code> instance, but with the relevant types:</p> <pre><code>from .user.model import User\n\nuser_crud = UserCRUD(User)\n</code></pre>"},{"location":"advanced/crud/#allow-multiple-updates-and-deletes","title":"Allow Multiple Updates and Deletes","text":"<p>One of FastCRUD's advanced features is the ability to update or delete multiple records at once based on specified conditions. This is particularly useful for batch operations where you need to modify or remove several records that match certain criteria.</p>"},{"location":"advanced/crud/#updating-multiple-records","title":"Updating Multiple Records","text":"<p>To update multiple records, you can set the <code>allow_multiple=True</code> parameter in the <code>update</code> method. This allows FastCRUD to apply the update to all records matching the given filters.</p> <pre><code># Assuming setup for FastCRUD instance `item_crud` and SQLAlchemy async session `db`\n\n# Update all items priced below $10 to a new price\nawait item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    allow_multiple=True,\n    price__lt=10,\n)\n</code></pre>"},{"location":"advanced/crud/#deleting-multiple-records","title":"Deleting Multiple Records","text":"<p>Similarly, you can delete multiple records by using the <code>allow_multiple=True</code> parameter in the <code>delete</code> or <code>db_delete</code> method, depending on whether you're performing a soft or hard delete.</p> <pre><code># Soft delete all items not sold in the last year\nawait item_crud.delete(\n    db=db,\n    allow_multiple=True,\n    last_sold__lt=datetime.datetime.now() - datetime.timedelta(days=365),\n)\n</code></pre>"},{"location":"advanced/crud/#advanced-filters","title":"Advanced Filters","text":"<p>FastCRUD supports advanced filtering options, allowing you to query records using operators such as greater than (<code>__gt</code>), less than (<code>__lt</code>), and their inclusive counterparts (<code>__gte</code>, <code>__lte</code>). These filters can be used in any method that retrieves or operates on records, including <code>get</code>, <code>get_multi</code>, <code>exists</code>, <code>count</code>, <code>update</code>, and <code>delete</code>.</p>"},{"location":"advanced/crud/#single-parameter-filters","title":"Single parameter filters","text":"<p>Most filter operators require a single string or integer value.</p> <pre><code># Fetch items priced between above $5\nitems = await item_crud.get_multi(\n    db=db,\n    price__gte=5,\n)\n</code></pre> <p>Currently supported single parameter filters are:</p> <ul> <li><code>__gt</code> - greater than</li> <li><code>__lt</code> - less than</li> <li><code>__gte</code> - greater than or equal to</li> <li><code>__lte</code> - less than or equal to</li> <li><code>__ne</code> - not equal</li> <li><code>__is</code> - used to test True, False and None identity</li> <li><code>__is_not</code> - negation of \"is\"</li> <li><code>__like</code> - SQL \"like\" search for specific text pattern</li> <li><code>__notlike</code> - negation of \"like\"</li> <li><code>__ilike</code> - case insensitive \"like\"</li> <li><code>__notilike</code> - case insensitive \"notlike\"</li> <li><code>__startswith</code> - text starts with given string</li> <li><code>__endswith</code> - text ends with given string</li> <li><code>__contains</code> - text contains given string</li> <li><code>__match</code> - database-specific match expression</li> </ul>"},{"location":"advanced/crud/#complex-parameter-filters","title":"Complex parameter filters","text":"<p>Some operators require multiple values. They must be passed as a python tuple, list or set.</p> <pre><code># Fetch items priced between $5 and $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__between=(5, 20),\n)\n</code></pre> <ul> <li><code>__between</code> - between 2 numeric values</li> <li><code>__in</code> - included in</li> <li><code>__not_in</code> - not included in</li> </ul>"},{"location":"advanced/crud/#or-clauses","title":"OR clauses","text":"<p>More complex OR filters are supported. They must be passed as dictionary, where each key is a library-supported operator to be used in OR expression and values is what get's passed as the parameter.</p> <pre><code># Fetch items priced under $5 or above $20\nitems = await item_crud.get_multi(\n    db=db,\n    price__or={'lt': 5, 'gt': 20},\n)\n</code></pre>"},{"location":"advanced/crud/#and-clauses","title":"AND clauses","text":"<p>AND clauses can be achieved by chaining multiple filters together.</p> <pre><code># Fetch items priced under $20 and over 2 years of warranty.\nitems = await item_crud.get_multi(\n    db=db,\n    price__lt=20,\n    warranty_years__gt=2,\n)\n</code></pre>"},{"location":"advanced/crud/#counting-records","title":"Counting Records","text":"<pre><code># Count items created in the last month\nitem_count = await item_crud.count(\n    db=db,\n    created_at__gte=datetime.datetime.now() - datetime.timedelta(days=30),\n)\n</code></pre>"},{"location":"advanced/crud/#skipping-database-commit","title":"Skipping Database Commit","text":"<p>For <code>create</code>, <code>update</code>, <code>db_delete</code> and <code>delete</code> methods of <code>FastCRUD</code>, you have the option of passing <code>commit=False</code> so you don't commit the operations immediately.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nawait item_crud.delete(\n    db=db, \n    commit=False, \n    id=1,\n)\n# this will not actually delete until you run a db.commit()\n</code></pre>"},{"location":"advanced/crud/#returning-clause-in-update","title":"Returning clause in <code>update</code>","text":"<p>In <code>update</code> method, you can pass <code>return_columns</code> parameter containing a list of columns you want to return after the update.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nitem = await item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    return_columns=[\"price\"],\n    price__lt=10,\n)\n# this will return the updated price\n</code></pre> <p>You can also pass <code>schema_to_select</code> parameter and <code>return_as_model</code> to return the updated data in the form of a Pydantic schema.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Base, Item\nfrom .item.schemas import ItemSchema\n\nitem_crud = FastCRUD(Item)\n\nitem = await item_crud.update(\n    db=db,\n    object={\"price\": 9.99},\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n    price__lt=10,\n)\n# this will return the updated data in the form of ItemSchema\n</code></pre>"},{"location":"advanced/crud/#unpaginated-get_multi-and-get_multi_joined","title":"Unpaginated <code>get_multi</code> and <code>get_multi_joined</code>","text":"<p>If you pass <code>None</code> to <code>limit</code> in <code>get_multi</code> and <code>get_multi_joined</code>, you get the whole unpaginated set of data that matches the filters. Use this with caution.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\n\nitem_crud = FastCRUD(Item)\n\nitems = await item_crud.get_multi(db=db, limit=None)\n# this will return all items in the db\n</code></pre> <p>Caution</p> <p>Be cautious when returning all the data in your database, and you should almost never allow your user API to do this.</p>"},{"location":"advanced/crud/#using-get_joined-and-get_multi_joined-for-multiple-models","title":"Using <code>get_joined</code> and <code>get_multi_joined</code> for multiple models","text":"<p>To facilitate complex data relationships, <code>get_joined</code> and <code>get_multi_joined</code> can be configured to handle joins with multiple models. This is achieved using the <code>joins_config</code> parameter, where you can specify a list of <code>JoinConfig</code> instances, each representing a distinct join configuration.</p>"},{"location":"advanced/crud/#upserting-multiple-records-using-upsert_multi","title":"Upserting multiple records using <code>upsert_multi</code>","text":"<p>FastCRUD provides an <code>upsert_multi</code> method to efficiently upsert multiple records in a single operation. This method is particularly useful when you need to insert new records or update existing ones based on a unique constraint.</p> <pre><code>from fastcrud import FastCRUD\n\nfrom .database import session as db\nfrom .item.model import Item\nfrom .item.schemas import CreateItemSchema, ItemSchema\n\nitem_crud = FastCRUD(Item)\nitems = await item_crud.upsert_multi(\n    db=db,\n    instances=[\n        CreateItemSchema(price=9.99),\n    ],\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n# this will return the upserted data in the form of ItemSchema\n</code></pre>"},{"location":"advanced/crud/#customizing-the-update-logic","title":"Customizing the Update Logic","text":"<p>To allow more granular control over the SQL <code>UPDATE</code> operation during an upsert, <code>upsert_multi</code> can accept an <code>update_override</code> argument. This allows for the specification of custom update logic using SQL expressions, like the <code>case</code> statement, to handle complex conditions.</p> <pre><code>from sqlalchemy.sql import case\n\nupdate_override = {\n    \"name\": case(\n        (Item.name.is_(None), stmt.excluded.name),\n        else_=Item.name\n    )\n}\n\nitems = await item_crud.upsert_multi(\n    db=db,\n    instances=[\n        CreateItemSchema(name=\"Gadget\", price=15.99),\n    ],\n    update_override=update_override,\n    schema_to_select=ItemSchema,\n    return_as_model=True,\n)\n</code></pre> <p>In the example above, the <code>name</code> field of the <code>Item</code> model will be updated to the new value only if the existing <code>name</code> field is <code>None</code>. Otherwise, it retains the existing <code>name</code>.</p>"},{"location":"advanced/crud/#example-joining-user-tier-and-department-models","title":"Example: Joining <code>User</code>, <code>Tier</code>, and <code>Department</code> Models","text":"<p>Consider a scenario where you want to retrieve users along with their associated tier and department information. Here's how you can achieve this using <code>get_multi_joined</code>.</p> <p>Start by creating the models and schemas, followed by a description of how they're to be joined:</p> Models and Schemas <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> Join Configurations<pre><code>from fastcrud import JoinConfig\n\njoins_config = [\n    JoinConfig(\n        model=Tier,\n        join_on=User.tier_id == Tier.id,\n        join_prefix=\"tier_\",\n        schema_to_select=ReadTierSchema,\n        join_type=\"left\",\n    ),\n\n    JoinConfig(\n        model=Department,\n        join_on=User.department_id == Department.id,\n        join_prefix=\"dept_\",\n        schema_to_select=ReadDepartmentSchema,\n        join_type=\"inner\",\n    ),\n]\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n    joins_config=joins_config,\n)\n</code></pre> <p>Then just pass this list to <code>joins_config</code>:</p> Passing to get_multi_joined<pre><code>from fastcrud import JoinConfig\n\njoins_config = [\n    ...\n]\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n    joins_config=joins_config,\n)\n</code></pre> <p>In this example, users are joined with the <code>Tier</code> and <code>Department</code> models. The <code>join_on</code> parameter specifies the condition for the join, <code>join_prefix</code> assigns a prefix to columns from the joined models (to avoid naming conflicts), and <code>join_type</code> determines whether it's a left or inner join.</p> <p>Warning</p> <p>If both single join parameters and <code>joins_config</code> are used simultaneously, an error will be raised.</p>"},{"location":"advanced/crud/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through its <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>one-to-one</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"advanced/crud/#one-to-one-joins","title":"One-to-One Joins","text":"<p>One-to-one relationships can be efficiently managed using either <code>get_joined</code> or <code>get_multi_joined</code>. The <code>get_joined</code> method is typically used when you want to fetch a single record from the database along with its associated record from another table, such as a user and their corresponding profile details. If you're retrieving multiple records, <code>get_multi_joined</code> can also be used for one-to-one joins. The parameter that deals with it, <code>relationship_type</code>, defaults to <code>one-on-one</code>.</p>"},{"location":"advanced/crud/#one-to-many-joins","title":"One-to-Many Joins","text":"<p>For one-to-many relationships, where a single record can be associated with multiple records in another table, <code>get_joined</code> can be used with <code>nest_joins</code> set to <code>True</code>. This setup allows the primary record to include a nested list of associated records, making it suitable for scenarios such as retrieving a user and all their blog posts. Alternatively, <code>get_multi_joined</code> is also applicable here for fetching multiple primary records, each with their nested lists of related records.</p> <p>Warning</p> <p>When using <code>nested_joins=True</code>, the performance will always be a bit worse than when using <code>nested_joins=False</code>. For cases where more performance is necessary, consider using <code>nested_joins=False</code> and remodeling your database.</p>"},{"location":"advanced/crud/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul>"},{"location":"advanced/crud/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>For a more detailed explanation, you may check the joins docs.</p>"},{"location":"advanced/crud/#using-aliases","title":"Using aliases","text":"<p>In complex query scenarios, particularly when you need to join a table to itself or perform multiple joins on the same table for different purposes, aliasing becomes crucial. Aliasing allows you to refer to the same table in different contexts with unique identifiers, avoiding conflicts and ambiguity in your queries.</p> <p>For both <code>get_joined</code> and <code>get_multi_joined</code> methods, when you need to join the same model multiple times, you can utilize the <code>alias</code> parameter within your <code>JoinConfig</code> to differentiate between the joins. This parameter expects an instance of <code>AliasedClass</code>, which can be created using the <code>aliased</code> function from SQLAlchemy (also in FastCRUD for convenience).</p>"},{"location":"advanced/crud/#example-joining-the-same-model-multiple-times","title":"Example: Joining the Same Model Multiple Times","text":"<p>Consider a task management application where tasks have both an owner and an assigned user, represented by the same <code>User</code> model. To fetch tasks with details of both users, we use aliases to join the <code>User</code> model twice, distinguishing between owners and assigned users.</p> <p>Let's start by creating the aliases and passing them to the join configuration. Don't forget to use the alias for <code>join_on</code>:</p> Join Configurations with Aliases<pre><code>from fastcrud import FastCRUD, JoinConfig, aliased\n\n# Create aliases for User to distinguish between the owner and the assigned user\nowner_alias = aliased(User, name=\"owner\")\nassigned_user_alias = aliased(User, name=\"assigned_user\")\n\n# Configure joins with aliases\njoins_config = [\n    JoinConfig(\n        model=User,\n        join_on=Task.owner_id == owner_alias.id,\n        join_prefix=\"owner_\",\n        schema_to_select=ReadUserSchema,\n        join_type=\"inner\",\n        alias=owner_alias,  # Pass the aliased class instance\n    ),\n    JoinConfig(\n        model=User,\n        join_on=Task.assigned_user_id == assigned_user_alias.id,\n        join_prefix=\"assigned_\",\n        schema_to_select=ReadUserSchema,\n        join_type=\"inner\",\n        alias=assigned_user_alias,  # Pass the aliased class instance\n    ),\n]\n\n# Initialize your FastCRUD instance for Task\ntask_crud = FastCRUD(Task)\n\n# Fetch tasks with joined user details\ntasks = await task_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadTaskSchema,\n    offset=0,\n    limit=10,\n    joins_config=joins_config,\n)\n</code></pre> <p>Then just pass this <code>joins_config</code> to <code>get_multi_joined</code>:</p> Passing joins_config to get_multi_joined<pre><code>from fastcrud import FastCRUD, JoinConfig, aliased\n\n...\n\n# Configure joins with aliases\njoins_config = [\n    ...\n]\n\n# Initialize your FastCRUD instance for Task\ntask_crud = FastCRUD(Task)\n\n# Fetch tasks with joined user details\ntasks = await task_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadTaskSchema,\n    offset=0,\n    limit=10,\n    joins_config=joins_config,\n)\n</code></pre> <p>In this example, <code>owner_alias</code> and <code>assigned_user_alias</code> are created from <code>User</code> to distinguish between the task's owner and the assigned user within the task management system. By using aliases, you can join the same model multiple times for different purposes in your queries, enhancing expressiveness and eliminating ambiguity.</p>"},{"location":"advanced/crud/#many-to-many-relationships-with-get_multi_joined","title":"Many-to-Many Relationships with <code>get_multi_joined</code>","text":"<p>FastCRUD simplifies dealing with many-to-many relationships by allowing easy fetch operations with joined models. Here, we demonstrate using <code>get_multi_joined</code> to handle a many-to-many relationship between <code>Project</code> and <code>Participant</code> models, linked through an association table.</p> <p>Note on Handling Many-to-Many Relationships:</p> <p>When using <code>get_multi_joined</code> for many-to-many relationships, it's essential to maintain a specific order in your <code>joins_config</code>: </p> <ol> <li>First, specify the main table you're querying from.</li> <li>Next, include the association table that links your main table to the other table involved in the many-to-many relationship.</li> <li>Finally, specify the other table that is connected via the association table.</li> </ol> <p>This order ensures that the SQL joins are structured correctly to reflect the many-to-many relationship and retrieve the desired data accurately.</p> <p>Tip</p> <p>Note that the first one can be the model defined in <code>FastCRUD(Model)</code>.</p> <pre><code># Fetch projects with their participants via a many-to-many relationship\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    ),\n]\n\ncrud_project = FastCRUD(Project)\n\nprojects_with_participants = await project_crud.get_multi_joined(\n    db=db,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n)\n</code></pre> <p>For a more detailed explanation, read this part of the docs.</p>"},{"location":"advanced/crud/#enhanced-query-capabilities-with-method-chaining","title":"Enhanced Query Capabilities with Method Chaining","text":"<p>The <code>select</code> method in FastCRUD is designed for flexibility, enabling you to build complex queries through method chaining.</p>"},{"location":"advanced/crud/#the-select-method","title":"The <code>select</code> Method","text":"<pre><code>async def select(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any\n) -&gt; Selectable\n</code></pre> <p>This method constructs a SQL Alchemy <code>Select</code> statement, offering optional column selection, filtering, and sorting. It's designed for flexibility, allowing you to chain additional SQLAlchemy methods for even more complex queries.</p>"},{"location":"advanced/crud/#features","title":"Features:","text":"<ul> <li>Column Selection: Specify columns with a Pydantic schema.</li> <li>Sorting: Define one or more columns for sorting, along with their sort order.</li> <li>Filtering: Apply filters directly through keyword arguments.</li> <li>Chaining: Chain with other SQLAlchemy methods for advanced query construction.</li> </ul>"},{"location":"advanced/crud/#usage-example","title":"Usage Example:","text":"<pre><code>class ReadMyModelSchema(BaseModel):\n    id: int\n    name: str | None = None\n    archived: bool\n    archived_at: datetime.datetime\n    date_updated: datetime.datetime\n\n\nstmt = await my_model_crud.select(\n    schema_to_select=ReadMyModelSchema,\n    sort_columns='name',\n    name__like='%example%',\n)\nstmt = stmt.where(additional_conditions).limit(10)\nresults = await db.execute(stmt)\n</code></pre> <p>This example demonstrates selecting a subset of columns, applying a filter, and chaining additional conditions like <code>where</code> and <code>limit</code>. Note that <code>select</code> returns a <code>Select</code> object, allowing for further modifications before execution.</p>"},{"location":"advanced/crud/#conclusion","title":"Conclusion","text":"<p>The advanced features of FastCRUD, such as <code>allow_multiple</code> and support for advanced filters, empower developers to efficiently manage database records with complex conditions. By leveraging these capabilities, you can build more dynamic, robust, and scalable FastAPI applications that effectively interact with your data model.</p>"},{"location":"advanced/endpoint/","title":"Advanced Use of EndpointCreator","text":""},{"location":"advanced/endpoint/#available-automatic-endpoints","title":"Available Automatic Endpoints","text":"<p>FastCRUD automates the creation of CRUD (Create, Read, Update, Delete) endpoints for your FastAPI application. Here's an overview of the available automatic endpoints and how they work, based on the automatic endpoints we've generated before:</p>"},{"location":"advanced/endpoint/#create","title":"Create","text":"<ul> <li>Endpoint: <code>/{model}</code></li> <li>Method: <code>POST</code></li> <li>Description: Creates a new item in the database.</li> <li>Request Body: JSON object based on the <code>create_schema</code>.</li> <li>Example Request: <code>POST /items</code> with JSON body.</li> </ul>"},{"location":"advanced/endpoint/#read","title":"Read","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>GET</code></li> <li>Description: Retrieves a single item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to retrieve.</li> <li>Example Request: <code>GET /items/1</code>.</li> <li>Example Return: <pre><code>{\n    \"id\": 1,\n    \"name\": \"Item 1\",\n    \"description\": \"Description of item 1\",\n    \"category\": \"Movies\",\n    \"price\": 5.99,\n    \"last_sold\": null,\n    \"created_at\": \"2024-01-01 12:00:00\"\n}\n</code></pre></li> </ul>"},{"location":"advanced/endpoint/#read-multiple","title":"Read Multiple","text":"<ul> <li>Endpoint: <code>/{model}</code></li> <li>Method: <code>GET</code></li> <li>Description: Retrieves multiple items with optional pagination.</li> <li>Query Parameters:<ul> <li><code>offset</code> (optional): The offset from where to start fetching items.</li> <li><code>limit</code> (optional): The maximum number of items to return.</li> <li><code>page</code> (optional): The page number, starting from 1.</li> <li><code>itemsPerPage</code> (optional): The number of items per page.</li> </ul> </li> <li>Example Request: <code>GET /items?offset=3&amp;limit=4</code>.</li> <li>Example Return: <pre><code>{\n  \"data\": [\n    {\n        \"id\": 4,\n        \"name\": \"Item 4\",\n        \"description\": \"Description of item 4\",\n        \"category\": \"Books\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:01:00\"\n    },\n    {\n        \"id\": 5,\n        \"name\": \"Item 5\",\n        \"description\": \"Description of item 5\",\n        \"category\": \"Music\",\n        \"price\": 5.99,\n        \"last_sold\": \"2024-04-01 00:00:00\",\n        \"created_at\": \"2024-01-01 12:10:00\"\n    },\n    {\n        \"id\": 6,\n        \"name\": \"Item 6\",\n        \"description\": \"Description of item 6\",\n        \"category\": \"TV\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:15:00\"\n    },\n    {\n        \"id\": 7,\n        \"name\": \"Item 7\",\n        \"description\": \"Description of item 7\",\n        \"category\": \"Books\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 13:00:30\"\n    }\n  ],\n  \"total_count\": 50\n}\n</code></pre></li> <li>Example Paginated Request: <code>GET /items?page=1&amp;itemsPerPage=3</code>.</li> <li>Example Paginated Return: <pre><code>{\n  \"data\": [\n    {\n        \"id\": 1,\n        \"name\": \"Item 1\",\n        \"description\": \"Description of item 1\",\n        \"category\": \"Movies\",\n        \"price\": 5.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:01\"\n    },\n    {\n        \"id\": 2,\n        \"name\": \"Item 2\",\n        \"description\": \"Description of item 2\",\n        \"category\": \"TV\",\n        \"price\": 19.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:15\"\n    },\n    {\n        \"id\": 3,\n        \"name\": \"Item 3\",\n        \"description\": \"Description of item 3\",\n        \"category\": \"Books\",\n        \"price\": 4.99,\n        \"last_sold\": null,\n        \"created_at\": \"2024-01-01 12:00:16\"\n    }\n  ],\n  \"total_count\": 50,\n  \"has_more\": true,\n  \"page\": 1,\n  \"items_per_page\": 3\n}\n</code></pre></li> </ul> <p>Note</p> <p><code>_read_paginated</code> endpoint was deprecated and mixed into <code>_read_items</code> in the release <code>0.15.0</code>. Simple <code>_read_items</code> behaviour persists with no breaking changes.</p> <p>Read items paginated: <pre><code>$ curl -X 'GET' \\\n  'http://localhost:8000/users?page=2&amp;itemsPerPage=10' \\\n  -H 'accept: application/json'\n</code></pre></p> <p>Read items unpaginated: <pre><code>$ curl -X 'GET' \\\n  'http://localhost:8000/users?offset=0&amp;limit=100' \\\n  -H 'accept: application/json'\n</code></pre></p>"},{"location":"advanced/endpoint/#update","title":"Update","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>PATCH</code></li> <li>Description: Updates an existing item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to update.</li> <li>Request Body: JSON object based on the <code>update_schema</code>.</li> <li>Example Request: <code>PATCH /items/1</code> with JSON body.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#delete","title":"Delete","text":"<ul> <li>Endpoint: <code>/{model}/{id}</code></li> <li>Method: <code>DELETE</code></li> <li>Description: Deletes (soft delete if configured) an item by its ID.</li> <li>Path Parameters: <code>id</code> - The ID of the item to delete.</li> <li>Example Request: <code>DELETE /items/1</code>.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#db-delete-hard-delete","title":"DB Delete (Hard Delete)","text":"<ul> <li>Endpoint: <code>/{model}/db_delete/{id}</code> (Available if a <code>delete_schema</code> is provided)</li> <li>Method: <code>DELETE</code></li> <li>Description: Permanently deletes an item by its ID, bypassing the soft delete mechanism.</li> <li>Path Parameters: <code>id</code> - The ID of the item to hard delete.</li> <li>Example Request: <code>DELETE /items/db_delete/1</code>.</li> <li>Example Return: <code>None</code></li> </ul>"},{"location":"advanced/endpoint/#selective-crud-operations","title":"Selective CRUD Operations","text":"<p>You can control which CRUD operations are exposed by using <code>included_methods</code> and <code>deleted_methods</code>. These parameters allow you to specify exactly which CRUD methods should be included or excluded when setting up the router. By default, all CRUD endpoints are included.</p> <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n</code></pre>"},{"location":"advanced/endpoint/#using-included_methods","title":"Using <code>included_methods</code>","text":"<p>Using <code>included_methods</code> you may define exactly the methods you want to be included.</p> <pre><code># Using crud_router with selective CRUD methods\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\", \"update\"],  # Only these methods will be included\n)\n\napp.include_router(my_router)\n</code></pre>"},{"location":"advanced/endpoint/#using-deleted_methods","title":"Using <code>deleted_methods</code>","text":"<p>Using <code>deleted_methods</code> you define the methods that will not be included.</p> <pre><code># Using crud_router with selective CRUD methods\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    deleted_methods=[\"update\", \"delete\"],  # All but these methods will be included\n)\n\napp.include_router(my_router)\n</code></pre> <p>Warning</p> <p>If <code>included_methods</code> and <code>deleted_methods</code> are both provided, a <code>ValueError</code> will be raised.</p>"},{"location":"advanced/endpoint/#customizing-endpoint-names","title":"Customizing Endpoint Names","text":"<p>You can customize the names of the auto generated endpoints by passing an <code>endpoint_names</code> dictionary when initializing the <code>EndpointCreator</code> or calling the <code>crud_router</code> function. This dictionary should map the CRUD operation names (<code>create</code>, <code>read</code>, <code>update</code>, <code>delete</code>, <code>db_delete</code>, <code>read_multi</code>) to your desired endpoint names.</p>"},{"location":"advanced/endpoint/#example-using-crud_router","title":"Example: Using <code>crud_router</code>","text":"<p>Here's how you can customize endpoint names using the <code>crud_router</code> function:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\n# Custom endpoint names\ncustom_endpoint_names = {\n    \"create\": \"add\",\n    \"read\": \"fetch\",\n    \"update\": \"modify\",\n    \"delete\": \"remove\",\n    \"read_multi\": \"list\",\n}\n\n# Setup CRUD router with custom endpoint names\napp.include_router(crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names=custom_endpoint_names,\n))\n</code></pre> <p>In this example, the standard CRUD endpoints will be replaced with <code>/add</code>, <code>/fetch/{id}</code>, <code>/modify/{id}</code>, <code>/remove/{id}</code>, <code>/list</code>, and <code>/paginate</code>.</p>"},{"location":"advanced/endpoint/#example-using-endpointcreator","title":"Example: Using <code>EndpointCreator</code>","text":"<p>If you are using <code>EndpointCreator</code>, you can also pass the <code>endpoint_names</code> dictionary to customize the endpoint names similarly:</p> <pre><code># Custom endpoint names\ncustom_endpoint_names = {\n    \"create\": \"add_new\",\n    \"read\": \"get_single\",\n    \"update\": \"change\",\n    \"delete\": \"erase\",\n    \"db_delete\": \"hard_erase\",\n    \"read_multi\": \"get_all\",\n    \"read_paginated\": \"get_page\",\n}\n\n# Initialize and use the custom EndpointCreator\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names=custom_endpoint_names,\n)\n\nendpoint_creator.add_routes_to_router()\napp.include_router(endpoint_creator.router)\n</code></pre> <p>Tip</p> <p>You only need to pass the names of the endpoints you want to change in the <code>endpoint_names</code> <code>dict</code>.</p> <p>Note</p> <p><code>default_endpoint_names</code> for <code>EndpointCreator</code> were changed to empty strings in <code>0.15.0</code>. See this issue for more details.</p>"},{"location":"advanced/endpoint/#extending-endpointcreator","title":"Extending <code>EndpointCreator</code>","text":"<p>You can create a subclass of <code>EndpointCreator</code> and override or add new methods to define custom routes. Here's an example:</p>"},{"location":"advanced/endpoint/#creating-a-custom-endpointcreator","title":"Creating a Custom <code>EndpointCreator</code>","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#adding-custom-routes","title":"Adding custom routes","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#overriding-add_routes_to_router","title":"Overriding <code>add_routes_to_router</code>","text":"<pre><code>from fastcrud import EndpointCreator\n\n# Define the custom EndpointCreator\nclass MyCustomEndpointCreator(EndpointCreator):\n    # Add custom routes or override existing methods\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n    # override add_routes_to_router to also add the custom routes\n    def add_routes_to_router(self, ...):\n        # First, add standard CRUD routes if you want them\n        super().add_routes_to_router(...)\n\n        # Now, add custom routes\n        self.router.add_api_route(\n            path=\"/custom\",\n            endpoint=self._custom_route(),\n            methods=[\"GET\"],\n            tags=self.tags,\n            # Other parameters as needed\n        )\n</code></pre>"},{"location":"advanced/endpoint/#using-the-custom-endpointcreator","title":"Using the Custom EndpointCreator","text":"<pre><code># Assuming MyCustomEndpointCreator was created\n\n...\n\n# Use the custom EndpointCreator with crud_router\nmy_router = crud_router(\n    session=get_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=FastCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\", \"update\"],  # Including selective methods\n    endpoint_creator=MyCustomEndpointCreator,\n)\n\napp.include_router(my_router)\n</code></pre>"},{"location":"advanced/endpoint/#custom-soft-delete","title":"Custom Soft Delete","text":"<p>To implement custom soft delete columns using <code>EndpointCreator</code> and <code>crud_router</code> in FastCRUD, you need to specify the names of the columns used for indicating deletion status and the deletion timestamp in your model. FastCRUD provides flexibility in handling soft deletes by allowing you to configure these column names directly when setting up CRUD operations or API endpoints.</p> <p>Here's how to specify custom soft delete columns when utilizing <code>EndpointCreator</code> and <code>crud_router</code>:</p>"},{"location":"advanced/endpoint/#defining-models-with-custom-soft-delete-columns","title":"Defining Models with Custom Soft Delete Columns","text":"<p>First, ensure your SQLAlchemy model is equipped with the custom soft delete columns. Here's an example model with custom columns for soft deletion:</p> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    archived = Column(Boolean, default=False)  # Custom soft delete column\n    archived_at = Column(DateTime)  # Custom timestamp column for soft delete\n</code></pre> <p>And a schema necessary to activate the soft delete endpoint:</p> <pre><code>class DeleteMyModelSchema(BaseModel):\n    pass\n</code></pre>"},{"location":"advanced/endpoint/#using-endpointcreator-and-crud_router-with-custom-soft-delete-or-update-columns","title":"Using <code>EndpointCreator</code> and <code>crud_router</code> with Custom Soft Delete or Update Columns","text":"<p>When initializing <code>crud_router</code> or creating a custom <code>EndpointCreator</code>, you can pass the names of your custom soft delete columns through the <code>FastCRUD</code> initialization. This informs FastCRUD which columns to check and update for soft deletion operations.</p> <p>Here's an example of using <code>crud_router</code> with custom soft delete columns:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession\n\napp = FastAPI()\n\n# Assuming async_session is your AsyncSession generator\n# and MyModel is your SQLAlchemy model\n\n# Initialize FastCRUD with custom soft delete columns\nmy_model_crud = FastCRUD(\n    MyModel,\n    is_deleted_column='archived',  # Custom 'is_deleted' column name\n    deleted_at_column='archived_at',  # Custom 'deleted_at' column name\n)\n\n# Setup CRUD router with the FastCRUD instance\napp.include_router(crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=my_model_crud,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n))\n</code></pre> <p>You may also directly pass the names of the columns to <code>crud_router</code> or <code>EndpointCreator</code>:</p> <pre><code>app.include_router(endpoint_creator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    is_deleted_column='archived',\n    deleted_at_column='archived_at',\n))\n</code></pre> <p>This setup ensures that the soft delete functionality within your application utilizes the <code>archived</code> and <code>archived_at</code> columns for marking records as deleted, rather than the default <code>is_deleted</code> and <code>deleted_at</code> fields.</p> <p>By specifying custom column names for soft deletion, you can adapt FastCRUD to fit the design of your database models, providing a flexible solution for handling deleted records in a way that best suits your application's needs.</p> <p>You can also customize your <code>updated_at</code> column:</p> <pre><code>class MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    archived = Column(Boolean, default=False)  # Custom soft delete column\n    archived_at = Column(DateTime)  # Custom timestamp column for soft delete\n    date_updated = Column(DateTime)  # Custom timestamp column for update\n\n\napp.include_router(endpoint_creator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    delete_schema=DeleteMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    is_deleted_column='archived',\n    deleted_at_column='archived_at',\n    updated_at_column='date_updated',\n))\n</code></pre>"},{"location":"advanced/endpoint/#using-filters-in-fastcrud","title":"Using Filters in FastCRUD","text":"<p>FastCRUD provides filtering capabilities, allowing you to filter query results based on various conditions. Filters can be applied to <code>read_multi</code> endpoint. This section explains how to configure and use filters in FastCRUD.</p>"},{"location":"advanced/endpoint/#defining-filters","title":"Defining Filters","text":"<p>Filters are either defined using the <code>FilterConfig</code> class or just passed as a dictionary. This class allows you to specify default filter values and validate filter types. Here's an example of how to define filters for a model:</p> <pre><code>from fastcrud import FilterConfig\n\n# Define filter configuration for a model\nfilter_config = FilterConfig(\n    tier_id=None,  # Default filter value for tier_id\n    name=None,  # Default filter value for name\n)\n</code></pre> <p>And the same thing using a <code>dict</code>: <pre><code>filter_config = {\n    \"tier_id\": None,  # Default filter value for tier_id\n    \"name\": None,  # Default filter value for name\n}\n</code></pre></p> <p>By using <code>FilterConfig</code> you get better error messages.</p>"},{"location":"advanced/endpoint/#applying-filters-to-endpoints","title":"Applying Filters to Endpoints","text":"<p>You can apply filters to your endpoints by passing the <code>filter_config</code> to the <code>crud_router</code> or <code>EndpointCreator</code>. Here's an example:</p> <pre><code>from fastcrud import crud_router\n\nfrom .database import async_session\nfrom .yourmodel.model import YourModel\nfrom .yourmodel.schemas import CreateYourModelSchema, UpdateYourModelSchema\n\n# Apply filters using crud_router\napp.include_router(\n    crud_router(\n        session=async_session,\n        model=YourModel,\n        create_schema=CreateYourModelSchema,\n        update_schema=UpdateYourModelSchema,\n        path=\"/yourmodel\",\n        tags=[\"YourModel\"],\n        filter_config=filter_config,  # Apply the filter configuration\n    ),\n)\n</code></pre>"},{"location":"advanced/endpoint/#using-filters-in-requests","title":"Using Filters in Requests","text":"<p>Once filters are configured, you can use them in your API requests. Filters are passed as query parameters. Here's an example of how to use filters in a request to a paginated endpoint:</p> <pre><code>GET /yourmodel?page=1&amp;itemsPerPage=3&amp;tier_id=1&amp;name=Alice\n</code></pre>"},{"location":"advanced/endpoint/#custom-filter-validation","title":"Custom Filter Validation","text":"<p>The <code>FilterConfig</code> class includes a validator to check filter types. If an invalid filter type is provided, a <code>ValueError</code> is raised. You can customize the validation logic by extending the <code>FilterConfig</code> class:</p> <pre><code>from fastcrud import FilterConfig\nfrom pydantic import ValidationError\n\nclass CustomFilterConfig(FilterConfig):\n    @field_validator(\"filters\")\n    def check_filter_types(cls, filters: dict[str, Any]) -&gt; dict[str, Any]:\n        for key, value in filters.items():\n            if not isinstance(value, (type(None), str, int, float, bool)):\n                raise ValueError(f\"Invalid default value for '{key}': {value}\")\n        return filters\n\ntry:\n    # Example of invalid filter configuration\n    invalid_filter_config = CustomFilterConfig(invalid_field=[])\nexcept ValidationError as e:\n    print(e)\n</code></pre>"},{"location":"advanced/endpoint/#handling-invalid-filter-columns","title":"Handling Invalid Filter Columns","text":"<p>FastCRUD ensures that filters are applied only to valid columns in your model. If an invalid filter column is specified, a <code>ValueError</code> is raised:</p> <pre><code>try:\n    # Example of invalid filter column\n    invalid_filter_config = FilterConfig(non_existent_column=None)\nexcept ValueError as e:\n    print(e)  # Output: Invalid filter column 'non_existent_column': not found in model\n</code></pre>"},{"location":"advanced/endpoint/#conclusion","title":"Conclusion","text":"<p>The <code>EndpointCreator</code> class in FastCRUD offers flexibility and control over CRUD operations and custom endpoint creation. By extending this class or using the <code>included_methods</code> and <code>deleted_methods</code> parameters, you can tailor your API's functionality to your specific requirements, ensuring a more customizable and streamlined experience.</p>"},{"location":"advanced/joins/","title":"Comprehensive Guide to Joins in FastCRUD","text":"<p>FastCRUD simplifies CRUD operations while offering capabilities for handling complex data relationships. This guide thoroughly explores the use of <code>JoinConfig</code> for executing join operations in FastCRUD methods such as <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code>, alongside simplified join techniques for straightforward scenarios.</p>"},{"location":"advanced/joins/#understanding-joinconfig","title":"Understanding <code>JoinConfig</code>","text":"<p><code>JoinConfig</code> is a detailed configuration mechanism for specifying joins between models in FastCRUD queries. It contains the following key attributes:</p> <ul> <li><code>model</code>: The SQLAlchemy model to join.</li> <li><code>join_on</code>: The condition defining how the join connects to other models.</li> <li><code>join_prefix</code>: An optional prefix for the joined columns to avoid column name conflicts.</li> <li><code>schema_to_select</code>: An optional Pydantic schema for selecting specific columns from the joined model.</li> <li><code>join_type</code>: The type of join (e.g., <code>\"left\"</code>, <code>\"inner\"</code>).</li> <li><code>alias</code>: An optional SQLAlchemy <code>AliasedClass</code> for complex scenarios like self-referential joins or multiple joins on the same model.</li> <li><code>filters</code>: An optional dictionary to apply filters directly to the joined model.</li> <li><code>relationship_type</code>: Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Default is <code>\"one-to-one\"</code>.</li> </ul> <p>Tip</p> <p>For <code>\"many-to-many\"</code>, you don't need to pass a <code>relationship_type</code>.</p>"},{"location":"advanced/joins/#applying-joins-in-fastcrud-methods","title":"Applying Joins in FastCRUD Methods","text":"Models - <code>Tier</code>, <code>Department</code>, <code>User</code>, <code>Story</code>, <code>Task</code> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre>"},{"location":"advanced/joins/#the-count-method-with-joins","title":"The <code>count</code> Method with Joins","text":"<p>The <code>count</code> method can be enhanced with join operations to perform complex aggregate queries. While <code>count</code> primarily returns the number of records matching a given condition, introducing joins allows for counting records across related models based on specific relationships and conditions.</p>"},{"location":"advanced/joins/#using-joinconfig","title":"Using <code>JoinConfig</code>","text":"<p>For join requirements, the <code>count</code> method can be invoked with join parameters passed as a list of <code>JoinConfig</code> to the <code>joins_config</code> parameter:</p> <pre><code>from fastcrud import JoinConfig\n\ntask_crud = FastCRUD(Task)\n\n# Count the number of tasks assigned to users in a specific department\ntask_count = await task_crud.count(\n    db=db,\n    joins_config=[\n        JoinConfig(\n            model=User, \n            join_on=Task.assigned_user_id == User.id,\n        ),\n        JoinConfig(\n            model=Department, \n            join_on=User.department_id == Department.id, \n            filters={\"name\": \"Engineering\"},\n        ),\n    ],\n)\n</code></pre>"},{"location":"advanced/joins/#fetching-data-with-get_joined-and-get_multi_joined","title":"Fetching Data with <code>get_joined</code> and <code>get_multi_joined</code>","text":"<p>These methods are essential for retrieving records from a primary model while including related data from one or more joined models. They support both simple and complex joining scenarios, including self-referential joins and many-to-many relationships.</p>"},{"location":"advanced/joins/#simple-joins-using-base-parameters","title":"Simple Joins Using Base Parameters","text":"<p>For simpler join requirements, FastCRUD allows specifying join parameters directly:</p> <ul> <li><code>join_model</code>: The target model to join.</li> <li><code>join_on</code>: The join condition.</li> <li><code>join_prefix</code>: Optional prefix for columns from the joined model.</li> <li><code>join_schema_to_select</code>: An optional Pydantic schema for selecting specific columns from the joined model.</li> <li><code>join_type</code>: Specifies the SQL join type.</li> <li><code>alias</code>: An optional SQLAlchemy <code>AliasedClass</code> for complex scenarios like self-referential joins or multiple joins on the same model.</li> <li><code>join_filters</code>: Additional filters for the joined model.</li> </ul>"},{"location":"advanced/joins/#examples-of-simple-joining","title":"Examples of Simple Joining","text":"<pre><code># Fetch tasks with assigned user details, specifying a left join\ntasks_with_users = await task_crud.get_joined(\n    db=db,\n    join_model=User,\n    join_on=Task.assigned_user_id == User.id,\n    join_type=\"left\",\n)\n</code></pre>"},{"location":"advanced/joins/#getting-joined-data-nested","title":"Getting Joined Data Nested","text":"<p>Note that by default, <code>FastCRUD</code> joins all the data and returns it in a single dictionary.</p> <p>Let's take two of the tables from above and join them with <code>FastCRUD</code>:</p> <pre><code>user_crud = FastCRUD(User)\nuser_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    id=1,\n)\n</code></pre> <p>We'll get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre> <p>If you want the joined data in a nested dictionary instead, you may just pass <code>nest_joins=True</code>:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>And you will get:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre> <p>This works for both <code>get_joined</code> and <code>get_multi_joined</code>.</p> <p>Warning</p> <p>Note that the final <code>\"_\"</code> in the passed <code>\"tier_\"</code> is stripped.</p>"},{"location":"advanced/joins/#complex-joins-using-joinconfig","title":"Complex Joins Using <code>JoinConfig</code>","text":"<p>When dealing with more complex join conditions, such as multiple joins, self-referential joins, or needing to specify aliases and filters, <code>JoinConfig</code> instances become the norm. They offer granular control over each join's aspects, enabling precise and efficient data retrieval.</p> <p>Example:</p> <code>user/schemas.py</code> Excerpt <pre><code>class ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n</code></pre> <pre><code># Fetch users with details from related departments and tiers, using aliases for self-referential joins\nfrom fastcrud import aliased\n\nmanager_alias = aliased(User)\n\nusers = await user_crud.get_multi_joined(\n    db=db,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Department, \n            join_on=User.department_id == Department.id, \n            join_prefix=\"dept_\",\n        ),\n        JoinConfig(\n            model=Tier, \n            join_on=User.tier_id == Tier.id, \n            join_prefix=\"tier_\",\n        ),\n        JoinConfig(\n            model=User, \n            alias=manager_alias, \n            join_on=User.manager_id == manager_alias.id, \n            join_prefix=\"manager_\",\n        ),\n    ],\n)\n</code></pre>"},{"location":"advanced/joins/#handling-one-to-one-and-one-to-many-joins-in-fastcrud","title":"Handling One-to-One and One-to-Many Joins in FastCRUD","text":"<p>FastCRUD provides flexibility in handling one-to-one and one-to-many relationships through <code>get_joined</code> and <code>get_multi_joined</code> methods, along with the ability to specify how joined data should be structured using both the <code>relationship_type</code> (default <code>\"one-to-one\"</code>) and the <code>nest_joins</code> (default <code>False</code>) parameters.</p>"},{"location":"advanced/joins/#one-to-one-relationships","title":"One-to-One Relationships","text":"<ul> <li><code>get_joined</code>: Fetch a single record and its directly associated record (e.g., a user and their profile).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=False</code>): Retrieve multiple records, each linked to a single related record from another table (e.g., users and their profiles).</li> </ul>"},{"location":"advanced/joins/#example","title":"Example","text":"<p>Let's take two of the tables from above and join them with <code>FastCRUD</code>:</p> <pre><code>user_crud = FastCRUD(User)\nuser_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier_id\": 1,\n    \"tier_name\": \"Free\"\n}\n</code></pre>"},{"location":"advanced/joins/#one-to-one-relationship-with-nested-joins","title":"One-to-One Relationship with Nested Joins","text":"<p>To get the joined data in a nested dictionary:</p> <pre><code>user_tier = await user_crud.get_joined(\n    db=db,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example\",\n    \"tier\": {\n        \"id\": 1,\n        \"name\": \"Free\"\n    }\n}\n</code></pre>"},{"location":"advanced/joins/#one-to-many-relationships","title":"One-to-Many Relationships","text":"<ul> <li><code>get_joined</code> (with <code>nest_joins=True</code>): Retrieve a single record with all its related records nested within it (e.g., a user and all their blog posts).</li> <li><code>get_multi_joined</code> (with <code>nest_joins=True</code>): Fetch multiple primary records, each with their related records nested (e.g., multiple users and all their blog posts).</li> </ul> <p>Warning</p> <p>When using <code>nest_joins=True</code>, the performance will always be a bit worse than when using <code>nest_joins=False</code>. For cases where more performance is necessary, consider using <code>nest_joins=False</code> and remodeling your database.</p>"},{"location":"advanced/joins/#example_1","title":"Example","text":"<p>To demonstrate a one-to-many relationship, let's assume <code>Author</code> and <code>Article</code> tables:</p> <pre><code>class Author(Base):\n    __tablename__ = \"author\"\n    id = Column(Integer, primary_key=True)\n    profile_id = Column(Integer, ForeignKey(\"profile.id\"))\n    name = Column(String)\n\n\nclass Article(Base):\n    __tablename__ = \"article\"\n    id = Column(Integer, primary_key=True)\n    author_id = Column(Integer, ForeignKey(\"author.id\"))\n    title = Column(String)\n    content = Column(String)\n</code></pre> <p>Fetch a user and all their posts:</p> <pre><code>author_crud = FastCRUD(Author)\nauthor_articles = await author_crud.get_joined(\n    db=db,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_prefix=\"article_\",\n    join_type=\"left\",\n    nest_joins=True,\n    id=1,\n)\n</code></pre> <p>The result will be:</p> <pre><code>{\n    \"id\": 1,\n    \"name\": \"Example Author\",\n    \"articles\": [\n        {\n            \"id\": 101,\n            \"author_id\": 1,\n            \"title\": \"First Article!\",\n            \"content\": \"First article content\"\n        },\n        {\n            \"id\": 102,\n            \"author_id\": 1,\n            \"title\": \"Second Article?\",\n            \"content\": \"Second article content\"\n        }\n    ]\n}\n</code></pre>"},{"location":"advanced/joins/#many-to-many-relationships-with-get_multi_joined","title":"Many-to-Many Relationships with <code>get_multi_joined</code>","text":"<p>FastCRUD simplifies dealing with many-to-many relationships by allowing easy fetch operations with joined models. Here, we demonstrate using <code>get_multi_joined</code> to handle a many-to-many relationship between <code>Project</code> and <code>Participant</code> models, linked through an association table.</p> <p>Note on Handling Many-to-Many Relationships:</p> <p>When using <code>get_multi_joined</code> for many-to-many relationships, it's essential to maintain a specific order in your <code>joins_config</code>: </p> <ol> <li>First, specify the main table you're querying from.</li> <li>Next, include the association table that links your main table to the other table involved in the many-to-many relationship.</li> <li>Finally, specify the other table that is connected via the association table.</li> </ol> <p>This order ensures that the SQL joins are structured correctly to reflect the many-to-many relationship and retrieve the desired data accurately.</p> <p>Tip</p> <p>Note that the first one can be the model defined in <code>FastCRUD(Model)</code>.</p>"},{"location":"advanced/joins/#scenario","title":"Scenario","text":"<p>Imagine a scenario where projects have multiple participants, and participants can be involved in multiple projects. This many-to-many relationship is facilitated through an association table.</p>"},{"location":"advanced/joins/#models","title":"Models","text":"<p>Our models include <code>Project</code>, <code>Participant</code>, and an association model <code>ProjectsParticipantsAssociation</code>:</p> <pre><code>from sqlalchemy import Column, Integer, String, ForeignKey, Table\nfrom sqlalchemy.orm import declarative_base, relationship\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Project(Base):\n    __tablename__ = 'projects'\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    # Relationship to Participant through the association table\n    participants = relationship(\"Participant\", secondary=projects_participants_association)\n\n\nclass Participant(Base):\n    __tablename__ = 'participants'\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    role = Column(String)\n    # Relationship to Project through the association table\n    projects = relationship(\"Project\", secondary=projects_participants_association)\n\n\n# Association table for the many-to-many relationship\nclass ProjectsParticipantsAssociation(Base):\n    __tablename__ = \"projects_participants_association\"\n    project_id = Column(Integer, ForeignKey(\"projects.id\"), primary_key=True)\n    participant_id = Column(Integer, ForeignKey(\"participants.id\"), primary_key=True)\n</code></pre>"},{"location":"advanced/joins/#fetching-data-with-get_multi_joined","title":"Fetching Data with <code>get_multi_joined</code>","text":"<p>To fetch projects along with their participants, we utilize <code>get_multi_joined</code> with appropriate <code>JoinConfig</code> settings:</p> <pre><code>from fastcrud import FastCRUD, JoinConfig\n\n# Initialize FastCRUD for the Project model\ncrud_project = FastCRUD(Project)\n\n# Define join conditions and configuration\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    ),\n]\n\n# Fetch projects with their participants\nprojects_with_participants = await crud_project.get_multi_joined(\n    db_session, \n    joins_config=joins_config,\n)\n\n# Now, `projects_with_participants['data']` will contain projects along with their participant information.\n</code></pre>"},{"location":"advanced/joins/#example_2","title":"Example","text":"<p>Imagine a scenario where projects have multiple participants, and participants can be involved in multiple projects. This many-to-many relationship is facilitated through an association table.</p> <p>Define the models:</p> <pre><code>class Project(Base):\n    __tablename__ = 'projects'\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n    description = Column(String)\n    participants = relationship(\"Participant\", secondary=projects_participants_association)\n\n\nclass Participant(Base):\n    __tablename__ = 'participants'\n    id = Column(Integer, primary key=True)\n    name = Column(String)\n    role = Column(String)\n    projects = relationship(\"Project\", secondary=projects_participants_association)\n\n\nclass ProjectsParticipantsAssociation(Base):\n    __tablename__ = \"projects_participants_association\"\n    project_id = Column(Integer, ForeignKey(\"projects.id\"), primary key=True)\n    participant_id = Column(Integer, ForeignKey(\"participants.id\"), primary key=True)\n</code></pre> <p>Fetch projects along with their participants:</p> <pre><code>from fastcrud import FastCRUD, JoinConfig\n\ncrud_project = FastCRUD(Project)\n\njoins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_prefix=\"pp_\",\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_prefix=\"participant_\",\n        join_type=\"inner\",\n    )\n]\n\nprojects_with_participants = await crud_project.get_multi_joined(\n    db_session, \n    joins_config=joins_config,\n)\n</code></pre> <p>The result will be:</p> <pre><code>[\n    {\n        \"id\": 1,\n        \"name\": \"Project A\",\n        \"description\": \"Description of Project A\",\n        \"participants\": [\n            {\n                \"id\": 1,\n                \"name\": \"Participant 1\",\n                \"role\": \"Developer\"\n            },\n            {\n                \"id\": 2,\n                \"name\": \"Participant 2\",\n                \"role\": \"Designer\"\n            }\n        ]\n    },\n    {\n        \"id\": 2,\n        \"name\": \"Project B\",\n        \"description\": \"Description of Project B\",\n        \"participants\": [\n            {\n                \"id\": 3,\n                \"name\": \"Participant 3\",\n                \"role\": \"Manager\"\n            },\n            {\n                \"id\": 4,\n                \"name\": \"Participant 4\",\n                \"role\": \"Tester\"\n            }\n        ]\n    }\n]\n</code></pre>"},{"location":"advanced/joins/#practical-tips-for-advanced-joins","title":"Practical Tips for Advanced Joins","text":"<ul> <li>Prefixing: Always use the <code>join_prefix</code> attribute to avoid column name collisions, especially in complex joins involving multiple models or self-referential joins.</li> <li>Aliasing: Utilize the <code>alias</code> attribute for disambiguating joins on the same model or for self-referential joins.</li> <li>Filtering Joined Models: Apply filters directly to joined models using the <code>filters</code> attribute in <code>JoinConfig</code> to refine the data set returned by the query.</li> <li>Ordering Joins: In many-to-many relationships or complex join scenarios, carefully sequence your <code>JoinConfig</code> entries to ensure logical and efficient SQL join construction.</li> </ul>"},{"location":"advanced/joins/#conclusion","title":"Conclusion","text":"<p>FastCRUD's support for join operations enhances the ability to perform complex queries across related models in FastAPI applications. By understanding and utilizing the <code>JoinConfig</code> class within the <code>count</code>, <code>get_joined</code>, and <code>get_multi_joined</code> methods, developers can craft powerful data retrieval queries.</p>"},{"location":"advanced/overview/","title":"Advanced Usage Overview","text":"<p>The Advanced section of our documentation delves into the sophisticated capabilities and features of our application, tailored for users looking to leverage advanced functionalities. This part of our guide aims to unlock deeper insights and efficiencies through more complex use cases and configurations.</p>"},{"location":"advanced/overview/#key-topics","title":"Key Topics","text":""},{"location":"advanced/overview/#1-advanced-filtering-and-searching","title":"1. Advanced Filtering and Searching","text":"<p>Explore how to implement advanced filtering and searching capabilities in your application. This guide covers the use of comparison operators (such as greater than, less than, etc.), pattern matching, and more to perform complex queries.</p> <ul> <li>Advanced Filtering Guide</li> </ul>"},{"location":"advanced/overview/#2-bulk-operations-and-batch-processing","title":"2. Bulk Operations and Batch Processing","text":"<p>Learn how to efficiently handle bulk operations and batch processing. This section provides insights into performing mass updates, deletes, and inserts, optimizing performance for large datasets.</p> <ul> <li>Bulk Operations Guide</li> </ul>"},{"location":"advanced/overview/#3-soft-delete-mechanisms-and-strategies","title":"3. Soft Delete Mechanisms and Strategies","text":"<p>Understand the implementation of soft delete mechanisms within our application. This guide covers configuring and using custom columns for soft deletes, restoring deleted records, and filtering queries to exclude soft-deleted entries.</p> <ul> <li>Soft Delete Strategies Guide</li> </ul>"},{"location":"advanced/overview/#4-advanced-use-of-endpointcreator-and-crud_router","title":"4. Advanced Use of EndpointCreator and crud_router","text":"<p>This topic extends the use of <code>EndpointCreator</code> and <code>crud_router</code> for advanced endpoint management, including creating custom routes, selective method exposure, and integrating soft delete functionalities.</p> <ul> <li>Advanced Endpoint Management Guide</li> </ul>"},{"location":"advanced/overview/#5-using-get_joined-and-get_multi_joined-for-multiple-models","title":"5. Using <code>get_joined</code> and <code>get_multi_joined</code> for multiple models","text":"<p>Explore the use of <code>get_joined</code> and <code>get_multi_joined</code> functions for complex queries that involve joining multiple models, including self-joins and scenarios requiring multiple joins on the same model.</p> <ul> <li>Joining Multiple Models Guide</li> </ul>"},{"location":"advanced/overview/#6-method-chaining-with-select","title":"6. Method Chaining with <code>select</code>","text":"<p>FastCRUD's <code>select</code> method introduces method chaining, allowing for the construction of detailed queries with a focus on precision. It simplifies the process of dynamically applying filters, sorting, and conditions, making it easier to manage complex query requirements.</p> <ul> <li>Method Chaining Guide</li> </ul>"},{"location":"advanced/overview/#7-in-depth-explanation-of-joined-methods","title":"7. In depth explanation of Joined methods","text":"<p>Explore different ways of joining models in FastCRUD with examples and tips.</p> <ul> <li>Joining Models</li> </ul>"},{"location":"advanced/overview/#8-filters-in-automatic-endpoints","title":"8. Filters in Automatic Endpoints","text":"<p>Learn how to add query parameters to your <code>get_multi</code> and <code>get_paginated</code> endpoints.</p> <ul> <li>Filters in Endpoints</li> </ul>"},{"location":"advanced/overview/#prerequisites","title":"Prerequisites","text":"<p>Advanced usage assumes a solid understanding of the basic features and functionalities of our application. Knowledge of FastAPI, SQLAlchemy, and Pydantic is highly recommended to fully grasp the concepts discussed.</p>"},{"location":"api/crud_router/","title":"CRUD Router API Reference","text":"<p><code>crud_router</code> is a utility function for creating and configuring a FastAPI router with CRUD endpoints for a given model.</p>"},{"location":"api/crud_router/#function-definition","title":"Function Definition","text":"<p>Creates and configures a FastAPI router with CRUD endpoints for a given model.</p> <p>This utility function streamlines the process of setting up a router for CRUD operations, using a custom <code>EndpointCreator</code> if provided, and managing dependency injections as well as selective method inclusions or exclusions.</p> <p>Parameters:</p> Name Type Description Default <code>session</code> <code>Callable</code> <p>The SQLAlchemy async session.</p> required <code>model</code> <code>ModelType</code> <p>The SQLAlchemy model.</p> required <code>create_schema</code> <code>Type[CreateSchemaType]</code> <p>Pydantic schema for creating an item.</p> required <code>update_schema</code> <code>Type[UpdateSchemaType]</code> <p>Pydantic schema for updating an item.</p> required <code>crud</code> <code>Optional[FastCRUD]</code> <p>An optional <code>FastCRUD</code> instance. If not provided, uses <code>FastCRUD(model)</code>.</p> <code>None</code> <code>delete_schema</code> <code>Optional[Type[DeleteSchemaType]]</code> <p>Optional Pydantic schema for deleting an item.</p> <code>None</code> <code>path</code> <code>str</code> <p>Base path for the CRUD endpoints.</p> <code>''</code> <code>tags</code> <code>Optional[list[Union[str, Enum]]]</code> <p>Optional list of tags for grouping endpoints in the documentation.</p> <code>None</code> <code>include_in_schema</code> <code>bool</code> <p>Whether to include the created endpoints in the OpenAPI schema.</p> <code>True</code> <code>create_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the create endpoint.</p> <code>[]</code> <code>read_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the read endpoint.</p> <code>[]</code> <code>read_multi_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the read multiple items endpoint.</p> <code>[]</code> <code>update_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the update endpoint.</p> <code>[]</code> <code>delete_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the delete endpoint.</p> <code>[]</code> <code>db_delete_deps</code> <code>Sequence[Callable]</code> <p>Optional list of functions to be injected as dependencies for the hard delete endpoint.</p> <code>[]</code> <code>included_methods</code> <code>Optional[list[str]]</code> <p>Optional list of CRUD methods to include. If <code>None</code>, all methods are included.</p> <code>None</code> <code>deleted_methods</code> <code>Optional[list[str]]</code> <p>Optional list of CRUD methods to exclude.</p> <code>None</code> <code>endpoint_creator</code> <code>Optional[Type[EndpointCreator]]</code> <p>Optional custom class derived from <code>EndpointCreator</code> for advanced customization.</p> <code>None</code> <code>is_deleted_column</code> <code>str</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>'is_deleted'</code> <code>deleted_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>'deleted_at'</code> <code>updated_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>'updated_at'</code> <code>endpoint_names</code> <code>Optional[dict[str, str]]</code> <p>Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types             (<code>\"create\"</code>, <code>\"read\"</code>, <code>\"update\"</code>, <code>\"delete\"</code>, <code>\"db_delete\"</code>, <code>\"read_multi\"</code>), and             values are the custom names to use. Unspecified operations will use default names.</p> <code>None</code> <code>filter_config</code> <code>Optional[Union[FilterConfig, dict]]</code> <p>Optional <code>FilterConfig</code> instance or dictionary to configure filters for the <code>read_multi</code> endpoint.</p> <code>None</code> <code>select_schema</code> <code>Optional[Type[SelectSchemaType]]</code> <p>Optional Pydantic schema for selecting an item.</p> <code>None</code> <p>Returns:</p> Type Description <code>APIRouter</code> <p>Configured <code>APIRouter</code> instance with the CRUD endpoints.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> Models and Schemas Used Below <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteMyModelSchema(BaseModel):\n    pass\n</code></pre> <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>customer/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateCustomerSchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadCustomerSchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateCustomerSchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteCustomerSchema(BaseModel):\n    pass\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>product/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateProductSchema(BaseModel):\n    name: str | None = None\n    price: float | None = None\n\n\nclass ReadProductSchema(BaseModel):\n    id: int\n    name: str | None = None\n    price: float | None = None\n\n\nclass UpdateProductSchema(BaseModel):\n    name: str | None = None\n    price: float | None = None\n\n\nclass DeleteProductSchema(BaseModel):\n    pass\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateOrderSchema(BaseModel):\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass UpdateOrderSchema(BaseModel):\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n\n\nclass DeleteOrderSchema(BaseModel):\n    pass\n</code></pre> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> <p>Basic Setup:</p> <pre><code>mymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n)\n</code></pre> <p>With Custom Dependencies:</p> <pre><code>def get_current_user(token: str = Depends(oauth2_scheme)):\n    # Implement user retrieval logic\n    return ...\n\nuser_router = crud_router(\n    session=async_session,\n    model=User,\n    create_schema=CreateUserSchema,\n    update_schema=UpdateUserSchema,\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n    path=\"/users\",\n    tags=[\"Users\"],\n)\n</code></pre> <p>Adding Delete Endpoints: <pre><code>product_router = crud_router(\n    session=async_session,\n    model=Product,\n    create_schema=CreateProductSchema,\n    update_schema=UpdateProductSchema,\n    delete_schema=DeleteProductSchema,\n    path=\"/products\",\n    tags=[\"Products\"],\n)\n</code></pre></p> <p>Customizing Path and Tags: <pre><code>OrderCRUD = FastCRUD[\n    Order,\n    CreateOrderSchema,\n    UpdateOrderSchema,\n    UpdateOrderSchema,\n    DeleteOrderSchema,\n]\norder_router = crud_router(\n    session=async_session,\n    model=Order,\n    create_schema=CreateOrderSchema,\n    update_schema=UpdateOrderSchema,\n    crud=OrderCRUD(Order),\n    path=\"/orders\",\n    tags=[\"Orders\", \"Sales\"],\n)\n</code></pre></p> <p>Integrating Multiple Models: <pre><code>ProductCRUD = FastCRUD[\n    Product,\n    CreateProductSchema,\n    UpdateProductSchema,\n    UpdateProductSchema,\n    DeleteProductSchema,\n]\nproduct_router = crud_router(\n    session=async_session,\n    model=Product,\n    create_schema=CreateProductSchema,\n    update_schema=UpdateProductSchema,\n    crud=ProductCRUD(Product),\n    path=\"/products\",\n    tags=[\"Inventory\"],\n)\n\nCustomerCRUD = FastCRUD[\n    Customer,\n    CreateCustomerSchema,\n    UpdateCustomerSchema,\n    UpdateCustomerSchema,\n    DeleteCustomerSchema,\n]\ncustomer_router = crud_router(\n    session=async_session,\n    model=Customer,\n    create_schema=CreateCustomerSchema,\n    update_schema=UpdateCustomerSchema,\n    crud=CustomerCRUD(Customer),\n    path=\"/customers\",\n    tags=[\"CRM\"],\n)\n</code></pre></p> <p>With Selective CRUD Methods:</p> <pre><code>MyModelCRUD = FastCRUD[\n    MyModel,\n    CreateMyModelSchema,\n    UpdateMyModelSchema,\n    UpdateMyModelSchema,\n    DeleteMyModelSchema,\n]\n# Only include 'create' and 'read' methods\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=MyModelCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Using a Custom <code>EndpointCreator</code>:</p> <pre><code>class CustomEndpointCreator(EndpointCreator):\n    def _custom_route(self):\n        async def custom_endpoint():\n            # Custom endpoint logic\n            return {\"message\": \"Custom route\"}\n\n        return custom_endpoint\n\n        async def add_routes_to_router(self, ...):\n            # First, add standard CRUD routes\n            super().add_routes_to_router(...)\n\n            # Now, add custom routes\n            self.router.add_api_route(\n                path=\"/custom\",\n                endpoint=self._custom_route(),\n                methods=[\"GET\"],\n                tags=self.tags,\n                # Other parameters as needed\n            )\n\nMyModelCRUD = FastCRUD[\n    MyModel,\n    CreateMyModelSchema,\n    UpdateMyModelSchema,\n    UpdateMyModelSchema,\n    DeleteMyModelSchema,\n]\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    crud=MyModelCRUD(MyModel),\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_creator=CustomEndpointCreator,\n)\n\napp.include_router(mymodel_router)\n</code></pre> <p>Customizing Endpoint Names:</p> <pre><code>task_router = crud_router(\n    session=async_session,\n    model=Task,\n    create_schema=CreateTaskSchema,\n    update_schema=UpdateTaskSchema,\n    path=\"/tasks\",\n    tags=[\"Task Management\"],\n    endpoint_names={\n        \"create\": \"add_task\",\n        \"read\": \"get_task\",\n        \"update\": \"modify_task\",\n        \"delete\": \"remove_task\",\n        \"db_delete\": \"permanently_remove_task\",\n        \"read_multi\": \"list_tasks\",\n    },\n)\n</code></pre> <p>Using <code>FilterConfig</code> with <code>dict</code>:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n)\n# Adds CRUD routes with filtering capabilities\napp.include_router(mymodel_router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> <p>Using <code>FilterConfig</code> with keyword arguments:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import crud_router\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\n\nmymodel_router = crud_router(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(id=None, name=\"default\"),\n)\n# Adds CRUD routes with filtering capabilities\napp.include_router(mymodel_router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> Source code in <code>fastcrud/endpoint/crud_router.py</code> <pre><code>def crud_router(\n    session: Callable,\n    model: ModelType,\n    create_schema: Type[CreateSchemaType],\n    update_schema: Type[UpdateSchemaType],\n    crud: Optional[FastCRUD] = None,\n    delete_schema: Optional[Type[DeleteSchemaType]] = None,\n    path: str = \"\",\n    tags: Optional[list[Union[str, Enum]]] = None,\n    include_in_schema: bool = True,\n    create_deps: Sequence[Callable] = [],\n    read_deps: Sequence[Callable] = [],\n    read_multi_deps: Sequence[Callable] = [],\n    update_deps: Sequence[Callable] = [],\n    delete_deps: Sequence[Callable] = [],\n    db_delete_deps: Sequence[Callable] = [],\n    included_methods: Optional[list[str]] = None,\n    deleted_methods: Optional[list[str]] = None,\n    endpoint_creator: Optional[Type[EndpointCreator]] = None,\n    is_deleted_column: str = \"is_deleted\",\n    deleted_at_column: str = \"deleted_at\",\n    updated_at_column: str = \"updated_at\",\n    endpoint_names: Optional[dict[str, str]] = None,\n    filter_config: Optional[Union[FilterConfig, dict]] = None,\n    select_schema: Optional[Type[SelectSchemaType]] = None,\n) -&gt; APIRouter:\n    \"\"\"\n    Creates and configures a FastAPI router with CRUD endpoints for a given model.\n\n    This utility function streamlines the process of setting up a router for CRUD operations,\n    using a custom `EndpointCreator` if provided, and managing dependency injections as well\n    as selective method inclusions or exclusions.\n\n    Args:\n        session: The SQLAlchemy async session.\n        model: The SQLAlchemy model.\n        create_schema: Pydantic schema for creating an item.\n        update_schema: Pydantic schema for updating an item.\n        crud: An optional `FastCRUD` instance. If not provided, uses `FastCRUD(model)`.\n        delete_schema: Optional Pydantic schema for deleting an item.\n        path: Base path for the CRUD endpoints.\n        tags: Optional list of tags for grouping endpoints in the documentation.\n        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.\n        create_deps: Optional list of functions to be injected as dependencies for the create endpoint.\n        read_deps: Optional list of functions to be injected as dependencies for the read endpoint.\n        read_multi_deps: Optional list of functions to be injected as dependencies for the read multiple items endpoint.\n        update_deps: Optional list of functions to be injected as dependencies for the update endpoint.\n        delete_deps: Optional list of functions to be injected as dependencies for the delete endpoint.\n        db_delete_deps: Optional list of functions to be injected as dependencies for the hard delete endpoint.\n        included_methods: Optional list of CRUD methods to include. If `None`, all methods are included.\n        deleted_methods: Optional list of CRUD methods to exclude.\n        endpoint_creator: Optional custom class derived from `EndpointCreator` for advanced customization.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types\n                        (`\"create\"`, `\"read\"`, `\"update\"`, `\"delete\"`, `\"db_delete\"`, `\"read_multi\"`), and\n                        values are the custom names to use. Unspecified operations will use default names.\n        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.\n        select_schema: Optional Pydantic schema for selecting an item.\n\n    Returns:\n        Configured `APIRouter` instance with the CRUD endpoints.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        ??? example \"Models and Schemas Used Below\"\n\n            ??? example \"`mymodel/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/mymodel/model.py:imports\n                fastcrud/examples/mymodel/model.py:model_simple\n                --8&lt;--\n                ```\n\n            ??? example \"`mymodel/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/mymodel/schemas.py:imports\n                fastcrud/examples/mymodel/schemas.py:createschema\n                fastcrud/examples/mymodel/schemas.py:updateschema\n                fastcrud/examples/mymodel/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`customer/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/model.py:imports\n                fastcrud/examples/customer/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`customer/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/schemas.py:imports\n                fastcrud/examples/customer/schemas.py:createschema\n                fastcrud/examples/customer/schemas.py:readschema\n                fastcrud/examples/customer/schemas.py:updateschema\n                fastcrud/examples/customer/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`product/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/model.py:imports\n                fastcrud/examples/product/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/schemas.py:imports\n                fastcrud/examples/product/schemas.py:createschema\n                fastcrud/examples/product/schemas.py:readschema\n                fastcrud/examples/product/schemas.py:updateschema\n                fastcrud/examples/product/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`order/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/model.py:imports\n                fastcrud/examples/order/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`order/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/schemas.py:imports\n                fastcrud/examples/order/schemas.py:createschema\n                fastcrud/examples/order/schemas.py:readschema\n                fastcrud/examples/order/schemas.py:updateschema\n                fastcrud/examples/order/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`tier/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/model.py:imports\n                fastcrud/examples/tier/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`tier/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/schemas.py:imports\n                fastcrud/examples/tier/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`department/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/model.py:imports\n                fastcrud/examples/department/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`department/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/schemas.py:imports\n                fastcrud/examples/department/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`user/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/model.py:imports\n                fastcrud/examples/user/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`user/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/schemas.py:imports\n                fastcrud/examples/user/schemas.py:createschema\n                fastcrud/examples/user/schemas.py:readschema\n                fastcrud/examples/user/schemas.py:updateschema\n                fastcrud/examples/user/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`story/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/model.py:imports\n                fastcrud/examples/story/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`story/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/schemas.py:imports\n                fastcrud/examples/story/schemas.py:createschema\n                fastcrud/examples/story/schemas.py:readschema\n                fastcrud/examples/story/schemas.py:updateschema\n                fastcrud/examples/story/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`task/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/model.py:imports\n                fastcrud/examples/task/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`task/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/schemas.py:imports\n                fastcrud/examples/task/schemas.py:createschema\n                fastcrud/examples/task/schemas.py:readschema\n                fastcrud/examples/task/schemas.py:updateschema\n                fastcrud/examples/task/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n        Basic Setup:\n\n        ```python\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n        )\n        ```\n\n        With Custom Dependencies:\n\n        ```python\n        def get_current_user(token: str = Depends(oauth2_scheme)):\n            # Implement user retrieval logic\n            return ...\n\n        user_router = crud_router(\n            session=async_session,\n            model=User,\n            create_schema=CreateUserSchema,\n            update_schema=UpdateUserSchema,\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n            path=\"/users\",\n            tags=[\"Users\"],\n        )\n        ```\n\n        Adding Delete Endpoints:\n        ```python\n        product_router = crud_router(\n            session=async_session,\n            model=Product,\n            create_schema=CreateProductSchema,\n            update_schema=UpdateProductSchema,\n            delete_schema=DeleteProductSchema,\n            path=\"/products\",\n            tags=[\"Products\"],\n        )\n        ```\n\n        Customizing Path and Tags:\n        ```python\n        OrderCRUD = FastCRUD[\n            Order,\n            CreateOrderSchema,\n            UpdateOrderSchema,\n            UpdateOrderSchema,\n            DeleteOrderSchema,\n        ]\n        order_router = crud_router(\n            session=async_session,\n            model=Order,\n            create_schema=CreateOrderSchema,\n            update_schema=UpdateOrderSchema,\n            crud=OrderCRUD(Order),\n            path=\"/orders\",\n            tags=[\"Orders\", \"Sales\"],\n        )\n        ```\n\n        Integrating Multiple Models:\n        ```python\n        ProductCRUD = FastCRUD[\n            Product,\n            CreateProductSchema,\n            UpdateProductSchema,\n            UpdateProductSchema,\n            DeleteProductSchema,\n        ]\n        product_router = crud_router(\n            session=async_session,\n            model=Product,\n            create_schema=CreateProductSchema,\n            update_schema=UpdateProductSchema,\n            crud=ProductCRUD(Product),\n            path=\"/products\",\n            tags=[\"Inventory\"],\n        )\n\n        CustomerCRUD = FastCRUD[\n            Customer,\n            CreateCustomerSchema,\n            UpdateCustomerSchema,\n            UpdateCustomerSchema,\n            DeleteCustomerSchema,\n        ]\n        customer_router = crud_router(\n            session=async_session,\n            model=Customer,\n            create_schema=CreateCustomerSchema,\n            update_schema=UpdateCustomerSchema,\n            crud=CustomerCRUD(Customer),\n            path=\"/customers\",\n            tags=[\"CRM\"],\n        )\n        ```\n\n        With Selective CRUD Methods:\n\n        ```python\n        MyModelCRUD = FastCRUD[\n            MyModel,\n            CreateMyModelSchema,\n            UpdateMyModelSchema,\n            UpdateMyModelSchema,\n            DeleteMyModelSchema,\n        ]\n        # Only include 'create' and 'read' methods\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            crud=MyModelCRUD(MyModel),\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Using a Custom `EndpointCreator`:\n\n        ```python\n        class CustomEndpointCreator(EndpointCreator):\n            def _custom_route(self):\n                async def custom_endpoint():\n                    # Custom endpoint logic\n                    return {\"message\": \"Custom route\"}\n\n                return custom_endpoint\n\n                async def add_routes_to_router(self, ...):\n                    # First, add standard CRUD routes\n                    super().add_routes_to_router(...)\n\n                    # Now, add custom routes\n                    self.router.add_api_route(\n                        path=\"/custom\",\n                        endpoint=self._custom_route(),\n                        methods=[\"GET\"],\n                        tags=self.tags,\n                        # Other parameters as needed\n                    )\n\n        MyModelCRUD = FastCRUD[\n            MyModel,\n            CreateMyModelSchema,\n            UpdateMyModelSchema,\n            UpdateMyModelSchema,\n            DeleteMyModelSchema,\n        ]\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            crud=MyModelCRUD(MyModel),\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            endpoint_creator=CustomEndpointCreator,\n        )\n\n        app.include_router(mymodel_router)\n        ```\n\n        Customizing Endpoint Names:\n\n        ```python\n        task_router = crud_router(\n            session=async_session,\n            model=Task,\n            create_schema=CreateTaskSchema,\n            update_schema=UpdateTaskSchema,\n            path=\"/tasks\",\n            tags=[\"Task Management\"],\n            endpoint_names={\n                \"create\": \"add_task\",\n                \"read\": \"get_task\",\n                \"update\": \"modify_task\",\n                \"delete\": \"remove_task\",\n                \"db_delete\": \"permanently_remove_task\",\n                \"read_multi\": \"list_tasks\",\n            },\n        )\n        ```\n\n        Using `FilterConfig` with `dict`:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import crud_router\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n        )\n        # Adds CRUD routes with filtering capabilities\n        app.include_router(mymodel_router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n\n        Using `FilterConfig` with keyword arguments:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import crud_router\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n\n        mymodel_router = crud_router(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(id=None, name=\"default\"),\n        )\n        # Adds CRUD routes with filtering capabilities\n        app.include_router(mymodel_router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n    \"\"\"\n\n    crud = crud or FastCRUD(\n        model=model,\n        is_deleted_column=is_deleted_column,\n        deleted_at_column=deleted_at_column,\n        updated_at_column=updated_at_column,\n    )\n\n    endpoint_creator_class = endpoint_creator or EndpointCreator\n    endpoint_creator_instance = endpoint_creator_class(\n        session=session,\n        model=model,\n        crud=crud,\n        create_schema=create_schema,  # type: ignore\n        update_schema=update_schema,  # type: ignore\n        include_in_schema=include_in_schema,\n        delete_schema=delete_schema,  # type: ignore\n        path=path,\n        tags=tags,\n        is_deleted_column=is_deleted_column,\n        deleted_at_column=deleted_at_column,\n        updated_at_column=updated_at_column,\n        endpoint_names=endpoint_names,\n        filter_config=filter_config,\n        select_schema=select_schema,  # type: ignore\n    )\n\n    endpoint_creator_instance.add_routes_to_router(\n        create_deps=create_deps,\n        read_deps=read_deps,\n        read_multi_deps=read_multi_deps,\n        update_deps=update_deps,\n        delete_deps=delete_deps,\n        db_delete_deps=db_delete_deps,\n        included_methods=included_methods,\n        deleted_methods=deleted_methods,\n    )\n\n    return endpoint_creator_instance.router\n</code></pre>"},{"location":"api/endpoint_creator/","title":"EndpointCreator API Reference","text":"<p><code>EndpointCreator</code> is a class designed to create and register CRUD endpoints for a FastAPI application. It simplifies the process of adding CRUD (Create, Read, Update, Delete) endpoints to a FastAPI router.</p>"},{"location":"api/endpoint_creator/#class-definition","title":"Class Definition","text":"<p>A class to create and register CRUD endpoints for a FastAPI application.</p> <p>This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations, and Pydantic schemas, and allows for custom dependency injection for each endpoint. The method assumes <code>id</code> is the primary key for path parameters.</p> <p>Attributes:</p> Name Type Description <code>session</code> <p>The SQLAlchemy async session.</p> <code>model</code> <p>The SQLAlchemy model.</p> <code>create_schema</code> <p>Pydantic schema for creating an item.</p> <code>update_schema</code> <p>Pydantic schema for updating an item.</p> <code>crud</code> <p>An optional FastCRUD instance. If not provided, uses <code>FastCRUD(model)</code>.</p> <code>include_in_schema</code> <p>Whether to include the created endpoints in the OpenAPI schema.</p> <code>delete_schema</code> <p>Optional Pydantic schema for deleting an item.</p> <code>path</code> <p>Base path for the CRUD endpoints.</p> <code>tags</code> <p>List of tags for grouping endpoints in the documentation.</p> <code>is_deleted_column</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>deleted_at_column</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>updated_at_column</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>endpoint_names</code> <p>Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types             (<code>\"create\"</code>, <code>\"read\"</code>, <code>\"update\"</code>, <code>\"delete\"</code>, <code>\"db_delete\"</code>, <code>\"read_multi\"</code>), and             values are the custom names to use. Unspecified operations will use default names.</p> <code>filter_config</code> <p>Optional <code>FilterConfig</code> instance or dictionary to configure filters for the <code>read_multi</code> endpoint.</p> <code>select_schema</code> <p>Optional Pydantic schema for selecting an item.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> <p>Basic Setup:</p> <code>mymodel/model.py</code> <pre><code>from sqlalchemy import Boolean, Column, DateTime, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass MyModel(Base):\n    __tablename__ = \"my_model\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>mymodel/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateMyModelSchema(BaseModel):\n    name: str | None = None\n\n\nclass UpdateMyModelSchema(BaseModel):\n    name: str | None = None\n</code></pre> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n)\nendpoint_creator.add_routes_to_router()\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n</code></pre> <p>With Custom Dependencies:</p> <pre><code>from fastapi.security import OAuth2PasswordBearer\n\noauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"token\")\n\ndef get_current_user(token: str = Depends(oauth2_scheme)):\n    return ...\n\nendpoint_creator.add_routes_to_router(\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n)\n</code></pre> <p>Selective Endpoint Creation (inclusion):</p> <pre><code># Only create 'create' and 'read' endpoints\nendpoint_creator.add_routes_to_router(\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Selective Endpoint Creation (deletion):</p> <pre><code># Create all but 'update' and 'delete' endpoints\nendpoint_creator.add_routes_to_router(\n    deleted_methods=[\"update\", \"delete\"],\n)\n</code></pre> <p>Integrating with Multiple Models:</p> <pre><code># Assuming definitions for OtherModel, OtherModelCRUD, etc.\n\nother_model_crud = OtherModelCRUD(OtherModel)\nother_endpoint_creator = EndpointCreator(\n    session=async_session,\n    model=OtherModel,\n    create_schema=CreateOtherModelSchema,\n    update_schema=UpdateOtherModelSchema,\n    crud=other_model_crud,\n)\nother_endpoint_creator.add_routes_to_router()\napp.include_router(other_endpoint_creator.router, prefix=\"/othermodel\")\n</code></pre> <p>Customizing Endpoint Names:</p> <pre><code>endpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    path=\"/mymodel\",\n    tags=[\"MyModel\"],\n    endpoint_names={\n        \"create\": \"add\",  # Custom endpoint name for creating items\n        \"read\": \"fetch\",  # Custom endpoint name for reading a single item\n        \"update\": \"change\",  # Custom endpoint name for updating items\n        # The delete operation will use the default name \"delete\"\n    },\n)\nendpoint_creator.add_routes_to_router()\n</code></pre> <p>Using <code>filter_config</code> with <code>dict</code>:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator, FilterConfig\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n)\n# Adds CRUD routes with filtering capabilities\nendpoint_creator.add_routes_to_router()\n# Include the internal router into the FastAPI app\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> <p>Using <code>filter_config</code> with keyword arguments:</p> <pre><code>from fastapi import FastAPI\nfrom fastcrud import EndpointCreator, FilterConfig\n\nfrom .database import async_session\nfrom .mymodel.model import MyModel\nfrom .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\napp = FastAPI()\nendpoint_creator = EndpointCreator(\n    session=async_session,\n    model=MyModel,\n    create_schema=CreateMyModelSchema,\n    update_schema=UpdateMyModelSchema,\n    filter_config=FilterConfig(id=None, name=\"default\"),\n)\n# Adds CRUD routes with filtering capabilities\nendpoint_creator.add_routes_to_router()\n# Include the internal router into the FastAPI app\napp.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n# Explanation:\n# The FilterConfig specifies that 'id' should be a query parameter with no default value\n# and 'name' should be a query parameter with a default value of 'default'.\n# When fetching multiple items, you can filter by these parameters.\n# Example GET request: /mymodel/get_multi?id=1&amp;name=example\n</code></pre> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>class EndpointCreator:\n    \"\"\"\n    A class to create and register CRUD endpoints for a FastAPI application.\n\n    This class simplifies the process of adding create, read, update, and delete (CRUD) endpoints\n    to a FastAPI router. It is initialized with a SQLAlchemy session, model, CRUD operations,\n    and Pydantic schemas, and allows for custom dependency injection for each endpoint.\n    The method assumes `id` is the primary key for path parameters.\n\n    Attributes:\n        session: The SQLAlchemy async session.\n        model: The SQLAlchemy model.\n        create_schema: Pydantic schema for creating an item.\n        update_schema: Pydantic schema for updating an item.\n        crud: An optional FastCRUD instance. If not provided, uses `FastCRUD(model)`.\n        include_in_schema: Whether to include the created endpoints in the OpenAPI schema.\n        delete_schema: Optional Pydantic schema for deleting an item.\n        path: Base path for the CRUD endpoints.\n        tags: List of tags for grouping endpoints in the documentation.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n        endpoint_names: Optional dictionary to customize endpoint names for CRUD operations. Keys are operation types\n                        (`\"create\"`, `\"read\"`, `\"update\"`, `\"delete\"`, `\"db_delete\"`, `\"read_multi\"`), and\n                        values are the custom names to use. Unspecified operations will use default names.\n        filter_config: Optional `FilterConfig` instance or dictionary to configure filters for the `read_multi` endpoint.\n        select_schema: Optional Pydantic schema for selecting an item.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        Basic Setup:\n\n        ??? example \"`mymodel/model.py`\"\n\n            ```python\n            --8&lt;--\n            fastcrud/examples/mymodel/model.py:imports\n            fastcrud/examples/mymodel/model.py:model_simple\n            --8&lt;--\n            ```\n\n        ??? example \"`mymodel/schemas.py`\"\n\n            ```python\n            --8&lt;--\n            fastcrud/examples/mymodel/schemas.py:imports\n            fastcrud/examples/mymodel/schemas.py:createschema\n            fastcrud/examples/mymodel/schemas.py:updateschema\n            --8&lt;--\n            ```\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n        )\n        endpoint_creator.add_routes_to_router()\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n        ```\n\n        With Custom Dependencies:\n\n        ```python\n        from fastapi.security import OAuth2PasswordBearer\n\n        oauth2_scheme = OAuth2PasswordBearer(tokenUrl=\"token\")\n\n        def get_current_user(token: str = Depends(oauth2_scheme)):\n            return ...\n\n        endpoint_creator.add_routes_to_router(\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n        )\n        ```\n\n        Selective Endpoint Creation (inclusion):\n\n        ```python\n        # Only create 'create' and 'read' endpoints\n        endpoint_creator.add_routes_to_router(\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Selective Endpoint Creation (deletion):\n\n        ```python\n        # Create all but 'update' and 'delete' endpoints\n        endpoint_creator.add_routes_to_router(\n            deleted_methods=[\"update\", \"delete\"],\n        )\n        ```\n\n        Integrating with Multiple Models:\n\n        ```python\n        # Assuming definitions for OtherModel, OtherModelCRUD, etc.\n\n        other_model_crud = OtherModelCRUD(OtherModel)\n        other_endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=OtherModel,\n            create_schema=CreateOtherModelSchema,\n            update_schema=UpdateOtherModelSchema,\n            crud=other_model_crud,\n        )\n        other_endpoint_creator.add_routes_to_router()\n        app.include_router(other_endpoint_creator.router, prefix=\"/othermodel\")\n        ```\n\n        Customizing Endpoint Names:\n\n        ```python\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            path=\"/mymodel\",\n            tags=[\"MyModel\"],\n            endpoint_names={\n                \"create\": \"add\",  # Custom endpoint name for creating items\n                \"read\": \"fetch\",  # Custom endpoint name for reading a single item\n                \"update\": \"change\",  # Custom endpoint name for updating items\n                # The delete operation will use the default name \"delete\"\n            },\n        )\n        endpoint_creator.add_routes_to_router()\n        ```\n\n        Using `filter_config` with `dict`:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator, FilterConfig\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(filters={\"id\": None, \"name\": \"default\"}),\n        )\n        # Adds CRUD routes with filtering capabilities\n        endpoint_creator.add_routes_to_router()\n        # Include the internal router into the FastAPI app\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n\n        Using `filter_config` with keyword arguments:\n\n        ```python\n        from fastapi import FastAPI\n        from fastcrud import EndpointCreator, FilterConfig\n\n        from .database import async_session\n        from .mymodel.model import MyModel\n        from .mymodel.schemas import CreateMyModelSchema, UpdateMyModelSchema\n\n        app = FastAPI()\n        endpoint_creator = EndpointCreator(\n            session=async_session,\n            model=MyModel,\n            create_schema=CreateMyModelSchema,\n            update_schema=UpdateMyModelSchema,\n            filter_config=FilterConfig(id=None, name=\"default\"),\n        )\n        # Adds CRUD routes with filtering capabilities\n        endpoint_creator.add_routes_to_router()\n        # Include the internal router into the FastAPI app\n        app.include_router(endpoint_creator.router, prefix=\"/mymodel\")\n\n        # Explanation:\n        # The FilterConfig specifies that 'id' should be a query parameter with no default value\n        # and 'name' should be a query parameter with a default value of 'default'.\n        # When fetching multiple items, you can filter by these parameters.\n        # Example GET request: /mymodel/get_multi?id=1&amp;name=example\n        ```\n    \"\"\"\n\n    def __init__(\n        self,\n        session: Callable,\n        model: ModelType,\n        create_schema: Type[CreateSchemaType],\n        update_schema: Type[UpdateSchemaType],\n        crud: Optional[FastCRUD] = None,\n        include_in_schema: bool = True,\n        delete_schema: Optional[Type[DeleteSchemaType]] = None,\n        path: str = \"\",\n        tags: Optional[list[Union[str, Enum]]] = None,\n        is_deleted_column: str = \"is_deleted\",\n        deleted_at_column: str = \"deleted_at\",\n        updated_at_column: str = \"updated_at\",\n        endpoint_names: Optional[dict[str, str]] = None,\n        filter_config: Optional[Union[FilterConfig, dict]] = None,\n        select_schema: Optional[Type[SelectSchemaType]] = None,\n    ) -&gt; None:\n        self._primary_keys = _get_primary_keys(model)\n        self._primary_keys_types = {\n            pk.name: _get_python_type(pk) for pk in self._primary_keys\n        }\n        self.primary_key_names = [pk.name for pk in self._primary_keys]\n        self.session = session\n        self.crud = crud or FastCRUD(\n            model=model,\n            is_deleted_column=is_deleted_column,\n            deleted_at_column=deleted_at_column,\n            updated_at_column=updated_at_column,\n        )\n        self.model = model\n        self.create_schema = create_schema\n        self.update_schema = update_schema\n        self.delete_schema = delete_schema\n        self.select_schema = select_schema\n        self.include_in_schema = include_in_schema\n        self.path = path\n        self.tags = tags or []\n        self.router = APIRouter()\n        self.is_deleted_column = is_deleted_column\n        self.deleted_at_column = deleted_at_column\n        self.updated_at_column = updated_at_column\n        self.default_endpoint_names = {\n            \"create\": \"\",\n            \"read\": \"\",\n            \"update\": \"\",\n            \"delete\": \"\",\n            \"db_delete\": \"db_delete\",\n            \"read_multi\": \"\",\n        }\n        self.endpoint_names = {**self.default_endpoint_names, **(endpoint_names or {})}\n        if filter_config:\n            if isinstance(filter_config, dict):\n                filter_config = FilterConfig(**filter_config)\n            self._validate_filter_config(filter_config)\n        self.filter_config = filter_config\n        self.column_types = _get_column_types(model)\n\n        if select_schema is not None:\n            self.list_response_model: Optional[Type[ListResponse[Any]]] = type(\n                \"DynamicListResponse\",\n                (ListResponse[BaseModel],),\n                {\"__annotations__\": {\"data\": list[select_schema]}},  # type: ignore\n            )\n            self.paginated_response_model: Optional[\n                Type[PaginatedListResponse[Any]]\n            ] = type(\n                \"DynamicPaginatedResponse\",\n                (PaginatedListResponse[BaseModel],),\n                {\n                    \"__annotations__\": {\n                        \"data\": list[select_schema],  # type: ignore\n                        \"total_count\": int,\n                        \"has_more\": bool,\n                        \"page\": Optional[int],\n                        \"items_per_page\": Optional[int],\n                    }\n                },\n            )\n        else:\n            self.list_response_model = None\n            self.paginated_response_model = None\n\n    def _validate_filter_config(self, filter_config: FilterConfig) -&gt; None:\n        model_columns = self.crud.model_col_names\n        for key in filter_config.filters.keys():\n            if key not in model_columns:\n                raise ValueError(\n                    f\"Invalid filter column '{key}': not found in model '{self.model.__name__}' columns\"\n                )\n\n    def _create_item(self):\n        \"\"\"Creates an endpoint for creating items in the database.\"\"\"\n\n        async def endpoint(\n            db: AsyncSession = Depends(self.session),\n            item: self.create_schema = Body(...),  # type: ignore\n        ):\n            unique_columns = _extract_unique_columns(self.model)\n\n            for column in unique_columns:\n                col_name = column.name\n                if hasattr(item, col_name):\n                    value = getattr(item, col_name)\n                    exists = await self.crud.exists(db, **{col_name: value})\n                    if exists:  # pragma: no cover\n                        raise DuplicateValueException(\n                            f\"Value {value} is already registered\"\n                        )\n\n            return await self.crud.create(db, item)\n\n        return endpoint\n\n    def _read_item(self):\n        \"\"\"Creates an endpoint for reading a single item from the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            if self.select_schema is not None:\n                item = await self.crud.get(\n                    db,\n                    schema_to_select=cast(Type[BaseModel], self.select_schema),\n                    return_as_model=True,\n                    **pkeys,\n                )\n            else:\n                item = await self.crud.get(db, **pkeys)\n            if not item:  # pragma: no cover\n                raise NotFoundException(detail=\"Item not found\")\n            return item  # pragma: no cover\n\n        return endpoint\n\n    def _read_items(self):\n        \"\"\"Creates an endpoint for reading multiple items from the database.\"\"\"\n        dynamic_filters = _create_dynamic_filters(self.filter_config, self.column_types)\n\n        async def endpoint(\n            db: AsyncSession = Depends(self.session),\n            offset: Optional[int] = Query(\n                None, description=\"Offset for unpaginated queries\"\n            ),\n            limit: Optional[int] = Query(\n                None, description=\"Limit for unpaginated queries\"\n            ),\n            page: Optional[int] = Query(None, alias=\"page\", description=\"Page number\"),\n            items_per_page: Optional[int] = Query(\n                None, alias=\"itemsPerPage\", description=\"Number of items per page\"\n            ),\n            filters: dict = Depends(dynamic_filters),\n        ) -&gt; Union[dict[str, Any], PaginatedListResponse, ListResponse]:\n            is_paginated = (page is not None) or (items_per_page is not None)\n            has_offset_limit = (offset is not None) and (limit is not None)\n\n            if is_paginated and has_offset_limit:\n                raise BadRequestException(\n                    detail=\"Conflicting parameters: Use either 'page' and 'itemsPerPage' for paginated results or 'offset' and 'limit' for specific range queries.\"\n                )\n\n            if is_paginated:\n                if not page:\n                    page = 1\n                if not items_per_page:\n                    items_per_page = 10\n                offset = compute_offset(page=page, items_per_page=items_per_page)  # type: ignore\n                limit = items_per_page\n            elif not has_offset_limit:\n                offset = 0\n                limit = 100\n\n            if self.select_schema is not None:\n                crud_data = await self.crud.get_multi(\n                    db,\n                    offset=offset,  # type: ignore\n                    limit=limit,  # type: ignore\n                    schema_to_select=self.select_schema,\n                    return_as_model=True,\n                    **filters,\n                )\n            else:\n                crud_data = await self.crud.get_multi(\n                    db,\n                    offset=offset,  # type: ignore\n                    limit=limit,  # type: ignore\n                    **filters,\n                )\n\n            if is_paginated:\n                return paginated_response(\n                    crud_data=crud_data,\n                    page=page,  # type: ignore\n                    items_per_page=items_per_page,  # type: ignore\n                )\n\n            if not has_offset_limit:\n                offset = 0\n                limit = 100\n\n            crud_data = await self.crud.get_multi(\n                db,\n                offset=offset,  # type: ignore\n                limit=limit,  # type: ignore\n                **filters,\n            )\n            return crud_data  # pragma: no cover\n\n        return endpoint\n\n    def _update_item(self):\n        \"\"\"Creates an endpoint for updating an existing item in the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(\n            item: self.update_schema = Body(...),  # type: ignore\n            db: AsyncSession = Depends(self.session),\n            **pkeys,\n        ):\n            return await self.crud.update(db, item, **pkeys)\n\n        return endpoint\n\n    def _delete_item(self):\n        \"\"\"Creates an endpoint for deleting an item from the database.\"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            await self.crud.delete(db, **pkeys)\n            return {\"message\": \"Item deleted successfully\"}  # pragma: no cover\n\n        return endpoint\n\n    def _db_delete(self):\n        \"\"\"\n        Creates an endpoint for hard deleting an item from the database.\n\n        This endpoint is only added if the `delete_schema` is provided during initialization.\n        The endpoint expects an item ID as a path parameter and uses the provided SQLAlchemy\n        async session to permanently delete the item from the database.\n        \"\"\"\n\n        @_apply_model_pk(**self._primary_keys_types)\n        async def endpoint(db: AsyncSession = Depends(self.session), **pkeys):\n            await self.crud.db_delete(db, **pkeys)\n            return {\n                \"message\": \"Item permanently deleted from the database\"\n            }  # pragma: no cover\n\n        return endpoint\n\n    def _get_endpoint_path(self, operation: str):\n        endpoint_name = self.endpoint_names.get(\n            operation, self.default_endpoint_names.get(operation, operation)\n        )\n        path = f\"{self.path}/{endpoint_name}\" if endpoint_name else self.path\n\n        if operation in {\"read\", \"update\", \"delete\", \"db_delete\"}:\n            _primary_keys_path_suffix = \"/\".join(\n                f\"{{{n}}}\" for n in self.primary_key_names\n            )\n            path = f\"{path}/{_primary_keys_path_suffix}\"\n\n        return path\n\n    def add_routes_to_router(\n        self,\n        create_deps: Sequence[Callable] = [],\n        read_deps: Sequence[Callable] = [],\n        read_multi_deps: Sequence[Callable] = [],\n        update_deps: Sequence[Callable] = [],\n        delete_deps: Sequence[Callable] = [],\n        db_delete_deps: Sequence[Callable] = [],\n        included_methods: Optional[Sequence[str]] = None,\n        deleted_methods: Optional[Sequence[str]] = None,\n    ):\n        \"\"\"\n        Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.\n\n        This method registers routes for create, read, update, and delete operations with the FastAPI router,\n        allowing for custom dependency injection for each type of operation.\n\n        Args:\n            create_deps: List of functions to be injected as dependencies for the create endpoint.\n            read_deps: List of functions to be injected as dependencies for the read endpoint.\n            read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.\n            update_deps: List of functions to be injected as dependencies for the update endpoint.\n            delete_deps: List of functions to be injected as dependencies for the delete endpoint.\n            db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.\n            included_methods: Optional list of methods to include. Defaults to all CRUD methods.\n            deleted_methods: Optional list of methods to exclude. Defaults to `None`.\n\n        Raises:\n            ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n        Examples:\n            Selective Endpoint Creation:\n\n            ```python\n            # Only create 'create' and 'read' endpoints\n            endpoint_creator.add_routes_to_router(\n                included_methods=[\"create\", \"read\"],\n            )\n            ```\n\n            Excluding Specific Endpoints:\n\n            ```python\n            # Create all endpoints except 'delete' and 'db_delete'\n            endpoint_creator.add_routes_to_router(\n                deleted_methods=[\"delete\", \"db_delete\"],\n            )\n            ```\n\n            With Custom Dependencies and Selective Endpoints:\n\n            ```python\n            def get_current_user(...):\n                ...\n\n            # Create only 'read' and 'update' endpoints with custom dependencies\n            endpoint_creator.add_routes_to_router(\n                read_deps=[get_current_user],\n                update_deps=[get_current_user],\n                included_methods=[\"read\", \"update\"],\n            )\n            ```\n\n        Note:\n            This method should be called to register the endpoints with the FastAPI application.\n            If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.\n            This method assumes `id` is the primary key for path parameters.\n        \"\"\"\n        if (included_methods is not None) and (deleted_methods is not None):\n            raise ValueError(\n                \"Cannot use both 'included_methods' and 'deleted_methods' simultaneously.\"\n            )\n\n        if included_methods is None:\n            included_methods = [\n                \"create\",\n                \"read\",\n                \"read_multi\",\n                \"update\",\n                \"delete\",\n                \"db_delete\",\n            ]\n        else:\n            try:\n                included_methods = CRUDMethods(\n                    valid_methods=included_methods\n                ).valid_methods\n            except ValidationError as e:\n                raise ValueError(f\"Invalid CRUD methods in included_methods: {e}\")\n\n        if deleted_methods is None:\n            deleted_methods = []\n        else:\n            try:\n                deleted_methods = CRUDMethods(\n                    valid_methods=deleted_methods\n                ).valid_methods\n            except ValidationError as e:\n                raise ValueError(f\"Invalid CRUD methods in deleted_methods: {e}\")\n\n        delete_description = \"Delete a\"\n        if self.delete_schema:\n            delete_description = \"Soft delete a\"\n\n        if (\"create\" in included_methods) and (\"create\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"create\"),\n                self._create_item(),\n                methods=[\"POST\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(create_deps),\n                description=f\"Create a new {self.model.__name__} row in the database.\",\n            )\n\n        if (\"read\" in included_methods) and (\"read\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"read\"),\n                self._read_item(),\n                methods=[\"GET\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(read_deps),\n                response_model=self.select_schema if self.select_schema else None,\n                description=f\"Read a single {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\"read_multi\" in included_methods) and (\"read_multi\" not in deleted_methods):\n            if self.select_schema is not None:\n                response_model: Optional[\n                    Type[Union[PaginatedListResponse[Any], ListResponse[Any]]]\n                ] = Union[\n                    self.paginated_response_model,  # type: ignore\n                    self.list_response_model,  # type: ignore\n                ]\n            else:\n                response_model = None\n\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"read_multi\"),\n                self._read_items(),\n                methods=[\"GET\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(read_multi_deps),\n                response_model=response_model,\n                description=(\n                    f\"Read multiple {self.model.__name__} rows from the database.\\n\\n\"\n                    f\"- Use page &amp; itemsPerPage for paginated results\\n\"\n                    f\"- Use offset &amp; limit for specific ranges\\n\"\n                    f\"- Returns paginated response when using page/itemsPerPage\\n\"\n                    f\"- Returns simple list response when using offset/limit\"\n                ),\n            )\n\n        if (\"update\" in included_methods) and (\"update\" not in deleted_methods):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"update\"),\n                self._update_item(),\n                methods=[\"PATCH\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(update_deps),\n                description=f\"Update an existing {self.model.__name__} row in the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\"delete\" in included_methods) and (\"delete\" not in deleted_methods):\n            path = self._get_endpoint_path(operation=\"delete\")\n            self.router.add_api_route(\n                path,\n                self._delete_item(),\n                methods=[\"DELETE\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(delete_deps),\n                description=f\"{delete_description} {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n        if (\n            (\"db_delete\" in included_methods)\n            and (\"db_delete\" not in deleted_methods)\n            and self.delete_schema\n        ):\n            self.router.add_api_route(\n                self._get_endpoint_path(operation=\"db_delete\"),\n                self._db_delete(),\n                methods=[\"DELETE\"],\n                include_in_schema=self.include_in_schema,\n                tags=self.tags,\n                dependencies=_inject_dependencies(db_delete_deps),\n                description=f\"Permanently delete a {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n            )\n\n    def add_custom_route(\n        self,\n        endpoint: Callable,\n        methods: Optional[Union[set[str], list[str]]],\n        path: Optional[str] = None,\n        dependencies: Optional[Sequence[Callable]] = None,\n        include_in_schema: bool = True,\n        tags: Optional[list[Union[str, Enum]]] = None,\n        summary: Optional[str] = None,\n        description: Optional[str] = None,\n        response_description: str = \"Successful Response\",\n    ) -&gt; None:\n        \"\"\"\n        Adds a custom route to the FastAPI router.\n\n        Args:\n            endpoint: The endpoint function to execute when the route is called.\n            methods: A list of HTTP methods for the route (e.g., `['GET', 'POST']`).\n            path: URL path for the custom route.\n            dependencies: A list of functions to be injected as dependencies for the route.\n            include_in_schema: Whether to include this route in the OpenAPI schema.\n            tags: Tags for grouping and categorizing the route in documentation.\n            summary: A short summary of the route, for documentation.\n            description: A detailed description of the route, for documentation.\n            response_description: A description of the response, for documentation.\n\n        Example:\n            ```python\n            async def custom_endpoint(foo: int, bar: str):\n                # custom logic here\n                return {\"foo\": foo, \"bar\": bar}\n\n            endpoint_creator.add_custom_route(\n                endpoint=custom_endpoint,\n                methods=[\"GET\"],\n                path=\"/custom\",\n                tags=[\"custom\"],\n                summary=\"Custom Endpoint\",\n                description=\"This is a custom endpoint.\",\n            )\n            ```\n        \"\"\"\n        path = path or self.path\n        full_path = f\"{self.path}{path}\"\n        self.router.add_api_route(\n            path=full_path,\n            endpoint=endpoint,\n            methods=methods,\n            dependencies=_inject_dependencies(dependencies) or [],\n            include_in_schema=include_in_schema,\n            tags=tags or self.tags,\n            summary=summary,\n            description=description,\n            response_description=response_description,\n        )\n</code></pre>"},{"location":"api/endpoint_creator/#fastcrud.EndpointCreator.add_custom_route","title":"<code>add_custom_route(endpoint, methods, path=None, dependencies=None, include_in_schema=True, tags=None, summary=None, description=None, response_description='Successful Response')</code>","text":"<p>Adds a custom route to the FastAPI router.</p> <p>Parameters:</p> Name Type Description Default <code>endpoint</code> <code>Callable</code> <p>The endpoint function to execute when the route is called.</p> required <code>methods</code> <code>Optional[Union[set[str], list[str]]]</code> <p>A list of HTTP methods for the route (e.g., <code>['GET', 'POST']</code>).</p> required <code>path</code> <code>Optional[str]</code> <p>URL path for the custom route.</p> <code>None</code> <code>dependencies</code> <code>Optional[Sequence[Callable]]</code> <p>A list of functions to be injected as dependencies for the route.</p> <code>None</code> <code>include_in_schema</code> <code>bool</code> <p>Whether to include this route in the OpenAPI schema.</p> <code>True</code> <code>tags</code> <code>Optional[list[Union[str, Enum]]]</code> <p>Tags for grouping and categorizing the route in documentation.</p> <code>None</code> <code>summary</code> <code>Optional[str]</code> <p>A short summary of the route, for documentation.</p> <code>None</code> <code>description</code> <code>Optional[str]</code> <p>A detailed description of the route, for documentation.</p> <code>None</code> <code>response_description</code> <code>str</code> <p>A description of the response, for documentation.</p> <code>'Successful Response'</code> Example <pre><code>async def custom_endpoint(foo: int, bar: str):\n    # custom logic here\n    return {\"foo\": foo, \"bar\": bar}\n\nendpoint_creator.add_custom_route(\n    endpoint=custom_endpoint,\n    methods=[\"GET\"],\n    path=\"/custom\",\n    tags=[\"custom\"],\n    summary=\"Custom Endpoint\",\n    description=\"This is a custom endpoint.\",\n)\n</code></pre> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>def add_custom_route(\n    self,\n    endpoint: Callable,\n    methods: Optional[Union[set[str], list[str]]],\n    path: Optional[str] = None,\n    dependencies: Optional[Sequence[Callable]] = None,\n    include_in_schema: bool = True,\n    tags: Optional[list[Union[str, Enum]]] = None,\n    summary: Optional[str] = None,\n    description: Optional[str] = None,\n    response_description: str = \"Successful Response\",\n) -&gt; None:\n    \"\"\"\n    Adds a custom route to the FastAPI router.\n\n    Args:\n        endpoint: The endpoint function to execute when the route is called.\n        methods: A list of HTTP methods for the route (e.g., `['GET', 'POST']`).\n        path: URL path for the custom route.\n        dependencies: A list of functions to be injected as dependencies for the route.\n        include_in_schema: Whether to include this route in the OpenAPI schema.\n        tags: Tags for grouping and categorizing the route in documentation.\n        summary: A short summary of the route, for documentation.\n        description: A detailed description of the route, for documentation.\n        response_description: A description of the response, for documentation.\n\n    Example:\n        ```python\n        async def custom_endpoint(foo: int, bar: str):\n            # custom logic here\n            return {\"foo\": foo, \"bar\": bar}\n\n        endpoint_creator.add_custom_route(\n            endpoint=custom_endpoint,\n            methods=[\"GET\"],\n            path=\"/custom\",\n            tags=[\"custom\"],\n            summary=\"Custom Endpoint\",\n            description=\"This is a custom endpoint.\",\n        )\n        ```\n    \"\"\"\n    path = path or self.path\n    full_path = f\"{self.path}{path}\"\n    self.router.add_api_route(\n        path=full_path,\n        endpoint=endpoint,\n        methods=methods,\n        dependencies=_inject_dependencies(dependencies) or [],\n        include_in_schema=include_in_schema,\n        tags=tags or self.tags,\n        summary=summary,\n        description=description,\n        response_description=response_description,\n    )\n</code></pre>"},{"location":"api/endpoint_creator/#fastcrud.EndpointCreator.add_routes_to_router","title":"<code>add_routes_to_router(create_deps=[], read_deps=[], read_multi_deps=[], update_deps=[], delete_deps=[], db_delete_deps=[], included_methods=None, deleted_methods=None)</code>","text":"<p>Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.</p> <p>This method registers routes for create, read, update, and delete operations with the FastAPI router, allowing for custom dependency injection for each type of operation.</p> <p>Parameters:</p> Name Type Description Default <code>create_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the create endpoint.</p> <code>[]</code> <code>read_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the read endpoint.</p> <code>[]</code> <code>read_multi_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the read multiple items endpoint.</p> <code>[]</code> <code>update_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the update endpoint.</p> <code>[]</code> <code>delete_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the delete endpoint.</p> <code>[]</code> <code>db_delete_deps</code> <code>Sequence[Callable]</code> <p>List of functions to be injected as dependencies for the hard delete endpoint.</p> <code>[]</code> <code>included_methods</code> <code>Optional[Sequence[str]]</code> <p>Optional list of methods to include. Defaults to all CRUD methods.</p> <code>None</code> <code>deleted_methods</code> <code>Optional[Sequence[str]]</code> <p>Optional list of methods to exclude. Defaults to <code>None</code>.</p> <code>None</code> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both <code>included_methods</code> and <code>deleted_methods</code> are provided.</p> <p>Examples:</p> <p>Selective Endpoint Creation:</p> <pre><code># Only create 'create' and 'read' endpoints\nendpoint_creator.add_routes_to_router(\n    included_methods=[\"create\", \"read\"],\n)\n</code></pre> <p>Excluding Specific Endpoints:</p> <pre><code># Create all endpoints except 'delete' and 'db_delete'\nendpoint_creator.add_routes_to_router(\n    deleted_methods=[\"delete\", \"db_delete\"],\n)\n</code></pre> <p>With Custom Dependencies and Selective Endpoints:</p> <pre><code>def get_current_user(...):\n    ...\n\n# Create only 'read' and 'update' endpoints with custom dependencies\nendpoint_creator.add_routes_to_router(\n    read_deps=[get_current_user],\n    update_deps=[get_current_user],\n    included_methods=[\"read\", \"update\"],\n)\n</code></pre> Note <p>This method should be called to register the endpoints with the FastAPI application. If <code>delete_schema</code> is provided on class instantiation, a hard delete endpoint is also registered. This method assumes <code>id</code> is the primary key for path parameters.</p> Source code in <code>fastcrud/endpoint/endpoint_creator.py</code> <pre><code>def add_routes_to_router(\n    self,\n    create_deps: Sequence[Callable] = [],\n    read_deps: Sequence[Callable] = [],\n    read_multi_deps: Sequence[Callable] = [],\n    update_deps: Sequence[Callable] = [],\n    delete_deps: Sequence[Callable] = [],\n    db_delete_deps: Sequence[Callable] = [],\n    included_methods: Optional[Sequence[str]] = None,\n    deleted_methods: Optional[Sequence[str]] = None,\n):\n    \"\"\"\n    Adds CRUD operation routes to the FastAPI router with specified dependencies for each type of operation.\n\n    This method registers routes for create, read, update, and delete operations with the FastAPI router,\n    allowing for custom dependency injection for each type of operation.\n\n    Args:\n        create_deps: List of functions to be injected as dependencies for the create endpoint.\n        read_deps: List of functions to be injected as dependencies for the read endpoint.\n        read_multi_deps: List of functions to be injected as dependencies for the read multiple items endpoint.\n        update_deps: List of functions to be injected as dependencies for the update endpoint.\n        delete_deps: List of functions to be injected as dependencies for the delete endpoint.\n        db_delete_deps: List of functions to be injected as dependencies for the hard delete endpoint.\n        included_methods: Optional list of methods to include. Defaults to all CRUD methods.\n        deleted_methods: Optional list of methods to exclude. Defaults to `None`.\n\n    Raises:\n        ValueError: If both `included_methods` and `deleted_methods` are provided.\n\n    Examples:\n        Selective Endpoint Creation:\n\n        ```python\n        # Only create 'create' and 'read' endpoints\n        endpoint_creator.add_routes_to_router(\n            included_methods=[\"create\", \"read\"],\n        )\n        ```\n\n        Excluding Specific Endpoints:\n\n        ```python\n        # Create all endpoints except 'delete' and 'db_delete'\n        endpoint_creator.add_routes_to_router(\n            deleted_methods=[\"delete\", \"db_delete\"],\n        )\n        ```\n\n        With Custom Dependencies and Selective Endpoints:\n\n        ```python\n        def get_current_user(...):\n            ...\n\n        # Create only 'read' and 'update' endpoints with custom dependencies\n        endpoint_creator.add_routes_to_router(\n            read_deps=[get_current_user],\n            update_deps=[get_current_user],\n            included_methods=[\"read\", \"update\"],\n        )\n        ```\n\n    Note:\n        This method should be called to register the endpoints with the FastAPI application.\n        If `delete_schema` is provided on class instantiation, a hard delete endpoint is also registered.\n        This method assumes `id` is the primary key for path parameters.\n    \"\"\"\n    if (included_methods is not None) and (deleted_methods is not None):\n        raise ValueError(\n            \"Cannot use both 'included_methods' and 'deleted_methods' simultaneously.\"\n        )\n\n    if included_methods is None:\n        included_methods = [\n            \"create\",\n            \"read\",\n            \"read_multi\",\n            \"update\",\n            \"delete\",\n            \"db_delete\",\n        ]\n    else:\n        try:\n            included_methods = CRUDMethods(\n                valid_methods=included_methods\n            ).valid_methods\n        except ValidationError as e:\n            raise ValueError(f\"Invalid CRUD methods in included_methods: {e}\")\n\n    if deleted_methods is None:\n        deleted_methods = []\n    else:\n        try:\n            deleted_methods = CRUDMethods(\n                valid_methods=deleted_methods\n            ).valid_methods\n        except ValidationError as e:\n            raise ValueError(f\"Invalid CRUD methods in deleted_methods: {e}\")\n\n    delete_description = \"Delete a\"\n    if self.delete_schema:\n        delete_description = \"Soft delete a\"\n\n    if (\"create\" in included_methods) and (\"create\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"create\"),\n            self._create_item(),\n            methods=[\"POST\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(create_deps),\n            description=f\"Create a new {self.model.__name__} row in the database.\",\n        )\n\n    if (\"read\" in included_methods) and (\"read\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"read\"),\n            self._read_item(),\n            methods=[\"GET\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(read_deps),\n            response_model=self.select_schema if self.select_schema else None,\n            description=f\"Read a single {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\"read_multi\" in included_methods) and (\"read_multi\" not in deleted_methods):\n        if self.select_schema is not None:\n            response_model: Optional[\n                Type[Union[PaginatedListResponse[Any], ListResponse[Any]]]\n            ] = Union[\n                self.paginated_response_model,  # type: ignore\n                self.list_response_model,  # type: ignore\n            ]\n        else:\n            response_model = None\n\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"read_multi\"),\n            self._read_items(),\n            methods=[\"GET\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(read_multi_deps),\n            response_model=response_model,\n            description=(\n                f\"Read multiple {self.model.__name__} rows from the database.\\n\\n\"\n                f\"- Use page &amp; itemsPerPage for paginated results\\n\"\n                f\"- Use offset &amp; limit for specific ranges\\n\"\n                f\"- Returns paginated response when using page/itemsPerPage\\n\"\n                f\"- Returns simple list response when using offset/limit\"\n            ),\n        )\n\n    if (\"update\" in included_methods) and (\"update\" not in deleted_methods):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"update\"),\n            self._update_item(),\n            methods=[\"PATCH\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(update_deps),\n            description=f\"Update an existing {self.model.__name__} row in the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\"delete\" in included_methods) and (\"delete\" not in deleted_methods):\n        path = self._get_endpoint_path(operation=\"delete\")\n        self.router.add_api_route(\n            path,\n            self._delete_item(),\n            methods=[\"DELETE\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(delete_deps),\n            description=f\"{delete_description} {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n\n    if (\n        (\"db_delete\" in included_methods)\n        and (\"db_delete\" not in deleted_methods)\n        and self.delete_schema\n    ):\n        self.router.add_api_route(\n            self._get_endpoint_path(operation=\"db_delete\"),\n            self._db_delete(),\n            methods=[\"DELETE\"],\n            include_in_schema=self.include_in_schema,\n            tags=self.tags,\n            dependencies=_inject_dependencies(db_delete_deps),\n            description=f\"Permanently delete a {self.model.__name__} row from the database by its primary keys: {self.primary_key_names}.\",\n        )\n</code></pre>"},{"location":"api/fastcrud/","title":"FastCRUD API Reference","text":"<p><code>FastCRUD</code> is a base class for CRUD operations on a model, utilizing Pydantic schemas for data validation and serialization.</p>"},{"location":"api/fastcrud/#class-definition","title":"Class Definition","text":"<p>             Bases: <code>Generic[ModelType, CreateSchemaType, UpdateSchemaType, UpdateSchemaInternalType, DeleteSchemaType, SelectSchemaType]</code></p> <p>Base class for CRUD operations on a model.</p> <p>This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model, utilizing Pydantic schemas for data validation and serialization.</p> <p>Parameters:</p> Name Type Description Default <code>model</code> <code>type[ModelType]</code> <p>The SQLAlchemy model type.</p> required <code>is_deleted_column</code> <code>str</code> <p>Optional column name to use for indicating a soft delete. Defaults to <code>\"is_deleted\"</code>.</p> <code>'is_deleted'</code> <code>deleted_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of a soft delete. Defaults to <code>\"deleted_at\"</code>.</p> <code>'deleted_at'</code> <code>updated_at_column</code> <code>str</code> <p>Optional column name to use for storing the timestamp of an update. Defaults to <code>\"updated_at\"</code>.</p> <code>'updated_at'</code> <p>Methods:</p> Name Description <code>create</code> <p>Creates a new record in the database from the provided Pydantic schema.</p> <code>select</code> <p>Generates a SQL Alchemy <code>Select</code> statement with optional filtering and sorting.</p> <code>get</code> <p>Retrieves a single record based on filters. Supports advanced filtering through comparison operators like <code>__gt</code>, <code>__lt</code>, etc.</p> <code>exists</code> <p>Checks if a record exists based on the provided filters.</p> <code>count</code> <p>Counts the number of records matching the provided filters.</p> <code>get_multi</code> <p>Fetches multiple records with optional sorting, pagination, and model conversion.</p> <code>get_joined</code> <p>Performs a join operation with another model, supporting custom join conditions and selection of specific columns.</p> <code>get_multi_joined</code> <p>Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.</p> <code>get_multi_by_cursor</code> <p>Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.</p> <code>update</code> <p>Updates an existing record or multiple records based on specified filters.</p> <code>db_delete</code> <p>Hard deletes a record or multiple records from the database based on provided filters.</p> <code>delete</code> <p>Soft deletes a record if it has an <code>\"is_deleted\"</code> attribute (or other attribute as defined by <code>is_deleted_column</code>); otherwise, performs a hard delete.</p> <p>Examples:</p> Models and Schemas Used Below <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>product/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadProductSchema(BaseModel):\n    id: int\n    name: str | None = None\n    price: float | None = None\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n</code></pre> <code>tier/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Tier(Base):\n    __tablename__ = \"tier\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String, unique=True)\n</code></pre> <code>tier/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadTierSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>department/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Department(Base):\n    __tablename__ = \"department\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>department/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadDepartmentSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>user/model.py</code> <pre><code>from sqlalchemy import (\n    Boolean,\n    Column,\n    DateTime,\n    ForeignKey,\n    Integer,\n    String,\n    func,\n)\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    username = Column(String)\n    email = Column(String)\n    age = Column(Integer)\n    role = Column(String)\n    tier_id = Column(Integer, ForeignKey(\"tier.id\"))\n    department_id = Column(Integer, ForeignKey(\"department.id\"))\n    manager_id = Column(Integer, ForeignKey(\"user.id\"))\n    is_active = Column(Boolean, default=True)\n    is_superuser = Column(Boolean, default=False)\n    registration_date = Column(DateTime, default=func.now())\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n</code></pre> <code>user/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass ReadUserSchema(BaseModel):\n    id: int\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool\n    is_superuser: bool\n    registration_date: datetime.datetime\n    archived: bool\n    archived_at: datetime.datetime | None = None\n\n\nclass UpdateUserSchema(BaseModel):\n    name: str | None = None\n    username: str | None = None\n    email: str | None = None\n    age: int | None = None\n    role: str | None = None\n    tier_id: int | None = None\n    department_id: int | None = None\n    manager_id: int | None = None\n    is_active: bool | None = None\n    is_superuser: bool | None = None\n\n\nclass DeleteUserSchema(BaseModel):\n    pass\n</code></pre> <code>story/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Story(Base):\n    __tablename__ = \"story\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>story/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass ReadStorySchema(BaseModel):\n    id: int\n    name: str | None = None\n\n\nclass UpdateStorySchema(BaseModel):\n    name: str | None = None\n\n\nclass DeleteStorySchema(BaseModel):\n    pass\n</code></pre> <code>task/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Task(Base):\n    __tablename__ = \"task\"\n    id = Column(Integer, primary_key=True)\n    creator_id = Column(Integer, ForeignKey(\"user.id\"))\n    owner_id = Column(Integer, ForeignKey(\"user.id\"))\n    assigned_user_id = Column(Integer, ForeignKey(\"user.id\"))\n    story_id = Column(Integer, ForeignKey(\"story.id\"))\n    status = Column(String)\n    priority = Column(String)\n</code></pre> <code>task/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass CreateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass ReadTaskSchema(BaseModel):\n    id: int\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass UpdateTaskSchema(BaseModel):\n    creator_id: int | None = None\n    owner_id: int | None = None\n    assigned_user_id: int | None = None\n    story_id: int | None = None\n    status: str | None = None\n    priority: str | None = None\n\n\nclass DeleteTaskSchema(BaseModel):\n    pass\n</code></pre> <code>profile/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Profile(Base):\n    __tablename__ = \"profile\"\n    id = Column(Integer, primary_key=True)\n    bio = Column(String)\n</code></pre> <code>profile/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadProfileSchema(BaseModel):\n    id: int\n    bio: str | None = None\n</code></pre> <code>author/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Author(Base):\n    __tablename__ = \"author\"\n    id = Column(Integer, primary_key=True)\n    profile_id = Column(Integer, ForeignKey(\"profile.id\"))\n    name = Column(String)\n</code></pre> <code>author/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadAuthorSchema(BaseModel):\n    id: int\n    profile_id: int | None = None\n    name: str | None = None\n</code></pre> <code>article/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Article(Base):\n    __tablename__ = \"article\"\n    id = Column(Integer, primary_key=True)\n    author_id = Column(Integer, ForeignKey(\"author.id\"))\n    title = Column(String)\n    content = Column(String)\n</code></pre> <code>article/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadArticleSchema(BaseModel):\n    id: int\n    author_id: int | None = None\n    title: str | None = None\n    content: str | None = None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-1-basic-usage","title":"Example 1: Basic Usage","text":"<p>Create a FastCRUD instance for a <code>User</code> model and perform basic CRUD operations.</p> <pre><code># Assuming you have a User model (either SQLAlchemy or SQLModel)\n# pydantic schemas for creation, update and deletion and an async session `db`\nUserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\nuser_crud = UserCRUD(User)\n\n# If you don't care about typing, you can also just ignore the UserCRUD part\n# Straight up define user_crud with FastCRUD\nuser_crud = FastCRUD(User)\n\n# Create a new user\nnew_user = await user_crud.create(db, CreateUserSchema(name=\"Alice\"))\n# Read a user\nuser = await user_crud.get(db, id=new_user.id)\n# Update a user\nawait user_crud.update(db, UpdateUserSchema(email=\"alice@example.com\"), id=new_user.id)\n# Delete a user\nawait user_crud.delete(db, id=new_user.id)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-2-advanced-filtering-and-pagination","title":"Example 2: Advanced Filtering and Pagination","text":"<p>Use advanced filtering, sorting, and pagination for fetching records.</p> <pre><code>product_crud = FastCRUD(Product)\nproducts = await product_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns=['price'],\n    sort_orders=['asc'],\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-3-join-operations-with-custom-schemas","title":"Example 3: Join Operations with Custom Schemas","text":"<p>Perform join operations between two models using custom schemas for selection.</p> <pre><code>order_crud = FastCRUD(Order)\norders = await order_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Product,\n    join_prefix=\"product_\",\n    join_schema_to_select=ReadProductSchema,\n    offset=0,\n    limit=5,\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-4-cursor-pagination","title":"Example 4: Cursor Pagination","text":"<p>Implement cursor-based pagination for efficient data retrieval in large datasets.</p> <pre><code>class Comment(Base):\n    id = Column(Integer, primary_key=True)\n    user_id = Column(Integer, ForeignKey(\"user.id\"))\n    subject = Column(String)\n    body = Column(String)\n\ncomment_crud = FastCRUD(Comment)\n\nfirst_page = await comment_crud.get_multi_by_cursor(db, limit=10)\nnext_cursor = first_page['next_cursor']\nsecond_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-5-dynamic-filtering-and-counting","title":"Example 5: Dynamic Filtering and Counting","text":"<p>Dynamically filter records based on various criteria and count the results.</p> <pre><code>task_crud = FastCRUD(Task)\ncompleted_tasks = await task_crud.get_multi(\n    db,\n    status='completed',\n)\nhigh_priority_task_count = await task_crud.count(\n    db,\n    priority='high',\n)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD--example-6-using-custom-column-names-for-soft-delete","title":"Example 6: Using Custom Column Names for Soft Delete","text":"<p>If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the <code>FastCRUD</code> instance.</p> <pre><code>class User(Base):\n    __tablename__ = \"user\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    ...\n    archived = Column(Boolean, default=False)\n    archived_at = Column(DateTime)\n\n\ncustom_user_crud = FastCRUD(\n    User,\n    is_deleted_column=\"archived\",\n    deleted_at_column=\"archived_at\",\n)\n# Now 'archived' and 'archived_at' will be used for soft delete operations.\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>class FastCRUD(\n    Generic[\n        ModelType,\n        CreateSchemaType,\n        UpdateSchemaType,\n        UpdateSchemaInternalType,\n        DeleteSchemaType,\n        SelectSchemaType,\n    ]\n):\n    \"\"\"\n    Base class for CRUD operations on a model.\n\n    This class provides a set of methods for create, read, update, and delete operations on a given SQLAlchemy model,\n    utilizing Pydantic schemas for data validation and serialization.\n\n    Args:\n        model: The SQLAlchemy model type.\n        is_deleted_column: Optional column name to use for indicating a soft delete. Defaults to `\"is_deleted\"`.\n        deleted_at_column: Optional column name to use for storing the timestamp of a soft delete. Defaults to `\"deleted_at\"`.\n        updated_at_column: Optional column name to use for storing the timestamp of an update. Defaults to `\"updated_at\"`.\n\n    Methods:\n        create:\n            Creates a new record in the database from the provided Pydantic schema.\n\n        select:\n            Generates a SQL Alchemy `Select` statement with optional filtering and sorting.\n\n        get:\n            Retrieves a single record based on filters. Supports advanced filtering through comparison operators like `__gt`, `__lt`, etc.\n\n        exists:\n            Checks if a record exists based on the provided filters.\n\n        count:\n            Counts the number of records matching the provided filters.\n\n        get_multi:\n            Fetches multiple records with optional sorting, pagination, and model conversion.\n\n        get_joined:\n            Performs a join operation with another model, supporting custom join conditions and selection of specific columns.\n\n        get_multi_joined:\n            Fetches multiple records with a join on another model, offering pagination and sorting for the joined tables.\n\n        get_multi_by_cursor:\n            Implements cursor-based pagination for fetching records, ideal for large datasets and infinite scrolling features.\n\n        update:\n            Updates an existing record or multiple records based on specified filters.\n\n        db_delete:\n            Hard deletes a record or multiple records from the database based on provided filters.\n\n        delete:\n            Soft deletes a record if it has an `\"is_deleted\"` attribute (or other attribute as defined by `is_deleted_column`); otherwise, performs a hard delete.\n\n    Examples:\n        ??? example \"Models and Schemas Used Below\"\n\n            ??? example \"`customer/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/customer/model.py:imports\n                fastcrud/examples/customer/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/model.py:imports\n                fastcrud/examples/product/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`product/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/product/schemas.py:imports\n                fastcrud/examples/product/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`order/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/model.py:imports\n                fastcrud/examples/order/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`order/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/order/schemas.py:imports\n                fastcrud/examples/order/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`tier/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/model.py:imports\n                fastcrud/examples/tier/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`tier/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/tier/schemas.py:imports\n                fastcrud/examples/tier/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`department/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/model.py:imports\n                fastcrud/examples/department/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`department/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/department/schemas.py:imports\n                fastcrud/examples/department/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`user/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/model.py:imports\n                fastcrud/examples/user/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`user/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/user/schemas.py:imports\n                fastcrud/examples/user/schemas.py:createschema\n                fastcrud/examples/user/schemas.py:readschema\n                fastcrud/examples/user/schemas.py:updateschema\n                fastcrud/examples/user/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`story/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/model.py:imports\n                fastcrud/examples/story/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`story/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/story/schemas.py:imports\n                fastcrud/examples/story/schemas.py:createschema\n                fastcrud/examples/story/schemas.py:readschema\n                fastcrud/examples/story/schemas.py:updateschema\n                fastcrud/examples/story/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ??? example \"`task/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/model.py:imports\n                fastcrud/examples/task/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`task/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/task/schemas.py:imports\n                fastcrud/examples/task/schemas.py:createschema\n                fastcrud/examples/task/schemas.py:readschema\n                fastcrud/examples/task/schemas.py:updateschema\n                fastcrud/examples/task/schemas.py:deleteschema\n                --8&lt;--\n                ```\n\n            ---\n\n            ??? example \"`profile/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/profile/model.py:imports\n                fastcrud/examples/profile/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`profile/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/profile/schemas.py:imports\n                fastcrud/examples/profile/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`author/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/author/model.py:imports\n                fastcrud/examples/author/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`author/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/author/schemas.py:imports\n                fastcrud/examples/author/schemas.py:readschema\n                --8&lt;--\n                ```\n\n            ??? example \"`article/model.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/article/model.py:imports\n                fastcrud/examples/article/model.py:model\n                --8&lt;--\n                ```\n\n            ??? example \"`article/schemas.py`\"\n\n                ```python\n                --8&lt;--\n                fastcrud/examples/article/schemas.py:imports\n                fastcrud/examples/article/schemas.py:readschema\n                --8&lt;--\n                ```\n\n        Example 1: Basic Usage\n        ----------------------\n\n        Create a FastCRUD instance for a `User` model and perform basic CRUD operations.\n\n        ```python\n        # Assuming you have a User model (either SQLAlchemy or SQLModel)\n        # pydantic schemas for creation, update and deletion and an async session `db`\n        UserCRUD = FastCRUD[User, CreateUserSchema, UpdateUserSchema, None, DeleteUserSchema]\n        user_crud = UserCRUD(User)\n\n        # If you don't care about typing, you can also just ignore the UserCRUD part\n        # Straight up define user_crud with FastCRUD\n        user_crud = FastCRUD(User)\n\n        # Create a new user\n        new_user = await user_crud.create(db, CreateUserSchema(name=\"Alice\"))\n        # Read a user\n        user = await user_crud.get(db, id=new_user.id)\n        # Update a user\n        await user_crud.update(db, UpdateUserSchema(email=\"alice@example.com\"), id=new_user.id)\n        # Delete a user\n        await user_crud.delete(db, id=new_user.id)\n        ```\n\n        Example 2: Advanced Filtering and Pagination\n        --------------------------------------------\n\n        Use advanced filtering, sorting, and pagination for fetching records.\n\n        ```python\n        product_crud = FastCRUD(Product)\n        products = await product_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            sort_columns=['price'],\n            sort_orders=['asc'],\n        )\n        ```\n\n        Example 3: Join Operations with Custom Schemas\n        ----------------------------------------------\n\n        Perform join operations between two models using custom schemas for selection.\n\n        ```python\n        order_crud = FastCRUD(Order)\n        orders = await order_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadOrderSchema,\n            join_model=Product,\n            join_prefix=\"product_\",\n            join_schema_to_select=ReadProductSchema,\n            offset=0,\n            limit=5,\n        )\n        ```\n\n        Example 4: Cursor Pagination\n        ----------------------------\n\n        Implement cursor-based pagination for efficient data retrieval in large datasets.\n\n        ```python\n        class Comment(Base):\n            id = Column(Integer, primary_key=True)\n            user_id = Column(Integer, ForeignKey(\"user.id\"))\n            subject = Column(String)\n            body = Column(String)\n\n        comment_crud = FastCRUD(Comment)\n\n        first_page = await comment_crud.get_multi_by_cursor(db, limit=10)\n        next_cursor = first_page['next_cursor']\n        second_page = await comment_crud.get_multi_by_cursor(db, cursor=next_cursor, limit=10)\n        ```\n\n        Example 5: Dynamic Filtering and Counting\n        -----------------------------------------\n        Dynamically filter records based on various criteria and count the results.\n\n        ```python\n        task_crud = FastCRUD(Task)\n        completed_tasks = await task_crud.get_multi(\n            db,\n            status='completed',\n        )\n        high_priority_task_count = await task_crud.count(\n            db,\n            priority='high',\n        )\n        ```\n\n        Example 6: Using Custom Column Names for Soft Delete\n        ----------------------------------------------------\n\n        If your model uses different column names for indicating a soft delete and its timestamp, you can specify these when creating the `FastCRUD` instance.\n\n        ```python\n        --8&lt;--\n        fastcrud/examples/user/model.py:model_common\n        --8&lt;--\n            ...\n        --8&lt;--\n        fastcrud/examples/user/model.py:model_archived\n        --8&lt;--\n\n\n        custom_user_crud = FastCRUD(\n            User,\n            is_deleted_column=\"archived\",\n            deleted_at_column=\"archived_at\",\n        )\n        # Now 'archived' and 'archived_at' will be used for soft delete operations.\n        ```\n    \"\"\"\n\n    _SUPPORTED_FILTERS = {\n        \"gt\": lambda column: column.__gt__,\n        \"lt\": lambda column: column.__lt__,\n        \"gte\": lambda column: column.__ge__,\n        \"lte\": lambda column: column.__le__,\n        \"ne\": lambda column: column.__ne__,\n        \"is\": lambda column: column.is_,\n        \"is_not\": lambda column: column.is_not,\n        \"like\": lambda column: column.like,\n        \"notlike\": lambda column: column.notlike,\n        \"ilike\": lambda column: column.ilike,\n        \"notilike\": lambda column: column.notilike,\n        \"startswith\": lambda column: column.startswith,\n        \"endswith\": lambda column: column.endswith,\n        \"contains\": lambda column: column.contains,\n        \"match\": lambda column: column.match,\n        \"between\": lambda column: column.between,\n        \"in\": lambda column: column.in_,\n        \"not_in\": lambda column: column.not_in,\n    }\n\n    def __init__(\n        self,\n        model: type[ModelType],\n        is_deleted_column: str = \"is_deleted\",\n        deleted_at_column: str = \"deleted_at\",\n        updated_at_column: str = \"updated_at\",\n    ) -&gt; None:\n        self.model = model\n        self.model_col_names = [col.key for col in model.__table__.columns]\n        self.is_deleted_column = is_deleted_column\n        self.deleted_at_column = deleted_at_column\n        self.updated_at_column = updated_at_column\n        self._primary_keys = _get_primary_keys(self.model)\n\n    def _get_sqlalchemy_filter(\n        self,\n        operator: str,\n        value: Any,\n    ) -&gt; Optional[Callable[[str], Callable]]:\n        if operator in {\"in\", \"not_in\", \"between\"}:\n            if not isinstance(value, (tuple, list, set)):\n                raise ValueError(f\"&lt;{operator}&gt; filter must be tuple, list or set\")\n        return self._SUPPORTED_FILTERS.get(operator)\n\n    def _parse_filters(\n        self, model: Optional[Union[type[ModelType], AliasedClass]] = None, **kwargs\n    ) -&gt; list[ColumnElement]:\n        model = model or self.model\n        filters = []\n\n        for key, value in kwargs.items():\n            if \"__\" in key:\n                field_name, op = key.rsplit(\"__\", 1)\n                column = getattr(model, field_name, None)\n                if column is None:\n                    raise ValueError(f\"Invalid filter column: {field_name}\")\n                if op == \"or\":\n                    or_filters = [\n                        sqlalchemy_filter(column)(or_value)\n                        for or_key, or_value in value.items()\n                        if (\n                            sqlalchemy_filter := self._get_sqlalchemy_filter(\n                                or_key, or_value\n                            )\n                        )\n                        is not None\n                    ]\n                    filters.append(or_(*or_filters))\n                else:\n                    sqlalchemy_filter = self._get_sqlalchemy_filter(op, value)\n                    if sqlalchemy_filter:\n                        filters.append(\n                            sqlalchemy_filter(column)(value)\n                            if op != \"between\"\n                            else sqlalchemy_filter(column)(*value)\n                        )\n            else:\n                column = getattr(model, key, None)\n                if column is not None:\n                    filters.append(column == value)\n\n        return filters\n\n    def _apply_sorting(\n        self,\n        stmt: Select,\n        sort_columns: Union[str, list[str]],\n        sort_orders: Optional[Union[str, list[str]]] = None,\n    ) -&gt; Select:\n        \"\"\"\n        Apply sorting to a SQLAlchemy query based on specified column names and sort orders.\n\n        Args:\n            stmt: The SQLAlchemy `Select` statement to which sorting will be applied.\n            sort_columns: A single column name or a list of column names on which to apply sorting.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding\n                to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n\n        Raises:\n            ValueError: Raised if sort orders are provided without corresponding sort columns,\n                or if an invalid sort order is provided (not `\"asc\"` or `\"desc\"`).\n            ArgumentError: Raised if an invalid column name is provided that does not exist in the model.\n\n        Returns:\n            The modified `Select` statement with sorting applied.\n\n        Examples:\n            Applying ascending sort on a single column:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, 'name')\n\n            Applying descending sort on a single column:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, 'age', 'desc')\n\n            Applying mixed sort orders on multiple columns:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, ['name', 'age'], ['asc', 'desc'])\n\n            Applying ascending sort on multiple columns:\n            &gt;&gt;&gt; stmt = _apply_sorting(stmt, ['name', 'age'])\n\n        Note:\n            This method modifies the passed `Select` statement in-place by applying the `order_by` clause\n            based on the provided column names and sort orders.\n        \"\"\"\n        if sort_orders and not sort_columns:\n            raise ValueError(\"Sort orders provided without corresponding sort columns.\")\n\n        if sort_columns:\n            if not isinstance(sort_columns, list):\n                sort_columns = [sort_columns]\n\n            if sort_orders:\n                if not isinstance(sort_orders, list):\n                    sort_orders = [sort_orders] * len(sort_columns)\n                if len(sort_columns) != len(sort_orders):\n                    raise ValueError(\n                        \"The length of sort_columns and sort_orders must match.\"\n                    )\n\n                for idx, order in enumerate(sort_orders):\n                    if order not in [\"asc\", \"desc\"]:\n                        raise ValueError(\n                            f\"Invalid sort order: {order}. Only 'asc' or 'desc' are allowed.\"\n                        )\n\n            validated_sort_orders = (\n                [\"asc\"] * len(sort_columns) if not sort_orders else sort_orders\n            )\n\n            for idx, column_name in enumerate(sort_columns):\n                column = getattr(self.model, column_name, None)\n                if not column:\n                    raise ArgumentError(f\"Invalid column name: {column_name}\")\n\n                order = validated_sort_orders[idx]\n                stmt = stmt.order_by(asc(column) if order == \"asc\" else desc(column))\n\n        return stmt\n\n    def _prepare_and_apply_joins(\n        self,\n        stmt: Select,\n        joins_config: list[JoinConfig],\n        use_temporary_prefix: bool = False,\n    ):\n        \"\"\"\n        Applies joins to the given SQL statement based on a list of `JoinConfig` objects.\n\n        Args:\n            stmt: The initial SQL statement.\n            joins_config: Configurations for all joins.\n            use_temporary_prefix: Whether to use or not an additional prefix for joins. Default `False`.\n\n        Returns:\n            The modified SQL statement with joins applied.\n        \"\"\"\n        for join in joins_config:\n            model = join.alias or join.model\n            join_select = _extract_matching_columns_from_schema(\n                model,\n                join.schema_to_select,\n                join.join_prefix,\n                join.alias,\n                use_temporary_prefix,\n            )\n            joined_model_filters = self._parse_filters(\n                model=model, **(join.filters or {})\n            )\n\n            if join.join_type == \"left\":\n                stmt = stmt.outerjoin(model, join.join_on).add_columns(*join_select)\n            elif join.join_type == \"inner\":\n                stmt = stmt.join(model, join.join_on).add_columns(*join_select)\n            else:  # pragma: no cover\n                raise ValueError(f\"Unsupported join type: {join.join_type}.\")\n            if joined_model_filters:\n                stmt = stmt.filter(*joined_model_filters)\n\n        return stmt\n\n    async def create(\n        self, db: AsyncSession, object: CreateSchemaType, commit: bool = True\n    ) -&gt; ModelType:\n        \"\"\"\n        Create a new record in the database.\n\n        Args:\n            db: The SQLAlchemy async session.\n            object: The Pydantic schema containing the data to be saved.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n\n        Returns:\n            The created database object.\n        \"\"\"\n        object_dict = object.model_dump()\n        db_object: ModelType = self.model(**object_dict)\n        db.add(db_object)\n        if commit:\n            await db.commit()\n        return db_object\n\n    async def select(\n        self,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        **kwargs: Any,\n    ) -&gt; Select:\n        \"\"\"\n        Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.\n\n        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.\n            sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n        Returns:\n            An SQL Alchemy `Select` statement object that can be executed or further modified.\n\n        Examples:\n            Selecting specific columns with filtering and sorting:\n\n            ```python\n            stmt = await user_crud.select(\n                schema_to_select=ReadUserSchema,\n                sort_columns=['age', 'name'],\n                sort_orders=['asc', 'desc'],\n                age__gt=18,\n            )\n            ```\n\n            Creating a statement to select all users without any filters:\n\n            ```python\n            stmt = await user_crud.select()\n            ```\n\n            Selecting users with a specific `role`, ordered by `name`:\n\n            ```python\n            stmt = await user_crud.select(\n                schema_to_select=UserReadSchema,\n                sort_columns='name',\n                role='admin',\n            )\n            ```\n\n        Note:\n            This method does not execute the generated SQL statement.\n            Use `db.execute(stmt)` to run the query and fetch results.\n        \"\"\"\n        to_select = _extract_matching_columns_from_schema(\n            model=self.model, schema=schema_to_select\n        )\n        filters = self._parse_filters(**kwargs)\n        stmt = select(*to_select).filter(*filters)\n\n        if sort_columns:\n            stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n        return stmt\n\n    async def get(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n        **kwargs: Any,\n    ) -&gt; Optional[Union[dict, SelectSchemaType]]:\n        \"\"\"\n        Fetches a single record based on specified filters.\n\n        This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            schema_to_select: Optional Pydantic schema for selecting specific columns.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n            one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.\n            **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.\n\n        Raises:\n            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n        Returns:\n            A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.\n\n        Examples:\n            Fetch a user by ID:\n\n            ```python\n            user = await user_crud.get(db, id=1)\n            ```\n\n            Fetch a user with an age greater than 30:\n\n            ```python\n            user = await user_crud.get(db, age__gt=30)\n            ```\n\n            Fetch a user with a registration date before Jan 1, 2020:\n\n            ```python\n            user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n            ```\n\n            Fetch a user not equal to a specific username:\n\n            ```python\n            user = await user_crud.get(db, username__ne='admin')\n            ```\n        \"\"\"\n        stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n        db_row = await db.execute(stmt)\n        result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n        if result is None:\n            return None\n        out: dict = dict(result._mapping)\n        if not return_as_model:\n            return out\n        if not schema_to_select:\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        return schema_to_select(**out)\n\n    def _get_pk_dict(self, instance):\n        return {pk.name: getattr(instance, pk.name) for pk in self._primary_keys}\n\n    async def upsert(\n        self,\n        db: AsyncSession,\n        instance: Union[UpdateSchemaType, CreateSchemaType],\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n    ) -&gt; Union[SelectSchemaType, dict[str, Any], None]:\n        \"\"\"Update the instance or create it if it doesn't exists.\n\n        Note: This method will perform two transactions to the database (get and create or update).\n\n        Args:\n            db: The database session to use for the operation.\n            instance: A Pydantic schema representing the instance.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n\n        Returns:\n            The created or updated instance\n        \"\"\"\n        _pks = self._get_pk_dict(instance)\n        schema_to_select = schema_to_select or type(instance)  # type: ignore\n        db_instance = await self.get(\n            db,\n            schema_to_select=schema_to_select,  # type: ignore\n            return_as_model=return_as_model,\n            **_pks,\n        )\n        if db_instance is None:\n            db_instance = await self.create(db, instance)  # type: ignore\n            db_instance = schema_to_select.model_validate(  # type: ignore\n                db_instance, from_attributes=True\n            )\n        else:\n            await self.update(db, instance)  # type: ignore\n            db_instance = await self.get(\n                db,\n                schema_to_select=schema_to_select,  # type: ignore\n                return_as_model=return_as_model,\n                **_pks,\n            )\n\n        return db_instance\n\n    async def upsert_multi(\n        self,\n        db: AsyncSession,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        commit: bool = False,\n        return_columns: Optional[list[str]] = None,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n        update_override: Optional[dict[str, Any]] = None,\n        **kwargs: Any,\n    ) -&gt; Optional[dict[str, Any]]:\n        \"\"\"\n        Upsert multiple records in the database. The underlying implementation varies based on the database dialect.\n\n        Args:\n            db: The database session to use for the operation.\n            instances: A list of Pydantic schemas representing the instances to upsert.\n            commit: If True, commits the transaction immediately. Default is False.\n            return_columns: Optional list of column names to return after the upsert operation.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.\n            return_as_model: If True, returns data as instances of the specified Pydantic model.\n            update_override: Optional dictionary to override the update values for the upsert operation.\n            **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.\n\n        Returns:\n            The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.\n\n        Raises:\n            ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.\n            NotImplementedError: If the database dialect is not supported for upsert multi.\n        \"\"\"\n        if update_override is None:\n            update_override = {}\n        filters = self._parse_filters(**kwargs)\n\n        if db.bind.dialect.name == \"postgresql\":\n            statement, params = await self._upsert_multi_postgresql(\n                instances, filters, update_override\n            )\n        elif db.bind.dialect.name == \"sqlite\":\n            statement, params = await self._upsert_multi_sqlite(\n                instances, filters, update_override\n            )\n        elif db.bind.dialect.name in [\"mysql\", \"mariadb\"]:\n            if filters:\n                raise ValueError(\n                    \"MySQL does not support filtering on insert operations.\"\n                )\n            if return_columns or schema_to_select or return_as_model:\n                raise ValueError(\n                    \"MySQL does not support the returning clause for insert operations.\"\n                )\n            statement, params = await self._upsert_multi_mysql(\n                instances, update_override\n            )\n        else:  # pragma: no cover\n            raise NotImplementedError(\n                f\"Upsert multi is not implemented for {db.bind.dialect.name}\"\n            )\n\n        if return_as_model:\n            return_columns = self.model_col_names\n\n        if return_columns:\n            statement = statement.returning(*[column(name) for name in return_columns])\n            db_row = await db.execute(statement, params)\n            if commit:\n                await db.commit()\n            return self._as_multi_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n            )\n\n        await db.execute(statement, params)\n        if commit:\n            await db.commit()\n        return None\n\n    async def _upsert_multi_postgresql(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        filters: list[ColumnElement],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = postgresql.insert(self.model)\n        statement = statement.on_conflict_do_update(\n            index_elements=self._primary_keys,\n            set_={\n                column.name: getattr(statement.excluded, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key and not column.unique\n            }\n            | update_set_override,\n            where=and_(*filters) if filters else None,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def _upsert_multi_sqlite(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        filters: list[ColumnElement],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = sqlite.insert(self.model)\n        statement = statement.on_conflict_do_update(\n            index_elements=self._primary_keys,\n            set_={\n                column.name: getattr(statement.excluded, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key and not column.unique\n            }\n            | update_set_override,\n            where=and_(*filters) if filters else None,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def _upsert_multi_mysql(\n        self,\n        instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n        update_set_override: dict[str, Any],\n    ) -&gt; tuple[Insert, list[dict]]:\n        statement = mysql.insert(self.model)\n        statement = statement.on_duplicate_key_update(\n            {\n                column.name: getattr(statement.inserted, column.name)\n                for column in self.model.__table__.columns\n                if not column.primary_key\n                and not column.unique\n                and column.name != self.deleted_at_column\n            }\n            | update_set_override,\n        )\n        params = [\n            self.model(**instance.model_dump()).__dict__ for instance in instances\n        ]\n        return statement, params\n\n    async def exists(self, db: AsyncSession, **kwargs: Any) -&gt; bool:\n        \"\"\"\n        Checks if any records exist that match the given filter conditions.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.\n\n        Returns:\n            `True` if at least one record matches the filter conditions, `False` otherwise.\n\n        Examples:\n            Check if a user with a specific ID exists:\n\n            ```python\n            exists = await user_crud.exists(db, id=1)\n            ```\n\n            Check if any user is older than 30:\n\n            ```python\n            exists = await user_crud.exists(db, age__gt=30)\n            ```\n\n            Check if any user was registered before Jan 1, 2020:\n\n            ```python\n            exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n            ```\n\n            Check if a username other than `admin` exists:\n\n            ```python\n            exists = await user_crud.exists(db, username__ne='admin')\n            ```\n        \"\"\"\n        filters = self._parse_filters(**kwargs)\n        stmt = select(self.model).filter(*filters).limit(1)\n\n        result = await db.execute(stmt)\n        return result.first() is not None\n\n    async def count(\n        self,\n        db: AsyncSession,\n        joins_config: Optional[list[JoinConfig]] = None,\n        **kwargs: Any,\n    ) -&gt; int:\n        \"\"\"\n        Counts records that match specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Can also count records based on a configuration of joins, useful for complex queries involving relationships.\n\n        Args:\n            db: The database session to use for the operation.\n            joins_config: Optional configuration for applying joins in the count query.\n            **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.\n\n        Returns:\n            The total number of records matching the filter conditions.\n\n        Examples:\n            Count users by ID:\n\n            ```python\n            count = await user_crud.count(db, id=1)\n            ```\n\n            Count users older than 30:\n\n            ```python\n            count = await user_crud.count(db, age__gt=30)\n            ```\n\n            Count users with a username other than `admin`:\n\n            ```python\n            count = await user_crud.count(db, username__ne='admin')\n            ```\n\n            Count projects with at least one participant (many-to-many relationship):\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                ),\n            ]\n            count = await crud.count(db, joins_config=joins_config)\n            ```\n\n            Count projects by a specific participant name (filter applied on a joined model):\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'name': 'Jane Doe'},\n                ),\n            ]\n            count = await crud.count(db, joins_config=joins_config)\n            ```\n        \"\"\"\n        primary_filters = self._parse_filters(**kwargs)\n\n        if joins_config is not None:\n            primary_keys = [p.name for p in _get_primary_keys(self.model)]\n            if not any(primary_keys):  # pragma: no cover\n                raise ValueError(\n                    f\"The model '{self.model.__name__}' does not have a primary key defined, which is required for counting with joins.\"\n                )\n            to_select = [\n                getattr(self.model, pk).label(f\"distinct_{pk}\") for pk in primary_keys\n            ]\n            base_query = select(*to_select)\n\n            for join in joins_config:\n                join_model = join.alias or join.model\n                join_filters = (\n                    self._parse_filters(model=join_model, **join.filters)\n                    if join.filters\n                    else []\n                )\n\n                if join.join_type == \"inner\":\n                    base_query = base_query.join(join_model, join.join_on)\n                else:\n                    base_query = base_query.outerjoin(join_model, join.join_on)\n\n                if join_filters:\n                    base_query = base_query.where(*join_filters)\n\n            if primary_filters:\n                base_query = base_query.where(*primary_filters)\n\n            subquery = base_query.subquery()\n            count_query = select(func.count()).select_from(subquery)\n        else:\n            count_query = select(func.count()).select_from(self.model)\n            if primary_filters:\n                count_query = count_query.where(*primary_filters)\n\n        total_count: Optional[int] = await db.scalar(count_query)\n        if total_count is None:\n            raise ValueError(\"Could not find the count.\")\n\n        return total_count\n\n    async def get_multi(\n        self,\n        db: AsyncSession,\n        offset: int = 0,\n        limit: Optional[int] = 100,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        return_as_model: bool = False,\n        return_total_count: bool = True,\n        **kwargs: Any,\n    ) -&gt; Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]:\n        \"\"\"\n        Fetches multiple records based on filters, supporting sorting, pagination.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            offset: Starting index for records to fetch, useful for pagination.\n            limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n            schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.\n            sort_columns: Column names to sort the results by.\n            sort_orders: Corresponding sort orders (`\"asc\"`, `\"desc\"`) for each column in `sort_columns`.\n            return_as_model: If `True`, returns data as instances of the specified Pydantic model.\n            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n        Returns:\n            A dictionary containing the data list and optionally the total count:\n            - With return_as_model=True: Dict with \"data\": List[SelectSchemaType]\n            - With return_as_model=False: Dict with \"data\": List[Dict[str, Any]]\n            - If return_total_count=True, includes \"total_count\": int\n\n        Raises:\n            ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.\n\n        Examples:\n            Fetch the first 10 users:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                0,\n                10,\n            )\n            ```\n\n            Fetch next 10 users with sorted by username:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                10,\n                10,\n                sort_columns='username',\n                sort_orders='desc',\n            )\n            ```\n\n            Fetch 10 users older than 30, sorted by age in descending order:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                sort_columns='age',\n                sort_orders='desc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch 10 users with a registration date before Jan 1, 2020:\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                registration_date__lt=datetime(2020, 1, 1),\n            )\n            ```\n\n            Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                offset=0,\n                limit=10,\n                schema_to_select=ReadUserSchema,\n                return_as_model=True,\n                username__ne='admin',\n            )\n            ```\n\n            Fetch users with filtering and multiple column sorting:\n\n            ```python\n            users = await user_crud.get_multi(\n                db,\n                0,\n                10,\n                sort_columns=['username', 'email'],\n                sort_orders=['asc', 'desc'],\n                is_active=True,\n            )\n            ```\n        \"\"\"\n        if (limit is not None and limit &lt; 0) or offset &lt; 0:\n            raise ValueError(\"Limit and offset must be non-negative.\")\n\n        stmt = await self.select(\n            schema_to_select=schema_to_select,\n            sort_columns=sort_columns,\n            sort_orders=sort_orders,\n            **kwargs,\n        )\n\n        if offset:\n            stmt = stmt.offset(offset)\n        if limit is not None:\n            stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data = [dict(row) for row in result.mappings()]\n\n        response: dict[str, Any] = {\"data\": data}\n\n        if return_total_count:\n            total_count = await self.count(db=db, **kwargs)\n            response[\"total_count\"] = total_count\n\n        if return_as_model:\n            if not schema_to_select:\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_data = [schema_to_select(**row) for row in data]\n                response[\"data\"] = model_data\n            except ValidationError as e:\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n\n        return response\n\n    async def get_joined(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        join_model: Optional[ModelType] = None,\n        join_on: Optional[Union[Join, BinaryExpression]] = None,\n        join_prefix: Optional[str] = None,\n        join_schema_to_select: Optional[type[SelectSchemaType]] = None,\n        join_type: str = \"left\",\n        alias: Optional[AliasedClass] = None,\n        join_filters: Optional[dict] = None,\n        joins_config: Optional[list[JoinConfig]] = None,\n        nest_joins: bool = False,\n        relationship_type: Optional[str] = None,\n        **kwargs: Any,\n    ) -&gt; Optional[dict[str, Any]]:\n        \"\"\"\n        Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts\n        to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to\n        specify each join configuration.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n            join_model: The model to join with.\n            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n            join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n            joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.\n            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n            relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n            **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.\n\n        Returns:\n            A dictionary representing the joined record, or `None` if no record matches the criteria.\n\n        Raises:\n            ValueError: If both single join parameters and `joins_config` are used simultaneously.\n            ArgumentError: If any provided model in `joins_config` is not recognized or invalid.\n            NoResultFound: If no record matches the criteria with the provided filters.\n\n        Examples:\n            Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`\n\n            ```python\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n            )\n            ```\n\n            Fetch a user and their associated tier, filtering by user ID:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                id=1,\n            )\n            ```\n\n            Fetch a user and their associated tier, where the user's age is greater than 30:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                age__gt=30,\n            )\n            ```\n\n            Fetch a user and their associated tier, excluding users with the `admin` username:\n\n            ```python\n            result = await user_crud.get_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                username__ne='admin',\n            )\n            ```\n\n            Complex example: Joining with a custom join condition, additional filter parameters, and a prefix\n\n            ```python\n            from sqlalchemy import and_\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                username=\"john_doe\",\n            )\n            ```\n\n            Example of using `joins_config` for multiple joins:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            # Using same User/Tier/Department models/schemas as above.\n\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n            )\n            ```\n\n            Using `alias` for joining the same model multiple times:\n            ```python\n            from fastcrud import aliased\n\n            owner_alias = aliased(ModelTest, name=\"owner\")\n            user_alias = aliased(ModelTest, name=\"user\")\n\n            result = await crud.get_joined(\n                db=session,\n                schema_to_select=BookingSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.owner_id == owner_alias.id,\n                        join_prefix=\"owner_\",\n                        alias=owner_alias,\n                        schema_to_select=UserSchema,\n                    ),\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.user_id == user_alias.id,\n                        join_prefix=\"user_\",\n                        alias=user_alias,\n                        schema_to_select=UserSchema,\n                    ),\n                ],\n                id=1,\n            )\n            ```\n\n            Fetching a single project and its associated participants where a participant has a specific role:\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'role': 'Designer'},\n                ),\n            ]\n            project = await crud.get_joined(\n                db=session,\n                schema_to_select=ProjectSchema,\n                joins_config=joins_config,\n            )\n            ```\n\n            Example of using `joins_config` for multiple joins with nested joins enabled:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            result = await user_crud.get_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n                nest_joins=True,\n            )\n            # Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n            ```\n\n            Example using one-to-one relationship:\n\n            ```python\n            author_crud = FastCRUD(Author)\n            result = await author_crud.get_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Profile,\n                join_on=Author.profile_id == Profile.id,\n                join_schema_to_select=ReadProfileSchema,\n                nest_joins=True,\n                relationship_type='one-to-one', # note that this is the default behavior\n            )\n            # Expect 'result' to have 'profile' as a nested dictionary\n            ```\n\n            Example using one-to-many relationship:\n\n            ```python\n            result = await author_crud.get_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Article,\n                join_on=Author.id == Article.author_id,\n                join_schema_to_select=ReadArticleSchema,\n                nest_joins=True,\n                relationship_type='one-to-many',\n            )\n            # Expect 'result' to have 'posts' as a nested list of dictionaries\n            ```\n        \"\"\"\n        if joins_config and (\n            join_model or join_prefix or join_on or join_schema_to_select or alias\n        ):\n            raise ValueError(\n                \"Cannot use both single join parameters and joins_config simultaneously.\"\n            )\n        elif not joins_config and not join_model:\n            raise ValueError(\"You need one of join_model or joins_config.\")\n\n        primary_select = _extract_matching_columns_from_schema(\n            model=self.model,\n            schema=schema_to_select,\n        )\n        stmt: Select = select(*primary_select).select_from(self.model)\n\n        join_definitions = joins_config if joins_config else []\n        if join_model:\n            join_definitions.append(\n                JoinConfig(\n                    model=join_model,\n                    join_on=join_on,\n                    join_prefix=join_prefix,\n                    schema_to_select=join_schema_to_select,\n                    join_type=join_type,\n                    alias=alias,\n                    filters=join_filters,\n                    relationship_type=relationship_type,\n                )\n            )\n\n        stmt = self._prepare_and_apply_joins(\n            stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n        )\n        primary_filters = self._parse_filters(**kwargs)\n        if primary_filters:\n            stmt = stmt.filter(*primary_filters)\n\n        db_rows = await db.execute(stmt)\n        if any(join.relationship_type == \"one-to-many\" for join in join_definitions):\n            if nest_joins is False:  # pragma: no cover\n                raise ValueError(\n                    \"Cannot use one-to-many relationship with nest_joins=False\"\n                )\n            results = db_rows.fetchall()\n            data_list = [dict(row._mapping) for row in results]\n        else:\n            result = db_rows.first()\n            if result is not None:\n                data_list = [dict(result._mapping)]\n            else:\n                data_list = []\n\n        if data_list:\n            if nest_joins:\n                nested_data: dict = {}\n                for data in data_list:\n                    nested_data = _nest_join_data(\n                        data,\n                        join_definitions,\n                        nested_data=nested_data,\n                    )\n                return nested_data\n            return data_list[0]\n\n        return None\n\n    async def get_multi_joined(\n        self,\n        db: AsyncSession,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        join_model: Optional[type[ModelType]] = None,\n        join_on: Optional[Any] = None,\n        join_prefix: Optional[str] = None,\n        join_schema_to_select: Optional[type[SelectSchemaType]] = None,\n        join_type: str = \"left\",\n        alias: Optional[AliasedClass[Any]] = None,\n        join_filters: Optional[dict] = None,\n        nest_joins: bool = False,\n        offset: int = 0,\n        limit: Optional[int] = 100,\n        sort_columns: Optional[Union[str, list[str]]] = None,\n        sort_orders: Optional[Union[str, list[str]]] = None,\n        return_as_model: bool = False,\n        joins_config: Optional[list[JoinConfig]] = None,\n        return_total_count: bool = True,\n        relationship_type: Optional[str] = None,\n        **kwargs: Any,\n    ) -&gt; dict[str, Any]:\n        \"\"\"\n        Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n            join_model: The model to join with.\n            join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n            join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n            join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n            join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n            alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n            join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n            nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n            offset: The offset (number of records to skip) for pagination.\n            limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n            sort_columns: A single column name or a list of column names on which to apply sorting.\n            sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n            return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n            joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.\n            return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n            relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n            **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.\n\n        Returns:\n            A dictionary containing the fetched rows under `\"data\"` key and total count under `\"total_count\"`.\n\n        Raises:\n            ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.\n                        Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.\n\n        Examples:\n            Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n            )\n            ```\n\n            Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                sort_columns='username',\n                sort_orders='asc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_schema_to_select=ReadTierSchema,\n                return_as_model=True,\n                username__ne='admin',\n            )\n            ```\n\n            Fetching and sorting by username in descending order, returning as Pydantic model:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n                sort_columns=['username'],\n                sort_orders=['desc'],\n                return_as_model=True,\n            )\n            ```\n\n            Fetching with complex conditions and custom join, returning as Pydantic model:\n\n            ```python\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                join_model=Tier,\n                join_on=User.tier_id == Tier.id,\n                join_prefix=\"tier_\",\n                join_schema_to_select=ReadTierSchema,\n                offset=0,\n                limit=10,\n                return_as_model=True,\n                is_active=True,\n            )\n            ```\n\n            Example using `joins_config` for multiple joins:\n\n            ```python\n            from fastcrud import JoinConfig\n\n            users = await user_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadUserSchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Tier,\n                        join_on=User.tier_id == Tier.id,\n                        join_prefix=\"tier_\",\n                        schema_to_select=ReadTierSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=Department,\n                        join_on=User.department_id == Department.id,\n                        join_prefix=\"dept_\",\n                        schema_to_select=ReadDepartmentSchema,\n                        join_type=\"inner\",\n                    ),\n                ],\n                offset=0,\n                limit=10,\n                sort_columns='username',\n                sort_orders='asc',\n            )\n            ```\n\n            Example using `alias` for multiple joins, with pagination, sorting, and model conversion:\n            ```python\n            from fastcrud import JoinConfig, FastCRUD, aliased\n\n            # Aliasing for self-joins or multiple joins on the same table\n            owner_alias = aliased(ModelTest, name=\"owner\")\n            user_alias = aliased(ModelTest, name=\"user\")\n\n            # Initialize your FastCRUD instance for BookingModel\n            crud = FastCRUD(BookingModel)\n\n            result = await crud.get_multi_joined(\n                db=session,\n                schema_to_select=BookingSchema,  # Primary model schema\n                joins_config=[\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.owner_id == owner_alias.id,\n                        join_prefix=\"owner_\",\n                        schema_to_select=UserSchema,  # Schema for the joined model\n                        alias=owner_alias,\n                    ),\n                    JoinConfig(\n                        model=ModelTest,\n                        join_on=BookingModel.user_id == user_alias.id,\n                        join_prefix=\"user_\",\n                        schema_to_select=UserSchema,\n                        alias=user_alias,\n                    )\n                ],\n                offset=10,  # Skip the first 10 records\n                limit=5,  # Fetch up to 5 records\n                sort_columns=['booking_date'],  # Sort by booking_date\n                sort_orders=['desc'],  # In descending order\n            )\n            ```\n\n            Fetching multiple project records and their associated participants where participants have a specific role:\n            ```python\n            joins_config = [\n                JoinConfig(\n                    model=ProjectsParticipantsAssociation,\n                    join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                    join_type=\"inner\",\n                ),\n                JoinConfig(\n                    model=Participant,\n                    join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                    join_type=\"inner\",\n                    filters={'role': 'Developer'},\n                ),\n            ]\n            projects = await crud.get_multi_joined(\n                db=session,\n                schema_to_select=ProjectSchema,\n                joins_config=joins_config,\n                limit=10,\n            )\n            ```\n\n            Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:\n\n            ```python\n            story_crud = FastCRUD(Story)\n            stories = await story_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadStorySchema,\n                joins_config=[\n                    JoinConfig(\n                        model=Task,\n                        join_on=Story.id == Task.story_id,\n                        join_prefix=\"task_\",\n                        schema_to_select=ReadTaskSchema,\n                        join_type=\"left\",\n                    ),\n                    JoinConfig(\n                        model=User,\n                        join_on=Task.creator_id == User.id,\n                        join_prefix=\"creator_\",\n                        schema_to_select=ReadUserSchema,\n                        join_type=\"left\",\n                        alias=aliased(User, name=\"task_creator\"),\n                    ),\n                ],\n                nest_joins=True,\n                offset=0,\n                limit=5,\n                sort_columns='name',\n                sort_orders='asc',\n            )\n            ```\n\n            Example using one-to-one relationship:\n\n            ```python\n            author_crud = FastCRUD(Author)\n            results = await author_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Profile,\n                join_on=Author.profile_id == Profile.id,\n                join_schema_to_select=ReadProfileSchema,\n                nest_joins=True,\n                offset=0,\n                limit=10,\n                relationship_type='one-to-one', # note that this is the default behavior\n            )\n            # Expect 'profile' to be nested as a dictionary under each user\n            ```\n\n            Example using one-to-many relationship:\n\n            ```python\n            results = await author_crud.get_multi_joined(\n                db=session,\n                schema_to_select=ReadAuthorSchema,\n                join_model=Article,\n                join_on=Author.id == Article.author_id,\n                join_schema_to_select=ReadArticleSchema,\n                nest_joins=True,\n                offset=0,\n                limit=10,\n                relationship_type='one-to-many',\n            )\n            # Expect 'posts' to be nested as a list of dictionaries under each user\n            ```\n        \"\"\"\n        if joins_config and (\n            join_model\n            or join_prefix\n            or join_on\n            or join_schema_to_select\n            or alias\n            or relationship_type\n        ):\n            raise ValueError(\n                \"Cannot use both single join parameters and joins_config simultaneously.\"\n            )\n        elif not joins_config and not join_model:\n            raise ValueError(\"You need one of join_model or joins_config.\")\n\n        if (limit is not None and limit &lt; 0) or offset &lt; 0:\n            raise ValueError(\"Limit and offset must be non-negative.\")\n\n        if relationship_type is None:\n            relationship_type = \"one-to-one\"\n\n        primary_select = _extract_matching_columns_from_schema(\n            model=self.model, schema=schema_to_select\n        )\n        stmt: Select = select(*primary_select)\n\n        join_definitions = joins_config if joins_config else []\n        if join_model:\n            try:\n                join_definitions.append(\n                    JoinConfig(\n                        model=join_model,\n                        join_on=join_on\n                        if join_on is not None\n                        else _auto_detect_join_condition(self.model, join_model),\n                        join_prefix=join_prefix,\n                        schema_to_select=join_schema_to_select,\n                        join_type=join_type,\n                        alias=alias,\n                        filters=join_filters,\n                        relationship_type=relationship_type,\n                    )\n                )\n            except ValueError as e:  # pragma: no cover\n                raise ValueError(f\"Could not configure join: {str(e)}\")\n\n        stmt = self._prepare_and_apply_joins(\n            stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n        )\n\n        primary_filters = self._parse_filters(**kwargs)\n        if primary_filters:\n            stmt = stmt.filter(*primary_filters)\n\n        if sort_columns:\n            stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n\n        if offset:\n            stmt = stmt.offset(offset)\n        if limit is not None:\n            stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data: list[Union[dict, SelectSchemaType]] = []\n\n        for row in result.mappings().all():\n            row_dict = dict(row)\n\n            if nest_joins:\n                row_dict = _nest_join_data(\n                    data=row_dict,\n                    join_definitions=join_definitions,\n                )\n\n            if return_as_model:\n                if schema_to_select is None:\n                    raise ValueError(\n                        \"schema_to_select must be provided when return_as_model is True.\"\n                    )\n                try:\n                    model_instance = schema_to_select(**row_dict)\n                    data.append(model_instance)\n                except ValidationError as e:\n                    raise ValueError(\n                        f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                    )\n            else:\n                data.append(row_dict)\n\n        if nest_joins and any(\n            join.relationship_type == \"one-to-many\" for join in join_definitions\n        ):\n            nested_data = _nest_multi_join_data(\n                base_primary_key=self._primary_keys[0].name,  # type: ignore[misc]\n                data=data,\n                joins_config=join_definitions,\n                return_as_model=return_as_model,\n                schema_to_select=schema_to_select if return_as_model else None,\n                nested_schema_to_select={\n                    (\n                        join.join_prefix.rstrip(\"_\")\n                        if join.join_prefix\n                        else join.model.__tablename__\n                    ): join.schema_to_select\n                    for join in join_definitions\n                    if join.schema_to_select\n                },\n            )\n        else:\n            nested_data = _handle_null_primary_key_multi_join(data, join_definitions)\n\n        response: dict[str, Any] = {\"data\": nested_data}\n\n        if return_total_count:\n            total_count: int = await self.count(\n                db=db, joins_config=joins_config, **kwargs\n            )\n            response[\"total_count\"] = total_count\n\n        return response\n\n    async def get_multi_by_cursor(\n        self,\n        db: AsyncSession,\n        cursor: Any = None,\n        limit: int = 100,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        sort_column: str = \"id\",\n        sort_order: str = \"asc\",\n        **kwargs: Any,\n    ) -&gt; dict[str, Any]:\n        \"\"\"\n        Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The SQLAlchemy async session.\n            cursor: The cursor value to start fetching records from. Defaults to `None`.\n            limit: Maximum number of rows to fetch.\n            schema_to_select: Pydantic schema for selecting specific columns.\n            sort_column: Column name to use for sorting and cursor pagination.\n            sort_order: Sorting direction, either `\"asc\"` or `\"desc\"`.\n            **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.\n\n        Returns:\n            A dictionary containing the fetched rows under `\"data\"` key and the next cursor value under `\"next_cursor\"`.\n\n        Examples:\n            Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='registration_date',\n                sort_order='desc',\n            )\n\n            # Fetch the next set of records using the cursor from the first page\n            next_cursor = first_page['next_cursor']\n            second_page = await user_crud.get_multi_by_cursor(\n                db,\n                cursor=next_cursor,\n                limit=10,\n                sort_column='registration_date',\n                sort_order='desc',\n            )\n            ```\n\n            Fetch records with age greater than 30 using cursor-based pagination:\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='age',\n                sort_order='asc',\n                age__gt=30,\n            )\n            ```\n\n            Fetch records excluding a specific username using cursor-based pagination:\n\n            ```python\n            first_page = await user_crud.get_multi_by_cursor(\n                db,\n                limit=10,\n                sort_column='username',\n                sort_order='asc',\n                username__ne='admin',\n            )\n            ```\n\n        Note:\n            This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.\n            Make sure the column used for cursor pagination is indexed for performance.\n            This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).\n        \"\"\"\n        if limit == 0:\n            return {\"data\": [], \"next_cursor\": None}\n\n        stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n        if cursor:\n            if sort_order == \"asc\":\n                stmt = stmt.filter(getattr(self.model, sort_column) &gt; cursor)\n            else:\n                stmt = stmt.filter(getattr(self.model, sort_column) &lt; cursor)\n\n        stmt = stmt.order_by(\n            asc(getattr(self.model, sort_column))\n            if sort_order == \"asc\"\n            else desc(getattr(self.model, sort_column))\n        )\n        stmt = stmt.limit(limit)\n\n        result = await db.execute(stmt)\n        data = [dict(row) for row in result.mappings()]\n\n        next_cursor = None\n        if len(data) == limit:\n            if sort_order == \"asc\":\n                next_cursor = data[-1][sort_column]\n            else:\n                data[0][sort_column]\n\n        return {\"data\": data, \"next_cursor\": next_cursor}\n\n    async def update(\n        self,\n        db: AsyncSession,\n        object: Union[UpdateSchemaType, dict[str, Any]],\n        allow_multiple: bool = False,\n        commit: bool = True,\n        return_columns: Optional[list[str]] = None,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n        **kwargs: Any,\n    ) -&gt; Optional[Union[dict, SelectSchemaType]]:\n        \"\"\"\n        Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            object: A Pydantic schema or dictionary containing the update data.\n            allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.\n            schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.\n            return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.\n            one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.\n            **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.\n\n        Returns:\n            The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n            NoResultFound: If no record matches the filters. (on version 0.15.3)\n            ValueError: If extra fields not present in the model are provided in the update data.\n            ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n        Examples:\n            Update a user's email based on their ID:\n\n            ```python\n            await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n            ```\n\n            Update users to be inactive where age is greater than 30 and allow updates to multiple records:\n\n            ```python\n            await user_crud.update(\n                db,\n                {'is_active': False},\n                allow_multiple=True,\n                age__gt=30,\n            )\n            ```\n\n            Update a user's username excluding specific user ID and prevent multiple updates:\n\n            ```python\n            await user_crud.update(\n                db,\n                {'username': 'new_username'},\n                allow_multiple=False,\n                id__ne=1,\n            )\n            ```\n\n            Update a user's email and return the updated record as a Pydantic model instance:\n\n            ```python\n            user = await user_crud.update(\n                db,\n                {'email': 'new_email@example.com'},\n                schema_to_select=ReadUserSchema,\n                return_as_model=True,\n                id=1,\n            )\n            ```\n\n            Update a user's email and return the updated record as a dictionary:\n            ```python\n            user = await user_crud.update(\n                db,\n                {'email': 'new_email@example.com'},\n                return_columns=['id', 'email'],\n                id=1,\n            )\n            ```\n        \"\"\"\n        total_count = await self.count(db, **kwargs)\n        if total_count == 0:\n            raise NoResultFound(\"No record found to update.\")\n        if not allow_multiple and total_count &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to update, found {total_count}.\"\n            )\n\n        if isinstance(object, dict):\n            update_data = object\n        else:\n            update_data = object.model_dump(exclude_unset=True)\n\n        updated_at_col = getattr(self.model, self.updated_at_column, None)\n        if updated_at_col:\n            update_data[self.updated_at_column] = datetime.now(timezone.utc)\n\n        update_data_keys = set(update_data.keys())\n        model_columns = {_column.name for _column in inspect(self.model).c}\n        extra_fields = update_data_keys - model_columns\n        if extra_fields:\n            raise ValueError(f\"Extra fields provided: {extra_fields}\")\n\n        filters = self._parse_filters(**kwargs)\n        stmt = update(self.model).filter(*filters).values(update_data)\n\n        if return_as_model:\n            return_columns = self.model_col_names\n\n        if return_columns:\n            stmt = stmt.returning(*[column(name) for name in return_columns])\n            db_row = await db.execute(stmt)\n            if commit:\n                await db.commit()\n            if allow_multiple:\n                return self._as_multi_response(\n                    db_row,\n                    schema_to_select=schema_to_select,\n                    return_as_model=return_as_model,\n                )\n            return self._as_single_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n                one_or_none=one_or_none,\n            )\n\n        await db.execute(stmt)\n        if commit:\n            await db.commit()\n        return None\n\n    def _as_single_response(\n        self,\n        db_row: Result,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n        one_or_none: bool = False,\n    ) -&gt; Optional[Union[dict, SelectSchemaType]]:\n        result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n        if result is None:  # pragma: no cover\n            return None\n        out: dict = dict(result._mapping)\n        if not return_as_model:\n            return out\n        if not schema_to_select:  # pragma: no cover\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        return schema_to_select(**out)\n\n    def _as_multi_response(\n        self,\n        db_row: Result,\n        schema_to_select: Optional[type[SelectSchemaType]] = None,\n        return_as_model: bool = False,\n    ) -&gt; dict:\n        data = [dict(row) for row in db_row.mappings()]\n\n        response: dict[str, Any] = {\"data\": data}\n\n        if return_as_model:\n            if not schema_to_select:  # pragma: no cover\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_data = [schema_to_select(**row) for row in data]\n                response[\"data\"] = model_data\n            except ValidationError as e:  # pragma: no cover\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n\n        return response\n\n    async def db_delete(\n        self,\n        db: AsyncSession,\n        allow_multiple: bool = False,\n        commit: bool = True,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Deletes a record or multiple records from the database based on specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.\n\n        Returns:\n            None\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n\n        Examples:\n            Delete a user based on their ID:\n\n            ```python\n            await user_crud.db_delete(db, id=1)\n            ```\n\n            Delete users older than 30 years and allow deletion of multiple records:\n\n            ```python\n            await user_crud.db_delete(\n                db,\n                allow_multiple=True,\n                age__gt=30,\n            )\n            ```\n\n            Delete a user with a specific username, ensuring only one record is deleted:\n\n            ```python\n            await user_crud.db_delete(\n                db,\n                allow_multiple=False,\n                username='unique_username',\n            )\n            ```\n        \"\"\"\n        if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to delete, found {total_count}.\"\n            )\n\n        filters = self._parse_filters(**kwargs)\n        stmt = delete(self.model).filter(*filters)\n        await db.execute(stmt)\n        if commit:\n            await db.commit()\n\n    async def delete(\n        self,\n        db: AsyncSession,\n        db_row: Optional[Row] = None,\n        allow_multiple: bool = False,\n        commit: bool = True,\n        **kwargs: Any,\n    ) -&gt; None:\n        \"\"\"\n        Soft deletes a record or optionally multiple records if it has an `\"is_deleted\"` attribute, otherwise performs a hard delete, based on specified filters.\n\n        For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n        Args:\n            db: The database session to use for the operation.\n            db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.\n            allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n            commit: If `True`, commits the transaction immediately. Default is `True`.\n            **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.\n\n        Raises:\n            MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n            NoResultFound: If no record matches the filters.\n\n        Returns:\n            None\n\n        Examples:\n            Soft delete a specific user by ID:\n\n            ```python\n            await user_crud.delete(db, id=1)\n            ```\n\n            Soft delete users with account registration dates before 2020, allowing deletion of multiple records:\n\n            ```python\n            await user_crud.delete(\n                db,\n                allow_multiple=True,\n                creation_date__lt=datetime(2020, 1, 1),\n            )\n            ```\n\n            Soft delete a user with a specific email, ensuring only one record is deleted:\n\n            ```python\n            await user_crud.delete(\n                db,\n                allow_multiple=False,\n                email='unique@example.com',\n            )\n            ```\n        \"\"\"\n        filters = self._parse_filters(**kwargs)\n        if db_row:\n            if hasattr(db_row, self.is_deleted_column) and hasattr(\n                db_row, self.deleted_at_column\n            ):\n                setattr(db_row, self.is_deleted_column, True)\n                setattr(db_row, self.deleted_at_column, datetime.now(timezone.utc))\n                if commit:\n                    await db.commit()\n            else:\n                await db.delete(db_row)\n            if commit:\n                await db.commit()\n            return\n\n        total_count = await self.count(db, **kwargs)\n        if total_count == 0:\n            raise NoResultFound(\"No record found to delete.\")\n        if not allow_multiple and total_count &gt; 1:\n            raise MultipleResultsFound(\n                f\"Expected exactly one record to delete, found {total_count}.\"\n            )\n\n        update_values: dict[str, Union[bool, datetime]] = {}\n        if self.deleted_at_column in self.model_col_names:\n            update_values[self.deleted_at_column] = datetime.now(timezone.utc)\n        if self.is_deleted_column in self.model_col_names:\n            update_values[self.is_deleted_column] = True\n\n        if update_values:\n            update_stmt = update(self.model).filter(*filters).values(**update_values)\n            await db.execute(update_stmt)\n\n        else:\n            delete_stmt = self.model.__table__.delete().where(*filters)\n            await db.execute(delete_stmt)\n        if commit:\n            await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.count","title":"<code>count(db, joins_config=None, **kwargs)</code>  <code>async</code>","text":"<p>Counts records that match specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Can also count records based on a configuration of joins, useful for complex queries involving relationships.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>Optional configuration for applying joins in the count query.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.</p> <code>{}</code> <p>Returns:</p> Type Description <code>int</code> <p>The total number of records matching the filter conditions.</p> <p>Examples:</p> <p>Count users by ID:</p> <pre><code>count = await user_crud.count(db, id=1)\n</code></pre> <p>Count users older than 30:</p> <pre><code>count = await user_crud.count(db, age__gt=30)\n</code></pre> <p>Count users with a username other than <code>admin</code>:</p> <pre><code>count = await user_crud.count(db, username__ne='admin')\n</code></pre> <p>Count projects with at least one participant (many-to-many relationship): <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n    ),\n]\ncount = await crud.count(db, joins_config=joins_config)\n</code></pre></p> <p>Count projects by a specific participant name (filter applied on a joined model): <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'name': 'Jane Doe'},\n    ),\n]\ncount = await crud.count(db, joins_config=joins_config)\n</code></pre></p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def count(\n    self,\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int:\n    \"\"\"\n    Counts records that match specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Can also count records based on a configuration of joins, useful for complex queries involving relationships.\n\n    Args:\n        db: The database session to use for the operation.\n        joins_config: Optional configuration for applying joins in the count query.\n        **kwargs: Filters to apply for the count, including field names for equality checks or with comparison operators for advanced queries.\n\n    Returns:\n        The total number of records matching the filter conditions.\n\n    Examples:\n        Count users by ID:\n\n        ```python\n        count = await user_crud.count(db, id=1)\n        ```\n\n        Count users older than 30:\n\n        ```python\n        count = await user_crud.count(db, age__gt=30)\n        ```\n\n        Count users with a username other than `admin`:\n\n        ```python\n        count = await user_crud.count(db, username__ne='admin')\n        ```\n\n        Count projects with at least one participant (many-to-many relationship):\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n            ),\n        ]\n        count = await crud.count(db, joins_config=joins_config)\n        ```\n\n        Count projects by a specific participant name (filter applied on a joined model):\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'name': 'Jane Doe'},\n            ),\n        ]\n        count = await crud.count(db, joins_config=joins_config)\n        ```\n    \"\"\"\n    primary_filters = self._parse_filters(**kwargs)\n\n    if joins_config is not None:\n        primary_keys = [p.name for p in _get_primary_keys(self.model)]\n        if not any(primary_keys):  # pragma: no cover\n            raise ValueError(\n                f\"The model '{self.model.__name__}' does not have a primary key defined, which is required for counting with joins.\"\n            )\n        to_select = [\n            getattr(self.model, pk).label(f\"distinct_{pk}\") for pk in primary_keys\n        ]\n        base_query = select(*to_select)\n\n        for join in joins_config:\n            join_model = join.alias or join.model\n            join_filters = (\n                self._parse_filters(model=join_model, **join.filters)\n                if join.filters\n                else []\n            )\n\n            if join.join_type == \"inner\":\n                base_query = base_query.join(join_model, join.join_on)\n            else:\n                base_query = base_query.outerjoin(join_model, join.join_on)\n\n            if join_filters:\n                base_query = base_query.where(*join_filters)\n\n        if primary_filters:\n            base_query = base_query.where(*primary_filters)\n\n        subquery = base_query.subquery()\n        count_query = select(func.count()).select_from(subquery)\n    else:\n        count_query = select(func.count()).select_from(self.model)\n        if primary_filters:\n            count_query = count_query.where(*primary_filters)\n\n    total_count: Optional[int] = await db.scalar(count_query)\n    if total_count is None:\n        raise ValueError(\"Could not find the count.\")\n\n    return total_count\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.create","title":"<code>create(db, object, commit=True)</code>  <code>async</code>","text":"<p>Create a new record in the database.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>object</code> <code>CreateSchemaType</code> <p>The Pydantic schema containing the data to be saved.</p> required <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <p>Returns:</p> Type Description <code>ModelType</code> <p>The created database object.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def create(\n    self, db: AsyncSession, object: CreateSchemaType, commit: bool = True\n) -&gt; ModelType:\n    \"\"\"\n    Create a new record in the database.\n\n    Args:\n        db: The SQLAlchemy async session.\n        object: The Pydantic schema containing the data to be saved.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n\n    Returns:\n        The created database object.\n    \"\"\"\n    object_dict = object.model_dump()\n    db_object: ModelType = self.model(**object_dict)\n    db.add(db_object)\n    if commit:\n        await db.commit()\n    return db_object\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.db_delete","title":"<code>db_delete(db, allow_multiple=False, commit=True, **kwargs)</code>  <code>async</code>","text":"<p>Deletes a record or multiple records from the database based on specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows deleting multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <p>Examples:</p> <p>Delete a user based on their ID:</p> <pre><code>await user_crud.db_delete(db, id=1)\n</code></pre> <p>Delete users older than 30 years and allow deletion of multiple records:</p> <pre><code>await user_crud.db_delete(\n    db,\n    allow_multiple=True,\n    age__gt=30,\n)\n</code></pre> <p>Delete a user with a specific username, ensuring only one record is deleted:</p> <pre><code>await user_crud.db_delete(\n    db,\n    allow_multiple=False,\n    username='unique_username',\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def db_delete(\n    self,\n    db: AsyncSession,\n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Deletes a record or multiple records from the database based on specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        **kwargs: Filters to identify the record(s) to delete, including advanced comparison operators for detailed querying.\n\n    Returns:\n        None\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n\n    Examples:\n        Delete a user based on their ID:\n\n        ```python\n        await user_crud.db_delete(db, id=1)\n        ```\n\n        Delete users older than 30 years and allow deletion of multiple records:\n\n        ```python\n        await user_crud.db_delete(\n            db,\n            allow_multiple=True,\n            age__gt=30,\n        )\n        ```\n\n        Delete a user with a specific username, ensuring only one record is deleted:\n\n        ```python\n        await user_crud.db_delete(\n            db,\n            allow_multiple=False,\n            username='unique_username',\n        )\n        ```\n    \"\"\"\n    if not allow_multiple and (total_count := await self.count(db, **kwargs)) &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to delete, found {total_count}.\"\n        )\n\n    filters = self._parse_filters(**kwargs)\n    stmt = delete(self.model).filter(*filters)\n    await db.execute(stmt)\n    if commit:\n        await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.delete","title":"<code>delete(db, db_row=None, allow_multiple=False, commit=True, **kwargs)</code>  <code>async</code>","text":"<p>Soft deletes a record or optionally multiple records if it has an <code>\"is_deleted\"</code> attribute, otherwise performs a hard delete, based on specified filters.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>db_row</code> <code>Optional[Row]</code> <p>Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.</p> <code>None</code> <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows deleting multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <code>NoResultFound</code> <p>If no record matches the filters.</p> <p>Returns:</p> Type Description <code>None</code> <p>None</p> <p>Examples:</p> <p>Soft delete a specific user by ID:</p> <pre><code>await user_crud.delete(db, id=1)\n</code></pre> <p>Soft delete users with account registration dates before 2020, allowing deletion of multiple records:</p> <pre><code>await user_crud.delete(\n    db,\n    allow_multiple=True,\n    creation_date__lt=datetime(2020, 1, 1),\n)\n</code></pre> <p>Soft delete a user with a specific email, ensuring only one record is deleted:</p> <pre><code>await user_crud.delete(\n    db,\n    allow_multiple=False,\n    email='unique@example.com',\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def delete(\n    self,\n    db: AsyncSession,\n    db_row: Optional[Row] = None,\n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None:\n    \"\"\"\n    Soft deletes a record or optionally multiple records if it has an `\"is_deleted\"` attribute, otherwise performs a hard delete, based on specified filters.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        db_row: Optional existing database row to delete. If provided, the method will attempt to delete this specific row, ignoring other filters.\n        allow_multiple: If `True`, allows deleting multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        **kwargs: Filters to identify the record(s) to delete, supporting advanced comparison operators for refined querying.\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n        NoResultFound: If no record matches the filters.\n\n    Returns:\n        None\n\n    Examples:\n        Soft delete a specific user by ID:\n\n        ```python\n        await user_crud.delete(db, id=1)\n        ```\n\n        Soft delete users with account registration dates before 2020, allowing deletion of multiple records:\n\n        ```python\n        await user_crud.delete(\n            db,\n            allow_multiple=True,\n            creation_date__lt=datetime(2020, 1, 1),\n        )\n        ```\n\n        Soft delete a user with a specific email, ensuring only one record is deleted:\n\n        ```python\n        await user_crud.delete(\n            db,\n            allow_multiple=False,\n            email='unique@example.com',\n        )\n        ```\n    \"\"\"\n    filters = self._parse_filters(**kwargs)\n    if db_row:\n        if hasattr(db_row, self.is_deleted_column) and hasattr(\n            db_row, self.deleted_at_column\n        ):\n            setattr(db_row, self.is_deleted_column, True)\n            setattr(db_row, self.deleted_at_column, datetime.now(timezone.utc))\n            if commit:\n                await db.commit()\n        else:\n            await db.delete(db_row)\n        if commit:\n            await db.commit()\n        return\n\n    total_count = await self.count(db, **kwargs)\n    if total_count == 0:\n        raise NoResultFound(\"No record found to delete.\")\n    if not allow_multiple and total_count &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to delete, found {total_count}.\"\n        )\n\n    update_values: dict[str, Union[bool, datetime]] = {}\n    if self.deleted_at_column in self.model_col_names:\n        update_values[self.deleted_at_column] = datetime.now(timezone.utc)\n    if self.is_deleted_column in self.model_col_names:\n        update_values[self.is_deleted_column] = True\n\n    if update_values:\n        update_stmt = update(self.model).filter(*filters).values(**update_values)\n        await db.execute(update_stmt)\n\n    else:\n        delete_stmt = self.model.__table__.delete().where(*filters)\n        await db.execute(delete_stmt)\n    if commit:\n        await db.commit()\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.exists","title":"<code>exists(db, **kwargs)</code>  <code>async</code>","text":"<p>Checks if any records exist that match the given filter conditions.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.</p> <code>{}</code> <p>Returns:</p> Type Description <code>bool</code> <p><code>True</code> if at least one record matches the filter conditions, <code>False</code> otherwise.</p> <p>Examples:</p> <p>Check if a user with a specific ID exists:</p> <pre><code>exists = await user_crud.exists(db, id=1)\n</code></pre> <p>Check if any user is older than 30:</p> <pre><code>exists = await user_crud.exists(db, age__gt=30)\n</code></pre> <p>Check if any user was registered before Jan 1, 2020:</p> <pre><code>exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n</code></pre> <p>Check if a username other than <code>admin</code> exists:</p> <pre><code>exists = await user_crud.exists(db, username__ne='admin')\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def exists(self, db: AsyncSession, **kwargs: Any) -&gt; bool:\n    \"\"\"\n    Checks if any records exist that match the given filter conditions.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        **kwargs: Filters to apply to the query, supporting both direct matches and advanced comparison operators for refined search criteria.\n\n    Returns:\n        `True` if at least one record matches the filter conditions, `False` otherwise.\n\n    Examples:\n        Check if a user with a specific ID exists:\n\n        ```python\n        exists = await user_crud.exists(db, id=1)\n        ```\n\n        Check if any user is older than 30:\n\n        ```python\n        exists = await user_crud.exists(db, age__gt=30)\n        ```\n\n        Check if any user was registered before Jan 1, 2020:\n\n        ```python\n        exists = await user_crud.exists(db, registration_date__lt=datetime(2020, 1, 1))\n        ```\n\n        Check if a username other than `admin` exists:\n\n        ```python\n        exists = await user_crud.exists(db, username__ne='admin')\n        ```\n    \"\"\"\n    filters = self._parse_filters(**kwargs)\n    stmt = select(self.model).filter(*filters).limit(1)\n\n    result = await db.execute(stmt)\n    return result.first() is not None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get","title":"<code>get(db, schema_to_select=None, return_as_model=False, one_or_none=False, **kwargs)</code>  <code>async</code>","text":"<p>Fetches a single record based on specified filters.</p> <p>This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Optional Pydantic schema for selecting specific columns.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <code>one_or_none</code> <code>bool</code> <p>Flag to get strictly one or no result. Multiple results are not allowed.</p> <code>False</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.</p> <code>{}</code> <p>Raises:</p> Type Description <code>ValueError</code> <p>If <code>return_as_model</code> is <code>True</code> but <code>schema_to_select</code> is not provided.</p> <p>Returns:</p> Type Description <code>Optional[Union[dict, SelectSchemaType]]</code> <p>A dictionary or a Pydantic model instance of the fetched database row, or <code>None</code> if no match is found.</p> <p>Examples:</p> <p>Fetch a user by ID:</p> <pre><code>user = await user_crud.get(db, id=1)\n</code></pre> <p>Fetch a user with an age greater than 30:</p> <pre><code>user = await user_crud.get(db, age__gt=30)\n</code></pre> <p>Fetch a user with a registration date before Jan 1, 2020:</p> <pre><code>user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n</code></pre> <p>Fetch a user not equal to a specific username:</p> <pre><code>user = await user_crud.get(db, username__ne='admin')\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, SelectSchemaType]]:\n    \"\"\"\n    Fetches a single record based on specified filters.\n\n    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        schema_to_select: Optional Pydantic schema for selecting specific columns.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n        one_or_none: Flag to get strictly one or no result. Multiple results are not allowed.\n        **kwargs: Filters to apply to the query, using field names for direct matches or appending comparison operators for advanced queries.\n\n    Raises:\n        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n    Returns:\n        A dictionary or a Pydantic model instance of the fetched database row, or `None` if no match is found.\n\n    Examples:\n        Fetch a user by ID:\n\n        ```python\n        user = await user_crud.get(db, id=1)\n        ```\n\n        Fetch a user with an age greater than 30:\n\n        ```python\n        user = await user_crud.get(db, age__gt=30)\n        ```\n\n        Fetch a user with a registration date before Jan 1, 2020:\n\n        ```python\n        user = await user_crud.get(db, registration_date__lt=datetime(2020, 1, 1))\n        ```\n\n        Fetch a user not equal to a specific username:\n\n        ```python\n        user = await user_crud.get(db, username__ne='admin')\n        ```\n    \"\"\"\n    stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n    db_row = await db.execute(stmt)\n    result: Optional[Row] = db_row.one_or_none() if one_or_none else db_row.first()\n    if result is None:\n        return None\n    out: dict = dict(result._mapping)\n    if not return_as_model:\n        return out\n    if not schema_to_select:\n        raise ValueError(\n            \"schema_to_select must be provided when return_as_model is True.\"\n        )\n    return schema_to_select(**out)\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_joined","title":"<code>get_joined(db, schema_to_select=None, join_model=None, join_on=None, join_prefix=None, join_schema_to_select=None, join_type='left', alias=None, join_filters=None, joins_config=None, nest_joins=False, relationship_type=None, **kwargs)</code>  <code>async</code>","text":"<p>Fetches a single record with one or multiple joins on other models. If <code>join_on</code> is not provided, the method attempts to automatically detect the join condition using foreign key relationships. For multiple joins, use <code>joins_config</code> to specify each join configuration.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns from the primary model. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>join_model</code> <code>Optional[ModelType]</code> <p>The model to join with.</p> <code>None</code> <code>join_on</code> <code>Optional[Union[Join, BinaryExpression]]</code> <p>SQLAlchemy Join object for specifying the <code>ON</code> clause of the join. If <code>None</code>, the join condition is auto-detected based on foreign keys.</p> <code>None</code> <code>join_prefix</code> <code>Optional[str]</code> <p>Optional prefix to be added to all columns of the joined model. If <code>None</code>, no prefix is added.</p> <code>None</code> <code>join_schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns from the joined model.</p> <code>None</code> <code>join_type</code> <code>str</code> <p>Specifies the type of join operation to perform. Can be <code>\"left\"</code> for a left outer join or <code>\"inner\"</code> for an inner join.</p> <code>'left'</code> <code>alias</code> <code>Optional[AliasedClass]</code> <p>An instance of <code>AliasedClass</code> for the join model, useful for self-joins or multiple joins on the same model. Result of <code>aliased(join_model)</code>.</p> <code>None</code> <code>join_filters</code> <code>Optional[dict]</code> <p>Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</p> <code>None</code> <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>A list of <code>JoinConfig</code> instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.</p> <code>None</code> <code>nest_joins</code> <code>bool</code> <p>If <code>True</code>, nested data structures will be returned where joined model data are nested under the <code>join_prefix</code> as a dictionary.</p> <code>False</code> <code>relationship_type</code> <code>Optional[str]</code> <p>Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Used to determine how to nest the joined data. If <code>None</code>, uses <code>\"one-to-one\"</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[dict[str, Any]]</code> <p>A dictionary representing the joined record, or <code>None</code> if no record matches the criteria.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If both single join parameters and <code>joins_config</code> are used simultaneously.</p> <code>ArgumentError</code> <p>If any provided model in <code>joins_config</code> is not recognized or invalid.</p> <code>NoResultFound</code> <p>If no record matches the criteria with the provided filters.</p> <p>Examples:</p> <p>Simple example: Joining <code>User</code> and <code>Tier</code> models without explicitly providing <code>join_on</code></p> <pre><code>result = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n)\n</code></pre> <p>Fetch a user and their associated tier, filtering by user ID:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    id=1,\n)\n</code></pre> <p>Fetch a user and their associated tier, where the user's age is greater than 30:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    age__gt=30,\n)\n</code></pre> <p>Fetch a user and their associated tier, excluding users with the <code>admin</code> username:</p> <pre><code>result = await user_crud.get_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    username__ne='admin',\n)\n</code></pre> <p>Complex example: Joining with a custom join condition, additional filter parameters, and a prefix</p> <pre><code>from sqlalchemy import and_\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    username=\"john_doe\",\n)\n</code></pre> <p>Example of using <code>joins_config</code> for multiple joins:</p> <pre><code>from fastcrud import JoinConfig\n\n# Using same User/Tier/Department models/schemas as above.\n\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n)\n</code></pre> <p>Using <code>alias</code> for joining the same model multiple times: <pre><code>from fastcrud import aliased\n\nowner_alias = aliased(ModelTest, name=\"owner\")\nuser_alias = aliased(ModelTest, name=\"user\")\n\nresult = await crud.get_joined(\n    db=session,\n    schema_to_select=BookingSchema,\n    joins_config=[\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.owner_id == owner_alias.id,\n            join_prefix=\"owner_\",\n            alias=owner_alias,\n            schema_to_select=UserSchema,\n        ),\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.user_id == user_alias.id,\n            join_prefix=\"user_\",\n            alias=user_alias,\n            schema_to_select=UserSchema,\n        ),\n    ],\n    id=1,\n)\n</code></pre></p> <p>Fetching a single project and its associated participants where a participant has a specific role: <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'role': 'Designer'},\n    ),\n]\nproject = await crud.get_joined(\n    db=session,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n)\n</code></pre></p> <p>Example of using <code>joins_config</code> for multiple joins with nested joins enabled:</p> <pre><code>from fastcrud import JoinConfig\n\nresult = await user_crud.get_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n    nest_joins=True,\n)\n# Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n</code></pre> <p>Example using one-to-one relationship:</p> <pre><code>author_crud = FastCRUD(Author)\nresult = await author_crud.get_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Profile,\n    join_on=Author.profile_id == Profile.id,\n    join_schema_to_select=ReadProfileSchema,\n    nest_joins=True,\n    relationship_type='one-to-one', # note that this is the default behavior\n)\n# Expect 'result' to have 'profile' as a nested dictionary\n</code></pre> <p>Example using one-to-many relationship:</p> <pre><code>result = await author_crud.get_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_schema_to_select=ReadArticleSchema,\n    nest_joins=True,\n    relationship_type='one-to-many',\n)\n# Expect 'result' to have 'posts' as a nested list of dictionaries\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_joined(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    join_model: Optional[ModelType] = None,\n    join_on: Optional[Union[Join, BinaryExpression]] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[SelectSchemaType]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass] = None,\n    join_filters: Optional[dict] = None,\n    joins_config: Optional[list[JoinConfig]] = None,\n    nest_joins: bool = False,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; Optional[dict[str, Any]]:\n    \"\"\"\n    Fetches a single record with one or multiple joins on other models. If `join_on` is not provided, the method attempts\n    to automatically detect the join condition using foreign key relationships. For multiple joins, use `joins_config` to\n    specify each join configuration.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n        join_model: The model to join with.\n        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n        join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n        joins_config: A list of `JoinConfig` instances, each specifying a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and the type of join. This parameter enables support for multiple joins.\n        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n        relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n        **kwargs: Filters to apply to the primary model query, supporting advanced comparison operators for refined searching.\n\n    Returns:\n        A dictionary representing the joined record, or `None` if no record matches the criteria.\n\n    Raises:\n        ValueError: If both single join parameters and `joins_config` are used simultaneously.\n        ArgumentError: If any provided model in `joins_config` is not recognized or invalid.\n        NoResultFound: If no record matches the criteria with the provided filters.\n\n    Examples:\n        Simple example: Joining `User` and `Tier` models without explicitly providing `join_on`\n\n        ```python\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n        )\n        ```\n\n        Fetch a user and their associated tier, filtering by user ID:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            id=1,\n        )\n        ```\n\n        Fetch a user and their associated tier, where the user's age is greater than 30:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            age__gt=30,\n        )\n        ```\n\n        Fetch a user and their associated tier, excluding users with the `admin` username:\n\n        ```python\n        result = await user_crud.get_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            username__ne='admin',\n        )\n        ```\n\n        Complex example: Joining with a custom join condition, additional filter parameters, and a prefix\n\n        ```python\n        from sqlalchemy import and_\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_on=and_(User.tier_id == Tier.id, User.is_superuser == True),\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            username=\"john_doe\",\n        )\n        ```\n\n        Example of using `joins_config` for multiple joins:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        # Using same User/Tier/Department models/schemas as above.\n\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n        )\n        ```\n\n        Using `alias` for joining the same model multiple times:\n        ```python\n        from fastcrud import aliased\n\n        owner_alias = aliased(ModelTest, name=\"owner\")\n        user_alias = aliased(ModelTest, name=\"user\")\n\n        result = await crud.get_joined(\n            db=session,\n            schema_to_select=BookingSchema,\n            joins_config=[\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.owner_id == owner_alias.id,\n                    join_prefix=\"owner_\",\n                    alias=owner_alias,\n                    schema_to_select=UserSchema,\n                ),\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.user_id == user_alias.id,\n                    join_prefix=\"user_\",\n                    alias=user_alias,\n                    schema_to_select=UserSchema,\n                ),\n            ],\n            id=1,\n        )\n        ```\n\n        Fetching a single project and its associated participants where a participant has a specific role:\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'role': 'Designer'},\n            ),\n        ]\n        project = await crud.get_joined(\n            db=session,\n            schema_to_select=ProjectSchema,\n            joins_config=joins_config,\n        )\n        ```\n\n        Example of using `joins_config` for multiple joins with nested joins enabled:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        result = await user_crud.get_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n            nest_joins=True,\n        )\n        # Expect 'result' to have 'tier' and 'dept' as nested dictionaries\n        ```\n\n        Example using one-to-one relationship:\n\n        ```python\n        author_crud = FastCRUD(Author)\n        result = await author_crud.get_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Profile,\n            join_on=Author.profile_id == Profile.id,\n            join_schema_to_select=ReadProfileSchema,\n            nest_joins=True,\n            relationship_type='one-to-one', # note that this is the default behavior\n        )\n        # Expect 'result' to have 'profile' as a nested dictionary\n        ```\n\n        Example using one-to-many relationship:\n\n        ```python\n        result = await author_crud.get_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Article,\n            join_on=Author.id == Article.author_id,\n            join_schema_to_select=ReadArticleSchema,\n            nest_joins=True,\n            relationship_type='one-to-many',\n        )\n        # Expect 'result' to have 'posts' as a nested list of dictionaries\n        ```\n    \"\"\"\n    if joins_config and (\n        join_model or join_prefix or join_on or join_schema_to_select or alias\n    ):\n        raise ValueError(\n            \"Cannot use both single join parameters and joins_config simultaneously.\"\n        )\n    elif not joins_config and not join_model:\n        raise ValueError(\"You need one of join_model or joins_config.\")\n\n    primary_select = _extract_matching_columns_from_schema(\n        model=self.model,\n        schema=schema_to_select,\n    )\n    stmt: Select = select(*primary_select).select_from(self.model)\n\n    join_definitions = joins_config if joins_config else []\n    if join_model:\n        join_definitions.append(\n            JoinConfig(\n                model=join_model,\n                join_on=join_on,\n                join_prefix=join_prefix,\n                schema_to_select=join_schema_to_select,\n                join_type=join_type,\n                alias=alias,\n                filters=join_filters,\n                relationship_type=relationship_type,\n            )\n        )\n\n    stmt = self._prepare_and_apply_joins(\n        stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n    )\n    primary_filters = self._parse_filters(**kwargs)\n    if primary_filters:\n        stmt = stmt.filter(*primary_filters)\n\n    db_rows = await db.execute(stmt)\n    if any(join.relationship_type == \"one-to-many\" for join in join_definitions):\n        if nest_joins is False:  # pragma: no cover\n            raise ValueError(\n                \"Cannot use one-to-many relationship with nest_joins=False\"\n            )\n        results = db_rows.fetchall()\n        data_list = [dict(row._mapping) for row in results]\n    else:\n        result = db_rows.first()\n        if result is not None:\n            data_list = [dict(result._mapping)]\n        else:\n            data_list = []\n\n    if data_list:\n        if nest_joins:\n            nested_data: dict = {}\n            for data in data_list:\n                nested_data = _nest_join_data(\n                    data,\n                    join_definitions,\n                    nested_data=nested_data,\n                )\n            return nested_data\n        return data_list[0]\n\n    return None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi","title":"<code>get_multi(db, offset=0, limit=100, schema_to_select=None, sort_columns=None, sort_orders=None, return_as_model=False, return_total_count=True, **kwargs)</code>  <code>async</code>","text":"<p>Fetches multiple records based on filters, supporting sorting, pagination.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>offset</code> <code>int</code> <p>Starting index for records to fetch, useful for pagination.</p> <code>0</code> <code>limit</code> <code>Optional[int]</code> <p>Maximum number of records to fetch in one call. Use <code>None</code> for \"no limit\", fetching all matching rows. Note that in order to use <code>limit=None</code>, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</p> <code>100</code> <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Optional Pydantic schema for selecting specific columns. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>Column names to sort the results by.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>Corresponding sort orders (<code>\"asc\"</code>, <code>\"desc\"</code>) for each column in <code>sort_columns</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, returns data as instances of the specified Pydantic model.</p> <code>False</code> <code>return_total_count</code> <code>bool</code> <p>If <code>True</code>, also returns the total count of rows with the selected filters. Useful for pagination.</p> <code>True</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for more detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]</code> <p>A dictionary containing the data list and optionally the total count:</p> <code>Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]</code> <ul> <li>With return_as_model=True: Dict with \"data\": List[SelectSchemaType]</li> </ul> <code>Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]</code> <ul> <li>With return_as_model=False: Dict with \"data\": List[Dict[str, Any]]</li> </ul> <code>Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]</code> <ul> <li>If return_total_count=True, includes \"total_count\": int</li> </ul> <p>Raises:</p> Type Description <code>ValueError</code> <p>If <code>limit</code> or <code>offset</code> is negative, or if <code>schema_to_select</code> is required but not provided or invalid.</p> <p>Examples:</p> <p>Fetch the first 10 users:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    0,\n    10,\n)\n</code></pre> <p>Fetch next 10 users with sorted by username:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    10,\n    10,\n    sort_columns='username',\n    sort_orders='desc',\n)\n</code></pre> <p>Fetch 10 users older than 30, sorted by age in descending order:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns='age',\n    sort_orders='desc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch 10 users with a registration date before Jan 1, 2020: <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    registration_date__lt=datetime(2020, 1, 1),\n)\n</code></pre></p> <p>Fetch 10 users with a username other than <code>admin</code>, returning as model instances (ensure appropriate schema is passed):</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    schema_to_select=ReadUserSchema,\n    return_as_model=True,\n    username__ne='admin',\n)\n</code></pre> <p>Fetch users with filtering and multiple column sorting:</p> <pre><code>users = await user_crud.get_multi(\n    db,\n    0,\n    10,\n    sort_columns=['username', 'email'],\n    sort_orders=['asc', 'desc'],\n    is_active=True,\n)\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi(\n    self,\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; Union[GetMultiResponseModel[SelectSchemaType], GetMultiResponseDict]:\n    \"\"\"\n    Fetches multiple records based on filters, supporting sorting, pagination.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        offset: Starting index for records to fetch, useful for pagination.\n        limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if `return_as_model` is True.\n        sort_columns: Column names to sort the results by.\n        sort_orders: Corresponding sort orders (`\"asc\"`, `\"desc\"`) for each column in `sort_columns`.\n        return_as_model: If `True`, returns data as instances of the specified Pydantic model.\n        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n    Returns:\n        A dictionary containing the data list and optionally the total count:\n        - With return_as_model=True: Dict with \"data\": List[SelectSchemaType]\n        - With return_as_model=False: Dict with \"data\": List[Dict[str, Any]]\n        - If return_total_count=True, includes \"total_count\": int\n\n    Raises:\n        ValueError: If `limit` or `offset` is negative, or if `schema_to_select` is required but not provided or invalid.\n\n    Examples:\n        Fetch the first 10 users:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            0,\n            10,\n        )\n        ```\n\n        Fetch next 10 users with sorted by username:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            10,\n            10,\n            sort_columns='username',\n            sort_orders='desc',\n        )\n        ```\n\n        Fetch 10 users older than 30, sorted by age in descending order:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            sort_columns='age',\n            sort_orders='desc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch 10 users with a registration date before Jan 1, 2020:\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            registration_date__lt=datetime(2020, 1, 1),\n        )\n        ```\n\n        Fetch 10 users with a username other than `admin`, returning as model instances (ensure appropriate schema is passed):\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            offset=0,\n            limit=10,\n            schema_to_select=ReadUserSchema,\n            return_as_model=True,\n            username__ne='admin',\n        )\n        ```\n\n        Fetch users with filtering and multiple column sorting:\n\n        ```python\n        users = await user_crud.get_multi(\n            db,\n            0,\n            10,\n            sort_columns=['username', 'email'],\n            sort_orders=['asc', 'desc'],\n            is_active=True,\n        )\n        ```\n    \"\"\"\n    if (limit is not None and limit &lt; 0) or offset &lt; 0:\n        raise ValueError(\"Limit and offset must be non-negative.\")\n\n    stmt = await self.select(\n        schema_to_select=schema_to_select,\n        sort_columns=sort_columns,\n        sort_orders=sort_orders,\n        **kwargs,\n    )\n\n    if offset:\n        stmt = stmt.offset(offset)\n    if limit is not None:\n        stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data = [dict(row) for row in result.mappings()]\n\n    response: dict[str, Any] = {\"data\": data}\n\n    if return_total_count:\n        total_count = await self.count(db=db, **kwargs)\n        response[\"total_count\"] = total_count\n\n    if return_as_model:\n        if not schema_to_select:\n            raise ValueError(\n                \"schema_to_select must be provided when return_as_model is True.\"\n            )\n        try:\n            model_data = [schema_to_select(**row) for row in data]\n            response[\"data\"] = model_data\n        except ValidationError as e:\n            raise ValueError(\n                f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n            )\n\n    return response\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi_by_cursor","title":"<code>get_multi_by_cursor(db, cursor=None, limit=100, schema_to_select=None, sort_column='id', sort_order='asc', **kwargs)</code>  <code>async</code>","text":"<p>Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>cursor</code> <code>Any</code> <p>The cursor value to start fetching records from. Defaults to <code>None</code>.</p> <code>None</code> <code>limit</code> <code>int</code> <p>Maximum number of rows to fetch.</p> <code>100</code> <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns.</p> <code>None</code> <code>sort_column</code> <code>str</code> <p>Column name to use for sorting and cursor pagination.</p> <code>'id'</code> <code>sort_order</code> <code>str</code> <p>Sorting direction, either <code>\"asc\"</code> or <code>\"desc\"</code>.</p> <code>'asc'</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A dictionary containing the fetched rows under <code>\"data\"</code> key and the next cursor value under <code>\"next_cursor\"</code>.</p> <p>Examples:</p> <p>Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='registration_date',\n    sort_order='desc',\n)\n\n# Fetch the next set of records using the cursor from the first page\nnext_cursor = first_page['next_cursor']\nsecond_page = await user_crud.get_multi_by_cursor(\n    db,\n    cursor=next_cursor,\n    limit=10,\n    sort_column='registration_date',\n    sort_order='desc',\n)\n</code></pre> <p>Fetch records with age greater than 30 using cursor-based pagination:</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='age',\n    sort_order='asc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch records excluding a specific username using cursor-based pagination:</p> <pre><code>first_page = await user_crud.get_multi_by_cursor(\n    db,\n    limit=10,\n    sort_column='username',\n    sort_order='asc',\n    username__ne='admin',\n)\n</code></pre> Note <p>This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features. Make sure the column used for cursor pagination is indexed for performance. This method assumes that your records can be ordered by a unique, sequential field (like <code>id</code> or <code>created_at</code>).</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi_by_cursor(\n    self,\n    db: AsyncSession,\n    cursor: Any = None,\n    limit: int = 100,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    sort_column: str = \"id\",\n    sort_order: str = \"asc\",\n    **kwargs: Any,\n) -&gt; dict[str, Any]:\n    \"\"\"\n    Implements cursor-based pagination for fetching records. This method is designed for efficient data retrieval in large datasets and is ideal for features like infinite scrolling.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        cursor: The cursor value to start fetching records from. Defaults to `None`.\n        limit: Maximum number of rows to fetch.\n        schema_to_select: Pydantic schema for selecting specific columns.\n        sort_column: Column name to use for sorting and cursor pagination.\n        sort_order: Sorting direction, either `\"asc\"` or `\"desc\"`.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for detailed querying.\n\n    Returns:\n        A dictionary containing the fetched rows under `\"data\"` key and the next cursor value under `\"next_cursor\"`.\n\n    Examples:\n        Fetch the first set of records (e.g., the first page in an infinite scrolling scenario):\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='registration_date',\n            sort_order='desc',\n        )\n\n        # Fetch the next set of records using the cursor from the first page\n        next_cursor = first_page['next_cursor']\n        second_page = await user_crud.get_multi_by_cursor(\n            db,\n            cursor=next_cursor,\n            limit=10,\n            sort_column='registration_date',\n            sort_order='desc',\n        )\n        ```\n\n        Fetch records with age greater than 30 using cursor-based pagination:\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='age',\n            sort_order='asc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch records excluding a specific username using cursor-based pagination:\n\n        ```python\n        first_page = await user_crud.get_multi_by_cursor(\n            db,\n            limit=10,\n            sort_column='username',\n            sort_order='asc',\n            username__ne='admin',\n        )\n        ```\n\n    Note:\n        This method is designed for efficient pagination in large datasets and is ideal for infinite scrolling features.\n        Make sure the column used for cursor pagination is indexed for performance.\n        This method assumes that your records can be ordered by a unique, sequential field (like `id` or `created_at`).\n    \"\"\"\n    if limit == 0:\n        return {\"data\": [], \"next_cursor\": None}\n\n    stmt = await self.select(schema_to_select=schema_to_select, **kwargs)\n\n    if cursor:\n        if sort_order == \"asc\":\n            stmt = stmt.filter(getattr(self.model, sort_column) &gt; cursor)\n        else:\n            stmt = stmt.filter(getattr(self.model, sort_column) &lt; cursor)\n\n    stmt = stmt.order_by(\n        asc(getattr(self.model, sort_column))\n        if sort_order == \"asc\"\n        else desc(getattr(self.model, sort_column))\n    )\n    stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data = [dict(row) for row in result.mappings()]\n\n    next_cursor = None\n    if len(data) == limit:\n        if sort_order == \"asc\":\n            next_cursor = data[-1][sort_column]\n        else:\n            data[0][sort_column]\n\n    return {\"data\": data, \"next_cursor\": next_cursor}\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.get_multi_joined","title":"<code>get_multi_joined(db, schema_to_select=None, join_model=None, join_on=None, join_prefix=None, join_schema_to_select=None, join_type='left', alias=None, join_filters=None, nest_joins=False, offset=0, limit=100, sort_columns=None, sort_orders=None, return_as_model=False, joins_config=None, return_total_count=True, relationship_type=None, **kwargs)</code>  <code>async</code>","text":"<p>Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The SQLAlchemy async session.</p> required <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns from the primary model. Required if <code>return_as_model</code> is True.</p> <code>None</code> <code>join_model</code> <code>Optional[type[ModelType]]</code> <p>The model to join with.</p> <code>None</code> <code>join_on</code> <code>Optional[Any]</code> <p>SQLAlchemy Join object for specifying the <code>ON</code> clause of the join. If <code>None</code>, the join condition is auto-detected based on foreign keys.</p> <code>None</code> <code>join_prefix</code> <code>Optional[str]</code> <p>Optional prefix to be added to all columns of the joined model. If <code>None</code>, no prefix is added.</p> <code>None</code> <code>join_schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns from the joined model.</p> <code>None</code> <code>join_type</code> <code>str</code> <p>Specifies the type of join operation to perform. Can be <code>\"left\"</code> for a left outer join or <code>\"inner\"</code> for an inner join.</p> <code>'left'</code> <code>alias</code> <code>Optional[AliasedClass[Any]]</code> <p>An instance of <code>AliasedClass</code> for the join model, useful for self-joins or multiple joins on the same model. Result of <code>aliased(join_model)</code>.</p> <code>None</code> <code>join_filters</code> <code>Optional[dict]</code> <p>Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.</p> <code>None</code> <code>nest_joins</code> <code>bool</code> <p>If <code>True</code>, nested data structures will be returned where joined model data are nested under the <code>join_prefix</code> as a dictionary.</p> <code>False</code> <code>offset</code> <code>int</code> <p>The offset (number of records to skip) for pagination.</p> <code>0</code> <code>limit</code> <code>Optional[int]</code> <p>Maximum number of records to fetch in one call. Use <code>None</code> for \"no limit\", fetching all matching rows. Note that in order to use <code>limit=None</code>, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.</p> <code>100</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>A single column name or a list of column names on which to apply sorting.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>A single sort order (<code>\"asc\"</code> or <code>\"desc\"</code>) or a list of sort orders corresponding to the columns in <code>sort_columns</code>. If not provided, defaults to <code>\"asc\"</code> for each column.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <code>joins_config</code> <code>Optional[list[JoinConfig]]</code> <p>List of <code>JoinConfig</code> instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.</p> <code>None</code> <code>return_total_count</code> <code>bool</code> <p>If <code>True</code>, also returns the total count of rows with the selected filters. Useful for pagination.</p> <code>True</code> <code>relationship_type</code> <code>Optional[str]</code> <p>Specifies the relationship type, such as <code>\"one-to-one\"</code> or <code>\"one-to-many\"</code>. Used to determine how to nest the joined data. If <code>None</code>, uses <code>\"one-to-one\"</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the primary query, including advanced comparison operators for refined searching.</p> <code>{}</code> <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A dictionary containing the fetched rows under <code>\"data\"</code> key and total count under <code>\"total_count\"</code>.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If either <code>limit</code> or <code>offset</code> are negative, or if <code>schema_to_select</code> is required but not provided or invalid.         Also if both <code>joins_config</code> and any of the single join parameters are provided or none of <code>joins_config</code> and <code>join_model</code> is provided.</p> <p>Examples:</p> <p>Fetching multiple <code>User</code> records joined with <code>Tier</code> records, using left join, returning raw data:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n)\n</code></pre> <p>Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    sort_columns='username',\n    sort_orders='asc',\n    age__gt=30,\n)\n</code></pre> <p>Fetch users joined with their tiers, excluding users with <code>admin</code> username, returning as model instances:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_schema_to_select=ReadTierSchema,\n    return_as_model=True,\n    username__ne='admin',\n)\n</code></pre> <p>Fetching and sorting by username in descending order, returning as Pydantic model:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n    sort_columns=['username'],\n    sort_orders=['desc'],\n    return_as_model=True,\n)\n</code></pre> <p>Fetching with complex conditions and custom join, returning as Pydantic model:</p> <pre><code>users = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    join_model=Tier,\n    join_on=User.tier_id == Tier.id,\n    join_prefix=\"tier_\",\n    join_schema_to_select=ReadTierSchema,\n    offset=0,\n    limit=10,\n    return_as_model=True,\n    is_active=True,\n)\n</code></pre> <p>Example using <code>joins_config</code> for multiple joins:</p> <pre><code>from fastcrud import JoinConfig\n\nusers = await user_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadUserSchema,\n    joins_config=[\n        JoinConfig(\n            model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            schema_to_select=ReadTierSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=Department,\n            join_on=User.department_id == Department.id,\n            join_prefix=\"dept_\",\n            schema_to_select=ReadDepartmentSchema,\n            join_type=\"inner\",\n        ),\n    ],\n    offset=0,\n    limit=10,\n    sort_columns='username',\n    sort_orders='asc',\n)\n</code></pre> <p>Example using <code>alias</code> for multiple joins, with pagination, sorting, and model conversion: <pre><code>from fastcrud import JoinConfig, FastCRUD, aliased\n\n# Aliasing for self-joins or multiple joins on the same table\nowner_alias = aliased(ModelTest, name=\"owner\")\nuser_alias = aliased(ModelTest, name=\"user\")\n\n# Initialize your FastCRUD instance for BookingModel\ncrud = FastCRUD(BookingModel)\n\nresult = await crud.get_multi_joined(\n    db=session,\n    schema_to_select=BookingSchema,  # Primary model schema\n    joins_config=[\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.owner_id == owner_alias.id,\n            join_prefix=\"owner_\",\n            schema_to_select=UserSchema,  # Schema for the joined model\n            alias=owner_alias,\n        ),\n        JoinConfig(\n            model=ModelTest,\n            join_on=BookingModel.user_id == user_alias.id,\n            join_prefix=\"user_\",\n            schema_to_select=UserSchema,\n            alias=user_alias,\n        )\n    ],\n    offset=10,  # Skip the first 10 records\n    limit=5,  # Fetch up to 5 records\n    sort_columns=['booking_date'],  # Sort by booking_date\n    sort_orders=['desc'],  # In descending order\n)\n</code></pre></p> <p>Fetching multiple project records and their associated participants where participants have a specific role: <pre><code>joins_config = [\n    JoinConfig(\n        model=ProjectsParticipantsAssociation,\n        join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n        join_type=\"inner\",\n    ),\n    JoinConfig(\n        model=Participant,\n        join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n        join_type=\"inner\",\n        filters={'role': 'Developer'},\n    ),\n]\nprojects = await crud.get_multi_joined(\n    db=session,\n    schema_to_select=ProjectSchema,\n    joins_config=joins_config,\n    limit=10,\n)\n</code></pre></p> <p>Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:</p> <pre><code>story_crud = FastCRUD(Story)\nstories = await story_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadStorySchema,\n    joins_config=[\n        JoinConfig(\n            model=Task,\n            join_on=Story.id == Task.story_id,\n            join_prefix=\"task_\",\n            schema_to_select=ReadTaskSchema,\n            join_type=\"left\",\n        ),\n        JoinConfig(\n            model=User,\n            join_on=Task.creator_id == User.id,\n            join_prefix=\"creator_\",\n            schema_to_select=ReadUserSchema,\n            join_type=\"left\",\n            alias=aliased(User, name=\"task_creator\"),\n        ),\n    ],\n    nest_joins=True,\n    offset=0,\n    limit=5,\n    sort_columns='name',\n    sort_orders='asc',\n)\n</code></pre> <p>Example using one-to-one relationship:</p> <pre><code>author_crud = FastCRUD(Author)\nresults = await author_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Profile,\n    join_on=Author.profile_id == Profile.id,\n    join_schema_to_select=ReadProfileSchema,\n    nest_joins=True,\n    offset=0,\n    limit=10,\n    relationship_type='one-to-one', # note that this is the default behavior\n)\n# Expect 'profile' to be nested as a dictionary under each user\n</code></pre> <p>Example using one-to-many relationship:</p> <pre><code>results = await author_crud.get_multi_joined(\n    db=session,\n    schema_to_select=ReadAuthorSchema,\n    join_model=Article,\n    join_on=Author.id == Article.author_id,\n    join_schema_to_select=ReadArticleSchema,\n    nest_joins=True,\n    offset=0,\n    limit=10,\n    relationship_type='one-to-many',\n)\n# Expect 'posts' to be nested as a list of dictionaries under each user\n</code></pre> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def get_multi_joined(\n    self,\n    db: AsyncSession,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    join_model: Optional[type[ModelType]] = None,\n    join_on: Optional[Any] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[SelectSchemaType]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass[Any]] = None,\n    join_filters: Optional[dict] = None,\n    nest_joins: bool = False,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    joins_config: Optional[list[JoinConfig]] = None,\n    return_total_count: bool = True,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; dict[str, Any]:\n    \"\"\"\n    Fetch multiple records with a join on another model, allowing for pagination, optional sorting, and model conversion.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The SQLAlchemy async session.\n        schema_to_select: Pydantic schema for selecting specific columns from the primary model. Required if `return_as_model` is True.\n        join_model: The model to join with.\n        join_on: SQLAlchemy Join object for specifying the `ON` clause of the join. If `None`, the join condition is auto-detected based on foreign keys.\n        join_prefix: Optional prefix to be added to all columns of the joined model. If `None`, no prefix is added.\n        join_schema_to_select: Pydantic schema for selecting specific columns from the joined model.\n        join_type: Specifies the type of join operation to perform. Can be `\"left\"` for a left outer join or `\"inner\"` for an inner join.\n        alias: An instance of `AliasedClass` for the join model, useful for self-joins or multiple joins on the same model. Result of `aliased(join_model)`.\n        join_filters: Filters applied to the joined model, specified as a dictionary mapping column names to their expected values.\n        nest_joins: If `True`, nested data structures will be returned where joined model data are nested under the `join_prefix` as a dictionary.\n        offset: The offset (number of records to skip) for pagination.\n        limit: Maximum number of records to fetch in one call. Use `None` for \"no limit\", fetching all matching rows. Note that in order to use `limit=None`, you'll have to provide a custom endpoint to facilitate it, which you should only do if you really seriously want to allow the user to get all the data at once.\n        sort_columns: A single column name or a list of column names on which to apply sorting.\n        sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders corresponding to the columns in `sort_columns`. If not provided, defaults to `\"asc\"` for each column.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n        joins_config: List of `JoinConfig` instances for specifying multiple joins. Each instance defines a model to join with, join condition, optional prefix for column names, schema for selecting specific columns, and join type.\n        return_total_count: If `True`, also returns the total count of rows with the selected filters. Useful for pagination.\n        relationship_type: Specifies the relationship type, such as `\"one-to-one\"` or `\"one-to-many\"`. Used to determine how to nest the joined data. If `None`, uses `\"one-to-one\"`.\n        **kwargs: Filters to apply to the primary query, including advanced comparison operators for refined searching.\n\n    Returns:\n        A dictionary containing the fetched rows under `\"data\"` key and total count under `\"total_count\"`.\n\n    Raises:\n        ValueError: If either `limit` or `offset` are negative, or if `schema_to_select` is required but not provided or invalid.\n                    Also if both `joins_config` and any of the single join parameters are provided or none of `joins_config` and `join_model` is provided.\n\n    Examples:\n        Fetching multiple `User` records joined with `Tier` records, using left join, returning raw data:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n        )\n        ```\n\n        Fetch users joined with their tiers, sorted by username, where user's age is greater than 30:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            sort_columns='username',\n            sort_orders='asc',\n            age__gt=30,\n        )\n        ```\n\n        Fetch users joined with their tiers, excluding users with `admin` username, returning as model instances:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_schema_to_select=ReadTierSchema,\n            return_as_model=True,\n            username__ne='admin',\n        )\n        ```\n\n        Fetching and sorting by username in descending order, returning as Pydantic model:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n            sort_columns=['username'],\n            sort_orders=['desc'],\n            return_as_model=True,\n        )\n        ```\n\n        Fetching with complex conditions and custom join, returning as Pydantic model:\n\n        ```python\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            join_model=Tier,\n            join_on=User.tier_id == Tier.id,\n            join_prefix=\"tier_\",\n            join_schema_to_select=ReadTierSchema,\n            offset=0,\n            limit=10,\n            return_as_model=True,\n            is_active=True,\n        )\n        ```\n\n        Example using `joins_config` for multiple joins:\n\n        ```python\n        from fastcrud import JoinConfig\n\n        users = await user_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadUserSchema,\n            joins_config=[\n                JoinConfig(\n                    model=Tier,\n                    join_on=User.tier_id == Tier.id,\n                    join_prefix=\"tier_\",\n                    schema_to_select=ReadTierSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=Department,\n                    join_on=User.department_id == Department.id,\n                    join_prefix=\"dept_\",\n                    schema_to_select=ReadDepartmentSchema,\n                    join_type=\"inner\",\n                ),\n            ],\n            offset=0,\n            limit=10,\n            sort_columns='username',\n            sort_orders='asc',\n        )\n        ```\n\n        Example using `alias` for multiple joins, with pagination, sorting, and model conversion:\n        ```python\n        from fastcrud import JoinConfig, FastCRUD, aliased\n\n        # Aliasing for self-joins or multiple joins on the same table\n        owner_alias = aliased(ModelTest, name=\"owner\")\n        user_alias = aliased(ModelTest, name=\"user\")\n\n        # Initialize your FastCRUD instance for BookingModel\n        crud = FastCRUD(BookingModel)\n\n        result = await crud.get_multi_joined(\n            db=session,\n            schema_to_select=BookingSchema,  # Primary model schema\n            joins_config=[\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.owner_id == owner_alias.id,\n                    join_prefix=\"owner_\",\n                    schema_to_select=UserSchema,  # Schema for the joined model\n                    alias=owner_alias,\n                ),\n                JoinConfig(\n                    model=ModelTest,\n                    join_on=BookingModel.user_id == user_alias.id,\n                    join_prefix=\"user_\",\n                    schema_to_select=UserSchema,\n                    alias=user_alias,\n                )\n            ],\n            offset=10,  # Skip the first 10 records\n            limit=5,  # Fetch up to 5 records\n            sort_columns=['booking_date'],  # Sort by booking_date\n            sort_orders=['desc'],  # In descending order\n        )\n        ```\n\n        Fetching multiple project records and their associated participants where participants have a specific role:\n        ```python\n        joins_config = [\n            JoinConfig(\n                model=ProjectsParticipantsAssociation,\n                join_on=Project.id == ProjectsParticipantsAssociation.project_id,\n                join_type=\"inner\",\n            ),\n            JoinConfig(\n                model=Participant,\n                join_on=ProjectsParticipantsAssociation.participant_id == Participant.id,\n                join_type=\"inner\",\n                filters={'role': 'Developer'},\n            ),\n        ]\n        projects = await crud.get_multi_joined(\n            db=session,\n            schema_to_select=ProjectSchema,\n            joins_config=joins_config,\n            limit=10,\n        )\n        ```\n\n        Fetching a list of stories, each with nested details of associated tasks and task creators, using nested joins:\n\n        ```python\n        story_crud = FastCRUD(Story)\n        stories = await story_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadStorySchema,\n            joins_config=[\n                JoinConfig(\n                    model=Task,\n                    join_on=Story.id == Task.story_id,\n                    join_prefix=\"task_\",\n                    schema_to_select=ReadTaskSchema,\n                    join_type=\"left\",\n                ),\n                JoinConfig(\n                    model=User,\n                    join_on=Task.creator_id == User.id,\n                    join_prefix=\"creator_\",\n                    schema_to_select=ReadUserSchema,\n                    join_type=\"left\",\n                    alias=aliased(User, name=\"task_creator\"),\n                ),\n            ],\n            nest_joins=True,\n            offset=0,\n            limit=5,\n            sort_columns='name',\n            sort_orders='asc',\n        )\n        ```\n\n        Example using one-to-one relationship:\n\n        ```python\n        author_crud = FastCRUD(Author)\n        results = await author_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Profile,\n            join_on=Author.profile_id == Profile.id,\n            join_schema_to_select=ReadProfileSchema,\n            nest_joins=True,\n            offset=0,\n            limit=10,\n            relationship_type='one-to-one', # note that this is the default behavior\n        )\n        # Expect 'profile' to be nested as a dictionary under each user\n        ```\n\n        Example using one-to-many relationship:\n\n        ```python\n        results = await author_crud.get_multi_joined(\n            db=session,\n            schema_to_select=ReadAuthorSchema,\n            join_model=Article,\n            join_on=Author.id == Article.author_id,\n            join_schema_to_select=ReadArticleSchema,\n            nest_joins=True,\n            offset=0,\n            limit=10,\n            relationship_type='one-to-many',\n        )\n        # Expect 'posts' to be nested as a list of dictionaries under each user\n        ```\n    \"\"\"\n    if joins_config and (\n        join_model\n        or join_prefix\n        or join_on\n        or join_schema_to_select\n        or alias\n        or relationship_type\n    ):\n        raise ValueError(\n            \"Cannot use both single join parameters and joins_config simultaneously.\"\n        )\n    elif not joins_config and not join_model:\n        raise ValueError(\"You need one of join_model or joins_config.\")\n\n    if (limit is not None and limit &lt; 0) or offset &lt; 0:\n        raise ValueError(\"Limit and offset must be non-negative.\")\n\n    if relationship_type is None:\n        relationship_type = \"one-to-one\"\n\n    primary_select = _extract_matching_columns_from_schema(\n        model=self.model, schema=schema_to_select\n    )\n    stmt: Select = select(*primary_select)\n\n    join_definitions = joins_config if joins_config else []\n    if join_model:\n        try:\n            join_definitions.append(\n                JoinConfig(\n                    model=join_model,\n                    join_on=join_on\n                    if join_on is not None\n                    else _auto_detect_join_condition(self.model, join_model),\n                    join_prefix=join_prefix,\n                    schema_to_select=join_schema_to_select,\n                    join_type=join_type,\n                    alias=alias,\n                    filters=join_filters,\n                    relationship_type=relationship_type,\n                )\n            )\n        except ValueError as e:  # pragma: no cover\n            raise ValueError(f\"Could not configure join: {str(e)}\")\n\n    stmt = self._prepare_and_apply_joins(\n        stmt=stmt, joins_config=join_definitions, use_temporary_prefix=nest_joins\n    )\n\n    primary_filters = self._parse_filters(**kwargs)\n    if primary_filters:\n        stmt = stmt.filter(*primary_filters)\n\n    if sort_columns:\n        stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n\n    if offset:\n        stmt = stmt.offset(offset)\n    if limit is not None:\n        stmt = stmt.limit(limit)\n\n    result = await db.execute(stmt)\n    data: list[Union[dict, SelectSchemaType]] = []\n\n    for row in result.mappings().all():\n        row_dict = dict(row)\n\n        if nest_joins:\n            row_dict = _nest_join_data(\n                data=row_dict,\n                join_definitions=join_definitions,\n            )\n\n        if return_as_model:\n            if schema_to_select is None:\n                raise ValueError(\n                    \"schema_to_select must be provided when return_as_model is True.\"\n                )\n            try:\n                model_instance = schema_to_select(**row_dict)\n                data.append(model_instance)\n            except ValidationError as e:\n                raise ValueError(\n                    f\"Data validation error for schema {schema_to_select.__name__}: {e}\"\n                )\n        else:\n            data.append(row_dict)\n\n    if nest_joins and any(\n        join.relationship_type == \"one-to-many\" for join in join_definitions\n    ):\n        nested_data = _nest_multi_join_data(\n            base_primary_key=self._primary_keys[0].name,  # type: ignore[misc]\n            data=data,\n            joins_config=join_definitions,\n            return_as_model=return_as_model,\n            schema_to_select=schema_to_select if return_as_model else None,\n            nested_schema_to_select={\n                (\n                    join.join_prefix.rstrip(\"_\")\n                    if join.join_prefix\n                    else join.model.__tablename__\n                ): join.schema_to_select\n                for join in join_definitions\n                if join.schema_to_select\n            },\n        )\n    else:\n        nested_data = _handle_null_primary_key_multi_join(data, join_definitions)\n\n    response: dict[str, Any] = {\"data\": nested_data}\n\n    if return_total_count:\n        total_count: int = await self.count(\n            db=db, joins_config=joins_config, **kwargs\n        )\n        response[\"total_count\"] = total_count\n\n    return response\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.select","title":"<code>select(schema_to_select=None, sort_columns=None, sort_orders=None, **kwargs)</code>  <code>async</code>","text":"<p>Constructs a SQL Alchemy <code>Select</code> statement with optional column selection, filtering, and sorting.</p> <p>This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.</p> <code>None</code> <code>sort_columns</code> <code>Optional[Union[str, list[str]]]</code> <p>A single column name or list of column names to sort the query results by. Must be used in conjunction with <code>sort_orders</code>.</p> <code>None</code> <code>sort_orders</code> <code>Optional[Union[str, list[str]]]</code> <p>A single sort order (<code>\"asc\"</code> or <code>\"desc\"</code>) or a list of sort orders, corresponding to each column in <code>sort_columns</code>. If not specified, defaults to ascending order for all <code>sort_columns</code>.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to apply to the query, including advanced comparison operators for more detailed querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Select</code> <p>An SQL Alchemy <code>Select</code> statement object that can be executed or further modified.</p> <p>Examples:</p> <p>Selecting specific columns with filtering and sorting:</p> <pre><code>stmt = await user_crud.select(\n    schema_to_select=ReadUserSchema,\n    sort_columns=['age', 'name'],\n    sort_orders=['asc', 'desc'],\n    age__gt=18,\n)\n</code></pre> <p>Creating a statement to select all users without any filters:</p> <pre><code>stmt = await user_crud.select()\n</code></pre> <p>Selecting users with a specific <code>role</code>, ordered by <code>name</code>:</p> <pre><code>stmt = await user_crud.select(\n    schema_to_select=UserReadSchema,\n    sort_columns='name',\n    role='admin',\n)\n</code></pre> Note <p>This method does not execute the generated SQL statement. Use <code>db.execute(stmt)</code> to run the query and fetch results.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def select(\n    self,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any,\n) -&gt; Select:\n    \"\"\"\n    Constructs a SQL Alchemy `Select` statement with optional column selection, filtering, and sorting.\n\n    This method allows for advanced filtering through comparison operators, enabling queries to be refined beyond simple equality checks.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        schema_to_select: Pydantic schema to determine which columns to include in the selection. If not provided, selects all columns of the model.\n        sort_columns: A single column name or list of column names to sort the query results by. Must be used in conjunction with `sort_orders`.\n        sort_orders: A single sort order (`\"asc\"` or `\"desc\"`) or a list of sort orders, corresponding to each column in `sort_columns`. If not specified, defaults to ascending order for all `sort_columns`.\n        **kwargs: Filters to apply to the query, including advanced comparison operators for more detailed querying.\n\n    Returns:\n        An SQL Alchemy `Select` statement object that can be executed or further modified.\n\n    Examples:\n        Selecting specific columns with filtering and sorting:\n\n        ```python\n        stmt = await user_crud.select(\n            schema_to_select=ReadUserSchema,\n            sort_columns=['age', 'name'],\n            sort_orders=['asc', 'desc'],\n            age__gt=18,\n        )\n        ```\n\n        Creating a statement to select all users without any filters:\n\n        ```python\n        stmt = await user_crud.select()\n        ```\n\n        Selecting users with a specific `role`, ordered by `name`:\n\n        ```python\n        stmt = await user_crud.select(\n            schema_to_select=UserReadSchema,\n            sort_columns='name',\n            role='admin',\n        )\n        ```\n\n    Note:\n        This method does not execute the generated SQL statement.\n        Use `db.execute(stmt)` to run the query and fetch results.\n    \"\"\"\n    to_select = _extract_matching_columns_from_schema(\n        model=self.model, schema=schema_to_select\n    )\n    filters = self._parse_filters(**kwargs)\n    stmt = select(*to_select).filter(*filters)\n\n    if sort_columns:\n        stmt = self._apply_sorting(stmt, sort_columns, sort_orders)\n    return stmt\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.update","title":"<code>update(db, object, allow_multiple=False, commit=True, return_columns=None, schema_to_select=None, return_as_model=False, one_or_none=False, **kwargs)</code>  <code>async</code>","text":"<p>Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.</p> <p>For filtering details see the Advanced Filters documentation</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>object</code> <code>Union[UpdateSchemaType, dict[str, Any]]</code> <p>A Pydantic schema or dictionary containing the update data.</p> required <code>allow_multiple</code> <code>bool</code> <p>If <code>True</code>, allows updating multiple records that match the filters. If <code>False</code>, raises an error if more than one record matches the filters.</p> <code>False</code> <code>commit</code> <code>bool</code> <p>If <code>True</code>, commits the transaction immediately. Default is <code>True</code>.</p> <code>True</code> <code>return_columns</code> <code>Optional[list[str]]</code> <p>A list of column names to return after the update. If <code>return_as_model</code> is True, all columns are returned.</p> <code>None</code> <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Pydantic schema for selecting specific columns from the updated record(s). Required if <code>return_as_model</code> is <code>True</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, returns the updated record(s) as Pydantic model instances based on <code>schema_to_select</code>. Default is False.</p> <code>False</code> <code>one_or_none</code> <code>bool</code> <p>If <code>True</code>, returns a single record if only one record matches the filters. Default is <code>False</code>.</p> <code>False</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[Union[dict, SelectSchemaType]]</code> <p>The updated record(s) as a dictionary or Pydantic model instance or <code>None</code>, depending on the value of <code>return_as_model</code> and <code>return_columns</code>.</p> <p>Raises:</p> Type Description <code>MultipleResultsFound</code> <p>If <code>allow_multiple</code> is <code>False</code> and more than one record matches the filters.</p> <code>NoResultFound</code> <p>If no record matches the filters. (on version 0.15.3)</p> <code>ValueError</code> <p>If extra fields not present in the model are provided in the update data.</p> <code>ValueError</code> <p>If <code>return_as_model</code> is <code>True</code> but <code>schema_to_select</code> is not provided.</p> <p>Examples:</p> <p>Update a user's email based on their ID:</p> <pre><code>await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n</code></pre> <p>Update users to be inactive where age is greater than 30 and allow updates to multiple records:</p> <pre><code>await user_crud.update(\n    db,\n    {'is_active': False},\n    allow_multiple=True,\n    age__gt=30,\n)\n</code></pre> <p>Update a user's username excluding specific user ID and prevent multiple updates:</p> <pre><code>await user_crud.update(\n    db,\n    {'username': 'new_username'},\n    allow_multiple=False,\n    id__ne=1,\n)\n</code></pre> <p>Update a user's email and return the updated record as a Pydantic model instance:</p> <pre><code>user = await user_crud.update(\n    db,\n    {'email': 'new_email@example.com'},\n    schema_to_select=ReadUserSchema,\n    return_as_model=True,\n    id=1,\n)\n</code></pre> <p>Update a user's email and return the updated record as a dictionary: <pre><code>user = await user_crud.update(\n    db,\n    {'email': 'new_email@example.com'},\n    return_columns=['id', 'email'],\n    id=1,\n)\n</code></pre></p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def update(\n    self,\n    db: AsyncSession,\n    object: Union[UpdateSchemaType, dict[str, Any]],\n    allow_multiple: bool = False,\n    commit: bool = True,\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, SelectSchemaType]]:\n    \"\"\"\n    Updates an existing record or multiple records in the database based on specified filters. This method allows for precise targeting of records to update.\n\n    For filtering details see [the Advanced Filters documentation](../advanced/crud.md/#advanced-filters)\n\n    Args:\n        db: The database session to use for the operation.\n        object: A Pydantic schema or dictionary containing the update data.\n        allow_multiple: If `True`, allows updating multiple records that match the filters. If `False`, raises an error if more than one record matches the filters.\n        commit: If `True`, commits the transaction immediately. Default is `True`.\n        return_columns: A list of column names to return after the update. If `return_as_model` is True, all columns are returned.\n        schema_to_select: Pydantic schema for selecting specific columns from the updated record(s). Required if `return_as_model` is `True`.\n        return_as_model: If `True`, returns the updated record(s) as Pydantic model instances based on `schema_to_select`. Default is False.\n        one_or_none: If `True`, returns a single record if only one record matches the filters. Default is `False`.\n        **kwargs: Filters to identify the record(s) to update, supporting advanced comparison operators for refined querying.\n\n    Returns:\n        The updated record(s) as a dictionary or Pydantic model instance or `None`, depending on the value of `return_as_model` and `return_columns`.\n\n    Raises:\n        MultipleResultsFound: If `allow_multiple` is `False` and more than one record matches the filters.\n        NoResultFound: If no record matches the filters. (on version 0.15.3)\n        ValueError: If extra fields not present in the model are provided in the update data.\n        ValueError: If `return_as_model` is `True` but `schema_to_select` is not provided.\n\n    Examples:\n        Update a user's email based on their ID:\n\n        ```python\n        await user_crud.update(db, {'email': 'new_email@example.com'}, id=1)\n        ```\n\n        Update users to be inactive where age is greater than 30 and allow updates to multiple records:\n\n        ```python\n        await user_crud.update(\n            db,\n            {'is_active': False},\n            allow_multiple=True,\n            age__gt=30,\n        )\n        ```\n\n        Update a user's username excluding specific user ID and prevent multiple updates:\n\n        ```python\n        await user_crud.update(\n            db,\n            {'username': 'new_username'},\n            allow_multiple=False,\n            id__ne=1,\n        )\n        ```\n\n        Update a user's email and return the updated record as a Pydantic model instance:\n\n        ```python\n        user = await user_crud.update(\n            db,\n            {'email': 'new_email@example.com'},\n            schema_to_select=ReadUserSchema,\n            return_as_model=True,\n            id=1,\n        )\n        ```\n\n        Update a user's email and return the updated record as a dictionary:\n        ```python\n        user = await user_crud.update(\n            db,\n            {'email': 'new_email@example.com'},\n            return_columns=['id', 'email'],\n            id=1,\n        )\n        ```\n    \"\"\"\n    total_count = await self.count(db, **kwargs)\n    if total_count == 0:\n        raise NoResultFound(\"No record found to update.\")\n    if not allow_multiple and total_count &gt; 1:\n        raise MultipleResultsFound(\n            f\"Expected exactly one record to update, found {total_count}.\"\n        )\n\n    if isinstance(object, dict):\n        update_data = object\n    else:\n        update_data = object.model_dump(exclude_unset=True)\n\n    updated_at_col = getattr(self.model, self.updated_at_column, None)\n    if updated_at_col:\n        update_data[self.updated_at_column] = datetime.now(timezone.utc)\n\n    update_data_keys = set(update_data.keys())\n    model_columns = {_column.name for _column in inspect(self.model).c}\n    extra_fields = update_data_keys - model_columns\n    if extra_fields:\n        raise ValueError(f\"Extra fields provided: {extra_fields}\")\n\n    filters = self._parse_filters(**kwargs)\n    stmt = update(self.model).filter(*filters).values(update_data)\n\n    if return_as_model:\n        return_columns = self.model_col_names\n\n    if return_columns:\n        stmt = stmt.returning(*[column(name) for name in return_columns])\n        db_row = await db.execute(stmt)\n        if commit:\n            await db.commit()\n        if allow_multiple:\n            return self._as_multi_response(\n                db_row,\n                schema_to_select=schema_to_select,\n                return_as_model=return_as_model,\n            )\n        return self._as_single_response(\n            db_row,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n            one_or_none=one_or_none,\n        )\n\n    await db.execute(stmt)\n    if commit:\n        await db.commit()\n    return None\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.upsert","title":"<code>upsert(db, instance, schema_to_select=None, return_as_model=False)</code>  <code>async</code>","text":"<p>Update the instance or create it if it doesn't exists.</p> <p>Note: This method will perform two transactions to the database (get and create or update).</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>instance</code> <code>Union[UpdateSchemaType, CreateSchemaType]</code> <p>A Pydantic schema representing the instance.</p> required <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Optional Pydantic schema for selecting specific columns. Defaults to <code>None</code>.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If <code>True</code>, converts the fetched data to Pydantic models based on <code>schema_to_select</code>. Defaults to <code>False</code>.</p> <code>False</code> <p>Returns:</p> Type Description <code>Union[SelectSchemaType, dict[str, Any], None]</code> <p>The created or updated instance</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def upsert(\n    self,\n    db: AsyncSession,\n    instance: Union[UpdateSchemaType, CreateSchemaType],\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    return_as_model: bool = False,\n) -&gt; Union[SelectSchemaType, dict[str, Any], None]:\n    \"\"\"Update the instance or create it if it doesn't exists.\n\n    Note: This method will perform two transactions to the database (get and create or update).\n\n    Args:\n        db: The database session to use for the operation.\n        instance: A Pydantic schema representing the instance.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Defaults to `None`.\n        return_as_model: If `True`, converts the fetched data to Pydantic models based on `schema_to_select`. Defaults to `False`.\n\n    Returns:\n        The created or updated instance\n    \"\"\"\n    _pks = self._get_pk_dict(instance)\n    schema_to_select = schema_to_select or type(instance)  # type: ignore\n    db_instance = await self.get(\n        db,\n        schema_to_select=schema_to_select,  # type: ignore\n        return_as_model=return_as_model,\n        **_pks,\n    )\n    if db_instance is None:\n        db_instance = await self.create(db, instance)  # type: ignore\n        db_instance = schema_to_select.model_validate(  # type: ignore\n            db_instance, from_attributes=True\n        )\n    else:\n        await self.update(db, instance)  # type: ignore\n        db_instance = await self.get(\n            db,\n            schema_to_select=schema_to_select,  # type: ignore\n            return_as_model=return_as_model,\n            **_pks,\n        )\n\n    return db_instance\n</code></pre>"},{"location":"api/fastcrud/#fastcrud.FastCRUD.upsert_multi","title":"<code>upsert_multi(db, instances, commit=False, return_columns=None, schema_to_select=None, return_as_model=False, update_override=None, **kwargs)</code>  <code>async</code>","text":"<p>Upsert multiple records in the database. The underlying implementation varies based on the database dialect.</p> <p>Parameters:</p> Name Type Description Default <code>db</code> <code>AsyncSession</code> <p>The database session to use for the operation.</p> required <code>instances</code> <code>list[Union[UpdateSchemaType, CreateSchemaType]]</code> <p>A list of Pydantic schemas representing the instances to upsert.</p> required <code>commit</code> <code>bool</code> <p>If True, commits the transaction immediately. Default is False.</p> <code>False</code> <code>return_columns</code> <code>Optional[list[str]]</code> <p>Optional list of column names to return after the upsert operation.</p> <code>None</code> <code>schema_to_select</code> <code>Optional[type[SelectSchemaType]]</code> <p>Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.</p> <code>None</code> <code>return_as_model</code> <code>bool</code> <p>If True, returns data as instances of the specified Pydantic model.</p> <code>False</code> <code>update_override</code> <code>Optional[dict[str, Any]]</code> <p>Optional dictionary to override the update values for the upsert operation.</p> <code>None</code> <code>**kwargs</code> <code>Any</code> <p>Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.</p> <code>{}</code> <p>Returns:</p> Type Description <code>Optional[dict[str, Any]]</code> <p>The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of <code>return_as_model</code> and <code>return_columns</code>.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.</p> <code>NotImplementedError</code> <p>If the database dialect is not supported for upsert multi.</p> Source code in <code>fastcrud/crud/fast_crud.py</code> <pre><code>async def upsert_multi(\n    self,\n    db: AsyncSession,\n    instances: list[Union[UpdateSchemaType, CreateSchemaType]],\n    commit: bool = False,\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[SelectSchemaType]] = None,\n    return_as_model: bool = False,\n    update_override: Optional[dict[str, Any]] = None,\n    **kwargs: Any,\n) -&gt; Optional[dict[str, Any]]:\n    \"\"\"\n    Upsert multiple records in the database. The underlying implementation varies based on the database dialect.\n\n    Args:\n        db: The database session to use for the operation.\n        instances: A list of Pydantic schemas representing the instances to upsert.\n        commit: If True, commits the transaction immediately. Default is False.\n        return_columns: Optional list of column names to return after the upsert operation.\n        schema_to_select: Optional Pydantic schema for selecting specific columns. Required if return_as_model is True.\n        return_as_model: If True, returns data as instances of the specified Pydantic model.\n        update_override: Optional dictionary to override the update values for the upsert operation.\n        **kwargs: Filters to identify the record(s) to update on conflict, supporting advanced comparison operators for refined querying.\n\n    Returns:\n        The updated record(s) as a dictionary or Pydantic model instance or None, depending on the value of `return_as_model` and `return_columns`.\n\n    Raises:\n        ValueError: If the MySQL dialect is used with filters, return_columns, schema_to_select, or return_as_model.\n        NotImplementedError: If the database dialect is not supported for upsert multi.\n    \"\"\"\n    if update_override is None:\n        update_override = {}\n    filters = self._parse_filters(**kwargs)\n\n    if db.bind.dialect.name == \"postgresql\":\n        statement, params = await self._upsert_multi_postgresql(\n            instances, filters, update_override\n        )\n    elif db.bind.dialect.name == \"sqlite\":\n        statement, params = await self._upsert_multi_sqlite(\n            instances, filters, update_override\n        )\n    elif db.bind.dialect.name in [\"mysql\", \"mariadb\"]:\n        if filters:\n            raise ValueError(\n                \"MySQL does not support filtering on insert operations.\"\n            )\n        if return_columns or schema_to_select or return_as_model:\n            raise ValueError(\n                \"MySQL does not support the returning clause for insert operations.\"\n            )\n        statement, params = await self._upsert_multi_mysql(\n            instances, update_override\n        )\n    else:  # pragma: no cover\n        raise NotImplementedError(\n            f\"Upsert multi is not implemented for {db.bind.dialect.name}\"\n        )\n\n    if return_as_model:\n        return_columns = self.model_col_names\n\n    if return_columns:\n        statement = statement.returning(*[column(name) for name in return_columns])\n        db_row = await db.execute(statement, params)\n        if commit:\n            await db.commit()\n        return self._as_multi_response(\n            db_row,\n            schema_to_select=schema_to_select,\n            return_as_model=return_as_model,\n        )\n\n    await db.execute(statement, params)\n    if commit:\n        await db.commit()\n    return None\n</code></pre>"},{"location":"api/overview/","title":"API Reference Overview","text":"<p>Welcome to the API Reference section of our documentation. This section provides detailed information about the various classes, functions, and modules that make up our application. Whether you are looking to extend the application, integrate with it, or simply explore its capabilities, this section will guide you through the intricacies of our codebase.</p>"},{"location":"api/overview/#key-components","title":"Key Components","text":"<p>Our application's API is comprised of several key components, each serving a specific purpose:</p> <ol> <li> <p>FastCRUD Class: This class is at the heart of our CRUD (Create, Read, Update, Delete) operations. It provides a convenient and efficient way to interact with our database models.</p> <ul> <li>FastCRUD Class Reference</li> </ul> </li> <li> <p>EndpointCreator Class: A utility class for creating and registering CRUD endpoints in a FastAPI application. It simplifies the addition of standard CRUD endpoints to your FastAPI router.</p> <ul> <li>EndpointCreator Class Reference</li> </ul> </li> <li> <p>crud_router Function: A function that creates and configures a FastAPI router with CRUD endpoints for a specific model. It's a quick way to add standard CRUD operations to your models.</p> <ul> <li>CRUD Router Function Reference</li> </ul> </li> <li> <p>paginated Module: A a utility module for offset pagination related functions.</p> <ul> <li>Pagination Module Reference</li> </ul> </li> </ol>"},{"location":"api/overview/#usage","title":"Usage","text":"<p>Each component is documented with its own dedicated page, where you can find detailed information about its methods, parameters, return types, and usage examples. These pages are designed to provide you with all the information you need to understand and work with our API effectively.</p>"},{"location":"api/overview/#contribution","title":"Contribution","text":"<p>If you wish to contribute to the development of our API, please refer to our Contributing Guidelines. We welcome contributions of all forms, from bug fixes to feature development.</p>"},{"location":"api/overview/#feedback","title":"Feedback","text":"<p>Your feedback is crucial in helping us improve this documentation. If you have any suggestions, corrections, or queries, please reach out to us.</p> <p>Navigate through each section for detailed documentation of our API components.</p>"},{"location":"api/paginated/","title":"Paginated Module Reference","text":"<p><code>paginated</code> is a utility module for offset pagination related functions.</p>"},{"location":"api/paginated/#function-definition","title":"Function Definition","text":""},{"location":"api/paginated/#fastcrud.paginated.compute_offset","title":"<code>compute_offset(page, items_per_page)</code>","text":"<p>Calculate the offset for pagination based on the given page number and items per page.</p> <p>The offset represents the starting point in a dataset for the items on a given page. For example, if each page displays 10 items and you want to display page 3, the offset will be 20, meaning the display should start with the 21st item.</p> <p>Parameters:</p> Name Type Description Default <code>page</code> <code>int</code> <p>The current page number. Page numbers should start from 1.</p> required <code>items_per_page</code> <code>int</code> <p>The number of items to be displayed on each page.</p> required <p>Returns:</p> Type Description <code>int</code> <p>The calculated offset.</p> <p>Examples:</p> <pre><code>&gt;&gt;&gt; offset(1, 10)\n0\n&gt;&gt;&gt; offset(3, 10)\n20\n</code></pre> Source code in <code>fastcrud/paginated/helper.py</code> <pre><code>def compute_offset(page: int, items_per_page: int) -&gt; int:\n    \"\"\"Calculate the offset for pagination based on the given page number and items per page.\n\n    The offset represents the starting point in a dataset for the items on a given page.\n    For example, if each page displays 10 items and you want to display page 3, the offset will be 20,\n    meaning the display should start with the 21st item.\n\n    Args:\n        page: The current page number. Page numbers should start from 1.\n        items_per_page: The number of items to be displayed on each page.\n\n    Returns:\n        The calculated offset.\n\n    Examples:\n        &gt;&gt;&gt; offset(1, 10)\n        0\n        &gt;&gt;&gt; offset(3, 10)\n        20\n    \"\"\"\n    return (page - 1) * items_per_page\n</code></pre>"},{"location":"api/paginated/#fastcrud.paginated.paginated_response","title":"<code>paginated_response(crud_data, page, items_per_page)</code>","text":"<p>Create a paginated response based on the provided data and pagination parameters.</p> <p>Parameters:</p> Name Type Description Default <code>crud_data</code> <code>dict</code> <p>Data to be paginated, including the list of items and total count.</p> required <code>page</code> <code>int</code> <p>Current page number.</p> required <code>items_per_page</code> <code>int</code> <p>Number of items per page.</p> required <p>Returns:</p> Type Description <code>dict[str, Any]</code> <p>A structured paginated response dict containing the list of items, total count, pagination flags, and numbers.</p> Note <p>The function does not actually paginate the data but formats the response to indicate pagination metadata.</p> Source code in <code>fastcrud/paginated/response.py</code> <pre><code>def paginated_response(\n    crud_data: dict, page: int, items_per_page: int\n) -&gt; dict[str, Any]:\n    \"\"\"Create a paginated response based on the provided data and pagination parameters.\n\n    Args:\n        crud_data: Data to be paginated, including the list of items and total count.\n        page: Current page number.\n        items_per_page: Number of items per page.\n\n    Returns:\n        A structured paginated response dict containing the list of items, total count, pagination flags, and numbers.\n\n    Note:\n        The function does not actually paginate the data but formats the response to indicate pagination metadata.\n    \"\"\"\n    return {\n        \"data\": crud_data[\"data\"],\n        \"total_count\": crud_data[\"total_count\"],\n        \"has_more\": (page * items_per_page) &lt; crud_data[\"total_count\"],\n        \"page\": page,\n        \"items_per_page\": items_per_page,\n    }\n</code></pre>"},{"location":"community/CODE_OF_CONDUCT/","title":"Contributor Covenant Code of Conduct","text":""},{"location":"community/CODE_OF_CONDUCT/#our-pledge","title":"Our Pledge","text":"<p>We as members, contributors, and leaders pledge to make participation in our community a harassment-free experience for everyone, regardless of age, body size, visible or invisible disability, ethnicity, sex characteristics, gender identity and expression, level of experience, education, socio-economic status, nationality, personal appearance, race, religion, or sexual identity and orientation.</p> <p>We pledge to act and interact in ways that contribute to an open, welcoming, diverse, inclusive, and healthy community.</p>"},{"location":"community/CODE_OF_CONDUCT/#our-standards","title":"Our Standards","text":"<p>Examples of behavior that contributes to a positive environment for our community include:</p> <ul> <li>Demonstrating empathy and kindness toward other people</li> <li>Being respectful of differing opinions, viewpoints, and experiences</li> <li>Giving and gracefully accepting constructive feedback</li> <li>Accepting responsibility and apologizing to those affected by our mistakes,   and learning from the experience</li> <li>Focusing on what is best not just for us as individuals, but for the   overall community</li> </ul> <p>Examples of unacceptable behavior include:</p> <ul> <li>The use of sexualized language or imagery, and sexual attention or   advances of any kind</li> <li>Trolling, insulting or derogatory comments, and personal or political attacks</li> <li>Public or private harassment</li> <li>Publishing others' private information, such as a physical or email   address, without their explicit permission</li> <li>Other conduct which could reasonably be considered inappropriate in a   professional setting</li> </ul>"},{"location":"community/CODE_OF_CONDUCT/#enforcement-responsibilities","title":"Enforcement Responsibilities","text":"<p>Community leaders are responsible for clarifying and enforcing our standards of acceptable behavior and will take appropriate and fair corrective action in response to any behavior that they deem inappropriate, threatening, offensive, or harmful.</p> <p>Community leaders have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, and will communicate reasons for moderation decisions when appropriate.</p>"},{"location":"community/CODE_OF_CONDUCT/#scope","title":"Scope","text":"<p>This Code of Conduct applies within all community spaces, and also applies when an individual is officially representing the community in public spaces. Examples of representing our community include using an official e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event.</p>"},{"location":"community/CODE_OF_CONDUCT/#enforcement","title":"Enforcement","text":"<p>Instances of abusive, harassing, or otherwise unacceptable behavior may be reported to the community leaders responsible for enforcement at igor.magalhaes.r@gmail.com. All complaints will be reviewed and investigated promptly and fairly.</p> <p>All community leaders are obligated to respect the privacy and security of the reporter of any incident.</p>"},{"location":"community/CODE_OF_CONDUCT/#enforcement-guidelines","title":"Enforcement Guidelines","text":"<p>Community leaders will follow these Community Impact Guidelines in determining the consequences for any action they deem in violation of this Code of Conduct:</p>"},{"location":"community/CODE_OF_CONDUCT/#1-correction","title":"1. Correction","text":"<p>Community Impact: Use of inappropriate language or other behavior deemed unprofessional or unwelcome in the community.</p> <p>Consequence: A private, written warning from community leaders, providing clarity around the nature of the violation and an explanation of why the behavior was inappropriate. A public apology may be requested.</p>"},{"location":"community/CODE_OF_CONDUCT/#2-warning","title":"2. Warning","text":"<p>Community Impact: A violation through a single incident or series of actions.</p> <p>Consequence: A warning with consequences for continued behavior. No interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, for a specified period of time. This includes avoiding interactions in community spaces as well as external channels like social media. Violating these terms may lead to a temporary or permanent ban.</p>"},{"location":"community/CODE_OF_CONDUCT/#3-temporary-ban","title":"3. Temporary Ban","text":"<p>Community Impact: A serious violation of community standards, including sustained inappropriate behavior.</p> <p>Consequence: A temporary ban from any sort of interaction or public communication with the community for a specified period of time. No public or private interaction with the people involved, including unsolicited interaction with those enforcing the Code of Conduct, is allowed during this period. Violating these terms may lead to a permanent ban.</p>"},{"location":"community/CODE_OF_CONDUCT/#4-permanent-ban","title":"4. Permanent Ban","text":"<p>Community Impact: Demonstrating a pattern of violation of community standards, including sustained inappropriate behavior,  harassment of an individual, or aggression toward or disparagement of classes of individuals.</p> <p>Consequence: A permanent ban from any sort of public interaction within the community.</p>"},{"location":"community/CODE_OF_CONDUCT/#attribution","title":"Attribution","text":"<p>This Code of Conduct is adapted from the Contributor Covenant, version 2.0, available at https://www.contributor-covenant.org/version/2/0/code_of_conduct.html.</p> <p>Community Impact Guidelines were inspired by Mozilla's code of conduct enforcement ladder.</p> <p>For answers to common questions about this code of conduct, see the FAQ at https://www.contributor-covenant.org/faq. Translations are available at https://www.contributor-covenant.org/translations.</p>"},{"location":"community/CONTRIBUTING/","title":"Contributing to FastCRUD","text":"<p>Thank you for your interest in contributing to FastCRUD! This guide is meant to make it easy for you to get started.</p>"},{"location":"community/CONTRIBUTING/#setting-up-your-development-environment","title":"Setting Up Your Development Environment","text":""},{"location":"community/CONTRIBUTING/#cloning-the-repository","title":"Cloning the Repository","text":"<p>Start by forking and cloning the FastCRUD repository:</p> <pre><code>git clone https://github.com/YOUR-GITHUB-USERNAME/fastcrud.git\n</code></pre>"},{"location":"community/CONTRIBUTING/#using-poetry-for-dependency-management","title":"Using Poetry for Dependency Management","text":"<p>FastCRUD uses Poetry for managing dependencies. If you don't have Poetry installed, follow the instructions on the official Poetry website.</p> <p>Once Poetry is installed, navigate to the cloned repository and install the dependencies: <pre><code>cd fastcrud\npoetry install\n</code></pre></p>"},{"location":"community/CONTRIBUTING/#activating-the-virtual-environment","title":"Activating the Virtual Environment","text":"<p>Poetry creates a virtual environment for your project. Activate it using:</p> <pre><code>poetry shell\n</code></pre>"},{"location":"community/CONTRIBUTING/#making-contributions","title":"Making Contributions","text":""},{"location":"community/CONTRIBUTING/#coding-standards","title":"Coding Standards","text":"<ul> <li>Follow PEP 8 guidelines.</li> <li>Write meaningful tests for new features or bug fixes.</li> </ul>"},{"location":"community/CONTRIBUTING/#testing-with-pytest","title":"Testing with Pytest","text":"<p>FastCRUD uses pytest for testing. Run tests using: <pre><code>poetry run pytest\n</code></pre></p>"},{"location":"community/CONTRIBUTING/#linting","title":"Linting","text":"<p>Use mypy for type checking: <pre><code>mypy fastcrud\n</code></pre></p> <p>Use ruff for style: <pre><code>ruff check --fix\nruff format\n</code></pre></p> <p>Ensure your code passes linting before submitting.</p>"},{"location":"community/CONTRIBUTING/#submitting-your-contributions","title":"Submitting Your Contributions","text":""},{"location":"community/CONTRIBUTING/#creating-a-pull-request","title":"Creating a Pull Request","text":"<p>After making your changes:</p> <ul> <li>Push your changes to your fork.</li> <li>Open a pull request with a clear description of your changes.</li> <li>Update the README.md if necessary.</li> </ul>"},{"location":"community/CONTRIBUTING/#code-reviews","title":"Code Reviews","text":"<ul> <li>Address any feedback from code reviews.</li> <li>Once approved, your contributions will be merged into the main branch.</li> </ul>"},{"location":"community/CONTRIBUTING/#code-of-conduct","title":"Code of Conduct","text":"<p>Please adhere to our Code of Conduct to maintain a welcoming and inclusive environment.</p> <p>Thank you for contributing to FastCRUD\ud83d\ude80</p>"},{"location":"community/LICENSE/","title":"License","text":"<p>MIT License</p> <p>Copyright (c) 2023 Igor Magalh\u00e3es</p> <p>Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:</p> <p>The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.</p> <p>THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.</p>"},{"location":"community/overview/","title":"Community Overview","text":"<p>Welcome to the project's community hub. Here, you'll find essential resources and guidelines that are crucial for contributing to and participating in the project. Please take the time to familiarize yourself with the following documents:</p>"},{"location":"community/overview/#table-of-contents","title":"Table of Contents","text":"<ul> <li>Contributing</li> <li>Code of Conduct</li> <li>License</li> </ul>"},{"location":"community/overview/#contributing","title":"Contributing","text":"<p>View the Contributing Guidelines</p> <p>Interested in contributing to the project? Great! The contributing guidelines will provide you with all the information you need to get started. This includes how to submit issues, propose changes, and the process for submitting pull requests.</p>"},{"location":"community/overview/#code-of-conduct","title":"Code of Conduct","text":"<p>View the Code of Conduct</p> <p>The Code of Conduct outlines the standards and behaviors expected of our community members. It's crucial to ensure a welcoming and inclusive environment for everyone. Please take the time to read and adhere to these guidelines.</p>"},{"location":"community/overview/#license","title":"License","text":"<p>View the License</p> <p>The license document outlines the terms under which our project can be used, modified, and distributed. Understanding the licensing is important for both users and contributors of the project.</p> <p>Thank you for being a part of our community and for contributing to our project's success!</p>"},{"location":"community/showcase_submission/","title":"Submit Your Project","text":"<p>Share Your Work</p> <p>Have you built something with FastCRUD? We'd love to feature it in our showcase!</p>"},{"location":"community/showcase_submission/#project-categories","title":"Project Categories","text":"<p>What You Can Submit</p> <ul> <li>Tutorials: Step-by-step guides teaching others how to build with FastCRUD</li> <li>Open Source Projects: Libraries, tools, or applications others can use and learn from</li> <li>Applications: Web apps, desktop tools, or services built with FastCRUD</li> <li>Commercial Services: Products or services powered by FastCRUD</li> </ul>"},{"location":"community/showcase_submission/#how-to-submit","title":"How to Submit","text":"<p>Submission Steps</p> <ol> <li>Create a new issue using our Showcase Submission Template</li> <li>Fill in the relevant information for your project type</li> <li>We'll review your submission and add it to the showcase!</li> </ol>"},{"location":"community/showcase_submission/#requirements-by-category","title":"Requirements by Category","text":"<p>What We Look For</p> <p>For Tutorials:</p> <ul> <li>Clear step-by-step instructions</li> <li>Working code examples</li> <li>Explanation of concepts used</li> </ul> <p>For Open Source Projects:</p> <ul> <li>Public repository</li> <li>Basic documentation</li> <li>Installation/usage instructions</li> </ul> <p>For Applications/Services:</p> <ul> <li>Public demo or screenshots</li> <li>Description of FastCRUD features used</li> <li>Link to live service (if applicable)</li> </ul>"},{"location":"community/showcase_submission/#need-help","title":"Need Help?","text":"<p>Questions?</p> <p>Need help with your submission? We're here to help!</p> <ul> <li>Open a discussion on GitHub</li> </ul>"},{"location":"usage/crud/","title":"Using FastCRUD for Enhanced CRUD Operations","text":"<p>FastCRUD is a versatile tool for handling CRUD (Create, Read, Update, Delete) operations in FastAPI applications with SQLAlchemy models. It leverages Pydantic schemas for data validation and serialization, offering a streamlined approach to database interactions.</p>"},{"location":"usage/crud/#key-features","title":"Key Features","text":"<ul> <li>Simplified CRUD operations with SQLAlchemy models.</li> <li>Data validation and serialization using Pydantic.</li> <li>Support for complex queries including joins and pagination.</li> </ul>"},{"location":"usage/crud/#getting-started","title":"Getting Started","text":""},{"location":"usage/crud/#step-1-define-models-and-schemas","title":"Step 1: Define Models and Schemas","text":"<p>Define your SQLAlchemy models and Pydantic schemas for data representation.</p> Models and Schemas Used Below <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre> <code>customer/model.py</code> <pre><code>from sqlalchemy import Column, Integer, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Customer(Base):\n    __tablename__ = \"customer\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n</code></pre> <code>customer/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadCustomerSchema(BaseModel):\n    id: int\n    name: str | None = None\n</code></pre> <code>product/model.py</code> <pre><code>from sqlalchemy import Column, Integer, Numeric, String\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Product(Base):\n    __tablename__ = \"product\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    price = Column(Numeric)\n</code></pre> <code>order/model.py</code> <pre><code>from sqlalchemy import Column, ForeignKey, Integer\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Order(Base):\n    __tablename__ = \"order\"\n    id = Column(Integer, primary_key=True)\n    customer_id = Column(Integer, ForeignKey(\"customer.id\"))\n    product_id = Column(Integer, ForeignKey(\"product.id\"))\n    quantity = Column(Integer)\n</code></pre> <code>order/schemas.py</code> <pre><code>from pydantic import BaseModel\n\n\nclass ReadOrderSchema(BaseModel):\n    id: int\n    customer_id: int | None = None\n    product_id: int | None = None\n    quantity: int | None = None\n</code></pre>"},{"location":"usage/crud/#step-2-initialize-fastcrud","title":"Step 2: Initialize FastCRUD","text":"<p>Create a <code>FastCRUD</code> instance for your model to handle CRUD operations.</p> <pre><code>from fastcrud import FastCRUD\n\n# Creating a FastCRUD instance\nitem_crud = FastCRUD(Item)\norder_crud = FastCRUD(Order)\n</code></pre>"},{"location":"usage/crud/#step-3-pick-your-method","title":"Step 3: Pick your Method","text":"<p>Then you just pick the method you need and use it like this:</p> <pre><code># Creating a new record\nnew_record = await item_crud.create(db_session, create_schema_instance)\n</code></pre> <p>More on available methods below.</p>"},{"location":"usage/crud/#understanding-fastcrud-methods","title":"Understanding FastCRUD Methods","text":"<p>FastCRUD offers a comprehensive suite of methods for CRUD operations, each designed to handle different aspects of database interactions efficiently.</p>"},{"location":"usage/crud/#1-create","title":"1. Create","text":"<pre><code>create(\n    db: AsyncSession,\n    object: CreateSchemaType,\n    commit: bool = True,\n) -&gt; ModelType\n</code></pre> <p>Purpose: To create a new record in the database. Usage Example: Creates an item with name <code>\"New Item\"</code>.</p> <pre><code>new_item = await item_crud.create(db, CreateItemSchema(name=\"New Item\"))\n</code></pre> <p>Warning</p> <p>Note that naive <code>datetime</code> such as <code>datetime.utcnow</code> is not supported by <code>FastCRUD</code> as it was deprecated.</p> <p>Use timezone aware <code>datetime</code>, such as <code>datetime.now(UTC)</code> instead.</p>"},{"location":"usage/crud/#2-get","title":"2. Get","text":"<pre><code>get(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]\n</code></pre> <p>Purpose: To fetch a single record based on filters, with an option to select specific columns using a Pydantic schema. Usage Example: Fetches the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>item = await item_crud.get(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#3-exists","title":"3. Exists","text":"<pre><code>exists(\n    db: AsyncSession,\n    **kwargs: Any,\n) -&gt; bool\n</code></pre> <p>Purpose: To check if a record exists based on provided filters. Usage Example: Checks whether an item with name <code>\"Existing Item\"</code> exists.</p> <pre><code>exists = await item_crud.exists(db, name=\"Existing Item\")\n</code></pre>"},{"location":"usage/crud/#4-count","title":"4. Count","text":"<pre><code>count(\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int\n</code></pre> <p>Purpose: To count the number of records matching provided filters. Usage Example: Counts the number of items with the <code>\"Books\"</code> category.</p> <pre><code>count = await item_crud.count(db, category=\"Books\")\n</code></pre>"},{"location":"usage/crud/#5-get-multi","title":"5. Get Multi","text":"<pre><code>get_multi(\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: To fetch multiple records with optional sorting, pagination, and model conversion. Usage Example: Fetches a subset of 5 items, starting from the 11th item in the database.</p> <pre><code>items = await item_crud.get_multi(db, offset=10, limit=5)\n</code></pre>"},{"location":"usage/crud/#6-update","title":"6. Update","text":"<pre><code>update(\n    db: AsyncSession, \n    object: Union[UpdateSchemaType, dict[str, Any]], \n    allow_multiple: bool = False,\n    commit: bool = True,\n    return_columns: Optional[list[str]] = None,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    return_as_model: bool = False,\n    one_or_none: bool = False,\n    **kwargs: Any,\n) -&gt; Optional[Union[dict, BaseModel]]\n</code></pre> <p>Purpose: To update an existing record in the database. Usage Example: Updates the description of the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>await item_crud.update(\n    db,\n    UpdateItemSchema(description=\"Updated\"),\n    id=item_id,\n)\n</code></pre>"},{"location":"usage/crud/#7-delete","title":"7. Delete","text":"<pre><code>delete(\n    db: AsyncSession, \n    db_row: Optional[Row] = None, \n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None\n</code></pre> <p>Purpose: To delete a record from the database, with support for soft delete. Usage Example: Deletes the item with <code>item_id</code> as its <code>id</code>, performs a soft delete if the model has the <code>is_deleted</code> column.</p> <pre><code>await item_crud.delete(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#8-hard-delete","title":"8. Hard Delete","text":"<pre><code>db_delete(\n    db: AsyncSession, \n    allow_multiple: bool = False,\n    commit: bool = True,\n    **kwargs: Any,\n) -&gt; None\n</code></pre> <p>Purpose: To hard delete a record from the database. Usage Example: Hard deletes the item with <code>item_id</code> as its <code>id</code>.</p> <pre><code>await item_crud.db_delete(db, id=item_id)\n</code></pre>"},{"location":"usage/crud/#advanced-methods-for-complex-queries-and-joins","title":"Advanced Methods for Complex Queries and Joins","text":"<p>FastCRUD extends its functionality with advanced methods tailored for complex query operations and handling joins. These methods cater to specific use cases where more sophisticated data retrieval and manipulation are required.</p>"},{"location":"usage/crud/#1-get-multi","title":"1. Get Multi","text":"<pre><code>get_multi(\n    db: AsyncSession,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    return_total_count: bool = True,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: To fetch multiple records based on specified filters, with options for sorting and pagination. Usage Example: Gets the first 10 items sorted by <code>name</code> in ascending order.</p> <pre><code>items = await item_crud.get_multi(\n    db,\n    offset=0,\n    limit=10,\n    sort_columns=['name'],\n    sort_orders=['asc'],\n)\n</code></pre>"},{"location":"usage/crud/#2-get-joined","title":"2. Get Joined","text":"<pre><code>get_joined(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[ModelType] = None,\n    join_on: Optional[Union[Join, BinaryExpression]] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass] = None,\n    join_filters: Optional[dict] = None,\n    joins_config: Optional[list[JoinConfig]] = None,\n    nest_joins: bool = False,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; Optional[dict[str, Any]]\n</code></pre> <p>Purpose: To fetch a single record with one or multiple joins on other models. Usage Example: Fetches order details for a specific order by joining with the <code>Customer</code> table, selecting specific columns as defined in <code>ReadOrderSchema</code> and <code>ReadCustomerSchema</code>.</p> <pre><code>order_details = await order_crud.get_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Customer,\n    join_schema_to_select=ReadCustomerSchema,\n    id=order_id,\n)\n</code></pre>"},{"location":"usage/crud/#3-get-multi-joined","title":"3. Get Multi Joined","text":"<pre><code>get_multi_joined(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    join_model: Optional[type[ModelType]] = None,\n    join_on: Optional[Any] = None,\n    join_prefix: Optional[str] = None,\n    join_schema_to_select: Optional[type[BaseModel]] = None,\n    join_type: str = \"left\",\n    alias: Optional[AliasedClass[Any]] = None,\n    join_filters: Optional[dict] = None,\n    nest_joins: bool = False,\n    offset: int = 0,\n    limit: Optional[int] = 100,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    return_as_model: bool = False,\n    joins_config: Optional[list[JoinConfig]] = None,\n    return_total_count: bool = True,\n    relationship_type: Optional[str] = None,\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: Similar to <code>get_joined</code>, but for fetching multiple records. Usage Example: Retrieves a paginated list of orders (up to 5), joined with the <code>Customer</code> table, using specified schemas for selective column retrieval from both tables.</p> <pre><code>orders = await order_crud.get_multi_joined(\n    db,\n    schema_to_select=ReadOrderSchema,\n    join_model=Customer,\n    join_schema_to_select=ReadCustomerSchema,\n    offset=0,\n    limit=5,\n)\n</code></pre>"},{"location":"usage/crud/#4-get-multi-by-cursor","title":"4. Get Multi By Cursor","text":"<pre><code>get_multi_by_cursor(\n    db: AsyncSession,\n    cursor: Any = None,\n    limit: int = 100,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_column: str = \"id\",\n    sort_order: str = \"asc\",\n    **kwargs: Any,\n) -&gt; dict[str, Any]\n</code></pre> <p>Purpose: Implements cursor-based pagination for efficient data retrieval in large datasets. Usage Example: Fetches the next 10 items after the last cursor for efficient pagination, sorted by creation date in descending order.</p> <pre><code>paginated_items = await item_crud.get_multi_by_cursor(\n    db,\n    cursor=last_cursor,\n    limit=10,\n    sort_column='created_at',\n    sort_order='desc',\n)\n</code></pre>"},{"location":"usage/crud/#5-select","title":"5. Select","text":"<pre><code>async def select(\n    db: AsyncSession,\n    schema_to_select: Optional[type[BaseModel]] = None,\n    sort_columns: Optional[Union[str, list[str]]] = None,\n    sort_orders: Optional[Union[str, list[str]]] = None,\n    **kwargs: Any,\n) -&gt; Select\n</code></pre> <p>Purpose: Constructs a SQL Alchemy <code>Select</code> statement with optional column selection, filtering, and sorting. Usage Example: Selects all items, filtering by <code>name</code> and sorting by <code>id</code>. Returns the <code>Select</code> statement.</p> <pre><code>stmt = await item_crud.select(\n    schema_to_select=ItemSchema,\n    sort_columns='id',\n    name='John',\n)\n# Note: This method returns a SQL Alchemy Select object, not the actual query result.\n</code></pre>"},{"location":"usage/crud/#6-count-for-joined-models","title":"6. Count for Joined Models","text":"<pre><code>count(\n    db: AsyncSession,\n    joins_config: Optional[list[JoinConfig]] = None,\n    **kwargs: Any,\n) -&gt; int\n</code></pre> <p>Purpose: To count records that match specified filters, especially useful in scenarios involving joins between models. This method supports counting unique entities across relationships, a common requirement in many-to-many or complex relationships. Usage Example: Count the number of unique projects a participant is involved in, considering a many-to-many relationship between <code>Project</code> and <code>Participant</code> models.</p> <pre><code># Assuming a Project model related to a Participant model through a many-to-many relationship\nprojects_count = await project_crud.count(\n    db=session,\n    joins_config=[\n        JoinConfig(\n            model=Participant,\n            join_on=ProjectsParticipantsAssociation.project_id == Project.id,\n            join_type=\"inner\",\n        ),\n    ],\n    participant_id=specific_participant_id,\n)\n</code></pre>"},{"location":"usage/crud/#error-handling","title":"Error Handling","text":"<p>FastCRUD provides mechanisms to handle common database errors, ensuring robust API behavior.</p>"},{"location":"usage/endpoint/","title":"Automatic Endpoint Creation with <code>crud_router</code>","text":"<p>This section of the documentation explains how to use the <code>crud_router</code> utility function from the FastCRUD package for automatic endpoint creation in a FastAPI application. The <code>crud_router</code> simplifies the process of creating standard CRUD (Create, Read, Update, Delete) endpoints for your models.</p>"},{"location":"usage/endpoint/#prerequisites","title":"Prerequisites","text":"<p>Before proceeding, ensure you have FastAPI and FastCRUD installed in your environment. FastCRUD streamlines interactions with the database using SQLAlchemy models and Pydantic schemas.</p>"},{"location":"usage/endpoint/#using-crud_router","title":"Using <code>crud_router</code>","text":""},{"location":"usage/endpoint/#step-1-define-your-model-and-schema","title":"Step 1: Define Your Model and Schema","text":"<p>First, define your SQLAlchemy model and corresponding Pydantic schemas for creating and updating data.</p> <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n</code></pre>"},{"location":"usage/endpoint/#step-2-set-up-fastapi-and-fastcrud","title":"Step 2: Set Up FastAPI and FastCRUD","text":"<p>Next, set up your FastAPI application, you can optionally set up a custom FastCRUD instance as well. This involves configuring the database connection.</p> <pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n</code></pre>"},{"location":"usage/endpoint/#step-3-use-crud_router-to-create-endpoints","title":"Step 3: Use <code>crud_router</code> to Create Endpoints","text":"<pre><code># CRUD router setup\nitem_router = crud_router(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    path=\"/items\",\n    tags=[\"Items\"],\n)\n\napp.include_router(item_router)\n</code></pre>"},{"location":"usage/endpoint/#available-endpoints","title":"Available Endpoints","text":"<p>For a comprehensive list of all available endpoints, read the advanced section.</p>"},{"location":"usage/endpoint/#usage-and-testing","title":"Usage and Testing","text":"<p>Once the application is running, you can test the automatically created endpoints using tools like Swagger UI, which FastAPI provides by default. The endpoints for creating, reading, updating, and deleting Item instances are now accessible at <code>/items</code>.</p>"},{"location":"usage/endpoint/#using-endpointcreator-directly","title":"Using <code>EndpointCreator</code> Directly","text":"<p>Using the <code>EndpointCreator</code> class in FastCRUD is a more flexible way to add CRUD endpoints to a FastAPI application.</p>"},{"location":"usage/endpoint/#step-1-define-your-model-and-schema_1","title":"Step 1: Define Your Model and Schema","text":"<p>Define your SQLAlchemy models and corresponding Pydantic schemas for data validation.</p> <code>item/model.py</code> <pre><code>from sqlalchemy import Column, DateTime, Integer, Numeric, String, func\nfrom sqlalchemy.orm import DeclarativeBase\n\n\nclass Base(DeclarativeBase):\n    pass\n\n\nclass Item(Base):\n    __tablename__ = \"items\"\n    id = Column(Integer, primary_key=True)\n    name = Column(String)\n    description = Column(String)\n    category = Column(String)\n    price = Column(Numeric)\n    last_sold = Column(DateTime)\n    created_at = Column(DateTime, default=func.now())\n</code></pre> <code>item/schemas.py</code> <pre><code>import datetime\n\nfrom pydantic import BaseModel\n\n\nclass CreateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass UpdateItemSchema(BaseModel):\n    name: str | None = None\n    description: str | None = None\n    category: str | None = None\n    price: float | None = None\n    last_sold: datetime.datetime | None = None\n\n\nclass DeleteItemSchema(BaseModel):\n    pass\n</code></pre>"},{"location":"usage/endpoint/#step-2-set-up-fastapi-and-fastcrud_1","title":"Step 2: Set Up FastAPI and FastCRUD","text":"<p>Next, set up your FastAPI application and FastCRUD instances. This involves configuring the database connection and creating a CRUD instance for your model.</p> <pre><code>from typing import AsyncGenerator\n\nfrom fastapi import FastAPI\nfrom fastcrud import FastCRUD, crud_router\nfrom sqlalchemy.ext.asyncio import AsyncSession, create_async_engine\nfrom sqlalchemy.orm import sessionmaker\n\n# Database setup (Async SQLAlchemy)\nDATABASE_URL = \"sqlite+aiosqlite:///./test.db\"\nengine = create_async_engine(DATABASE_URL, echo=True)\nasync_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False)\n\n# Database session dependency\nasync def get_session() -&gt; AsyncGenerator[AsyncSession, None]:\n    async with async_session() as session:\n        yield session\n\n# Create tables before the app start\nasync def lifespan(app: FastAPI):\n    async with engine.begin() as conn:\n        await conn.run_sync(Base.metadata.create_all)\n    yield\n\n# FastAPI app\napp = FastAPI(lifespan=lifespan)\n\n# CRUD operations setup\nitem_crud = FastCRUD(Item)\n</code></pre>"},{"location":"usage/endpoint/#step-3-initialize-endpointcreator","title":"Step 3: Initialize <code>EndpointCreator</code>","text":"<p>Create an instance of <code>EndpointCreator</code> by passing the necessary parameters, including your model, session, CRUD instance, and schemas.</p> <pre><code>from fastcrud import EndpointCreator\n\n# Initialize EndpointCreator\nendpoint_creator = EndpointCreator(\n    session=get_session,\n    model=Item,\n    create_schema=CreateItemSchema,\n    update_schema=UpdateItemSchema,\n    crud=item_crud,\n    delete_schema=DeleteItemSchema,\n    path=\"/itempath\",\n    tags=[\"ItemTag\"]\n)\n</code></pre>"},{"location":"usage/endpoint/#step-4-add-custom-endpoints","title":"Step 4: Add Custom Endpoints","text":"<p>Add custom endpoints using <code>EndpointCreator</code>. You can inject dependencies as needed.</p> <pre><code># Example of adding custom dependencies\nendpoint_creator.add_routes_to_router(\n    read_deps=[custom_dependency],\n    update_deps=[another_custom_dependency],\n)\n</code></pre>"},{"location":"usage/endpoint/#step-5-include-the-router-in-your-application","title":"Step 5: Include the Router in Your Application","text":"<p>Finally, include the router from the <code>EndpointCreator</code> in your FastAPI application.</p> <pre><code>app.include_router(endpoint_creator.router)\n</code></pre>"},{"location":"usage/endpoint/#advanced-customization","title":"Advanced Customization","text":"<p>You can override the default methods in <code>EndpointCreator</code> for more control over the CRUD operations. You can also specify the operations you want to include. Read more in the advanced section.</p>"},{"location":"usage/endpoint/#conclusion","title":"Conclusion","text":"<p>By following these steps, you can quickly set up CRUD endpoints for your models in a FastAPI application using <code>crud_router</code> or <code>EndpointCreator</code>. This utility function reduces boilerplate code and increases development efficiency by automating the creation of standard API endpoints.</p>"},{"location":"usage/overview/","title":"Usage Overview","text":"<p>The Usage section of our documentation provides comprehensive guides on how to effectively use key features of our application. This section is divided into various topics, each focusing on a specific aspect of usage, ensuring that you have all the information you need to leverage the full potential of our tools and functionalities.</p>"},{"location":"usage/overview/#key-topics","title":"Key Topics","text":""},{"location":"usage/overview/#1-automatic-endpoint-creation-with-crud_router","title":"1. Automatic Endpoint Creation with <code>crud_router</code>","text":"<p>This guide covers the use of <code>crud_router</code> for automatic endpoint creation in FastAPI applications. It provides a step-by-step approach to streamline the creation of standard CRUD endpoints.</p> <ul> <li>Automatic Endpoint Creation Guide</li> </ul>"},{"location":"usage/overview/#2-enhanced-crud-operations-with-fastcrud","title":"2. Enhanced CRUD Operations with FastCRUD","text":"<p>Learn how to use the <code>FastCRUD</code> class for enhanced CRUD operations. This guide delves into the functionalities offered by <code>FastCRUD</code>, including advanced query capabilities, pagination, and error handling.</p> <ul> <li>FastCRUD Usage Guide</li> </ul>"},{"location":"usage/overview/#getting-started","title":"Getting Started","text":"<p>To make the most out of these guides, we recommend familiarizing yourself with FastAPI and SQLAlchemy basics, as our application leverages these frameworks extensively.</p>"},{"location":"usage/overview/#contribution","title":"Contribution","text":"<p>If you have suggestions or contributions to these guides, please refer to our Contributing Guidelines. We appreciate your input in improving our documentation.</p>"}]}
\ No newline at end of file
diff --git a/showcase/index.html b/showcase/index.html
new file mode 100644
index 0000000..e2c50a7
--- /dev/null
+++ b/showcase/index.html
@@ -0,0 +1,1389 @@
+
+<!doctype html>
+<html lang="en" class="no-js">
+  <head>
+    
+      <meta charset="utf-8">
+      <meta name="viewport" content="width=device-width,initial-scale=1">
+      
+        <meta name="description" content="Powerful CRUD methods and automatic endpoint creation for FastAPI.">
+      
+      
+        <meta name="author" content="Igor Magalhaes">
+      
+      
+        <link rel="canonical" href="https://github.com/igorbenav/fastcrud/showcase/">
+      
+      
+        <link rel="prev" href="../api/paginated/">
+      
+      
+        <link rel="next" href="../community/overview/">
+      
+      
+      <link rel="icon" href="../assets/logo.png">
+      <meta name="generator" content="mkdocs-1.5.3, mkdocs-material-9.5.5">
+    
+    
+      
+        <title>Showcase - FastCRUD</title>
+      
+    
+    
+      <link rel="stylesheet" href="../assets/stylesheets/main.50c56a3b.min.css">
+      
+        
+        <link rel="stylesheet" href="../assets/stylesheets/palette.06af60db.min.css">
+      
+      
+
+
+    
+    
+      
+    
+    
+      
+        
+        
+        <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+        <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Ubuntu:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">
+        <style>:root{--md-text-font:"Ubuntu";--md-code-font:"Roboto Mono"}</style>
+      
+    
+    
+      <link rel="stylesheet" href="../assets/_mkdocstrings.css">
+    
+    <script>__md_scope=new URL("..",location),__md_hash=e=>[...e].reduce((e,_)=>(e<<5)-e+_.charCodeAt(0),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>
+    
+      
+
+    
+    
+    
+  </head>
+  
+  
+    
+    
+      
+    
+    
+    
+    
+    <body dir="ltr" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple">
+  
+    
+    <input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">
+    <input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">
+    <label class="md-overlay" for="__drawer"></label>
+    <div data-md-component="skip">
+      
+        
+        <a href="#showcase" class="md-skip">
+          Skip to content
+        </a>
+      
+    </div>
+    <div data-md-component="announce">
+      
+    </div>
+    
+    
+      
+
+<header class="md-header" data-md-component="header">
+  <nav class="md-header__inner md-grid" aria-label="Header">
+    <a href=".." title="FastCRUD" class="md-header__button md-logo" aria-label="FastCRUD" data-md-component="logo">
+      
+  <img src="../assets/logo.png" alt="logo">
+
+    </a>
+    <label class="md-header__button md-icon" for="__drawer">
+      
+      <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3V6m0 5h18v2H3v-2m0 5h18v2H3v-2Z"/></svg>
+    </label>
+    <div class="md-header__title" data-md-component="header-title">
+      <div class="md-header__ellipsis">
+        <div class="md-header__topic">
+          <span class="md-ellipsis">
+            FastCRUD
+          </span>
+        </div>
+        <div class="md-header__topic" data-md-component="header-topic">
+          <span class="md-ellipsis">
+            
+              Showcase
+            
+          </span>
+        </div>
+      </div>
+    </div>
+    
+      
+        <form class="md-header__option" data-md-component="palette">
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple"  aria-label="Switch to dark mode"  type="radio" name="__palette" id="__palette_0">
+    
+      <label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_1" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+    
+    
+    
+    <input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="deep-purple" data-md-color-accent="deep-purple"  aria-label="Switch to light mode"  type="radio" name="__palette" id="__palette_1">
+    
+      <label class="md-header__button md-icon" title="Switch to light mode" for="__palette_0" hidden>
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12c0-2.42-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12 20 8.69Z"/></svg>
+      </label>
+    
+  
+</form>
+      
+    
+    
+      <script>var media,input,key,value,palette=__md_get("__palette");if(palette&&palette.color){"(prefers-color-scheme)"===palette.color.media&&(media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']"),palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent"));for([key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
+    
+    
+    
+      <label class="md-header__button md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+      </label>
+      <div class="md-search" data-md-component="search" role="dialog">
+  <label class="md-search__overlay" for="__search"></label>
+  <div class="md-search__inner" role="search">
+    <form class="md-search__form" name="search">
+      <input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>
+      <label class="md-search__icon md-icon" for="__search">
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.516 6.516 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5Z"/></svg>
+        
+        <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11h12Z"/></svg>
+      </label>
+      <nav class="md-search__options" aria-label="Search">
+        
+        <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
+          
+          <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12 19 6.41Z"/></svg>
+        </button>
+      </nav>
+      
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
+    </form>
+    <div class="md-search__output">
+      <div class="md-search__scrollwrap" data-md-scrollfix>
+        <div class="md-search-result" data-md-component="search-result">
+          <div class="md-search-result__meta">
+            Initializing search
+          </div>
+          <ol class="md-search-result__list" role="presentation"></ol>
+        </div>
+      </div>
+    </div>
+  </div>
+</div>
+    
+    
+      <div class="md-header__source">
+        <a href="https://github.com/igorbenav/fastcrud" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    igorbenav/fastcrud
+  </div>
+</a>
+      </div>
+    
+  </nav>
+  
+</header>
+    
+    <div class="md-container" data-md-component="container">
+      
+      
+        
+          
+            
+<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
+  <div class="md-grid">
+    <ul class="md-tabs__list">
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href=".." class="md-tabs__link">
+        
+  
+    
+  
+  FastCRUD
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../installing/" class="md-tabs__link">
+        
+  
+    
+  
+  Installing
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../quick-start/" class="md-tabs__link">
+        
+  
+    
+  
+  Quick-Start
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../sqlmodel/" class="md-tabs__link">
+        
+  
+    
+  
+  Using SQLModel
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../usage/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Usage
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../advanced/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Advanced
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../api/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  API Reference
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+    
+  
+  
+    <li class="md-tabs__item md-tabs__item--active">
+      <a href="./" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
+    
+    
+      <li class="md-tabs__item">
+        <a href="../community/overview/" class="md-tabs__link">
+          
+  
+    
+  
+  Community
+
+        </a>
+      </li>
+    
+  
+
+      
+        
+  
+  
+  
+    <li class="md-tabs__item">
+      <a href="../changelog/" class="md-tabs__link">
+        
+  
+    
+  
+  Changelog
+
+      </a>
+    </li>
+  
+
+      
+    </ul>
+  </div>
+</nav>
+          
+        
+      
+      <main class="md-main" data-md-component="main">
+        <div class="md-main__inner md-grid">
+          
+            
+              
+              <div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+
+  
+
+
+<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+  <label class="md-nav__title" for="__drawer">
+    <a href=".." title="FastCRUD" class="md-nav__button md-logo" aria-label="FastCRUD" data-md-component="logo">
+      
+  <img src="../assets/logo.png" alt="logo">
+
+    </a>
+    FastCRUD
+  </label>
+  
+    <div class="md-nav__source">
+      <a href="https://github.com/igorbenav/fastcrud" title="Go to repository" class="md-source" data-md-component="source">
+  <div class="md-source__icon md-icon">
+    
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 448 512"><!--! Font Awesome Free 6.5.1 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2023 Fonticons, Inc.--><path d="M439.55 236.05 244 40.45a28.87 28.87 0 0 0-40.81 0l-40.66 40.63 51.52 51.52c27.06-9.14 52.68 16.77 43.39 43.68l49.66 49.66c34.23-11.8 61.18 31 35.47 56.69-26.49 26.49-70.21-2.87-56-37.34L240.22 199v121.85c25.3 12.54 22.26 41.85 9.08 55a34.34 34.34 0 0 1-48.55 0c-17.57-17.6-11.07-46.91 11.25-56v-123c-20.8-8.51-24.6-30.74-18.64-45L142.57 101 8.45 235.14a28.86 28.86 0 0 0 0 40.81l195.61 195.6a28.86 28.86 0 0 0 40.8 0l194.69-194.69a28.86 28.86 0 0 0 0-40.81z"/></svg>
+  </div>
+  <div class="md-source__repository">
+    igorbenav/fastcrud
+  </div>
+</a>
+    </div>
+  
+  <ul class="md-nav__list" data-md-scrollfix>
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href=".." class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastCRUD
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../installing/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Installing
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../quick-start/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Quick-Start
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../sqlmodel/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Using SQLModel
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" >
+        
+          
+          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Usage
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_5">
+            <span class="md-nav__icon md-icon"></span>
+            Usage
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../usage/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../usage/endpoint/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Automatic Endpoints
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../usage/crud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    CRUD Utilities
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" >
+        
+          
+          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Advanced
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_6">
+            <span class="md-nav__icon md-icon"></span>
+            Advanced
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../advanced/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../advanced/endpoint/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Custom Endpoints
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../advanced/crud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Advanced CRUD Usage
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../advanced/joins/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Joining Models
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_7" >
+        
+          
+          <label class="md-nav__link" for="__nav_7" id="__nav_7_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    API Reference
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_7_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_7">
+            <span class="md-nav__icon md-icon"></span>
+            API Reference
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../api/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../api/fastcrud/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    FastCRUD
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../api/endpoint_creator/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    EndpointCreator
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../api/crud_router/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    crud_router
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../api/paginated/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    paginated
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+    
+  
+  
+  
+    <li class="md-nav__item md-nav__item--active">
+      
+      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
+      
+      
+        
+      
+      
+        <label class="md-nav__link md-nav__link--active" for="__toc">
+          
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      
+      <a href="./" class="md-nav__link md-nav__link--active">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+      
+        
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#applications" class="md-nav__link">
+    <span class="md-ellipsis">
+      Applications
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#open-source" class="md-nav__link">
+    <span class="md-ellipsis">
+      Open Source
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#tutorials" class="md-nav__link">
+    <span class="md-ellipsis">
+      Tutorials
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    
+    
+      
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
+    
+    
+    
+      
+      
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
+      
+        
+        
+        
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
+        
+          
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
+            
+  
+  <span class="md-ellipsis">
+    Community
+  </span>
+  
+
+            <span class="md-nav__icon md-icon"></span>
+          </label>
+        
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
+            <span class="md-nav__icon md-icon"></span>
+            Community
+          </label>
+          <ul class="md-nav__list" data-md-scrollfix>
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../community/overview/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Overview
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../community/CONTRIBUTING/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Contributing
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../community/CODE_OF_CONDUCT/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Code of Conduct
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../community/LICENSE/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    License
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+          </ul>
+        </nav>
+      
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
+  
+    <li class="md-nav__item">
+      <a href="../changelog/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Changelog
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+  </ul>
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+            
+              
+              <div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >
+                <div class="md-sidebar__scrollwrap">
+                  <div class="md-sidebar__inner">
+                    
+
+<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
+  
+  
+  
+    
+  
+  
+    <label class="md-nav__title" for="__toc">
+      <span class="md-nav__icon md-icon"></span>
+      Table of contents
+    </label>
+    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
+      
+        <li class="md-nav__item">
+  <a href="#applications" class="md-nav__link">
+    <span class="md-ellipsis">
+      Applications
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#open-source" class="md-nav__link">
+    <span class="md-ellipsis">
+      Open Source
+    </span>
+  </a>
+  
+</li>
+      
+        <li class="md-nav__item">
+  <a href="#tutorials" class="md-nav__link">
+    <span class="md-ellipsis">
+      Tutorials
+    </span>
+  </a>
+  
+</li>
+      
+    </ul>
+  
+</nav>
+                  </div>
+                </div>
+              </div>
+            
+          
+          
+            <div class="md-content" data-md-component="content">
+              <article class="md-content__inner md-typeset">
+                
+                  
+
+  
+  
+
+
+<h1 id="showcase">Showcase<a class="headerlink" href="#showcase" title="Permanent link">&para;</a></h1>
+<div class="admonition example">
+<p class="admonition-title"><strong>Categories</strong></p>
+<p>Browse by type: <a href="#applications">Applications</a> · <a href="#tutorials">Tutorials</a></p>
+</div>
+<h2 id="applications">Applications<a class="headerlink" href="#applications" title="Permanent link">&para;</a></h2>
+<div class="admonition tip">
+<p class="admonition-title">Be the First!</p>
+<p>No applications yet. Have you built something with FastCRUD? We'd love to feature it here!</p>
+<p><strong><a href="../community/showcase_submission/">Submit Your Project</a></strong></p>
+</div>
+<h2 id="open-source">Open Source<a class="headerlink" href="#open-source" title="Permanent link">&para;</a></h2>
+<div class="admonition success">
+<p class="admonition-title">FastAPI Boilerplate</p>
+<p><strong>By FastCRUD Team</strong> · <a href="https://github.com/igorbenav/FastAPI-boilerplate">Source</a></p>
+<p>FastAPI boilerplate creates an extendable async API using FastAPI, Pydantic V2, SQLAlchemy 2.0 and PostgreSQL.</p>
+<p><code>Template</code> <code>FastAPI</code> <code>Boilerplate</code></p>
+</div>
+<div class="admonition success">
+<p class="admonition-title">Email Assistant API</p>
+<p><strong>By FastCRUD Team</strong> · <a href="https://github.com/igorbenav/email-assistant-api">Source</a></p>
+<p>A personalized email writing assistant built with FastAPI, OpenAI's API, and FastCRUD.</p>
+<p><code>OpenAI</code> <code>LLM</code> <code>AI</code></p>
+</div>
+<div class="admonition success">
+<p class="admonition-title">SQLModel Boilerplate</p>
+<p><strong>By FastCRUD Team</strong> · <a href="https://github.com/igorbenav/SQLModel-boilerplate">Source</a></p>
+<p>SQLModel boilerplate creates an extendable async API using FastAPI, SQLModel and PostgreSQL.</p>
+<p><code>Template</code> <code>SQLModel</code> <code>Boilerplate</code></p>
+</div>
+<h2 id="tutorials">Tutorials<a class="headerlink" href="#tutorials" title="Permanent link">&para;</a></h2>
+<div class="admonition note">
+<p class="admonition-title">Creating LLM Powered APIs with FastAPI</p>
+<p><strong>By FastCRUD Team</strong> · <a href="https://medium.com/@igorbenav/creating-llm-powered-apis-with-fastapi-in-2024-aecb02e40b8f">View Tutorial</a></p>
+<p>Learn the basics of creating LLM powered APIs with FastCRUD.</p>
+<p><code>FastAPI</code> <code>AI</code> <code>Beginner</code> <code>LLM</code></p>
+</div>
+<hr />
+<div class="admonition question">
+<p class="admonition-title">Add Your Project</p>
+<p>Built something with FastCRUD? We'd love to showcase it!</p>
+<p><strong><a href="../community/showcase_submission/">Submit Your Project</a></strong></p>
+</div>
+
+
+
+
+
+
+
+
+
+
+
+
+                
+              </article>
+            </div>
+          
+          
+<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
+        </div>
+        
+      </main>
+      
+        <footer class="md-footer">
+  
+  <div class="md-footer-meta md-typeset">
+    <div class="md-footer-meta__inner md-grid">
+      <div class="md-copyright">
+  
+  
+    Made with
+    <a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">
+      Material for MkDocs
+    </a>
+  
+</div>
+      
+    </div>
+  </div>
+</footer>
+      
+    </div>
+    <div class="md-dialog" data-md-component="dialog">
+      <div class="md-dialog__inner md-typeset"></div>
+    </div>
+    
+    
+    <script id="__config" type="application/json">{"base": "..", "features": ["navigation.instant", "navigation.instant.prefetch", "navigation.tabs", "navigation.indexes", "search.suggest", "content.code.copy"], "search": "../assets/javascripts/workers/search.b8dbb3d2.min.js", "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}}</script>
+    
+    
+      <script src="../assets/javascripts/bundle.c18c5fb9.min.js"></script>
+      
+    
+  </body>
+</html>
\ No newline at end of file
diff --git a/sitemap.xml b/sitemap.xml
index d9ebaef..2001fc6 100644
--- a/sitemap.xml
+++ b/sitemap.xml
@@ -2,107 +2,117 @@
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
     <url>
          <loc>https://github.com/igorbenav/fastcrud/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/changelog/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/installing/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/quick-start/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
+         <changefreq>daily</changefreq>
+    </url>
+    <url>
+         <loc>https://github.com/igorbenav/fastcrud/showcase/</loc>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/sqlmodel/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/advanced/crud/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/advanced/endpoint/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/advanced/joins/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/advanced/overview/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/api/crud_router/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/api/endpoint_creator/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/api/fastcrud/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/api/overview/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/api/paginated/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/community/CODE_OF_CONDUCT/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/community/CONTRIBUTING/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/community/LICENSE/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/community/overview/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
+         <changefreq>daily</changefreq>
+    </url>
+    <url>
+         <loc>https://github.com/igorbenav/fastcrud/community/showcase_submission/</loc>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/usage/crud/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/usage/endpoint/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
     <url>
          <loc>https://github.com/igorbenav/fastcrud/usage/overview/</loc>
-         <lastmod>2024-09-19</lastmod>
+         <lastmod>2025-01-09</lastmod>
          <changefreq>daily</changefreq>
     </url>
 </urlset>
\ No newline at end of file
diff --git a/sitemap.xml.gz b/sitemap.xml.gz
index feac14252acc7167612aaf8b7033ae5922ad0792..03c8ead7c74db4c474e86388c4e209b799769e59 100644
GIT binary patch
delta 396
zcmV;70dxL|1D*p2ABzYGt2cjVkq8}s$&$GsCPQ6J7ECrglUi!&R$6Qe%zwWk(|O)u
zX?p?6<MAcDhSzxcRWq-{Qc=Md{xpny4|60+%E`jt=bPZsUnY~dl}usnnP9FKex-Hu
z1VG>Sp`sesuu-9q1SnLQ3k7~AK@`sYWa61IBpA;wBW406Ll$My5UQ*85F$~314@KE
zU=BNQgi0gXmLLX0?ERzWPA$r07R?@lXc|Ow6Y?{67ltax2|h}EN=iuCIR<w#qY2zl
zf9H)!nIN`9DOVaYX1=TK(o;*(XJE8a+fG%L=n+)ddgqCm7h`6-6P6w12%BZ)z|y~A
zF)tfIxpoHpVYJE_tuVi*j^f^XdT>K8bz4Z$YAjvgUMsgi5<@MVFuT$j3|5y)w}FIm
zsImPmm#FKOQ+)>MZnZ9Un<Cw1t9_cg1kduf?ejk0W-sojU$^NxdtbW)c4hhfimwf2
qq1r=D)vznG9p5TQuoDg2D0QV<8@2ye!k2^D<R{;Se%(V95C8y;ZnpIR

delta 375
zcmV--0f_#d1Bn9&ABzYG42J7wkq8}s*<mh-$xs)Q1(QwBq$|(Tt+dz{nE!r7obkNF
zLVE!okH?qr3MF2CSKMnsX(q+OpN5g|fgrMAf-d~SeiJ<U%VZKaifb^QO%{6Lm&Vjj
z2z6Z-YG$CqwGO4CNR!eYXmkytD4hGr#IvI>Fzj7M%q2<sD%zHz%#_VXNMwb77?tV+
z1a8q0YeQ61pcwVJ_m|o;l`N83G<yi5c`%*ZlxyrRjg(kWI4U?L1!nvlqr1ppLO0ak
zc|%by>DZx6XoESo&voq5Q^UwtV71DOovKgV-Wd4Uow#VRAYj|ofhl#vf+%XqgmDJ^
zX|>uJt+cQGmO(dqaLq1#n=9F77*H;7e>*oP3b2t*m|gke_Ewi#x5ktSY+(FL8Cg}0
zVCIa{-D;ihHhH?sR)=)&5<J_#ZJ!VOZT8}h`gNPGv-h<-U{|JJqcH_1);xpMl?BhB
V{l6}_Z0!GM@&nsf0dlVn005CCx%U77

diff --git a/sqlmodel/index.html b/sqlmodel/index.html
index 76505ec..9a2c772 100644
--- a/sqlmodel/index.html
+++ b/sqlmodel/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -946,6 +963,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -956,6 +993,8 @@
       
         
       
+        
+      
         
       
     
@@ -970,10 +1009,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -984,8 +1023,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1039,6 +1078,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/usage/crud/index.html b/usage/crud/index.html
index 0236abe..e07cd61 100644
--- a/usage/crud/index.html
+++ b/usage/crud/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1194,6 +1211,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1204,6 +1241,8 @@
       
         
       
+        
+      
         
       
     
@@ -1218,10 +1257,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1232,8 +1271,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1287,6 +1326,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/usage/endpoint/index.html b/usage/endpoint/index.html
index 382831a..788a9a2 100644
--- a/usage/endpoint/index.html
+++ b/usage/endpoint/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1125,6 +1142,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1135,6 +1172,8 @@
       
         
       
+        
+      
         
       
     
@@ -1149,10 +1188,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1163,8 +1202,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1218,6 +1257,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">
         
diff --git a/usage/overview/index.html b/usage/overview/index.html
index f4ca97d..0428511 100644
--- a/usage/overview/index.html
+++ b/usage/overview/index.html
@@ -351,6 +351,23 @@
   
   
   
+    <li class="md-tabs__item">
+      <a href="../../showcase/" class="md-tabs__link">
+        
+  
+    
+  
+  Showcase
+
+      </a>
+    </li>
+  
+
+      
+        
+  
+  
+  
     
     
       <li class="md-tabs__item">
@@ -1029,6 +1046,26 @@
   
   
   
+  
+    <li class="md-nav__item">
+      <a href="../../showcase/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+    
+      
+      
+  
+  
+  
   
     
     
@@ -1039,6 +1076,8 @@
       
         
       
+        
+      
         
       
     
@@ -1053,10 +1092,10 @@
         
         
         
-        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_8" >
+        <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_9" >
         
           
-          <label class="md-nav__link" for="__nav_8" id="__nav_8_label" tabindex="">
+          <label class="md-nav__link" for="__nav_9" id="__nav_9_label" tabindex="">
             
   
   <span class="md-ellipsis">
@@ -1067,8 +1106,8 @@
             <span class="md-nav__icon md-icon"></span>
           </label>
         
-        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_8_label" aria-expanded="false">
-          <label class="md-nav__title" for="__nav_8">
+        <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_9_label" aria-expanded="false">
+          <label class="md-nav__title" for="__nav_9">
             <span class="md-nav__icon md-icon"></span>
             Community
           </label>
@@ -1122,6 +1161,27 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../community/showcase_submission/" class="md-nav__link">
+        
+  
+  <span class="md-ellipsis">
+    Showcase Submission
+  </span>
+  
+
+      </a>
+    </li>
+  
+
+              
+            
+              
+                
+  
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../community/CODE_OF_CONDUCT/" class="md-nav__link">