Skip to content
This repository has been archived by the owner on Jan 23, 2021. It is now read-only.

Commit

Permalink
feature: add readthedocs integration
Browse files Browse the repository at this point in the history
  • Loading branch information
tripledes committed Dec 23, 2019
1 parent d8209ca commit dde3354
Show file tree
Hide file tree
Showing 16 changed files with 238 additions and 38 deletions.
7 changes: 7 additions & 0 deletions .readthedocs.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
version: 2
sphinx:
configuration: doc/source/conf.py
python:
version: 3.7
install:
- requirements: doc/requirements.txt
Binary file added doc/build/doctrees/contents.doctree
Binary file not shown.
Binary file modified doc/build/doctrees/environment.pickle
Binary file not shown.
Binary file modified doc/build/doctrees/infrastructure.doctree
Binary file not shown.
File renamed without changes.
148 changes: 148 additions & 0 deletions doc/build/html/contents.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,148 @@

<!DOCTYPE html>

<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta charset="utf-8" />
<title>Welcome to The Sheriff’s documentation! &#8212; The Sheriff 1.0.0 documentation</title>
<link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
<script type="text/javascript" id="documentation_options" data-url_root="./" src="_static/documentation_options.js"></script>
<script type="text/javascript" src="_static/jquery.js"></script>
<script type="text/javascript" src="_static/underscore.js"></script>
<script type="text/javascript" src="_static/doctools.js"></script>
<script type="text/javascript" src="_static/language_data.js"></script>
<link rel="index" title="Index" href="genindex.html" />
<link rel="search" title="Search" href="search.html" />
<link rel="next" title="The Sheriff Usage" href="usage.html" />

<link rel="stylesheet" href="_static/custom.css" type="text/css" />


<meta name="viewport" content="width=device-width, initial-scale=0.9, maximum-scale=0.9" />

</head><body>


<div class="document">
<div class="documentwrapper">
<div class="bodywrapper">


<div class="body" role="main">

<div class="section" id="welcome-to-the-sheriff-s-documentation">
<h1>Welcome to The Sheriff’s documentation!<a class="headerlink" href="#welcome-to-the-sheriff-s-documentation" title="Permalink to this headline"></a></h1>
<div class="toctree-wrapper compound">
</div>
<div class="section" id="application-usage">
<h2>Application usage<a class="headerlink" href="#application-usage" title="Permalink to this headline"></a></h2>
<p>Here’s all you need to run and test The Sheriff application.</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="usage.html">The Sheriff Usage</a><ul>
<li class="toctree-l2"><a class="reference internal" href="usage.html#runtime-requirements">Runtime Requirements</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#validating-use-cases">Validating use cases</a></li>
<li class="toctree-l2"><a class="reference internal" href="usage.html#development-requirements">Development Requirements</a></li>
</ul>
</li>
</ul>
</div>
</div>
<div class="section" id="the-api-documentation">
<h2>The API Documentation<a class="headerlink" href="#the-api-documentation" title="Permalink to this headline"></a></h2>
<p>If you are looking for information on a specific function, class, or method,
this part of the documentation is for you.</p>
<div class="toctree-wrapper compound">
<ul>
<li class="toctree-l1"><a class="reference internal" href="infrastructure.html">The Sheriff Infrastructure</a><ul>
<li class="toctree-l2"><a class="reference internal" href="infrastructure.html#controllers">Controllers</a></li>
<li class="toctree-l2"><a class="reference internal" href="infrastructure.html#repositories">Repositories</a></li>
</ul>
</li>
</ul>
</div>
</div>
</div>


</div>

</div>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="#">
<img class="logo" src="_static/logo.png" alt="Logo"/>
</a></p>
<h1 class="logo"><a href="#">The Sheriff</a></h1>








<h3>Navigation</h3>
<ul>
<li class="toctree-l1"><a class="reference internal" href="usage.html">The Sheriff Usage</a></li>
</ul>
<ul>
<li class="toctree-l1"><a class="reference internal" href="infrastructure.html">The Sheriff Infrastructure</a></li>
</ul>


<hr />
<ul>

<li class="toctree-l1"><a href="https://github.com/tripledes/thesheriff">🚀 Github</a></li>

</ul>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="#">Documentation overview</a><ul>
<li>Next: <a href="usage.html" title="next chapter">The Sheriff Usage</a></li>
</ul></li>
</ul>
</div>
<div id="searchbox" style="display: none" role="search">
<h3 id="searchlabel">Quick search</h3>
<div class="searchformwrapper">
<form class="search" action="search.html" method="get">
<input type="text" name="q" aria-labelledby="searchlabel" />
<input type="submit" value="Go" />
</form>
</div>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>








