Skip to content

Commit

Permalink
πŸ“ CI: automated Generate Documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
actions-user committed Nov 10, 2023
1 parent d9f8168 commit 52351dc
Show file tree
Hide file tree
Showing 8 changed files with 88 additions and 79 deletions.
6 changes: 4 additions & 2 deletions docs/html/genindex.html
Original file line number Diff line number Diff line change
Expand Up @@ -507,17 +507,19 @@ <h2 id="I">I</h2>
</li>
<li><a href="modules/builders.html#freshbooks.builders.filter.FilterBuilder.in_list">in_list() (freshbooks.builders.filter.FilterBuilder method)</a>
</li>
</ul></td>
<td style="width: 33%; vertical-align: top;"><ul>
<li><a href="modules/builders.html#freshbooks.builders.includes.IncludesBuilder.include">include() (freshbooks.builders.includes.IncludesBuilder method)</a>
</li>
</ul></td>
<td style="width: 33%; vertical-align: top;"><ul>
<li><a href="modules/builders.html#freshbooks.builders.includes.IncludesBuilder">IncludesBuilder (class in freshbooks.builders.includes)</a>
</li>
<li><a href="modules/client.html#freshbooks.client.Client.invoice_payment_options">invoice_payment_options (freshbooks.client.Client property)</a>
</li>
<li><a href="modules/client.html#freshbooks.client.Client.invoice_profiles">invoice_profiles (freshbooks.client.Client property)</a>
</li>
<li><a href="modules/client.html#freshbooks.client.Client.invoices">invoices (freshbooks.client.Client property)</a>
</li>
<li><a href="modules/models.html#freshbooks.models.VisState.is_integer">is_integer() (freshbooks.models.VisState method)</a>
</li>
<li><a href="modules/client.html#freshbooks.client.Client.items">items (freshbooks.client.Client property)</a>
</li>
Expand Down
1 change: 1 addition & 0 deletions docs/html/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -305,6 +305,7 @@ <h1>Welcome to freshbooks-sdk’s documentation!<a class="headerlink" href="#wel
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.denominator"><code class="docutils literal notranslate"><span class="pre">VisState.denominator</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.from_bytes"><code class="docutils literal notranslate"><span class="pre">VisState.from_bytes()</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.imag"><code class="docutils literal notranslate"><span class="pre">VisState.imag</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.is_integer"><code class="docutils literal notranslate"><span class="pre">VisState.is_integer()</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.numerator"><code class="docutils literal notranslate"><span class="pre">VisState.numerator</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.real"><code class="docutils literal notranslate"><span class="pre">VisState.real</span></code></a></li>
<li class="toctree-l3"><a class="reference internal" href="modules/models.html#freshbooks.models.VisState.to_bytes"><code class="docutils literal notranslate"><span class="pre">VisState.to_bytes()</span></code></a></li>
Expand Down
34 changes: 17 additions & 17 deletions docs/html/modules/builders.html
Original file line number Diff line number Diff line change
Expand Up @@ -162,7 +162,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Builds the query string parameters from the PaginateBuilder.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">str</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``str</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>resource_name</strong> – The type of resource to generate the query string for. Eg. AccountingResource, ProjectsResource</p>
Expand All @@ -179,7 +179,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Set the page you wish to fetch in a list call, or get the currently set the page.
When setting, can be chained.</p>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">paginator</span> <span class="o">=</span> <span class="n">PaginateBuilder</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span>
<span class="go">:rtype: :py:data:`~typing.Union`\[:py:class:`int`, :py:obj:`None`, :py:class:`~freshbooks.builders.Builder`]</span>
<span class="go">:rtype: :sphinx_autodoc_typehints_type:`\:py\:data\:\`\~typing.Union\`\\ \\\[\:py\:class\:\`int\`\, \:py\:obj\:\`None\`\, \:py\:class\:\`\~freshbooks.builders.Builder\`\]`</span>

<span class="gp">&gt;&gt;&gt; </span><span class="n">paginator</span>
<span class="go">PaginateBuilder(page=1, per_page=3)</span>
Expand Down Expand Up @@ -209,7 +209,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
or get the currently set per_page. When setting, can be chained.</p>
<p>The page size is capped at 100.</p>
<div class="highlight-python notranslate"><div class="highlight"><pre><span></span><span class="gp">&gt;&gt;&gt; </span><span class="n">paginator</span> <span class="o">=</span> <span class="n">PaginateBuilder</span><span class="p">(</span><span class="mi">1</span><span class="p">,</span> <span class="mi">3</span><span class="p">)</span>
<span class="go">:rtype: :py:data:`~typing.Union`\[:py:class:`int`, :py:obj:`None`, :py:class:`~freshbooks.builders.Builder`]</span>
<span class="go">:rtype: :sphinx_autodoc_typehints_type:`\:py\:data\:\`\~typing.Union\`\\ \\\[\:py\:class\:\`int\`\, \:py\:obj\:\`None\`\, \:py\:class\:\`\~freshbooks.builders.Builder\`\]`</span>

