Deploying to gh-pages from @ bc57f0f 🚀

ServiceNow · Oct 11, 2024 · 8d029f2 · 8d029f2
1 parent 6d90fa1
commit 8d029f2
Show file tree

Hide file tree

Showing 18 changed files with 212 additions and 80 deletions.
diff --git a/_modules/index.html b/_modules/index.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Overview: module code &#8212; PySNC 1.1.8 documentation</title>
+    <title>Overview: module code &#8212; PySNC 1.1.9 documentation</title>
     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=039e1c02" />
-    <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=fd6a9826"></script>
+    <script data-url_root="../" id="documentation_options" src="../_static/documentation_options.js?v=59121c3f"></script>
     <script src="../_static/doctools.js?v=888ff710"></script>
     <script src="../_static/sphinx_highlight.js?v=4825356b"></script>
     <link rel="index" title="Index" href="../genindex.html" />

diff --git a/_modules/pysnc/attachment.html b/_modules/pysnc/attachment.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>pysnc.attachment &#8212; PySNC 1.1.8 documentation</title>
+    <title>pysnc.attachment &#8212; PySNC 1.1.9 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../_static/alabaster.css?v=039e1c02" />
-    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=fd6a9826"></script>
+    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=59121c3f"></script>
     <script src="../../_static/doctools.js?v=888ff710"></script>
     <script src="../../_static/sphinx_highlight.js?v=4825356b"></script>
     <link rel="index" title="Index" href="../../genindex.html" />

diff --git a/_modules/pysnc/client.html b/_modules/pysnc/client.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>pysnc.client &#8212; PySNC 1.1.8 documentation</title>
+    <title>pysnc.client &#8212; PySNC 1.1.9 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../_static/alabaster.css?v=039e1c02" />
-    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=fd6a9826"></script>
+    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=59121c3f"></script>
     <script src="../../_static/doctools.js?v=888ff710"></script>
     <script src="../../_static/sphinx_highlight.js?v=4825356b"></script>
     <link rel="index" title="Index" href="../../genindex.html" />
