Skip to content

Commit a0b24f8

Browse files
committed
Deployed 37052c5 with MkDocs version: 1.1
1 parent fcd3a42 commit a0b24f8

23 files changed

Lines changed: 93 additions & 972 deletions

File tree

changelog/index.html

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -371,6 +371,20 @@
371371
<label class="md-nav__title" for="__toc">Table of contents</label>
372372
<ul class="md-nav__list" data-md-scrollfix="">
373373
<li class="md-nav__item">
374+
<a class="md-nav__link" href="#v021-2020-04-07">
375+
v0.2.1 - 2020-04-07
376+
</a>
377+
<nav class="md-nav">
378+
<ul class="md-nav__list">
379+
<li class="md-nav__item">
380+
<a class="md-nav__link" href="#bug-fixes">
381+
Bug Fixes
382+
</a>
383+
</li>
384+
</ul>
385+
</nav>
386+
</li>
387+
<li class="md-nav__item">
374388
<a class="md-nav__link" href="#v020-2020-03-27">
375389
v0.2.0 - 2020-03-27
376390
</a>
@@ -451,6 +465,20 @@
451465
<label class="md-nav__title" for="__toc">Table of contents</label>
452466
<ul class="md-nav__list" data-md-scrollfix="">
453467
<li class="md-nav__item">
468+
<a class="md-nav__link" href="#v021-2020-04-07">
469+
v0.2.1 - 2020-04-07
470+
</a>
471+
<nav class="md-nav">
472+
<ul class="md-nav__list">
473+
<li class="md-nav__item">
474+
<a class="md-nav__link" href="#bug-fixes">
475+
Bug Fixes
476+
</a>
477+
</li>
478+
</ul>
479+
</nav>
480+
</li>
481+
<li class="md-nav__item">
454482
<a class="md-nav__link" href="#v020-2020-03-27">
455483
v0.2.0 - 2020-03-27
456484
</a>
@@ -523,6 +551,13 @@ <h1 id="changelog">Changelog</h1>
523551
<p>All notable changes to this project will be documented in this file.</p>
524552
<p>The format is based on <a href="http://keepachangelog.com/en/1.0.0/">Keep a Changelog</a>
525553
and this project adheres to <a href="http://semver.org/spec/v2.0.0.html">Semantic Versioning</a>.</p>
554+
<h2 id="v021-2020-04-07"><a href="https://github.com/pawamoy/pytkdocs/releases/tag/v0.2.1">v0.2.1</a> - 2020-04-07</h2>
555+
<p><small><a href="https://github.com/pawamoy/pytkdocs/compare/v0.2.0...v0.2.1">Compare with v0.2.0</a></small></p>
556+
<h3 id="bug-fixes">Bug Fixes</h3>
557+
<ul>
558+
<li>Fix forward refs replacement for python &gt; 3.6 (<a href="https://github.com/pawamoy/pytkdocs/commit/6a90aca346209fe2a4e3eec6bfb45f353bce679f">6a90aca</a> by Timothée Mazzucotelli).</li>
559+
<li>Handle exception parsing error (<a href="https://github.com/pawamoy/pytkdocs/commit/d6561f86362e7a9d8c45471f1d6eb5deffd5e0c8">d6561f8</a> by Timothée Mazzucotelli). Related issues/PRs: <a href="https://github.com/pawamoy/pytkdocs/issues/16">#16</a></li>
560+
</ul>
526561
<h2 id="v020-2020-03-27"><a href="https://github.com/pawamoy/py-tkdocs/releases/tag/v0.2.0">v0.2.0</a> - 2020-03-27</h2>
527562
<p><small><a href="https://github.com/pawamoy/pytkdocs/compare/v0.1.2...V0.2.0">Compare with v0.1.2</a></small></p>
528563
<h3 id="added">Added</h3>

developers/test_suite/__init__/index.html