</div>
</div>
<div class="clearer"></div>
</div>
<div class="footer">
&copy;2019, The Sheriff Team.

|
Powered by <a href="http://sphinx-doc.org/">Sphinx 2.2.0</a>
&amp; <a href="https://github.com/bitprophet/alabaster">Alabaster 0.7.12</a>

|
<a href="_sources/contents.rst.txt"
rel="nofollow">Page source</a>
</div>




</body>
</html>
8 changes: 5 additions & 3 deletions doc/build/html/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -151,6 +151,8 @@ <h2 id="U">U</h2>

<ul>
<li><a href="infrastructure.html#thesheriff.infrastructure.repository.mysql_outlaw_repository.MySQLOutlawRepository.update">(thesheriff.infrastructure.repository.mysql_outlaw_repository.MySQLOutlawRepository method)</a>
</li>
<li><a href="infrastructure.html#thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.update">(thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository method)</a>
</li>
</ul></li>
</ul></td>
Expand All @@ -164,10 +166,10 @@ <h2 id="U">U</h2>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<p class="logo"><a href="contents.html">
<img class="logo" src="_static/logo.png" alt="Logo"/>
</a></p>
<h1 class="logo"><a href="index.html">The Sheriff</a></h1>
<h1 class="logo"><a href="contents.html">The Sheriff</a></h1>



Expand All @@ -194,7 +196,7 @@ <h3>Navigation</h3>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="index.html">Documentation overview</a><ul>
<li><a href="contents.html">Documentation overview</a><ul>
</ul></li>
</ul>
</div>
Expand Down
51 changes: 29 additions & 22 deletions doc/build/html/infrastructure.html
Original file line number Diff line number Diff line change
Expand Up @@ -145,7 +145,7 @@ <h3>thesheriff.infrastructure.controllers.outlaw_controller<a class="headerlink"
</pre></div>
</div>
</li>
<li><p><em>/outlaw/&lt;int:outlaw_id&gt;/gangs</em> (GET)</p>
<li><p><em>/&lt;prefix&gt;/outlaw/&lt;int:outlaw_id&gt;/gangs</em> (GET)</p>
<p><strong>Request Example:</strong></p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> curl localhost:5000/api/&lt;version&gt;/outlaw/1/gangs
</pre></div>
Expand All @@ -161,6 +161,21 @@ <h3>thesheriff.infrastructure.controllers.outlaw_controller<a class="headerlink"
</pre></div>
</div>
</li>
<li><p><em>/&lt;prefix&gt;/outlaw/&lt;int:outlaw_id&gt;/raid/&lt;int:raid_id&gt;/</em> (POST)</p>
<p><strong>Request Example:</strong></p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> curl localhost:5000/api/&lt;version&gt;/outlaw/1/raid/1 <span class="se">\</span>
-X POST --data @examples/json/rate_raid.json <span class="se">\</span>
-H <span class="s1">&#39;Content-Type: application/json&#39;</span>
</pre></div>
</div>
<p><strong>Response Example:</strong></p>
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
<span class="nt">&quot;status&quot;</span><span class="p">:</span> <span class="mi">201</span><span class="p">,</span>
<span class="nt">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;raid rated successfully&quot;</span>
<span class="p">}</span>
</pre></div>
</div>
</li>
</ul>
</dd></dl>

Expand All @@ -184,23 +199,6 @@ <h3>thesheriff.infrastructure.controllers.raid_controller<a class="headerlink" h
</dd>
</dl>
<p>Implements the following routes:</p>
<ul>
<li><p><em>/&lt;prefix&gt;/raid/&lt;int:raid_id&gt;/rate</em> (POST)</p>
<p><strong>Request Example:</strong></p>
<div class="highlight-console notranslate"><div class="highlight"><pre><span></span><span class="gp">$</span> curl localhost:5000/api/&lt;version&gt;/raid/1/rate <span class="se">\</span>
-X POST --data @examples/json/rate_raid.json <span class="se">\</span>
-H <span class="s1">&#39;Content-Type: application/json&#39;</span>
</pre></div>
</div>
<p><strong>Response Example:</strong></p>
<div class="highlight-json notranslate"><div class="highlight"><pre><span></span><span class="p">{</span>
<span class="nt">&quot;status&quot;</span><span class="p">:</span> <span class="mi">201</span><span class="p">,</span>
<span class="nt">&quot;message&quot;</span><span class="p">:</span> <span class="s2">&quot;raid rated successfully&quot;</span>
<span class="p">}</span>
</pre></div>
</div>
</li>
</ul>
</dd></dl>

