Skip to content

Commit 9b6c72b

Browse files
committed
Update docs build
1 parent f51dc32 commit 9b6c72b

File tree

7 files changed

+152
-151
lines changed

7 files changed

+152
-151
lines changed

docs/_modules/versionedobj/exceptions.html

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -75,10 +75,16 @@ <h1>Source code for versionedobj.exceptions</h1><div class="highlight"><pre>
7575
<span class="k">pass</span></div>
7676

7777

78-
<div class="viewcode-block" id="LoadObjError"><a class="viewcode-back" href="../../versionedobj.html#versionedobj.exceptions.LoadObjError">[docs]</a><span class="k">class</span> <span class="nc">LoadObjError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
78+
<div class="viewcode-block" id="LoadObjectError"><a class="viewcode-back" href="../../versionedobj.html#versionedobj.exceptions.LoadObjectError">[docs]</a><span class="k">class</span> <span class="nc">LoadObjectError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
7979
<span class="sd">&quot;&quot;&quot;</span>
8080
<span class="sd"> Exception raised whenever saved object data cannot be loaded because of a JSON parser error</span>
81-
<span class="sd"> or because of a failed migration path</span>
81+
<span class="sd"> &quot;&quot;&quot;</span>
82+
<span class="k">pass</span></div>
83+
84+
85+
<div class="viewcode-block" id="ObjectMigrationError"><a class="viewcode-back" href="../../versionedobj.html#versionedobj.exceptions.ObjectMigrationError">[docs]</a><span class="k">class</span> <span class="nc">ObjectMigrationError</span><span class="p">(</span><span class="ne">Exception</span><span class="p">):</span>
86+
<span class="sd">&quot;&quot;&quot;</span>
87+
<span class="sd"> Exception raised whenever migration of a versioned object fails</span>
8288
<span class="sd"> &quot;&quot;&quot;</span>
8389
<span class="k">pass</span></div>
8490

docs/_modules/versionedobj/object.html

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -72,7 +72,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
7272
<span class="kn">import</span> <span class="nn">json</span>
7373
<span class="kn">from</span> <span class="nn">json.decoder</span> <span class="kn">import</span> <span class="n">JSONDecodeError</span>
7474

75-
<span class="kn">from</span> <span class="nn">versionedobj.exceptions</span> <span class="kn">import</span> <span class="n">InvalidFilterError</span><span class="p">,</span> <span class="n">LoadObjError</span><span class="p">,</span> <span class="n">InputValidationError</span><span class="p">,</span> <span class="n">InvalidVersionAttributeError</span>
75+
<span class="kn">from</span> <span class="nn">versionedobj.exceptions</span> <span class="kn">import</span> <span class="n">InvalidFilterError</span><span class="p">,</span> <span class="n">LoadObjectError</span><span class="p">,</span> <span class="n">ObjectMigrationError</span><span class="p">,</span> <span class="n">InputValidationError</span><span class="p">,</span> <span class="n">InvalidVersionAttributeError</span>
7676

7777

7878
<div class="viewcode-block" id="migration"><a class="viewcode-back" href="../../versionedobj.html#versionedobj.object.migration">[docs]</a><span class="k">def</span> <span class="nf">migration</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">from_version</span><span class="p">,</span> <span class="n">to_version</span><span class="p">):</span>
@@ -352,7 +352,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
352352
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
353353

354354
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
355-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if migration to current version fails.</span>
355+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</span>
356356
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
357357
<span class="sd"> &quot;&quot;&quot;</span>
358358
<span class="k">return</span> <span class="bp">cls</span><span class="p">()</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span><span class="n">attrs</span><span class="p">,</span> <span class="n">validate</span><span class="p">,</span> <span class="n">only</span><span class="p">,</span> <span class="n">ignore</span><span class="p">)</span></div>
@@ -371,7 +371,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
371371
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
372372

373373
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
374-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if migration to current version fails.</span>
374+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</span>
375375
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
376376
<span class="sd"> &quot;&quot;&quot;</span>
377377
<span class="k">return</span> <span class="bp">cls</span><span class="p">()</span><span class="o">.</span><span class="n">from_json</span><span class="p">(</span><span class="n">jsonstr</span><span class="p">,</span> <span class="n">validate</span><span class="p">,</span> <span class="n">only</span><span class="p">,</span> <span class="n">ignore</span><span class="p">)</span></div>
@@ -390,7 +390,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
390390
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
391391

392392
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
393-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if migration to current version fails.</span>
393+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</span>
394394
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
395395
<span class="sd"> &quot;&quot;&quot;</span>
396396
<span class="k">return</span> <span class="bp">cls</span><span class="p">()</span><span class="o">.</span><span class="n">from_file</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="n">validate</span><span class="p">,</span> <span class="n">only</span><span class="p">,</span> <span class="n">ignore</span><span class="p">)</span></div>
@@ -432,7 +432,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
432432
<span class="k">break</span>
433433