Lines changed: 0 additions & 98 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,6 @@
3737
<input autocomplete="off" class="md-toggle" data-md-toggle="drawer" id="__drawer" type="checkbox"/>
3838
<input autocomplete="off" class="md-toggle" data-md-toggle="search" id="__search" type="checkbox"/>
3939
<label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
40-
<a class="md-skip" href="#tests.__init__" tabindex="0">
41-
Skip to content
42-
</a>
4340
<header class="md-header" data-md-component="header">
4441
<nav class="md-header-nav md-grid">
4542
<div class="md-flex">
@@ -239,37 +236,9 @@
239236
<ul class="md-nav__list" data-md-scrollfix="">
240237
<li class="md-nav__item md-nav__item--active">
241238
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" id="__toc" type="checkbox"/>
242-
<label class="md-nav__link md-nav__link--active" for="__toc">
243-
__init__.py
244-
</label>
245239
<a class="md-nav__link md-nav__link--active" href="./" title="__init__.py">
246240
__init__.py
247241
</a>
248-
<nav class="md-nav md-nav--secondary">
249-
<label class="md-nav__title" for="__toc">Table of contents</label>
250-
<ul class="md-nav__list" data-md-scrollfix="">
251-
<li class="md-nav__item">
252-
<a class="md-nav__link" href="#tests.__init__">
253-
tests.__init__
254-
</a>
255-
</li>
256-
<li class="md-nav__item">
257-
<a class="md-nav__link" href="#tests.__init__.FIXTURES_DIR">
258-
FIXTURES_DIR
259-
</a>
260-
</li>
261-
<li class="md-nav__item">
262-
<a class="md-nav__link" href="#tests.__init__.TESTS_DIR">
263-
TESTS_DIR
264-
</a>
265-
</li>
266-
<li class="md-nav__item">
267-
<a class="md-nav__link" href="#tests.__init__.TMP_DIR">
268-
TMP_DIR
269-
</a>
270-
</li>
271-
</ul>
272-
</nav>
273242
</li>
274243
<li class="md-nav__item">
275244
<a class="md-nav__link" href="../conftest/" title="conftest.py">
@@ -403,77 +372,10 @@
403372
</div>
404373
</div>
405374
</div>
406-
<div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
407-
<div class="md-sidebar__scrollwrap">
408-
<div class="md-sidebar__inner">
409-
<nav class="md-nav md-nav--secondary">
410-
<label class="md-nav__title" for="__toc">Table of contents</label>
411-
<ul class="md-nav__list" data-md-scrollfix="">
412-
<li class="md-nav__item">
413-
<a class="md-nav__link" href="#tests.__init__">
414-
tests.__init__
415-
</a>
416-
</li>
417-
<li class="md-nav__item">
418-
<a class="md-nav__link" href="#tests.__init__.FIXTURES_DIR">
419-
FIXTURES_DIR
420-
</a>
421-
</li>
422-
<li class="md-nav__item">
423-
<a class="md-nav__link" href="#tests.__init__.TESTS_DIR">
424-
TESTS_DIR
425-
</a>
426-
</li>
427-
<li class="md-nav__item">
428-
<a class="md-nav__link" href="#tests.__init__.TMP_DIR">
429-
TMP_DIR
430-
</a>
431-
</li>
432-
</ul>
433-
</nav>
434-
</div>
435-
</div>
436-
</div>
437375
<div class="md-content">
438376
<article class="md-content__inner md-typeset">
439377
<a class="md-icon md-content__icon" href="https://github.com/pawamoy/pytkdocs/edit/master/docs/developers/test_suite/__init__.md" title="Edit this page"></a>
440378
<h1>__init__.py</h1>
441-
<div class="doc doc-object doc-module">
442-
<h6 class="hidden-toc" href="#tests.__init__" id="tests.__init__" style="visibility: hidden; width: 0; height: 0;">
443-
</h6>
444-
<div class="doc doc-contents first">
445-
<p>In this module we simply define some path constants.</p>
446-
<div class="doc doc-children">
447-
<div class="doc doc-object doc-attribute">
448-
<h2 class="doc doc-heading" id="tests.__init__.FIXTURES_DIR">
449-
<code class="highlight">
450-
FIXTURES_DIR: <span class="n">Path</span> </code>
451-
</h2>
452-
<div class="doc doc-contents">
453-
<p>The tests/fixtures directory path object.</p>
454-
</div>
455-
</div>
456-
<div class="doc doc-object doc-attribute">
457-
<h2 class="doc doc-heading" id="tests.__init__.TESTS_DIR">
458-
<code class="highlight">
459-
TESTS_DIR: <span class="n">Path</span> </code>
460-
</h2>
461-
<div class="doc doc-contents">
462-
<p>The tests directory path object.</p>
463-
</div>
464-
</div>
465-
<div class="doc doc-object doc-attribute">
466-
<h2 class="doc doc-heading" id="tests.__init__.TMP_DIR">
467-
<code class="highlight">
468-
TMP_DIR: <span class="n">Path</span> </code>
469-
</h2>
470-
<div class="doc doc-contents">
471-
<p>The tests/tmp directory path object.</p>
472-
</div>
473-
</div>
474-
</div>
475-
</div>
476-
</div>
477379
</article>
478380
</div>
479381
</div>