<span class="gp">&gt;&gt;&gt; </span><span class="n">paginator</span>
<span class="go">PaginateBuilder(page=1, per_page=3)</span>
Expand Down Expand Up @@ -278,7 +278,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<p>For date fields, you can pass the iso format <code class="docutils literal notranslate"><span class="pre">2020-10-17</span></code> or a <code class="docutils literal notranslate"><span class="pre">datetime</span></code> or <code class="docutils literal notranslate"><span class="pre">date</span></code> object, which
will be converted to the proper string format.</p>
<p>Examples:
:rtype: :py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
:rtype: :sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">filter.between(&quot;amount&quot;,</span> <span class="pre">1,</span> <span class="pre">10)</span></code> will yield filters <code class="docutils literal notranslate"><span class="pre">&amp;search[amount_min]=1&amp;search[amount_max]=10</span></code></p></li>
<li><p><code class="docutils literal notranslate"><span class="pre">filter.between(&quot;amount_min&quot;,</span> <span class="pre">min=1)</span></code> will yield filter <code class="docutils literal notranslate"><span class="pre">&amp;search[amount_min]=1</span></code></p></li>
Expand Down Expand Up @@ -308,7 +308,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<code class="docutils literal notranslate"><span class="pre">filter.boolean(&quot;active&quot;,</span> <span class="pre">False)</span></code> will yield the filter <code class="docutils literal notranslate"><span class="pre">&amp;active=false</span></code></p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><ul class="simple">
Expand All @@ -328,7 +328,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Builds the query string parameters from the FilterBuilder.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">str</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``str</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>resource_name</strong> – The type of resource to generate the query string for. Eg. AccountingResource, ProjectsResource</p>
Expand All @@ -347,7 +347,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
after the provided time.</p>
<p>The url parameter must be in ISO 8601 format (eg. 2010-10-17T05:45:53Z)</p>
<p>Example:
:rtype: :py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
:rtype: :sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
<ul class="simple">
<li><p><code class="docutils literal notranslate"><span class="pre">filter.date_time(&quot;updated_since&quot;,</span> <span class="pre">&quot;2020-10-17T13:14:07&quot;)</span></code> will yield <code class="docutils literal notranslate"><span class="pre">&amp;updated_since=2020-10-17T13:14:07</span></code></p></li>
</ul>
Expand All @@ -372,7 +372,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<code class="docutils literal notranslate"><span class="pre">filter.equals(&quot;username&quot;,</span> <span class="pre">&quot;Bob&quot;)</span></code> will yield the filter <code class="docutils literal notranslate"><span class="pre">&amp;search[username]=Bob</span></code></p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><ul class="simple">
Expand All @@ -399,7 +399,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
of unique cases that may not be handled.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><ul class="simple">
Expand All @@ -421,7 +421,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
not Like-match β€œleaf”.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><ul class="simple">
Expand Down Expand Up @@ -458,7 +458,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Builds the query string parameters from the IncludesBuilder.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">str</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``str</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>resource_name</strong> – The type of resource to generate the query string for. Eg. AccountingResource, ProjectsResource</p>
Expand All @@ -477,7 +477,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<code class="docutils literal notranslate"><span class="pre">includes.include(&quot;late_reminders&quot;)</span></code> will yield the filter <code class="docutils literal notranslate"><span class="pre">&amp;include[]=late_reminders</span></code></p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>key</strong> – The key for the resource or data to include</p>
Expand Down Expand Up @@ -511,7 +511,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Alias for .ascending()</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
</dl>
</dd></dl>
Expand All @@ -522,7 +522,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Add a sort by the field in ascending order.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>key</strong> – The field for the resource list to be sorted by</p>
Expand All @@ -536,7 +536,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Builds the query string parameter from the SortBuilder.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">str</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``str</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>resource_name</strong> – The type of resource to generate the query string for. Eg. AccountingResource, ProjectsResource</p>
Expand All @@ -553,7 +553,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Alias for .descending()</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
</dl>
</dd></dl>
Expand All @@ -564,7 +564,7 @@ <h1>Builders<a class="headerlink" href="#builders" title="Link to this heading">
<dd><p>Add a sort by the field in descending order.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.builders.Builder</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.builders.Builder</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>key</strong> – The field for the resource list to be sorted by</p>
Expand Down
8 changes: 4 additions & 4 deletions docs/html/modules/client.html
Original file line number Diff line number Diff line change
Expand Up @@ -183,7 +183,7 @@ <h1>Client<a class="headerlink" href="#client" title="Link to this heading"><
<p>See <a class="reference external" href="https://www.freshbooks.com/api/me_endpoint">FreshBooks API - Business, Roles, and Identity</a></p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~freshbooks.models.Identity</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~freshbooks.models.Identity</span></code></p>
</dd>
</dl>
</dd></dl>
Expand Down Expand Up @@ -222,7 +222,7 @@ <h1>Client<a class="headerlink" href="#client" title="Link to this heading"><
on the Client instance and also returns those values in an object.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~types.SimpleNamespace</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~types.SimpleNamespace</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>code</strong> – access_grant code from the authorization redirect</p>
Expand Down Expand Up @@ -252,7 +252,7 @@ <h1>Client<a class="headerlink" href="#client" title="Link to this heading"><
application is registered for.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">str</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``str</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>scopes</strong> – List of scopes if your want an access token with only a subset of your registered scopes</p>
Expand Down Expand Up @@ -331,7 +331,7 @@ <h1>Client<a class="headerlink" href="#client" title="Link to this heading"><
in an object.</p>
<dl class="field-list simple">
<dt class="field-odd">Return type<span class="colon">:</span></dt>
<dd class="field-odd"><p>:py:class:<code class="docutils literal notranslate"><span class="pre">~types.SimpleNamespace</span></code></p>
<dd class="field-odd"><p>:sphinx_autodoc_typehints_type:<code class="docutils literal notranslate"><span class="pre">\:py\:class\:\``~types.SimpleNamespace</span></code></p>
</dd>
<dt class="field-even">Parameters<span class="colon">:</span></dt>
<dd class="field-even"><p><strong>refresh_token</strong> – (Optional) refresh_token from initial <code class="docutils literal notranslate"><span class="pre">get_access_token</span></code> call</p>
Expand Down
Loading

0 comments on commit 52351dc

Please sign in to comment.