434434
<span class="k">if</span> <span class="n">version_after_migration</span> <span class="o">!=</span> <span class="n">version</span><span class="p">:</span>
435-
<span class="k">raise</span> <span class="n">LoadObjError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Failed to migrate from version </span><span class="si">{</span><span class="n">version_before_migration</span><span class="si">}</span><span class="s2"> to </span><span class="si">{</span><span class="n">version</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
435+
<span class="k">raise</span> <span class="n">ObjectMigrationError</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Failed to migrate from version </span><span class="si">{</span><span class="n">version_before_migration</span><span class="si">}</span><span class="s2"> to </span><span class="si">{</span><span class="n">version</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
436436

437437
<span class="k">return</span> <span class="n">attrs</span>
438438

@@ -549,7 +549,7 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
549549
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
550550

551551
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
552-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if migration to current version fails.</span>
552+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</span>
553553
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
554554
<span class="sd"> &quot;&quot;&quot;</span>
555555
<span class="k">if</span> <span class="n">only</span> <span class="ow">and</span> <span class="n">ignore</span><span class="p">:</span>
@@ -599,13 +599,14 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
599599
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
600600

601601
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
602-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if JSON parsing fails, or if migration to current version fails.</span>
602+
<span class="sd"> :raises versionedobj.exceptions.LoadObjectError: if JSON parsing fails</span>
603+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails</span>
603604
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
604605
<span class="sd"> &quot;&quot;&quot;</span>
605606
<span class="k">try</span><span class="p">:</span>
606607
<span class="n">d</span> <span class="o">=</span> <span class="n">json</span><span class="o">.</span><span class="n">loads</span><span class="p">(</span><span class="n">jsonstr</span><span class="p">)</span>
607608
<span class="k">except</span> <span class="n">JSONDecodeError</span><span class="p">:</span>
608-
<span class="k">raise</span> <span class="n">LoadObjError</span><span class="p">(</span><span class="s2">&quot;JSON decode failure&quot;</span><span class="p">)</span>
609+
<span class="k">raise</span> <span class="n">LoadObjectError</span><span class="p">(</span><span class="s2">&quot;JSON decode failure&quot;</span><span class="p">)</span>
609610

610611
<span class="bp">self</span><span class="o">.</span><span class="n">from_dict</span><span class="p">(</span><span class="n">d</span><span class="p">,</span> <span class="n">validate</span><span class="p">,</span> <span class="n">only</span><span class="p">,</span> <span class="n">ignore</span><span class="p">)</span>
611612
<span class="k">return</span> <span class="bp">self</span></div>
@@ -634,7 +635,8 @@ <h1>Source code for versionedobj.object</h1><div class="highlight"><pre>
634635
<span class="sd"> :param list ignore: Blacklist of field names to ignore (cannot be used with whitelist)</span>
635636

636637
<span class="sd"> :raises versionedobj.exceptions.InputValidationError: if validation of input data fails.</span>
637-
<span class="sd"> :raises versionedobj.exceptions.LoadObjError: if JSON parsing fails, or if migration to current version fails.</span>
638+
<span class="sd"> :raises versionedobj.exceptions.LoadObjectError: if JSON parsing fails</span>
639+
<span class="sd"> :raises versionedobj.exceptions.ObjectMigrationError: if migration to current version fails.</span>
638640
<span class="sd"> :raises versionedobj.exceptions.InvalidFilterError: if both &#39;only&#39; and &#39;ignore&#39; are provided.</span>
639641
<span class="sd"> &quot;&quot;&quot;</span>
640642
<span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">filename</span><span class="p">,</span> <span class="s1">&#39;r&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">fh</span><span class="p">:</span>

docs/genindex.html

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -141,7 +141,7 @@ <h2 id="I">I</h2>
141141
<h2 id="L">L</h2>
142142
<table style="width: 100%" class="indextable genindextable"><tr>
143143
<td style="width: 33%; vertical-align: top;"><ul>
144-
<li><a href="versionedobj.html#versionedobj.exceptions.LoadObjError">LoadObjError</a>
144+
<li><a href="versionedobj.html#versionedobj.exceptions.LoadObjectError">LoadObjectError</a>
145145
</li>
146146
</ul></td>
147147
</tr></table>
@@ -185,6 +185,10 @@ <h2 id="O">O</h2>
185185
<table style="width: 100%" class="indextable genindextable"><tr>
186186
<td style="width: 33%; vertical-align: top;"><ul>
187187
<li><a href="versionedobj.html#versionedobj.object.VersionedObject.object_attributes">object_attributes() (versionedobj.object.VersionedObject method)</a>
188+
</li>
189+
</ul></td>
190+
<td style="width: 33%; vertical-align: top;"><ul>
191+
<li><a href="versionedobj.html#versionedobj.exceptions.ObjectMigrationError">ObjectMigrationError</a>
188192
</li>
189193
</ul></td>
190194
</tr></table>

0 commit comments

Comments
 (0)