developers/test_suite/conftest/index.html

Lines changed: 0 additions & 104 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,6 @@
3737
<input autocomplete="off" class="md-toggle" data-md-toggle="drawer" id="__drawer" type="checkbox"/>
3838
<input autocomplete="off" class="md-toggle" data-md-toggle="search" id="__search" type="checkbox"/>
3939
<label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
40-
<a class="md-skip" href="#tests.conftest" tabindex="0">
41-
Skip to content
42-
</a>
4340
<header class="md-header" data-md-component="header">
4441
<nav class="md-header-nav md-grid">
4542
<div class="md-flex">
@@ -244,27 +241,9 @@
244241
</li>
245242
<li class="md-nav__item md-nav__item--active">
246243
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" id="__toc" type="checkbox"/>
247-
<label class="md-nav__link md-nav__link--active" for="__toc">
248-
conftest.py
249-
</label>
250244
<a class="md-nav__link md-nav__link--active" href="./" title="conftest.py">
251245
conftest.py
252246
</a>
253-
<nav class="md-nav md-nav--secondary">
254-
<label class="md-nav__title" for="__toc">Table of contents</label>
255-
<ul class="md-nav__list" data-md-scrollfix="">
256-
<li class="md-nav__item">
257-
<a class="md-nav__link" href="#tests.conftest">
258-
tests.conftest
259-
</a>
260-
</li>
261-
<li class="md-nav__item">
262-
<a class="md-nav__link" href="#tests.conftest.pytest_itemcollected">
263-
pytest_itemcollected()
264-
</a>
265-
</li>
266-
</ul>
267-
</nav>
268247
</li>
269248
<li class="md-nav__item md-nav__item--nested">
270249
<input class="md-toggle md-nav__toggle" data-md-toggle="nav-4-1-3" id="nav-4-1-3" type="checkbox"/>
@@ -393,93 +372,10 @@
393372
</div>
394373
</div>
395374
</div>
396-
<div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
397-
<div class="md-sidebar__scrollwrap">
398-
<div class="md-sidebar__inner">
399-
<nav class="md-nav md-nav--secondary">
400-
<label class="md-nav__title" for="__toc">Table of contents</label>
401-
<ul class="md-nav__list" data-md-scrollfix="">
402-
<li class="md-nav__item">
403-
<a class="md-nav__link" href="#tests.conftest">
404-
tests.conftest
405-
</a>
406-
</li>
407-
<li class="md-nav__item">
408-
<a class="md-nav__link" href="#tests.conftest.pytest_itemcollected">
409-
pytest_itemcollected()
410-
</a>
411-
</li>
412-
</ul>
413-
</nav>
414-
</div>
415-
</div>
416-
</div>
417375
<div class="md-content">
418376
<article class="md-content__inner md-typeset">
419377
<a class="md-icon md-content__icon" href="https://github.com/pawamoy/pytkdocs/edit/master/docs/developers/test_suite/conftest.md" title="Edit this page"></a>
420378
<h1>conftest.py</h1>
421-
<div class="doc doc-object doc-module">
422-
<h6 class="hidden-toc" href="#tests.conftest" id="tests.conftest" style="visibility: hidden; width: 0; height: 0;">
423-
</h6>
424-
<div class="doc doc-contents first">
425-
<p>Configuration for pytest.</p>
426-
<div class="doc doc-children">
427-
<div class="doc doc-object doc-function">
428-
<h2 class="doc doc-heading" id="tests.conftest.pytest_itemcollected">
429-
<code class="highlight language-python">
430-
pytest_itemcollected<span class="p">(</span><span class="n">item</span><span class="p">)</span> </code>
431-
</h2>
432-
<div class="doc doc-contents">
433-
<p>Make tests names more readable in the tests output.</p>
434-
<details class="quote">
435-
<summary>Source code in <code>tests/conftest.py</code></summary>
436-
<table class="highlighttable">
437-
<tr>
438-
<td class="linenos">
439-
<div class="linenodiv">
440-
<pre><span></span> 4
441-
5
442-
6
443-
7
444-
8
445-
9
446-
10
447-
11
448-
12
449-
13
450-
14
451-
15
452-
16
453-
17</pre>
454-
</div>
455-
</td>
456-
<td class="code">
457-
<div class="highlight">
458-
<pre><span></span><code><span class="k">def</span> <span class="nf">pytest_itemcollected</span><span class="p">(</span><span class="n">item</span><span class="p">):</span>
459-
<span class="sd">"""Make tests names more readable in the tests output."""</span>
460-
<span class="n">item</span><span class="o">.</span><span class="n">_nodeid</span> <span class="o">=</span> <span class="p">(</span>
461-
<span class="n">item</span><span class="o">.</span><span class="n">_nodeid</span><span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">".py"</span><span class="p">,</span> <span class="s2">""</span><span class="p">)</span>
462-
<span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">"tests/"</span><span class="p">,</span> <span class="s2">""</span><span class="p">)</span>
463-
<span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">"test_"</span><span class="p">,</span> <span class="s2">""</span><span class="p">)</span>
464-
<span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">"_"</span><span class="p">,</span> <span class="s2">" "</span><span class="p">)</span>
465-
<span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">"Test"</span><span class="p">,</span> <span class="s2">""</span><span class="p">)</span>
466-
<span class="o">.</span><span class="n">replace</span><span class="p">(</span><span class="s2">"Class"</span><span class="p">,</span> <span class="s2">" class"</span><span class="p">)</span>
467-
<span class="o">.</span><span class="n">lower</span><span class="p">()</span>
468-
<span class="p">)</span>
469-
<span class="n">doc</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">obj</span><span class="o">.</span><span class="vm">__doc__</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">if</span> <span class="n">item</span><span class="o">.</span><span class="n">obj</span><span class="o">.</span><span class="vm">__doc__</span> <span class="k">else</span> <span class="s2">""</span>
470-
<span class="k">if</span> <span class="n">doc</span><span class="p">:</span>
471-
<span class="n">item</span><span class="o">.</span><span class="n">_nodeid</span> <span class="o">=</span> <span class="n">item</span><span class="o">.</span><span class="n">_nodeid</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">"::"</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span> <span class="o">+</span> <span class="s2">"::"</span> <span class="o">+</span> <span class="n">doc</span>
472-
</code></pre>
473-
</div>
474-
</td>
475-
</tr>
476-
</table>
477-
</details>
478-
</div>
479-
</div>
480-
</div>
481-
</div>
482-
</div>
483379
</article>
484380
</div>
485381
</div>

