nautobot 2.0.5__py3-none-any.whl → 2.1.0b1__py3-none-any.whl

nautobot/project-static/docs/code-reference/nautobot/apps/utils.html

@@ -2659,6 +2659,20 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../../user-guide/platform-functionality/externalintegration.html" class="md-nav__link">
+        External Integrations
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../../user-guide/platform-functionality/gitrepository.html" class="md-nav__link">
         Git Repositories
@@ -2679,7 +2693,7 @@
       
       
       
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_8" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_9" >
       
       
       
@@ -2688,14 +2702,14 @@
         <div class="md-nav__link md-nav__link--index ">
           <a href="../../../user-guide/platform-functionality/graphql.html">GraphQL</a>
           
-            <label for="__nav_2_4_8">
+            <label for="__nav_2_4_9">
               <span class="md-nav__icon md-icon"></span>
             </label>
           
         </div>
       
-      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_8_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_4_8">
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_9_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_4_9">
           <span class="md-nav__icon md-icon"></span>
           GraphQL
         </label>
@@ -2747,7 +2761,7 @@
       
       
       
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_10" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_11" >
       
       
       
@@ -2756,14 +2770,14 @@
         <div class="md-nav__link md-nav__link--index ">
           <a href="../../../user-guide/platform-functionality/jobs/index.html">Jobs</a>
           
-            <label for="__nav_2_4_10">
+            <label for="__nav_2_4_11">
               <span class="md-nav__icon md-icon"></span>
             </label>
           
         </div>
       
-      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_10_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_4_10">
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_11_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_4_11">
           <span class="md-nav__icon md-icon"></span>
           Jobs
         </label>
@@ -2885,7 +2899,7 @@
       
       
       
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_14" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_15" >
       
       
       
@@ -2894,14 +2908,14 @@
         <div class="md-nav__link md-nav__link--index ">
           <a href="../../../user-guide/platform-functionality/rest-api/overview.html">REST API</a>
           
-            <label for="__nav_2_4_14">
+            <label for="__nav_2_4_15">
               <span class="md-nav__icon md-icon"></span>
             </label>
           
         </div>
       
-      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_14_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_4_14">
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_15_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_4_15">
           <span class="md-nav__icon md-icon"></span>
           REST API
         </label>
@@ -3037,17 +3051,17 @@
       
       
       
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_20" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_4_21" >
       
       
       
-        <label class="md-nav__link" for="__nav_2_4_20" id="__nav_2_4_20_label" tabindex="0">
+        <label class="md-nav__link" for="__nav_2_4_21" id="__nav_2_4_21_label" tabindex="0">
           Users
           <span class="md-nav__icon md-icon"></span>
         </label>
       
-      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_20_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_4_20">
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_4_21_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_4_21">
           <span class="md-nav__icon md-icon"></span>
           Users
         </label>
@@ -5353,6 +5367,20 @@
   
   
   
+    <li class="md-nav__item">
+      <a href="../../../release-notes/version-2.1.html" class="md-nav__link">
+        Version 2.1
+      </a>
+    </li>
+  
+
+            
+          
+            
+              
+  
+  
+  
     <li class="md-nav__item">
       <a href="../../../release-notes/version-2.0.html" class="md-nav__link">
         Version 2.0
@@ -9097,8 +9125,7 @@ to return only queryset filterable parameters.</p>
 <span class="normal"><a href="#__codelineno-0-133">133</a></span>
 <span class="normal"><a href="#__codelineno-0-134">134</a></span>
 <span class="normal"><a href="#__codelineno-0-135">135</a></span>
-<span class="normal"><a href="#__codelineno-0-136">136</a></span>
-<span class="normal"><a href="#__codelineno-0-137">137</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="k">def</span> <span class="nf">get_filterable_params_from_filter_params</span><span class="p">(</span><span class="n">filter_params</span><span class="p">,</span> <span class="n">non_filter_params</span><span class="p">,</span> <span class="n">filterset</span><span class="p">):</span>
+<span class="normal"><a href="#__codelineno-0-136">136</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-104" name="__codelineno-0-104"></a><span class="k">def</span> <span class="nf">get_filterable_params_from_filter_params</span><span class="p">(</span><span class="n">filter_params</span><span class="p">,</span> <span class="n">non_filter_params</span><span class="p">,</span> <span class="n">filterset</span><span class="p">):</span>
 <a id="__codelineno-0-105" name="__codelineno-0-105"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
 <a id="__codelineno-0-106" name="__codelineno-0-106"></a><span class="sd">    Remove any `non_filter_params` and fields that are not a part of the filterset from  `filter_params`</span>
 <a id="__codelineno-0-107" name="__codelineno-0-107"></a><span class="sd">    to return only queryset filterable parameters.</span>
