Skip to content

Commit fb797fc

Browse files
committed
Update documentation
1 parent b1aa742 commit fb797fc

3 files changed

Lines changed: 12 additions & 6 deletions

File tree

_sources/autoapi/dvcurator/readme/index.rst.txt

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -27,18 +27,22 @@ Module Contents
2727

2828

2929

30-
.. py:function:: generate_readme(metadata, folder, token=None, repo=None)
30+
.. py:function:: generate_readme(metadata, folder, token=None, key=None, repo=None)
3131
3232
Generate README.txt file.
3333

34-
This function uses the template assets/README.txt
34+
This function uses the file README_template.txt in the repository root.
3535

3636
:param metadata: Project metadata from `get_metadata()`
3737
:type metadata: list
3838
:param folder: Path to QDR Prepared folder for project
3939
:type folder: String
4040
:param token: Dataverse token (required if the project is unpublished)
4141
:type token: string
42+
:param key: Github API key, or None for public repository
43+
:type key: String or None
44+
:param repo: Repository to use for the README template, defaults to dvcurator.hosts.curation_repo
45+
:type repo: String or None
4246

4347
:return: Path to newly generated README file
4448
:rtype: string

autoapi/dvcurator/readme/index.html

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ <h2>Functions<a class="headerlink" href="#functions" title="Permalink to this he
4141
<tr class="row-odd"><td><p><a class="reference internal" href="#dvcurator.readme.clean_html_tags" title="dvcurator.readme.clean_html_tags"><code class="xref py py-obj docutils literal notranslate"><span class="pre">clean_html_tags</span></code></a>(text)</p></td>
4242
<td><p>Remove all HTML tags from text</p></td>
4343
</tr>
44-
<tr class="row-even"><td><p><a class="reference internal" href="#dvcurator.readme.generate_readme" title="dvcurator.readme.generate_readme"><code class="xref py py-obj docutils literal notranslate"><span class="pre">generate_readme</span></code></a>(metadata, folder[, token, repo])</p></td>
44+
<tr class="row-even"><td><p><a class="reference internal" href="#dvcurator.readme.generate_readme" title="dvcurator.readme.generate_readme"><code class="xref py py-obj docutils literal notranslate"><span class="pre">generate_readme</span></code></a>(metadata, folder[, token, key, repo])</p></td>
4545
<td><p>Generate README.txt file.</p></td>
4646
</tr>
4747
</tbody>
@@ -68,15 +68,17 @@ <h2>Module Contents<a class="headerlink" href="#module-contents" title="Permalin
6868

6969
<dl class="py function">
7070
<dt class="sig sig-object py" id="dvcurator.readme.generate_readme">
71-
<span class="sig-prename descclassname"><span class="pre">dvcurator.readme.</span></span><span class="sig-name descname"><span class="pre">generate_readme</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">metadata</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">folder</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">repo</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#dvcurator.readme.generate_readme" title="Permalink to this definition"></a></dt>
71+
<span class="sig-prename descclassname"><span class="pre">dvcurator.readme.</span></span><span class="sig-name descname"><span class="pre">generate_readme</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">metadata</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">folder</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">token</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">key</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">repo</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#dvcurator.readme.generate_readme" title="Permalink to this definition"></a></dt>
7272
<dd><p>Generate README.txt file.</p>
73-
<p>This function uses the template assets/README.txt</p>
73+
<p>This function uses the file README_template.txt in the repository root.</p>
7474
<dl class="field-list simple">
7575
<dt class="field-odd">Parameters<span class="colon">:</span></dt>
7676
<dd class="field-odd"><ul class="simple">
7777
<li><p><strong>metadata</strong> (<em>list</em>) – Project metadata from <cite>get_metadata()</cite></p></li>
7878
<li><p><strong>folder</strong> (<em>String</em>) – Path to QDR Prepared folder for project</p></li>
7979
<li><p><strong>token</strong> (<em>string</em>) – Dataverse token (required if the project is unpublished)</p></li>
80+
<li><p><strong>key</strong> (<em>String</em><em> or </em><em>None</em>) – Github API key, or None for public repository</p></li>
81+
<li><p><strong>repo</strong> (<em>String</em><em> or </em><em>None</em>) – Repository to use for the README template, defaults to dvcurator.hosts.curation_repo</p></li>
8082
</ul>
8183
</dd>
8284
<dt class="field-even">Returns<span class="colon">:</span></dt>

0 commit comments

Comments
 (0)