developers/test_suite/fixtures/inheriting_enum_Enum/index.html

Lines changed: 0 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -37,9 +37,6 @@
3737
<input autocomplete="off" class="md-toggle" data-md-toggle="drawer" id="__drawer" type="checkbox"/>
3838
<input autocomplete="off" class="md-toggle" data-md-toggle="search" id="__search" type="checkbox"/>
3939
<label class="md-overlay" data-md-component="overlay" for="__drawer"></label>
40-
<a class="md-skip" href="#tests.fixtures.inheriting_enum_Enum" tabindex="0">
41-
Skip to content
42-
</a>
4340
<header class="md-header" data-md-component="header">
4441
<nav class="md-header-nav md-grid">
4542
<div class="md-flex">
@@ -259,22 +256,9 @@
259256
<ul class="md-nav__list" data-md-scrollfix="">
260257
<li class="md-nav__item md-nav__item--active">
261258
<input class="md-toggle md-nav__toggle" data-md-toggle="toc" id="__toc" type="checkbox"/>
262-
<label class="md-nav__link md-nav__link--active" for="__toc">
263-
inheriting_enum_Enum.py
264-
</label>
265259
<a class="md-nav__link md-nav__link--active" href="./" title="inheriting_enum_Enum.py">
266260
inheriting_enum_Enum.py
267261
</a>
268-
<nav class="md-nav md-nav--secondary">
269-
<label class="md-nav__title" for="__toc">Table of contents</label>
270-
<ul class="md-nav__list" data-md-scrollfix="">
271-
<li class="md-nav__item">
272-
<a class="md-nav__link" href="#tests.fixtures.inheriting_enum_Enum">
273-
tests.fixtures.inheriting_enum_Enum
274-
</a>
275-
</li>
276-
</ul>
277-
</nav>
278262
</li>
279263
<li class="md-nav__item">
280264
<a class="md-nav__link" href="../inheriting_typing_NamedTuple/" title="inheriting_typing_NamedTuple.py">
@@ -388,46 +372,10 @@
388372
</div>
389373
</div>
390374
</div>
391-
<div class="md-sidebar md-sidebar--secondary" data-md-component="toc">
392-
<div class="md-sidebar__scrollwrap">
393-
<div class="md-sidebar__inner">
394-
<nav class="md-nav md-nav--secondary">
395-
<label class="md-nav__title" for="__toc">Table of contents</label>
396-
<ul class="md-nav__list" data-md-scrollfix="">
397-
<li class="md-nav__item">
398-
<a class="md-nav__link" href="#tests.fixtures.inheriting_enum_Enum">
399-
tests.fixtures.inheriting_enum_Enum
400-
</a>
401-
</li>
402-
</ul>
403-
</nav>
404-
</div>
405-
</div>
406-
</div>
407375
<div class="md-content">
408376
<article class="md-content__inner md-typeset">
409377
<a class="md-icon md-content__icon" href="https://github.com/pawamoy/pytkdocs/edit/master/docs/developers/test_suite/fixtures/inheriting_enum_Enum.md" title="Edit this page"></a>
410378
<h1>inheriting_enum_Enum.py</h1>
411-
<div class="doc doc-object doc-module">
412-
<h6 class="hidden-toc" href="#tests.fixtures.inheriting_enum_Enum" id="tests.fixtures.inheriting_enum_Enum" style="visibility: hidden; width: 0; height: 0;">
413-
</h6>
414-
<div class="doc doc-contents first">
415-
<p>While recursing on a class inheriting from <code>enum.Enum</code>, the class' <code>__dict__</code> returns private items
416-
whose values are the <code>object</code> builtin for example.</p>
417-
<p>The <code>object</code> builtin is a class, so <code>pytkdocs</code> is trying to recurse on it,
418-
and tries to get its file path by first getting its module.</p>
419-
<p>The <code>object</code> class' module is <code>builtins</code>, which does not have a <code>__file__</code> attribute,
420-
so trying to access it generates an <code>AttributeError</code> error.</p>
421-
<p>Instead of failing, we simply catch the error and set <code>file_path = ""</code>.</p>
422-
<p>References:</p>
423-
<ul>
424-
<li>Test case: <a href="https://pawamoy.github.io/pytkdocs/developers/test_suite/test_loader/#tests.test_loader.test_inheriting_enum_Enum">tests.test_loader.test_inheriting_enum_Enum</a>.</li>
425-
<li>Issue reported on commit <a href="https://github.com/pawamoy/mkdocstrings/commit/5053f8142913f01358481e4801e5222d88482c35">5053f81</a>.</li>
426-
<li>Fixed by commit <a href="https://github.com/pawamoy/pytkdocs/commit/48df6bc9cf878f3ce281fac6ccaf8fe1d4e89c84">48df6bc</a>.</li>
427-
<li>See other "inheriting" test cases.</li>
428-
</ul>
429-
</div>
430-
</div>
431379
</article>
432380
</div>
433381
</div>

0 commit comments

Comments
 (0)