@@ -9111,27 +9138,26 @@ to return only queryset filterable parameters.</p>
 <a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">    Returns:</span>
 <a id="__codelineno-0-115" name="__codelineno-0-115"></a><span class="sd">        (QueryDict): Filter param querydict with only queryset filterable params</span>
 <a id="__codelineno-0-116" name="__codelineno-0-116"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-117" name="__codelineno-0-117"></a>    <span class="k">for</span> <span class="n">non_filter_param</span> <span class="ow">in</span> <span class="n">non_filter_params</span><span class="p">:</span>
-<a id="__codelineno-0-118" name="__codelineno-0-118"></a>        <span class="n">filter_params</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">non_filter_param</span><span class="p">,</span> <span class="kc">None</span><span class="p">)</span>
-<a id="__codelineno-0-119" name="__codelineno-0-119"></a>
-<a id="__codelineno-0-120" name="__codelineno-0-120"></a>    <span class="c1"># Some FilterSet field only accept single choice not multiple choices</span>
-<a id="__codelineno-0-121" name="__codelineno-0-121"></a>    <span class="c1"># e.g datetime field, bool fields etc.</span>
-<a id="__codelineno-0-122" name="__codelineno-0-122"></a>    <span class="n">final_filter_params</span> <span class="o">=</span> <span class="p">{}</span>
-<a id="__codelineno-0-123" name="__codelineno-0-123"></a>    <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
-<a id="__codelineno-0-124" name="__codelineno-0-124"></a>        <span class="k">if</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field</span><span class="p">):</span>
-<a id="__codelineno-0-125" name="__codelineno-0-125"></a>            <span class="c1"># `is_single_choice_field` implements `get_filterset_field`, which throws an exception if a field is not found.</span>
-<a id="__codelineno-0-126" name="__codelineno-0-126"></a>            <span class="c1"># If an exception is thrown, instead of throwing an exception, set `_is_single_choice_field` to &#39;False&#39;</span>
-<a id="__codelineno-0-127" name="__codelineno-0-127"></a>            <span class="c1"># because the fields that were not discovered are still necessary.</span>
-<a id="__codelineno-0-128" name="__codelineno-0-128"></a>            <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-0-129" name="__codelineno-0-129"></a>                <span class="n">_is_single_choice_field</span> <span class="o">=</span> <span class="n">is_single_choice_field</span><span class="p">(</span><span class="n">filterset</span><span class="p">,</span> <span class="n">field</span><span class="p">)</span>
-<a id="__codelineno-0-130" name="__codelineno-0-130"></a>            <span class="k">except</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">FilterSetFieldNotFound</span><span class="p">:</span>
-<a id="__codelineno-0-131" name="__codelineno-0-131"></a>                <span class="n">_is_single_choice_field</span> <span class="o">=</span> <span class="kc">False</span>
-<a id="__codelineno-0-132" name="__codelineno-0-132"></a>
-<a id="__codelineno-0-133" name="__codelineno-0-133"></a>            <span class="n">final_filter_params</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
-<a id="__codelineno-0-134" name="__codelineno-0-134"></a>                <span class="n">filter_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field</span><span class="p">)</span> <span class="k">if</span> <span class="n">_is_single_choice_field</span> <span class="k">else</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">field</span><span class="p">)</span>
-<a id="__codelineno-0-135" name="__codelineno-0-135"></a>            <span class="p">)</span>
-<a id="__codelineno-0-136" name="__codelineno-0-136"></a>
-<a id="__codelineno-0-137" name="__codelineno-0-137"></a>    <span class="k">return</span> <span class="n">final_filter_params</span>
+<a id="__codelineno-0-117" name="__codelineno-0-117"></a>    <span class="c1"># Some FilterSet field only accept single choice not multiple choices</span>
+<a id="__codelineno-0-118" name="__codelineno-0-118"></a>    <span class="c1"># e.g datetime field, bool fields etc.</span>
+<a id="__codelineno-0-119" name="__codelineno-0-119"></a>    <span class="n">final_filter_params</span> <span class="o">=</span> <span class="p">{}</span>
+<a id="__codelineno-0-120" name="__codelineno-0-120"></a>    <span class="k">for</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+<a id="__codelineno-0-121" name="__codelineno-0-121"></a>        <span class="k">if</span> <span class="n">field</span> <span class="ow">in</span> <span class="n">non_filter_params</span><span class="p">:</span>
+<a id="__codelineno-0-122" name="__codelineno-0-122"></a>            <span class="k">continue</span>
+<a id="__codelineno-0-123" name="__codelineno-0-123"></a>        <span class="k">if</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field</span><span class="p">):</span>
+<a id="__codelineno-0-124" name="__codelineno-0-124"></a>            <span class="c1"># `is_single_choice_field` implements `get_filterset_field`, which throws an exception if a field is not found.</span>
+<a id="__codelineno-0-125" name="__codelineno-0-125"></a>            <span class="c1"># If an exception is thrown, instead of throwing an exception, set `_is_single_choice_field` to &#39;False&#39;</span>
+<a id="__codelineno-0-126" name="__codelineno-0-126"></a>            <span class="c1"># because the fields that were not discovered are still necessary.</span>
+<a id="__codelineno-0-127" name="__codelineno-0-127"></a>            <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-0-128" name="__codelineno-0-128"></a>                <span class="n">_is_single_choice_field</span> <span class="o">=</span> <span class="n">is_single_choice_field</span><span class="p">(</span><span class="n">filterset</span><span class="p">,</span> <span class="n">field</span><span class="p">)</span>
+<a id="__codelineno-0-129" name="__codelineno-0-129"></a>            <span class="k">except</span> <span class="n">exceptions</span><span class="o">.</span><span class="n">FilterSetFieldNotFound</span><span class="p">:</span>
+<a id="__codelineno-0-130" name="__codelineno-0-130"></a>                <span class="n">_is_single_choice_field</span> <span class="o">=</span> <span class="kc">False</span>
+<a id="__codelineno-0-131" name="__codelineno-0-131"></a>
+<a id="__codelineno-0-132" name="__codelineno-0-132"></a>            <span class="n">final_filter_params</span><span class="p">[</span><span class="n">field</span><span class="p">]</span> <span class="o">=</span> <span class="p">(</span>
+<a id="__codelineno-0-133" name="__codelineno-0-133"></a>                <span class="n">filter_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field</span><span class="p">)</span> <span class="k">if</span> <span class="n">_is_single_choice_field</span> <span class="k">else</span> <span class="n">filter_params</span><span class="o">.</span><span class="n">getlist</span><span class="p">(</span><span class="n">field</span><span class="p">)</span>
+<a id="__codelineno-0-134" name="__codelineno-0-134"></a>            <span class="p">)</span>
+<a id="__codelineno-0-135" name="__codelineno-0-135"></a>
+<a id="__codelineno-0-136" name="__codelineno-0-136"></a>    <span class="k">return</span> <span class="n">final_filter_params</span>
 </code></pre></div></td></tr></table></div>
           </details>
   </div>