@@ -179,7 +179,8 @@ <h1>Source code for pysnc.client</h1><div class="highlight"><pre>
         <span class="n">params</span> <span class="o">=</span> <span class="p">{}</span> <span class="k">if</span> <span class="n">record</span> <span class="ow">is</span> <span class="kc">None</span> <span class="k">else</span> <span class="n">record</span><span class="o">.</span><span class="n">_parameters</span><span class="p">()</span>
         <span class="k">if</span> <span class="s1">&#39;sysparm_display_value&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">params</span><span class="p">:</span>
             <span class="n">params</span><span class="p">[</span><span class="s1">&#39;sysparm_display_value&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;all&#39;</span>
-        <span class="n">params</span><span class="p">[</span><span class="s1">&#39;sysparm_exclude_reference_link&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;true&#39;</span>  <span class="c1"># Scratch it!</span>
+        <span class="k">if</span> <span class="s1">&#39;sysparm_exclude_reference_link&#39;</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">params</span><span class="p">:</span>
+            <span class="n">params</span><span class="p">[</span><span class="s1">&#39;sysparm_exclude_reference_link&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;true&#39;</span>  <span class="c1"># Scratch it!, by default</span>
         <span class="n">params</span><span class="p">[</span><span class="s1">&#39;sysparm_suppress_pagination_header&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;true&#39;</span>  <span class="c1"># Required for large queries</span>
         <span class="k">return</span> <span class="n">params</span>
 
@@ -395,7 +396,14 @@ <h1>Source code for pysnc.client</h1><div class="highlight"><pre>
 
         <span class="k">return</span> <span class="n">response</span>
 
-<div class="viewcode-block" id="BatchAPI.execute"><a class="viewcode-back" href="../../api.html#pysnc.BatchAPI.execute">[docs]</a>    <span class="k">def</span> <span class="nf">execute</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<div class="viewcode-block" id="BatchAPI.execute"><a class="viewcode-back" href="../../api.html#pysnc.BatchAPI.execute">[docs]</a>    <span class="k">def</span> <span class="nf">execute</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">attempt</span><span class="o">=</span><span class="mi">0</span><span class="p">):</span>
+        <span class="k">if</span> <span class="n">attempt</span> <span class="o">&gt;</span> <span class="mi">2</span><span class="p">:</span>
+            <span class="c1"># just give up and tell em we tried</span>
+            <span class="k">for</span> <span class="n">h</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">:</span>
+                <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">[</span><span class="n">h</span><span class="p">](</span><span class="kc">None</span><span class="p">)</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span> <span class="o">=</span> <span class="p">{}</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">__requests</span> <span class="o">=</span> <span class="p">[]</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span> <span class="o">=</span> <span class="p">{}</span>
         <span class="n">bid</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_next_id</span><span class="p">()</span>
         <span class="n">body</span> <span class="o">=</span> <span class="p">{</span>
             <span class="s1">&#39;batch_request_id&#39;</span><span class="p">:</span> <span class="n">bid</span><span class="p">,</span>
@@ -404,20 +412,18 @@ <h1>Source code for pysnc.client</h1><div class="highlight"><pre>
         <span class="n">r</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">session</span><span class="o">.</span><span class="n">post</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_batch_target</span><span class="p">(),</span> <span class="n">json</span><span class="o">=</span><span class="n">body</span><span class="p">)</span>
         <span class="bp">self</span><span class="o">.</span><span class="n">_validate_response</span><span class="p">(</span><span class="n">r</span><span class="p">)</span>
         <span class="n">data</span> <span class="o">=</span> <span class="n">r</span><span class="o">.</span><span class="n">json</span><span class="p">()</span>
-        <span class="k">try</span><span class="p">:</span>
-            <span class="k">assert</span> <span class="nb">str</span><span class="p">(</span><span class="n">bid</span><span class="p">)</span> <span class="o">==</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;batch_request_id&#39;</span><span class="p">],</span> <span class="sa">f</span><span class="s2">&quot;How did we get a response id different from </span><span class="si">{</span><span class="n">bid</span><span class="si">}</span><span class="s2">&quot;</span>
-
-            <span class="k">for</span> <span class="n">response</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;serviced_requests&#39;</span><span class="p">]</span> <span class="o">+</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;unserviced_requests&#39;</span><span class="p">]:</span>
-                <span class="n">response_id</span> <span class="o">=</span> <span class="n">response</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]</span>
-                <span class="k">assert</span> <span class="n">response_id</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;Somehow has no hook for </span><span class="si">{</span><span class="n">response_id</span><span class="si">}</span><span class="s2">&quot;</span>
-                <span class="k">assert</span> <span class="n">response_id</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;Somehow we did not store request for </span><span class="si">{</span><span class="n">response_id</span><span class="si">}</span><span class="s2">&quot;</span>
-                <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">[</span><span class="n">response</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]](</span><span class="bp">self</span><span class="o">.</span><span class="n">_transform_response</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span><span class="p">[</span><span class="n">response_id</span><span class="p">],</span> <span class="n">response</span><span class="p">))</span>
-
-            <span class="k">return</span> <span class="n">bid</span>
-        <span class="k">finally</span><span class="p">:</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span> <span class="o">=</span> <span class="p">{}</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__requests</span> <span class="o">=</span> <span class="p">[]</span>
-            <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span> <span class="o">=</span> <span class="p">{}</span></div>
+        <span class="k">assert</span> <span class="nb">str</span><span class="p">(</span><span class="n">bid</span><span class="p">)</span> <span class="o">==</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;batch_request_id&#39;</span><span class="p">],</span> <span class="sa">f</span><span class="s2">&quot;How did we get a response id different from </span><span class="si">{</span><span class="n">bid</span><span class="si">}</span><span class="s2">&quot;</span>
+
+        <span class="k">for</span> <span class="n">response</span> <span class="ow">in</span> <span class="n">data</span><span class="p">[</span><span class="s1">&#39;serviced_requests&#39;</span><span class="p">]:</span>
+            <span class="n">response_id</span> <span class="o">=</span> <span class="n">response</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]</span>
+            <span class="k">assert</span> <span class="n">response_id</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;Somehow has no hook for </span><span class="si">{</span><span class="n">response_id</span><span class="si">}</span><span class="s2">&quot;</span>
+            <span class="k">assert</span> <span class="n">response_id</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;Somehow we did not store request for </span><span class="si">{</span><span class="n">response_id</span><span class="si">}</span><span class="s2">&quot;</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">[</span><span class="n">response</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]](</span><span class="bp">self</span><span class="o">.</span><span class="n">_transform_response</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">__stored_requests</span><span class="o">.</span><span class="n">pop</span><span class="p">(</span><span class="n">response_id</span><span class="p">),</span> <span class="n">response</span><span class="p">))</span>
+            <span class="k">del</span> <span class="bp">self</span><span class="o">.</span><span class="n">__hooks</span><span class="p">[</span><span class="n">response_id</span><span class="p">]</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">__requests</span> <span class="o">=</span> <span class="nb">list</span><span class="p">(</span><span class="nb">filter</span><span class="p">(</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[</span><span class="s1">&#39;id&#39;</span><span class="p">]</span> <span class="o">!=</span> <span class="n">response_id</span><span class="p">,</span> <span class="bp">self</span><span class="o">.</span><span class="n">__requests</span><span class="p">))</span>
+
+        <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="s1">&#39;unserviced_requests&#39;</span><span class="p">])</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+            <span class="bp">self</span><span class="o">.</span><span class="n">execute</span><span class="p">(</span><span class="n">attempt</span><span class="o">=</span><span class="n">attempt</span><span class="o">+</span><span class="mi">1</span><span class="p">)</span></div>
 
 <div class="viewcode-block" id="BatchAPI.get"><a class="viewcode-back" href="../../api.html#pysnc.BatchAPI.get">[docs]</a>    <span class="k">def</span> <span class="nf">get</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">record</span><span class="p">:</span> <span class="n">GlideRecord</span><span class="p">,</span> <span class="n">sys_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">hook</span><span class="p">:</span> <span class="n">Callable</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span><span class="p">:</span>
         <span class="n">params</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">_set_params</span><span class="p">(</span><span class="n">record</span><span class="p">)</span>

diff --git a/_modules/pysnc/exceptions.html b/_modules/pysnc/exceptions.html
@@ -4,10 +4,10 @@
   <head>
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>pysnc.exceptions &#8212; PySNC 1.1.8 documentation</title>
+    <title>pysnc.exceptions &#8212; PySNC 1.1.9 documentation</title>
     <link rel="stylesheet" type="text/css" href="../../_static/pygments.css?v=fa44fd50" />
     <link rel="stylesheet" type="text/css" href="../../_static/alabaster.css?v=039e1c02" />
-    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=fd6a9826"></script>
+    <script data-url_root="../../" id="documentation_options" src="../../_static/documentation_options.js?v=59121c3f"></script>
     <script src="../../_static/doctools.js?v=888ff710"></script>
     <script src="../../_static/sphinx_highlight.js?v=4825356b"></script>
     <link rel="index" title="Index" href="../../genindex.html" />