</div>
Expand Down Expand Up @@ -407,7 +405,7 @@ <h2>Repositories<a class="headerlink" href="#repositories" title="Permalink to t
</dl>
<dl class="method">
<dt id="thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.add">
<code class="sig-name descname">add</code><span class="sig-paren">(</span><em class="sig-param">new_outlaw: thesheriff.domain.outlaw.outlaw.Outlaw</em><span class="sig-paren">)</span> &#x2192; NoReturn<a class="headerlink" href="#thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.add" title="Permalink to this definition"></a></dt>
<code class="sig-name descname">add</code><span class="sig-paren">(</span><em class="sig-param">new_raid: thesheriff.domain.raid.raid.Raid</em><span class="sig-paren">)</span> &#x2192; NoReturn<a class="headerlink" href="#thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.add" title="Permalink to this definition"></a></dt>
<dd><p>Method add persists a new Outlaw to MySQL.</p>
<dl class="field-list simple">
<dt class="field-odd">Parameters</dt>
Expand Down Expand Up @@ -439,6 +437,15 @@ <h2>Repositories<a class="headerlink" href="#repositories" title="Permalink to t
</dl>
</dd></dl>

<dl class="method">
<dt id="thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.update">
<code class="sig-name descname">update</code><span class="sig-paren">(</span><em class="sig-param">mod_raid: thesheriff.domain.raid.raid.Raid</em><span class="sig-paren">)</span> &#x2192; NoReturn<a class="headerlink" href="#thesheriff.infrastructure.repository.mysql_raid_repository.MySQLRaidRepository.update" title="Permalink to this definition"></a></dt>
<dd><p>Method update updates an existing Raid.
:param mod_raid: Object with the Raid information
:type mod_raid: Raid.
:return: NoReturn.</p>
</dd></dl>

</dd></dl>

</div>
Expand All @@ -451,10 +458,10 @@ <h2>Repositories<a class="headerlink" href="#repositories" title="Permalink to t
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<p class="logo"><a href="contents.html">
<img class="logo" src="_static/logo.png" alt="Logo"/>
</a></p>
<h1 class="logo"><a href="index.html">The Sheriff</a></h1>
<h1 class="logo"><a href="contents.html">The Sheriff</a></h1>



Expand Down Expand Up @@ -485,7 +492,7 @@ <h3>Navigation</h3>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="index.html">Documentation overview</a><ul>
<li><a href="contents.html">Documentation overview</a><ul>
<li>Previous: <a href="usage.html" title="previous chapter">The Sheriff Usage</a></li>
</ul></li>
</ul>
Expand Down
Binary file modified doc/build/html/objects.inv
Binary file not shown.
6 changes: 3 additions & 3 deletions doc/build/html/py-modindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -94,10 +94,10 @@ <h1>Python Module Index</h1>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<p class="logo"><a href="contents.html">
<img class="logo" src="_static/logo.png" alt="Logo"/>
</a></p>
<h1 class="logo"><a href="index.html">The Sheriff</a></h1>
<h1 class="logo"><a href="contents.html">The Sheriff</a></h1>



Expand All @@ -124,7 +124,7 @@ <h3>Navigation</h3>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="index.html">Documentation overview</a><ul>
<li><a href="contents.html">Documentation overview</a><ul>
</ul></li>
</ul>
</div>
Expand Down
6 changes: 3 additions & 3 deletions doc/build/html/search.html
Original file line number Diff line number Diff line change
Expand Up @@ -65,10 +65,10 @@ <h1 id="search-documentation">Search</h1>
</div>
<div class="sphinxsidebar" role="navigation" aria-label="main navigation">
<div class="sphinxsidebarwrapper">
<p class="logo"><a href="index.html">
<p class="logo"><a href="contents.html">
<img class="logo" src="_static/logo.png" alt="Logo"/>
</a></p>
<h1 class="logo"><a href="index.html">The Sheriff</a></h1>
<h1 class="logo"><a href="contents.html">The Sheriff</a></h1>



Expand All @@ -95,7 +95,7 @@ <h3>Navigation</h3>
<div class="relations">
<h3>Related Topics</h3>
<ul>
<li><a href="index.html">Documentation overview</a><ul>
<li><a href="contents.html">Documentation overview</a><ul>
</ul></li>
</ul>
</div>
Expand Down

0 comments on commit dde3354

Please sign in to comment.