@@ -11136,7 +11162,8 @@ values.</p>
 
           <details class="quote">
             <summary>Source code in <code>nautobot/core/utils/requests.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-140">140</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-139">139</a></span>
+<span class="normal"><a href="#__codelineno-0-140">140</a></span>
 <span class="normal"><a href="#__codelineno-0-141">141</a></span>
 <span class="normal"><a href="#__codelineno-0-142">142</a></span>
 <span class="normal"><a href="#__codelineno-0-143">143</a></span>
@@ -11168,41 +11195,40 @@ values.</p>
 <span class="normal"><a href="#__codelineno-0-169">169</a></span>
 <span class="normal"><a href="#__codelineno-0-170">170</a></span>
 <span class="normal"><a href="#__codelineno-0-171">171</a></span>
-<span class="normal"><a href="#__codelineno-0-172">172</a></span>
-<span class="normal"><a href="#__codelineno-0-173">173</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="k">def</span> <span class="nf">normalize_querydict</span><span class="p">(</span><span class="n">querydict</span><span class="p">,</span> <span class="n">form_class</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
-<a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">    Convert a QueryDict to a normal, mutable dictionary, preserving list values. For example,</span>
-<a id="__codelineno-0-143" name="__codelineno-0-143"></a>
-<a id="__codelineno-0-144" name="__codelineno-0-144"></a><span class="sd">        QueryDict(&#39;foo=1&amp;bar=2&amp;bar=3&amp;baz=&#39;)</span>
-<a id="__codelineno-0-145" name="__codelineno-0-145"></a>
-<a id="__codelineno-0-146" name="__codelineno-0-146"></a><span class="sd">    becomes:</span>
-<a id="__codelineno-0-147" name="__codelineno-0-147"></a>
-<a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="sd">        {&#39;foo&#39;: &#39;1&#39;, &#39;bar&#39;: [&#39;2&#39;, &#39;3&#39;], &#39;baz&#39;: &#39;&#39;}</span>
-<a id="__codelineno-0-149" name="__codelineno-0-149"></a>
-<a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">    This function is necessary because QueryDict does not provide any built-in mechanism which preserves multiple</span>
-<a id="__codelineno-0-151" name="__codelineno-0-151"></a><span class="sd">    values.</span>
-<a id="__codelineno-0-152" name="__codelineno-0-152"></a>
-<a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">    A `form_class` can be provided as a way to hint which query parameters should be treated as lists.</span>
-<a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-155" name="__codelineno-0-155"></a>    <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span>
-<a id="__codelineno-0-156" name="__codelineno-0-156"></a>    <span class="k">if</span> <span class="n">querydict</span><span class="p">:</span>
-<a id="__codelineno-0-157" name="__codelineno-0-157"></a>        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value_list</span> <span class="ow">in</span> <span class="n">querydict</span><span class="o">.</span><span class="n">lists</span><span class="p">():</span>
-<a id="__codelineno-0-158" name="__codelineno-0-158"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">value_list</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
-<a id="__codelineno-0-159" name="__codelineno-0-159"></a>                <span class="c1"># More than one value in the querydict for this key, so keep it as a list</span>
-<a id="__codelineno-0-160" name="__codelineno-0-160"></a>                <span class="c1"># TODO: we could check here and de-listify value_list if the form_class field is a single-value one?</span>
-<a id="__codelineno-0-161" name="__codelineno-0-161"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span>
-<a id="__codelineno-0-162" name="__codelineno-0-162"></a>            <span class="k">elif</span> <span class="p">(</span>
-<a id="__codelineno-0-163" name="__codelineno-0-163"></a>                <span class="n">form_class</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
-<a id="__codelineno-0-164" name="__codelineno-0-164"></a>                <span class="ow">and</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">form_class</span><span class="o">.</span><span class="n">base_fields</span>
-<a id="__codelineno-0-165" name="__codelineno-0-165"></a>                <span class="c1"># ModelMultipleChoiceField is *not* itself a subclass of MultipleChoiceField, thanks Django!</span>
-<a id="__codelineno-0-166" name="__codelineno-0-166"></a>                <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">form_class</span><span class="o">.</span><span class="n">base_fields</span><span class="p">[</span><span class="n">key</span><span class="p">],</span> <span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">MultipleChoiceField</span><span class="p">,</span> <span class="n">forms</span><span class="o">.</span><span class="n">ModelMultipleChoiceField</span><span class="p">))</span>
-<a id="__codelineno-0-167" name="__codelineno-0-167"></a>            <span class="p">):</span>
-<a id="__codelineno-0-168" name="__codelineno-0-168"></a>                <span class="c1"># Even though there&#39;s only a single value in the querydict for this key, the form wants it as a list</span>
-<a id="__codelineno-0-169" name="__codelineno-0-169"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span>
-<a id="__codelineno-0-170" name="__codelineno-0-170"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-171" name="__codelineno-0-171"></a>                <span class="c1"># Only a single value in the querydict for this key, and no guidance otherwise, so make it single</span>
-<a id="__codelineno-0-172" name="__codelineno-0-172"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
-<a id="__codelineno-0-173" name="__codelineno-0-173"></a>    <span class="k">return</span> <span class="n">result</span>
+<span class="normal"><a href="#__codelineno-0-172">172</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-139" name="__codelineno-0-139"></a><span class="k">def</span> <span class="nf">normalize_querydict</span><span class="p">(</span><span class="n">querydict</span><span class="p">,</span> <span class="n">form_class</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="sd">    Convert a QueryDict to a normal, mutable dictionary, preserving list values. For example,</span>
+<a id="__codelineno-0-142" name="__codelineno-0-142"></a>
+<a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">        QueryDict(&#39;foo=1&amp;bar=2&amp;bar=3&amp;baz=&#39;)</span>
+<a id="__codelineno-0-144" name="__codelineno-0-144"></a>
+<a id="__codelineno-0-145" name="__codelineno-0-145"></a><span class="sd">    becomes:</span>
+<a id="__codelineno-0-146" name="__codelineno-0-146"></a>
+<a id="__codelineno-0-147" name="__codelineno-0-147"></a><span class="sd">        {&#39;foo&#39;: &#39;1&#39;, &#39;bar&#39;: [&#39;2&#39;, &#39;3&#39;], &#39;baz&#39;: &#39;&#39;}</span>
+<a id="__codelineno-0-148" name="__codelineno-0-148"></a>
+<a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="sd">    This function is necessary because QueryDict does not provide any built-in mechanism which preserves multiple</span>
+<a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">    values.</span>
+<a id="__codelineno-0-151" name="__codelineno-0-151"></a>
+<a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">    A `form_class` can be provided as a way to hint which query parameters should be treated as lists.</span>
+<a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-154" name="__codelineno-0-154"></a>    <span class="n">result</span> <span class="o">=</span> <span class="p">{}</span>
+<a id="__codelineno-0-155" name="__codelineno-0-155"></a>    <span class="k">if</span> <span class="n">querydict</span><span class="p">:</span>
+<a id="__codelineno-0-156" name="__codelineno-0-156"></a>        <span class="k">for</span> <span class="n">key</span><span class="p">,</span> <span class="n">value_list</span> <span class="ow">in</span> <span class="n">querydict</span><span class="o">.</span><span class="n">lists</span><span class="p">():</span>
+<a id="__codelineno-0-157" name="__codelineno-0-157"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">value_list</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">1</span><span class="p">:</span>
+<a id="__codelineno-0-158" name="__codelineno-0-158"></a>                <span class="c1"># More than one value in the querydict for this key, so keep it as a list</span>
+<a id="__codelineno-0-159" name="__codelineno-0-159"></a>                <span class="c1"># TODO: we could check here and de-listify value_list if the form_class field is a single-value one?</span>
+<a id="__codelineno-0-160" name="__codelineno-0-160"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span>
+<a id="__codelineno-0-161" name="__codelineno-0-161"></a>            <span class="k">elif</span> <span class="p">(</span>
+<a id="__codelineno-0-162" name="__codelineno-0-162"></a>                <span class="n">form_class</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span>
+<a id="__codelineno-0-163" name="__codelineno-0-163"></a>                <span class="ow">and</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">form_class</span><span class="o">.</span><span class="n">base_fields</span>
+<a id="__codelineno-0-164" name="__codelineno-0-164"></a>                <span class="c1"># ModelMultipleChoiceField is *not* itself a subclass of MultipleChoiceField, thanks Django!</span>
+<a id="__codelineno-0-165" name="__codelineno-0-165"></a>                <span class="ow">and</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">form_class</span><span class="o">.</span><span class="n">base_fields</span><span class="p">[</span><span class="n">key</span><span class="p">],</span> <span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">MultipleChoiceField</span><span class="p">,</span> <span class="n">forms</span><span class="o">.</span><span class="n">ModelMultipleChoiceField</span><span class="p">))</span>
+<a id="__codelineno-0-166" name="__codelineno-0-166"></a>            <span class="p">):</span>
+<a id="__codelineno-0-167" name="__codelineno-0-167"></a>                <span class="c1"># Even though there&#39;s only a single value in the querydict for this key, the form wants it as a list</span>
+<a id="__codelineno-0-168" name="__codelineno-0-168"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span>
+<a id="__codelineno-0-169" name="__codelineno-0-169"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-170" name="__codelineno-0-170"></a>                <span class="c1"># Only a single value in the querydict for this key, and no guidance otherwise, so make it single</span>
+<a id="__codelineno-0-171" name="__codelineno-0-171"></a>                <span class="n">result</span><span class="p">[</span><span class="n">key</span><span class="p">]</span> <span class="o">=</span> <span class="n">value_list</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span>
+<a id="__codelineno-0-172" name="__codelineno-0-172"></a>    <span class="k">return</span> <span class="n">result</span>
 </code></pre></div></td></tr></table></div>
           </details>
   </div>